Connect a una fonte di dati Loki - Grafana gestito da Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect a una fonte di dati Loki

L'origine dati Loki fornisce l'accesso a Loki, il sistema di aggregazione dei log di Grafana.

Aggiungere la fonte di dati

  1. Apri l'area di lavoro Grafana e assicurati di aver effettuato l'accesso.

  2. Nel menu laterale sotto il link Configurazione dovresti trovare un link Data Sources.

  3. scegli il pulsante Aggiungi fonte di dati in alto.

  4. Seleziona Loki dall'elenco delle fonti di dati.

Nota

Se non vedi il link Fonti di dati nel menu laterale, significa che l'utente attuale non ha il Admin ruolo.

Nome Descrizione
Name Il nome della fonte di dati. Ecco come viene visualizzata la fonte di dati nei pannelli, nelle query e in Esplora.
Default L'origine dati predefinita significa che sarà preselezionata per i nuovi pannelli.
URL L'URL dell'istanza Loki, ad esempio. http://localhost:3100 Potrebbe essere l'URL di un host Amazon EC2 o un Application Load Balancer davanti a un cluster Amazon EKS o qualsiasi altro URL per un'istanza Loki.
Maximum lines Limite massimo per il numero di righe di registro restituite da Loki (il valore predefinito è 1000). Diminuisci se il tuo browser è lento durante la visualizzazione dei log in Explore.

Campi derivati

È possibile utilizzare la configurazione dei campi derivati per effettuare le seguenti operazioni:

  • Aggiungi campi analizzati dal messaggio di registro.

  • Aggiungi un link che utilizza il valore del campo.

Puoi utilizzare questa funzionalità per collegarti al tuo backend di tracciamento direttamente dai tuoi log o collegarti a una pagina del profilo utente se nella riga di registro è presente un UserID. Questi collegamenti vengono visualizzati nei dettagli del registro. Per ulteriori informazioni, consulta Etichette e campi rilevati.

Ogni campo derivato è composto da quanto segue:

  • Nome: visualizzato nei dettagli del registro sotto forma di etichetta.

  • Regex: un pattern Regex che viene eseguito sul messaggio di registro e ne acquisisce una parte come valore del nuovo campo. Può contenere un solo gruppo di acquisizione.

  • URL/query: se il link è esterno, inserisci l'URL completo del link. Se il collegamento è interno, questo input funge da query per l'origine dati di destinazione. In entrambi i casi, è possibile interpolare il valore del campo con ${__value.raw } una macro.

  • Link interno: seleziona se il link è interno o esterno. In caso di collegamento interno, un selettore dell'origine dati consente di selezionare l'origine dati di destinazione. Sono supportate solo le fonti di dati di tracciamento.

Puoi utilizzare una sezione di debug per vedere cosa estraggono i tuoi campi e come viene interpolato l'URL. Scegli Mostra un messaggio di registro di esempio per mostrare l'area di testo in cui puoi inserire un messaggio di registro.

Il nuovo campo con il link mostrato nei dettagli del registro.

Esecuzione di query su log di

L'interrogazione e la visualizzazione dei dati di registro da Loki sono disponibili tramite Explore e con il pannello dei log nelle visualizzazioni. Seleziona la fonte di dati Loki, quindi inserisci una query LogQL per visualizzare i log. Per ulteriori informazioni su LogQL, consulta LogQL.

Registra le interrogazioni

Una query di log è composta da due parti: il selettore del flusso di log e un'espressione di ricerca. Per motivi di prestazioni, è necessario iniziare scegliendo un'etichetta di registro per un flusso di log.

Il Logs Explorer (il pulsante Log labels) accanto al campo di interrogazione mostra un elenco di etichette dei flussi di log disponibili. Un modo alternativo per scrivere una query consiste nell'utilizzare il completamento automatico del campo di interrogazione. Si inizia digitando una parentesi curva sinistra { e il menu di completamento automatico suggerirà un elenco di etichette. Premi il tasto Invio per eseguire la query.

Dopo la restituzione del risultato, il pannello di registro mostra un elenco di righe di registro e un grafico a barre in cui l'asse x mostra l'ora e l'asse y mostra la frequenza/conteggio.

Selettore Log Stream

Per la parte relativa all'etichetta dell'espressione di interrogazione, racchiudetela tra parentesi {} graffe e quindi utilizzate la sintassi del valore chiave per selezionare le etichette. Le espressioni multiple delle etichette sono separate da una virgola:

{app="mysql",name="mysql-backup"}

Attualmente sono supportati i seguenti operatori di abbinamento delle etichette:

  • =esattamente uguali.

  • !=non uguale.

  • =~regex-match.

  • !~non usare regex-match.

Esempi:

  • {name=~"mysql.+"}

  • {name!~"mysql.+"}

Un altro modo per aggiungere un selettore di etichette è nella sezione tabella. Scegli Filtro accanto a un'etichetta per aggiungere l'etichetta all'espressione di query. Funziona anche per più query e aggiungerà il selettore di etichette a ciascuna query.

Espressioni di ricerca

Dopo aver scritto il Log Stream Selector, puoi filtrare ulteriormente i risultati scrivendo un'espressione di ricerca. L'espressione di ricerca può essere solo testo o un'espressione regex.

Domande di esempio:

  • {job="mysql"} |= "error"

  • {name="kafka"} |~ "tsdb-ops.*io:2003"

  • {instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"

Gli operatori di filtro possono essere concatenati e filtreranno in sequenza l'espressione. Le righe di registro risultanti soddisferanno ogni filtro.

Esempio

{job="mysql"} |= "error" != "timeout"

Attualmente sono supportati i seguenti tipi di filtri:

  • |=la riga contiene una stringa.

  • !=la riga non contiene una stringa.

  • |~la linea corrisponde all'espressione regolare.

  • !~la linea non corrisponde all'espressione regolare.

Nota

Per ulteriori informazioni su LogQL, il linguaggio di interrogazione di Loki, vedi Loki LogQL.

Contesto del registro

Quando si utilizza un'espressione di ricerca come descritto sopra, ora è possibile recuperare il contesto che circonda i risultati filtrati. Scegliendo il Show Context link nelle righe filtrate, potrai esaminare i messaggi di registro che hanno preceduto e seguito il messaggio di registro che ti interessa.

Modellazione

Invece di inserire elementi come il nome del server, dell'applicazione e del sensore nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come caselle di selezione a discesa nella parte superiore della dashboard. Puoi utilizzare queste caselle a discesa per modificare i dati visualizzati nella dashboard.

Per ulteriori informazioni sui modelli e sulle variabili dei modelli, consulta. Modelli e variabili

Annotazioni

Puoi usare qualsiasi query Loki non metrica come fonte per le annotazioni. Il contenuto del registro verrà utilizzato come testo di annotazione e le etichette del flusso di registro come tag, quindi non è necessaria una mappatura aggiuntiva.