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à. # Annotazione delle visualizzazioni **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 12.x di Grafana, vedere. [Funzionamento nella versione 12 di Grafana](using-grafana-v12.md) Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) 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** 1. Nella dashboard, fai clic sul pannello **Serie temporali**. Apparirà un menu contestuale. 1. Nel menu contestuale, fai clic su **Aggiungi annotazione.** 1. Aggiungi una descrizione dell'annotazione e, facoltativamente, dei tag. 1. Fai clic su **Salva**. 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** 1. Nella dashboard `Ctrl+Click` o `Cmd+Click` nel pannello **Serie temporali**. 1. Nel menu contestuale, fai clic su **Aggiungi annotazione.** 1. Aggiungi una descrizione dell'annotazione e, facoltativamente, dei tag. 1. Fai clic su **Salva**. **Modifica di un'annotazione** 1. Nella dashboard, posiziona il mouse su un indicatore di annotazione nel pannello Serie **temporali**. 1. Fai clic sull'icona di modifica (matita) nel tooltip di annotazione. 1. Modifica la descrizione e, facoltativamente, i tag. 1. Fai clic su **Salva**. **Eliminazione di un'annotazione** 1. **Nella dashboard, posiziona il mouse su un indicatore di annotazione nel pannello Serie temporali.** 1. Fai clic sull'icona del cestino nel tooltip di annotazione. **Built-in query** 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 comportamento`Match 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](AMG-data-sources.md) specifica.