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à.
Esplora
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
In un'area di lavoro Grafana, l'interfaccia utente della dashboard fornisce strumenti per la creazione di dashboard per la visualizzazione. Explore elimina tutte le opzioni della dashboard e del pannello in modo che tu possa concentrarti sulla query. Iterate fino a ottenere una query funzionante, quindi pianificate e create una dashboard.
Per il monitoraggio dell'infrastruttura e la risposta agli incidenti, non è più necessario passare ad altri strumenti per eseguire il debug di ciò che è andato storto. Puoi usare Explore per approfondire le metriche e i log e trovare la causa.
Explore semplifica la visualizzazione dei dati senza creare una dashboard. Se la tua fonte di dati supporta dati grafici e tabellari, Explore mostra i risultati sia come grafico che come tabella. Questo ti aiuta a vedere le tendenze dei dati e maggiori dettagli allo stesso tempo.
Inizia a esplorare
Nota
Per impostazione predefinita, gli utenti con il ruolo Viewer non possono modificare e non hanno accesso a Explore.
L'icona Esplora nel menu a sinistra apre una scheda Esplora vuota.
Per iniziare con un'interrogazione esistente in un pannello, scegliete l'opzione Esplora dal menu del pannello. Si apre una scheda Esplora che contiene l'interrogazione del pannello. Puoi quindi modificare o iterare la query all'esterno della dashboard.
Scegli la tua fonte di dati dall'elenco a discesa in alto a sinistra. Prometheus ha un'implementazione Explore personalizzata. Le altre fonti di dati utilizzano il loro editor di query standard.
Nel campo delle interrogazioni, puoi scrivere la tua query ed esplorare i tuoi dati. Ci sono tre pulsanti accanto al campo di interrogazione, un pulsante di cancellazione (X), un pulsante di aggiunta di query (+) e il pulsante di rimozione della query (-). Come nell'editor di interrogazioni del pannello, puoi aggiungere e rimuovere più interrogazioni.
Dividere e confrontare
La funzione di visualizzazione divisa è un modo per confrontare grafici e tabelle side-by-side o per esaminare i dati correlati insieme su un'unica pagina. Scegliete Dividi per duplicare la query corrente e dividere la pagina in due side-by-side interrogazioni. Hai la possibilità di selezionare una fonte di dati diversa per la nuova query. In questo modo è possibile confrontare la stessa query per due server diversi o confrontare l'ambiente di staging con l'ambiente di produzione.
Nella visualizzazione divisa, è possibile collegare i selettori temporali per entrambi i pannelli (se si modifica uno, viene modificato anche l'altro) scegliendo uno dei pulsanti di sincronizzazione temporale collegati ai selettori temporali. Il collegamento dei selettori temporali aiuta a mantenere sincronizzati gli orari di inizio e di fine delle interrogazioni con visualizzazione divisa, in modo da visualizzare lo stesso intervallo di tempo in entrambi i pannelli divisi.
È possibile chiudere l'interrogazione appena creata scegliendo Chiudi Dividi.
Condivisione di un link abbreviato
Utilizza la funzionalità Condividi link abbreviato per creare URL più piccoli e semplici dello stesso formato /goto/:uid
invece di condividere URL più lunghi che contengono parametri di query complessi. Puoi creare un link abbreviato scegliendo l'opzione Condividi nella barra degli strumenti Esplora. Tutti i link abbreviati che non vengono mai utilizzati vengono eliminati automaticamente dopo 7 giorni.
Cronologia delle query
La cronologia delle query è un elenco di query utilizzate in Explore. La cronologia è locale del browser e non è condivisa. Per aprire e interagire con la cronologia, scegli Cronologia delle interrogazioni in Esplora.
Visualizzazione della cronologia delle interrogazioni
Nella cronologia delle interrogazioni, puoi fare quanto segue:
-
Eseguire una query.
-
Crea o modifica un commento.
-
Copia un'interrogazione negli appunti.
-
Copia negli appunti un link abbreviato con la query.
-
Inizia un'interrogazione.
Gestione delle interrogazioni preferite
Tutte le interrogazioni che sono state contrassegnate come speciali nella scheda Cronologia delle interrogazioni vengono visualizzate nella scheda Speciali. Puoi accedere più rapidamente alle tue query preferite e riutilizzarle senza doverle digitare nuovamente.
Ordina la cronologia delle query
Per impostazione predefinita, la cronologia delle interrogazioni mostra le query più recenti. Puoi ordinare la cronologia per data o per nome della fonte di dati in ordine crescente o decrescente.
Sul lato destro della cronologia delle query, nell'elenco a discesa, scegli una delle seguenti opzioni: campo.
-
Prima il più recente
-
Prima il più vecchio
-
Fonte dati A-Z
-
Fonte dati Z-A
Nota
Se è attiva la visualizzazione divisa, la modalità di ordinamento si applica solo al pannello attivo.
Filtra la cronologia delle interrogazioni
Nelle schede Cronologia delle interrogazioni e Speciali, puoi filtrare la cronologia delle query in base al nome dell'origine dati.
-
Scegli Filtra le interrogazioni per fonti di dati specifiche.
-
Seleziona la fonte di dati che desideri utilizzare per filtrare la cronologia. Puoi selezionare più fonti di dati.
Nella scheda Cronologia delle interrogazioni, puoi utilizzare il cursore verticale per filtrare le query per data:
-
Trascina la maniglia inferiore per modificare la data di inizio.
-
Trascina la maniglia superiore per modificare la data di fine.
Nota
Se la visualizzazione è divisa, i filtri vengono applicati solo al pannello attivo.
Ricerca nella cronologia delle interrogazioni
Puoi cercare nella cronologia tra le domande e i commenti. La ricerca è possibile nelle schede Cronologia delle interrogazioni e Speciali.
-
Scegli il campo Interrogazioni di ricerca.
-
Nel campo di ricerca, inserisci il termine di ricerca.
Impostazioni della cronologia delle interrogazioni
È possibile personalizzare la cronologia delle interrogazioni nella scheda Impostazioni. La tabella seguente elenca le opzioni disponibili.
Impostazione | Valore predefinito |
---|---|
Specificate per quanto tempo Grafana salverà la cronologia delle vostre interrogazioni. | 1 settimana |
Cambia la scheda attiva predefinita. | Scheda della cronologia delle interrogazioni |
Mostra le interrogazioni solo per la fonte di dati attualmente attiva in Explore. | True |
Cancella la cronologia delle interrogazioni. | (Scegli Cancella cronologia delle interrogazioni per eliminare definitivamente tutte le query memorizzate.) |
Nota
Le impostazioni della cronologia delle interrogazioni sono globali e vengono applicate a entrambi i pannelli in modalità split.
Funzionalità specifiche di Prometheus
La prima versione di Explore offre un'esperienza di interrogazione personalizzata per Prometheus. Quando si esegue una query, Grafana esegue in realtà due query: una normale query Prometheus per il grafico e una Instant Query per la tabella. Una Instant Query restituisce l'ultimo valore per ogni serie temporale, che mostra un buon riepilogo dei dati mostrati nel grafico.
Esploratore di metriche
Sul lato sinistro del campo di interrogazione, scegli Metriche per aprire Metric Explorer. Questo mostra un menu gerarchico con metriche raggruppate in base al loro prefisso. Ad esempio, tutte le metriche di Alertmanager sono raggruppate sotto il prefisso. alertmanager
Questo è un buon punto di partenza per esplorare quali metriche sono disponibili.
Campo di interrogazione
Il campo Query supporta il completamento automatico dei nomi delle metriche, delle funzioni e funziona più o meno allo stesso modo dell'editor di query standard di Prometheus. Premi Invio per eseguire una query.
È possibile accedere al menu di completamento automatico premendo Ctrl+Spazio. Il menu di completamento automatico contiene una nuova sezione Cronologia con un elenco di interrogazioni eseguite di recente.
I suggerimenti possono essere visualizzati nel campo Query. Scegli un suggerimento per aggiornare la tua query con la modifica suggerita.
-
Per i contatori (metriche che aumentano in modo monotono), è consigliata una funzione di frequenza.
-
Per i bucket, è consigliata una funzione istogramma.
-
Per le regole di registrazione, è possibile espandere le regole.
Filtri da tabella
Scegliete il pulsante Filtro nella colonna dell'etichetta di un pannello di tabella per aggiungere filtri all'espressione di interrogazione. È possibile aggiungere filtri anche per più interrogazioni. Il filtro viene aggiunto per tutte le query.
Integrazione dei log
Puoi anche utilizzare Explore per esaminare i tuoi log con le seguenti fonti di dati:
-
InfluxDB
-
Elasticsearch
Visualizzazione dei log
I risultati delle interrogazioni di log vengono mostrati come istogrammi nel grafico, mentre i singoli log vengono visualizzati di seguito. Se l'origine dati non invia i dati dell'istogramma per l'intervallo di tempo richiesto, il modello di log calcola una serie temporale basata sul numero di righe di registro raggruppato in intervalli di tempo calcolati automaticamente. L'inizio dell'istogramma viene quindi ancorato al timestamp della prima riga di registro relativo al risultato. La fine della serie temporale è ancorata all'intervallo To del selettore orario.
Livello di log
Per i log in cui è specificata un'etichetta di livello, Grafana utilizza il valore dell'etichetta per determinare il livello di registro e aggiornare il colore di conseguenza. Se nel registro non è specificata un'etichetta di livello, Grafana analizza il registro per scoprire se il suo contenuto corrisponde a una delle espressioni supportate. Il livello di registro è sempre determinato dalla prima corrispondenza. Se Grafana non è in grado di determinare un livello di registro, verrà visualizzato con il livello di registro sconosciuto. La tabella seguente elenca i livelli di registro e la mappatura delle abbreviazioni e delle espressioni a livello di registro.
Espressioni supportate | Livello di log | Colore |
---|---|---|
emerg | critico | viola |
fatali | critico | viola |
avviso | critico | viola |
critica | critico | viola |
critico | critico | viola |
errare | error | rosso |
errore | error | rosso |
error | error | rosso |
avviso | attenzione | giallo |
attenzione | attenzione | giallo |
Info | Info | verde |
Informazioni | Info | verde |
avviso | Info | verde |
debug | debug | blu |
debug | debug | blu |
tracciano | tracciano | blu chiaro |
* | sconosciuto | grigio |
opzioni di visualizzazione
È possibile personalizzare la modalità di visualizzazione dei registri e selezionare le colonne da visualizzare.
Orario
Questa opzione mostra o nasconde la colonna temporale. Questo è il timestamp associato alla riga di registro riportata dalla fonte di dati.
Etichette uniche
Questa opzione mostra o nasconde la colonna delle etichette univoche, che include solo etichette non comuni. Tutte le etichette comuni sono visualizzate sopra.
Avvolgi le linee
Per utilizzare l'avvolgimento delle linee nel display, impostalo su True. L'impostazione di questa opzione su False comporta lo scorrimento orizzontale.
Deduppare
I dati di registro possono essere molto ripetitivi. Explore può aiutarti nascondendo le righe di registro duplicate. È possibile scegliere tra diversi algoritmi di deduplicazione:
-
Esatto: le corrispondenze esatte vengono eseguite sull'intera riga ad eccezione dei campi data.
-
Numeri: le corrispondenze vengono eseguite sulla riga dopo aver eliminato numeri come durate, indirizzi IP e così via.
-
Firma: la deduplicazione più aggressiva, elimina tutte le lettere e i numeri. Le corrispondenze vengono eseguite sullo spazio bianco e sulla punteggiatura rimanenti.
Inverti l'ordine dei risultati
È possibile modificare l'ordine dei log ricevuti dall'ordine decrescente predefinito (prima il più recente) all'ordine crescente (prima il più vecchio).
Etichette e campi rilevati
Ogni riga di registro ha un'area estensibile con le relative etichette e i campi rilevati, per un'interazione più solida. Per tutte le etichette, puoi filtrare per (filtro positivo) e filtrare (filtro negativo) le etichette selezionate. Ogni campo o etichetta ha anche un'icona delle statistiche per visualizzare statistiche una tantum relative a tutti i log visualizzati.
Attiva/disattiva i campi rilevati
Se i log sono strutturati in JSON o logfmt, puoi mostrare o nascondere i campi rilevati. Espandi una riga di registro, quindi scegli l'icona a forma di occhio per mostrare o nascondere i campi.
{{< docs-imagebox img=» /img/docs/explore/parsed-fields-7-2.gif "max-width="800px» caption="Attivazione dei campi rilevati in Explore» >}}
Tracciamento dell'integrazione
Puoi visualizzare le tracce provenienti da fonti di dati di tracciamento in Explore. Fonti di dati attualmente supportate:
Per informazioni sull'utilizzo dell'editor di query, consulta la documentazione relativa alla fonte di dati specifica.
Header
L'intestazione include i seguenti elementi:
-
Titolo dell'intestazione, che mostra il nome del root span e dell'ID di traccia
-
Ricerca, che evidenzia gli intervalli che contengono il testo cercato
-
Metadati relativi alla traccia
Minimappa
La minimappa mostra una vista condensata della sequenza temporale della traccia. Trascina il mouse sulla minimappa per ingrandire un intervallo di tempo più piccolo. Lo zoom aggiornerà anche la sequenza temporale principale, quindi sarà facile vedere intervalli più brevi. Se fai una pausa sulla minimappa, quando viene ingrandita, puoi vedere il pulsante Reimposta selezione, che reimposta lo zoom.
Sequenza temporale
La timeline mostra un elenco di intervalli all'interno della traccia. Ogni riga di estensione è composta dai seguenti componenti:
-
Pulsante Espandi figli: espande o comprime tutti gli intervalli secondari dell'intervallo selezionato
-
Nome servizio: nome del servizio che ha registrato l'intervallo
-
Nome dell'operazione: nome dell'operazione rappresentata da questo intervallo
-
Barra della durata dell'intervallo: rappresentazione visiva della durata dell'operazione all'interno della traccia
Scegliendo un punto qualsiasi della riga di span vengono visualizzati i dettagli dell'intervallo.
I dettagli dell'intervallo
I dettagli dell'intervallo includono i seguenti elementi:
-
Nome operazione
-
Metadati Span
-
Tag (qualsiasi tag associato a questo intervallo)
-
Metadati del processo (metadati relativi al processo che ha registrato questo intervallo)
-
Registri: elenco dei log registrati da questo intervallo e dei valori chiave associati. Nel caso dei registri Zipkin, la sezione mostra le annotazioni Zipkin.
Navigazione tra Explore e una dashboard
Per accelerare i flussi di lavoro che prevedono il passaggio regolare da Esplora a una dashboard e viceversa, abbiamo aggiunto la possibilità di tornare alla dashboard di origine dopo aver navigato su Esplora dal menu a discesa del pannello.
Dopo aver navigato su Esplora, dovresti notare un pulsante «Indietro» nella barra degli strumenti Esplora.
Basta scegliere il pulsante per tornare alla dashboard di origine oppure, se desideri riportare le modifiche apportate in Esplora nella dashboard, scegli semplicemente la freccia accanto al pulsante per visualizzare la voce di menu «Torna al pannello con le modifiche».
Interroga l'ispettore
Per facilitare il debug delle query, Explore consente di esaminare le richieste e le risposte alle query, nonché le statistiche sulle query, tramite Query inspector. Questa funzionalità è simile alla scheda Statistiche dell'ispettore del pannello e alla scheda Query. Per ulteriori informazioni, consultare Ispeziona le prestazioni delle query e Visualizza la richiesta e la risposta non elaborate alla fonte di dati.