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à.
Interrogazioni registrate
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.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 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana
Puoi vedere le tendenze nel tempo scattando un'istantanea di un punto dati su un intervallo prestabilito utilizzando le query registrate. Questo può darti un'idea delle tendenze storiche.
Per i plugin che non restituiscono serie temporali, potrebbe essere utile tracciare dati storici. Ad esempio, potresti voler eseguire una query ServiceNowper visualizzare una cronologia dei tempi di risposta alle richieste, ma puoi restituire solo le point-in-time metriche correnti.
Come funzionano le interrogazioni registrate
Le query registrate funzionano solo con i plugin di origine dati di backend. Per ulteriori informazioni, consulta il plugin Backend
-
riga e colonna singole: una query che restituisce una sola riga e colonna.
-
conteggio delle righe: una query che restituisce righe significative da contare.
-
espressione - Qualsiasi espressione. Per ulteriori informazioni sulla creazione e l'utilizzo di espressioni, consulta Espressioni
.
Dopo aver creato o abilitato un'interrogazione registrata, crea immediatamente un'istantanea e continua a creare istantanee all'intervallo impostato. La query registrata interrompe l'acquisizione di istantanee quando è disabilitata, eliminata o quando Grafana non è in esecuzione. I punti dati vengono raccolti nel backend eseguendo la query registrata e inoltrando ogni risultato a un'istanza Prometheus abilitata alla scrittura remota.
Nota
È necessario configurare un'origine dati Prometheus e associarla a una destinazione di scrittura remota prima di poter utilizzare le query registrate.
Creare un'interrogazione registrata
Per creare un'interrogazione registrata, completare i seguenti passaggi:
-
Trova o crea un'interrogazione che desideri registrare su una dashboard in un pannello di modifica. La query deve restituire solo una riga e una colonna. Se ne restituisce di più, è comunque possibile registrare il numero di risultati restituiti utilizzando l'opzione count. L'origine dati della query deve essere una fonte di dati di backend. Le espressioni possono essere utilizzate per aggregare i dati di una query di serie temporali. Per ulteriori informazioni sulla creazione e l'utilizzo di espressioni, consulta Espressioni
. -
Scegliete il menu Record Query che si trova nell'editor delle interrogazioni.
-
Inserite le informazioni di interrogazione registrate. Tutti i campi sono obbligatori se non diversamente indicato.
-
Nome: nome dell'interrogazione registrata.
-
Descrizione - (opzionale) Descrivi l'interrogazione registrata come desideri che appaia nell'elenco delle interrogazioni registrate.
-
Intervallo: l'intervallo in cui verrà scattata l'istantanea. L'intervallo inizia quando si crea l'interrogazione registrata e si interrompe se si mette in pausa o si elimina l'interrogazione registrata. Per ulteriori informazioni sulla sospensione e l'eliminazione delle interrogazioni registrate, consulta Gestione delle interrogazioni registrate.
-
Intervallo: l'intervallo di tempo relativo dell'interrogazione. Se si seleziona un intervallo di 30 m e un intervallo di 1 ora, l'interrogazione scatterà un'istantanea ogni ora degli ultimi 30 minuti.
-
Conta i risultati della query: se desideri contare le righe restituite dalla query, attiva questa opzione. Se questa opzione è disattivata, la query deve restituire una riga con un valore.
-
-
Verifica la query registrata scegliendo il pulsante Test Recorded Query.
-
Scegli Avvia la registrazione della query.
Aggiungere una query registrata
È possibile aggiungere interrogazioni registrate esistenti ai pannelli di una dashboard. Per ogni query registrata che aggiungi, viene creata una query Prometheus:. generated_recorded_query_name{id="generated_id", name="recorded query
name"} La query creata da Prometheus restituisce tutte le istantanee raccolte dalla query registrata.
-
Accedi a un pannello in una dashboard in cui desideri aggiungere una query registrata.
-
Scegli il menu + Interrogazione registrata.
-
Se desideri filtrare le query registrate per fonte di dati, seleziona una fonte di dati dal menu a discesa Filtra per fonte di dati.
-
Scegli il menu Aggiungi sulla query registrata per aggiungerla al pannello.
Dopo aver aggiunto la query registrata al pannello, la fonte di dati del pannello diventerà-- Mixed --. La query registrata è rappresentata da un'Prometheusinterrogazione con un'etichetta che corrisponde al nome della query registrata. Fai riferimento a Prometheus
Se dopo aver aggiunto una query registrata, viene visualizzata un'interrogazione con un'origine -- Mixed -- dati anziché un'origine dati Prometheus, ciò potrebbe significare che non è stata impostata Prometheus
una destinazione di scrittura remota per le query registrate. Fate riferimento a Target di scrittura remoto
Utilizzo di un'interrogazione registrata
Per utilizzare un'interrogazione registrata, creane una e aggiungila a una dashboard. Dopodiché, può essere gestita in Preferenze dalla scheda Interrogazioni registrate.
Gestione delle interrogazioni registrate
Le interrogazioni registrate possono essere messe in pausa o attivate ed eliminate dalla scheda Interrogazioni registrate in Preferenze. L'eliminazione di una query registrata la rimuoverà da Grafana, ma le informazioni raccolte in Prometheus rimarranno lì. Mettere in pausa una query registrata non raccoglierà più nuovi punti dati finché non verrà ripristinata.
Obiettivo di scrittura remoto
La destinazione di scrittura remota è l'origine dati Prometheus su cui vengono scritti i punti dati di interrogazione registrati. Avrai bisogno di un Prometheus con la scrittura remota abilitata e dovrai creare una fonte di dati per questo Prometheus.
Per modificare la destinazione di scrittura remota, scegli Modifica destinazione di scrittura remota nel menu della console nella scheda Interrogazioni registrate in Preferenze. Seleziona l'origine dati Prometheus con la scrittura remota abilitata e inserisci il percorso di scrittura remota.
