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à.
Interroga e trasforma i dati
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. Funzionamento nella versione 10 di Grafana
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8
Grafana supporta molti tipi di fonti di dati. Le interrogazioni sulle fonti di dati restituiscono dati che Grafana può trasformare e visualizzare. Ogni fonte di dati utilizza il proprio linguaggio di query e i plug-in di origine dati implementano ciascuno un'interfaccia utente per la creazione di query chiamata editor di query.
Informazioni sulle interrogazioni
I pannelli Grafana comunicano con le fonti di dati tramite query, che recuperano i dati per la visualizzazione. Una query è una domanda scritta nel linguaggio di interrogazione utilizzato dalla fonte di dati.
È possibile configurare la frequenza delle interrogazioni e i limiti di raccolta dei dati nelle opzioni di origine dati del pannello. Grafana supporta fino a 26 interrogazioni per pannello.
Puoi trovare ulteriori informazioni sul linguaggio di interrogazione di ciascuna fonte di dati nella sezione Fonti dati.
Editor di query
L'editor di query di ogni fonte di dati fornisce un'interfaccia utente personalizzata che consente di scrivere query che sfruttano le sue funzionalità uniche.
A causa delle differenze tra i linguaggi di interrogazione, ogni editor di query di sorgenti di dati ha un aspetto e un funzionamento diversi. A seconda della fonte di dati, l'editor di query potrebbe fornire funzionalità di completamento automatico, nomi di metriche, suggerimenti di variabili o un'interfaccia visiva per la creazione di query.
Per i dettagli sulle funzionalità esclusive dell'editor di query di una specifica fonte di dati, consulta la relativa documentazione:
-
Per le fonti di dati incluse in Grafana, vedi Origini dati integrate.
-
Per le fonti di dati incluse nell'edizione Grafana Enterprise, vedere. Connect a fonti di dati aziendali
Sintassi delle query
Le fonti di dati utilizzano diversi linguaggi di interrogazione per richiedere dati. Per i dettagli sul linguaggio di interrogazione unico di una fonte di dati specifica, consulta la relativa documentazione.
Esempio di PostgreSQL:
SELECT hostname FROM host WHERE region IN($region)
Esempio PromQL:
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Fonti di dati speciali
Grafana include anche tre fonti di dati speciali: Grafana, Mixed e Dashboard. Per i dettagli, consulta Fonti di dati
Naviga nella scheda Query
La scheda Query di un pannello è composta dai seguenti elementi:
-
Selettore di origine dati: seleziona l'origine dati da interrogare.
-
Opzioni di interrogazione: — Imposta i parametri massimi di recupero dei dati e gli intervalli di tempo di esecuzione delle query.
-
Pulsante Query Inspector: — Apre il pannello Query Inspector, in cui è possibile visualizzare e ottimizzare la query.
-
Elenco dell'editor di query: — Elenca le domande che hai scritto.
-
Espressioni: — Utilizza il generatore di espressioni per creare espressioni di avviso. Per ulteriori informazioni sulle espressioni, consulta Scrivere interrogazioni sulle espressioni.
Aggiungere un'interrogazione
Una query restituisce i dati che Grafana visualizza nei pannelli del dashboard. Quando crei un pannello, Grafana seleziona automaticamente l'origine dati predefinita.
Per aggiungere una query
-
Modifica il pannello a cui stai aggiungendo un'interrogazione.
-
Scegli la scheda Queries (Query).
-
Scegli il menu a discesa Origine dati e seleziona una fonte di dati.
-
Scegli le opzioni di interrogazione per configurare il numero massimo di punti dati necessari. Per ulteriori informazioni sulle opzioni di interrogazione, consultaOpzioni di interrogazione.
-
Scrivere la query utilizzando l'editor di query.
-
Scegli Applica.
Grafana interroga la fonte di dati e visualizza i dati.
Gestisci le interrogazioni
Grafana organizza le interrogazioni in righe di interrogazione comprimibili. Ogni riga di query contiene un editor di query ed è identificata da una lettera (A, B, C e così via).
Per gestire le query, è possibile copiare le interrogazioni, nasconderle, rimuovere una query, riordinare le interrogazioni e attivare la guida dell'editor di query.
Opzioni di interrogazione
Scegli le opzioni di interrogazione accanto al selettore dell'origine dati per visualizzare le impostazioni per l'origine dati selezionata. Le modifiche che apporti qui influiscono solo sulle interrogazioni effettuate in questo pannello.
Grafana imposta i valori predefiniti che vengono visualizzati nel testo grigio scuro. Le modifiche vengono visualizzate in testo bianco. Per riportare un campo all'impostazione predefinita, elimina il testo bianco dal campo.
Le opzioni di interrogazione delle fonti di dati del pannello includono:
-
Numero massimo di punti dati: se l'origine dati lo supporta, imposta il numero massimo di punti dati per ogni serie restituita. Se la query restituisce più punti dati rispetto all'impostazione del numero massimo di punti dati, l'origine dati riduce il numero di punti restituiti aggregandoli per media, max o un'altra funzione.
È possibile limitare il numero di punti per migliorare le prestazioni delle query o rendere più fluida la linea visualizzata. Il valore predefinito è la larghezza (o il numero di pixel) del grafico, poiché è possibile visualizzare solo il numero di punti dati disponibile nel pannello grafico.
Con lo streaming di dati, Grafana utilizza il valore massimo dei punti dati per il rolling buffer. Lo streaming è un flusso continuo di dati e il buffering divide il flusso in blocchi. Ad esempio, Loki trasmette i dati in modalità live tailing.
-
Intervallo minimo: imposta un limite minimo per l'intervallo calcolato automaticamente, che in genere è l'intervallo minimo di scrape. Se un punto dati viene salvato ogni 15 secondi, non trarrai vantaggio dall'avere un intervallo inferiore a quello. Puoi anche impostarlo su un valore minimo superiore all'intervallo di scrape per recuperare interrogazioni più dettagliate e ben funzionanti.
-
Intervallo: imposta un intervallo di tempo che è possibile utilizzare per aggregare o raggruppare i punti dati in base al tempo.
Grafana calcola automaticamente un intervallo appropriato che puoi utilizzare come variabile nelle query basate su modelli. La variabile viene misurata in secondi () o millisecondi ()
$__interval.$__interval_msGli intervalli vengono in genere utilizzati in funzioni di aggregazione come somma o media. Ad esempio, questa è una query Prometheus che utilizza la variabile interval:.
rate(http_requests_total[$__interval])Questo intervallo automatico viene calcolato in base alla larghezza del grafico. Man mano che l'utente rimpicciolisce una visualizzazione, l'intervallo aumenta, con conseguente aggregazione a grana più grossa. Allo stesso modo, se l'utente ingrandisce, l'intervallo diminuisce, ottenendo un'aggregazione più dettagliata.
Per ulteriori informazioni, consulta Variabili globali.
-
Tempo relativo: sostituisce l'intervallo di tempo relativo per i singoli pannelli, il che li rende diversi da quello selezionato nel selettore temporale della dashboard nell'angolo in alto a destra della dashboard. Puoi usarlo per mostrare le metriche relative a periodi di tempo o giorni diversi sulla stessa dashboard.
Nota
Le sostituzioni temporali del pannello non hanno effetto quando l'intervallo di tempo della dashboard è assoluto.
Esempio Campo temporale relativo Ultimi 5 minuti
now-5mIl giorno finora
now/dUltimi 5 giorni
now-5d/dFinora questa settimana
now/wUltimi 2 anni
now-2y/y -
Spostamento temporale: sostituisce l'intervallo di tempo per i singoli pannelli spostandone l'inizio e la fine rispetto al selettore orario. Ad esempio, puoi spostare l'intervallo di tempo per il pannello in modo che sia due ore prima rispetto al selettore orario della dashboard.
Nota
Le sostituzioni temporali del pannello non hanno effetto quando l'intervallo di tempo del pannello di controllo è assoluto.
Esempio Campo Time Shift Tutta la settimana scorsa
1w/wDue intere settimane fa
2w/wTutto il mese scorso
1M/MTutto l'anno
1d/yL'intero anno
1y/y -
Timeout della cache: (visibile solo se disponibile nell'origine dati) Sostituisce il timeout predefinito della cache se l'archivio delle serie temporali dispone di una cache delle query. Specificate questo valore come valore numerico in secondi.
