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à.
Domande e condizioni
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
In Grafana, le query svolgono un ruolo fondamentale nel recupero e nella trasformazione dei dati da fonti di dati supportate, che includono database come MySQL e PostgreSQL, database di serie temporali come Prometheus, InfluxDB e Graphite e servizi come Amazon, Azure Monitor e Google Cloud Monitoring. OpenSearch CloudWatch
Per ulteriori informazioni sulle fonti di dati supportate, consulta. Fonti di dati e avvisi Grafana
Il processo di esecuzione di una query prevede la definizione dell'origine dati, la specificazione dei dati desiderati da recuperare e l'applicazione di filtri o trasformazioni pertinenti. Per costruire queste query vengono utilizzati linguaggi di query o sintassi specifici dell'origine dati scelta.
In Alerting, si definisce una query per ottenere i dati da misurare e una condizione che deve essere soddisfatta prima che venga attivata una regola di avviso.
Una regola di avviso è costituita da una o più interrogazioni ed espressioni che selezionano i dati da misurare.
Per ulteriori informazioni su interrogazioni ed espressioni, vedere. Interroga e trasforma i dati
Interrogazioni relative alle fonti di dati
Le interrogazioni in Grafana possono essere applicate in vari modi, a seconda della fonte di dati e del linguaggio di interrogazione utilizzati. 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.
Alcuni tipi comuni di componenti di interrogazione includono:
Metriche o campi dati: specifica le metriche o i campi dati specifici che desideri recuperare, come l'utilizzo della CPU, il traffico di rete o le letture dei sensori.
Intervallo di tempo: definisci l'intervallo di tempo per il quale desideri recuperare i dati, ad esempio l'ultima ora, un giorno specifico o un intervallo di tempo personalizzato.
Filtri: applica filtri per restringere i dati in base a criteri specifici, ad esempio filtrando i dati in base a un tag, un host o un'applicazione specifici.
Aggregazioni: esegui aggregazioni sui dati per calcolare metriche come medie, somme o conteggi in un determinato periodo di tempo.
Raggruppamento: raggruppa i dati in base a dimensioni o tag specifici per creare viste o suddivisioni aggregate.
Nota
Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili qui
Interrogazioni di espressione
In Grafana, un'espressione viene utilizzata per eseguire calcoli, trasformazioni o aggregazioni sui dati interrogati dall'origine dati. Consente di creare metriche personalizzate o modificare metriche esistenti in base a operazioni matematiche, funzioni o espressioni logiche.
Sfruttando le query di espressione, gli utenti possono eseguire attività come il calcolo della variazione percentuale tra due valori, applicare funzioni come funzioni logaritmiche o trigonometriche, aggregare dati su intervalli di tempo o dimensioni specifici e implementare la logica condizionale per gestire diversi scenari.
In Alerting, puoi usare solo espressioni per le regole di avviso gestite da Grafana. Per ogni espressione, puoi scegliere tra le espressioni matematiche, di riduzione e di ricampionamento. Queste sono chiamate regole multidimensionali, perché generano un avviso separato per ogni serie.
Puoi anche utilizzare una condizione classica, che crea una regola di avviso che attiva un singolo avviso quando viene soddisfatta la relativa condizione. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie.
Nota
Le condizioni classiche esistono principalmente per motivi di compatibilità e dovrebbero essere evitate se possibile.
Ridurre
Aggrega i valori delle serie temporali nell'intervallo temporale selezionato in un unico valore.
Math (Matematica)
Esegue funzioni/operazioni matematiche in formato libero su serie temporali e dati numerici. Può essere utilizzato per preelaborare i dati delle serie temporali o per definire una condizione di avviso per i dati numerici.
Ricampionare
Riallinea un intervallo di tempo a un nuovo set di timestamp, utile quando si confrontano dati di serie temporali provenienti da diverse fonti di dati in cui i timestamp altrimenti non si allineerebbero.
Threshold
Verifica se alcuni dati delle serie temporali corrispondono alla condizione di soglia.
L'espressione di soglia consente di confrontare due valori singoli. Viene restituita 0 quando la condizione è falsa e 1 se la condizione è vera. Sono disponibili le seguenti funzioni di soglia:
-
È superiore a (x > y)
-
È inferiore a (x < y)
-
È inferiore a (x y1 E x < y2)
-
< y1 AND x >È al di fuori dell'intervallo (x y2)
Condizione classica
Verifica se alcuni dati delle serie temporali corrispondono alla condizione di avviso.
Nota
Le classiche interrogazioni con espressioni di condizione producono sempre una sola istanza di avviso, indipendentemente dal numero di serie temporali che soddisfano la condizione. Le condizioni classiche esistono principalmente per motivi di compatibilità e dovrebbero essere evitate se possibile.
Aggregazioni
Grafana Alerting offre le seguenti funzioni di aggregazione per consentirti di affinare ulteriormente la tua query.
Queste funzioni sono disponibili solo per le espressioni condizionali Reduce e Classic.
| Funzione | Expression | Cosa fa |
|---|---|---|
| avg | Riduci/Classico | Visualizza la media dei valori |
| min | Riduci/Classic | Visualizza il valore più basso |
| max | Riduci/Classic | Visualizza il valore più alto |
| sum | Riduci/Classic | Visualizza la somma di tutti i valori |
| count | Riduci/Classic | Conta il numero di valori nel risultato |
| last | Riduci/Classic | Visualizza l'ultimo valore |
| median | Riduci/Classic | Visualizza il valore mediano |
| diff | Classic | Visualizza la differenza tra il valore più recente e quello più vecchio |
| diff_abs | Classic | Visualizza il valore assoluto di diff |
| percent_diff | Classic | Visualizza il valore percentuale della differenza tra il valore più recente e quello più vecchio |
| percent_diff_abs | Classic | Visualizza il valore assoluto di percent_diff |
| count_non_null | Classic | Visualizza un conteggio di valori nel set di risultati che non lo sono null |
Condizione di avviso
Una condizione di avviso è l'interrogazione o l'espressione che determina se l'avviso verrà attivato o meno a seconda del valore che produce. Può esserci una sola condizione che determinerà l'attivazione dell'avviso.
Dopo aver definito le query e/o le espressioni, scegline una come condizione della regola di avviso.
Quando i dati richiesti soddisfano la condizione definita, Grafana attiva l'avviso associato, che può essere configurato per inviare notifiche attraverso vari canali come e-mail, Slack o. PagerDuty Le notifiche ti informano sulla condizione soddisfatta, consentendoti di intraprendere le azioni appropriate o di indagare sul problema sottostante.
Per impostazione predefinita, l'ultima espressione aggiunta viene utilizzata come condizione di avviso.
Soglia di ripristino
Per ridurre il rumore generato dagli avvisi che lampeggiano, è possibile impostare una soglia di ripristino diversa dalla soglia di avviso.
Gli avvisi flapping si verificano quando una metrica si aggira intorno alla soglia di avviso e possono portare a frequenti cambiamenti di stato, con conseguente generazione di troppe notifiche.
Le regole di avviso gestite da Grafana vengono valutate per un intervallo di tempo specifico. Durante ogni valutazione, il risultato della query viene confrontato con la soglia impostata nella regola di avviso. Se il valore di una metrica è superiore alla soglia, viene attivata una regola di avviso e viene inviata una notifica. Quando il valore scende al di sotto della soglia ed è presente un avviso attivo per questa metrica, l'avviso viene risolto e viene inviata un'altra notifica.
Può essere difficile creare una regola di avviso per una metrica rumorosa. Cioè, quando il valore di una metrica supera e scende continuamente al di sopra e al di sotto di una soglia. Questa operazione si chiama flapping e genera una serie di notifiche di attivazione (risolte) e una cronologia dello stato di allarme rumoroso.
Ad esempio, se hai un avviso di latenza con una soglia di 1000 ms e il numero oscilla intorno a 1000 (ad esempio 980 ->1010 -> 990 -> 1020 e così via), ognuna di queste attiverà una notifica.
Per risolvere questo problema, puoi impostare una soglia di ripristino (personalizzata), che in pratica significa avere due soglie anziché una. Un avviso viene attivato quando viene superata la prima soglia e viene risolto solo quando viene superata la seconda soglia.
Ad esempio, è possibile impostare una soglia di 1000 ms e una soglia di ripristino di 900 ms. In questo modo, una regola di avviso smetterà di attivarsi solo quando scende al di sotto di 900 ms e il flapping viene ridotto.
