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 10.x di Grafana.
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8
Amazon Managed 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 interrogazione e i plug-in di origine dati implementano ciascuno un'interfaccia utente per la creazione di query chiamata editor di query.
Argomenti
- Informazioni sulle interrogazioni
- Naviga nella scheda delle interrogazioni
- Aggiungere una query
- Gestisci le interrogazioni
- Opzioni di interrogazione
- Scrivere interrogazioni sulle espressioni
- Condividi i risultati delle interrogazioni con un altro pannello
- Trasforma i dati
- Risolvi i problemi relativi alle interrogazioni
- Tipi di calcolo
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 query 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 origine dati, incluse informazioni sulle query e sulla sintassi, consulta la documentazione sull'origine dati:
-
Per le fonti di dati incluse in Amazon Managed Grafana, consulta Origini dati integrate.
-
Per le fonti di dati incluse in Grafana Enterprise, vedere. Connect a fonti di dati aziendali
-
Per altri plugin di sorgenti dati che si installano tramite ilTrova i plugin con il catalogo dei plugin, la documentazione è collegata all'elenco nel catalogo dei plugin.
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 ulteriori informazioni, consulta Connessione alle origini dati.
Naviga nella scheda delle interrogazioni
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 interrogazioni 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 una query
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, rimuoverle, riordinarle 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.
-
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_ms
Gli 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-5m
Il giorno finora
now/d
Ultimi 5 giorni
now-5d/d
Finora questa settimana
now/w
Ultimi 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/w
Due intere settimane fa
2w/w
Tutto il mese scorso
1M/M
Tutto l'anno
1d/y
L'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.