Annotazione delle visualizzazioni

Le annotazioni forniscono un modo per contrassegnare punti sul grafico con eventi complessi. Quando passi il mouse su un'annotazione, puoi ottenere la descrizione e i tag dell'evento. Il campo di testo può includere collegamenti ad altri sistemi con maggiori dettagli.

Annotazioni native

Grafana è dotato di un archivio di annotazioni nativo e della possibilità di aggiungere eventi di annotazione direttamente dal pannello grafico o tramite l'API HTTP.

Aggiungere un'annotazione

In alternativa, per aggiungere un'annotazione, Ctrl+Click o Cmd+Click nel pannello Serie temporali verrà visualizzato il popover Aggiungi annotazione.

Aggiungere un'annotazione regionale

Modifica di un'annotazione

Eliminazione di un'annotazione

Interrogazione integrata

Dopo aver aggiunto un'annotazione, sarà ancora visibile. Ciò è dovuto alla query di annotazione integrata presente in tutti i dashboard. Questa query di annotazione recupererà tutti gli eventi di annotazione che provengono dalla dashboard corrente e li mostrerà nel pannello in cui sono stati creati. Ciò include le annotazioni della cronologia dello stato di avviso. Puoi impedire che le annotazioni vengano recuperate e disegnate aprendo le impostazioni delle annotazioni (tramite il menu Dashboard cogs) e modificando la query denominata. Annotations & Alerts (Built-in)

Quando copi una dashboard utilizzando la funzione Salva con nome, riceverà un nuovo ID dashboard, quindi le annotazioni create sulla dashboard di origine non saranno più visibili nella copia. Puoi comunque mostrarle se aggiungi una nuova Annotation Query e filtra per tag. Funziona solo se le annotazioni nella dashboard di origine avevano tag in base ai quali filtrare.

Interrogazione per tag

È possibile creare nuove query per recuperare le annotazioni dall'archivio di annotazioni nativo tramite l'origine -- Grafana -- dati impostando Filtra per su. Tags

Grafana v8.1 e versioni successive supportano anche il typeahead dei tag esistenti, forniscono almeno un tag.

Ad esempio, create il nome di una query di annotazione outages e specificate un tag. outage Questa query mostrerà tutte le annotazioni (da qualsiasi dashboard o tramite API) con il tag di interruzione. Se in una query di annotazione sono definiti più tag, Grafana mostrerà solo le annotazioni che corrispondono a tutti i tag. Per modificare il comportamentoMatch any, abilita e Grafana mostrerà le annotazioni che contengono uno dei tag che hai fornito.

In Grafana v5.3+ è possibile utilizzare variabili modello nella query dei tag. Quindi, se hai una dashboard che mostra le statistiche per diversi servizi e una variabile modello che determina quali servizi mostrare, ora puoi usare la stessa variabile modello nella tua query di annotazione per mostrare solo le annotazioni per quei servizi.

Interrogazione di altre fonti di dati

Gli eventi di annotazione vengono recuperati tramite query di annotazione. Per aggiungere una nuova query di annotazione a una dashboard, apri il menu delle impostazioni della dashboard, quindi seleziona Annotazioni. Si aprirà la visualizzazione delle impostazioni delle annotazioni della dashboard. Per creare una nuova query di annotazione, premi il pulsante Nuovo.

Specificate un nome per la richiesta di annotazione. Questo nome viene assegnato all'interruttore (casella di controllo) che consente di abilitare o disabilitare la visualizzazione degli eventi di annotazione da questa query. Ad esempio, potresti avere due query di annotazione denominate e. Deploys Outages L'interruttore ti permetterà di decidere quali annotazioni mostrare.

Dettagli della richiesta di annotazione

Le opzioni di interrogazione delle annotazioni sono diverse per ogni fonte di dati. Per informazioni sulle annotazioni in una fonte di dati specifica, consulta l'argomento relativo all'origine dati specifica.