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 Graphite
Grafana dispone di un editor di query Graphite avanzato che consente di navigare rapidamente nello spazio metrico, aggiungere funzioni, modificare i parametri delle funzioni e molto altro. L'editor è in grado di gestire tutti i tipi di interrogazioni sulla grafite. Può persino gestire query annidate complesse tramite l'uso di riferimenti di query.
Impostazioni Graphite
Per accedere alle impostazioni di Graphite, fai una pausa sull'icona Configurazione (ingranaggio), quindi scegli Fonti dati, quindi scegli l'origine dati Graphite.
Nome | Descrizione |
---|---|
Name
|
Il nome della fonte di dati. Ecco come viene visualizzata la fonte di dati nei pannelli e nelle query. |
Default
|
L'origine dati predefinita significa che sarà preselezionata per i nuovi pannelli. |
URL
|
Il protocollo HTTP, l'IP e la porta dell'installazione di graphite-web o graphite-api. |
Access
|
Server (impostazione predefinita) = L'URL deve essere accessibile dal backend/server Grafana. |
Auth
|
|
Basic Auth
|
Abilita l'autenticazione di base per la fonte di dati. |
User
|
Nome utente per l'autenticazione di base. |
Password
|
Password per l'autenticazione di base. |
Custom HTTP Headers
|
Scegli Aggiungi intestazione per aggiungere un'intestazione HTTP personalizzata. |
Header
|
Inserisci il nome dell'intestazione personalizzata. |
Value
|
Immettete il valore dell'intestazione personalizzato. |
Graphite details
|
|
Version
|
Seleziona la tua versione di Graphite. |
Type
|
Seleziona il tuo tipo di grafite. |
La modalità di accesso controlla il modo in cui verranno gestite le richieste alla fonte di dati. Il server dovrebbe essere il metodo preferito se non viene indicato nient'altro.
Modalità di accesso al server (impostazione predefinita)
Tutte le richieste vengono effettuate dal browser ad Amazon Managed Grafana, che le inoltra alla fonte di dati, aggirando i possibili requisiti Cross-Origin Resource Sharing (CORS). Se selezioni questa modalità di accesso, l'URL deve essere accessibile da Amazon Managed Grafana.
Modalità di accesso al browser
Amazon Managed Grafana non supporta l'accesso diretto tramite browser all'origine dati Graphite.
Editor di query Graphite
Grafana include un editor di query specifico per Graphite per aiutarti a creare le tue query.
Per vedere il testo non elaborato della query che viene inviata a Graphite, scegli l'icona Attiva la modalità di modifica del testo (matita).
Scelta delle metriche da interrogare
Scegli Seleziona metrica per navigare nello spazio metrico. Dopo aver iniziato, puoi continuare a usare il puntatore o i tasti freccia della tastiera. Potete selezionare un carattere jolly e continuare.
Funzioni
Per aggiungere una funzione, scegliete l'icona con il segno più accanto a Funzione. Puoi cercare la funzione o selezionarla dal menu. Dopo aver selezionato una funzione, questa verrà aggiunta e l'attenzione verrà spostata nella casella di testo del primo parametro. Per modificare o cambiare un parametro, selezionalo e si trasformerà in una casella di testo. - Per eliminare una funzione, scegliete il nome della funzione seguito dall'icona x.
Alcune funzioni, ad esempioaliasByNode
, supportano un secondo argomento opzionale. Per aggiungere un argomento, soffermatevi sul primo argomento, quindi scegliete il +
simbolo che appare. Per rimuovere il secondo parametro opzionale, selezionatelo e lasciatelo vuoto. L'editor lo rimuoverà.
Ordina le etichette
Se desideri un ordine coerente, usasortByName
. Questo può essere fastidioso quando hai le stesse etichette su più grafici e sono entrambe ordinate in modo diverso e utilizzano colori diversi. Per risolvere questo problema, usa. sortByName()
Interrogazioni annidate
È possibile fare riferimento alle query in base alla lettera riga in cui si trovano (in modo simile a Microsoft Excel). Se aggiungete una seconda query a un grafico, potete fare riferimento alla prima interrogazione digitando #A. In questo modo è possibile creare query composte in modo pratico.
Evitare molte interrogazioni utilizzando caratteri jolly
Occasionalmente, potresti voler vedere più serie temporali tracciate sullo stesso grafico. Ad esempio, potresti voler vedere come viene utilizzata la CPU su una macchina. Inizialmente è possibile creare il grafico aggiungendo una query per ogni serie temporale, ad esempio cpu.percent.user.g
cpu.percent.system.g
, e così via. Ciò comporta l'esecuzione di n query sull'origine dati, il che è inefficiente.
Per essere più efficienti, è possibile utilizzare caratteri jolly nella ricerca, restituendo tutte le serie temporali in un'unica query. Ad esempio, cpu.percent.*.g
.
Modifica del nome della metrica in tabelle o grafici
Utilizza alias
le funzioni per modificare i nomi delle metriche nelle tabelle o nei grafici Grafana; ad esempio, o. aliasByNode()
aliasSub()
Consolidamento dei punti
Tutte le metriche di Graphite sono consolidate in modo che Graphite non restituisca più punti dati di quanti siano i pixel nel grafico. Per impostazione predefinita, questo consolidamento viene eseguito utilizzando la funzione. avg
Puoi controllare il modo in cui Graphite consolida le metriche aggiungendo la funzione Graphite ConsolidateBy.
Nota
Ciò significa che i valori di riepilogo della legenda (max, min, totale) non possono essere corretti tutti contemporaneamente. Sono calcolati lato client da Grafana. E a seconda della funzione di consolidamento, solo una o due possono essere corrette contemporaneamente.
Combinazione di serie temporali
Per combinare serie temporali, scegliete Combina nell'elenco Funzioni.
Esplorazione dei dati e tag
In Graphite, tutto è un tag.
Quando si esplorano i dati, i tag precedentemente selezionati vengono utilizzati per filtrare il set di risultati rimanente. Per selezionare i dati, si utilizza la seriesByTag
funzione, che utilizza le espressioni di tag (=
,, !=
=~
,!=~
) per filtrare le serie temporali.
Il generatore di query Grafana lo fa automaticamente quando selezioni un tag.
Nota
Suggerimento: la ricerca delle espressioni regolari può essere lenta sui tag ad alta cardinalità, quindi prova prima a utilizzare altri tag per ridurre l'ambito. Iniziare con un nome o uno spazio dei nomi particolare aiuta a ridurre i risultati.
Variabili del modello
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
Per creare una variabile utilizzando i valori dei tag, utilizzate le funzioni tags
Grafana e. tag_values
Query | Descrizione |
---|---|
tags()
|
Restituisce tutti i tag. |
tags(server=~backend\*)
|
Restituisce solo i tag che si trovano in serie corrispondenti all'espressione del filtro. |
tag_values(server)
|
Restituisce i valori dei tag per il tag specificato. |
tag_values(server, server=~backend\*)
|
Restituisce i valori dei tag filtrati che si verificano per il tag specificato in serie che corrispondono a tali espressioni. |
tag_values(server, server=~backend\*,
app=~${apps:regex})
|
Più espressioni ed espressioni di filtro possono contenere altre variabili. |
Per maggiori dettagli, consulta i documenti Graphite sull'API di completamento automatico per i
Variabile di interrogazione
La query specificata nel campo della query deve essere un tipo di ricerca metrica. Ad esempio, una query come quella prod.servers.*
riempirà la variabile con tutti i possibili valori presenti nella posizione dei caratteri jolly.
È inoltre possibile creare variabili annidate che utilizzano altre variabili nella loro definizione. Ad esempio, apps.$app.servers.*
utilizza la variabile $app
nella definizione della query.
Viene utilizzato __searchFilter
per filtrare i risultati delle variabili di query
Se __searchFilter
si utilizza il campo di ricerca, il risultato della query verrà filtrato in base a ciò che viene immesso nella casella di selezione a discesa. Quando non si immette nulla, il valore predefinito per __searchFilter
«*
e» quando viene utilizzato come parte di un'espressione regolare.
L'esempio seguente mostra come utilizzare, __searchFilter
come parte del campo di interrogazione, la ricerca server
mentre l'utente inserisce il testo nella casella di selezione a discesa.
Query
apps.$app.servers.$__searchFilter
TagValues
tag_values(server, server=~${__searchFilter:regex})
Utilizzo variabile
È possibile utilizzare una variabile nel percorso di un nodo metrico o come parametro di una funzione.
Esistono due sintassi:
-
$<varname>
Esempio: apps.frontend. $server.requests.count -
${varname}
Esempio: apps.frontend. $ {server} .requests.count
Perché due modi? La prima sintassi è più facile da leggere e scrivere ma non consente di utilizzare una variabile al centro di una parola. Usa la seconda sintassi in espressioni come. my.server${serverNumber}.count
Utilizzo delle variabili nelle query di tag
Le variabili multivalore nelle query di tag utilizzano la sintassi di formattazione avanzata introdotta in Grafana 5.0 per le variabili:. {var:regex}
Le query senza tag utilizzeranno la formattazione glob predefinita per le variabili multivalore.
Il seguente esempio di codice mostra un'espressione di tag con formattazione regex e che utilizza l'operatore Equal Tilde,. =~
server=~${servers:regex}
Per ulteriori informazioni, consulta Opzioni avanzate di formato variabile.
Annotazioni
Le annotazioni consentono di sovrapporre informazioni dettagliate sugli eventi ai grafici. È possibile aggiungere interrogazioni di annotazione tramite il menu Dashboard /la vista Annotazioni. Per ulteriori informazioni, consulta Annotazioni.
Graphite supporta due modi per interrogare le annotazioni:
-
Una normale interrogazione metrica. A tale scopo, si utilizza la casella di testo Graphite Query.
-
Una query di eventi Graphite. Per questo, usate la casella di
Graphite event tags
testo e specificate un tag o un carattere jolly (dovrebbe funzionare anche tenerlo vuoto).