Connect a una fonte di dati Graphite - 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 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.gcpu.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 tag.

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).