

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à.

# Lavorare nella versione 9 di Grafana
<a name="using-grafana-v9"></a>

****  
**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 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)

Quando crei il tuo spazio di lavoro Grafana, hai la possibilità di scegliere quale versione di Grafana usare. I seguenti argomenti descrivono l'utilizzo di un'area di lavoro Grafana che utilizza la versione 9 di Grafana.

**Topics**
+ [Dashboard in Grafana versione 9](v9-dashboards.md)
+ [Pannelli e visualizzazioni in Grafana versione 9](v9-panels.md)
+ [Esplora nella versione 9 di Grafana](v9-explore.md)
+ [Avvisi nella versione 9 di Grafana](v9-alerts.md)

# Dashboard in Grafana versione 9
<a name="v9-dashboards"></a>

****  
**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 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)

Una dashboard è un insieme di uno o più [pannelli](v9-panels.md) organizzati e disposti in una o più righe. Grafana viene fornito con una varietà di pannelli che semplificano la creazione delle query giuste e personalizzano la visualizzazione in modo da poter creare la dashboard perfetta per le tue esigenze. Ogni pannello può interagire con i dati di qualsiasi configurazione. [Connessione alle origini dati](AMG-data-sources.md)

Le istantanee del pannello di controllo sono statiche. Le query e le espressioni non possono essere rieseguite dalle istantanee. Di conseguenza, se aggiorni una variabile nella query o nell'espressione, i dati del dashboard non verranno modificati.

**Topics**
+ [Utilizzo dei pannelli di controllo](v9-dash-using-dashboards.md)
+ [Creazione di dashboard](v9-dash-building-dashboards.md)
+ [Gestione dei dashboard](v9-dash-managing-dashboards.md)
+ [Condivisione di dashboard e pannelli](v9-dash-sharing.md)
+ [Gestione delle playlist](v9-dash-managing-playlists.md)
+ [Aggiungere e gestire le variabili del dashboard](v9-dash-variables.md)
+ [Valutazione dell'utilizzo del pannello di controllo](v9-dash-assess-dashboard-usage.md)
+ [Ricerca nelle dashboard in Grafana versione 9](v9-search.md)

# Utilizzo dei pannelli di controllo
<a name="v9-dash-using-dashboards"></a>

****  
**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 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)

Questo argomento fornisce una panoramica delle funzionalità e delle scorciatoie della dashboard e descrive come utilizzare la ricerca nella dashboard.

## Funzionalità
<a name="v9-dash-features"></a>

Puoi utilizzare le dashboard per personalizzare la presentazione dei dati nei seguenti modi.


|  Funzionalità  |  Description  | 
| --- | --- | 
| **1. Home** | Fai clic sull'icona principale di Grafana per essere reindirizzato alla home page configurata nell'istanza Grafana. | 
| **2. Titolo** | Quando fai clic sul titolo della dashboard, puoi cercare la dashboard contenuta nella cartella corrente. | 
| **3. Condivisione di una dashboard** | Utilizza questa opzione per condividere la dashboard corrente tramite link o istantanea. Puoi anche esportare la definizione della dashboard dalla modalità di condivisione. | 
| **4. Aggiungere un nuovo pannello** | Utilizzate questa opzione per aggiungere un pannello, una riga della dashboard o un pannello della libreria alla dashboard corrente. | 
| **5. Impostazioni del pannello di controllo** | Utilizza questa opzione per modificare il nome, la cartella e i tag della dashboard e gestire le variabili e le query di annotazione. Per ulteriori informazioni sulle impostazioni della dashboard, consulta. [Modifica delle impostazioni del pannello di controllo](v9-dash-modify-settings.md) | 
| **6. Menu a discesa Time Picker** |  Fai clic per selezionare le opzioni relative all'intervallo di tempo e impostare intervalli di tempo assoluti personalizzati. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7. Intervallo di tempo di zoom indietro**  | Fare clic per ridurre l'intervallo di tempo. Per ulteriori informazioni su come utilizzare i controlli dell'intervallo di tempo, vedere[Impostazione dell'intervallo di tempo della dashboard](#v9-dash-setting-dashboard-time-range).  | 
| **8. Dashboard rinfrescante** | Fai clic per attivare immediatamente le interrogazioni e aggiornare i dati del dashboard. | 
| **9. Aggiornamento dell'intervallo di tempo del dashboard** | Fai clic per selezionare un intervallo di tempo di aggiornamento automatico del pannello di controllo. | 
| **10. Modalità di visualizzazione**  | Fai clic per visualizzare la dashboard su uno schermo di grandi dimensioni, ad esempio una TV o un chiosco. La modalità di visualizzazione nasconde informazioni non pertinenti come i menu di navigazione.  | 
| **11. Pannello del cruscotto** |  L'elemento costitutivo principale di una dashboard è il pannello. Per aggiungere un nuovo pannello, una riga della dashboard o un pannello della libreria, fai clic su **Aggiungi pannello**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12. Legenda del grafico** | Modifica i colori delle serie, l'asse y e la visibilità delle serie direttamente dalla legenda. | 
| **13. Ricerca nel pannello di controllo** | Fai clic su **Cerca** per cercare le dashboard per nome o titolo del pannello. | 
| **14. Riga del cruscotto** | Una riga del dashboard è un divisore logico all'interno di un pannello di controllo che raggruppa i pannelli. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## Tasti di scelta rapida
<a name="v9-dash-keyboard-shortcuts"></a>

Grafana ha diverse scorciatoie da tastiera disponibili. **Per visualizzare tutte le scorciatoie da tastiera disponibili, premi?** o **h** sulla tastiera.
+ `Ctrl+S`salva la dashboard corrente. 
+ `f`apre il cerca/ricerca del pannello di controllo. 
+  `d+k`attiva la modalità chiosco (nasconde il menu). 
+ `d+e`espande tutte le righe. 
+ `d+s`apre le impostazioni della dashboard. 
+ `Ctrl+K`apre la palette dei comandi.
+ `Esc`esce dal pannello quando è in modalità di visualizzazione a schermo intero o di modifica. Consente inoltre di tornare alla dashboard dalle impostazioni della dashboard.

**Pannello focalizzato**

Per utilizzare le scorciatoie destinate a un pannello specifico, passa il mouse su un pannello con il puntatore del mouse.
+ `e`attiva o disattiva la visualizzazione del pannello 
+ `v`attiva la visualizzazione a schermo intero del pannello 
+ `ps`apre la funzione di condivisione del pannello 
+ `pd`duplica il pannello 
+ `pr`rimuove il pannello 
+ `pl`alterna la legenda del pannello 

## Impostazione dell'intervallo di tempo della dashboard
<a name="v9-dash-setting-dashboard-time-range"></a>

Grafana offre diversi modi per gestire gli intervalli di tempo dei dati visualizzati, per dashboard, pannelli e anche per gli avvisi.

Questa sezione descrive le unità di tempo supportate e gli intervalli relativi, i controlli temporali comuni, le impostazioni temporali a livello di dashboard e le impostazioni temporali specifiche del pannello.

**Unità di tempo e intervalli relativi**

Grafana supporta le seguenti unità di tempo:`s (seconds)`,,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)` `M (months)``Q (quarters)`, e. `y (years)` 

L'operatore meno ti consente di tornare indietro nel tempo, rispetto a adesso. Se desideri visualizzare il periodo completo dell'unità (giorno, settimana o mese), aggiungi `/<time unit>` alla fine. Per visualizzare i periodi fiscali, l'uso `fQ (fiscal quarter)` e le unità `fy (fiscal year)` di tempo.

L'operatore plus ti consente di avanzare nel tempo rispetto a adesso. Ad esempio, puoi utilizzare questa funzionalità per esaminare i dati previsti per il futuro.

La tabella seguente fornisce esempi di intervalli relativi.


| Esempio di intervallo relativo | Da | Per | 
| --- | --- | --- | 
| Ultimi 5 minuti |  `now-5m`  |  `now`  | 
| Il giorno finora |  `now/d`  |  `now`  | 
| Questa settimana |  `now/w`  |  `now/w`  | 
| Questa settimana finora |  `now/w`  |  `now`  | 
| Questo mese |  `now/M`  |  `now/M`  | 
| Questo mese finora |  `now/M`  |  `now`  | 
| Mese precedente |  `now-1M/M`  |  `now-1M/M`  | 
| Quest'anno finora |  `now/Y`  |  `now`  | 
| Quest'anno |  `now/Y`  |  `now/Y`  | 
| Anno fiscale precedente |  `now-1y/fy`  |  `now-1y/fy`  | 

**Nota**  
 Grafana Alerting non supporta i timestamp `now+n` futuri e `now-1n/n` l'*inizio di n fino alla fine di n* timestamp. 

**Controlli comuni dell'intervallo di tempo**

I controlli temporali della dashboard e del pannello hanno un'interfaccia utente comune. Di seguito vengono descritti i controlli comuni relativi all'intervallo di tempo.
+ L'intervallo di tempo corrente, chiamato anche *selettore temporale*, mostra l'intervallo di tempo attualmente visualizzato nella dashboard o nel pannello visualizzato. Posiziona il cursore sul campo per visualizzare i timestamp esatti dell'intervallo e la loro origine (ad esempio il browser locale). Fai clic sull'*intervallo di tempo corrente per modificarlo*. È possibile modificare l'ora corrente utilizzando un *intervallo di tempo relativo*, ad esempio gli ultimi 15 minuti, o un intervallo di tempo assoluto, ad esempio `2020-05-14 00:00:00` to`2020-05-15 23:59:59`.
+ L'**intervallo di tempo relativo** può essere selezionato dall'elenco **Intervalli temporali relativi**. Puoi filtrare l'elenco utilizzando il campo di immissione in alto. Alcuni esempi di intervalli di tempo includono *Ultimi 30 minuti*, *Ultime 12 ore*, *Ultimi 7 giorni*, *Ultimi 2 anni*, *Ieri*, *L'*altro ieri*, L'altro ieri, Questo giorno* *la settimana scorsa, *Oggi finora**, Questa settimana finora e *Questo mese finora*.
+ L'**intervallo di tempo assoluto** può essere impostato in due modi: digitando valori temporali esatti o valori temporali relativi nei campi **Da** e **A** e facendo clic su **Applica intervallo di tempo** oppure facendo clic su una data o un intervallo di date dal calendario visualizzato quando si fa clic sul campo **Da** o **A**. Per applicare le selezioni, fai clic su **Applica intervallo di tempo.**

*Altre funzionalità relative all'intervallo di tempo*

1. **Per rimpicciolire, fate clic su **Cmd\$1Z o Ctrl\$1Z**.** Fai clic sull'icona per visualizzare un intervallo di tempo più ampio nella visualizzazione della dashboard o del pannello.

1. Per utilizzare la funzione di ingrandimento, fai clic e trascina per selezionare l'intervallo di tempo nella visualizzazione che desideri visualizzare.

**Nota**  
L'ingrandimento è applicabile solo alle visualizzazioni grafiche. 

*Aggiorna i dashboard*

Fai clic sull'icona **Aggiorna dashboard** per eseguire immediatamente ogni query sulla dashboard e aggiornare le visualizzazioni. Grafana annulla qualsiasi richiesta in sospeso quando attivi un aggiornamento.

Per impostazione predefinita, Grafana non aggiorna automaticamente la dashboard. Le interrogazioni vengono eseguite secondo una propria pianificazione in base alle impostazioni del pannello. Tuttavia, se desideri aggiornare regolarmente la dashboard, fai clic sulla freccia rivolta verso il basso accanto all'icona **Aggiorna dashboard** e seleziona un intervallo di aggiornamento.

**Controlla l'intervallo di tempo utilizzando un URL**

Puoi controllare l'intervallo di tempo di una dashboard fornendo i seguenti parametri di query nell'URL della dashboard.
+ `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch, o [tempo relativo](#v9-dash-setting-dashboard-time-range).
+ `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch, o tempo relativo.
+ `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` restituisce un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.

# Creazione di dashboard
<a name="v9-dash-building-dashboards"></a>

****  
**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 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)

Dopo aver creato un'area di lavoro Grafana e aver effettuato l'accesso, puoi creare dashboard e modificare le impostazioni in base alle tue esigenze. 

**Topics**
+ [Creazione di dashboard](v9-dash-creating.md)
+ [Aggiungere o modificare pannelli](v9-dash-edit-panels.md)
+ [Modifica delle impostazioni del pannello di controllo](v9-dash-modify-settings.md)
+ [Variabili URL del pannello di controllo](v9-dash-dashboard-url-variables.md)
+ [Aggiungere un pannello della libreria alla dashboard](v9-dash-manage-library-panels.md)
+ [Gestione della cronologia delle versioni del dashboard](v9-dash-manage-version-history.md)
+ [Gestione dei collegamenti al pannello di controllo](v9-dash-manage-dashboard-links.md)
+ [Modello JSON di dashboard](v9-dash-dashboard-json-model.md)

# Creazione di dashboard
<a name="v9-dash-creating"></a>

****  
**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 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)

**Creazione di una dashboard**

Le dashboard e i pannelli consentono di mostrare i dati in forma visiva utilizzando Grafana. Ogni pannello necessita di almeno una query per visualizzare una visualizzazione. Prima di iniziare, completa i seguenti prerequisiti.
+ Assicurati di disporre delle autorizzazioni appropriate. Per ulteriori informazioni sulle autorizzazioni, consultare [Utenti, team e autorizzazioni](Grafana-administration-authorization.md).
+ Identifica la dashboard a cui desideri aggiungere il pannello.
+ Comprendi il linguaggio di interrogazione della fonte di dati di destinazione.
+ Assicurati che sia stata aggiunta la fonte di dati per la quale stai scrivendo una query.

 Per creare una dashboard:

1. **Accedi a Grafana, posiziona il cursore su Dashboard e fai clic su \$1 Nuova **dashboard**.**

1. Fai clic su **Aggiungi un nuovo pannello**.

1. Nella prima riga della scheda **Query**, fai clic sull'elenco a discesa e seleziona una fonte di dati.

1. Scrivi o costruisci una query nel linguaggio di interrogazione della tua fonte di dati.

1. Nell'elenco delle **visualizzazioni**, seleziona un tipo di visualizzazione. Grafana mostra un'anteprima dei risultati della query con la visualizzazione applicata. Per ulteriori informazioni, consulta Opzioni di [visualizzazione](v9-panels-viz.md).

1. Regola le impostazioni del pannello nei seguenti modi.
   + [Configura le mappature dei valori](v9-panels-configure-value-mappings.md)
   + [Opzioni specifiche per la visualizzazione](v9-panels-viz.md)
   + [Sostituisci i valori dei campi](v9-panels-configure-overrides.md)
   + [Configura le soglie](v9-panels-configure-thresholds.md)
   + [Configura le opzioni standard](v9-panels-configure-standard-options.md)
**Nota**  
La maggior parte delle visualizzazioni necessita di alcune modifiche prima di visualizzare correttamente le informazioni necessarie.

1. Aggiungi una nota per descrivere la visualizzazione (o descrivere le modifiche), quindi fai clic su **Salva** nell'angolo superiore destro della pagina.
**Nota**  
Le note sono utili se devi ripristinare la dashboard a una versione precedente.

**Configurazione delle righe ripetute**

Puoi configurare Grafana per aggiungere dinamicamente pannelli o righe a una dashboard in base al valore di una variabile. Le variabili modificano dinamicamente le tue query su tutte le righe di una dashboard. Per ulteriori informazioni sui pannelli ripetuti, consulta [Configurare]() i pannelli ripetuti.

Puoi anche ripetere le righe se hai delle variabili impostate `Multi-value` o `Include all values` selezionate.

Prima di iniziare, assicurati che la query includa una variabile multivalore, quindi completa i passaggi seguenti.

1. Nella home page della dashboard, fai clic su **Aggiungi pannello**.

1. Nella finestra di dialogo **Aggiungi un pannello**, fai clic su **Aggiungi una nuova riga**.

1. Passa il mouse sul titolo della riga e fai clic sull'icona a forma di ingranaggio.

1. Nella finestra di dialogo **Opzioni riga**, aggiungi un titolo e seleziona la variabile per la quale desideri aggiungere righe ripetute.
**Nota**  
 Per fornire un contesto agli utenti del dashboard, aggiungi la variabile al titolo della riga. 

**Per spostare un pannello**

1. Apri il pannello di controllo .

1. Fate clic sul titolo del pannello e trascinatelo nella nuova posizione. Puoi posizionare un pannello su una dashboard in qualsiasi posizione.

**Per ridimensionare un pannello**

1. Apri il pannello di controllo .

1. Per regolare le dimensioni del pannello, fate clic e trascinate l'angolo inferiore destro del pannello. Puoi ridimensionare un pannello della dashboard in base alle tue esigenze.

# Aggiungere o modificare pannelli
<a name="v9-dash-edit-panels"></a>

****  
**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 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)

Dopo aver creato una dashboard, puoi aggiungere, modificare o rimuovere pannelli in qualsiasi momento.
+ **Visualizza dashboard**: per visualizzare una dashboard, dal menu **Home**, seleziona **Dashboard**, quindi scegli la dashboard che desideri visualizzare. Potrebbe essere necessario espandere la cartella che contiene la dashboard.
+ **Aggiungi pannello**: per aggiungere un pannello a una dashboard, scegli l'icona **Aggiungi pannello** nella barra dei menu nella parte superiore della pagina.
+ **Pannello** di modifica Per modificare un pannello esistente su una dashboard, scegli l'icona del menu che appare quando passi il mouse sul pannello, quindi scegli **Modifica**.
+ **Rimuovi pannello** **Per rimuovere un pannello esistente su una dashboard, scegli l'icona del menu che appare quando passi il mouse sul pannello, quindi scegli Rimuovi.**

# Modifica delle impostazioni del pannello di controllo
<a name="v9-dash-modify-settings"></a>

****  
**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 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)

La pagina delle impostazioni della dashboard consente di:
+ Modificare le proprietà generali della dashboard, incluse le impostazioni dell'ora.
+ Aggiungi interrogazioni di annotazione.
+ Aggiungi variabili del pannello di controllo.
+ Aggiungi link.
+ Visualizza il modello JSON del dashboard

Per accedere alla pagina delle impostazioni della dashboard:

1. Apri una dashboard in modalità di modifica.

1. Fai clic su **Impostazioni dashboard** (icona a forma di ingranaggio) situata nella parte superiore della pagina.

**Modifica delle impostazioni relative all'ora della dashboard**

Modifica le impostazioni dell'ora della dashboard quando desideri modificare il fuso orario della dashboard, l'ora locale del browser e specificare gli intervalli di aggiornamento automatico.

**Per modificare le impostazioni dell'ora della dashboard**

1. Nella pagina delle impostazioni della **dashboard**, seleziona **Generale**.

1. Vai alla sezione **Opzioni temporali**.

1. Specificate le impostazioni dell'ora in base alle seguenti descrizioni.

1. Il fuso orario specifica il fuso orario locale del servizio o del sistema che si sta monitorando. Questo può essere utile quando si monitora un sistema o un servizio che opera in diversi fusi orari.
   + Grafana utilizza il fuso orario *predefinito* selezionato per il profilo utente, il team o l'organizzazione. Se non viene specificato alcun fuso orario per il profilo utente, per il team di cui l'utente è membro o per l'organizzazione, Grafana utilizza l'ora locale del browser.
   + Viene utilizzato il fuso orario configurato per il browser dell'utente di visualizzazione, l'*ora locale del browser*. Si tratta in genere dello stesso fuso orario impostato sul computer.
   + Utilizza i fusi [orari standard ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), incluso UTC.
+ L'**aggiornamento automatico** personalizza le opzioni visualizzate per il tempo relativo e le opzioni di aggiornamento automatico Le voci sono separate da virgole e accettano qualsiasi unità di tempo valida.
+ **Ora il ritardo** sostituisce il tempo inserendo un ritardo. `now` Utilizzate questa opzione per gestire i ritardi noti nell'aggregazione dei dati ed evitare valori nulli.
+ **Nascondi il selettore orario** rimuove la visualizzazione del selettore orario Grafana.

**Nota**  
Per avere controlli temporali, i dati devono includere una colonna temporale. Consulta la documentazione della tua [fonte di dati](AMG-data-sources.md) specifica per ulteriori informazioni sull'inclusione di una colonna temporale.

**Aggiungere una query di annotazione**

Una query di annotazione è una query che richiede gli eventi. Questi eventi possono essere visualizzati in grafici sulla dashboard come linee verticali insieme a una piccola icona su cui passare il mouse per visualizzare le informazioni sull'evento.

**Per aggiungere una query di annotazione**

1. Nella pagina delle **impostazioni della dashboard**, seleziona **Annotazioni**.

1. Seleziona **Aggiungi interrogazione di annotazione.** 

1. Inserisci un nome e seleziona una fonte di dati.

1. Completa il resto del modulo per creare una query e un'annotazione.

L'interfaccia utente dell'editor di query cambia in base all'origine dati selezionata. Consulta la documentazione sull'[origine dei dati](AMG-data-sources.md) per i dettagli su come costruire una query.

**Aggiungere una variabile**

Le variabili consentono di creare dashboard più interattivi e dinamici. Invece di codificare elementi come i nomi di server, applicazioni e sensori nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come elenchi a discesa nella parte superiore della dashboard. Questi menu a discesa semplificano la modifica dei dati visualizzati nella dashboard.

[Per ulteriori informazioni sulle variabili, consulta Variabili.](v9-dash-variables.md)

1. Nella pagina **delle impostazioni della dashboard**, fai clic su **Variabile** nel menu della sezione a sinistra, quindi sul pulsante **Aggiungi variabile**.

1. Nella sezione **Generale**, il nome della variabile. Questo è il nome che verrà utilizzato in seguito nelle query.

1. Seleziona un **tipo** di variabile.
**Nota**  
Il tipo di variabile selezionato influisce sui campi che compili nella pagina.

1. Definite la variabile e fate clic su **Aggiorna**.

**Aggiungere un link**

I link alla dashboard consentono di inserire collegamenti ad altre dashboard e siti Web direttamente sotto l'intestazione della dashboard. I link facilitano la navigazione verso altre dashboard e contenuti correlati. 

1.  Nella pagina **delle impostazioni della dashboard**, fai clic su **Collegamenti** nel menu della sezione a sinistra, quindi sul pulsante **Aggiungi link**. 

1.  Inserisci il titolo e, nel campo **Tipo**, seleziona **Dashboard** o **Link**. 

1.  Per aggiungere un link alla dashboard, aggiungi un tag opzionale, seleziona una delle opzioni del link alla dashboard e fai clic su **Applica**. 
**Nota**  
I tag sono utili per creare un menu a discesa dinamico di dashboard che hanno tutte un tag specifico. 

1.  Per aggiungere un link, aggiungi un URL e un testo del tooltip che appaiono quando l'utente passa il mouse sul link, seleziona un'icona che appare accanto al link e seleziona una delle opzioni del link della dashboard. 

**Visualizza il modello JSON della dashboard** 

Una dashboard in Grafana è rappresentata da un oggetto JSON, che memorizza i metadati della relativa dashboard. I metadati della dashboard includono le proprietà della dashboard, i metadati dei pannelli, le variabili del modello, le interrogazioni dei pannelli e così via. 

**Per visualizzare un modello JSON di dashboard, nella pagina delle **impostazioni della dashboard**, fai clic su JSON.**

[Per ulteriori informazioni sui campi JSON, consulta Campi JSON.](v9-dash-dashboard-json-model.md)

# Variabili URL del pannello di controllo
<a name="v9-dash-dashboard-url-variables"></a>

****  
**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 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)

Grafana può applicare valori variabili passati come parametri di query nella dashboard. URLs Per ulteriori informazioni, consulta [Gestire i collegamenti alla dashboard e i](v9-dash-manage-dashboard-links.md) [modelli e le variabili](v9-dash-variables.md).

**Passare le variabili come parametri di interrogazione**

Grafana interpreta i parametri della stringa di query con il prefisso `var-` come variabili nella dashboard fornita.

Ad esempio, in questo URL: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Il parametro query `var-example=value` rappresenta l'esempio di variabile del dashboard con un valore di`value`.

**Passare più valori per una variabile**

Per passare più valori, ripetete il parametro variabile una volta per ogni valore.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana viene interpretata `var-example=value1&var-example=value2` come l'esempio di variabile del dashboard con due valori: e. `value1` `value2`

**Aggiungere variabili ai link del pannello di controllo**

Grafana può aggiungere variabili ai link del dashboard quando li generi dalle impostazioni di una dashboard. Per ulteriori informazioni e passaggi per aggiungere variabili, consulta [Gestire i collegamenti alla dashboard](v9-dash-manage-dashboard-links.md).

**Passaggio di filtri ad hoc**

I filtri ad hoc applicano filtri chiave o di valore a tutte le query metriche che utilizzano una fonte di dati specificata. Per ulteriori informazioni, consulta Filtri [ad hoc.]()

Per passare un filtro ad hoc come parametro di query, utilizzate la sintassi della variabile per passare la variabile di filtro ad hoc e fornite anche la chiave, l'operatore come valore e il valore come elenco separato da un tubo.

Ad esempio, in questo URL:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Il parametro query `var-adhoc=key|=|value` applica il filtro ad hoc configurato come variabile di dashboard ad hoc utilizzando la `example_key` chiave, l'`=`operatore e il valore. `example_value`

**Nota**  
Quando condividi URLs con filtri ad hoc, ricorda di codificare l'URL. Nell'esempio precedente, sostituite le pipe `(|)` con `%7C` e l'operatore `(=)` di uguaglianza con. ` %3D`

**Controllo dell'intervallo di tempo tramite l'URL**

Per impostare l'intervallo di tempo di una dashboard, utilizza i parametri `from``to`,`time`, e di `time.window` query. Poiché non si tratta di variabili, non richiedono il `var-` prefisso.

# Aggiungere un pannello della libreria alla dashboard
<a name="v9-dash-manage-library-panels"></a>

****  
**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 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)

Un pannello libreria è un pannello riutilizzabile che puoi usare in qualsiasi dashboard. Quando modificate un pannello della libreria, la modifica si propaga a tutte le istanze in cui viene utilizzato il pannello. I pannelli della libreria semplificano il riutilizzo dei pannelli su più dashboard.

Puoi salvare un pannello della libreria in una cartella insieme ai dashboard salvati.

**Creazione di un pannello della libreria**

Quando create un pannello della libreria, anche il pannello sulla dashboard di origine viene convertito in un pannello della libreria. È necessario salvare la dashboard originale dopo la conversione di un pannello.

1. Apri un pannello in modalità di modifica.

1. Nelle opzioni di visualizzazione del pannello, fai clic sull'opzione freccia giù per apportare modifiche alla visualizzazione.

1. Per aprire la finestra di dialogo **Crea**, fate clic sull'opzione **Pannelli Libreria**, quindi fate clic sul **pannello Crea libreria**.

1. Nel **nome del pannello Libreria**, inserite il nome.

1. In **Salva nella cartella**, selezionate la cartella in cui salvare il pannello della libreria.

1. Per salvare le modifiche, fate clic su **Crea pannello libreria**.

1. Per salvare la dashboard, fai clic su **Salva**.

Dopo aver creato un pannello della libreria, puoi modificare il pannello utilizzando qualsiasi dashboard in cui è visualizzato. Dopo aver salvato le modifiche, tutte le istanze del pannello della libreria riflettono tali modifiche.

**Aggiungere un pannello della libreria a una dashboard**

Aggiungi un pannello della libreria Grafana a una dashboard quando desideri fornire visualizzazioni ad altri utenti della dashboard.

1. Passa il mouse sull'opzione **Dashboards** nel menu a sinistra, quindi seleziona **Nuova dashboard** dalle opzioni a discesa. Si aprirà la finestra **di dialogo Aggiungi pannello**.

1. Fate clic sull'opzione **Aggiungi un pannello** dalla libreria del pannello. Verrà visualizzato un elenco dei pannelli della libreria.

1. Filtra l'elenco o cerca il pannello che desideri aggiungere.

1. Fai clic su un pannello per aggiungerlo alla dashboard.

**Scollegare un pannello della libreria**

Scollegate un pannello della libreria quando desiderate apportare una modifica al pannello e non influire sulle altre istanze del pannello della libreria.

1. **Passa il mouse su **Dashboard** nel menu a sinistra, quindi fai clic su Pannelli Libreria.**

1. Seleziona un pannello della libreria che viene utilizzato in diversi dashboard.

1. Seleziona il pannello che desideri scollegare.

1. Fate clic sul titolo del pannello, quindi su **Modifica**. Il pannello si aprirà in modalità di modifica.

1. Fai clic sull'opzione **Scollega** nell'angolo in alto a destra della pagina.

**Visualizzazione di un elenco di pannelli della libreria**

Scollegate un pannello della libreria quando desiderate apportare una modifica al pannello e non influire sulle altre istanze del pannello della libreria.

1. **Passa il mouse sull'opzione **Dashboard** nel menu a sinistra, quindi fai clic su Pannelli Libreria.** È possibile visualizzare un elenco di pannelli di libreria precedentemente definiti.

1. Cerca uno specifico pannello della libreria se ne conosci il nome. Puoi anche filtrare i pannelli per cartella o tipo.

**Eliminazione di un pannello della libreria**

Eliminate un pannello della libreria quando non vi serve più.

1. Passa il mouse su **Dashboard** nel menu a sinistra e seleziona i **pannelli Libreria**.

1. Seleziona il pannello che desideri eliminare.

1. Fate clic sull'icona di eliminazione accanto al nome della libreria.

# Gestione della cronologia delle versioni del dashboard
<a name="v9-dash-manage-version-history"></a>

****  
**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 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)

Ogni volta che salvi una versione della dashboard, viene salvata una copia di quella versione in modo che le versioni precedenti non vadano mai perse. Un elenco di queste versioni è disponibile accedendo alle impostazioni della dashboard e selezionando **Versioni** nel menu a sinistra.

La funzionalità di cronologia delle versioni della dashboard consente di confrontare e ripristinare le versioni della dashboard salvate in precedenza.

**Confronto di due versioni della dashboard**

Per confrontare due versioni della dashboard, seleziona le due versioni dall'elenco che desideri confrontare. Fai clic su **Confronta versioni** per visualizzare la differenza tra le due versioni.

Facendo clic sul pulsante, verrai indirizzato alla visualizzazione delle differenze. Per impostazione predefinita, vedrai un riepilogo testuale delle modifiche.

Se desideri visualizzare la differenza del codice JSON non elaborato che rappresenta la tua dashboard, puoi farlo anche facendo clic sul pulsante **Visualizza JSON Diff** in basso.

Se desideri ripristinare la versione con cui ti opponi, puoi farlo facendo clic sul <x>pulsante **Ripristina alla versione in alto a** destra.

**Ripristino a una versione della dashboard salvata in precedenza**

Se devi ripristinare una versione della dashboard salvata in precedenza, puoi fare clic sul pulsante **Ripristina** a destra di una riga nell'elenco delle versioni della dashboard oppure fare clic sul <x>pulsante **Ripristina alla versione** che appare nella vista delle differenze. Facendo clic sul pulsante verrà visualizzato il seguente pop-up che richiede di confermare il ripristino.

Dopo il ripristino a una versione precedente, verrà creata una nuova versione contenente gli stessi dati esatti della versione precedente, solo con un numero di versione diverso. Questo è indicato nella **colonna Note relativa** alla riga della nuova versione del dashboard. Questo viene fatto semplicemente per garantire che le versioni precedenti della dashboard non siano influenzate dalla modifica.

# Gestione dei collegamenti al pannello di controllo
<a name="v9-dash-manage-dashboard-links"></a>

****  
**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 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)

Puoi utilizzare i link per navigare tra i dashboard di uso comune o per connettere altri utenti alle tue visualizzazioni. I link consentono di creare collegamenti ad altre dashboard, pannelli e persino siti Web esterni.

Grafana supporta collegamenti a dashboard, collegamenti a pannelli e collegamenti dati. I link alla dashboard vengono visualizzati nella parte superiore della dashboard. I collegamenti ai pannelli sono accessibili facendo clic su un'icona nell'angolo superiore sinistro del pannello.

**Scelta del link da utilizzare**

Inizia a capire come stai attualmente navigando tra le dashboard. Se passi spesso da un set di dashboard all'altro e hai difficoltà a trovare lo stesso contesto in ognuna di esse, i link possono aiutarti a ottimizzare il flusso di lavoro.

Il passaggio successivo consiste nel capire quale tipo di link è adatto al tuo flusso di lavoro. Anche se tutti i tipi di link in Grafana vengono utilizzati per creare collegamenti ad altre dashboard o siti Web esterni, funzionano in contesti diversi.
+ Se il link si riferisce alla maggior parte se non a tutti i pannelli della dashboard, utilizza i link della dashboard.
+ Se vuoi approfondire pannelli specifici, usa i link ai pannelli.
+ Se desideri creare un collegamento a un sito esterno, puoi utilizzare un collegamento alla dashboard o un collegamento al pannello.
+ Se desideri approfondire una serie specifica o anche una singola misurazione, utilizza i link dati.

**Controllo dell'intervallo di tempo tramite l'URL**

Per controllare l'intervallo di tempo di un pannello o di una dashboard, puoi fornire i parametri di query nell'URL della dashboard:
+ `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch.
+ `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch.
+ `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` risulterà in un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.

**Collegamenti alla dashboard**

Quando crei un link alla dashboard, puoi includere l'intervallo di tempo e le variabili correnti del modello per passare direttamente allo stesso contesto in un'altra dashboard. In questo modo, non devi preoccuparti che la persona a cui invii il link stia visualizzando i dati giusti. Per altri tipi di link, consulta [Variabili del collegamento dati]().

I link al pannello di controllo possono essere utilizzati anche come collegamenti a sistemi esterni, ad esempio per inviare [un GitHub problema con il nome corrente della dashboard](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).

Dopo aver aggiunto un link alla dashboard, questo verrà visualizzato nell'angolo in alto a destra della dashboard.

**Aggiungere link alle dashboard**

Aggiungi link ad altre dashboard nella parte superiore della dashboard corrente.

1. Durante la visualizzazione della dashboard che desideri collegare, fai clic sull'ingranaggio nella parte superiore dello schermo per aprire **le impostazioni della dashboard**.

1. Fai clic su **Collegamenti**, quindi su **Aggiungi link alla dashboard** o su **Nuovo**.

1. In **Tipo**, seleziona **dashboard**.

1. Seleziona le opzioni di collegamento tra le seguenti.
   + **Con tag**: inserisci i tag per limitare i dashboard collegati solo a quelli con i tag che inserisci. Altrimenti, Grafana include collegamenti a tutte le altre dashboard.
   + **Come menu a discesa**: se stai collegando a molte dashboard, probabilmente vorrai selezionare questa opzione e aggiungere un titolo opzionale al menu a discesa. Altrimenti, Grafana mostra i link del pannello di controllo uno accanto all'altro nella parte superiore della dashboard.
   + **Intervallo di tempo**: seleziona questa opzione per includere l'intervallo di tempo della dashboard nel link. Quando l'utente fa clic sul collegamento, la dashboard collegata si aprirà con l'intervallo di tempo indicato già impostato.
   + **Valori delle variabili**: selezionate questa opzione per includere nel link le variabili del modello attualmente utilizzate come parametri di interrogazione. Quando l'utente fa clic sul link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori del link. Per ulteriori informazioni, consulta [Variabili URL della dashboard](v9-dash-dashboard-url-variables.md).
   + **Apri in una nuova scheda**: seleziona questa opzione se desideri che il link alla dashboard si apra in una nuova scheda o finestra.

1. Fare clic su **Add (Aggiungi)**.

**Aggiungere un link URL a una dashboard**

Aggiungi un link a un URL nella parte superiore della dashboard corrente. Puoi collegarti a qualsiasi URL disponibile, inclusi dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente sia ingrandito sui dati giusti in Grafana.

1. **Durante la visualizzazione della dashboard che desideri collegare, fai clic sull'ingranaggio nella parte superiore dello schermo per aprire le impostazioni della dashboard.**

1. Fai clic su **Collegamenti**, quindi su **Aggiungi link alla dashboard** o su **Nuovo**.

1. In Tipo, seleziona **Link**.

1. Seleziona le opzioni di collegamento tra le seguenti.
   + **URL**: inserisci l'URL a cui desideri collegarti. A seconda della destinazione, potresti voler includere i valori dei campi. Per ulteriori informazioni, guarda questo esempio di [Github](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
   + **Titolo**: inserisci il titolo che desideri venga visualizzato nel link.
   + **Suggerimento**: inserisci il tooltip che desideri venga visualizzato dal link.
   + **Icona**: scegli l'icona che desideri venga visualizzata con il link.
   + **Intervallo di tempo**: seleziona questa opzione per includere l'intervallo di tempo della dashboard nel link. Quando l'utente fa clic sul collegamento, la dashboard collegata si apre con l'intervallo di tempo indicato impostato.
     + `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch.
     + `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch.
     + `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` risulterà in un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.
   + **Valori delle variabili**: selezionate questa opzione per includere nel link le variabili del modello attualmente utilizzate come parametri di interrogazione. Quando l'utente fa clic sul link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori del link. 

     Il formato della variabile è il seguente: 

     `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2`
   + **Apri in una nuova scheda**: seleziona questa opzione se desideri che il link alla dashboard si apra in una nuova scheda o finestra

1. Fare clic su **Add (Aggiungi)**.

**Aggiornamento di un link alla dashboard**

Per modificare o aggiornare un link esistente alla dashboard, segui questa procedura.

1. Nelle **impostazioni della dashboard,** nella scheda **Collegamenti**, fai clic sul link esistente che desideri modificare.

1. Modifica le impostazioni, quindi fai clic su **Aggiorna**.

**Duplicazione di un link alla dashboard**

Per duplicare un link esistente alla dashboard, fai clic sull'icona di duplicazione accanto al link esistente che desideri duplicare.

**Eliminazione di un link alla dashboard**

Per eliminare un link esistente alla dashboard, fai clic sull'icona del cestino accanto all'icona duplicata che desideri eliminare.

**Collegamenti al pannello**

Ogni pannello può avere il proprio set di link che vengono visualizzati nell'angolo superiore sinistro del pannello. Puoi collegarti a qualsiasi URL disponibile, inclusi dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente sia ingrandito sui dati giusti in Grafana.

Per visualizzare i collegamenti disponibili ai pannelli, fai clic sull'icona nell'angolo in alto a sinistra di un pannello.
+ **Aggiungere un collegamento al pannello**: ogni pannello può avere il proprio set di link che vengono visualizzati nell'angolo superiore sinistro del pannello. Puoi collegarti a qualsiasi URL disponibile, inclusi dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente sia ingrandito sui dati giusti in Grafana. Fai clic sull'icona nell'angolo in alto a sinistra di un pannello per visualizzare i link disponibili.

  1. Passa il cursore sul pannello a cui desideri aggiungere un link, quindi premi. `e` **Oppure fai clic sulla freccia a discesa accanto al titolo del pannello, quindi fai clic su Modifica.**

  1. Nella scheda **Pannello**, scorri verso il basso fino alla sezione **Collegamenti**. 

  1. Espandi **Collegamenti**, quindi fai clic su **Aggiungi collegamento**.

  1. Inserisci un **titolo**. Il **titolo** è un'etichetta leggibile dall'uomo per il collegamento che verrà visualizzato nell'interfaccia utente.

  1. Inserisci l'**URL** a cui desideri collegarti. Puoi anche aggiungere una delle variabili del modello definite nella dashboard. Premi `Ctrl+Space` o `Cmd+Space` e fai clic nel campo URL per visualizzare le variabili disponibili. Aggiungendo variabili modello al link del pannello, il link rimanda l'utente al contesto giusto, con le variabili pertinenti già impostate.

     Puoi anche usare variabili temporali.
     + `from`definisce il limite inferiore dell'intervallo di tempo, specificato in ms epoch.
     + `to`definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch.
     + `time`e `time.window` definisce un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in ms. Ad esempio, `?time=1500000000000&time.window=10000` restituisce un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000.
+ **Aggiornamento di un collegamento al pannello**

  1. Nella scheda **Pannello**, trova il link a cui desideri apportare modifiche.

  1. Fai clic sull'icona **Modifica** (matita) per aprire la finestra Modifica link.

  1. Apporta le modifiche necessarie:

  1. Fai clic su **Salva** per salvare le modifiche e chiudere la finestra.

  1. Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard.
+ **Eliminazione di un collegamento al pannello**

  1. Nella scheda **Pannello**, individuate il link a cui desiderate apportare modifiche.

  1. Fai clic sull'icona **X** accanto al link che desideri eliminare.

  1. Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard.

# Modello JSON di dashboard
<a name="v9-dash-dashboard-json-model"></a>

****  
**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 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)

Una dashboard in Grafana è rappresentata da un oggetto JSON, che memorizza i metadati della relativa dashboard. I metadati della dashboard includono le proprietà della dashboard, i metadati dei pannelli, le variabili del modello e le query dei pannelli.

Per visualizzare il codice JSON di una dashboard.

1. Passa a una dashboard.

1. Nel menu di navigazione in alto, fai clic sull'icona **delle impostazioni della dashboard** (ingranaggio).

1. Fai clic su **Modello JSON**.

**Campi JSON**

Quando un utente crea un nuovo dashboard, viene inizializzato un nuovo oggetto JSON del dashboard con i seguenti campi.

**Nota**  
Nel seguente codice JSON, id viene visualizzato come null, che è il valore predefinito assegnato ad esso fino al salvataggio di un dashboard. Dopo il salvataggio di un pannello di controllo, al campo viene assegnato un valore intero. `id`

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Di seguito viene descritto ogni campo del dashboard JSON.


| Name | Utilizzo | 
| --- | --- | 
| **id** | identificatore numerico univoco per la dashboard (generato dal db) | 
| **uid** | identificatore univoco del dashboard che può essere generato da chiunque. String (8-40) | 
| **titolo** | titolo attuale del pannello di controllo | 
| **tags** | tag associati alla dashboard, una serie di stringhe | 
| **stile** | tema del cruscotto, ad esempio *scuro* o *chiaro* | 
| **timezone** | *fuso orario della dashboard, ad esempio *utc* o browser* | 
| **modificabile** | se una dashboard è modificabile o meno | 
| **GraphToolTip** | 0 per nessun mirino o tooltip condiviso (impostazione predefinita), 1 per mirino condiviso, 2 per mirino condiviso e tooltip condiviso | 
| **time** | **intervallo di tempo per la dashboard, ad esempio ultime 6 ore o ultimi 7 giorni** | 
| **timepicker** | [metadati timepicker, vedi la sezione timepicker per i dettagli](#v9-dash-dashboard-json-model) | 
| **modellazione** | [creazione di modelli di metadati, consulta la sezione relativa ai modelli per i dettagli](#v9-dash-dashboard-json-model) | 
| **annotations** | [metadati delle annotazioni, vedi le annotazioni per sapere come aggiungerli](v9-panels-annotate-visualizations.md) | 
| **aggiorna** | intervallo di aggiornamento automatico | 
| **schemaVersion** | versione dello schema JSON (intero), incrementata ogni volta che un aggiornamento Grafana apporta modifiche a detto schema | 
| **versione** | versione della dashboard (numero intero), incrementata ogni volta che la dashboard viene aggiornata | 
| **pannelli** | array di pannelli (vedi sotto per i dettagli) | 

**Riquadri**

I pannelli sono gli elementi costitutivi di una dashboard. Consiste in interrogazioni sull'origine dei dati, tipi di grafici, alias e altro. Il pannello JSON è costituito da una serie di oggetti JSON, ognuno dei quali rappresenta un pannello diverso. La maggior parte dei campi è comune a tutti i pannelli, ma alcuni campi dipendono dal tipo di pannello. Quello che segue è un esempio di pannello JSON di un pannello di testo.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Dimensioni e posizione del pannello**

La proprietà gridPos descrive le dimensioni e la posizione del pannello nelle coordinate della griglia.
+ `w`: 1—24 (la larghezza del pannello di controllo è divisa in 24 colonne)
+ `h`: nelle unità di altezza della griglia, ciascuna rappresenta 30 pixel.
+ `x`: La posizione x, nella stessa unità di`w`.
+ `y`: La posizione y, espressa nella stessa unità di`h`.

La griglia ha una gravità negativa che si sposta verso l'alto se c'è spazio vuoto sopra un pannello.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Modellazione**

Il `templating` campo contiene una serie di variabili modello con i relativi valori salvati insieme ad altri metadati.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

# Gestione dei dashboard
<a name="v9-dash-managing-dashboards"></a>

****  
**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 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)

Una dashboard è un insieme di uno o più [pannelli](v9-panels.md) che presenta visivamente i dati in una o più righe.

Per ulteriori informazioni sulla creazione di dashboard, consulta [Aggiungere e organizzare pannelli]().

## Creazione di cartelle di dashboard
<a name="v9-dash-create-dashboard-folder"></a>

Le cartelle ti aiutano a organizzare e raggruppare le dashboard, il che è utile quando hai molte dashboard o più team che utilizzano la stessa istanza Grafana.

**Prerequisiti**

Assicurati di disporre delle autorizzazioni di amministratore Grafana. [Per ulteriori informazioni sulle autorizzazioni della dashboard, consulta Autorizzazioni della dashboard.](Grafana-administration-authorization.md)

**Per creare una cartella del pannello di controllo**

1. Accedi a Grafana e nel menu laterale, fai clic su **Dashboards** > Nuova cartella

1. **Inserisci un nome univoco e fai clic su Crea.**

**Nota**  
Quando salvi una dashboard, puoi selezionare una cartella in cui salvare la dashboard o creare una nuova cartella.

## Gestione di dashboard e cartelle
<a name="v9-dash-manage-dashboard-folder"></a>

Nella pagina **Gestisci dashboard e cartelle** puoi:
+ Creare una cartella
+ Creazione di un pannello di controllo
+ Sposta i dashboard in cartelle
+ Eliminare più dashboard
+ Accedi a una pagina della cartella in cui puoi assegnare le autorizzazioni per cartelle e dashboard

**Pagina della cartella Dashboard**

È possibile completare le seguenti attività **nella pagina della cartella Dashboard**:
+ Sposta o elimina i dashboard in una cartella.
+ Rinomina una cartella (disponibile nella scheda **Impostazioni**).
+ Assegna le autorizzazioni alle cartelle (che vengono ereditate dai dashboard della cartella).

**Per accedere alla pagina della cartella della dashboard, fai clic sull'ingranaggio che appare quando passi il mouse su una cartella nell'elenco dei risultati di ricerca della dashboard o nella pagina Gestisci dashboard e cartelle.**

**Autorizzazioni della dashboard**

È possibile assegnare autorizzazioni a una cartella. Tutte le autorizzazioni assegnate vengono ereditate dai dashboard della cartella. Viene utilizzata una lista di controllo degli accessi (ACL) in cui è possibile assegnare le autorizzazioni al **ruolo dell'organizzazione**, al **team** e a un **utente**.

Per ulteriori informazioni, consulta [le autorizzazioni](Grafana-permissions.md).

## Esportazione e importazione di dashboard
<a name="v9-dash-export-import-dashboards"></a>

Puoi utilizzare l'interfaccia utente Grafana o l'API HTTP per esportare e importare dashboard.

**Esportazione di un pannello di controllo**

L'azione di esportazione del dashboard crea un file JSON Grafana che contiene tutto ciò di cui hai bisogno, inclusi layout, variabili, stili, fonti di dati, query e così via, in modo da poter importare la dashboard in un secondo momento.

**Nota**  
Grafana scarica un file JSON sul computer locale. 

1. Apri il pannello di controllo che desideri esportare.

1. Seleziona l'icona di condivisione.

1. Scegli **Export** (Esporta).

1. Scegli **Salva su file.**

**Rendere portatile una dashboard**

Se desideri esportare una dashboard per farla usare ad altri, puoi aggiungere variabili modello per cose come un prefisso metrico (usa una variabile costante) e il nome del server.

Una variabile modello di questo tipo `Constant` verrà automaticamente nascosta nella dashboard e verrà aggiunta anche come input obbligatorio quando la dashboard viene importata.

**Importazione di un pannello di controllo**

1. Scegli **Dashboard** nel menu laterale.

1. Scegli **Nuovo**, quindi seleziona **Importa** dal menu a discesa.

1. Eseguire una delle seguenti fasi.
   + Carica un file JSON del pannello di controllo.
   + Incolla l'URL di un [pannello di controllo Grafana.com](https://grafana.com/).
   + Incolla il testo JSON della dashboard direttamente nell'area di testo.

   Il processo di importazione consente di modificare il nome della dashboard, scegliere l'origine dati che si desidera che venga utilizzata dalla dashboard e specificare eventuali prefissi delle metriche (se la dashboard ne utilizza uno).

## Dashboard di risoluzione dei problemi
<a name="v9-dash-troubleshooting"></a>

Questa sezione fornisce informazioni per aiutarti a risolvere i problemi più comuni delle dashboard. 

**La dashboard è lenta**

Se la dashboard è lenta, considera quanto segue:
+ Stai cercando di renderizzare dozzine (o centinaia o migliaia) di serie temporali su un grafico? Ciò può causare ritardi nel browser. Prova a utilizzare funzioni come HighestMax (in Graphite) per ridurre le serie restituite.
+ A volte i nomi delle serie possono essere molto grandi. Ciò causa dimensioni di risposta maggiori. Prova a utilizzare l'alias per ridurre la dimensione dei nomi delle serie restituiti.
+ Stai interrogando molte serie temporali o per un lungo intervallo di tempo? Entrambe queste condizioni possono far sì che Grafana o la tua fonte di dati raccolga molti dati, il che può rallentarli.
+ Potrebbe essere un carico elevato sull'infrastruttura di rete. Se la lentezza non è costante, questo potrebbe essere il problema.

**Problemi relativi alla frequenza di aggiornamento del pannello di controllo**

Per impostazione predefinita, Grafana interroga la tua fonte di dati ogni 30 secondi. L'impostazione di una frequenza di aggiornamento bassa sui dashboard comporta uno stress inutile sul backend. In molti casi, non è necessario interrogarlo frequentemente perché i dati non vengono inviati al sistema in modo tale da consentire la visualizzazione delle modifiche.

Se si verifica questo problema, si consigliano le seguenti soluzioni.
+ Non abilitare l'aggiornamento automatico su dashboard, pannelli o variabili a meno che non sia necessario. Gli utenti possono aggiornare il browser manualmente oppure puoi impostare la frequenza di aggiornamento per un periodo di tempo adeguato (ad esempio ogni dieci minuti o ogni ora).
+ Se necessario, imposta la frequenza di aggiornamento su una volta al minuto. Gli utenti possono sempre aggiornare la dashboard manualmente.
+ Se la dashboard ha un periodo di tempo più lungo (ad esempio una settimana), l'aggiornamento automatico potrebbe non essere necessario.

**La gestione o il rendering di dati nulli sono errati o creano confusione**

Alcune applicazioni pubblicano i dati in modo intermittente. Ad esempio, pubblicano una metrica solo quando si verifica un evento. Per impostazione predefinita, i grafici Grafana collegano le linee tra i punti dati.

# Condivisione di dashboard e pannelli
<a name="v9-dash-sharing"></a>

****  
**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 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)

Grafana consente di condividere dashboard e pannelli con altri utenti all'interno di un'organizzazione e, in determinate situazioni, pubblicamente sul Web. Puoi condividere usando:
+ Un link diretto
+ Un'istantanea
+ Un link di esportazione (solo per i dashboard)

È necessario disporre del permesso di visualizzazione autorizzato per visualizzare un'immagine resa da un link diretto.

La stessa autorizzazione è richiesta anche per visualizzare i link incorporati, a meno che tu non abbia abilitato l'autorizzazione di accesso anonimo per la tua istanza Grafana.

Quando condividi un pannello o una dashboard come istantanea, un'istantanea (che è un pannello o una dashboard nel momento in cui scatti l'istantanea) è disponibile pubblicamente sul Web. Chiunque abbia un link ad esso può accedervi. Poiché le istantanee non richiedono alcuna autorizzazione per la visualizzazione, Grafana rimuove le informazioni relative all'account da cui provengono, nonché tutti i dati sensibili dall'istantanea.

## Condivisione di una dashboard
<a name="v9-dash-share-dashboard"></a>

Puoi condividere una dashboard come collegamento diretto o come istantanea. Puoi anche esportare una dashboard.

**Nota**  
Se modifichi una dashboard, assicurati di salvare le modifiche prima di condividerle.

1. Vai alla home page dell'istanza Grafana.

1. Fai clic sull'icona di condivisione nella barra di navigazione in alto.

   La finestra di dialogo di condivisione si aprirà e mostrerà la scheda **Link**.

**Condivisione di un link diretto**

La scheda **Link** mostra l'intervallo di tempo corrente, le variabili del modello e il tema predefinito. Puoi anche condividere un URL abbreviato.

1. Fare clic su **Copy (Copia)**. Questa azione copia l'URL predefinito o abbreviato negli Appunti.

1. Invia l'URL copiato a un utente Grafana con l'autorizzazione a visualizzare il link.

**Pubblicazione di un'istantanea**

Un'istantanea della dashboard condivide pubblicamente una dashboard interattiva. Grafana rimuove i dati sensibili come le query (metriche, template e annotazioni) e i collegamenti ai pannelli, lasciando solo i dati metrici visibili e i nomi delle serie incorporati nella dashboard. Le istantanee della dashboard sono accessibili a chiunque disponga del link.

Puoi pubblicare istantanee sulla tua istanza locale.

1. Fate clic su **Istantanea locale**.

1. Grafana genera un link dell'istantanea. Copia il link all'istantanea e condividilo all'interno della tua organizzazione o pubblicamente sul Web.

**Esportazione di una dashboard**

Le dashboard Grafana possono essere facilmente esportate e importate. Per ulteriori informazioni, [consulta Esportazione e](v9-dash-managing-dashboards.md#v9-dash-export-import-dashboards) importazione di dashboard.

## Condivisione di un pannello
<a name="v9-dash-share-panel"></a>

Puoi condividere un pannello come collegamento diretto o come istantanea. Puoi anche creare pannelli di libreria usando l'opzione **Condividi** su qualsiasi pannello.

1. Fate clic sul titolo di un pannello per aprire il menu del pannello.

1. Fate clic su **Condividi**. La finestra di dialogo di condivisione si aprirà e mostrerà la scheda **Link**.

**Utilizzando un link diretto**

La scheda **Link** mostra l'intervallo di tempo corrente, le variabili del modello e il tema predefinito. Facoltativamente, puoi abilitare un URL abbreviato da condividere. 

1. Fai clic su **Copia** per copiare l'URL predefinito o abbreviato negli appunti. 

1. Invia l'URL copiato a un utente Grafana con l'autorizzazione a visualizzare il link.

1. Facoltativamente, puoi anche fare clic su **Immagine renderizzata con collegamento diretto** per condividere un'immagine del pannello.

**Interrogazione dei parametri delle stringhe per le immagini renderizzate lato server**
+ **larghezza: larghezza** in pixel. L'impostazione predefinita è 800.
+ **altezza**: altezza in pixel. Il valore predefinito è 400.
+ **tz**: fuso orario nel formato in `UTC%2BHH%3AMM` cui HH e MM sono sfalsati in ore e minuti dopo l'UTC.
+ **timeout: numero di secondi**. Il timeout può essere aumentato se la query per il pannello richiede più dei 30 secondi predefiniti.
+ **scala**: valore numerico per configurare il fattore di scala del dispositivo. Il valore predefinito è 1. Usa un valore più alto per produrre immagini più dettagliate (DPI più alti). Supportato in Grafana v7.0\$1.

**Pubblicazione di un'istantanea**

Un'istantanea del pannello condivide pubblicamente un pannello interattivo. Grafana rimuove i dati sensibili lasciando solo i dati metrici visibili e i nomi delle serie incorporati nella dashboard. Le istantanee del pannello sono accessibili a chiunque disponga del link

Puoi pubblicare istantanee sulla tua istanza locale.

1. Nella finestra di dialogo **Share Panel**, fate clic su **Istantanea** per aprire la scheda.

1. Fate clic su **Istantanea locale**. Grafana genera il link dell'istantanea.

1. Copia il link all'istantanea e condividilo all'interno della tua organizzazione o pubblicamente sul Web.

Se hai creato un'istantanea per errore, fai clic su **Elimina istantanea** per rimuovere l'istantanea dall'istanza Grafana.

**Creazione di un pannello della libreria**

Per creare un pannello della libreria dalla finestra di dialogo **Share Panel**.

1. Fate clic sul **pannello Libreria**.

1. Nel **nome del pannello Libreria**, inserite il nome.

1. In **Salva nella cartella**, selezionate la cartella in cui salvare il pannello della libreria. Per impostazione predefinita, è selezionata la cartella **Generale**.

1. Fate clic sul pannello **Crea libreria** per salvare le modifiche.

1. Fai clic su **Salva** per salvare la dashboard.

# Gestione delle playlist
<a name="v9-dash-managing-playlists"></a>

****  
**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 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)

Una *playlist* è un elenco di dashboard che vengono visualizzate in sequenza. Puoi usare una playlist per aumentare la consapevolezza della situazione o per presentare le tue metriche al tuo team o ai visitatori. Grafana ridimensiona automaticamente le dashboard a qualsiasi risoluzione, il che le rende perfette per schermi di grandi dimensioni. **Puoi accedere alla funzione playlist dal menu laterale di Grafana nel sottomenu Dashboards.**

## Accesso, condivisione e controllo di una playlist
<a name="v9-dash-access-share-control-playlist"></a>

Utilizza le informazioni in questa sezione per accedere alle playlist esistenti. Avvia e controlla la visualizzazione di una playlist utilizzando una delle cinque modalità disponibili.

**Accedere a una playlist**

1. Passa il cursore sul menu laterale di Grafana.

1. **Fai clic su Playlist.**

   Verrà visualizzato un elenco di playlist esistenti.

**Avvio di una playlist**

È possibile avviare una playlist in cinque diverse modalità di visualizzazione. La modalità di visualizzazione determina la modalità di visualizzazione dei menu e della barra di navigazione nei dashboard.

Per impostazione predefinita, ogni dashboard viene visualizzata per il periodo di tempo immesso nel campo **Intervallo**, che viene impostato quando si crea o si modifica una playlist. Dopo aver avviato una playlist, puoi controllarla con la barra di navigazione nella parte superiore della pagina.

La playlist mostra ogni dashboard per il tempo specificato nel `Interval` campo, impostato durante la creazione o la modifica di una playlist. Dopo l'avvio di una playlist, puoi controllarla utilizzando la barra di navigazione nella parte superiore dello schermo.

1. Accedi alla pagina della playlist per visualizzare un elenco di playlist esistenti.

1. Trova la playlist che desideri avviare, quindi fai clic su **Avvia playlist**.

   Si aprirà la finestra di dialogo di avvio della playlist.

1. Seleziona una delle cinque modalità di playlist disponibili in base alle informazioni riportate nella tabella seguente.

1. Fate clic su Avvia.


| Modalità | Description | 
| --- | --- | 
| Modalità normale |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| modalità TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| modalità TV (con pannelli ad adattamento automatico) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| modalità Kiosk |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 
| Modalità Kiosk (con pannelli ad adattamento automatico) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-dash-managing-playlists.html)  | 

**Controllo di una playlist**

Puoi controllare una playlist in modalità **Normale** o **TV** dopo l'avvio, utilizzando la barra di navigazione nella parte superiore dello schermo. Premi il `Esc` tasto della tastiera per interrompere la playlist.


| Button | Azione | 
| --- | --- | 
| Avanti (doppia freccia destra) | Passa alla dashboard successiva. | 
| Indietro (freccia sinistra) | Torna alla dashboard precedente. | 
| Stop (quadrato) | Termina la playlist e passa alla dashboard corrente. | 
| modalità di visualizzazione ciclica (icona del monitor) | Ruota la visualizzazione dei dashboard in diverse modalità di visualizzazione. | 
| Intervallo temporale | Visualizza i dati entro un intervallo di tempo. Può essere impostato per visualizzare gli ultimi 5 minuti fino a 5 anni fa o un intervallo di tempo personalizzato, utilizzando la freccia rivolta verso il basso. | 
| Aggiorna (freccia circolare) | Ricarica la dashboard per visualizzare i dati correnti. Può essere impostato per ricaricarsi automaticamente ogni 5 secondi o 1 giorno, utilizzando la freccia a discesa. | 

## Creare una playlist
<a name="v9-dash-create-playlist"></a>

Puoi creare una playlist per presentare le dashboard in una sequenza con un ordine e un intervallo di tempo prestabiliti tra le dashboard.

1. Fai clic su **Nuova playlist** nella pagina della playlist.

1. Inserisci un nome descrittivo nella casella di testo **Nome**.

1. Immettete un intervallo di tempo nella casella di testo **Intervallo.**
**Nota**  
I dashboard aggiunti sono elencati in ordine sequenziale.

1. Nelle **dashboard**, aggiungi le dashboard esistenti alla playlist utilizzando le opzioni a discesa **Aggiungi per titolo** e **Aggiungi per tag**.

1. Facoltativamente:
   + Cerca una dashboard in base al nome, a un'espressione regolare o a un tag.
   + Filtra i risultati in base allo stato o ai tag contrassegnati con una stella.
   + Riorganizza l'ordine della dashboard che hai aggiunto utilizzando l'icona a forma di freccia su e giù.
   + Rimuovi una dashboard dalla playlist facendo clic sull'icona **X** accanto alla dashboard.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

## Salvare una playlist
<a name="v9-dash-save-playlist"></a>

Puoi salvare una playlist e aggiungerla alla tua pagina **Playlist**, dove puoi avviarla.

**Importante**  
Assicurati che tutte le dashboard che desideri vengano aggiunte nella playlist quando crei o modifichi la playlist prima di salvarla.

1. Per accedere alla funzione playlist, posiziona il cursore sul menu laterale di Grafana.

1. Fai clic su **Playlist** per visualizzare le playlist disponibili.

1. Fai clic sulla playlist che preferisci.

1. Modifica la playlist.

1. Verifica che la playlist abbia un **nome**, un **intervallo** e almeno una **dashboard** aggiunta.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

## Modificare o eliminare una playlist
<a name="v9-dash-edit-delete-playlist"></a>

Puoi modificare una playlist aggiornandone il nome, l'intervallo di tempo e aggiungendo, rimuovendo e riorganizzando l'ordine delle dashboard.

**Modificare una playlist**

1. Fai clic su **Modifica playlist** nella pagina della playlist.

1. Aggiorna il nome e l'intervallo di tempo, quindi aggiungi o rimuovi dashboard dalla playlist seguendo le istruzioni riportate nella sezione Crea una playlist, sopra.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

**Eliminazione di una playlist**

1. Fai clic su **Playlist**.

1. Fai clic su **Rimuovi** accanto alla playlist che desideri eliminare.

**Riorganizzazione dell'ordine della dashboard**

1. Accanto alla dashboard che desideri spostare, fai clic sulla freccia rivolta verso l'alto o verso il basso.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

**Rimuovere un pannello di controllo**

1. Fai clic su **Rimuovi** per rimuovere una dashboard dalla playlist.

1. Fare clic su **Save (Salva)** per salvare le modifiche.

## Condivisione di una playlist in modalità di visualizzazione
<a name="v9-dash-share-playlist-view-mode"></a>

Puoi condividere una playlist copiando l'indirizzo del link nella modalità di visualizzazione che preferisci e incollando l'URL nella destinazione.

1. **Dal sottomenu **Dashboards**, fai clic su Playlist.**

1. Fai clic su **Avvia playlist** accanto alla playlist che desideri condividere.

1. Nel menu a discesa, fai clic con il pulsante destro del mouse sulla modalità di visualizzazione che preferisci.

1. Fai clic su **Copia l'indirizzo del link** per copiare l'URL negli appunti.

1. Incolla l'URL nella tua destinazione.

# Aggiungere e gestire le variabili del dashboard
<a name="v9-dash-variables"></a>

****  
**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 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)

Una variabile è un segnaposto per un valore. È possibile utilizzare le variabili nelle query metriche e nei titoli dei pannelli. Pertanto, quando modifichi il valore, utilizzando il menu a discesa nella parte superiore della dashboard, le query metriche del pannello cambieranno per riflettere il nuovo valore.

Le variabili ti consentono di creare dashboard più interattive e dinamiche. Invece di codificare elementi come i nomi di server, applicazioni e sensori nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come elenchi a discesa nella parte superiore della dashboard. Questi menu a discesa semplificano la modifica dei dati visualizzati nella dashboard.

Questi possono essere particolarmente utili per gli amministratori che desiderano consentire agli utenti di Grafana di regolare rapidamente le visualizzazioni ma non vogliono concedere loro autorizzazioni di modifica complete. I visualizzatori Grafana possono utilizzare variabili.

Le variabili e i modelli consentono inoltre di creare dashboard a fonte singola. Se disponi di più sorgenti di dati o server identici, puoi creare un'unica dashboard e utilizzare le variabili per modificare ciò che stai visualizzando. Ciò semplifica enormemente la manutenzione e la manutenzione.

**Modelli**

Un modello è qualsiasi interrogazione che contiene una variabile. Ad esempio, se si amministra una dashboard per monitorare diversi server, è possibile creare una dashboard per ogni server oppure creare una dashboard e utilizzare pannelli con query di modello, come le seguenti.

```
wmi_system_threads{instance=~"$server"}
```

I valori delle variabili vengono sempre sincronizzati con l'URL utilizzando la sintassi var- =value. <varname>

**Esempi**

Le variabili sono elencate in elenchi a discesa nella parte superiore dello schermo. Seleziona diverse variabili per vedere come cambiano le visualizzazioni.

Per visualizzare le impostazioni delle variabili, accedi a Impostazioni della **dashboard >** Variabili. Fai clic su una variabile nell'elenco per visualizzarne le impostazioni. 

Le variabili possono essere utilizzate nei titoli, nelle descrizioni, nei pannelli di testo e nelle interrogazioni. Le interrogazioni con testo che inizia con `$` sono modelli. Non tutti i pannelli avranno interrogazioni basate sui modelli.

**Procedure ottimali variabili**
+ Gli elenchi a discesa delle variabili vengono visualizzati nell'ordine in cui sono elencati nell'elenco delle variabili nelle **impostazioni della dashboard**.
+ Metti le variabili che cambierai spesso in alto, in modo che vengano mostrate per prime (all'estrema sinistra sulla dashboard).

# Aggiungere e gestire variabili
<a name="v9-dash-variable-add"></a>

****  
**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 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)

La tabella seguente elenca i tipi di variabili forniti con Grafana.


| Tipo della variabile | Description | 
| --- | --- | 
|  Query  |  Elenco di valori generato da query come nomi di metriche, nomi di server, sensori IDs, data center e così via. Aggiungere una variabile di interrogazione.  | 
|  Personalizzato  |  Definite manualmente le opzioni della variabile utilizzando un elenco separato da virgole. Aggiungi una variabile personalizzata.  | 
|  Text box (Casella di testo)  |  Visualizza un campo di immissione di testo libero con un valore predefinito opzionale. Aggiungi una variabile per la casella di testo.  | 
|  Costante  |  Definire una costante nascosta. Aggiungi una variabile costante.  | 
|  Origine dati  |  Cambia rapidamente la fonte di dati per un'intera dashboard. Aggiungi una variabile di origine dati.  | 
|  Interval  |  Le variabili di intervallo rappresentano intervalli di tempo. Aggiungere una variabile di intervallo.  | 
|  Filtri ad hoc  |  Filtri chiave-valore che vengono aggiunti automaticamente a tutte le query metriche per un'origine dati (solo Prometheus, Loki, InfluxDB ed Elasticsearch). Aggiungi filtri ad hoc.  | 
|  Variabili globali  |  Variabili integrate che possono essere utilizzate nelle espressioni dell'editor di query. Fare riferimento a Variabili globali.  | 
|  Variabili concatenate  |  Le interrogazioni variabili possono contenere altre variabili. Fare riferimento a Variabili concatenate.  | 

## Inserimento delle opzioni generali
<a name="v9-dash-variable-options"></a>

È necessario immettere opzioni generali per qualsiasi tipo di variabile creata.

**Per inserire opzioni generali**

1. Vai alla dashboard per cui desideri creare una variabile e seleziona l'icona **delle impostazioni della dashboard** (a forma di ingranaggio) nella parte superiore della pagina.

1. Nella scheda **Variabili**, seleziona **Nuovo**.

1. Immettete un **nome** per la variabile.

1. Nell'elenco **Tipo**, selezionare **Interrogazione**.

1. (Facoltativo) In **Etichetta**, inserite il nome visualizzato del menu a discesa della variabile.

   Se non inserisci un nome visualizzato, l'etichetta del menu a discesa è il nome della variabile.

1. Scegli un'opzione **Nascondi**:
   + **Nessuna selezione (vuota):** l'elenco a discesa della variabile mostra il **nome** o il valore dell'**etichetta** della variabile.
   + **Etichetta:** l'elenco a discesa della variabile mostra solo il valore della variabile selezionata e una freccia rivolta verso il basso.
   + **Variabile:** nella dashboard non viene visualizzato alcun menu a discesa delle variabili.

## Aggiungere una variabile di query
<a name="v9-dash-variable-add-query"></a>

Le variabili di query consentono di scrivere una query sull'origine dati in grado di restituire un elenco di nomi di metriche, valori di tag o chiavi. Ad esempio, una variabile di query potrebbe restituire un elenco di nomi di server IDs, sensori o data center. I valori delle variabili cambiano man mano che recuperano dinamicamente le opzioni con una query sull'origine dei dati.

Le variabili di query sono generalmente supportate solo per le stringhe. Se la query restituisce numeri o qualsiasi altro tipo di dati, potrebbe essere necessario convertirli in stringhe per utilizzarli come variabili. Per l'origine dati di Azure, ad esempio, puoi usare la funzione [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) per questo scopo.

Le espressioni di query possono contenere riferimenti ad altre variabili e in effetti creare variabili collegate. Grafana lo rileva e aggiorna automaticamente una variabile quando una delle sue variabili collegate cambia.

**Nota**  
Le espressioni di query sono diverse per ogni fonte di dati. Per ulteriori informazioni, consulta la documentazione relativa all'[origine dati](AMG-data-sources.md).

**Per aggiungere una variabile di query**

1. Inserisci le opzioni generali, come sopra.

1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione per la query.

1. Nell'elenco **Aggiorna**, selezionate quando la variabile deve aggiornare le opzioni.
   + **Al caricamento del dashboard:** interroga l'origine dei dati ogni volta che viene caricato il dashboard. Ciò rallenta il caricamento della dashboard, poiché la query variabile deve essere completata prima di poter inizializzare la dashboard.
   + **In caso di modifica dell'intervallo di tempo:** interroga l'origine dati quando l'intervallo di tempo del dashboard cambia. Utilizza questa opzione solo se la tua query sulle opzioni variabili contiene un filtro per intervallo di tempo o dipende dall'intervallo di tempo del dashboard.

1. Nel campo **Query**, inserisci una query.
   + Il campo di interrogazione varia in base alla fonte di dati. Alcune fonti di dati dispongono di editor di query personalizzati.
   + Se hai bisogno di più spazio in un unico editor di interrogazioni con campo di input, posiziona il cursore sulle linee nell'angolo inferiore destro del campo e trascina verso il basso per espandere.

1. (Facoltativo) Nel campo **Regex**, digita un'espressione regex per filtrare o acquisire parti specifiche dei nomi restituiti dalla query sull'origine dati. Per vedere degli esempi, consulta [Filtrare le variabili con regex](#v9-dash-variable-add-filter).

1. Nell'elenco **Ordinamento**, seleziona il tipo di ordinamento dei valori da visualizzare nell'elenco a discesa. L'opzione predefinita, **Disabilitata**, indica che verrà utilizzato l'ordine delle opzioni restituite dalla query sull'origine dei dati.

1. (Facoltativo) Inserite [le opzioni di selezione](#v9-dash-variable-add-selection).

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile personalizzata
<a name="v9-dash-variable-add-custom"></a>

Usa una variabile *personalizzata* per un valore che non cambia, ad esempio un numero o una stringa.

Ad esempio, se hai nomi di server o nomi di regioni che non cambiano mai, potresti volerli creare come variabili personalizzate anziché variabili di query. Poiché non vengono modificate, è possibile utilizzarle in [variabili concatenate](#v9-dash-variable-add-chained) anziché in altre variabili di query. Ciò ridurrebbe il numero di query che Grafana deve inviare quando le variabili concatenate vengono aggiornate.

**Per aggiungere una variabile personalizzata**

1. Inserisci le opzioni generali, come sopra.

1. Nel 

   **Valori separati da virgole**, immettete i valori di questa variabile in un elenco separato da virgole. È possibile includere numeri, stringhe o coppie chiave-valore separate da uno spazio e due punti. Ad esempio, `key1 : value1,key2 : value2`.

1. [(Facoltativo) Inserite le opzioni di selezione.](#v9-dash-variable-add-selection)

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile alla casella di testo
<a name="v9-dash-variable-add-text"></a>

Le variabili delle *caselle* di testo visualizzano un campo di immissione di testo libero con un valore predefinito opzionale. Questa è la variabile più flessibile, in quanto è possibile inserire qualsiasi valore. Utilizza questo tipo di variabile se disponi di metriche con cardinalità elevata o se desideri aggiornare più pannelli in una dashboard contemporaneamente.

**Per aggiungere una variabile di casella di testo**

1. Inserisci le opzioni generali, come sopra.

1. (Facoltativo) Nel campo **Valore predefinito**, selezionate il valore predefinito per la variabile. Se non si inserisce nulla in questo campo, Grafana visualizza una casella di testo vuota in cui gli utenti possono digitare il testo.

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile costante
<a name="v9-dash-variable-add-constant"></a>

Le variabili *costanti* consentono di definire una costante nascosta. Ciò è utile per i prefissi dei percorsi metrici per i dashboard che desideri condividere. Quando esporti una dashboard, le variabili costanti vengono convertite in opzioni di importazione.

Le variabili costanti *non* sono flessibili. Ogni variabile costante contiene solo un valore e non può essere aggiornata a meno che non si aggiornino le impostazioni della variabile.

Le variabili costanti sono utili quando si hanno valori complessi da includere nelle query ma non si desidera digitare nuovamente in ogni query. Ad esempio, se hai chiamato un percorso del server`i-0b6a61efe2ab843gg`, puoi sostituirlo con una variabile chiamata. `$path_gg`

**Per aggiungere una variabile costante**

1. Inserisci le opzioni generali, come sopra.

1. Nel campo **Valore**, inserisci il valore della variabile. È possibile inserire lettere, numeri e simboli. Puoi anche usare i caratteri jolly se usi il [formato raw](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile di origine dati
<a name="v9-dash-variable-add-datasource"></a>

Le variabili di *origine dati* consentono di modificare rapidamente l'origine dati per un intero dashboard. Sono utili se disponi di più istanze di un'origine dati, magari in ambienti diversi.

**Per aggiungere una variabile di origine dati**

1. Inserisci le opzioni generali, come sopra.

1. Nell'elenco **Tipo**, selezionate l'origine dati di destinazione per la variabile.

1. (Facoltativo) In **Filtro del nome dell'istanza**, inserisci un filtro regex per le istanze di origine dati tra cui scegliere nell'elenco a discesa dei valori delle variabili. Lascia vuoto questo campo per visualizzare tutte le istanze.

1. (Facoltativo) Inserite [le opzioni di selezione](#v9-dash-variable-add-selection).

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

## Aggiungere una variabile di intervallo
<a name="v9-dash-variable-add-internal"></a>

Utilizzate una variabile di *intervallo* per rappresentare intervalli di tempo come`1m`, `1h` o. `1d` *Puoi considerarli come un gruppo a livello di dashboard basato su un comando temporale.* Le variabili di intervallo modificano il modo in cui i dati vengono raggruppati nella visualizzazione. È inoltre possibile utilizzare l'opzione Auto per restituire un determinato numero di punti dati per intervallo di tempo.

È possibile utilizzare una variabile di intervallo come parametro per raggruppare per ora (per InfluxDB), intervallo di data e istogramma (per Elasticsearch) o come parametro della funzione di riepilogo (per Graphite).

**Per aggiungere una variabile di intervallo**

1. Inserisci le opzioni generali, come sopra.

1. Nel campo **Valori**, inserisci gli intervalli di tempo che desideri vengano visualizzati nell'elenco a discesa delle variabili. Sono supportate le seguenti unità di tempo:`s (seconds)`,`m (minutes)`,`h (hours)`,`d (days)`, `w (weeks)``M (months)`, e. `y (years)` Puoi anche accettare o modificare i valori predefiniti:`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Facoltativo) Attiva **l'opzione Auto** se desideri aggiungere l'`auto`opzione all'elenco. Questa opzione consente di specificare quante volte l'intervallo di tempo corrente deve essere diviso per calcolare l'intervallo di `auto` tempo corrente. Se lo accendi, vengono visualizzate altre due opzioni:
   + **Conteggio dei passaggi:** seleziona il numero di volte in cui l'intervallo di tempo corrente verrà diviso per calcolare il valore, in modo simile all'opzione di interrogazione **Max data points**. Ad esempio, se l'intervallo di tempo visibile corrente è di 30 minuti, l'`auto`intervallo raggruppa i dati in 30 incrementi di un minuto. Il valore predefinito è 30 passaggi.
   + **Intervallo minimo: la soglia minima al** di sotto della quale gli intervalli di conteggio dei passi non divideranno il tempo. Per continuare con l'esempio di 30 minuti, se l'intervallo minimo è impostato su 2 m, Grafana raggrupperà i dati in 15 incrementi di due minuti.

1. In **Anteprima dei valori**, Grafana mostra un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

**Esempi di variabili a intervallo**

L'esempio seguente mostra una variabile modello `myinterval` in una funzione Graphite:

```
summarize($myinterval, sum, false)
```

## Aggiungere filtri ad hoc
<a name="v9-dash-variable-add-adhoc"></a>

*I filtri ad hoc* consentono di aggiungere filtri chiave-valore che vengono aggiunti automaticamente a tutte le query metriche che utilizzano l'origine dati specificata. A differenza di altre variabili, non si utilizzano filtri ad hoc nelle query. Utilizzate invece filtri ad hoc per scrivere filtri per le query esistenti.

**Nota**  
Le variabili di filtro ad hoc funzionano solo con le fonti di dati Prometheus, Loki, InfluxDB ed Elasticsearch.

1. Inserisci le opzioni generali, come sopra.

1. Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione.

1. Seleziona **Aggiungi** per aggiungere la variabile alla dashboard.

**Crea filtri ad hoc**

I filtri ad hoc sono una delle opzioni variabili più complesse e flessibili disponibili. Invece di un normale elenco di opzioni variabili, questa variabile consente di creare una query ad hoc a livello di dashboard. I filtri applicati in questo modo vengono applicati a tutti i pannelli della dashboard.

## Configura le opzioni di selezione delle variabili
<a name="v9-dash-variable-add-selection"></a>

**Le opzioni di selezione** sono una funzionalità che è possibile utilizzare per gestire le selezioni di opzioni variabili. Tutte le opzioni di selezione sono opzionali e sono disattivate per impostazione predefinita.

### Variabili multivalore
<a name="v9-dash-variable-add-selection-multi"></a>

L'interpolazione di una variabile con più valori selezionati è complicata in quanto non è semplice formattare i valori multipli in una stringa valida nel contesto dato in cui viene utilizzata la variabile. Grafana cerca di risolvere questo problema consentendo a ciascun plug-in di origine dati di comunicare al motore di interpolazione dei modelli quale formato utilizzare per più valori.

**Nota**  
L'opzione **Personalizza tutti i valori** sulla variabile deve essere vuota affinché Grafana formatti tutti i valori in un'unica stringa. Se viene lasciato vuoto, Grafana concatena (somma) tutti i valori della query. Ad esempio, `value1,value2,value3`. Se viene utilizzato un `all` valore personalizzato, il valore sarà invece o. `*` `all`

**Variabili multivalore con una fonte di dati Graphite**

Graphite utilizza espressioni globulari. **Una variabile con più valori, in questo caso, verrebbe interpolata come `{host1,host2,host3}` se il valore della variabile corrente fosse *host1, host2 e host3*.**

**Variabili multivalore con un'origine dati Prometheus o InfluxDB**

InfluxDB e Prometheus utilizzano espressioni regex, quindi la stessa variabile verrebbe interpolata di. `(host1|host2|host3)` Ogni valore verrebbe inoltre escluso dall'espressione regolare. In caso contrario, un valore con un carattere di controllo regex interromperebbe l'espressione regex.

**Variabili multivalore con un'origine dati elastica**

Elasticsearch utilizza la sintassi delle query lucene, quindi la stessa variabile verrebbe formattata come. `("host1" OR "host2" OR "host3")` In questo caso, è necessario escludere ogni valore in modo che il valore contenga solo le parole di controllo Lucene e le virgolette.

**Risolvi i problemi relativi alle variabili multivalore**

L'escape e la formattazione automatici possono causare problemi e può essere difficile comprenderne la logica alla base. Soprattutto per InfluxDB e Prometheus, dove l'uso della sintassi regex richiede che la variabile venga utilizzata nel contesto dell'operatore regex.

Se non vuoi che Grafana esegua l'escape e la formattazione automatica delle espressioni regolari, devi eseguire una delle seguenti operazioni:
+ **Disattiva le opzioni **Multivalore** o Includi tutto.**
+ Usa il [formato variabile non elaborato](https://grafana.com/docs/grafana/latest/dashboards/variables/variable-syntax/#raw).

### Opzione Includi tutto
<a name="v9-dash-variable-add-multi-all"></a>

Grafana aggiunge un'`All`opzione all'elenco a discesa delle variabili. Se un utente seleziona questa opzione, vengono selezionate tutte le opzioni variabili.

### Personalizza tutti i valori
<a name="v9-dash-variable-add-multi-custom"></a>

Questa opzione è visibile solo se è selezionata l'**opzione Includi tutto**.

Immettete la sintassi regex, globs o lucene nel campo **Custom all value** per definire il valore dell'opzione. `All`

Per impostazione predefinita, il `All` valore include tutte le opzioni in un'espressione combinata. Questa operazione può diventare molto lunga e causare problemi di prestazioni. A volte può essere meglio specificare un valore all personalizzato, ad esempio un'espressione regolare con caratteri jolly.

Per avere una sintassi regex, globs o lucene personalizzata nell'opzione **Custom all value**, questa opzione non viene mai evitata, quindi dovrai pensare a quale sia un valore valido per la tua fonte di dati.

## Variabili globali
<a name="v9-dash-variable-add-global"></a>

Grafana ha variabili globali integrate che possono essere utilizzate nelle espressioni dell'editor di query. Questo argomento le elenca in ordine alfabetico e le definisce. Queste variabili sono utili nelle query, nei collegamenti alla dashboard, nei collegamenti ai pannelli e nei collegamenti dati.

**\$1\$1\$1dashboard**

Questa variabile è il nome della dashboard corrente.

**\$1\$1\$1from e \$1\$1\$1to**

Grafana ha due variabili di intervallo temporale integrate: `$__from` e. `$__to` Attualmente sono sempre interpolati come millisecondi di epoca per impostazione predefinita, ma puoi controllare la formattazione della data.


| Sintassi | Risultato dell’esempio | Description | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Epoca Unix in millisecondi  | 
|  `${__from:date}`  |  2020-07-13T 20:19:09.254 Z  |  Nessun args, il valore predefinito è ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Epoca dei secondi di Unix  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Qualsiasi formato di data personalizzato che non includa il carattere:  | 

La sintassi precedente funziona anche con`${__to}`.

**\$1\$1\$1interval**

*È possibile utilizzare la `$__interval` variabile come parametro per raggruppare per ora (per InfluxDB, MySQL, Postgres, MSSQL), intervallo di istogramma di data (per Elasticsearch) o come parametro della funzione di riepilogo (per Graphite).*

Grafana calcola automaticamente un intervallo che può essere utilizzato per raggruppare per tempo nelle query. Quando ci sono più punti dati di quelli che possono essere visualizzati su un grafico, le interrogazioni possono essere rese più efficienti raggruppandole in base a un intervallo più ampio. Ad esempio, se stai guardando un grafico con dati relativi a 3 mesi, potresti non essere in grado di visualizzare i dettagli al minuto. Il raggruppamento per ora o giorno rende l'interrogazione più efficiente senza influire su ciò che mostra il grafico. `$__interval`Viene calcolato utilizzando l'intervallo di tempo e la larghezza del grafico (il numero di pixel).

Calcolo approssimativo: `(to - from) / resolution`

Ad esempio, quando l'intervallo di tempo è di 1 ora e il grafico è a schermo intero, l'intervallo potrebbe essere calcolato in`2m`: i punti sono raggruppati in intervalli di 2 minuti. Se l'intervallo di tempo è di 6 mesi e il grafico è a schermo intero, l'intervallo potrebbe essere `1d` (1 giorno). I punti vengono raggruppati per giorno.

Nell'origine dati InfluxDB, la variabile legacy `$interval` è la stessa variabile. `$__interval`dovrebbe essere usato invece.

Le fonti di dati InfluxDB ed Elasticsearch dispongono di `Group by time interval` campi che vengono utilizzati per codificare l'intervallo o per impostare il limite minimo per la `$__interval` variabile (utilizzando la sintassi ->). `>` `>10m`

**\$1\$1\$1interval\$1ms**

Questa variabile è la `$__interval` variabile in millisecondi, non una stringa formattata con intervallo di tempo. Ad esempio, se è allora è. `$__interval` `20m` `$__interval_ms` `1200000`

**\$1\$1\$1org**

Questa variabile è l'ID dell'organizzazione corrente. `${__org.name}`è il nome dell'organizzazione corrente.

**\$1\$1\$1user**

`${__user.id}`è l'ID dell'utente corrente. `${__user.login}`è l'handle di accesso dell'utente corrente. `${__user.email}`è l'e-mail dell'utente corrente.

**\$1\$1\$1range**

Attualmente è supportato solo per le fonti di dati Prometheus e Loki. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata da`to - from`. Ha una rappresentazione in millisecondi e una seconda denominata e. `$__range_ms` `$__range_s`

**\$1\$1\$1rate\$1interval**

Attualmente è supportato solo per le fonti di dati Prometheus. La `$__rate_interval` variabile è pensata per essere utilizzata nella funzione rate.

**\$1timeFilter o \$1\$1\$1timeFilter**

La `$timeFilter` variabile restituisce l'intervallo di tempo attualmente selezionato come espressione. Ad esempio, l'`Last 7 days`espressione dell'intervallo di tempo è`time > now() - 7d`.

Viene utilizzata in diversi luoghi, tra cui:
+ La clausola WHERE per l'origine dati InfluxDB. Grafana lo aggiunge automaticamente alle query InfluxDB in modalità Query Editor. Puoi aggiungerlo manualmente in modalità Editor di testo:. `WHERE $timeFilter`
+ Registra le query di Analytics nella fonte di dati di Azure Monitor.
+ Query SQL in MySQL, Postgres e MSSQL.
+ La `$__timeFilter` variabile viene utilizzata nell'origine dati MySQL.

## Variabili concatenate
<a name="v9-dash-variable-add-chained"></a>

*Le variabili concatenate*, chiamate anche *variabili collegate o variabili* *annidate*, sono variabili di query con una o più altre variabili nella relativa query variabile. Questa sezione spiega come funzionano le variabili concatenate e fornisce collegamenti a dashboard di esempio che utilizzano variabili concatenate.

Le query con variabili concatenate sono diverse per ogni fonte di dati, ma la premessa è la stessa per tutte. È possibile utilizzare le query con variabili concatenate in qualsiasi fonte di dati che le consenta.

Sono possibili dashboard con modelli collegati estremamente complessi, con 5 o 10 livelli di profondità. Tecnicamente, non ci sono limiti alla profondità o alla complessità che puoi raggiungere, ma più link hai, maggiore è il carico di query.

**Buone pratiche e suggerimenti**

Le seguenti pratiche semplificheranno l'utilizzo delle dashboard e delle variabili.

**Creazione di nuove variabili collegate**
+ Le variabili concatenate creano parent/child dipendenze. Puoi immaginarle come una scala o un albero.
+ Il modo più semplice per creare una nuova variabile concatenata è copiare la variabile su cui si desidera basare quella nuova. Nell'elenco delle variabili, fate clic sull'icona **Duplica variabile** a destra della voce della variabile per crearne una copia. È quindi possibile aggiungerlo alla query per la variabile principale.
+ Le nuove variabili create in questo modo vengono visualizzate in fondo all'elenco. Potrebbe essere necessario trascinarla in una posizione diversa nell'elenco per inserirla in un ordine logico.

**Ordine variabile**

Puoi modificare l'ordine delle variabili nell'elenco delle variabili del dashboard facendo clic sulle frecce su e giù sul lato destro di ogni voce. Grafana elenca i menu a discesa delle variabili da sinistra a destra in base a questo elenco, con la variabile in alto all'estrema sinistra.
+ Elenca le variabili che non hanno dipendenze in alto, prima delle variabili secondarie.
+ Ogni variabile deve seguire quella da cui dipende.
+ Ricorda che nell'interfaccia utente non è indicato quali variabili abbiano relazioni di dipendenza. Elenca le variabili in ordine logico per semplificare le cose agli altri utenti (e a te stesso).

**Considerazione della complessità**

Maggiore è il numero di livelli di dipendenza nelle variabili, maggiore sarà il tempo necessario per aggiornare le dashboard dopo aver modificato le variabili.

Ad esempio, se disponi di una serie di quattro variabili collegate (country, Region, server, metric) e modifichi il valore di una variabile radice (country), Grafana deve eseguire le query per tutte le variabili dipendenti prima di aggiornare le visualizzazioni nella dashboard.

## Gestisci le variabili
<a name="v9-dash-variable-add-manage"></a>

La pagina delle variabili consente di [aggiungere](https://grafana.com/docs/grafana/latest/dashboards/variables/add-template-variables/) variabili e gestire le variabili esistenti. Consente inoltre di [esaminare](https://grafana.com/docs/grafana/latest/dashboards/variables/inspect-variable/) le variabili e identificare se una variabile viene referenziata (o utilizzata) in altre variabili o dashboard.

**Sposta:** puoi spostare una variabile verso l'alto o verso il basso nell'elenco trascinandola.

**Clona:** per clonare una variabile, fai clic sull'icona del clone dal set di icone a destra. In questo modo viene creata una copia della variabile con il nome della variabile originale preceduto da. `copy_of_`

**Elimina:** per eliminare una variabile, fai clic sull'icona del cestino dal set di icone a destra.

## Filtra le variabili con regex
<a name="v9-dash-variable-add-filter"></a>

Utilizzando l'opzione Regex Query, si filtra l'elenco di opzioni restituite dalla variabile query o si modificano le opzioni restituite.

Questa pagina mostra come utilizzare regex per filter/modify i valori nel menu a discesa delle variabili.

Utilizzando l'opzione Regex Query, si filtra l'elenco di opzioni restituite dalla query Variable o si modificano le opzioni restituite. Per ulteriori informazioni, consulta la guida di Mozilla sulle espressioni [regolari](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Gli esempi seguenti mostrano il filtraggio in base al seguente elenco di opzioni

```
backend_01
backend_02
backend_03
backend_04
```

**Filtra in modo che vengano restituite solo le opzioni che `02` terminano con `01` o**

Regex:

```
/
(
01|02 
) 
$/
```

Risultato:

```
backend_01
backend_02
```

**Filtra e modifica le opzioni utilizzando un gruppo di acquisizione regex per restituire parte del testo**

Regex:

```
/.* 
(
01|02 
)
/
```

Risultato:

```
01
02
```

**Filtrare e modificare - Esempio di Prometheus**

Elenco di opzioni:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Regex:

```
/. *instance="
(
[^"]*
)
.*/
```

Risultato:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filtra e modifica utilizzando gruppi di acquisizione di testo e valori denominati**

Utilizzando gruppi di acquisizione denominati, è possibile acquisire parti separate di «testo» e «valore» dalle opzioni restituite dalla query variabile. Ciò consente all'elenco a discesa delle variabili di contenere un nome descrittivo per ogni valore che può essere selezionato.

Ad esempio, quando si esegue una query sulla metrica `node_hwmon_chip_names` Prometheus, è molto più intuitiva `chip_name` del valore. `chip` Quindi il seguente risultato della query variabile:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Passato attraverso la seguente Regex:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Produrrebbe il seguente elenco a discesa:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Sono supportati solo `text` i nomi dei gruppi di `value` acquisizione.

## 
<a name="v9-dash-variable-add-inspect"></a>

La pagina delle variabili consente di identificare facilmente se una variabile viene referenziata (o utilizzata) in altre variabili o nella dashboard.

Ogni variabile referenziata o utilizzata presenta un segno di spunta verde accanto ad essa, mentre le variabili non referenziate hanno un'icona di avvertenza arancione accanto ad esse. Inoltre, tutte le variabili referenziate hanno un'icona di dipendenza accanto al segno di spunta verde. È possibile selezionare l'icona per visualizzare la mappa delle dipendenze. La mappa delle dipendenze può essere spostata. È possibile ingrandire o ridurre con la rotellina del mouse o uno strumento equivalente.

# Sintassi variabile
<a name="v9-dash-variable-syntax"></a>

****  
**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 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)

I titoli dei pannelli e le query metriche possono fare riferimento a variabili utilizzando due sintassi diverse.
+ `$varname`— Questa sintassi è facile da leggere, ma non consente di utilizzare una variabile al centro di una parola.

  **Esempio**: `apps.frontend.$server.requests.count`
+ `${var_name}`— Utilizzate questa sintassi quando desiderate utilizzare una variabile al centro di un'espressione.
+ `${var_name:<format>}`— Questo formato offre un maggiore controllo su come Grafana interpreta i valori. Per ulteriori informazioni, consulta Opzioni *avanzate di formato variabile*.
+ `[[varname]]`— Non utilizzare. Questa sintassi è vecchia ed è obsoleta. Verrà rimosso in una versione futura.

Prima che le query vengano inviate alla fonte dati, la query viene *interpolata*, il che significa che la variabile viene sostituita con il valore corrente. Durante l'interpolazione, è possibile che il valore della variabile venga *ignorato per* conformarsi alla sintassi del linguaggio di interrogazione e del luogo in cui viene utilizzato. Ad esempio, una variabile utilizzata in un'espressione regex in una query InfluxDB o Prometheus verrà escapitata con regex.

**Opzioni avanzate di formato variabile**

La formattazione dell'interpolazione delle variabili dipende dall'origine dei dati, ma ci sono alcune situazioni in cui potresti voler modificare la formattazione predefinita.

Ad esempio, l'impostazione predefinita per l'origine dati MySQL consiste nell'unire più valori separati da virgole da virgole:. `'server01','server02'` In alcuni casi, potresti voler avere una stringa separata da virgole senza virgolette:. `server01,server02` Puoi farlo accadere con le opzioni avanzate di formattazione delle variabili elencate di seguito.

**Sintassi generale**

Sintassi: `${var_name:option}`

Se viene specificata un'opzione di formattazione non valida, allora `glob` è l'opzione. default/fallback 

**CSV**

Formatta le variabili con più valori come una stringa separata da virgole.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Distribuito - OpenTSDB**

Formatta le variabili con più valori in formato personalizzato per OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Virgolette doppie**

Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `"` in ogni valore per e cita ogni valore con. `\"` `"`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Grafite**

Formatta le variabili con più valori in un glob (per le query Graphite).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Formatta le variabili con più valori come una stringa separata da virgole.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Formatta le variabili con più valori in formato Lucene per Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Codice percentuale**

Formatta variabili singole e multivalore da utilizzare nei parametri URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Tubo**

Formatta le variabili con più valori in una stringa separata da pipe.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Raw**

Disattiva la formattazione specifica dell'origine dati, ad esempio le virgolette singole in una query SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Espressione regolare**

Formatta le variabili con più valori in una stringa regex.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Citazione singola**

Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `'` in ogni valore per e cita ogni valore con. `\'` `'`

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Formatta le variabili a valore singolo e multivalore in una stringa separata da virgole, scade `'` in ogni valore per e cita ogni valore con. `''` `'`

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Text (Testo)**

Formatta le variabili a valore singolo e multivalore nella loro rappresentazione testuale. Per una singola variabile, restituirà solo la rappresentazione del testo. Per le variabili multivalore, restituirà la rappresentazione del testo combinata con. `+`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parametri di query**

Formatta le variabili a valore singolo e multivalore nella loro rappresentazione dei parametri di interrogazione. Ad esempio: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Valutazione dell'utilizzo del pannello di controllo
<a name="v9-dash-assess-dashboard-usage"></a>

****  
**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 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 informazioni sull'utilizzo consentono di comprendere meglio come viene utilizzata l'istanza Grafana.

La funzione di analisi sull'utilizzo raccoglie una serie di dati aggregati e li archivia nel database.
+ Visualizzazioni del pannello di controllo (aggregate e per utente)
+ Errori nell'origine dei dati
+ Interrogazioni sulle fonti di dati

I dati aggregati consentono di accedere a diverse funzionalità, tra cui approfondimenti sulla dashboard e sulle fonti di dati, l'indicatore di presenza, l'ordinamento dei dashboard utilizzando i dati di analisi e la visualizzazione dei dati di analisi sull'utilizzo in una dashboard.

Questa funzione genera anche registri dettagliati che possono essere esportati in Loki.

## Dashboard e approfondimenti sulle fonti di dati
<a name="v9-dash-insights"></a>

Per ogni dashboard e fonte di dati, puoi accedere alle informazioni sull'utilizzo.

**Informazioni dettagliate sulla dashboard**

Per visualizzare le informazioni sull'utilizzo della dashboard, fai clic su **Dashboard insights** nella barra in alto.

Dashboard Insights mostra le seguenti informazioni.
+ **Statistiche**: il numero di domande ed errori giornalieri negli ultimi 30 giorni.
+ **Utenti e attività**: il conteggio delle visualizzazioni giornaliere degli ultimi 30 giorni, delle ultime attività sulla dashboard e degli utenti recenti (con un limite di 20).

**Informazioni sulle fonti di dati**

Gli approfondimenti sulle fonti di dati forniscono informazioni su come è stata utilizzata un'origine dati negli ultimi 30 giorni, ad esempio:
+ Interrogazioni al giorno
+ Errori al giorno
+ Tempo di caricamento giornaliero delle query (media in ms)

Per trovare informazioni approfondite sulle fonti di dati:

1. Vai alla visualizzazione dell'elenco delle **fonti di dati**.

1. Fai clic su **Origine dati**.

1. Fai clic sulla scheda **Insights**.

## Indicatore di presenza
<a name="v9-dash-presence-indicator"></a>

Quando accedi e guardi una dashboard, puoi sapere chi sta guardando la tua stessa dashboard tramite un indicatore di presenza, che mostra gli avatar degli utenti che hanno interagito di recente con la dashboard. L'intervallo di tempo predefinito è di 10 minuti. Per vedere il nome dell'utente, passa il mouse sull'avatar dell'utente. Gli avatar provengono da [Gravatar](https://gravatar.com/) in base all'e-mail dell'utente.

**Quando ci sono più utenti attivi su una dashboard di quanti ne possano rientrare nell'indicatore di presenza, fai clic sull'icona \$1X.** In questo modo si apriranno le informazioni sulla dashboard, che contengono maggiori dettagli sulle attività recenti degli utenti.

## Ordinamento delle dashboard utilizzando i dati di approfondimento
<a name="v9-dash-sort-dashboards"></a>

Nella visualizzazione di ricerca, puoi utilizzare i dati di Insights per aiutarti a trovare le dashboard più utilizzate, non funzionanti e inutilizzate.
+ Errori totali
+ Errori 30 giorni
+ Visualizzazioni totali
+ Visualizzazioni 30 giorni

# Ricerca nelle dashboard in Grafana versione 9
<a name="v9-search"></a>

****  
**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 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)

Puoi cercare le dashboard in base al nome della dashboard e al titolo del pannello. Quando cerchi dashboard, il sistema restituisce tutti i dashboard disponibili all'interno dell'istanza Grafana, anche se non disponi dell'autorizzazione per visualizzare il contenuto del pannello di controllo.

## Cerca nelle dashboard utilizzando il nome della dashboard
<a name="v9-search-by-name"></a>

Inserisci qualsiasi parte del nome della dashboard nella barra di ricerca. La ricerca restituisce i risultati per qualsiasi corrispondenza parziale di stringhe in tempo reale, durante la digitazione.

La ricerca nella dashboard è:
+ Real-time
+ *Nessuna* distinzione tra maiuscole
+ Funzionale su dashboard archiviate e basate su file.

**Suggerimento**  
Puoi usare i tasti freccia della tastiera per navigare tra i risultati e premere `Enter` per aprire la dashboard selezionata.

## Cerca nelle dashboard utilizzando il titolo del pannello
<a name="v9-search-by-title"></a>

Puoi cercare una dashboard in base al titolo di un pannello che appare in una dashboard. Se il titolo di un pannello corrisponde alla query di ricerca, la dashboard viene visualizzata nei risultati di ricerca.

## Filtra i risultati di ricerca della dashboard per tag
<a name="v9-search-by-tag"></a>

I tag sono un ottimo modo per organizzare le dashboard, soprattutto con l'aumentare del numero di dashboard. **Puoi aggiungere e gestire i tag nelle Impostazioni della dashboard.**

Quando si selezionano più tag, Grafana mostra dashboard che includono tutti i tag selezionati.

Per filtrare i risultati di ricerca della dashboard in base a un tag, completa uno dei seguenti passaggi:
+ Per filtrare i risultati di ricerca della dashboard per tag, scegli un tag che appare nella colonna destra dei risultati della ricerca.

  Puoi continuare a filtrare scegliendo tag aggiuntivi.
+ Per visualizzare un elenco di tutti i tag disponibili, fai clic sul menu a discesa **Filtra per tag** e seleziona un tag.

  Verranno visualizzati tutti i tag e, quando selezioni un tag, la ricerca nella dashboard verrà immediatamente filtrata.

**Suggerimento**  
Se usi solo una tastiera, premi il `tab` tasto e vai al menu a discesa **Filtra per tag**, premi il tasto freccia giù per attivare il menu e individuare un tag e premi `Enter` per selezionare il tag.

# Pannelli e visualizzazioni in Grafana versione 9
<a name="v9-panels"></a>

****  
**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 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)

 Il *pannello* è l'elemento base della visualizzazione in Grafana. Ogni pannello ha un editor di query specifico per la fonte di dati selezionata nel pannello. L'editor di query consente di creare una query che restituisce i dati che si desidera visualizzare. 

 Esiste un'ampia varietà di opzioni di stile e formattazione per ogni pannello. I pannelli possono essere trascinati, rilasciati e ridimensionati per riorganizzarli sulla dashboard. 

 Prima di aggiungere un pannello, assicurati di aver configurato una fonte di dati. 

Potrebbero essere disponibili altri tipi di pannelli installando [plugin](grafana-plugins.md) aggiuntivi nell'area di lavoro.
+  Per informazioni dettagliate sull'utilizzo di fonti di dati specifiche, consulta. [Connessione alle origini dati](AMG-data-sources.md) 

**Topics**
+ [Panoramica dell'editor di pannelli](v9-panels-editor-overview.md)
+ [Configura le opzioni del pannello](v9-panels-configure-panel-options.md)
+ [Configurazione delle opzioni standard](v9-panels-configure-standard-options.md)
+ [Interroga e trasforma i dati](v9-panels-query-xform.md)
+ [Configurare le soglie](v9-panels-configure-thresholds.md)
+ [Configurare i collegamenti dati](v9-panels-configure-data-links.md)
+ [Configura le sostituzioni dei campi](v9-panels-configure-overrides.md)
+ [Configurare le mappature dei valori](v9-panels-configure-value-mappings.md)
+ [Configurare una legenda](v9-panels-configure-legend.md)
+ [Tipi di calcolo](v9-panels-calculation-types.md)
+ [Annotazione delle visualizzazioni](v9-panels-annotate-visualizations.md)
+ [La vista di ispezione del pannello](v9-panels-panel-inspector.md)
+ [Visualizzazioni disponibili nella versione 9 di Grafana](v9-panels-viz.md)

# Panoramica dell'editor di pannelli
<a name="v9-panels-editor-overview"></a>

****  
**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 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)

 Questa sezione descrive le aree dell'editor del pannello Grafana. 
+  Intestazione del pannello: la sezione header elenca la dashboard in cui viene visualizzato il pannello e i seguenti controlli: 
  +  **Icona delle impostazioni della dashboard (ingranaggio):** fai clic per accedere alle impostazioni della dashboard. 
  +  **Ignora: elimina** le modifiche apportate al pannello dall'ultima volta che hai salvato la dashboard. 
  +  **Salva:** salva le modifiche apportate al pannello. 
  +  **Applica:** applica le modifiche apportate e chiude l'editor del pannello, riportandoti alla dashboard. Dovrai salvare la dashboard per rendere permanenti le modifiche applicate. 
+  Anteprima della visualizzazione: la sezione di anteprima della visualizzazione contiene le seguenti opzioni: 
  +  **Visualizzazione tabella:** converte qualsiasi visualizzazione in una tabella in modo da poter vedere i dati. Le viste tabellari sono utili per la risoluzione dei problemi. Questa vista contiene solo i dati grezzi. Non include le trasformazioni che potresti aver applicato ai dati o le opzioni di formattazione disponibili nella visualizzazione della [tabella](v9-panels-table.md). 
  +  **Riempimento:** l'anteprima della visualizzazione riempie lo spazio disponibile. Se si modifica la larghezza del riquadro laterale o l'altezza del riquadro inferiore, la visualizzazione cambia per occupare lo spazio disponibile. 
  +  **Effettiva:** l'anteprima della visualizzazione avrà le dimensioni esatte di quelle sulla dashboard. Se lo spazio disponibile non è sufficiente, la visualizzazione verrà ridimensionata preservando le proporzioni. 
  +  **Controlli dell'intervallo di tempo:** l'**impostazione predefinita** è il fuso orario locale del browser o il fuso orario selezionato a un livello superiore. 
+  Sezione dati: la sezione dati contiene schede in cui è possibile immettere interrogazioni, trasformare i dati e creare regole di avviso (se applicabile). 
  +  **Scheda Query:** seleziona la tua fonte di dati e inserisci le domande qui. 
  +  **Scheda Trasforma:** applica le trasformazioni dei dati. 
  +  **Scheda Avviso:** scrivi le regole di avviso. 
+  Opzioni di visualizzazione del pannello: la sezione delle opzioni di visualizzazione contiene schede in cui è possibile configurare quasi ogni aspetto della visualizzazione dei dati. 

## Apri il pannello, ispeziona il cassetto
<a name="v9-panels-editor-open-panel"></a>

 Il cassetto di ispezione consente di comprendere e risolvere i problemi dei pannelli. È possibile visualizzare i dati grezzi di qualsiasi pannello, esportarli in un file con valori separati da virgole (CSV), visualizzare le richieste di interrogazione ed esportare pannelli e dati in formato JSON. 

 **Nota:** non tutti i tipi di pannello includono tutte le schede. Ad esempio, i pannelli con l'elenco delle dashboard non contengono dati grezzi da esaminare, quindi non visualizzano le schede Statistiche, Dati o Query. 

 L'ispettore del pannello include le seguenti opzioni: 
+  Il pannello Inspect Drawer Display apre un cassetto sul lato destro. Fate clic sulla freccia nell'angolo superiore destro per espandere o ridurre il riquadro del cassetto. 
+  **Scheda Dati:** mostra i dati grezzi restituiti dall'interrogazione con le trasformazioni applicate. Le opzioni di campo come le sostituzioni e le mappature dei valori non vengono applicate per impostazione predefinita. 
+  **Scheda Statistiche:** mostra quanto tempo impiega la query e quanto restituisce. 
+  **Scheda JSON:** consente di visualizzare e copiare il pannello JSON, i dati del pannello JSON e la struttura del frame di dati JSON. Ciò è utile se si esegue il provisioning o la somministrazione di Grafana. 
+  **Scheda Query:** mostra le richieste al server inviate quando Grafana interroga l'origine dati. 
+  **Scheda Errore:** mostra l'errore. Visibile solo quando la query restituisce un errore. 

# Configura le opzioni del pannello
<a name="v9-panels-configure-panel-options"></a>

****  
**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 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)

 Un pannello Grafana è l'interfaccia utente utilizzata per definire una query sull'origine dati e trasformare e formattare i dati che appaiono nelle visualizzazioni. 

 Un editor di pannelli include un generatore di query e una serie di opzioni che potete usare per trasformare i dati e aggiungere informazioni ai pannelli. 

 Questo argomento descrive come: 
+  Aprire un pannello per la modifica 
+  Aggiungi un titolo e una descrizione del pannello 
+  Visualizza un modello JSON di un pannello 
+  Aggiungi righe e pannelli ripetuti 

## Modificare un pannello
<a name="v9-panels-edit-a-panel"></a>

 Dopo aver aggiunto un pannello a una dashboard, puoi aprirlo in qualsiasi momento per modificare, modificare o aggiornare le interrogazioni, aggiungere la trasformazione dei dati e modificare le impostazioni di visualizzazione. 

1.  Apri la dashboard che contiene il pannello che desideri modificare. 

1.  Passa il mouse su qualsiasi parte del pannello per visualizzare il menu delle azioni nell'angolo in alto a destra. 

1.  Fai clic sul menu e seleziona **Modifica**. 

    **Per usare una scorciatoia da tastiera per aprire il pannello, passa il mouse sul pannello e premi e.** 

    Il pannello si apre in modalità di modifica. 

## Aggiungere un titolo e una descrizione a un pannello
<a name="v9-panels-add-title-description"></a>

 Aggiungi un titolo e una descrizione a un pannello per condividere con gli utenti tutte le informazioni importanti sulla visualizzazione. Ad esempio, utilizza la descrizione per documentare lo scopo della visualizzazione. 

1.  Modifica un pannello. 

1.  Nel riquadro delle opzioni di visualizzazione del pannello, individua la sezione **Opzioni del pannello**. 

1.  Inserisci un **titolo**. 

    Il testo inserito in questo campo viene visualizzato nella parte superiore del pannello nell'editor dei pannelli e nella dashboard. 

1.  Scrivi una descrizione del pannello e dei dati che stai visualizzando. 

    Il testo inserito in questo campo viene visualizzato in un tooltip nell'angolo superiore sinistro del pannello. 

    [È possibile utilizzare [le variabili definite](v9-dash-variables.md) nel campo **Titolo** e **Descrizione**, ma non variabili globali.](v9-dash-variable-add.md#v9-dash-variable-add-global)

    

## Visualizza un modello JSON a pannello
<a name="v9-panels-json-model"></a>

 Esplora ed esporta modelli JSON di pannelli, pannelli e frame di dati. 

1.  Apri la dashboard che contiene il pannello. 

1.  Passa il mouse su qualsiasi parte del pannello per visualizzare il menu delle azioni nell'angolo in alto a destra. 

1.  Fai clic sul menu e seleziona **Ispeziona > Pannello JSON**. 

1.  Nel campo **Seleziona sorgente**, seleziona una delle seguenti opzioni: 
   +  **Pannello JSON:** visualizza un oggetto JSON che rappresenta il pannello. 
   +  **Dati del pannello:** visualizza un oggetto JSON che rappresenta i dati passati al pannello. 
   +  **DataFrame struttura:** Visualizza il set di risultati non elaborato con trasformazioni, configurazioni di campo e configurazioni di override applicate. 

1.  Per esplorare il formato JSON, fate clic su **>** per espandere o comprimere parti del modello JSON. 

## Configura i pannelli ripetuti
<a name="v9-panels-configure-repeating-panels"></a>

 Puoi configurare Grafana per aggiungere dinamicamente pannelli o righe a una dashboard. Un pannello dinamico è un pannello che il sistema crea in base al valore di una variabile. Le variabili modificano dinamicamente le tue interrogazioni su tutti i pannelli di una dashboard.

**Nota**  
I pannelli ripetuti richiedono che le variabili abbiano uno o più elementi selezionati; non è possibile ripetere un pannello zero volte per nasconderlo. 

 **Prima di iniziare:** 
+  Assicurati che l'interrogazione includa una variabile multivalore. 

 **Per configurare i pannelli ripetuti:** 

1. Modifica il pannello che desideri ripetere.

1.  Nel riquadro delle opzioni di visualizzazione, fate clic su **Opzioni del pannello > Opzioni di ripetizione**. 

1.  Seleziona una **direzione**. 
   +  Scegliete **orizzontale** per disporre i pannelli side-by-side. Grafana regola la larghezza di un pannello ripetuto. Attualmente, non è possibile combinare altri pannelli su una riga con un pannello ripetuto. 
   +  Scegliete **verticale** per disporre i pannelli in una colonna. La larghezza dei pannelli ripetuti è la stessa del pannello originale ripetuto. 

1.  Per propagare le modifiche a tutti i pannelli, ricarica la dashboard. 

# Configurazione delle opzioni standard
<a name="v9-panels-configure-standard-options"></a>

****  
**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 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)

 Il modello di dati utilizzato in Grafana è una struttura tabellare orientata a colonne che unifica sia le serie temporali che i risultati delle query tabellari. *Ogni colonna all'interno di questa struttura è chiamata campo.* Un campo può rappresentare una singola serie temporale o colonna di tabella. 

 Le opzioni di campo consentono di modificare la modalità di visualizzazione dei dati nelle visualizzazioni. Le opzioni e le sostituzioni applicate non modificano i dati, ma il modo in cui Grafana li visualizza. Quando si modifica un'opzione, questa viene applicata a tutti i campi, ovvero a tutte le serie o colonne. Ad esempio, se si modifica l'unità in percentuale, tutti i campi con valori numerici vengono visualizzati in percentuale. 

 Per un elenco completo delle opzioni di formattazione dei campi, consulta Definizioni delle opzioni [standard](#v9-panels-standard-options-definitions).

**Nota**  
 È possibile applicare opzioni standard alla maggior parte dei pannelli Grafana integrati. Ad alcuni vecchi pannelli e pannelli della community che non sono stati aggiornati al nuovo pannello e al nuovo modello di dati mancheranno tutte o alcune di queste opzioni di campo. 

1.  Apri una dashboard, fai clic sul titolo del pannello e fai clic su **Modifica**. 

1.  Nel riquadro delle opzioni di visualizzazione del pannello, individua la sezione **Opzioni standard**. 

1.  Seleziona le opzioni standard che desideri applicare. 

1.  Per visualizzare l'anteprima della modifica, fai clic all'esterno della casella delle opzioni di campo che stai modificando o premi **Invio**. 

## Definizioni delle opzioni standard
<a name="v9-panels-standard-options-definitions"></a>

 Questa sezione spiega tutte le opzioni standard disponibili. 

 È possibile applicare opzioni standard alla maggior parte dei pannelli Grafana integrati. Ad alcuni vecchi pannelli e pannelli della community che non sono stati aggiornati al nuovo pannello e al nuovo modello di dati mancheranno tutte o alcune di queste opzioni di campo. 

 La maggior parte delle opzioni di campo non influirà sulla visualizzazione finché non si fa clic all'esterno della casella delle opzioni di campo che si sta modificando o si preme Invio. 

**Nota**  
 Lavoriamo costantemente per aggiungere ed espandere le opzioni per tutte le visualizzazioni, pertanto tutte le opzioni potrebbero non essere disponibili per tutte le visualizzazioni. 

### Unità
<a name="v9-panels-standard-options-unit"></a>

 Consente di scegliere l'unità da utilizzare in un campo. Fai clic nel campo **Unità**, quindi esegui il drill-down fino a trovare l'unità desiderata. L'unità selezionata viene applicata a tutti i campi tranne il tempo. 

#### Unità personalizzate
<a name="v9-panels-standard-options-custom-units"></a>

 Puoi utilizzare il menu a discesa delle unità per specificare anche unità personalizzate, prefisso o suffisso personalizzati e formati di data e ora. 

 Per selezionare un'unità personalizzata, inserisci l'unità e seleziona l'ultima opzione **Custom: xxx** nel menu a discesa. 
+  **suffisso:** <suffix>per l'unità personalizzata che deve seguire il valore. 
+  **prefisso:** <prefix>per l'unità personalizzata che deve precedere il valore. 
+  **ora:** <format>per formati di data e ora personalizzati, digita ad esempio **time:YYYYY-MM-DD**. [Vedi i formati per la sintassi e le opzioni del formato.](https://momentjs.com/docs/#/displaying/)
+  **si:** <base scale><unit characters>per unità SI personalizzate. Ad esempio: **si: mF.** Questo è un po' più avanzato in quanto consente di specificare sia un'unità che la scala dei dati di origine. Quindi, se i dati di origine sono rappresentati come milli (migliaia di) qualcosa, prefiggi l'unità con quel carattere di scala SI. 
+  **count:** <unit>per un'unità di conteggio personalizzata. 
+  **valuta:** <unit>per personalizzare un'unità monetaria. 

 Puoi anche incollare un'emoji nativa nel selettore di unità e sceglierla come unità personalizzata. 

#### Unità di stringa
<a name="v9-panels-standard-options-string-units"></a>

 Grafana a volte può essere troppo aggressivo nell'analizzare le stringhe e visualizzarle come numeri. **Per configurare Grafana in modo che mostri il valore della stringa originale, crea un campo override e aggiungi una proprietà di unità con l'unità String.** 

### Min
<a name="v9-panels-standard-options-min"></a>

 Consente di impostare il valore minimo utilizzato nei calcoli della soglia percentuale. Lascia vuoto per il calcolo automatico basato su tutte le serie e i campi. 

### Max
<a name="v9-panels-standard-options-max"></a>

 Consente di impostare il valore massimo utilizzato nei calcoli della soglia percentuale. Lascia vuoto per il calcolo automatico basato su tutte le serie e i campi. 

### Decimali
<a name="v9-panels-standard-options-decimals"></a>

 Specificate il numero di decimali che Grafana include nel valore renderizzato. Se lasci vuoto questo campo, Grafana tronca automaticamente il numero di decimali in base al valore. Ad esempio 1.1234 verrà visualizzato come 1,12 e 100.456 verrà visualizzato come 100. 

 **Per visualizzare tutti i decimali, imposta l'unità su String.** 

### Display name (Nome visualizzato)
<a name="v9-panels-standard-options-displayname"></a>

 Consente di impostare il titolo di visualizzazione di tutti i campi. È possibile utilizzare [variabili](v9-dash-variables.md).

 Quando vengono visualizzate più statistiche, campi o serie, questo campo controlla il titolo di ogni statistica. Puoi usare espressioni come **\$1 \$1\$1\$1field.name\$1 per usare solo il nome** della serie o il nome del campo nel titolo. 

 Viene fornito un campo con il nome Temp e le etichette \$1"loc"="PBI», «Sensor"="3"\$1 


|  Sintassi delle espressioni  |  Esempio  |  Renderizza su  |  Spiegazione  | 
| --- | --- | --- | --- | 
|  \$1 \$1\$1\$1field.displayName\$1  |  Uguale alla sintassi  |  Temperatura \$1loc="PBI», Sensor="3"\$1  |  Visualizza il nome del campo e le etichette in \$1\$1, se presenti. Se nella risposta è presente una sola chiave di etichetta, per la parte dell'etichetta, Grafana visualizza il valore dell'etichetta senza le parentesi racchiuse.  | 
|  \$1 \$1\$1\$1field.name\$1  |  Uguale alla sintassi  |  Temp  |  Visualizza il nome del campo (senza etichette).  | 
|  \$1 \$1\$1\$1field.labels\$1  |  Uguale alla sintassi  |  loc="PBI», Sensore="3"  |  Visualizza le etichette senza il nome.  | 
|  \$1 \$1\$1\$1field.labels.x\$1  |  \$1 \$1\$1\$1field.labels.loc\$1  |  PBI  |  Visualizza il valore della chiave dell'etichetta specificata.  | 
|  \$1 \$1\$1\$1field.labels. \$1\$1valori\$1  |  Uguale alla sintassi  |  PBI, 3  |  Visualizza i valori delle etichette separate da una virgola (senza chiavi di etichetta).  | 

 Se il valore è una stringa vuota dopo il rendering dell'espressione per un determinato campo, viene utilizzato il metodo di visualizzazione predefinito. 

### Combinazione di colori
<a name="v9-panels-standard-options-color-scheme"></a>

 Le opzioni di colore e il relativo effetto sulla visualizzazione dipendono dalla visualizzazione con cui si sta lavorando. Alcune visualizzazioni hanno diverse opzioni di colore. 

 È possibile specificare un singolo colore o selezionare uno schema di colori continuo (sfumato), in base a un valore. Il colore continuo interpola un colore utilizzando la percentuale di un valore rispetto ai valori min e max. 

 Selezionate una delle seguenti palette: 


|  modalità a colori  |  Description  | 
| --- | --- | 
|  Colore singolo  |  Specificate un solo colore, utile in una regola di override  | 
|  Dalle soglie  |  Informa Grafana di prendere il colore dalla soglia corrispondente  | 
|  Palette classica  |  Grafana assegnerà il colore cercando un colore in una tavolozza per indice di serie. Utile per grafici, diagrammi a torta e altre visualizzazioni di dati categoriali  | 
|  Green-Yellow-Red (per valore)  |  Combinazione di colori continua  | 
|  Blue-Yellow-Red (per valore)  |  Combinazione di colori continua  | 
|  Blues (per valore)  |  Combinazione di colori continua (sfondo del pannello in blu)  | 
|  Rossi (per valore)  |  Combinazione di colori continua (lo sfondo del pannello diventa blu)  | 
|  Verdi (per valore)  |  Combinazione di colori continua (lo sfondo del pannello diventa blu)  | 
|  Viola (in base al valore)  |  Combinazione di colori continua (lo sfondo del pannello diventa blu)  | 

### Nessun valore
<a name="v9-panels-standard-options-no-value"></a>

 Inserisci cosa Grafana deve mostrare se il valore del campo è vuoto o nullo. Il valore predefinito è un trattino (-). 

# Interroga e trasforma i dati
<a name="v9-panels-query-xform"></a>

****  
**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 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)

Grafana supporta molti tipi di fonti di [dati](AMG-data-sources.md). *Le interrogazioni sulle* fonti di dati restituiscono dati che Grafana *può* trasformare e visualizzare. Ogni fonte di dati utilizza il proprio linguaggio di query e i plug-in di origine dati implementano ciascuno un'interfaccia utente per la creazione di query chiamata editor di query.

## Informazioni sulle interrogazioni
<a name="v9-panels-query-xform-about"></a>

I pannelli Grafana comunicano con le fonti di dati tramite query, che recuperano i dati per la visualizzazione. Una query è una domanda scritta nel linguaggio di interrogazione utilizzato dalla fonte di dati.

È possibile configurare la frequenza delle interrogazioni e i limiti di raccolta dei dati nelle opzioni di origine dati del pannello. Grafana supporta fino a 26 interrogazioni per pannello.

Puoi trovare ulteriori informazioni sul linguaggio di interrogazione di ciascuna fonte di dati nella sezione [Fonti dati](AMG-data-sources.md).

**Editor di query**

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.

Per i dettagli sulle funzionalità esclusive dell'editor di query di una specifica fonte di dati, consulta la relativa documentazione:
+ Per le fonti di dati incluse in Grafana, vedi Origini [dati integrate](AMG-data-sources-builtin.md).
+ Per le fonti di dati incluse nell'edizione Grafana Enterprise, vedere. [Connect a fonti di dati aziendali](AMG-data-sources-enterprise.md)

**Sintassi delle query**

Le fonti di dati utilizzano diversi linguaggi di interrogazione per richiedere dati. Per i dettagli sul linguaggio di interrogazione unico di una fonte di dati specifica, consulta la relativa documentazione.

**Esempio di PostgreSQL:**

```
SELECT hostname FROM host WHERE region IN($region)
```

**Esempio PromQL:**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**Fonti di dati speciali**

**Grafana include anche tre fonti di dati speciali: **Grafana**, **Mixed** e Dashboard.** Per i dettagli, consulta Fonti di dati

## Naviga nella scheda Query
<a name="v9-panels-query-xform-navigate"></a>

La scheda **Query** di un pannello è composta dai seguenti elementi:
+ **Selettore di origine dati**: seleziona l'origine dati da interrogare.
+ **Opzioni di interrogazione:** — Imposta i parametri massimi di recupero dei dati e gli intervalli di tempo di esecuzione delle query.
+ **Pulsante Query Inspector:** — Apre il pannello Query Inspector, in cui è possibile visualizzare e ottimizzare la query.
+ **Elenco dell'editor di query:** — Elenca le domande che hai scritto.
+ **Espressioni:** — Utilizza il generatore di espressioni per creare espressioni di avviso. Per ulteriori informazioni sulle espressioni, consulta [Scrivere interrogazioni sulle espressioni](v9-panels-query-xform-expressions.md).

## Aggiungere un'interrogazione
<a name="v9-panels-query-xform-add"></a>

Una query restituisce i dati che Grafana visualizza nei pannelli del dashboard. Quando crei un pannello, Grafana seleziona automaticamente l'origine dati predefinita.

**Per aggiungere una query**

1. Modifica il pannello a cui stai aggiungendo un'interrogazione.

1. Scegli la scheda **Queries** (Query).

1. Scegli il menu a discesa **Origine dati** e seleziona una fonte di dati.

1. Scegli **le opzioni di interrogazione** per configurare il numero massimo di punti dati necessari. Per ulteriori informazioni sulle opzioni di interrogazione, consulta[Opzioni di interrogazione](#v9-panels-query-xform-options).

1. Scrivere la query utilizzando l'editor di query.

1. Scegli **Applica**.

Grafana interroga la fonte di dati e visualizza i dati.

## Gestisci le interrogazioni
<a name="v9-panels-query-xform-manage"></a>

Grafana organizza le interrogazioni in righe di interrogazione comprimibili. Ogni riga di query contiene un editor di query ed è identificata da una lettera (A, B, C e così via).

Per gestire le query, è possibile copiare le interrogazioni, nasconderle, rimuovere una query, riordinare le interrogazioni e attivare la guida dell'editor di query.

## Opzioni di interrogazione
<a name="v9-panels-query-xform-options"></a>

Scegli **le opzioni di interrogazione** accanto al selettore dell'origine dati per visualizzare le impostazioni per l'origine dati selezionata. Le modifiche che apporti qui influiscono solo sulle interrogazioni effettuate in questo pannello.

Grafana imposta i valori predefiniti che vengono visualizzati nel testo grigio scuro. Le modifiche vengono visualizzate in testo bianco. Per riportare un campo all'impostazione predefinita, elimina il testo bianco dal campo.

Le opzioni di interrogazione delle fonti di dati del pannello includono:
+ **Numero massimo di punti dati**: se l'origine dati lo supporta, imposta il numero massimo di punti dati per ogni serie restituita. Se la query restituisce più punti dati rispetto all'impostazione del numero massimo di punti dati, l'origine dati riduce il numero di punti restituiti aggregandoli per media, max o un'altra funzione.

  È possibile limitare il numero di punti per migliorare le prestazioni delle query o rendere più fluida la linea visualizzata. Il valore predefinito è la larghezza (o il numero di pixel) del grafico, poiché è possibile visualizzare solo il numero di punti dati disponibile nel pannello grafico.

  Con lo streaming di dati, Grafana utilizza il valore massimo dei punti dati per il rolling buffer. Lo streaming è un flusso continuo di dati e il buffering divide il flusso in blocchi. Ad esempio, Loki trasmette i dati in modalità live tailing.
+ **Intervallo minimo**: imposta un limite minimo per l'intervallo calcolato automaticamente, che in genere è l'intervallo minimo di scrape. Se un punto dati viene salvato ogni 15 secondi, non trarrai vantaggio dall'avere un intervallo inferiore a quello. Puoi anche impostarlo su un valore minimo superiore all'intervallo di scrape per recuperare interrogazioni più dettagliate e ben funzionanti.
+ Intervallo: imposta un **intervallo** di tempo che è possibile utilizzare per aggregare o raggruppare i punti dati in base al tempo.

  Grafana calcola automaticamente un intervallo appropriato che puoi utilizzare come variabile nelle query basate su modelli. La variabile viene misurata in secondi () o millisecondi ()`$__interval`. `$__interval_ms`

  Gli intervalli vengono in genere utilizzati in funzioni di aggregazione come somma o media. Ad esempio, questa è una query Prometheus che utilizza la variabile interval:. `rate(http_requests_total[$__interval])`

  Questo intervallo automatico viene calcolato in base alla larghezza del grafico. Man mano che l'utente rimpicciolisce una visualizzazione, l'intervallo aumenta, con conseguente aggregazione a grana più grossa. Allo stesso modo, se l'utente ingrandisce, l'intervallo diminuisce, ottenendo un'aggregazione più dettagliata.

  Per ulteriori informazioni, consulta [Variabili globali](v9-dash-variable-add.md#v9-dash-variable-add-global).
+ **Tempo relativo**: sostituisce l'intervallo di tempo relativo per i singoli pannelli, il che li rende diversi da quello selezionato nel selettore temporale della dashboard nell'angolo in alto a destra della dashboard. Puoi usarlo per mostrare le metriche relative a periodi di tempo o giorni diversi sulla stessa dashboard.
**Nota**  
Le sostituzioni temporali del pannello non hanno effetto quando l'intervallo di tempo della dashboard è assoluto.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Spostamento temporale**: sostituisce l'intervallo di tempo per i singoli pannelli spostandone l'inizio e la fine rispetto al selettore orario. Ad esempio, puoi spostare l'intervallo di tempo per il pannello in modo che sia due ore prima rispetto al selettore orario della dashboard.
**Nota**  
Le sostituzioni temporali del pannello non hanno effetto quando l'intervallo di tempo del pannello di controllo è assoluto.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v9-panels-query-xform.html)
+ **Timeout della cache**: *(visibile solo se disponibile nell'origine dati) Sostituisce il* timeout predefinito della cache se l'archivio delle serie temporali dispone di una cache delle query. Specificate questo valore come valore numerico in secondi.

# Scrivere interrogazioni sulle espressioni
<a name="v9-panels-query-xform-expressions"></a>

****  
**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 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 espressioni lato server consentono di manipolare i dati restituiti dalle query con operazioni matematiche e di altro tipo. Le espressioni creano nuovi dati e non manipolano i dati restituiti dalle fonti di dati.

## Informazioni sulle espressioni
<a name="v9-panels-query-about"></a>

Le espressioni lato server consentono di manipolare i dati restituiti dalle query con operazioni matematiche e di altro tipo. Le espressioni creano nuovi dati e non manipolano i dati restituiti dalle fonti di dati, a parte alcune piccole ristrutturazioni dei dati per rendere i dati accettabili come input per le espressioni.

**Utilizzo delle espressioni**

Le espressioni sono utilizzate principalmente da [Grafana](v9-alerts.md) Alerting. L'elaborazione viene eseguita sul lato server, quindi le espressioni possono funzionare senza una sessione del browser. Tuttavia, le espressioni possono essere utilizzate anche con fonti di dati e visualizzazioni di backend.

**Nota**  
Le espressioni non funzionano con gli avvisi del dashboard legacy.

Le espressioni hanno lo scopo di aumentare le fonti di dati abilitando la combinazione di query provenienti da diverse fonti di dati o fornendo operazioni non disponibili in un'origine dati.

**Nota**  
Quando possibile, è necessario eseguire l'elaborazione dei dati all'interno della fonte dati. La copia dei dati dallo storage al server Grafana per l'elaborazione è inefficiente, quindi le espressioni sono destinate all'elaborazione leggera dei dati.

Le espressioni funzionano con le query relative alle fonti di dati che restituiscono serie temporali o dati numerici. Funzionano anche su dati [multidimensionali](getting-started-grafanaui.md#time-series-dimensions). Ad esempio, una query che restituisce più serie, in cui ogni serie è identificata da etichette o tag.

Una singola espressione accetta una o più query o altre espressioni come input e aggiunge dati al risultato. Ogni singola espressione o query è rappresentata da una variabile che è un identificatore denominato noto come refID (ad esempio, la lettera predefinita o). `A` `B`

Per fare riferimento all'output di una singola espressione o di una query di origine dati in un'altra espressione, questo identificatore viene utilizzato come variabile.

**Tipi di espressioni**

Le espressioni funzionano con due tipi di dati.
+ Una raccolta di serie temporali.
+ Una raccolta di numeri, in cui ogni numero è un elemento.

Ogni raccolta viene restituita da una singola query o espressione di origine dati e rappresentata dal RefID. Ogni raccolta è un insieme, in cui ogni elemento del set è identificato in modo univoco dalle sue dimensioni, memorizzate come [etichette](getting-started-grafanaui.md#labels) o coppie chiave-valore.

**Interrogazioni sull'origine dei dati**

Le espressioni lato server supportano solo le query sulle origini dati per le origini dati di backend. Si presume generalmente che i dati siano etichettati come dati di serie temporali. In futuro intendevamo aggiungere un'asserzione del tipo di dati restituito dalla query (numero o serie temporale) in modo che le espressioni possano gestire meglio gli errori.

Le query relative alle fonti di dati, se utilizzate con le espressioni, vengono eseguite dal motore delle espressioni. Quando esegue questa operazione, ristruttura i dati in modo che siano costituiti da una serie temporale o da un numero per frame di dati. Quindi, ad esempio, se si utilizza un'origine dati che restituisce più serie su un frame nella visualizzazione per tabella, si potrebbe notare che ha un aspetto diverso quando viene eseguita con espressioni.

Attualmente, l'unico formato non di serie temporale (numero) supportato quando si utilizzano i frame di dati è una risposta in tabella che restituisce un frame di dati senza ora, colonne di stringhe e una colonna numerica:


| Loc | Host | AVG\$1CPU | 
| --- | --- | --- | 
|  MIA  |  A  |  1  | 
|  NYC  |  B  |  2  | 

L'esempio precedente produrrà un numero che funziona con le espressioni. Le colonne di stringhe diventano etichette e la colonna numerica il valore corrispondente. Ad esempio `{"Loc": "MIA", "Host": "A"}` con il valore 1.

**Operazioni**

È possibile utilizzare le seguenti operazioni nelle espressioni: math, reduce e resample.

**Math** (Matematica)

La matematica serve per formule matematiche in formato libero su serie temporali o dati numerici. Le operazioni matematiche prendono come input numeri e serie temporali e li modificano in numeri e serie temporali diversi.

Ad esempio, ai dati di altre query o espressioni viene fatto riferimento con il RefID preceduto dal simbolo del dollaro. `$A` Se la variabile contiene spazi nel nome, puoi usare una sintassi tra parentesi come. `${my variable}`

Le costanti numeriche possono essere in formato decimale (`2.24`), ottale (con uno zero iniziale come) o esadecimale (con uno 0x iniziale`072`). `0x2A` Sono supportati anche esponenziali e segni (ad es.). `-0.8e-2`

**Operatori**

Sono supportati gli operatori aritmetici (`+`binari e unari`-`,`*`,`/`,`%`, esponenti`**`), relazionali (`<`,,,`>`, `==` `!=``>=`,`<=`) e logici (`&&``||`, e unari). `!`

Il comportamento dell'operazione con i dati dipende dal fatto che si tratti di dati numerici o di serie temporali.

Con le operazioni binarie, come `$A + $B` o`$A || $B`, l'operatore viene applicato nei seguenti modi a seconda del tipo di dati:
+ Se entrambi `$A` e `$B` sono numeri, l'operazione viene eseguita tra i due numeri.
+ Se una variabile è un numero e l'altra variabile è una serie temporale, viene eseguita l'operazione tra il valore di ogni punto della serie temporale e il numero.
+ Se entrambe `$A` le serie `$B` sono dati di serie temporali, l'operazione tra ogni valore delle due serie viene eseguita per ogni indicatore temporale presente in entrambe `$A` e`$B`. L'`Resample`operazione può essere utilizzata per allineare i timestamp.

Riepilogo:
+ Numero OP = numero
+ Numero serie OP = serie
+ Serie OP = serie

Poiché le espressioni funzionano con più serie o numeri rappresentati da una singola variabile, le operazioni binarie eseguono anche un'unione (unione) tra le due variabili. Questa operazione viene eseguita sulla base delle etichette identificative associate a ogni singola serie o numero.

Quindi, se hai numeri con etichette come `{host=web01}` in `$A` e un altro numero `$B` con le stesse etichette, l'operazione viene eseguita tra questi due elementi all'interno di ciascuna variabile e il risultato condividerà le stesse etichette. Le regole per il comportamento di questa unione sono le seguenti:
+ Un articolo senza etichette si unirà a qualsiasi cosa.
+ Se `$B` entrambi `$A` contengono un solo elemento (una serie o un numero), si uniranno.
+ Se le etichette sono matematiche esatte, si uniranno.
+ Se le etichette sono un sottoinsieme delle altre, ad esempio un elemento in `$A` è etichettato `{host=A,dc=MIA}` e un elemento in `$B` è `{host=A}` etichettato, si uniranno.
+ Se all'interno di una variabile, ad esempio, `$A` ci sono diverse chiavi di tag per ogni elemento, il comportamento di unione non è definito.

Gli operatori relazionali e logici restituiscono 0 per falso, 1 per vero.

**Funzioni matematiche**

Sebbene la maggior parte delle funzioni sia presente nelle operazioni di espressione proprie, l'operazione matematica presenta alcune funzioni simili agli operatori o ai simboli matematici. Quando le funzioni possono accettare numeri o serie, verrà restituito lo stesso tipo dell'argomento. Quando si tratta di una serie, l'operazione viene eseguita per il valore di ogni punto della serie.

*addominali*

abs restituisce il valore assoluto del suo argomento che può essere un numero o una serie. Ad esempio: `abs(-1)` o `abs($A)`.

*is\$1inf*

is\$1inf accetta un numero o una serie e restituisce `1` `Inf` valori (negativi o positivi) e `0` altri valori. Ad esempio, `is_inf($A)`.

**Nota**  
Se hai bisogno di verificare specificamente l'infinito negativo, ad esempio, puoi fare un confronto come. `$A == infn()`

*is\$1nan*

is\$1nan prende un numero o una serie e restituisce valori e `1` altri `NaN` valori. `0` Ad esempio, `is_nan($A)`. Questa funzione esiste perché non `NaN` è uguale a. `NaN`

*is\$1null*

is\$1null accetta un numero o una serie e restituisce valori e altri valori`1`. `null` `0` Ad esempio, `is_null($A)`.

*is\$1number*

is\$1number prende un numero o una serie e restituisce tutti `1` i valori numerici reali e `0` gli altri valori (che sono`null`,`Inf+`, `Inf-` e). `NaN` Ad esempio, `is_number($A)`.

*registro*

Log restituisce il logaritmo naturale del suo argomento, che può essere un numero o una serie. Se il valore è inferiore a 0, `NaN` viene restituito. Ad esempio: `log(-1)` o `log($A)`.

*inf, infn, nan e null*

Le funzioni inf, infn, nan e null restituiscono tutte un singolo valore del nome. Esistono principalmente per i test. Esempio: `null()`.

*rotondo*

Round restituisce un valore intero arrotondato. Ad esempio `round(3.123)` o `round($A)`.

*soffitto*

Ceil arrotonda il numero al valore intero più vicino. Ad esempio, `ceil(3.123)` restituisce `4`.

*pavimento*

Floor arrotonda il numero per difetto al valore intero più vicino. Ad esempio,`floor(3.123`) restituisce. `3`

**Ridurre**

Reduce prende una o più serie temporali restituite da una query o un'espressione e trasforma ogni serie in un unico numero. Le etichette delle serie temporali vengono conservate come etichette su ogni numero ridotto emesso.

*Campi:*
+ **Funzione**: la funzione di riduzione da utilizzare
+ **Input**: la variabile (RefID (ad esempio`A`)) da ricampionare
+ **Modalità**: consente il comportamento di controllo della funzione di riduzione quando una serie contiene valori non numerici (null, NaN, \$1-Inf)

**Funzioni di riduzione**

*Conteggio*

Count restituisce il numero di punti in ogni serie.

*Significa*

La media restituisce il totale di tutti i valori di ogni serie diviso per il numero di punti di quella serie. In `strict` modalità se alcuni valori della serie sono null o nan, o se la serie è vuota, viene restituito NaN.

*Min e Max*

Min e Max restituiscono rispettivamente il valore più piccolo o più grande della serie. In `strict` modalità se alcuni valori della serie sono null o nan, o se la serie è vuota, viene restituito NaN.

*Somma*

Sum restituisce il totale di tutti i valori della serie. Se la serie è di lunghezza zero, la somma sarà 0. In `strict` modalità, se nella serie sono presenti valori NaN o Null, viene restituito NaN.

*Ultimo*

Ultimo restituisce l'ultimo numero della serie. Se la serie non ha valori, restituisce NaN.

**Modalità di riduzione**

*Rigido*

In modalità Strict, la serie di input viene elaborata così com'è. Se alcuni valori della serie non sono numerici (null, NaN o \$1-Inf), viene restituito NaN.

*Elimina caratteri non numerici*

In questa modalità tutti i valori non numerici (null, NaN o \$1-Inf) nella serie di input vengono filtrati prima di eseguire la funzione di riduzione.

*Sostituisci valori non numerici*

In questa modalità tutti i valori non numerici vengono sostituiti da un valore predefinito.

**Ricampionamento**

Resample modifica i timestamp di ogni serie temporale per avere un intervallo di tempo coerente. Il caso d'uso principale consiste nel ricampionare serie temporali che non condividono gli stessi timestamp in modo da poter eseguire operazioni matematiche tra di esse. Questa operazione può essere eseguita ricampionando ciascuna delle due serie e quindi eseguendo un'operazione matematica facendo riferimento alle variabili ricampionate.

*Campi:*
+ **Input**: la variabile dei dati delle serie temporali (RefID (ad esempio`A`)) da ricampionare
+ **Ricampionamento** a: la durata del ricampionamento, ad esempio `10s.` le unità possono essere `s` secondi, `m` minuti, `h` ore, giorni, `d` settimane e `w` anni. `y`
+ **Downsample**: la funzione di riduzione da utilizzare quando sono presenti più di un punto dati per campione di finestra. Vedi l'operazione di riduzione per i dettagli sul comportamento.
+ **Upsample**: il metodo da utilizzare per riempire un esempio di finestra senza punti dati.
  + il **pad** si riempie con l'ultimo valore conosciuto
  + **riempimento con il** successivo valore noto
  + **fillna** per riempire le finestre di esempio vuote con NaNs

## Scrivere un'espressione
<a name="v9-panels-query-write"></a>

Se la tua fonte di dati li supporta, Grafana visualizza il pulsante **Espressione** e mostra tutte le espressioni esistenti nell'elenco dell'editor di query.

**Per scrivere un'espressione**

1. Aprire il pannello.

1. Sotto l'interrogazione, scegliete **Espressione**.

1. Nel campo **Operazione**, seleziona il tipo di espressione che desideri scrivere.

1. Scrivi l'espressione.

1. Scegli **Applica**.

## Casi speciali
<a name="v9-panels-query-special"></a>

Quando un'origine dati interrogata non restituisce serie o numeri, viene restituito il motore di espressione. `NoData` Ad esempio, se una richiesta contiene due query sull'origine dati che vengono unite da un'espressione, se `NoData` viene restituita da almeno una delle query sull'origine dati, il risultato restituito per l'intera query è. `NoData` Per ulteriori informazioni su come Grafana Alerting elabora i `NoData` risultati, vedere. [Nessuna gestione di dati o casi di errore](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)

# Condividi i risultati delle query con un altro pannello
<a name="v9-panels-query-share"></a>

****  
**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 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)

Grafana ti consente di utilizzare il risultato della query di un pannello per qualsiasi altro pannello della dashboard. La condivisione dei risultati delle query tra i pannelli riduce il numero di interrogazioni fatte alla fonte di dati, il che può migliorare le prestazioni della dashboard.

L'origine dati della dashboard ti consente di selezionare un pannello nella dashboard che contiene le query per le quali desideri condividere i risultati. Invece di inviare una query separata per ogni pannello, Grafana invia una query e gli altri pannelli utilizzano i risultati dell'interrogazione per creare visualizzazioni.

Questa strategia può ridurre drasticamente il numero di interrogazioni effettuate quando, ad esempio, sono presenti più pannelli che visualizzano gli stessi dati.

**Per condividere i risultati delle interrogazioni**

1. [Crea una dashboard](v9-dash-creating.md).

1. Cambia il titolo in`Source panel`. Utilizzerai questo pannello come fonte per gli altri pannelli.

1. Definite la query o le domande che desiderate condividere.

   Se non disponi di un'origine dati disponibile, utilizza l'origine **TestData**dati, che restituisce una serie temporale casuale che puoi utilizzare per i test.

1. Aggiungi un secondo pannello e seleziona l'origine dati della **Dashboard** nell'editor di query.

1. Nell'**elenco Usa i risultati del pannello**, seleziona il primo pannello che hai creato.

Tutte le interrogazioni definite nel pannello sorgente sono ora disponibili nel nuovo pannello. Le interrogazioni effettuate nel pannello sorgente possono essere condivise con più pannelli.

È possibile fare clic su una qualsiasi delle interrogazioni per accedere al pannello in cui sono definite.

# Trasformazione dei dati
<a name="v9-panels-xform"></a>

****  
**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 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 trasformazioni sono un modo efficace per manipolare i dati restituiti da una query prima che il sistema applichi una visualizzazione. Utilizzando le trasformazioni, è possibile:
+ Rinominare i campi
+ Unisci i dati delle serie temporali
+ Esegui operazioni matematiche su più query
+ Usa l'output di una trasformazione come input per un'altra trasformazione

Per gli utenti che si affidano a più visualizzazioni dello stesso set di dati, le trasformazioni offrono un metodo efficiente per creare e gestire numerose dashboard.

È inoltre possibile utilizzare l'output di una trasformazione come input per un'altra trasformazione, il che si traduce in un aumento delle prestazioni.

**Nota**  
A volte il sistema non è in grado di rappresentare graficamente i dati trasformati. Quando ciò accade, fai clic sull'interruttore della **visualizzazione Tabella** sopra la visualizzazione per passare a una visualizzazione tabellare dei dati. Questo può aiutarti a comprendere il risultato finale delle tue trasformazioni.

## Tipi di trasformazione
<a name="v9-panels-xform-types"></a>

Grafana offre diversi modi per trasformare i dati. Di seguito è riportato un elenco completo delle funzioni di trasformazione.

## Ordine delle trasformazioni
<a name="v9-panels-xform-order"></a>

Quando sono presenti più trasformazioni, Grafana le applica nell'ordine in cui sono elencate. Ogni trasformazione crea un set di risultati che poi passa alla trasformazione successiva nella pipeline di elaborazione.

L'ordine in cui Grafana applica le trasformazioni influisce direttamente sui risultati. Ad esempio, se utilizzi una trasformazione Reduce per condensare tutti i risultati di una colonna in un unico valore, puoi applicare le trasformazioni solo a quel singolo valore.

## Aggiungi una funzione di trasformazione ai dati
<a name="v9-panels-xform-add"></a>

I seguenti passaggi ti guidano nell'aggiunta di una trasformazione ai dati.

**Per aggiungere una trasformazione a un pannello**

1. Vai al pannello in cui desideri aggiungere una o più trasformazioni.

1. Scegliete il titolo del pannello e fate clic su **Modifica**.

1. Seleziona la scheda **Transform** (Trasformazione).

1. Scegli una trasformazione. Viene visualizzata una riga di trasformazione in cui è possibile configurare le opzioni di trasformazione.

1. Per applicare un'altra trasformazione, scegli **Aggiungi trasformazione**. Questa trasformazione agisce sul set di risultati restituito dalla trasformazione precedente.

## Esegui il debug di una trasformazione
<a name="v9-panels-xform-debug"></a>

Per visualizzare i set di risultati in ingresso e in uscita della trasformazione, scegliete l'icona del bug sul lato destro della riga di trasformazione.

I set di risultati di input e output possono aiutarti a eseguire il debug di una trasformazione.

## Eliminare una trasformazione
<a name="v9-panels-xform-delete"></a>

Ti consigliamo di rimuovere le trasformazioni che non ti servono. Quando elimini una trasformazione, rimuovi i dati dalla visualizzazione.

Prerequisiti:

Identifica tutte le dashboard che si basano sulla trasformazione e informa gli utenti della dashboard interessati.

**Per eliminare una trasformazione**

1. Aprire un pannello per modificarlo.

1. Seleziona la scheda **Transform** (Trasformazione).

1. Scegli l'icona del cestino accanto alla trasformazione che desideri eliminare.

## Funzioni di trasformazione
<a name="v9-panels-xform-functions"></a>

È possibile eseguire le seguenti trasformazioni sui dati.

**Aggiungi campo dal calcolo**

Usa questa trasformazione per aggiungere un nuovo campo calcolato da altri due campi. Ogni trasformazione consente di aggiungere un nuovo campo.
+ **Modalità**: seleziona una modalità:
  + **Riduci riga**: applica il calcolo selezionato su ciascuna riga di campi selezionati in modo indipendente.
  + **Opzione binaria**: applica operazioni matematiche di base (somma, moltiplica, ecc.) sui valori in una singola riga da due campi selezionati.
+ **Nome campo**: seleziona i nomi dei campi che desideri utilizzare nel calcolo per il nuovo campo.
+ **Calcolo**: se si seleziona **la modalità Riduci righe**, viene visualizzato il campo **Calcolo**. Fai clic sul campo per visualizzare un elenco di scelte di calcolo che puoi utilizzare per creare il nuovo campo. Per informazioni sui calcoli disponibili, consulta [Tipi di calcolo](v9-panels-calculation-types.md).
+ **Operazione**: se si seleziona la modalità **opzione binaria**, vengono visualizzati i campi **Operazione**. Questi campi consentono di eseguire operazioni matematiche di base sui valori in un'unica riga da due campi selezionati. È inoltre possibile utilizzare valori numerici per operazioni binarie.
+ **Alias**: (Facoltativo) Inserisci il nome del nuovo campo. Se lasci questo campo vuoto, al campo verrà assegnato un nome corrispondente al calcolo.
+ **Sostituisci tutti i campi**: (Facoltativo) Seleziona questa opzione se desideri nascondere tutti gli altri campi e visualizzare solo il campo calcolato nella visualizzazione.

**Concatena i campi**

Questa trasformazione combina tutti i campi di tutti i frame in un unico risultato. Considerate queste due domande.

Interrogazione A:


| Temp | Tempo di operatività | 
| --- | --- | 
|  15.4  |  1230233  | 

Interrogazione B:


| AQI | Errori | 
| --- | --- | 
|  3.2  |  5  | 

Dopo aver concatenato i campi, il frame di dati sarebbe:


| Temp | Operatività | AQI | Errori | 
| --- | --- | --- | --- | 
|  15,4  |  1230233  |  3.2  |  5  | 

**Config dai risultati della query**

Questa trasformazione consente di selezionare una query e da essa estrarre opzioni standard come **Min**, **Max**, **Unit** e **Thresholds** e applicarle ad altri risultati della query. Ciò consente una configurazione dinamica della visualizzazione basata sulle query.

Se desideri estrarre una configurazione unica per ogni riga del risultato della query di configurazione, prova la trasformazione da righe a campi.

**Opzioni**
+ **Interrogazione di configurazione**: seleziona la query che restituisce i dati che desideri utilizzare come configurazione.
+ **Applica a**: seleziona i campi o le serie a cui applicare la configurazione.
+ **Applica alle opzioni**: in genere un tipo di campo o un'espressione regolare del nome di campo a seconda dell'opzione selezionata in **Applica a**.

**Converti il tipo di campo**

Questa trasformazione modifica il tipo di campo del campo specificato.
+ **Campo**: seleziona uno dei campi disponibili
+ **as**: seleziona il formato FieldType in cui convertire
  + **Numerico**: tenta di rendere numerici i valori
  + **Stringa**: renderà i valori stringhe
  + **Ora**: tenta di analizzare i valori come tempo
    + Mostrerà un'opzione per specificare un DateFormat come input da una stringa come yyyy-mm-dd o DD MM YYYY hh:mm:ss
  + **Booleano: renderà i valori booleani**

Ad esempio, è possibile modificare la seguente query selezionando il campo orario come Ora e il formato della data come YYYY.


| Orario | Segna | Valore | 
| --- | --- | --- | 
|  01/07/2017  |  sopra  |  25  | 
|  02/08/2018  |  sotto  |  22  | 
|  02/09/2019  |  sotto  |  29  | 
|  04/10/2020  |  sopra  |  22  | 

Il risultato:


| Orario | Mark | Valore | 
| --- | --- | --- | 
|  1/1/2017  |  sopra  |  25  | 
|  1/1/2018  |  sotto  |  22  | 
|  1/1/2019  |  sotto  |  29  | 
|  1/1/2020  |  sopra  |  22  | 

**Filtra i dati per nome**

Utilizzate questa trasformazione per rimuovere parti dei risultati della query.

Grafana visualizza il campo **Identificatore**, seguito dai campi restituiti dalla query.

Puoi applicare i filtri in due modi:
+ Immettere un'espressione regex.
+ Scegli un campo per attivare il filtro su quel campo. I campi filtrati vengono visualizzati con testo grigio scuro, i campi non filtrati hanno testo bianco.

**Filtra i dati per query**

Utilizzate questa trasformazione nei pannelli che hanno più interrogazioni, se volete nascondere una o più interrogazioni.

Grafana visualizza le lettere di identificazione della query in testo grigio scuro. Fai clic su un identificatore di query per attivare il filtro. Se la lettera di interrogazione è bianca, vengono visualizzati i risultati. Se la lettera di interrogazione è scura, i risultati vengono nascosti.

**Nota**  
Questa trasformazione non è disponibile per Graphite perché questa fonte di dati non supporta la correlazione dei dati restituiti con le query.

**Filtra i dati per valore**

Questa trasformazione consente di filtrare i dati direttamente in Grafana e rimuovere alcuni punti dati dai risultati della query. Hai la possibilità di includere o escludere i dati che soddisfano una o più condizioni da te definite. Le condizioni vengono applicate a un campo selezionato.

Questa trasformazione è utile se l'origine dati non filtra nativamente in base ai valori. È inoltre possibile utilizzarla per restringere i valori da visualizzare se si utilizza una query condivisa.

Le condizioni disponibili per tutti i campi sono:
+ **Regex**: corrisponde a un'espressione regex
+ **Is Null**: corrisponde se il valore è nullo
+ **Is Not Null**: corrisponde se il valore non è nullo
+ **Uguale**: corrisponde se il valore è uguale al valore specificato
+ **Diverso**: corrisponde se il valore è diverso dal valore specificato

Le condizioni disponibili per i campi numerici sono:
+ **Maggiore**: corrisponde se il valore è maggiore del valore specificato
+ **Inferiore**: corrisponde se il valore è inferiore al valore specificato
+ **Maggiore o uguale**: corrisponde se il valore è maggiore o uguale
+ **Minore o uguale**: corrisponde se il valore è inferiore o uguale
+ **Intervallo**: corrisponde a un intervallo compreso tra un minimo e un massimo specificati, inclusi il minimo e il massimo

Considerate il seguente set di dati:


| Orario | Temperatura | Altitude (Altitudine) | 
| --- | --- | --- | 
|  07/07/2020 11:34:23  |  32  |  101  | 
|  07/07/2020 11:34:22  |  28  |  125  | 
|  07/07/2020 11:34:21  |  26  |  110  | 
|  07/07/2020 11:34:20  |  23  |  98  | 
|  07/07/2020 10:32:24  |  31  |  95  | 
|  07/07/2020 10:31:22  |  20  |  85  | 
|  07/07/2020 9:30:57  |  19  |  101  | 

Se **includi** i punti dati con una temperatura inferiore a 30°C, la configurazione sarà la seguente:
+ **Tipo di filtro:** `Include`
+ **Condizione**: righe in cui `Temperature` corrispondono `Lower Than 30`

E otterrete il seguente risultato, in cui sono incluse solo le temperature inferiori a 30°C:


| Orario | Temperatura | Altitude (Altitudine) | 
| --- | --- | --- | 
|  07/07/2020 11:34:22  |  28  |  125  | 
|  07/07/2020 11:34:21  |  26  |  110  | 
|  07/07/2020 11:34:20  |  23  |  98  | 
|  07/07/2020 10:31:22  |  20  |  85  | 
|  07/07/2020 9:30:57  |  19  |  101  | 

Puoi aggiungere più di una condizione al filtro. Ad esempio, potresti voler includere i dati solo se l'altitudine è maggiore di 100. A tale scopo, aggiungi tale condizione alla seguente configurazione:
+ Tipo di filtro: `Include` righe che `Match All` condizionano
+ Condizione 1: righe in cui `Temperature` corrisponde `Lower` a `30`
+ Condizione 2 - Righe in cui `Altitude` corrisponde `Greater` a `100`

Quando hai più di una condizione, puoi scegliere se desideri che l'azione (includi/escludi) venga applicata alle righe che **soddisfano tutte le** condizioni o **soddisfano** una delle condizioni che hai aggiunto.

Nell'esempio precedente abbiamo scelto **Abbina tutto** perché volevamo includere le righe che hanno una temperatura inferiore a 30 E un'altitudine superiore a 100. Se volessimo invece includere le righe che hanno una temperatura inferiore a 30 O un'altitudine superiore a 100, selezioneremmo **Match any**. Ciò includerebbe la prima riga dei dati originali, che ha una temperatura di 32°C (non corrisponde alla prima condizione) ma un'altitudine di 101 (che corrisponde alla seconda condizione), quindi è inclusa.

Le condizioni non valide o configurate in modo incompleto vengono ignorate.

**Gruppo da**

Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. Fai clic per visualizzare un elenco di scelte di calcolo.

Ecco un esempio di dati originali.


| Orario | ID del server | Temperatura della CPU | Stato del server | 
| --- | --- | --- | --- | 
|  07/07/2020 11:34:20AM  |  server 1  |  80  |  Arresto  | 
|  07/07/2020 11:34:20  |  server 3  |  62  |  OK  | 
|  07/07/2020 10:32:20  |  server 2  |  90  |  Sovraccarico  | 
|  07/07/2020 10:31:22  |  server 3  |  55  |  OK  | 
|  07/07/2020 9:30:57  |  server 3  |  62  |  Reebooting (Riavvio in corso)  | 
|  07/07/2020 9:30:05  |  server 2  |  88  |  OK  | 
|  07/07/2020 09:28:06  |  server 1  |  80  |  OK  | 
|  07/07/2020 09:25:05  |  server 2  |  88  |  OK  | 
|  07/07/2020 09:23:07  |  server 1  |  86  |  OK  | 

Questa trasformazione avviene in due fasi. Per prima cosa specificate uno o più campi in base ai quali raggruppare i dati. In questo modo verranno raggruppati tutti gli stessi valori di quei campi, come se li avessi ordinati. Ad esempio, se raggruppiamo i dati in base al campo Server ID, i dati verranno raggruppati in questo modo:


| Orario | ID del server | Temperatura della CPU | Stato del server | 
| --- | --- | --- | --- | 
|  07/07/2020 11:34:20AM  |  server 1  |  80  |  Arresto  | 
|  07/07/2020 09:28:06  |  server 1  |  80  |  OK  | 
|  07/07/2020 09:23:07  |  server 1  |  86  |  OK  | 
|  07/07/2020 10:32:20  |  server 2  |  90  |  Sovraccarico  | 
|  07/07/2020 9:30:05  |  server 2  |  88  |  OK  | 
|  07/07/2020 09:25:05  |  server 2  |  88  |  OK  | 
|  07/07/2020 11:34:20  |  server 3  |  62  |  OK  | 
|  07/07/2020 10:31:22  |  server 3  |  55  |  OK  | 
|  07/07/2020 9:30:57  |  server 3  |  62  |  Reebooting (Riavvio in corso)  | 

Tutte le righe con lo stesso valore di Server ID vengono raggruppate.

Dopo aver scelto il campo in base al quale raggruppare i dati, puoi aggiungere vari calcoli sugli altri campi e applicare il calcolo a ciascun gruppo di righe. Ad esempio, potremmo voler calcolare la temperatura media della CPU per ciascuno di questi server. Quindi possiamo aggiungere il calcolo *medio* applicato al campo della temperatura della CPU per ottenere quanto segue:


| ID del server | Temperatura della CPU (media) | 
| --- | --- | 
|  server 1  |  82  | 
|  server 2  |  8.6  | 
|  server 3  |  59,6  | 

E possiamo aggiungere più di un calcolo. Per esempio:
+ Per il campo Time, possiamo calcolare l'*ultimo* valore, per sapere quando è stato ricevuto l'ultimo punto dati per ogni server
+ Per il campo Server Status, possiamo calcolare il valore *Last* per sapere qual è l'ultimo valore di stato per ogni server
+ Per il campo Temperature, possiamo anche calcolare l'*ultimo* valore per sapere qual è l'ultima temperatura monitorata per ogni server

Otterremmo quindi:


| ID del server | Temperatura della CPU (media) | Temperatura della CPU (ultima) | Ora (ultima) | Stato del server (ultimo) | 
| --- | --- | --- | --- | --- | 
|  server 1  |  82  |  80  |  07/07/2020 11:34:20  |  Arresto  | 
|  server 2  |  8.6  |  90  |  07/07/2020 10:32:20  |  Sovraccarico  | 
|  server 3  |  59,6  |  62  |  07/07/2020 11:34:20  |  OK  | 

Questa trasformazione consente di estrarre le informazioni chiave dalle serie temporali e di visualizzarle in modo conveniente.

**Partecipa per campo**

Usa questa trasformazione per unire più risultati in un'unica tabella. Ciò è particolarmente utile per convertire i risultati di più serie temporali in un'unica tabella ampia con un campo temporale condiviso.

*Connessione interna*

Un inner join unisce i dati di più tabelle in cui tutte le tabelle condividono lo stesso valore del campo selezionato. Questo tipo di join esclude i dati in cui i valori non corrispondono in tutti i risultati.

Utilizzate questa trasformazione per combinare i risultati di più query (combinati su un campo di join passato o sulla prima colonna time) in un unico risultato e rilasciate le righe in cui un'unione non può avvenire con successo.

Nell'esempio seguente, due query restituiscono i dati della tabella. Viene visualizzato come due tabelle separate prima di applicare la trasformazione Inner Join.

Interrogazione A:


| Orario | Processo | Tempo di operatività | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  nodo  |  25260122  | 
|  07/07/2020 11:24:20  |  locandina  |  123001233  | 
|  07/07/2020 11:14:20  |  locandina  |  345001233  | 

Interrogazione B:


| Orario | Server | Errori | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  server 1  |  15  | 
|  07/07/2020 11:24:20  |  server 2  |  5  | 
|  07/07/2020 11:04:20  |  server 3  |  10  | 

Il risultato dopo l'applicazione della trasformazione inner join è simile al seguente:


| Orario | Processo | Operatività | Server | Errori | 
| --- | --- | --- | --- | --- | 
|  07/07/2020 11:34:20  |  nodo  |  25260122  |  server 1  |  15  | 
|  07/07/2020 11:24:20  |  locandina  |  123001233  |  server 2  |  5  | 

*Giunto esterno*

Un outer join include tutti i dati di un inner join e le righe in cui i valori non corrispondono in tutti gli input. Mentre l'inner join unisce la Query A e la Query B nel campo temporale, l'outer join include tutte le righe che non corrispondono nel campo time.

Nell'esempio seguente, due query restituiscono i dati della tabella. Viene visualizzato come due tabelle prima di applicare la trasformazione outer join.

Interrogazione A:


| Orario | Processo | Tempo di operatività | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  nodo  |  25260122  | 
|  07/07/2020 11:24:20  |  locandina  |  123001233  | 
|  07/07/2020 11:14:20  |  locandina  |  345001233  | 

Interrogazione B:


| Orario | Server | Errori | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  server 1  |  15  | 
|  07/07/2020 11:24:20  |  server 2  |  5  | 
|  07/07/2020 11:04:20  |  server 3  |  10  | 

Il risultato dopo l'applicazione della trasformazione outer join è simile al seguente:


| Orario | Processo | Operatività | Server | Errori | 
| --- | --- | --- | --- | --- | 
|  07/07/2020 11:04:20  |    |    |  server 3  |  10  | 
|  07/07/2020 11:14:20  |  locandina  |  345001233  |    |    | 
|  07/07/2020 11:34:20  |  nodo  |  25260122  |  server 1  |  15  | 
|  07/07/2020 11:24:20  |  locandina  |  123001233  |  server 2  |  5  | 

**Etichette per i campi**

Questa trasformazione modifica i risultati delle serie temporali che includono etichette o tag in una tabella in cui le chiavi e i valori di ogni etichetta sono inclusi nel risultato della tabella. Le etichette possono essere visualizzate come colonne o come valori di riga.

Dato il risultato di una query di due serie temporali:
+ Serie 1: etichette Server=Server A, Datacenter=EU
+ Serie 2 — etichette Server=Server B, Datacenter=EU

In modalità **Columns**, il risultato è simile al seguente:


| Orario | Server | Datacenter | Valore | 
| --- | --- | --- | --- | 
|  07/07/2020 11:34:20  |  Server A  |  UE  |  1  | 
|  07/07/2020 11:34:20  |  Server B  |  UE  |  2  | 

In modalità «Righe», il risultato ha una tabella per ogni serie e mostra il valore di ogni etichetta in questo modo:


| etichetta | value | 
| --- | --- | 
|  Server  |  Server A  | 
|  Datacenter  |  UE  | 


| etichetta | value | 
| --- | --- | 
|  Server  |  Server B  | 
|  Datacenter  |  UE  | 

*Nome del campo Valore*

Se hai selezionato Server come **nome del campo Valore**, otterrai un campo per ogni valore dell'etichetta Server.


| Orario | Datacenter | Server A | Server B | 
| --- | --- | --- | --- | 
|  07/07/2020 11:34:20  |  UE  |  1  |  2  | 

*Comportamento di fusione*

Il trasformatore delle etichette per i campi è composto internamente da due trasformazioni separate. Il primo agisce su una singola serie ed estrae le etichette nei campi. La seconda è la trasformazione di fusione che unisce tutti i risultati in un'unica tabella. La trasformazione di unione tenta di unire tutti i campi corrispondenti. Questa fase di unione è obbligatoria e non può essere disattivata. 

**Nota**  
La trasformazione di *fusione* può essere utilizzata da sola ed è descritta in dettaglio di seguito.

Per illustrare ciò, ecco un esempio in cui sono presenti due query che restituiscono serie temporali senza etichette sovrapposte.
+ Serie 1 — labels server=Servera
+ Serie 2 — labels datacenter=EU

Ciò risulterà innanzitutto in queste due tabelle:


| Orario | Server | Valore | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  Servire A  |  10  | 


| Orario | Datacenter | Valore | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  UE  |  20  | 

Dopo l'unione:


| Orario | Server | Valore | Datacenter | 
| --- | --- | --- | --- | 
|  07/07/2020 11:34:20  |  Servire A  |  10  |    | 
|  07/07/2020 11:34:20  |    |  20  |  UE  | 

**Unione**

Utilizzate questa trasformazione per combinare il risultato di più interrogazioni in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare. I valori che possono essere uniti vengono combinati nella stessa riga. I valori sono unibili se i campi condivisi contengono gli stessi dati.

Nell'esempio seguente, abbiamo due query che restituiscono i dati della tabella. Viene visualizzato come due tabelle separate prima di applicare la trasformazione.

Interrogazione A:


| Orario | Processo | Tempo di operatività | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  nodo  |  25260122  | 
|  07/07/2020 11:24:20  |  locandina  |  123001233  | 

Interrogazione B:


| Orario | Processo | Errori | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  nodo  |  15  | 
|  07/07/2020 11:24:20  |  locandina  |  5  | 

Ecco il risultato dopo aver applicato la trasformazione Merge:


| Orario | Processo | Errori | Operatività | 
| --- | --- | --- | --- | 
|  07/07/2020 11:34:20  |  nodo  |  15  |  25260122  | 
|  07/07/2020 11:24:20  |  locandina  |  5  |  123001233  | 

**Organizza i campi**

Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti dalla query.

**Nota**  
Questa trasformazione funziona solo nei pannelli con una singola interrogazione. Se il pannello ha più interrogazioni, è necessario applicare una trasformazione Outer join o rimuovere le interrogazioni aggiuntive.

Grafana mostra un elenco di campi restituiti dalla query. Puoi:
+ Modifica l'ordine dei campi posizionando il cursore su un campo. Il cursore si trasforma in una mano e quindi puoi trascinare il campo nella nuova posizione.
+ Nascondi o mostra un campo facendo clic sull'icona a forma di occhio accanto al nome del campo.
+ Rinomina i campi digitando un nuovo nome nella casella Rinomina.

**Partizione per valori**

Questa trasformazione può aiutare a eliminare la necessità di più query sulla stessa origine dati con `WHERE` clausole diverse quando si rappresentano graficamente più serie. Prendi in considerazione una tabella SQL di metriche con i seguenti dati:


| Orario | Region | Valore | 
| --- | --- | --- | 
|  20/10/2022 12:00:00  |  US  |  1520  | 
|  20/10/2022 12:00:00  |  UE  |  2936  | 
|  20/10/2022 1:00:00  |  US  |  1327  | 
|  20/10/2022 1:00:00  |  UE  |  912  | 

Prima della versione 9.3, se volevi tracciare una linea di tendenza rossa per gli Stati Uniti e una blu per l'UE nello stesso TimeSeries pannello, probabilmente dovevi suddividerla in due domande:

```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```

Ciò richiede anche che tu sappia in anticipo quali regioni esistono effettivamente nella tabella delle metriche.

Con il trasformatore *Partition by values*, ora puoi emettere una singola query e dividere i risultati per valori univoci in una o più colonne (`fields`) a tua scelta. Nell'esempio seguente viene utilizzato `Region`.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Orario | Region | Valore | 
| --- | --- | --- | 
|  20/10/2022 12:00:00  |  US  |  1520  | 
|  20/10/2022 1:00:00  |  US  |  1327  | 


| Orario | Region | Valore | 
| --- | --- | --- | 
|  20/10/2022 12:00:00  |  UE  |  2936  | 
|  20/10/2022 1:00:00  |  UE  |  912  | 

**Ridurre**

La trasformazione *Reduce* applica un calcolo a ogni campo del frame e restituisce un singolo valore. I campi relativi all'ora vengono rimossi quando si applica questa trasformazione.

Considerate l'input:

Interrogazione A:


| Orario | Temp | Tempo di operatività | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  12.3  |  256122  | 
|  07/07/2020 11:24:20  |  15,4  |  1230233  | 

Interrogazione B:


| Orario | AQI | Errori | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  6,5  |  15  | 
|  07/07/2020 11:24:20  |  3.2  |  5  | 

Il trasformatore di riduzione ha due modalità:
+ **Da serie a righe**: crea una riga per ogni campo e una colonna per ogni calcolo.
+ **Riduci campi**: mantiene la struttura del frame esistente, ma comprime ogni campo in un unico valore.

Ad esempio, se hai utilizzato il **primo** e **l'ultimo** calcolo con una trasformazione **da serie a righe**, il risultato sarebbe:


| Campo | Primo | Ultimo | 
| --- | --- | --- | 
|  Temp  |  12.3  |  15.4  | 
|  Operatività  |  256122  |  1230233  | 
|  AQI  |  6,5  |  3.2  | 
|  Errori  |  15  |  5  | 

I campi Riduci con l'ultimo calcolo restituiscono due frame, ciascuno con una riga:

Interrogazione A:


| Temp | Tempo di operatività | 
| --- | --- | 
|  15.4  |  1230233  | 

Interrogazione B:


| AQI | Errori | 
| --- | --- | 
|  3.2  |  5  | 

**Rinomina tramite regex**

Utilizzate questa trasformazione per rinominare parti dei risultati della query utilizzando un'espressione regolare e un pattern sostitutivo.

È possibile specificare un'espressione regolare, che viene applicata solo alle corrispondenze, insieme a un pattern sostitutivo che supporti i riferimenti a ritroso. Ad esempio, immaginiamo di visualizzare l'utilizzo della CPU per host e di voler rimuovere il nome di dominio. È possibile impostare l'espressione regolare su `([^\.]+)\..+` e il pattern sostitutivo su`$1`, `web-01.example.com` diventerebbe. `web-01`

**Da righe a campi**

La trasformazione da righe a campi converte le righe in campi separati. Ciò può essere utile in quanto i campi possono essere modificati e configurati individualmente. Può anche utilizzare campi aggiuntivi come fonti per la configurazione dinamica dei campi o mapparli alle etichette dei campi. Le etichette aggiuntive possono quindi essere utilizzate per definire nomi di visualizzazione migliori per i campi risultanti.

Questa trasformazione include una tabella di campi che elenca tutti i campi nei dati restituiti dalla query di configurazione. Questa tabella consente di controllare quale campo deve essere mappato a ciascuna proprietà di configurazione (l'opzione\$1Usa come\$1\$1). Puoi anche scegliere quale valore selezionare se ci sono più righe nei dati restituiti.

Questa trasformazione richiede:
+ Un campo da usare come origine dei nomi dei campi.

  Per impostazione predefinita, la trasformazione utilizza il primo campo stringa come origine. Puoi sovrascrivere questa impostazione predefinita selezionando **Nome campo** nella colonna **Usa come** per il campo che desideri utilizzare al suo posto.
+ Un campo da usare come fonte di valori.

  Per impostazione predefinita, la trasformazione utilizza il primo campo numerico come origine. Tuttavia, puoi ignorare questa impostazione predefinita selezionando **Valore del campo** nella colonna **Usa come** per il campo che desideri utilizzare al suo posto.

Utile per visualizzare i dati in:
+ Gauge
+ Stat
+ Grafico a torta

*Associa campi aggiuntivi alle etichette*

Se un campo non è mappato alla proprietà di configurazione, Grafana lo utilizzerà automaticamente come sorgente per un'etichetta sul campo di output-

Esempio:


| Name | DataCenter | Valore | 
| --- | --- | --- | 
|  ServerA  |  US  |  100  | 
|  Server B  |  UE  |  200  | 

Output:


| ServerA (etichette DataCenter: US) | ServerB (etichette DataCenter: EU) | 
| --- | --- | 
|  10  |  20  | 

Le etichette aggiuntive possono ora essere utilizzate nel campo Nome visualizzato per fornire nomi di campo più completi.

Se vuoi estrarre la configurazione da una query e applicarla a un'altra, dovresti usare la configurazione dalla trasformazione dei risultati della query.

*Esempio*

Input:


| Name | Valore | Max | 
| --- | --- | --- | 
|  ServerA  |  10  |  100  | 
|  Server B  |  20  |  200  | 
|  Server C  |  30  |  300  | 

Output:


| ServerA (configurazione: max=100) | ServerB (configurazione: max=200) | ServerC (configurazione: max=300) | 
| --- | --- | --- | 
|  10  |  20  |  30  | 

Come puoi vedere, ogni riga dei dati di origine diventa un campo separato. Ogni campo ora ha anche un set di opzioni di configurazione massimo. Opzioni come Min, Max, Unit e Thresholds fanno tutte parte della configurazione del campo e, se impostate in questo modo, verranno utilizzate dalla visualizzazione al posto delle opzioni configurate manualmente nel riquadro delle opzioni dell'editor del pannello.

**Prepara le serie temporali**

La preparazione della trasformazione delle serie temporali è utile quando un'origine dati restituisce dati di serie temporali in un formato non supportato dal pannello che si desidera utilizzare.

Questa trasformazione consente di risolvere questo problema convertendo i dati delle serie temporali dal formato ampio al formato lungo o viceversa.

Seleziona l'opzione **Serie temporale a più fotogrammi** per trasformare l'intervallo di dati delle serie temporali dal formato ampio a quello lungo.

Seleziona l'opzione **Wide time series** per trasformare il frame di dati delle serie temporali dal formato lungo a quello ampio.

**Da serie a righe**

Utilizzate questa trasformazione per combinare il risultato di più interrogazioni di dati su serie temporali in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare.

Il risultato di questa trasformazione conterrà tre colonne: Time, Metric e Value. La colonna Metrica viene aggiunta in modo da poter vedere facilmente da quale query proviene la metrica. Personalizza questo valore definendo Label nella query di origine.

Nell'esempio seguente, abbiamo due query che restituiscono dati di serie temporali. Viene visualizzato come due tabelle separate prima di applicare la trasformazione.

Interrogazione A:


| Orario | Temperatura | 
| --- | --- | 
|  07/07/2020 11:34:20  |  25  | 
|  07/07/2020 10:31:22  |  22  | 
|  07/07/2020 9:30:05  |  19  | 

Interrogazione B:


| Orario | Umidità | 
| --- | --- | 
|  07/07/2020 11:34:20AM  |  24  | 
|  07/07/2020 10:32:20  |  29  | 
|  07/07/2020 9:30:57  |  33  | 

Ecco il risultato dopo aver applicato la trasformazione Series to rows.


| Orario | Metrica | Valore | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  Temperatura  |  25  | 
|  07/07/2020 11:34:20  |  Umidità  |  22  | 
|  07/07/2020 10:32:20AM  |  Umidità  |  29  | 
|  07/07/2020 10:31:22  |  Temperatura  |  22  | 
|  07/07/2020 9:30:57  |  Umidità  |  33  | 
|  07/07/2020 09:30:05  |  Temperatura  |  19  | 

**Ordina per**

Questa trasformazione ordinerà ogni frame in base al campo configurato. Quando `reverse` è selezionata, i valori verranno restituiti nell'ordine inverso.

**Limite**

Utilizzate questa trasformazione per limitare il numero di righe visualizzate.

Nell'esempio seguente, abbiamo la seguente risposta dalla fonte di dati:


| Orario | Metrica | Valore | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  Temperatura  |  25  | 
|  07/07/2020 11:34:20  |  Umidità  |  22  | 
|  07/07/2020 10:32:20AM  |  Umidità  |  29  | 
|  07/07/2020 10:31:22  |  Temperatura  |  22  | 
|  07/07/2020 9:30:57  |  Umidità  |  33  | 
|  07/07/2020 09:30:05  |  Temperatura  |  19  | 

Ecco il risultato dopo aver aggiunto una trasformazione Limit con un valore di '3':


| Orario | Metrica | Valore | 
| --- | --- | --- | 
|  07/07/2020 11:34:20  |  Temperatura  |  25  | 
|  07/07/2020 11:34:20  |  Umidità  |  22  | 
|  07/07/2020 10:32:20AM  |  Umidità  |  29  | 

# Risolvi i problemi relativi alle interrogazioni
<a name="v9-panels-query-troubleshoot"></a>

****  
**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 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)

Questa pagina fornisce informazioni per risolvere i problemi più comuni del pannello di controllo.

**Ottengo risultati diversi quando riorganizzo le mie funzioni**

L'ordine delle funzioni è molto importante. Proprio come in matematica, l'ordine in cui vengono posizionate le funzioni può influire sul risultato.

**Esamina la richiesta e la risposta alla tua domanda**

I problemi più comuni riguardano l'interrogazione e la risposta provenienti dalla fonte dei dati. Anche se sembra un bug o un problema di visualizzazione in Grafana, è quasi sempre un problema con la query sulla fonte dei dati o la risposta della fonte dei dati. Inizia esaminando la domanda e la risposta del pannello.

Per ulteriori informazioni, consulta [Ispeziona i dati di richiesta e risposta](v9-panels-panel-inspector.md).

**La mia richiesta è lenta**

Quanti punti dati restituisce la tua query? Una query che restituisce molti punti dati sarà lenta. Prova questo:
+ Nelle **opzioni di query**, limita il **numero massimo di punti dati** restituiti.
+ Nelle **opzioni di interrogazione**, aumentate il tempo **di intervallo minimo**.
+ Nella tua interrogazione, usa una `group by` funzione.

# Configurare le soglie
<a name="v9-panels-configure-thresholds"></a>

****  
**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 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)

 Questa sezione include informazioni sull'utilizzo delle soglie nelle visualizzazioni. Imparerai a conoscere le soglie e i relativi valori predefiniti, come aggiungere o eliminare una soglia e come aggiungere una soglia a un pannello precedente. 

## Informazioni sulle soglie
<a name="v9-panels-thresholds-about"></a>

 Una soglia è un valore specificato per una metrica che viene riflessa visivamente in una dashboard quando il valore di soglia viene raggiunto o superato. 

 Le soglie forniscono un metodo per applicare stili e colori condizionali alle visualizzazioni in base ai risultati delle query. È possibile applicare soglie alla maggior parte delle visualizzazioni, ma non a tutte. [Per ulteriori informazioni sulle visualizzazioni, consulta i pannelli di visualizzazione.](v9-panels.md)

 È possibile utilizzare le soglie per: 
+  [Le linee della griglia a colori o le aree della griglia nella visualizzazione delle serie temporali](v9-panels-time-series.md) 
+  [Linee di colore nella visualizzazione delle serie temporali](v9-panels-time-series.md) 
+  [Colora lo sfondo o il testo del valore nella visualizzazione Stat](v9-panels-stat.md) 
+  [Colora l'indicatore e gli indicatori di soglia nella visualizzazione Gauge](v9-panels-gauge.md) 
+  [Marcatori a colori nella visualizzazione Geomap](v9-panels-geomap.md) 
+  [Colora il testo o lo sfondo della cella nella visualizzazione Tabella](v9-panels-table.md) 
+  Definisci le regioni e i colori delle regioni nella visualizzazione della [cronologia dello stato](v9-panels-state-timeline.md) 

 Esistono due tipi di soglie: 
+  Le soglie **assolute** sono definite da un numero. Ad esempio, 80 su una scala da 1 a 150. 
+  Le soglie **percentuali** sono definite rispetto al minimo o al massimo. Ad esempio, l'80 percento. 

### Soglie predefinite
<a name="v9-panels-thresholds-default"></a>

 Nelle visualizzazioni che lo supportano, Grafana imposta i valori di soglia predefiniti di: 
+  80 = rosso 
+  Base = verde 
+  Modalità = Assoluta 

 Il valore **base** rappresenta l'infinito negativo. In genere è il colore «buono». 

## Aggiungere o eliminare una soglia
<a name="v9-panels-thresholds-add-delete"></a>

 Puoi aggiungere tutte le soglie che desideri a un pannello. Grafana ordina automaticamente i valori delle soglie dal più alto al più basso. 

 Eliminate una soglia quando non è più rilevante per le vostre operazioni aziendali. Quando si elimina una soglia, il sistema rimuove la soglia da tutte le visualizzazioni che includono la soglia. 

1.  Per aggiungere una soglia: 

   1.  Modifica il pannello a cui desideri aggiungere una soglia. 

   1.  Nel riquadro laterale delle opzioni, individua la sezione **Soglie** e fai clic su **\$1 Aggiungi** soglia. 

   1.  Seleziona un colore, un numero e una modalità di soglia. La modalità Soglia si applica a tutte le soglie di questo pannello. 

   1.  Per un pannello con serie temporali, selezionate l'opzione **Mostra** soglie. 

1.  Per eliminare una soglia, accedi al pannello che contiene la soglia e fai clic sull'icona del cestino accanto alla soglia che desideri rimuovere. 

## Aggiungi una soglia a un pannello grafico precedente
<a name="v9-panels-thresholds-legacy-graph"></a>

 Nella visualizzazione del pannello Grafico, le soglie consentono di aggiungere linee o sezioni a un grafico per facilitare il riconoscimento quando il grafico supera una soglia. 

1.  Passate al pannello grafico a cui desiderate aggiungere una soglia. 

1.  Nella scheda **Pannello**, fate clic su **Soglie**. 

1.  Fate clic su **Aggiungi soglia**. 

1.  Completare i seguenti campi: 
   +  **T1 -** Entrambi i valori sono necessari per visualizzare una soglia. 
     +  **lt** o **gt**: seleziona **lt** per meno di o **gt** per maggiore di per indicare a cosa si applica la soglia. 
     +  **Valore:** immettere un valore di soglia. Grafana traccia una linea di soglia lungo l'asse Y a quel valore. 
   +  **Colore:** scegli una condizione che corrisponda a un colore o definisci il tuo colore. 
     +  **personalizzato:** definisci il colore di riempimento e il colore della linea. 
     +  **critico -** Il colore del riempimento e della linea sono rossi. 
     +  **avviso -** I colori di riempimento e linea sono gialli. 
     +  **ok -** I colori di riempimento e linea sono verdi. 
   +  **Riempimento:** controlla se viene visualizzato il riempimento della soglia. 
   +  **Linea:** controlla se viene visualizzata la linea di soglia. 
   +  **Asse Y:** scegli **sinistra** o **destra**. 

1.  Fai clic su **Salva** per salvare le modifiche nella dashboard. 

# Configurare i collegamenti dati
<a name="v9-panels-configure-data-links"></a>

****  
**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 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)

 È possibile utilizzare variabili di collegamento dati o collegamenti dati per creare collegamenti tra i pannelli. 

## Variabili di collegamento dati
<a name="v9-panels-data-link-variables"></a>

 È possibile utilizzare le variabili nei collegamenti dati per fare riferimento a campi, etichette e valori delle serie. Per ulteriori informazioni sui collegamenti dati, consulta[Collegamenti dati](#v9-panels-data-links).

 Per visualizzare un elenco di variabili disponibili, digita **\$1** nel campo **URL del** collegamento dati per visualizzare un elenco di variabili che puoi utilizzare. 

**Nota**  
 Queste variabili sono cambiate nella versione 6.4, quindi se hai una versione precedente di Grafana, usa il selettore di versione per selezionare i documenti per una versione precedente di Grafana. 

 Puoi anche usare variabili modello nei tuoi link dati, vedi. URLs [Aggiungere e gestire le variabili del dashboard](v9-dash-variables.md)

## Variabili del pannello dell'intervallo di tempo
<a name="v9-panels-time-range-panel-variables"></a>

 Queste variabili consentono di includere l'intervallo di tempo corrente nell'URL del collegamento dati. 
+  **\$1\$1url\$1time\$1range - intervallo di** **tempo della dashboard corrente (ad es.? da=ora-6h&a=adesso**) 
+  \$1\$1\$1from e **\$1\$1\$1to** - Per ulteriori informazioni, vedi. [Variabili globali](v9-dash-variable-add.md#v9-dash-variable-add-global)

## Variabili di serie
<a name="v9-panels-series-variables"></a>

 Le variabili specifiche della serie sono disponibili nello spazio dei nomi **\$1\$1series**: 
+  **\$1\$1series.name** - nome della serie all'URL 

## Variabili di campo
<a name="v9-panels-field-variables"></a>

 Le variabili specifiche del campo sono disponibili nello spazio dei nomi **\$1\$1field**: 
+  **\$1\$1field.name: il nome del campo** 
+  **\$1\$1field.labels. **<LABEL>- il valore dell'etichetta rispetto all'URL. <LABEL>Se l'etichetta contiene punti, usa la sintassi **\$1\$1field.labels [» «].** 

## Variabili di valore
<a name="v9-panels-value-variables"></a>

 Le variabili specifiche del valore sono disponibili nello spazio dei nomi **\$1\$1value**: 
+  **\$1\$1value.time** **- il timestamp del valore (epoca Unix ms) rispetto all'URL (ad es.? time=1560268814105**) 
+  **\$1\$1value.raw - valore grezzo** 
+  **\$1\$1value.numeric - rappresentazione numerica** di un valore 
+  **\$1\$1value.text - rappresentazione testuale di un valore** 
+  **\$1\$1value.calc** - nome del calcolo se il valore è il risultato del calcolo 

## Variabili del modello
<a name="v9-panels-template-variables"></a>

 Quando ti colleghi a un'altra dashboard che utilizza variabili modello, seleziona i valori delle variabili per chiunque faccia clic sul link. 

 **\$1 \$1var-myvar:queryparam\$1** - dove **var-myvar** è il nome della variabile modello che corrisponde a quella nella dashboard corrente che desideri utilizzare. 


|  Stato variabile  |  Risultato nell'URL creato  | 
| --- | --- | 
|  ha selezionato un valore  |  var-myvar=valore1  | 
|  valori multipli selezionati  |  var-myvar=valore1&var-myvar=valore2  | 
|  selezionato Tutto  |  var-myvar=Tutti  | 

 **Se desideri aggiungere tutte le variabili della dashboard corrente all'URL, usa \$1 \$1\$1\$1all\$1variables\$1.** 

## Collegamenti dati
<a name="v9-panels-data-links"></a>

 I collegamenti dati consentono di fornire un contesto più granulare ai collegamenti. È possibile creare collegamenti che includono il nome della serie o anche il valore sotto il cursore. Ad esempio, se la visualizzazione mostra quattro server, è possibile aggiungere un collegamento dati a uno o due di essi. 

 Il link stesso è accessibile in diversi modi a seconda della visualizzazione. Per il grafico è necessario fare clic su un punto o una linea dati, per un pannello come Stat, Gauge o Bar Gauge è possibile fare clic in un punto qualsiasi della visualizzazione per aprire il menu contestuale. 

 Puoi utilizzare le variabili nei link dati per indirizzare le persone a una dashboard dettagliata con filtri di dati conservati. Ad esempio, è possibile utilizzare le variabili per specificare un intervallo di tempo, una serie e una selezione di variabili. Per ulteriori informazioni, consulta [Variabili di collegamento dati](#v9-panels-data-link-variables).

### Suggerimenti Typeahead
<a name="v9-panels-typeahead-suggestions"></a>

 Quando crei o aggiorni un collegamento dati, premi Cmd\$1Spazio o Ctrl\$1Spazio sulla tastiera per aprire i suggerimenti di digitazione automatica per aggiungere più facilmente variabili all'URL. 

### Aggiungi un collegamento dati
<a name="v9-panels-add-a-datalink"></a>

1.  **Posiziona il cursore sul pannello a cui desideri aggiungere un collegamento, quindi premi e.** **Oppure fai clic sulla freccia a discesa accanto al titolo del pannello, quindi fai clic su Modifica.** 

1.  Nella scheda Campo, scorri verso il basso fino alla sezione Collegamenti dati. 

1.  Espandi Collegamenti dati, quindi fai clic su **Aggiungi collegamento**. 

1.  Inserisci un **titolo**. Il **titolo** è un'etichetta leggibile dall'uomo per il collegamento che verrà visualizzato nell'interfaccia utente. 

1.  Inserisci l'**URL** a cui desideri collegarti. 

    Puoi anche aggiungere una delle variabili del modello definite nella dashboard. Fai clic nel campo **URL** e quindi digita **\$1** o premi Ctrl\$1Space o Cmd\$1Space per visualizzare un elenco di variabili disponibili. Aggiungendo variabili modello al link del pannello, il link rimanda l'utente al contesto giusto, con le variabili pertinenti già impostate. Per ulteriori informazioni, consulta [Variabili di collegamento dati](#v9-panels-data-link-variables).

1.  Se desideri che il link si apra in una nuova scheda, seleziona **Apri in una nuova scheda**. 

1.  Fai clic su **Salva** per salvare le modifiche e chiudere la finestra. 

1.  Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard. 

### Aggiorna un collegamento dati
<a name="v9-panels-update-a-datalink"></a>

1.  Nella scheda Campo, trova il link a cui desideri apportare modifiche. 

1.  Fai clic sull'icona Modifica (matita) per aprire la finestra Modifica link. 

1.  Apporta le modifiche necessarie: 

1.  Fai clic su **Salva** per salvare le modifiche e chiudere la finestra. 

1.  Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard. 

### Eliminare un collegamento dati
<a name="v9-panels-delete-a-datalink"></a>

1.  Nella scheda Campo, trova il link che desideri eliminare. 

1.  Fai clic sull'icona **X** accanto al link che desideri eliminare. 

1.  Fai clic su **Salva** in alto a destra per salvare le modifiche nella dashboard. 

# Configura le sostituzioni dei campi
<a name="v9-panels-configure-overrides"></a>

****  
**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 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 sostituzioni consentono di personalizzare le impostazioni di visualizzazione per campi o serie specifici. Ciò si ottiene aggiungendo una regola di esclusione che si rivolge a un particolare set di campi e che può definire più opzioni ciascuno. 

 Ad esempio, si imposta l'unità per tutti i campi che includono il testo «byte» aggiungendo un override utilizzando il matcher **regex Fields with name matching** e quindi si aggiunge l'opzione Unit alla regola override. 

## Esempio 1: temperatura del formato
<a name="v9-panels-overrides-format-temperature"></a>

 Supponiamo che il nostro set di risultati sia un frame di dati composto da due campi: tempo e temperatura. 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47,0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 A ogni campo (colonna) di questa struttura possono essere applicate opzioni di campo che ne modificano il modo in cui vengono visualizzati i valori. Ciò significa che è possibile, ad esempio, impostare l'unità su Temperatura > Celsius, ottenendo la seguente tabella: 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45,0 °C  | 
|  2020-01-02 03:05:00  |  47,0 °C  | 
|  2020-01-02 03:06:00  |  48,0 °C  | 

 Inoltre, la cifra decimale non è richiesta, quindi possiamo rimuoverla. È possibile modificare i decimali da **auto** a zero (**0**), ottenendo la seguente tabella: 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  | 
|  2020-01-02 03:05:00  |  47 °C  | 
|  2020-01-02 03:06:00  |  48 °C  | 

## Esempio 2: Formattare temperatura e umidità
<a name="v9-panels-overrides-format-humidity"></a>

 Supponiamo che il nostro set di risultati sia un frame di dati composto da quattro campi: tempo, alta temperatura, bassa temperatura e umidità. 


|  time  |  alta temperatura  |  bassa temperatura  |  umidità  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30,0  |  67  | 
|  2020-01-02 03:05:00  |  47,0  |  34,0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31,0  |  68  | 

 Aggiungiamo l'unità Celsius ed eliminiamo la cifra decimale. Ciò si traduce nella seguente tabella: 


|  time  |  alta temperatura  |  bassa temperatura  |  umidità  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67 °C  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68 °C  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68 °C  | 

 I campi di temperatura sembrano buoni, ma ora è necessario modificare l'umidità. Possiamo risolvere questo problema applicando un'opzione di campo che sovrascrive al campo di umidità e modificando l'unità in Misc > percent (0-100). 


|  time  |  alta temperatura  |  bassa temperatura  |  umidità  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67%  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68%  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68%  | 

## Aggiungi una sovrascrittura di campo
<a name="v9-panels-overrides-add-a-field"></a>

 Una regola di sostituzione dei campi può personalizzare le impostazioni di visualizzazione per un campo o una serie specifici. 

1.  Modifica il pannello a cui desideri aggiungere un'eccezione. 

1.  Nel riquadro laterale delle opzioni del pannello, fai clic su **Aggiungi sovrascrittura campo** nella parte inferiore del riquadro. 

1.  Seleziona a quali campi verrà applicata una regola di esclusione: 
   +  **Campi con nome:** seleziona un campo dall'elenco di tutti i campi disponibili. Le proprietà aggiunte a una regola con questo selettore vengono applicate solo a questo singolo campo. 
   +  **Campi il cui nome corrisponde all'espressione regolare:** specificate i campi da sovrascrivere con un'espressione regolare. Le proprietà aggiunte a una regola con questo selettore vengono applicate a tutti i campi in cui il nome del campo corrisponde all'espressione regolare. 
   +  **Campi con tipo:** seleziona i campi per tipo, ad esempio stringa, numerico e così via. Le proprietà aggiunte a una regola con questo selettore vengono applicate a tutti i campi che corrispondono al tipo selezionato. 
   +  **Campi restituiti da una query:** seleziona tutti i campi restituiti da una query specifica, ad esempio A, B o C. Le proprietà aggiunte a una regola con questo selettore vengono applicate a tutti i campi restituiti dalla query selezionata. 

1.  Fate clic su **Aggiungi proprietà sostitutiva.** 

1.  Seleziona l'opzione di campo che desideri applicare. 

1.  Inserisci le opzioni aggiungendo valori nei campi. Per riportare le opzioni ai valori predefiniti, elimina il testo bianco nei campi. 

1.  Continua ad aggiungere sostituzioni a questo campo facendo clic su **Aggiungi proprietà di sostituzione** oppure puoi fare clic su **Aggiungi sostituzioni e selezionare un campo diverso a cui aggiungere le sostituzioni**. 

1.  Al termine, fai clic su **Salva per salvare** tutte le modifiche al pannello nella dashboard. 

## Eliminare una sovrascrittura di un campo
<a name="v9-panels-overrides-delete-a-field"></a>

 Elimina l'override di un campo quando non è più necessario. Quando si elimina una sovrascrittura, l'aspetto del valore viene impostato come predefinito nel formato originale. Questa modifica influisce sulle dashboard e sugli utenti della dashboard che si affidano a un pannello interessato. 

1.  Modifica il pannello che contiene l'override che desideri eliminare. 

1.  Nel riquadro laterale delle opzioni del pannello, scorri verso il basso fino a visualizzare le sostituzioni. 

1.  Fai clic sull'eccezione che desideri eliminare, quindi sull'icona del cestino associata. 

## Visualizza le sostituzioni dei campi
<a name="v9-panels-overrides-view"></a>

 È possibile visualizzare le sostituzioni dei campi nelle opzioni di visualizzazione del pannello. 

1.  Modifica il pannello che contiene le sostituzioni che desideri visualizzare. 

1.  Nel riquadro laterale delle opzioni del pannello, scorri verso il basso fino a visualizzare le sostituzioni. 

 **Le impostazioni di sostituzione visualizzate nella scheda **Tutte** sono uguali a quelle visualizzate nella scheda Sostituzioni.** 

## Modifica l'override di un campo
<a name="v9-panels-overrides-edit-a-field"></a>

 Modifica l'override di un campo quando desideri apportare modifiche a un'impostazione di sovrascrittura. La modifica apportata ha effetto immediato. 

1.  Modifica il pannello che contiene le sostituzioni che desideri modificare. 

1.  Nel riquadro laterale delle opzioni del pannello, scorri verso il basso fino a visualizzare le sostituzioni. 

1.  Individua l'override che desideri modificare. 

1.  Eseguite una delle seguenti operazioni: 
   +  Modifica le impostazioni sulle sostituzioni esistenti o sui parametri di selezione dei campi. 
   +  Eliminare le proprietà di sostituzione esistenti facendo clic sulla **X** accanto alla proprietà. 
   +  Aggiungere una proprietà sostitutiva facendo clic su **Aggiungi proprietà di sostituzione.** 

# Configurare le mappature dei valori
<a name="v9-panels-configure-value-mappings"></a>

****  
**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 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)

 Oltre alle sostituzioni dei campi, la mappatura dei valori è una tecnica che è possibile utilizzare per modificare il trattamento visivo dei dati che appaiono in una visualizzazione. 

 I valori mappati tramite le mappature dei valori ignorano la formattazione dell'unità. Ciò significa che un valore di testo mappato su un valore numerico non viene formattato utilizzando l'unità configurata. 

 Se le mappature dei valori sono presenti in un pannello, Grafana visualizza un riepilogo nel riquadro laterale dell'editor dei pannelli. 

**Nota**  
 Le nuove mappature dei valori non sono compatibili con alcune visualizzazioni, come Graph (old), Text e Heatmap. 

## Tipi di mappature dei valori
<a name="v9-panels-value-mappings-types"></a>

 Grafana supporta le seguenti mappature dei valori: 
+  **Valore:** mappa i valori del testo su un colore o su un testo di visualizzazione diverso. **Ad esempio, puoi configurare una mappatura dei valori in modo che tutte le istanze del valore **10** appaiano come Perfection\$1** anziché il numero. 
+  **Intervallo:** mappa gli intervalli numerici su un testo e un colore visualizzati. Ad esempio, se un valore rientra in un determinato intervallo, è possibile configurare una mappatura dei valori di intervallo per visualizzare **Basso** o **Alto** anziché il numero. 
+  **Regex:** mappa le espressioni regolari su testo e colore sostitutivi. **Ad esempio, se un valore è **www.example.com**, puoi configurare una mappatura dei valori regex in modo che Grafana visualizzi www e tronchi il dominio.** 
+  **Speciale** Visualizza valori speciali come **Null**, **NaN** (non un numero) e valori booleani come **true** e **false su** un testo e un colore di visualizzazione. **Ad esempio, puoi configurare una mappatura di valori speciale in modo che i valori **nulli appaiano come N/A**.** 

 È inoltre possibile utilizzare i punti a sinistra per trascinare e riordinare le mappature dei valori nell'elenco. 

## Mappa un valore
<a name="v9-panels-value-mappings-map-a-value"></a>

 Mappa un valore quando desideri formattare un singolo valore. 

1.  Apri un pannello per il quale desideri mappare un valore. 

1.  Nelle opzioni di visualizzazione del pannello, individuate la sezione **Mappature dei valori** e fate clic su **Aggiungi mappature di valore**. 

1.  **Fai clic su **Aggiungi una nuova mappatura**, quindi seleziona Valore.** 

1.  Immettete il valore da abbinare a Grafana. 

1.  (Facoltativo) Inserite il testo visualizzato. 

1.  (Facoltativo) Imposta il colore. 

1.  Fate clic su **Aggiorna** per salvare la mappatura dei valori. 

## Mappa un intervallo
<a name="v9-panels-value-mappings-map-a-range"></a>

 Mappa un intervallo di valori quando desideri formattare più valori continui. 

1.  Modifica il pannello per il quale desideri mappare un intervallo di valori. 

1.  Nelle opzioni di visualizzazione del pannello, nella sezione **Mappature dei valori, fate clic su Aggiungi mappature** **di valore**. 

1.  **Fai clic su **Aggiungi una nuova mappatura**, quindi seleziona Intervallo.** 

1.  Inserisci i valori iniziali e finali nell'intervallo a cui Grafana deve corrispondere. 

1.  (Facoltativo) Inserite il testo visualizzato. 

1.  (Facoltativo) Imposta il colore. 

1.  Fate clic su **Aggiorna** per salvare la mappatura dei valori. 

## Mappa un'espressione regolare
<a name="v9-panels-value-mappings-map-a-regex"></a>

 Mappa un'espressione regolare quando desideri formattare il testo e il colore di un valore di espressione regolare. 

1.  Modifica il pannello per il quale vuoi mappare un'espressione regolare. 

1.  Nella sezione **Mappature dei valori** delle opzioni di visualizzazione del pannello, fate clic su **Aggiungi mappature di valore**. 

1.  **Fai clic su **Aggiungi una nuova mappatura**, quindi seleziona Regex.** 

1.  Inserisci il modello di espressione regolare a cui Grafana deve corrispondere. 

1.  (Facoltativo) Inserite il testo visualizzato. 

1.  (Facoltativo) Imposta il colore. 

1.  Fate clic su **Aggiorna** per salvare la mappatura dei valori. 

## Mappa un valore speciale
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 Mappa un valore speciale quando desideri formattare valori non comuni, booleani o vuoti. 

1.  Modifica il pannello per il quale desideri mappare un valore speciale. 

1.  Nelle opzioni di visualizzazione del pannello, individuate la sezione **Mappature dei valori** e fate clic su **Aggiungi mappature di valore**. 

1.  **Fai clic su **Aggiungi una nuova mappatura**, quindi seleziona Speciale.** 

1.  Seleziona il valore speciale a cui Grafana deve corrispondere. 

1.  (Facoltativo) Immettete il testo visualizzato. 

1.  (Facoltativo) Imposta il colore. 

1.  Fate clic su **Aggiorna** per salvare la mappatura dei valori. 

## Modifica una mappatura dei valori
<a name="v9-panels-value-mappings-edit-a-value"></a>

 È possibile modificare una mappatura dei valori in qualsiasi momento. 

1.  Modifica il pannello che contiene la mappatura dei valori che desideri modificare. 

1.  Nelle opzioni di visualizzazione del pannello, nella sezione Mappature dei **valori, fate clic su **Modifica** mappature** dei valori. 

1.  **Apporta le modifiche e fai clic su Aggiorna.** 

# Configurare una legenda
<a name="v9-panels-configure-legend"></a>

****  
**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 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)

Un pannello include una legenda che è possibile utilizzare per interpretare i dati visualizzati in una visualizzazione. Ogni opzione di legenda aggiunge contesto e chiarezza ai dati illustrati in una visualizzazione.

## Isolamento dei dati delle serie in una visualizzazione
<a name="v9-panels-legend-isolate"></a>

Le visualizzazioni possono spesso essere visivamente complesse e includere molte serie di dati. È possibile semplificare la visualizzazione rimuovendo i dati delle serie dalla visualizzazione, in modo da isolare i dati che si desidera visualizzare. **Grafana crea automaticamente un nuovo override nella scheda Sostituisci.**

Quando applichi le modifiche, le modifiche alla visualizzazione vengono visualizzate da tutti gli utenti del pannello.

**Per isolare i dati delle serie in una visualizzazione**

1. Aprire il pannello.

1. Nella legenda, seleziona l'etichetta della serie che desideri isolare.

   Il sistema rimuove dalla visualizzazione tutti gli altri dati della serie.

1. Per aggiungere in modo incrementale i dati della serie a una serie isolata, premete il tasto **Ctrl** o **Comando** e selezionate l'etichetta della serie che desiderate aggiungere.

1. Per tornare alla visualizzazione predefinita che include tutti i dati, fate clic due volte sull'etichetta di una serie.

1. **Per salvare le modifiche in modo che vengano visualizzate da tutti gli utenti del pannello, selezionate Applica.**

Questo argomento si applica attualmente alle seguenti visualizzazioni:
+ [Grafico a barre](v9-panels-bar-chart.md)
+ [Istogramma](v9-panels-histogram.md)
+ [Grafico a torta](v9-panels-piechart.md)
+ [Cronologia dello stato](v9-panels-state-timeline.md)
+ [Cronologia dello stato](v9-panels-status-history.md)
+ [Serie temporali](v9-panels-time-series.md)

## Aggiungere valori a una legenda
<a name="v9-panels-legend-add-values"></a>

Per aggiungere più contesto a una visualizzazione, puoi aggiungere valori di dati in serie a una legenda. Puoi aggiungere tutti i valori che desideri; dopo aver applicato le modifiche, puoi scorrere orizzontalmente la legenda per visualizzare tutti i valori.

**Per aggiungere valori a una legenda**

1. Modifica un pannello.

1. Nel riquadro delle opzioni di visualizzazione del pannello, individua la sezione **Legenda**.

1. Nel campo **Valori della legenda**, seleziona i valori che desideri vengano visualizzati nella legenda.

1. Scegli **Applica** per salvare le modifiche e torna alla dashboard.

## Cambiare il colore di una serie
<a name="v9-panels-legend-change-color"></a>

Per impostazione predefinita, Grafana specifica il colore dei dati della serie, che puoi modificare.

**Per cambiare il colore di una serie**

1. Modificare un pannello.

1. Nella legenda, seleziona la barra dei colori associata alla serie.

1. Seleziona un colore preimpostato o un colore personalizzato dalla tavolozza dei colori.

1. Scegli **Applica** per salvare le modifiche e torna alla dashboard.

## Ordina serie
<a name="v9-panels-legend-sort"></a>

È possibile modificare la modalità della legenda in **Tabella** e [Tipi di calcolo](v9-panels-calculation-types.md) scegliere di visualizzarla nella legenda. Seleziona l'intestazione del nome del calcolo nella tabella della legenda per ordinare i valori nella tabella in ordine crescente o decrescente.

L'ordinamento influisce sulla posizione delle barre nel pannello Grafico a barre e sull'ordine delle serie in pila nei pannelli Serie temporali e Grafico a barre.

**Nota**  
Questa funzionalità è supportata solo in questi pannelli: Grafico a barre, Istogramma, Serie temporali, Grafico XY.

# Tipi di calcolo
<a name="v9-panels-calculation-types"></a>

****  
**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 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)

 La tabella seguente contiene un elenco di calcoli che è possibile eseguire in Grafana. Puoi trovare questi calcoli nella scheda **Trasforma** e nelle visualizzazioni degli indicatori a barre, degli indicatori e delle statistiche. 


|  Calcolo  |  Description  | 
| --- | --- | 
|  Tutti i valori nulli  |  Vero quando tutti i valori sono nulli  | 
|  Tutti gli zeri  |  Vero quando tutti i valori sono 0  | 
|  Numero di modifiche  |  Numero di volte in cui il valore del campo cambia  | 
|  Conteggio  |  Numero di valori in un campo  | 
|  Delta  |  Modifica cumulativa del valore, conta solo gli incrementi  | 
|  Differenza  |  Differenza tra il primo e l'ultimo valore di un campo  | 
|  Differenza percentuale  |  Variazione percentuale tra il primo e l'ultimo valore di un campo  | 
|  Conteggio distinto  |  Numero di valori univoci in un campo  | 
|  Primo (non nullo)  |  Innanzitutto, non è un valore nullo in un campo  | 
|  Max  |  Valore massimo di un campo  | 
|  Media  |  Valore medio di tutti i valori in un campo  | 
|  Varianza  |  Varianza di tutti i valori in un campo  | 
|  StdDev  |  Deviazione standard di tutti i valori in un campo  | 
|  Min  |  Valore minimo di un campo  | 
|  Min (sopra lo zero)  |  Valore minimo e positivo di un campo  | 
|  Intervallo  |  Differenza tra i valori massimi e minimi di un campo  | 
|  Fase  |  Intervallo minimo tra i valori di un campo  | 
|  Totale  |  Somma di tutti i valori in un campo  | 

# Annotazione delle visualizzazioni
<a name="v9-panels-annotate-visualizations"></a>

****  
**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 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.

**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 comportamento`Match any`, abilita e Grafana mostrerà le annotazioni che contengono uno dei tag che hai fornito.

In Grafana v5.3\$1 è 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.

# La vista di ispezione del pannello
<a name="v9-panels-panel-inspector"></a>

****  
**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 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)

 La vista di ispezione del pannello, che puoi aprire tramite il menu del pannello, ti aiuta a comprendere e risolvere i problemi dei pannelli. Puoi ispezionare i dati grezzi di qualsiasi pannello Grafana, esportare tali dati in un file con valori separati da virgole (CSV), visualizzare le richieste di query ed esportare pannelli e dati JSON. 

**Nota**  
 Non tutti i tipi di pannello includono tutte le schede. Ad esempio, i pannelli con l'elenco delle dashboard non contengono dati grezzi da esaminare, quindi non visualizzano le schede Statistiche, Dati o Query. 

 L'ispettore del pannello include le seguenti opzioni: 

1.  L'ispettore del pannello visualizza **Inspect: [NameOfPanelBeingInspected]** nella parte superiore del riquadro. Fate clic sulla freccia nell'angolo superiore destro per espandere o ridurre il riquadro. 

1.  **Scheda Dati:** mostra i dati grezzi restituiti dall'interrogazione con le trasformazioni applicate. Le opzioni di campo come le sostituzioni e le mappature dei valori non vengono applicate per impostazione predefinita. 

1.  **Scheda Statistiche:** mostra quanto tempo impiega la query e quanto restituisce. 

1.  **Scheda JSON:** consente di visualizzare e copiare il pannello JSON, i dati del pannello JSON e la struttura del frame di dati JSON. Ciò è utile se si esegue il provisioning o la somministrazione di Grafana. 

1.  **Scheda Query:** mostra le richieste al server inviate quando Grafana interroga l'origine dati. 

1.  **Scheda Errore:** mostra l'errore. Visibile solo quando la query restituisce un errore. 

## Scarica i risultati non elaborati delle query
<a name="v9-panels-raw-query-results"></a>

 Grafana genera un file CSV che contiene i tuoi dati, comprese le eventuali trasformazioni di tali dati. Puoi scegliere di visualizzare i dati prima o dopo che il pannello applica le opzioni di campo o le sostituzioni delle opzioni di campo. 

1.  Modifica il pannello che contiene i dati della query che desideri scaricare. 

1.  Nell'editor di query, fare clic su **Query Inspector**. 

1.  Fate clic su **Dati**. 

    Se il pannello contiene più interrogazioni o interroga più nodi, allora sono disponibili opzioni aggiuntive. 
   +  **Seleziona risultato**: scegli i dati del set di risultati che desideri visualizzare. 
   +  **Trasforma i dati** 
   +  **Partecipa in base all'ora**: visualizza i dati grezzi di tutte le tue query contemporaneamente, un set di risultati per colonna. Fai clic sull'intestazione di una colonna per riordinare i dati. 

1.  Per visualizzare i dati prima che il sistema applichi le sostituzioni dei campi, fate clic sull'interruttore Dati **formattati**. 

1.  **Per scaricare un file CSV formattato specificamente per Excel, fai clic sull'interruttore Scarica per Excel.** 

1.  **Fai clic su Scarica CSV.** 

## Controlla le prestazioni delle query
<a name="v9-panels-query-performance"></a>

 La scheda **Statistiche** mostra le statistiche che indicano la durata della query, il numero di query inviate e il numero di righe restituite. Queste informazioni possono aiutarti a risolvere i problemi delle tue query, soprattutto se uno qualsiasi dei numeri è inaspettatamente alto o basso. 

1.  Modifica il pannello che contiene l'interrogazione specificando le prestazioni che desideri controllare. 

1.  Nell'editor di query, fare clic su **Query Inspector**. 

1.  Fate clic su **Statistiche**. 

 Le statistiche vengono visualizzate in formato di sola lettura. 

## Ispeziona la richiesta e la risposta all'interrogazione
<a name="v9-panels-query-request-response"></a>

 Esamina i dati della richiesta di interrogazione e della risposta quando desideri risolvere una query che restituisce risultati imprevisti o non restituisce i risultati previsti. 

1.  Modifica il pannello che contiene l'interrogazione che desideri esportare. 

1.  Nell'editor di query, fare clic su **Query Inspector**. 

1.  Fate clic su **Aggiorna**. 

    Il pannello viene compilato con i dati di risposta. 

1.  Apportate le modifiche necessarie ed eseguite nuovamente la query. 

1.  Per scaricare i dati relativi alla richiesta di interrogazione e alla risposta, fate clic sull'icona **Copia negli Appunti** e incollate i risultati in un'altra applicazione. 

# Visualizzazioni disponibili nella versione 9 di Grafana
<a name="v9-panels-viz"></a>

****  
**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 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)

Grafana offre una varietà di visualizzazioni per supportare diversi casi d'uso. Questa sezione della documentazione evidenzia i pannelli integrati, le relative opzioni e l'utilizzo tipico.

Un pannello comune da cui iniziare e per apprendere le basi dell'uso dei pannelli è il [Pannello delle serie temporali](v9-panels-time-series.md) pannello.

**Topics**
+ [Pannello elenco degli avvisi](v9-panels-alert-list.md)
+ [Pannello Annotazioni](v9-panels-annotations.md)
+ [Pannello grafico a barre](v9-panels-bar-chart.md)
+ [Manometro a barra](v9-panels-bar-gauge.md)
+ [Pannello portacandele](v9-panels-candlestick.md)
+ [Pannello in tela](v9-panels-canvas.md)
+ [Pannello dell'orologio](v9-panels-clock.md)
+ [Elenco dashboard](v9-panels-dashboard-list.md)
+ [Pannello del calibro](v9-panels-gauge.md)
+ [Pannello Geomap](v9-panels-geomap.md)
+ [Pannello grafico](v9-panels-graph.md)
+ [Pannello Heatmap](v9-panels-heatmap.md)
+ [Pannello istogramma](v9-panels-histogram.md)
+ [Pannello Logs](v9-panels-logs.md)
+ [Pannello delle notizie](v9-panels-news.md)
+ [Pannello grafico dei nodi](v9-panels-node-graph.md)
+ [Pannello grafico a torta](v9-panels-piechart.md)
+ [Pannello Plotly](v9-panels-plotly.md)
+ [Pannello Sankey](v9-panels-sankey.md)
+ [Pannello Scatter](v9-panels-scatter.md)
+ [Pannello Stat](v9-panels-stat.md)
+ [Pannello della cronologia dello stato](v9-panels-state-timeline.md)
+ [Pannello della cronologia dello stato](v9-panels-status-history.md)
+ [Pannello da tavolo](v9-panels-table.md)
+ [Pannello di testo](v9-panels-text.md)
+ [Pannello delle serie temporali](v9-panels-time-series.md)
+ [Pannello Traces (Beta)](v9-panels-traces.md)
+ [WindRose](v9-panels-windrose.md)

# Pannello elenco degli avvisi
<a name="v9-panels-alert-list"></a>

****  
**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 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)

Il pannello con l'elenco degli avvisi mostra gli avvisi della dashboard. È possibile configurare l'elenco per mostrare lo stato corrente o le modifiche recenti dello stato. Per ulteriori informazioni sugli avvisi, vedere[Avvisi nella versione 9 di Grafana](v9-alerts.md).

Utilizza queste impostazioni per perfezionare la visualizzazione.

## Opzioni
<a name="v9-panels-alert-list-options"></a>
+  **Modalità di gruppo**: scegli **Raggruppamento predefinito** per mostrare le istanze di avviso raggruppate in base alla relativa regola di avviso o Raggruppamento **personalizzato per raggruppare le istanze di** avviso in base a un set di etichette personalizzato.
+  **Numero massimo di elementi**: imposta il numero massimo di avvisi da elencare.
+  **Ordinamento**: seleziona come ordinare gli avvisi visualizzati.
  +  **Alfabetico (asc)**: ordine alfabetico
  +  **Alfabetico (desc**) — Ordine alfabetico inverso
  +  **Importanza**: per importanza in base ai seguenti valori, dove 1 è il valore più alto:
    + `alerting`oppure`firing`: 1
    + `no_data`: 2
    + `pending`: 3
    + `ok`: 4
    + `paused`oppure`inactive`: 5
+  **Avvisi da questa dashboard**: mostra gli avvisi solo dalla dashboard in cui si trova l'elenco degli avvisi.

## Filtro
<a name="v9-panels-alert-filter"></a>

Utilizza le seguenti opzioni per filtrare gli avvisi in modo che corrispondano alla query, alla cartella o ai tag che scegli:
+  **Nome dell'avviso**: immetti una richiesta relativa al nome dell'avviso. 
+  **Etichetta dell'istanza di avviso**: filtra le istanze di avviso utilizzando l'interrogazione delle etichette. Ad esempio, `{severity="critical", instance=~"cluster-us-.+"}`.
+  **Cartella**: seleziona una cartella. Verranno visualizzati solo gli avvisi provenienti dai dashboard nella cartella selezionata.
+  **Fonte dati**: filtra gli avvisi dall'origine dati selezionata. 

## Filtro di stato
<a name="v9-panels-alert-state-filter"></a>

Scegli quali stati di avviso visualizzare in questo pannello.
+ Avvisi/ Attivazione
+ Pending (In attesa)
+ Nessun dato
+ Normale
+ Errore

# Pannello Annotazioni
<a name="v9-panels-annotations"></a>

****  
**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 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)

Il pannello Annotazioni mostra un elenco di annotazioni disponibili che è possibile utilizzare per visualizzare i dati annotati. Sono disponibili varie opzioni per filtrare l'elenco in base ai tag e alla dashboard corrente.

## Interrogazione di annotazione
<a name="v9-panels-annotations-query"></a>

Le seguenti opzioni controllano la query di origine per l'elenco delle annotazioni.

**Filtro delle interrogazioni**

Utilizza il filtro di interrogazione per creare un elenco di annotazioni da tutte le dashboard dell'organizzazione o dalla dashboard corrente in cui si trova questo pannello. Ha le seguenti opzioni:
+ Tutti i dashboard: elenca le annotazioni di tutti i dashboard dell'organizzazione corrente.
+ Questa dashboard: limita l'elenco alle annotazioni sulla dashboard corrente.

**Intervallo di tempo**

Utilizzate l'opzione intervallo di tempo per specificare se l'elenco deve essere limitato all'intervallo di tempo corrente. Ha le seguenti opzioni:
+ Nessuno: nessun limite di intervallo di tempo per la richiesta di annotazioni.
+ Questa dashboard: limita l'elenco all'intervallo di tempo della dashboard in cui è disponibile il pannello dell'elenco delle annotazioni.

**Tag**

Utilizza l'opzione tag per filtrare le annotazioni per tag. Puoi aggiungere più tag per affinare l'elenco.

**Nota**  
Facoltativamente, lascia l'elenco dei tag vuoto e filtra al volo selezionando i tag che sono elencati come parte dei risultati sul pannello stesso.

*Limite*

Utilizzate l'opzione limit per limitare il numero di risultati restituiti.

## Visualizzazione
<a name="v9-panels-annotations-display"></a>

Queste opzioni controllano i metadati aggiuntivi inclusi nella visualizzazione del pannello delle annotazioni.

**Mostra utente**

Utilizzate questa opzione per mostrare o nascondere l'utente che ha creato l'annotazione.

**Mostra l'ora**

Utilizzate questa opzione per mostrare o nascondere l'ora di creazione dell'annotazione.

**Mostra tag**

Utilizzate questa opzione per mostrare o nascondere i tag associati a un'annotazione. *NB*: È possibile utilizzare i tag per filtrare in tempo reale l'elenco delle annotazioni sul pannello stesso.

## Comportamento dei link
<a name="v9-panels-annotations-links"></a>

**Destinazione del link**

Utilizzate questa opzione per scegliere come visualizzare i dati annotati. Ha le seguenti opzioni.
+ Pannello: questa opzione ti porterà direttamente a una visualizzazione a tutto schermo del pannello con l'annotazione corrispondente
+ Dashboard: questa opzione focalizzerà l'annotazione nel contesto di una dashboard completa

**Tempo prima**

Utilizzate questa opzione per impostare l'intervallo di tempo prima dell'annotazione. Usa valori di stringa di durata come «1h» = 1 ora, «10m» = 10 minuti, ecc.

**Tempo dopo**

Utilizzate questa opzione per impostare l'intervallo di tempo dopo l'annotazione.

# Pannello grafico a barre
<a name="v9-panels-bar-chart"></a>

****  
**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 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)

Questa visualizzazione del pannello consente di rappresentare graficamente dati categorici.

## Formati di dati supportati
<a name="v9-panels-bar-chart-formats"></a>

È supportato un solo frame di dati e deve avere almeno un campo stringa che verrà utilizzato come categoria per un asse X o Y e uno o più campi numerici. Di seguito è riportato un esempio di formati di dati:


|  Browser  |  Quota di mercato  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17.5  | 

Se hai più di un campo numerico, il pannello mostra le barre raggruppate.

### Visualizzazione di serie temporali o set di risultati multipli
<a name="v9-panels-bar-chart-visualization"></a>

Se disponi di più serie temporali o tabelle, devi prima unirle utilizzando una trasformazione di unione o riduzione. Ad esempio, se disponi di più serie temporali e desideri confrontarne l'ultimo e il valore massimo, aggiungi la trasformazione **Riduci** e specifica **Max** e **Last** come opzioni in **Calcoli**.

## Opzioni del grafico a barre
<a name="v9-panels-bar-chart-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Orientation** (Orientamento)
+  **Automatico** — Grafana decide l'orientamento della barra in base alle dimensioni del pannello.
+  **Orizzontale**: rende l'asse X l'asse delle categorie.
+  **Verticale**: rende l'asse Y l'asse delle categorie.

**La lunghezza massima delle etichette dei grafici a barre sull'asse X** imposta la lunghezza massima delle etichette dei grafici a barre. Le etichette più lunghe della lunghezza massima vengono troncate (con ellissi).

La **spaziatura minima delle etichette a barre imposta la spaziatura minima tra le** etichette delle barre.

**Mostra valori**

Controlla se i valori vengono visualizzati sopra o a sinistra delle barre.
+  **Automatico**: i valori vengono visualizzati se c'è spazio.
+  **Sempre**: mostra sempre i valori.
+  **Mai**: non mostrare mai valori.

**Impilamento**

Controlla l'impilamento dei grafici a barre.
+  **Disattivato**: le barre non verranno impilate.
+  **Normale**: le barre verranno impilate una sopra l'altra.
+  **Percentuale**: le barre verranno impilate una sopra l'altra e l'altezza di ciascuna barra è la percentuale dell'altezza totale della pila (tutte le pile di barre avranno la stessa altezza, fino al 100%).

La **larghezza del gruppo** controlla la larghezza dei gruppi. 0=larghezza minima e 1=larghezza massima.

La **larghezza della barra** controlla la larghezza delle barre. 0=min e 1=larghezza massima.

Il **raggio della barra** controlla il raggio delle barre, 0 = raggio minimo e 0,5 = raggio massimo.

**Evidenzia l'intera area sui controlli al passaggio del mouse** se l'area circostante della barra viene evidenziata quando passi il mouse sulla barra con un puntatore.

**La larghezza della linea** controlla la larghezza della linea delle barre.

**L'opacità di riempimento** controlla l'opacità di riempimento delle barre.

La modalità **gradiente imposta la modalità di riempimento** del gradiente. Il gradiente di riempimento si basa sul colore della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard. L'aspetto del gradiente è influenzato dall'impostazione dell'**opacità di riempimento**.
+  **Nessuno**: nessun riempimento a gradiente, questa è l'impostazione predefinita.
+  **Opacità: la** trasparenza del gradiente viene calcolata in base ai valori sull'asse y. L'opacità del riempimento aumenta con i valori sull'asse Y.
+  **Tonalità**: il colore del gradiente viene generato in base alla tonalità del colore della linea.

**Modalità Tooltip**: quando si posiziona il cursore sulla visualizzazione, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip.
+  **Singolo**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui stai posizionando il mouse sulla visualizzazione.
+  **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie della visualizzazione. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+  **Nascosto**: non visualizza il tooltip quando interagisci con la visualizzazione.

**Nota**  
È possibile utilizzare un override per nascondere singole serie dal tooltip.

**Modalità Legenda**: utilizza queste impostazioni per perfezionare l'aspetto della legenda nella visualizzazione. Per ulteriori informazioni, consulta [Configurare una legenda](v9-panels-configure-legend.md).
+  **Elenco**: visualizza la legenda sotto forma di elenco. Si tratta di una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda**: scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

**Calcoli della legenda**: scegli quali calcoli standard mostrare nella legenda. Puoi averne più di uno.

**Dimensione del testo**: inserisci un valore per modificare la dimensione del testo sul grafico a barre.

**Asse**: utilizza le seguenti impostazioni di campo per perfezionare la visualizzazione degli assi. Alcune opzioni di campo non influiranno sulla visualizzazione finché non fate clic all'esterno della casella delle opzioni di campo che state modificando o premete Invio.
+  **Posizionamento**: imposta il posizionamento dell'asse Y.
+  **Automatico** — Grafana assegna automaticamente l'asse Y alla serie. Quando ci sono due o più serie con unità diverse, Grafana assegna l'asse sinistro alla prima unità e quello destro alle unità successive.
+  **Sinistra**: visualizza tutti gli assi Y sul lato sinistro.
+  **Destra**: visualizza tutti gli assi Y sul lato destro.
+  **Nascosto**: nasconde tutti gli assi Y.
+  **Etichetta**: imposta un'etichetta di testo sull'asse Y. Se hai più di un asse Y, puoi assegnare etichette diverse con un'eccezione.
+  **Larghezza**: imposta una larghezza fissa dell'asse. Per impostazione predefinita, Grafana calcola dinamicamente la larghezza di un asse.

  Impostando la larghezza dell'asse, i dati con diversi tipi di assi possono condividere le stesse proporzioni di visualizzazione. Ciò semplifica il confronto di più dati di un grafico perché gli assi non vengono spostati o allungati in prossimità visiva l'uno dell'altro.
+  **Soft min e soft max**: impostate le opzioni soft min e soft max per un migliore controllo dei limiti dell'asse Y. Per impostazione predefinita, Grafana imposta automaticamente l'intervallo per l'asse Y in base al set di dati.

  Le impostazioni soft min e soft max possono impedire che i blip si trasformino in montagne quando i dati sono per lo più piatti, mentre le impostazioni hard min o max, derivate dalle opzioni di campo min e max standard, possono impedire ai picchi intermittenti di appiattire i dettagli utili ritagliando i picchi oltre un punto definito.

  È possibile impostare opzioni standard min/max per definire limiti rigidi dell'asse Y.

# Manometro a barra
<a name="v9-panels-bar-gauge"></a>

****  
**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 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)

L'indicatore a barre semplifica i dati riducendo ogni campo a un unico valore. Sei tu a scegliere come Grafana calcola la riduzione.

Questo pannello può mostrare uno o più indicatori a barre a seconda del numero di serie, righe o colonne restituite dalla query.

## Opzioni di valore
<a name="v9-panels-bar-gauge-value"></a>

Utilizza le seguenti opzioni per rifinire il modo in cui la visualizzazione mostra il valore:

**Mostra**: scegli come Grafana visualizza i tuoi dati.

**Calcola**: mostra un valore calcolato in base a tutte le righe.
+ **Calcolo**: seleziona una funzione di riduzione che Grafana utilizzerà per ridurre molti campi a un unico valore. Per un elenco dei calcoli disponibili, consulta Tipi di calcolo.
+ **Campi**: seleziona i campi visualizzati nel pannello.

**Tutti i valori**: mostra una statistica separata per ogni riga. Se selezioni questa opzione, puoi anche limitare il numero di righe da visualizzare.
+ **Limite**: il numero massimo di righe da visualizzare. Il valore predefinito è 5.000.
+ **Campi**: seleziona i campi visualizzati nel pannello.

## Opzioni relative agli indicatori a barre
<a name="v9-panels-bar-gauge-options"></a>

Regola la modalità di visualizzazione dell'indicatore a barra.

**Orientamento**: scegli una direzione di impilamento.
+ **Automatico**: Grafana seleziona quello che ritiene sia l'orientamento migliore.
+ **Orizzontale**: le barre si estendono orizzontalmente, da sinistra a destra.
+ **Verticale**: le barre si estendono verticalmente, dal basso verso l'alto.

**Modalità di visualizzazione**: scegli una modalità di visualizzazione.
+ **Gradiente**: i livelli di soglia definiscono un gradiente.
+ **LCD retrò**: l'indicatore è suddiviso in piccole celle accese o spente.
+ **Base**: colore singolo in base alla soglia di corrispondenza.

**Mostra area non riempita**: seleziona questa opzione se desideri rendere la regione vuota delle barre in grigio scuro. Non applicabile alla modalità di visualizzazione LCD retrò.

**Larghezza minima**

Limita la larghezza minima della colonna della barra in direzione verticale.

Mostra automaticamente la barra di scorrimento dell'asse x quando c'è una grande quantità di dati.

**Altezza minima**

Limita l'altezza minima della riga della barra in direzione orizzontale.

Mostra automaticamente la barra di scorrimento dell'asse y quando c'è una grande quantità di dati.

# Pannello portacandele
<a name="v9-panels-candlestick"></a>

****  
**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 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)

Il pannello Candlestick consente di visualizzare dati che includono una serie di dimensioni coerenti incentrate sul movimento dei prezzi. Il pannello Candlestick include una modalità Open-High-Low-Close (OHLC), oltre al supporto per dimensioni aggiuntive basate su dati di serie temporali.

Il pannello Candlestick si basa sulle fondamenta di e include molte impostazioni di configurazione comuni. [Pannello delle serie temporali](v9-panels-time-series.md)

**Mode** (Modalità)

Le opzioni della modalità consentono di attivare o disattivare le dimensioni utilizzate per la visualizzazione.
+ **Candles** limita le dimensioni del pannello alle dimensioni di apertura, altezza, altezza e chiusura utilizzate dalle visualizzazioni a candela.
+ **Il volume** limita la dimensione del pannello alla dimensione del volume.
+ **Entrambi** sono il comportamento predefinito per il pannello a candele. Include visualizzazioni sia a candele che a volume.

**Stile a candela**
+ **Candles** è lo stile di visualizzazione predefinito e crea visualizzazioni a forma di candela tra le dimensioni di apertura e chiusura.
+ **OHLC Bars** mostra i valori di apertura, massimo, minimo e chiusura delle quattro dimensioni principali.

**Strategia del colore**
+ **Poiché Open** è il comportamento predefinito. Questa modalità utilizzerà il colore *Up* (sotto) se il movimento dei prezzi all'interno del periodo è positivo. In altre parole, se il valore alla chiusura è maggiore o uguale al valore all'apertura, viene utilizzato il colore *Up*.
+ **Poiché Prior Close** è un metodo di visualizzazione alternativo in cui il colore della candela si basa sul movimento dei prezzi interperiodici o sulla variazione di valore. In altre parole, se il valore all'apertura è maggiore del valore precedente alla chiusura, viene utilizzato il colore *Up*. Se il valore all'apertura è inferiore al valore precedente alla chiusura, viene utilizzato il colore *Giù*. *Questa opzione attiva anche la modalità di visualizzazione con candele vuote*. Le candele vuote indicano che il movimento intra-periodo è positivo (il valore è più alto quando è chiuso che aperto), le candele piene indicano che la variazione intra-periodo è negativa (il valore è più basso quando è chiuso che aperto). [Per ulteriori informazioni, consulta la spiegazione delle differenze.](https://thetradingbible.com/how-to-read-hollow-candlesticks)

**Colori Up & Down**

Le opzioni di **colore Up** e **Down** selezionano i colori da utilizzare quando il movimento del prezzo è al rialzo o al ribasso. La *strategia cromatica* di cui sopra determinerà se utilizzare il movimento dei prezzi interperiodico o interperiodico per selezionare il colore della candela o della barra OHLC.

**Apri, Alto, Basso, Chiudi**

Il pannello a candela tenterà di mappare i campi alla dimensione appropriata. Le opzioni **Apri**, **Alto**, **Basso** e **Chiudi** consentono di mappare i dati a queste dimensioni se il pannello non è in grado di farlo.

**Nota**  
Questi valori sono nascosti dalla legenda.
+ **Open** corrisponde al valore iniziale del periodo specificato.
+ **Alto** corrisponde al valore più alto del periodo specificato.
+ **Basso** corrisponde al valore più basso del periodo specificato.
+ **Close** corrisponde al valore finale (finale) del periodo specificato.
+ **Il volume** corrisponde al numero di campioni nel periodo indicato. (ad esempio numero di operazioni)

**Campi aggiuntivi**

Il pannello a candela si basa sul pannello delle serie temporali. Può visualizzare dimensioni di dati aggiuntive oltre a apertura, massimo, minimo, chiusura e volume Le opzioni **Includi** e **Ignora** consentono al pannello di visualizzare altri dati inclusi come medie mobili semplici, bande di Bollinger e altro, utilizzando gli stessi stili e configurazioni disponibili in. [Pannello delle serie temporali](v9-panels-time-series.md)

# Pannello in tela
<a name="v9-panels-canvas"></a>

****  
**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 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)

Canvas è un nuovo pannello che combina la potenza di Grafana con la flessibilità degli elementi personalizzati. Le visualizzazioni Canvas sono pannelli estensibili costruiti su moduli che consentono di posizionare in modo esplicito gli elementi all'interno di layout statici e dinamici. Ciò consente di progettare visualizzazioni personalizzate e sovrapporre dati in modi impossibili con i pannelli Grafana standard, il tutto all'interno dell'interfaccia utente di Grafana. Se hai utilizzato i più diffusi strumenti di interfaccia utente e web design, la progettazione di pannelli Canvas ti sembrerà molto familiare.

## Elementi
<a name="v9-panels-canvas-elements"></a>

**Valore del parametro**

L'elemento del valore metrico consente di selezionare facilmente i dati che si desidera visualizzare su canvas. Questo elemento ha una modalità di «modifica» unica che può essere attivata tramite l'opzione «Modifica» del menu contestuale o facendo doppio clic. In modalità di modifica, è possibile selezionare i dati del campo che si desidera visualizzare.

**Text (Testo)**

L'elemento di testo consente di aggiungere facilmente testo all'area di disegno. L'elemento supporta anche una modalità di modifica, attivabile facendo doppio clic o utilizzando l'opzione del menu di modifica nel menu contestuale.

**Rettangolo**

L'elemento rettangolare consente di aggiungere un rettangolo di base alla tela. Gli elementi rettangolari supportano la visualizzazione di testo (sia dati fissi che di campo) e possono cambiare il colore di sfondo in base alle soglie di dati.

**Icona**

L'elemento icona consente di aggiungere un'icona supportata all'area di disegno. Le icone possono avere il loro colore impostato in base a soglie o mappature di valori.

## Modifica della tela
<a name="v9-panels-canvas-editing"></a>

**Editor in linea**

Canvas introduce una nuova esperienza di modifica. Ora puoi modificare il pannello canvas in linea mentre sei nel contesto della modalità dashboard.

**Menu contestuale**

Il menu contestuale consente di accedere alle attività più comuni. Le funzionalità supportate includono l'apertura e la chiusura dell'editor in linea, la duplicazione di un elemento, l'eliminazione di un elemento e altro ancora.

Il menu contestuale viene attivato facendo clic con il pulsante destro del mouse sul pannello o su un determinato elemento della tela. Facendo clic con il pulsante destro del mouse sul pannello, è possibile impostare un'immagine di sfondo e aggiungere facilmente elementi alla tela.

Facendo clic con il pulsante destro del mouse su un elemento, è possibile modificare, eliminare e duplicare l'elemento o modificare il posizionamento dei livelli dell'elemento.

## Opzioni Canvas
<a name="v9-panels-canvas-options"></a>

**Modifica in linea**

L'interruttore di modifica in linea consente di bloccare o sbloccare il pannello canvas. Quando è spento, il pannello canvas si blocca, *bloccando* gli elementi al loro posto e impedendo modifiche involontarie.

# Pannello dell'orologio
<a name="v9-panels-clock"></a>

****  
**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 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)

Il pannello dell'orologio mostra l'ora corrente o un conto alla rovescia. Si aggiorna ogni secondo.
+ **Modalità**: l'impostazione predefinita è l'**ora**. Se scegli il **conto alla rovescia**, imposta la **scadenza del conto alla rovescia** per iniziare il conto alla rovescia.
+ **12 o 24 ore: le opzioni per mostrare l'ora** sono il formato 12 ore e il formato 24 ore.
+ **Fuso orario**: i fusi orari sono forniti dalla libreria moment timezone. L'impostazione predefinita è il fuso orario del computer.
+ **Scadenza del conto alla rovescia****: specifica l'ora e la data in cui eseguire il conto alla rovescia, se hai impostato la **modalità** sul conto alla rovescia.**
+ **Testo di fine del conto alla rovescia**: specifica il testo da mostrare al termine del conto alla rovescia.
+ **Opzioni di formattazione data/ora: personalizza** la dimensione, lo spessore e la formattazione del carattere. date/time Se stai visualizzando un conto alla rovescia e non vuoi vedere i secondi che scorrono, modifica il formato dell'ora impostandolo per l'orologio a 24 ore o `hh:mm` per l'orologio a 12 ore. `h:mm A` [Per un elenco completo delle opzioni, consulta Display.](https://momentjs.com/docs/#/displaying/)
+ **Bg Color**: seleziona un colore di sfondo per l'orologio.

# Elenco dashboard
<a name="v9-panels-dashboard-list"></a>

****  
**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 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)

La visualizzazione dell'elenco delle dashboard consente di visualizzare collegamenti dinamici ad altre dashboard. L'elenco può essere configurato per utilizzare dashboard con stelle, dashboard visualizzate di recente, una query di ricerca e tag di dashboard.

A ogni caricamento della dashboard, questo pannello interroga l'elenco delle dashboard, fornendo sempre il maggior numero di risultati. up-to-date

**Opzioni**

Utilizza queste opzioni per perfezionare la visualizzazione.
+ **Speciali: visualizza i dashboard contrassegnati** con stelle in ordine alfabetico.
+ Visualizzate di **recente**: mostra le dashboard visualizzate di recente in ordine alfabetico.
+ **Ricerca**: visualizza le dashboard in base a query di ricerca o tag. È necessario inserire almeno un valore in **Query** o **Tags**. Per i campi **Query** e **Tags**, è supportata l'interpolazione variabile, `$my_var` ad esempio o. `${my_var}`
+ **Mostra titoli**: la selezione dell'elenco selezionata (Specializzato, Visualizzato di recente, Cerca) viene mostrata come titolo.
+ **Numero massimo di elementi**: imposta il numero massimo di elementi da elencare per sezione. Ad esempio, se lo lasci al valore predefinito di 10 e visualizzi le dashboard con Preferiti e Visualizzate di recente, il pannello mostrerà fino a 20 dashboard totali, dieci per sezione.

**Cerca**

Queste opzioni si applicano solo se è selezionata l'opzione **Cerca**.
+ **Interrogazione**: inserisci la query in base alla quale desideri eseguire la ricerca. Le interrogazioni non fanno distinzione tra maiuscole e minuscole e i valori parziali sono accettati.
+ **Cartella**: seleziona le cartelle del dashboard che desideri visualizzare.
+ **Tag**: qui puoi inserire i tag in base ai quali desideri effettuare la ricerca. I tag esistenti non verranno visualizzati durante la digitazione e *fanno* distinzione tra maiuscole e minuscole.

**Nota**  
Quando vengono visualizzati più tag e stringhe, l'elenco della dashboard mostra quelli che soddisfano *tutte le* condizioni.

# Pannello del calibro
<a name="v9-panels-gauge"></a>

****  
**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 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)

Gauge è una visualizzazione a valore singolo che può ripetere un indicatore per ogni serie, colonna o riga.

**Opzioni di valore**

Utilizza le seguenti opzioni per rifinire il modo in cui la visualizzazione mostra il valore:

**Mostra**

Scegli come Grafana visualizza i tuoi dati.

**Calcola**

Mostra un valore calcolato basato su tutte le righe.
+ **Calcolo**: seleziona una funzione di riduzione che Grafana utilizzerà per ridurre molti campi a un unico valore. Per un elenco dei calcoli disponibili, fare riferimento a. [Tipi di calcolo](v9-panels-calculation-types.md)
+ **Campi**: seleziona i campi da visualizzare nel pannello.

**Tutti i valori**

Mostra una statistica separata per ogni riga. Se selezioni questa opzione, puoi anche limitare il numero di righe da visualizzare.
+ **Limite**: il numero massimo di righe da visualizzare. Il valore predefinito è 5.000.
+ **Campi**: seleziona i campi da visualizzare nel pannello.

**Gauge**

Regola la modalità di visualizzazione dell'indicatore.
+ **Mostra etichette di soglia**: controlla se vengono visualizzati i valori di soglia.
+ **Mostra indicatori di soglia**: controlla se viene visualizzata una banda di soglia al di fuori della banda di valori dell'indicatore interno.

**Dimensione del testo**

Regola le dimensioni del testo dell'indicatore.
+ **Titolo**: inserisci un valore numerico per la dimensione del titolo dell'indicatore.
+ **Valore**: immettere un valore numerico per la dimensione del valore dell'indicatore.

# Pannello Geomap
<a name="v9-panels-geomap"></a>

****  
**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 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)

La visualizzazione del pannello Geomap consente di visualizzare e personalizzare la mappa del mondo utilizzando dati geospaziali. Puoi configurare vari stili di sovrapposizione e impostazioni di visualizzazione della mappa per concentrarti facilmente sulle importanti caratteristiche dei dati basate sulla posizione.

## Vista mappa
<a name="v9-panels-geomap-view"></a>

La visualizzazione della mappa controlla la visualizzazione iniziale della mappa quando viene caricata la dashboard.

**Vista iniziale**

La vista iniziale configura il modo in cui il GeoMap pannello viene renderizzato quando il pannello viene caricato per la prima volta.
+ La **visualizzazione** imposta il centro della mappa quando il pannello viene caricato per la prima volta.
  + **Adatta ai dati** si adatta alla visualizzazione della mappa in base alle estensioni dei dati dei livelli della mappa e si aggiorna quando i dati cambiano.
    + L'opzione **Data** consente di selezionare l'estensione in base ai dati di «Tutti i livelli», un singolo «Livello» o «Ultimo valore» di un livello selezionato.
    + Il **livello** può essere selezionato se si adattano i dati da un singolo «Livello» o dall' «Ultimo valore» di un livello.
    + Il **riempimento** imposta il riempimento in percentuale relativa oltre all'estensione dei dati (non disponibile solo se si considera «Ultimo valore»).
    + **Max Zoom** imposta il livello di zoom massimo durante l'adattamento dei dati.
  + **Coordinates** imposta la visualizzazione della mappa in base a:
    + **Latitudine**
    + **Longitudine**
  + Sono disponibili anche viste predefinite, tra cui:
    + **(0°, 0°)**
    + **Nord America**
    + **Sud America**
    + **Europa**
    + **Africa**
    + **Asia occidentale**
    + **Asia meridionale**
    + **Sud-est asiatico**
    + **Asia orientale**
    + **Australia**
    + **Oceania**
+ **Zoom** imposta il livello di zoom iniziale.

## Livelli della mappa
<a name="v9-panels-geomap-layers"></a>

La visualizzazione Geomap supporta la visualizzazione di più livelli. Ogni livello determina il modo in cui vengono visualizzati i dati geospaziali sulla parte superiore della mappa di base.

**Tipi**

Nella visualizzazione Geomap sono disponibili tre tipi di layer cartografici tra cui scegliere.
+ [Layer di marker](#v9-panels-geomap-markers)esegue il rendering di un marker in ogni punto dati.
+ [Livello di mappa termica](#v9-panels-geomap-heatmap)visualizza una mappa termica dei dati.
+ [Strato GeoJSON](#v9-panels-geomap-geojson)esegue il rendering di dati statici da un file GeoJSON.

Esistono anche cinque tipi di layer attualmente in versione alfa.
+ [Livello notte/giorno (alfa)](#v9-panels-geomap-nightday)esegue il rendering di una regione notturna o diurna.
+ L'**icona all'ultimo punto (alfa)** esegue il rendering di un'icona nell'ultimo punto dati.
+ **Dynamic GeoJSON (alpha) definisce** lo stile di un file GeoJSON in base ai risultati delle query.
+ **Route (alpha)** esegue il rendering dei punti dati come percorso.
+ [Livello di foto (Alpha)](#v9-panels-geomap-photos)esegue il rendering di una foto in ogni punto dati.

**Controlli di livello**

I controlli dei livelli consentono di creare livelli, cambiarne il nome, riordinare ed eliminare i livelli.
+ **Aggiungi livello** crea un livello di dati aggiuntivo e configurabile per la visualizzazione Geomap. Quando aggiungi un livello, ti viene richiesto di selezionare un tipo di livello. È possibile modificare il tipo di livello in qualsiasi momento durante la configurazione del pannello. Consultate la precedente sezione **Tipi di livello** per i dettagli su ciascun tipo di livello.
+ I controlli dei livelli consentono di rinominare, eliminare e riordinare i livelli del pannello.
  + **Modifica il nome del livello** (icona a forma di matita) rinomina il livello.
  + **Trash Bin** elimina il livello.
  + **Reorder** (sei punti/maniglia) consente di modificare l'ordine dei livelli. I dati sui livelli superiori verranno visualizzati sopra i dati sui livelli inferiori. Il pannello aggiornerà l'ordine dei livelli durante il trascinamento per semplificare la scelta di un ordine dei livelli.

Puoi aggiungere più livelli di dati a un singolo pannello Geomap per creare visualizzazioni ricche e dettagliate.

**Location (Ubicazione)**

Il pannello Geomap necessita di una fonte di dati geografici. Questi dati provengono da una query del database e sono disponibili quattro opzioni di mappatura per i dati.
+ Ricerca **automaticamente** i dati sulla posizione. Utilizzate questa opzione quando la ricerca si basa su uno dei seguenti nomi per i campi dati.
  + geohash: «geohash»
  + latitudine: «latitudine», «lat»
  + longitudine: «longitudine», «lng», «lon»
  + lookup: «cerca»
+ **Coords** specifica che la tua query contiene dati di coordinate. Ti verrà richiesto di selezionare i campi di dati numerici per latitudine e longitudine dalla query del database.
+ **Geohash specifica che la tua query contiene dati geohash**. Ti verrà richiesto di selezionare un campo di dati di tipo stringa per il geohash dalla query del database.
+ La **ricerca** specifica che la query contiene i dati del nome della posizione che devono essere mappati su un valore. Ti verrà richiesto di selezionare il campo di ricerca dalla query del database e da un dizionario geografico. Il gazetteer è la directory utilizzata per mappare i dati richiesti su un punto geografico.

## Layer di marker
<a name="v9-panels-geomap-markers"></a>

Il livello marker consente di visualizzare i punti dati sotto forma di marker di diverse forme, ad esempio cerchi, quadrati, triangoli, stelle e altro.

I marker hanno molte opzioni di personalizzazione.
+ **Marker Color configura il colore** del marker. L'impostazione predefinita `Single color` mantiene tutti i punti di un unico colore. Esiste un'opzione alternativa per avere più colori a seconda dei valori dei punti dati e della soglia impostata nella `Thresholds` sezione.
+ **Marker Size** configura la dimensione del marker. L'impostazione predefinita è `Fixed size` che rende tutte le dimensioni dei marker uguali indipendentemente dai punti dati. Tuttavia, esiste anche un'opzione per ridimensionare i cerchi in base ai punti dati corrispondenti. `Min`e la dimensione del `Max` marker deve essere impostata in modo tale che il livello Marker possa scalare all'interno di questo intervallo.
+ **Marker Shape** consente di scegliere la forma, l'icona o l'elemento grafico per contribuire a fornire un contesto visivo aggiuntivo ai dati. Scegli tra le risorse incluse in Grafana, come forme semplici o la libreria Unicon. Puoi anche specificare un URL contenente una risorsa di immagini. L'immagine deve essere una grafica vettoriale scalabile (SVG).
+ **L'opacità di riempimento configura la trasparenza** di ogni marker.

## Livello di mappa termica
<a name="v9-panels-geomap-heatmap"></a>

Il livello di mappa termica raggruppa vari punti dati per visualizzare posizioni con densità diverse. Per aggiungere un livello di mappa termica:

Fai clic sul menu a discesa sotto Data Layer e scegli. `Heatmap`

Analogamente`Markers`, ti vengono richieste le opzioni per determinare quali punti dati visualizzare e come desideri visualizzarli.
+ **I valori di peso** configurano l'intensità dei cluster della mappa termica. `Fixed value`mantiene un valore di peso costante in tutti i punti dati. Questo valore deve essere compreso tra 0 e 1. Analogamente a Markers, esiste un'opzione alternativa nel menu a discesa per ridimensionare automaticamente i valori di peso in base ai valori dei dati.
+ **Radius** configura la dimensione dei cluster di mappe termiche.
+ **Blur** configura la quantità di sfocatura su ogni cluster.

## Strato GeoJSON
<a name="v9-panels-geomap-geojson"></a>

Il livello GeoJSON consente di selezionare e caricare un file GeoJSON statico dal filesystem.
+ **GeoJSON** URL offre una scelta di file GeoJSON forniti con Grafana.
+ **Lo stile predefinito** controlla gli stili da applicare quando nessuna delle regole precedenti corrisponde.
  + **Il colore** configura il colore dello stile predefinito
  + **L'opacità configura l'opacità** predefinita
+ **Le regole di stile** applicano gli stili in base alle proprietà delle caratteristiche
  + La **regola** consente di selezionare una *caratteristica*, una *condizione* e un *valore* dal file GeoJSON per definire una regola. L'icona del cestino può essere utilizzata per eliminare la regola corrente.
  + **Il colore** configura il colore dello stile per la regola corrente
  + **L'opacità** configura il livello di trasparenza per la regola corrente
+ **Aggiungi regola di stile crea regole** di stile aggiuntive.

## Strato CARTO
<a name="v9-panels-geomap-carto"></a>

Un livello CARTO proviene dalle mappe di base [CARTO Raster](https://carto.com/about-us/).

**Opzioni**
+ **Tema**

   Scegli un tema, un tema **chiaro**, un tema **scuro** o un tema **automatico**.
+ **Mostra etichette** mostra i dettagli del Paese nella parte superiore della mappa.
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Strato di piastrelle XYZ
<a name="v9-panels-geomap-xyz"></a>

Il tile layer XYZ è una mappa di un tile layer generico.

**Nota**  
Per ulteriori informazioni sui tile layer generici, vedere [Tiled Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) e [List of Open Street Map Tile](https://wiki.openstreetmap.org/wiki/Tile_servers) Servers.

**Opzioni**
+ **Modello di URL**
**Nota**  
Imposta un URL di tile server valido, con \$1z\$1/\$1x\$1/\$1y\$1 ad esempio:`https://tile.openstreetmap.org/{z}/{x}/{y}.png`.
+ L'**attribuzione** imposta la stringa di riferimento per il layer, se visualizzata nei controlli della [mappa](#v9-panels-geomap-controls)
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Apri il livello Street Map
<a name="v9-panels-geomap-osm"></a>

Una mappa tratta da [Open Street Map](https://www.openstreetmap.org/about), un database mondiale geografico collaborativo e gratuito.

**Opzioni**
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Livello ArcGIS
<a name="v9-panels-geomap-arcgis"></a>

[Un layer [ArcGIS è](https://services.arcgisonline.com/arcgis/rest/services) un layer proveniente da un ESRI ArcGIS.](https://www.esri.com/en-us/about/about-esri/overview) MapServer

**Opzioni**
+ **Istanza del server** da selezionare tra i seguenti tipi di mappa.
  + Mappa stradale mondiale
  + Immagini del mondo
  + Mondo fisico
  + Topografico
  + Topografica USA
  + Oceano mondiale
  + Personalizzato MapServer (vedi [XYZ](#v9-panels-geomap-xyz) per la formattazione)
    + Modello di URL
    + Attribuzione
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Livello notte/giorno (alfa)
<a name="v9-panels-geomap-nightday"></a>

Il livello Notte/Giorno mostra le regioni diurne e notturne in base all'intervallo di tempo corrente.

**Nota**  
Per ulteriori informazioni, [consultate Estensioni per OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

**Opzioni**
+ **Mostra** alterna la sorgente temporale dall'intervallo temporale del pannello
+ **Colore della regione notturna: seleziona il colore** per la regione notturna
+ **Display sun** alterna l'icona del sole
+ **Opacità** da 0 (trasparente) a 1 (opaco)

## Livello di foto (Alpha)
<a name="v9-panels-geomap-photos"></a>

Il livello Foto esegue il rendering di una foto in ogni punto dati.

**Nota**  
Per ulteriori informazioni, [consultate Estensioni per OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

**Opzioni**
+ **Campo di origine dell'immagine**

  Seleziona un campo stringa contenente dati di immagine in uno dei seguenti formati:
  + **Immagine URLs**
  + Immagine binaria **codificata Base64** () `data:image/png;base64,…`
+ **Tipo**

   seleziona lo stile della cornice attorno alle immagini
  + **Square**
  + **Circle** (Cerchio)
  + **Ancorato**
  + **Folio**
+ Attiva l'opzione **Ritaglia** se le immagini vengono ritagliate per adattarle
+ **Shadow**: attiva un riquadro (ombra) dietro le immagini
+ **Bordo**: imposta la dimensione del bordo attorno alle immagini
+ **Colore del bordo** imposta il colore del bordo attorno alle immagini
+ **Raggio**: imposta la dimensione complessiva delle immagini in pixel

## Controlli della mappa
<a name="v9-panels-geomap-controls"></a>

L'interfaccia dei controlli della mappa contiene le seguenti opzioni per le informazioni sulla mappa e le sovrapposizioni degli strumenti.

**Zoom**

Questa sezione descrive ciascuno dei controlli dello zoom.

*Mostra il controllo dello zoom*

Visualizza i controlli dello zoom nell'angolo superiore sinistro.

*Zoom con rotella del mouse*

Attiva o disattiva utilizzando la rotellina del mouse per ingrandire o ridurre.

**Mostra attribuzione**

Visualizza l'attribuzione per i layer della mappa di base sulla mappa.

**Mostra scala**

Visualizza le informazioni sulla scala nell'angolo inferiore sinistro.

**Nota**  
Visualizza le unità in [m]/[km].

**Mostra gli strumenti di misura**

Visualizza gli strumenti di misura nell'angolo superiore destro. Le misurazioni vengono visualizzate solo quando questo controllo è aperto.
+ **Fare clic** per iniziare a misurare
+ **Continua a fare clic** per continuare la misurazione
+ **Fate doppio clic** per terminare la misurazione

**Nota**  
Quando si modifica il tipo o le unità di misura, la misurazione precedente viene rimossa dalla mappa.  
Se il controllo viene chiuso e poi riaperto, viene visualizzata la misurazione più recente.  
Una misurazione può essere modificata facendo clic su di essa e trascinandola.

*Lunghezza*

Calcola la lunghezza sferica di una geometria. Questa lunghezza è la somma delle grandi distanze circolari tra le coordinate. Per le geometrie costituite da più parti, la lunghezza è la somma della lunghezza di ogni parte. Si presume che le geometrie siano in 'EPSG:3857'.

È possibile scegliere le seguenti unità per le misurazioni della lunghezza:
+ **Metrico (m/km)**
+ **Piedi (ft)**
+ **Miglia (mi)**
+ **Miglia nautiche (nmi)**

*Area*

Ottieni l'area sferica di una geometria. Quest'area viene calcolata supponendo che i bordi del poligono siano segmenti di grandi cerchi su una sfera. Si presume che le geometrie siano in 'EPSG:3857'.

È possibile scegliere le seguenti unità per la misurazione dell'area:
+ **Metri quadrati (m²)**
+ **Chilometri quadrati (km²)**
+ **Piedi quadrati (ft²)**
+ **Miglia quadrate (mi²)**
+ **Acri (acri)**
+ **Ettaro (ha)**

**Mostra debug**

Visualizza le informazioni di debug nell'angolo superiore destro della mappa. Ciò può essere utile per eseguire il debug o la convalida di un'origine dati.
+ **Zoom** mostra il livello di zoom corrente della mappa.
+ **Centro** mostra la **longitudine** e la **latitudine** correnti del centro della mappa.

**Tooltip**
+ **Nessuno visualizza le descrizioni dei** comandi solo quando si fa clic su un punto dati.
+ **Details** visualizza le descrizioni dei comandi quando un puntatore passa sopra un punto dati.

# Pannello grafico
<a name="v9-panels-graph"></a>

****  
**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 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)

Un pannello grafico può essere visualizzato come una linea, un percorso di punti o una serie di barre. Questo tipo di grafico è abbastanza versatile da visualizzare quasi tutti i dati di serie temporali.

## Opzioni relative ai dati e ai campi
<a name="v9-panels-graph-data-and-field-options"></a>

Quando si utilizzano visualizzazioni grafiche, è possibile applicare le seguenti opzioni:
+  [Trasformazione dei dati](v9-panels-xform.md) 
+ Avvisi. Questo è l'unico tipo di visualizzazione che consente di impostare avvisi. Per ulteriori informazioni, consulta [Avvisi nella versione 9 di Grafana](v9-alerts.md).
+  [Configurare le soglie](v9-panels-configure-thresholds.md) 

## Opzioni di visualizzazione
<a name="v9-panels-graph-display-options"></a>

Per perfezionare la visualizzazione, utilizza le seguenti impostazioni:
+  **Barre**: visualizza i valori come grafico a barre. 
+  **Linee**: visualizza i valori come grafico a linee. 
+  **Larghezza della linea**: specifica la larghezza della linea per una serie. Il valore di default è 1.
+  **Scala**: disegna i punti adiacenti come scala.
+  **Riempimento dell'area**: specifica la quantità di riempimento a colori per una serie. L'impostazione predefinita è 1; 0 è nessuna.
+  **Gradiente di riempimento**: specifica il grado di sfumatura sull'area di riempimento. L'impostazione predefinita è 0, che non indica alcun gradiente; 10 è un gradiente ripido.
+  **Punti: visualizza i punti** per i valori. 
+  **Raggio del punto**: controlla la dimensione dei punti.
+  **Soglie di avviso: visualizza le** soglie di avviso e le regioni sul pannello.

### Impilamento e valore nullo
<a name="v9-panels-graph-stacking-and-null-value"></a>
+  **Pila**: ogni serie è impilata sopra l'altra.
+  **Percentuale**: ogni serie viene estratta come percentuale del totale di tutte le serie. Questa opzione è disponibile quando è selezionato **Stack**.
+  **Valore nullo**: specifica come vengono visualizzati i valori nulli. *Si tratta di un'impostazione importante.* Vedi la nota riportata di seguito.
  +  **connesso**: se nella serie è presente uno spazio vuoto, ovvero uno o più valori nulli, la riga salterà lo spazio vuoto e si connetterà al valore successivo non nullo. 
  +  **null** Se nella serie è presente uno spazio vuoto, ovvero un valore nullo, la riga del grafico verrà interrotta e mostrerà lo spazio vuoto. Questa è l'impostazione predefinita.
  +  **null as zero** — Se c'è uno spazio vuoto nella serie, ossia un valore nullo, questo verrà visualizzato come valore zero nel pannello grafico.

**Importante**  
Se state monitorando il carico della CPU di un server e il carico raggiunge il 100%, il server si bloccherà e l'agente che invia le statistiche non sarà in grado di raccogliere le statistiche di carico. Ciò comporta una lacuna nelle metriche e l'utilizzo dell'impostazione *null* predefinita significa che Amazon Managed Grafana mostrerà le lacune e indicherà che qualcosa non va. Se è impostato su *connesso*, sarà facile perdere questo segnale. 

### Posiziona il mouse sul tooltip
<a name="v9-panels-graph-hover-tooltip"></a>

Usa queste impostazioni per modificare l'aspetto del tooltip che appare quando ti fermi sulla visualizzazione del grafico.
+  **Modalità**: determina il numero di serie visualizzate dal tooltip posizionato al passaggio del mouse.
  +  **Tutte le serie**: il tooltip al passaggio del mouse mostra tutte le serie nel grafico. Nell'elenco delle serie nel tooltip, l'area di lavoro Grafana evidenzia in grassetto la serie su cui stai facendo una pausa.
  +  **Singola**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui stai facendo una pausa nel grafico.
+  **Ordinamento: ordina** **l'ordine delle serie nel tooltip posizionato al passaggio del mouse se è stata selezionata la modalità Tutte le serie.** Quando fai una pausa su un grafico, Amazon Managed Grafana mostra i valori associati alle linee. In genere, gli utenti sono più interessati ai valori più alti o più bassi. L'ordinamento di questi valori può semplificare notevolmente la ricerca dei dati desiderati.
  +  **Nessuno**: l'ordine delle serie nel tooltip è determinato dal tipo di ordinamento della query. Ad esempio, è possibile ordinare la serie alfabeticamente in base al nome della serie.
  +  **Crescente**: le serie nel tooltip al passaggio del mouse vengono ordinate per valore e in ordine crescente, con il valore più basso nella parte superiore dell'elenco.
  +  **Decrescente**: le serie presenti nel tooltip al passaggio del mouse sono ordinate per valore e in ordine decrescente, con il valore più alto in cima all'elenco.

## Sostituzioni delle serie
<a name="v9-panels-graph-series-overrides"></a>

Le sostituzioni delle serie consentono di renderizzare una serie in un pannello grafico in modo diverso dalle altre. È possibile personalizzare le opzioni di visualizzazione in base alla serie o utilizzando le regole regex. Ad esempio, una serie può avere una larghezza di linea più spessa per farla risaltare o essere spostata sull'asse Y destro.

È possibile aggiungere più sostituzioni di serie.

**Per aggiungere una sovrascrittura di serie**

1. Scegli **Aggiungi sovrascrittura alla serie**.

1. In **Alias o regex**, digita o seleziona una serie. Scegli il campo per visualizzare un elenco delle serie disponibili.

   Ad esempio, `/Network.*/` corrisponderebbe a due serie denominate `Network out` e`Network in`.

1. Scegliete **\$1**, quindi selezionate uno stile da applicare alla serie. Puoi aggiungere più stili a ogni voce.
+  **Barre**: mostra le serie come grafico a barre. 
+  **Linee**: mostra le serie come grafico a linee. 
+  **Riempimento a linee**: mostra un grafico a linee con riempimento ad area. 
+  **Gradiente di riempimento: specifica la quantità del gradiente** di riempimento dell'area.
+  **Larghezza della linea: imposta lo spessore della linea**.
+  **Modalità punto nullo**: utilizzate questa opzione per ignorare i valori nulli o sostituirli con zero. Questo è importante se vuoi ignorare le lacune nei dati.
+  **Compila di seguito per**: riempi l'area tra due serie.
+  **Linea della scala**: mostra la serie come linea di scala.
+  **Trattini**: mostra una linea con trattini. 
+  **Hidden Series**: nasconde la serie. 
+  **Lunghezza trattino**: imposta la lunghezza dei trattini nella linea.
+  **Dash Space**: imposta la lunghezza degli spazi tra i trattini della linea.
+  **Punti**: mostra le serie come punti separati.
+  **Raggio del punto**: imposta il raggio per il rendering dei punti.
+  **Pila**: imposta il gruppo di pila per la serie.
+  **Colore**: imposta il colore della serie.
+  **Asse Y: imposta l'asse** y della serie.
+  **Z-index** — Imposta lo z-index della serie (ordine di rendering). Questa opzione è importante quando si sovrappongono stili diversi, come grafici a barre e grafici ad area.
+  Trasforma: trasforma il valore in negativo per renderlo al di sotto dell'asse y.
+  **Legenda**: controlla se una serie viene mostrata nella legenda.
+  **Nascondi nel tooltip**: controlla se una serie viene mostrata in un tooltip grafico.

## Axes (Asse)
<a name="v9-panels-graph-axes"></a>

Utilizzate queste opzioni per controllare la visualizzazione degli assi nella visualizzazione.

### Y a sinistra Y/Right
<a name="v9-panels-graph-left-yright-y"></a>

Le opzioni sono identiche per entrambi gli assi y.
+  **Mostra**: scegli di mostrare o nascondere l'asse.
+  **Unità**: scegli l'unità di visualizzazione per il valore y.
+  **Scala**: scegli la scala da usare per il valore y: **lineare** o **logaritmica**. **L'impostazione predefinita è lineare.**
+  **Y-Min** — Il valore y minimo. L'impostazione predefinita è **auto**.
+  **Y-Max**: il valore Y massimo. L'impostazione predefinita è **auto**.
+  **Decimali**: definisce quanti decimali vengono visualizzati per il valore y. L'impostazione predefinita è **auto**. 
+  **Etichetta**: specifica l'etichetta dell'asse y. L'impostazione predefinita è «»,

### Assi Y
<a name="v9-panels-graph-y-axes"></a>
+  **Allinea: allinea** gli assi y sinistro e destro in base al valore. L'impostazione predefinita è unchecked/false.
+  **Livello**: immettete il valore da utilizzare per l'allineamento degli assi y sinistro e destro, a partire da Y=0. Il valore predefinito è 0. **Questa opzione è disponibile quando è selezionato Allinea.** 

### Asse X
<a name="v9-panels-graph-x-axis"></a>
+  **Mostra**: scegli di mostrare o nascondere l'asse.
+  **Modalità**: la modalità di visualizzazione modifica completamente la visualizzazione del pannello grafico. È come avere tre pannelli in uno. La modalità principale è la modalità serie temporale con il tempo sull'asse x. Le altre due modalità sono una modalità grafico a barre di base con serie sull'asse x anziché sul tempo e una modalità istogramma.
  +  **Ora** (impostazione predefinita): l'asse x rappresenta il tempo e i dati sono raggruppati per ora (ad esempio, per ora o per minuto).
  +  **Serie**: i dati sono raggruppati per serie e non per ora. L'asse y rappresenta ancora il valore.
    +  **Valore**: questo è il tipo di aggregazione da utilizzare per i valori. L'impostazione predefinita è **totale** (somma dei valori).
  +  **Istogramma**: questa opzione converte il grafico in un istogramma. Un istogramma è un tipo di grafico a barre che raggruppa i numeri in intervalli, spesso chiamati secchi o contenitori. Le barre più alte indicano che in quell'intervallo rientrano più dati.

    Per ulteriori informazioni sugli istogrammi, vedere. [Introduzione agli istogrammi e alle mappe di calore](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)
    +  **Bucket: imposta** il numero di bucket in base ai quali raggruppare i valori. Se lasciato vuoto, Amazon Managed Grafana prova a calcolare un numero adeguato di bucket.
    +  **X-Min**: filtra dall'istogramma i valori inferiori a questo limite minimo.
    +  **X-Max**: filtra i valori superiori a questo limite massimo.

## Legenda
<a name="v9-panels-graph-legend"></a>

Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.

### Opzioni
<a name="v9-panels-graph-legends-options"></a>
+  **Mostra**: deseleziona per nascondere la legenda. L'impostazione predefinita è selezionata (true).
+  **Come tabella**: selezionare per visualizzare la legenda nella tabella. L'impostazione predefinita è selezionata (true).
+  **A destra**: selezionare per visualizzare la legenda a destra.
+  Larghezza: immetti la larghezza minima per la legenda in pixel. Questa opzione è disponibile quando è selezionata **l'opzione A destra**.

### Valori
<a name="v9-panels-graph-values"></a>

È possibile visualizzare valori aggiuntivi accanto ai nomi delle legende.
+  **Min**: il valore minimo restituito dalla query metrica.
+  **Max**: il valore massimo restituito dalla query metrica.
+  **Media**: il valore medio restituito dalla query metrica.
+  **Corrente**: l'ultimo valore restituito dalla query metrica.
+  **Totale**: la somma di tutti i valori restituiti dalla query metrica.
+  **Decimali: quanti decimali** vengono visualizzati per i valori delle legende e le descrizioni dei comandi al passaggio del mouse sul grafico.

Amazon Managed Grafana calcola i valori della legenda sul lato client. Questi valori della legenda dipendono dal tipo di aggregazione o consolidamento dei punti utilizzato dalla query metrica. Tutti i valori della legenda sopra riportati non possono essere corretti contemporaneamente.

Ad esempio, se si traccia una frequenza di questo tipo richieste/secondo, utilizzando probabilmente la media come aggregatore, il totale nella legenda non rappresenterà il numero totale di richieste. È solo la somma di tutti i punti dati ricevuti da Amazon Managed Grafana. 

### Nascondi serie
<a name="v9-panels-graph-hide-series"></a>

Nasconde le serie quando tutti i valori di una serie di una query metrica hanno un valore specifico.
+  **Con solo valori null**: value=NULL (impostazione predefinita deselezionata)
+  **Con solo zeri: value=ZERO** (impostazione predefinita deselezionata)

### Regioni temporali
<a name="v9-panels-graph-time-regions"></a>

È possibile evidenziare aree temporali specifiche sul grafico per facilitare la visualizzazione, ad esempio, dei fine settimana, degli orari lavorativi e degli orari non lavorativi. Tutte le aree temporali configurate si riferiscono all'ora UTC.

# Pannello Heatmap
<a name="v9-panels-heatmap"></a>

****  
**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 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)

La visualizzazione del pannello Heatmap consente di visualizzare gli istogrammi nel tempo. Per ulteriori informazioni sugli istogrammi, fare riferimento a. [Introduzione agli istogrammi e alle mappe di calore](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

## Calcola a partire dai dati
<a name="v9-panels-heatmap-calculate"></a>

Questa impostazione determina se i dati sono già una mappa termica calcolata (dalla sorgente/trasformatore di dati) o una mappa che deve essere calcolata nel pannello.

**X Bucket**

Questa impostazione determina come l'asse X viene suddiviso in secchi. **È possibile specificare un intervallo di tempo nell'input Size.** Ad esempio, un intervallo di tempo di `1h` rende le celle larghe 1 ora sull'asse X.

**Secchio Y**

Questa impostazione determina come l'asse Y viene suddiviso in secchi.

**Scala Y Bucket**

Seleziona una delle seguenti scale di valori dell'asse Y:
+ **lineare**: scala lineare.
+ **log (base 2)** — Scala logaritmica con base 2.
+ **log (base 10)** — Scala logaritmica con base 10.

## Assi Y
<a name="v9-panels-heatmap-y-axes"></a>

Definisce come viene visualizzato l'asse Y

 **Posizionamento**
+ **Sinistra**: a sinistra
+ **Destra**: a destra
+ **Nascosto**: nascosto

**Unità**

Configurazione dell'unità

**Decimali**

Questa impostazione determina la configurazione decimale.

**Valore min/max**

Questa impostazione configura l'intervallo degli assi.

**Inverso**

Se selezionato, l'asse appare in ordine inverso.

## Colori
<a name="v9-panels-heatmap-colors"></a>

Lo spettro dei colori controlla la mappatura tra il conteggio dei valori (in ogni bucket) e il colore assegnato a ciascun bucket. Il colore più a sinistra dello spettro rappresenta il conteggio minimo e il colore sul lato più a destra rappresenta il conteggio massimo. Alcune combinazioni di colori vengono automaticamente invertite quando si utilizza il tema della luce.

Puoi anche cambiare la modalità colore in Opacità. In questo caso, il colore non cambierà, ma la quantità di opacità cambierà con il numero di bucket
+ **Mode** (Modalità)
  + **Schema**: valore del bucket rappresentato dal colore della cella.
    + **Schema**: se la modalità è **schema**, seleziona una combinazione di colori.
  + **opacità**: valore del bucket rappresentato dall'opacità della cella. La cella opaca indica il valore massimo.
    + **Colore: colore** di base della cella.
    + **Scala**: scala per mappare i valori del bucket all'opacità.
      + lineare: **scala lineare**. Il valore del bucket viene mappato linearmente all'opacità.
      + **sqrt** — Scala di potenza. **Opacità delle celle calcolata come`value ^ k`, dove `k` è un valore esponenziale configurato.** Se l'esponente è inferiore a`1`, si otterrà una scala logaritmica. Se l'esponente è maggiore di`1`, otterrai una scala esponenziale. In caso di`1`, la scala sarà la stessa di quella lineare.
    + **Esponente**: valore dell'esponente, maggiore di. `0`

**Colore iniziale/finale a partire dal valore**

Per impostazione predefinita, Grafana calcola i colori delle celle in base ai valori minimi e massimi del bucket. Con Min e Max puoi sovrascrivere questi valori. Considerate il valore del bucket come asse Z e Min e Max come Z-Min e Z-Max, rispettivamente.
+ **Inizio**: valore minimo utilizzato per il calcolo del colore delle celle. Se il valore del bucket è inferiore a Min, viene mappato sul colore «minimo». Il valore minimo della serie è il valore predefinito.
+ **Fine**: valore massimo utilizzato per il calcolo del colore delle celle. Se il valore del bucket è maggiore di Max, viene mappato al colore «massimo». Il valore massimo della serie è il valore predefinito.

## Visualizzazione delle celle
<a name="v9-panels-heatmap-cell"></a>

Usa le impostazioni di visualizzazione delle celle per affinare la visualizzazione delle celle nella tua mappa termica.

## Opzioni di visualizzazione aggiuntive
<a name="v9-panels-heatmap-options"></a>

**Tooltip**
+ **Mostra tooltip** — Mostra il tooltip della heatmap.
+ **Mostra istogramma: mostra un istogramma** dell'asse Y sulla descrizione del comando. Un istogramma rappresenta la distribuzione dei valori del bucket per un timestamp specifico.

**Legenda**

Scegli se visualizzare la legenda della mappa termica sulla visualizzazione.

**Esemplari**

Imposta il colore usato per mostrare i dati del campione.

# Pannello istogramma
<a name="v9-panels-histogram"></a>

****  
**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 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)

La visualizzazione dell'istogramma calcola la distribuzione dei valori e li presenta come un grafico a barre. L'asse Y e l'altezza di ogni barra rappresentano il conteggio dei valori che rientrano in ciascuna parentesi, mentre l'asse X rappresenta l'intervallo di valori.

La visualizzazione dell'istogramma supporta le serie temporali e qualsiasi risultato di tabella con uno o più campi numerici.

## Formati supportati
<a name="v9-panels-histogram-formats"></a>

La visualizzazione dell'istogramma supporta le serie temporali e qualsiasi risultato di tabella con uno o più campi numerici.

## Opzioni di visualizzazione
<a name="v9-panels-histogram-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Dimensioni del secchio**

La dimensione dei secchi. Lascialo vuoto per il dimensionamento automatico dei secchi (\$1 10% dell'intera gamma).

**Offset del secchio**

Se il primo bucket non deve iniziare da zero. Un offset diverso da zero sposta la finestra di aggregazione. Ad esempio, i bucket di 5 dimensioni che sono 0—5, 5—10, 10—15 con un offset predefinito pari a 0 diventerebbero 2—7, 7—12, 12—17 con un offset di 2; offset di 0, 5 o 10, in questo caso, di fatto non servirebbero a nulla. In genere, questa opzione verrebbe utilizzata con una dimensione del bucket definita in modo esplicito anziché in modo automatico. Affinché questa impostazione abbia effetto, la quantità di offset deve essere maggiore di 0 e minore della dimensione del bucket; i valori al di fuori di questo intervallo avranno lo stesso effetto dei valori all'interno di questo intervallo.

**Combina serie**

Questo unirà tutte le serie e i campi in un istogramma combinato.

**La larghezza della linea** controlla la larghezza della linea delle barre.

**L'opacità di riempimento** controlla l'opacità di riempimento delle barre.

La modalità **gradiente imposta la modalità di riempimento** del gradiente. Il gradiente di riempimento si basa sul colore della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard. L'aspetto del gradiente è influenzato dall'impostazione dell'opacità di riempimento.
+  **Nessuno**: nessun riempimento a gradiente, questa è l'impostazione predefinita.
+  **Opacità: la** trasparenza del gradiente viene calcolata in base ai valori sull'asse Y. L'opacità del riempimento aumenta con i valori sull'asse Y.
+  **Tonalità**: il colore del gradiente viene generato in base alla tonalità del colore della linea.

**Modalità tooltip** Quando si posiziona il cursore sul grafico, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip:
+  **Singola**: il tooltip al passaggio del mouse mostra solo la serie su cui stai passando il mouse.
+  **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie presenti nella visualizzazione. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+  **Nascosto**: non visualizza il tooltip. 

**Nota**  
Utilizzate un override per nascondere le singole serie dal tooltip.

## Opzioni relative alla legenda
<a name="v9-panels-histogram-legend"></a>

Quando l'opzione legenda è abilitata, può mostrare le mappature dei valori o le parentesi di soglia. Per mostrare le mappature dei valori nella legenda, è importante che l'opzione Combinazione di colori nelle opzioni standard sia impostata su Colore singolo o Palette classica. Per visualizzare le parentesi di soglia nella legenda, impostate lo schema di colori su Dalle soglie.

**Modalità Legenda** Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Si tratta di una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda** Scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

**Valori della legenda**

Scegli quale dei calcoli standard mostrare nella legenda. Puoi averne più di uno. Per ulteriori informazioni, consulta [Tipi di calcolo](v9-panels-calculation-types.md).

**Calcoli delle legende**

Scegli quali calcoli mostrare nella legenda. Puoi selezionarne più di uno.

# Pannello Logs
<a name="v9-panels-logs"></a>

****  
**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 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)

La visualizzazione del pannello dei log mostra le righe di registro provenienti da fonti di dati che supportano i log, come Elastic, Influx e Loki. In genere, si utilizza questo pannello accanto a un pannello grafico per visualizzare l'output del registro di un processo correlato.

Il pannello dei log mostra il risultato delle interrogazioni inserite nella scheda **Query**. I risultati di più interrogazioni vengono uniti e ordinati per ora. Puoi scorrere all'interno del pannello se la sorgente dati restituisce più righe di quelle visualizzabili.

Per limitare il numero di righe renderizzate, puoi utilizzare l'impostazione **Max data points** nelle **opzioni di interrogazione**. Se non è impostata, l'origine dati in genere impone un limite predefinito.

## Livello di log
<a name="v9-panels-logs-level"></a>

Per i log in cui è specificata un'etichetta di **livello**, utilizziamo 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, cerchiamo di scoprire se il suo contenuto corrisponde a una delle espressioni supportate (vedi sotto per maggiori informazioni). Il livello di registro è sempre determinato dalla prima corrispondenza. Nel caso in cui Grafana non sia in grado di determinare un livello di registro, verrà visualizzato con un livello di registro **sconosciuto**. Per ulteriori informazioni, consulta [Visualizzazione dei log](v9-explore-logs.md#v9-explore-logs-viz).

## Dettagli del registro
<a name="v9-panels-logs-details"></a>

Ogni riga di registro ha un'area estensibile con le relative etichette e i campi rilevati, per un'interazione più solida. Ogni campo o etichetta ha un'icona delle statistiche per visualizzare le statistiche relative a tutti i log visualizzati.

**Collegamenti dati**

Utilizzando i collegamenti dati, è possibile trasformare qualsiasi parte di un messaggio di registro in un collegamento interno o esterno. Il link creato è visibile come pulsante nella sezione **Collegamenti** all'interno della visualizzazione dei **dettagli del registro**.

**Opzioni di visualizzazione**

Utilizza le seguenti impostazioni per perfezionare la visualizzazione:
+  **Ora**: mostra o nasconde la colonna del tempo. Questo è il timestamp associato alla riga di registro riportata dalla fonte di dati.
+  **Etichette uniche**: mostra o nasconde la colonna delle etichette univoche, che mostra solo le etichette non comuni.
+ **Etichette comuni**: mostra o nasconde le etichette comuni
+  **Avvolgi linee**: attiva l'avvolgimento delle linee. 
+ **Prettify JSON**: imposta questa opzione per stampare correttamente tutti i `true` log JSON. Questa impostazione non influisce sui log in formati diversi da JSON.
+ **Abilita i dettagli del registro**: attiva l'opzione per visualizzare la visualizzazione dei dettagli del registro per ogni riga del registro. L'impostazione predefinita è `true`.
+  **Ordine**: mostra i risultati in ordine temporale decrescente o crescente. L'impostazione predefinita è **Decrescente, che** mostra per primi i log più recenti. Imposta su **Ascendente** per mostrare per prime le righe di registro più vecchie.

# Pannello delle notizie
<a name="v9-panels-news"></a>

****  
**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 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)

Questo pannello mostra un feed RSS. Per impostazione predefinita, visualizza articoli dal blog Grafana Labs.

**Inserisci l'URL di un RSS nella sezione Visualizza.** Questo tipo di pannello non accetta altre domande.

**Nota**  
I feed RSS vengono caricati dal front-end Grafana senza un proxy. [Di conseguenza, verranno caricati solo i feed RSS configurati con le intestazioni CORS appropriate.](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) Se il feed RSS che state cercando di visualizzare non viene caricato, prendete in considerazione la possibilità di riospitare il feed RSS o di creare un proxy personalizzato.

# Pannello grafico dei nodi
<a name="v9-panels-node-graph"></a>

****  
**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 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)

Il pannello del grafico dei nodi visualizza grafici o reti diretti. Utilizza il layout a forza diretta per posizionare efficacemente i nodi in modo da facilitare la visualizzazione di mappe infrastrutturali complesse, gerarchie o diagrammi di esecuzione.

## Requisiti dei dati
<a name="v9-panels-node-graph-requirements"></a>

Il pannello del grafico dei nodi richiede una forma specifica dei dati per poterne visualizzare i nodi e i bordi. Non tutte le fonti di dati o le query possono essere visualizzate in questo pannello.

*La visualizzazione del grafico dei nodi è composta da *nodi e bordi*.*
+ Un *nodo* viene visualizzato come un cerchio. Un nodo può rappresentare un'applicazione, un servizio o qualsiasi altra cosa rilevante dal punto di vista dell'applicazione.
+ Un *bordo* viene visualizzato come una linea che collega due nodi. La connessione potrebbe essere una richiesta, un'operazione o qualche altra relazione tra i due nodi.

Sia i nodi che i bordi possono avere metadati o statistiche associati. L'origine dati definisce quali informazioni e valori vengono visualizzati, quindi fonti di dati diverse possono mostrare tipi diversi di valori o non mostrare alcuni valori.

## Nodi
<a name="v9-panels-node-graph-nodes"></a>

Di solito, i nodi mostrano due valori statistici all'interno del nodo e due identificatori appena sotto il nodo, in genere nome e tipo. I nodi possono anche mostrare un altro set di valori sotto forma di un cerchio colorato attorno al nodo, con sezioni di colore diverso che rappresentano valori diversi che dovrebbero sommarsi a 1. Ad esempio, puoi avere la percentuale di errori rappresentata dalla parte rossa del cerchio.

Ulteriori dettagli possono essere visualizzati in un menu contestuale, che viene visualizzato quando si sceglie il nodo. Nel menu contestuale possono essere presenti anche collegamenti aggiuntivi che possono indirizzare ad altre parti dell'area di lavoro Grafana o a qualsiasi collegamento esterno.

**Nota**  
Il grafico dei nodi può mostrare solo 1.500 nodi. Se questo limite viene superato, viene visualizzato un avviso nell'angolo in alto a destra e alcuni nodi verranno nascosti. È possibile espandere le parti nascoste del grafico facendo clic sui marker **dei nodi nascosti** nel grafico.

## Edges
<a name="v9-panels-node-graph-edges"></a>

I bordi possono anche mostrare statistiche quando passi il mouse sopra il bordo. Analogamente ai nodi, è possibile aprire un menu contestuale con dettagli e collegamenti aggiuntivi scegliendo lo spigolo.

La prima fonte di dati che supporta questa visualizzazione è la fonte di AWS X-Ray dati per la sua funzionalità di mappa dei servizi. Per ulteriori informazioni, consulta [Connect a un'origine AWS X-Ray dati](x-ray-data-source.md).

## Navigazione nel grafico del nodo
<a name="v9-panels-node-graph-navigation"></a>

È possibile eseguire una panoramica all'interno del grafico del nodo selezionando una posizione esterna a qualsiasi nodo o bordo e trascinando il puntatore.

È possibile eseguire lo zoom utilizzando i pulsanti nell'angolo superiore sinistro del grafico del nodo.

**Nodi nascosti**

Il numero di nodi visualizzati in un determinato momento è limitato per mantenere prestazioni ragionevoli. I nodi che non rientrano in questo limite sono nascosti dietro dei marker cliccabili che mostrano un numero approssimativo di nodi nascosti collegati a quel bordo. Puoi scegliere il marker per espandere il grafico attorno a quel nodo.

**Visualizzazione a griglia**

Puoi passare alla visualizzazione a griglia per avere una panoramica migliore dei nodi più interessanti del grafico. La visualizzazione a griglia mostra i nodi in una griglia senza bordi e può essere ordinata in base alle statistiche mostrate all'interno del nodo o in base alle statistiche rappresentate dal bordo colorato dei nodi.

Per ordinare i nodi, scegli le statistiche all'interno della legenda. Il marker accanto al nome della statistica mostra quale statistica è attualmente utilizzata per l'ordinamento e la direzione di ordinamento.

Scegliete il nodo e poi l'opzione di **layout Mostra nel grafico** per tornare al layout del grafico concentrandovi sul nodo selezionato, per mostrarlo nel contesto del grafico completo.

## Data API (API dati).
<a name="v9-panels-node-graph-data-api"></a>

Questa visualizzazione richiede una forma specifica dei dati da restituire dalla fonte dei dati per visualizzarli correttamente.

Node Graph richiede almeno un frame di dati che descriva i bordi del grafico. Per impostazione predefinita, Node Graph calcolerà i nodi e tutte le statistiche basate su questo frame di dati. Facoltativamente, è possibile inviare un secondo frame di dati che descrive i nodi nel caso in cui sia necessario mostrare più metadati specifici del nodo. È necessario impostare `frame.meta.preferredVisualisationType = 'nodeGraph'` entrambi i frame di dati o assegnare loro un nome `nodes` e, `edges` rispettivamente, il rendering del grafico del nodo.

**Estrae i dati dalla struttura**

Campi obbligatori:


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
|  id  |  stringa  |  Identificatore univoco dello spigolo.  | 
|  origine  |  stringa  |  ID del nodo sorgente.  | 
|  target  |  stringa  |  Id del bersaglio.  | 

Campi opzionali:


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
|  mainstat  |  stringa/numero  |  Prima statistica mostrata nella sovrapposizione quando si passa il mouse sul bordo. Può essere una stringa che mostra il valore così com'è oppure può essere un numero. Se è un numero, viene mostrata anche qualsiasi unità associata a quel campo  | 
|  statistica secondaria  |  stringa/numero  |  Uguale a MainStat, ma mostrato proprio sotto.  | 
|  dettagli\$1\$1\$1  |  stringa/numero  |  Qualsiasi campo preceduto da `detail__` verrà mostrato nell'intestazione del menu contestuale quando si fa clic sul bordo. Usalo `config.displayName` per un'etichetta più leggibile dall'uomo.  | 

**Nodi, dati provenienti dalla struttura.**

Campi obbligatori:


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
|  id  |  stringa  |  Identificatore univoco del nodo. A questo ID viene fatto riferimento da edge nei campi di origine e destinazione.  | 

Campi opzionali:


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
|  titolo  |  stringa  |  Nome del nodo visibile appena sotto il nodo.  | 
|  Sottotitolo  |  stringa  |  Nome, tipo o altro identificatore aggiuntivo mostrato sotto il titolo.  | 
|  stativo principale  |  stringa/numero  |  Prima statistica mostrata all'interno del nodo stesso. Può essere una stringa che mostra il valore così com'è o un numero. Se è un numero, viene mostrata anche qualsiasi unità associata a quel campo.  | 
|  statistica secondaria  |  stringa/numero  |  Uguale a MainStat, ma mostrato sotto di esso all'interno del nodo.  | 
|  arc\$1\$1\$1  |  numero  |  Qualsiasi campo preceduto da `arc__` verrà utilizzato per creare il cerchio colorato attorno al nodo. La somma di tutti i valori in questi campi deve essere 1. È possibile specificare il colore utilizzando`config.color.fixedColor`.  | 
|  dettaglio\$1\$1\$1  |  stringa/numero  |  Qualsiasi campo preceduto da `detail__` verrà mostrato nell'intestazione del menu contestuale quando si fa clic sul nodo. Usalo `config.displayName` per un'etichetta più leggibile dall'uomo.  | 

# Pannello grafico a torta
<a name="v9-panels-piechart"></a>

****  
**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 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)

Il grafico a torta mostra le serie ridotte, o i valori di una serie, di una o più interrogazioni, in relazione tra loro, sotto forma di fette di torta. La lunghezza dell'arco, l'area e l'angolo centrale di una fetta sono tutti proporzionali al valore delle fette, in quanto si riferiscono alla somma di tutti i valori. Questo tipo di grafico viene utilizzato al meglio quando si desidera un confronto rapido di un piccolo insieme di valori in una forma esteticamente gradevole.

## Opzioni di valore
<a name="v9-panels-piechart-value"></a>

Utilizza le seguenti opzioni per affinare il valore della visualizzazione.

**Mostra**

Scegli quante informazioni mostrare.
+ **Calcola**: riduce ogni valore a un singolo valore per serie.
+ **Tutti i valori**: visualizza tutti i valori di una singola serie.

**Calcolo**

Seleziona un calcolo per ridurre ogni serie quando è stata selezionata l'opzione Calcola. Per informazioni sui calcoli disponibili, consulta [Tipi di calcolo](v9-panels-calculation-types.md).

**Limite**

Quando si visualizzano tutti i valori di una singola serie, ciò limita il numero di valori visualizzati.

**Campi**

Seleziona il campo o i campi da visualizzare nella visualizzazione. Ogni nome di campo è disponibile nell'elenco oppure puoi selezionare una delle seguenti opzioni:
+ **Campi numerici**: tutti i campi con valori numerici.
+ **Tutti i campi**: tutti i campi che non vengono rimossi dalle trasformazioni.
+ **Ora**: tutti i campi con valori temporali.

## Opzioni del grafico a torta
<a name="v9-panels-piechart-options"></a>

Utilizza queste opzioni per perfezionare l'aspetto della visualizzazione.

**Tipo di grafico a torta**

Seleziona lo stile di visualizzazione del grafico a torta. Può essere una delle seguenti:
+ **Pie**: un grafico a torta standard
+ **Donut**: un grafico a torta con un foro al centro

**Etichette**

Seleziona le etichette da visualizzare sul grafico a torta. Puoi selezionarne più di una.
+ **Nome**: il nome della serie o del campo.
+ **Percentuale**: la percentuale del totale.
+ **Valore**: il valore numerico grezzo.

Per impostazione predefinita, le etichette vengono visualizzate in bianco sul corpo del grafico. È possibile selezionare colori più scuri del grafico per renderli più visibili. I nomi o i numeri lunghi potrebbero essere tagliati.

**modalità Tooltip**

Quando si posiziona il cursore sulla visualizzazione, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip.
+ **Singolo**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui stai posizionando il mouse sulla visualizzazione.
+ **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie della visualizzazione. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+ **Nascosto**: non visualizza il tooltip quando interagisci con la visualizzazione.

Utilizzate un override per nascondere le singole serie dal tooltip.

**modalità Legend**

Utilizza queste impostazioni per definire come appare la legenda nella visualizzazione. Per ulteriori informazioni sulla legenda, consulta [Configurare una legenda](v9-panels-configure-legend.md).
+ **Elenco**: visualizza la legenda sotto forma di elenco. Si tratta di una modalità di visualizzazione predefinita della legenda.
+ **Tabella**: visualizza la legenda come tabella.
+ **Nascosto**: nasconde la legenda.

**Posizionamento della leggenda**

Scegli dove visualizzare la legenda.
+ **In basso**: sotto il grafico.
+ A **destra**: a destra del grafico.

**Valori della legenda**

Scegli quale dei [calcoli standard](v9-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

Seleziona i valori da visualizzare nella legenda. È possibile selezionarne più di uno.
+ **Percentuale**: la percentuale del totale.
+ **Valore**: il valore numerico grezzo.

Per ulteriori informazioni sulla legenda, consulta [Configurare una legenda](v9-panels-configure-legend.md).

# Pannello Plotly
<a name="v9-panels-plotly"></a>

****  
**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 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)

Il pannello Plotly esegue il rendering dei grafici utilizzando Plotly, una libreria grafica javascript [open source](https://plotly.com/javascript/).

I campi **Data**, **Layout** e **Config** corrispondono ai parametri comuni descritti nella documentazione di [Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Devono essere in formato JSON.

I dati forniti dall'origine dati possono essere trasformati tramite uno script definito dall'utente prima di essere inseriti nel grafico Plotly. Lo script include 2 argomenti.
+ `data`— Dati restituiti dalla fonte di dati.
+ `variables`— Un oggetto che contiene [le variabili Grafana](templates-and-variables.md) nella dashboard corrente (variabili utente e queste poche variabili globali:`__from`, `__to``__interval`, e`__interval_ms`).

Lo script deve restituire un oggetto con una o più delle seguenti proprietà: `data``layout`, `config` e`frames`. Di seguito è riportato un esempio di :

```
let x  = data.series[0].fields[0].values.buffer
let y  = data.series[0].fields[1].values.buffer
let serie = {
    x : x,
    y : y,
    name : variables.project //where project is the name of a Grafana’s variable
}

return {
    data : [serie],
    config : {
    displayModeBar: false
    }
}
```

L'oggetto restituito dallo script e il JSON fornito nei campi *Data*, *Layout* e *Config* verranno uniti (unione profonda).

Se non viene fornito alcuno script, il pannello utilizzerà solo *i campi Data*, *Layout* e *Config.*

# Pannello Sankey
<a name="v9-panels-sankey"></a>

****  
**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 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)

Il pannello Sankey mostra i diagrammi di Sankey, utili per visualizzare i dati di flusso, con la larghezza del flusso proporzionale alla metrica selezionata. L'immagine seguente mostra un diagramma di Sankey con due gruppi di origine e destinazione.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/sankey-panel.png)


**Come funziona**

Il pannello sankey richiede almeno 2 colonne di dati, un'origine e una destinazione per i flussi. La tua query dovrebbe raggruppare i dati in almeno due gruppi. Il pannello disegnerà i collegamenti dalla prima colonna di punti dati all'ultima nell'ordine della query. Lo spessore dei link sarà proporzionato al valore assegnato dalla metrica della query.

**Personalizzazione**
+ **Collegamenti**: attualmente esistono due opzioni per il colore del collegamento: multiplo o singolo. Per impostazione predefinita, è multicolore. Per scegliere un solo colore per i collegamenti, attiva l'opzione **Solo colore a collegamento singolo e scegli il tuo colore** dal selettore di colori di Grafana.
+ **Nodi****: puoi cambiare il colore dei nodi rettangolari modificando l'opzione Colore del nodo**
+ **Larghezza del nodo**: la larghezza dei nodi può essere regolata con il cursore **Larghezza del nodo** o inserendo un numero nella casella di immissione. Questo numero deve essere un numero intero.
+ **Imbottitura dei nodi**: la spaziatura verticale tra i nodi può essere regolata con il cursore **Node Padding** o inserendo un numero nella casella di immissione. Questo numero deve essere un numero intero. Se i tuoi link sono troppo sottili, prova a modificare questo numero
+ **Intestazioni**: le intestazioni delle colonne possono essere modificate utilizzando l'opzione **Display Name** override nel pannello dell'editor. **Saranno dello stesso colore che hai scelto per il colore del testo**
+ **Layout Sankey**: il layout dei collegamenti Sankey può essere leggermente modificato utilizzando il cursore di **iterazione del layout**. Questo numero deve essere un numero intero ed è il numero di iterazioni di rilassamento utilizzate per generare il layout.

# Pannello Scatter
<a name="v9-panels-scatter"></a>

****  
**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 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)

Il pannello a dispersione mostra un X/Y grafico a dispersione per i dati della tabella con un'interfaccia più semplice rispetto ad altri pannelli grafici. A differenza del pannello grafico, il pannello a dispersione non richiede che i dati appartengano a una serie temporale. Il pannello a dispersione richiede un set di dati in formato tabella con due o più colonne numeriche di dati.

Uno di questi può essere assegnato all'asse X. Uno o più valori possono essere assegnati a una serie di valori dell'asse Y e i dati risultanti possono essere tracciati come una serie di punti. Ogni serie può opzionalmente mostrare anche una linea di regressione utilizzando uno dei numerosi migliori adattamenti statistici.

**Creazione di un pannello a dispersione**

La procedura seguente descrive come creare un grafico a dispersione utilizzando il pannello a dispersione. Per questo esempio, supponiamo che esistano dati, come nella tabella seguente, denominati `HEIGHT` con tre colonne di valori numerici, `Age` `Boys``Girls`, e che mostrino l'altezza media di ragazzi e ragazze per età.


| Età | Altezza del ragazzo | Altezza della ragazza | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121,1  |  120,8  | 
|  8  |  126,3  |  126  | 
|  9  |  131,3  |  131,3  | 
|  10  |  136,2  |  137,1  | 
|  11  |  141,2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152,6  | 
|  14  |  159,9  |  155,1  | 
|  15  |  164,4  |  156,7  | 
|  16  |  167,3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Per creare un grafico a dispersione con il pannello a dispersione**

1. Nella dashboard Grafana, scegli **Aggiungi** pannello.

1. Per la Query, scrivi una query che restituisca i dati necessari. In questo caso, dovresti usare una query come`SELECT * FROM HEIGHT`.

1. Seleziona la visualizzazione **Scatter**.

Questo creerà un grafico a dispersione, utilizzando la prima colonna come asse X e le altre colonne numeriche come assi Y.

**Opzioni di configurazione**

Il pannello a dispersione offre le seguenti quattro opzioni di configurazione personalizzate.
+ **Asse X**: è possibile scegliere quale campo utilizzare come asse X, nonché le estensioni, il titolo e le informazioni di visualizzazione per l'asse.
+ **Asse Y**: è possibile scegliere quali campi visualizzare sull'asse Y, incluse le opzioni di visualizzazione per ogni campo e le informazioni sulle estensioni e sul titolo per l'asse. Puoi anche scegliere di visualizzare una linea di regressione per ogni campo. Vedi le seguenti informazioni per maggiori dettagli sulla configurazione della linea di regressione.
+ **Legenda**: puoi attivare o disattivare una legenda per il pannello, nonché scegliere la dimensione del testo nella legenda.
+ **Visualizzazione**: puoi impostare altre opzioni per il grafico, tra cui il colore della griglia e lo stile del bordo.

**Configurazione della linea di regressione**

Ogni set di dati sull'asse Y può visualizzare una linea, oltre ai singoli punti. Sono disponibili cinque opzioni per il tipo di linea.
+ **Nessuno**: non visualizza una linea di regressione.
+ **Semplice**: visualizza una linea di regressione che collega i punti del set di dati.
+ **Lineare**: visualizza una linea retta, utilizzando il metodo best-fit dei minimi quadrati.
+ Esponenziale: visualizza una linea di **regressione esponenziale più** adatta.
+ **Potenza: visualizza la linea di regressione** più adatta alla potenza.

# Pannello Stat
<a name="v9-panels-stat"></a>

****  
**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 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)

La visualizzazione del pannello Stat mostra un unico grande valore stat con un grafico sparkline opzionale. È possibile controllare lo sfondo o il colore del valore utilizzando delle soglie.

Per impostazione predefinita, il pannello Statistiche mostra uno dei seguenti elementi:
+ Solo il valore di una singola serie o campo.
+ Valore e nome di più serie o campi.

È possibile utilizzare la **modalità Testo** per controllare se il testo viene visualizzato o meno.

## Regolazione automatica del layout
<a name="v9-panels-stat-automatic-adjust"></a>

Il pannello regola automaticamente il layout in base alla larghezza e all'altezza disponibili nella dashboard. Nasconde automaticamente il grafico (sparkline) se il pannello diventa troppo piccolo.

## Opzioni di valore
<a name="v9-panels-stat-value"></a>

Utilizza le seguenti opzioni per rifinire il modo in cui la visualizzazione mostra il valore:

**Mostra**

Scegli come Grafana visualizza i tuoi dati.

**Calcola**

Mostra un valore calcolato basato su tutte le righe.
+ **Calcolo**: seleziona una funzione di riduzione che Grafana utilizzerà per ridurre molti campi a un unico valore. Per un elenco dei calcoli disponibili, consulta Calcoli [standard](v9-panels-calculation-types.md).
+ **Campi**: seleziona i campi visualizzati nel pannello.

**Tutti i valori**

Mostra una statistica separata per ogni riga. Se selezioni questa opzione, puoi anche limitare il numero di righe da visualizzare.
+ **Limite**: il numero massimo di righe da visualizzare. Il valore predefinito è 5.000.
+ **Campi**: seleziona i campi visualizzati nel pannello.

## Stili di statistiche
<a name="v9-panels-stat-styles"></a>

Personalizza la tua visualizzazione.

**Orientation** (Orientamento)

Scegli una direzione di impilamento.
+ **Automatico**: Grafana seleziona quello che ritiene sia l'orientamento migliore.
+ **Orizzontale**: le barre si estendono orizzontalmente, da sinistra a destra.
+ **Verticale**: le barre si estendono verticalmente, dall'alto verso il basso.

**Modalità testo**

È possibile utilizzare l'opzione Modalità testo per controllare il testo visualizzato dal pannello. Se il valore non è importante, lo sono solo il nome e il colore, quindi modificate la **modalità Testo in** **Nome**. Il valore verrà comunque utilizzato per determinare il colore e verrà visualizzato in una descrizione comandi.
+ **Automatico**: se i dati contengono più serie o campi, mostra sia il nome che il valore.
+ **Valore**: mostra solo il valore, mai il nome. Il nome viene invece visualizzato nel tooltip posizionato al passaggio del mouse.
+ **Valore e nome**: mostra sempre valore e nome.
+ **Nome**: mostra il nome anziché il valore. Il valore viene visualizzato nel tooltip posizionato al passaggio del mouse.
+ **Nessuno: non** mostra nulla (vuoto). Il nome e il valore vengono visualizzati nel tooltip posizionato al passaggio del mouse.

**Modo a colori**

Seleziona una modalità di colore.
+ **Valore**: colora solo il valore e l'area del grafico.
+ **Sfondo**: colora anche lo sfondo.

**modalità Graph**

Seleziona un grafico e una modalità sparkline.
+ **Nessuno**: nasconde il grafico e mostra solo il valore.
+ **Area**: mostra il grafico dell'area al di sotto del valore. Ciò richiede che la query restituisca una colonna temporale.

**Allineamento del testo**

Scegli una modalità di allineamento.
+ **Automatico**: se viene visualizzato un solo valore (nessuna ripetizione), il valore viene centrato. Se vengono visualizzate più serie o righe, il valore viene allineato a sinistra.
+ **Centro**: il valore della statistica è centrato.

Dimensione del testo

Regola le dimensioni del testo dell'indicatore.
+ **Titolo**: inserisci un valore numerico per la dimensione del titolo dell'indicatore.
+ **Valore**: immettere un valore numerico per la dimensione del valore dell'indicatore.

# Pannello della cronologia dello stato
<a name="v9-panels-state-timeline"></a>

****  
**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 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)

La visualizzazione del pannello della timeline dello stato mostra cambiamenti di stato discreti nel tempo. Ogni campo o serie viene visualizzato come una banda orizzontale unica. Le regioni statali possono essere renderizzate con o senza valori. Questo pannello funziona bene con stringhe o stati booleani, ma può essere utilizzato anche con serie temporali. Se utilizzate con serie temporali, le soglie vengono utilizzate per trasformare i valori numerici in regioni statali discrete.

## Opzioni relative alla cronologia dello stato
<a name="v9-panels-state-timeline-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Unisci valori consecutivi uguali**

Controlla se Grafana unisce valori identici se sono uno accanto all'altro.

**Mostra valori**

Controlla se i valori vengono visualizzati all'interno delle regioni statali. Auto renderizzerà i valori se c'è spazio sufficiente.

**Allinea i valori**

Controlla l'allineamento dei valori all'interno delle regioni statali.

**Altezza delle righe**

Controlla lo spazio tra le righe. 1 = nessuno spazio = 0,5 = 50% spazio.

**Larghezza della linea**

Controlla la larghezza delle linee delle regioni statali.

**Riempi l'opacità**

Controlla l'opacità delle regioni statali.

## Mappature dei valori
<a name="v9-panels-state-timeline-valuemap"></a>

Per assegnare colori a valori booleani o stringhe, usa. [Configurare le mappature dei valori](v9-panels-configure-value-mappings.md)

## Dati di serie temporali con soglie
<a name="v9-panels-state-timeline-threshold"></a>

Il pannello può essere utilizzato anche con i dati delle serie temporali. In questo caso, le soglie vengono utilizzate per trasformare le serie temporali in regioni statali a colori discreti.

## Opzioni relative alla legenda
<a name="v9-panels-state-timeline-legend"></a>

Quando l'opzione legenda è abilitata, può mostrare le mappature dei valori o le parentesi di soglia. Per mostrare le mappature dei valori nella legenda, è importante che l'opzione Combinazione di colori nelle opzioni Standard sia impostata su Colore singolo o Palette classica. Per visualizzare le parentesi di soglia nella legenda, impostate lo schema di colori su Dalle soglie.

**Modalità Legenda** Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Questa è una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda** Scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

**Valori della legenda**

Scegli quale dei [calcoli standard](v9-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

# Pannello della cronologia dello stato
<a name="v9-panels-status-history"></a>

****  
**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 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)

La visualizzazione della cronologia dello stato mostra gli stati periodici nel tempo. Ogni campo o serie viene visualizzato come una riga orizzontale. I riquadri vengono renderizzati e centrati attorno a ciascun valore.

La visualizzazione della cronologia dello stato funziona con campi stringhe, booleani e numerici o serie temporali. È richiesto un campo orario. È possibile utilizzare le mappature dei valori per colorare le stringhe o assegnare valori di testo a intervalli numerici.

## Opzioni di visualizzazione
<a name="v9-panels-status-history-timeline-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Mostra valori**

Controlla se i valori vengono visualizzati all'interno delle caselle dei valori. Auto renderizzerà i valori se c'è spazio sufficiente.

La **larghezza della colonna** controlla la larghezza dei riquadri. 1=larghezza massima e 0=larghezza minima.

**La larghezza della linea controlla la larghezza** della linea delle regioni statali.

**L'opacità di riempimento controlla l'opacità** di riempimento delle regioni statali.

## Mappature dei valori
<a name="v9-panels-status-history-valuemap"></a>

Per assegnare colori a valori booleani o stringhe, usa. [Configurare le mappature dei valori](v9-panels-configure-value-mappings.md)

## Dati di serie temporali con soglie
<a name="v9-panels-status-history-threshold"></a>

Il pannello può essere utilizzato anche con i dati delle serie temporali. In questo caso, le soglie vengono utilizzate per colorare le caselle. È inoltre possibile utilizzare combinazioni di colori a gradiente per colorare i valori.

## Opzioni relative alla legenda
<a name="v9-panels-status-history-legend"></a>

Quando l'opzione legenda è abilitata, può mostrare le mappature dei valori o le parentesi di soglia. Per mostrare le mappature dei valori nella legenda, è importante che l'opzione Combinazione di colori nelle opzioni Standard sia impostata su Colore singolo o Palette classica. Per visualizzare le parentesi di soglia nella legenda, imposta lo schema di colori su Dalle soglie.

**Modalità Legenda** Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Questa è una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda** Scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

**Valori della legenda**

Scegli quale dei [calcoli standard](v9-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

# Pannello da tavolo
<a name="v9-panels-table"></a>

****  
**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 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)

La visualizzazione del pannello delle tabelle è molto flessibile e supporta diverse modalità per le serie temporali e per le tabelle, le annotazioni e i dati JSON non elaborati. Questo pannello fornisce anche opzioni di formattazione della data, formattazione dei valori e colorazione.

## Ordina colonna
<a name="v9-panels-table-sort"></a>

Fai clic sul titolo di una colonna per modificare l'ordinamento da predefinito a decrescente a crescente. Ogni volta che fate clic, l'ordinamento passa all'opzione successiva del ciclo. Puoi solo ordinare in base a una colonna alla volta.

## Opzioni della tabella
<a name="v9-panels-table-options"></a>

**Mostra l'intestazione**

Mostra o nascondi i nomi delle colonne importati dalla tua fonte di dati.

## Larghezza delle colonne
<a name="v9-panels-table-width"></a>

Per impostazione predefinita, Grafana calcola automaticamente la larghezza della colonna in base alla dimensione della tabella e alla larghezza minima della colonna. Questa opzione di campo può sovrascrivere l'impostazione e definire la larghezza di tutte le colonne in pixel.

Ad esempio, se si immette `100` nel campo, quando si fa clic all'esterno del campo, tutte le colonne verranno impostate su una larghezza di 100 pixel.

## Larghezza minima della colonna
<a name="v9-panels-table-min"></a>

Per impostazione predefinita, la larghezza minima della colonna della tabella è 150 pixel. Questa opzione di campo può sostituire quella predefinita e definirà la nuova larghezza minima della colonna per il pannello della tabella in pixel.

Ad esempio, se si immette `75` nel campo, quando si fa clic all'esterno del campo, tutte le colonne verranno ridimensionate fino a una larghezza non inferiore a 75 pixel.

Per i dispositivi con schermi di piccole dimensioni, come smartphone o tablet, riduci il valore predefinito dei `150` pixel per consentire `50` ai pannelli basati su tabelle di essere visualizzati correttamente nelle dashboard.

## Allineamento delle colonne
<a name="v9-panels-table-alignment"></a>

Scegli come Grafana deve allineare il contenuto delle celle:
+ Auto (impostazione predefinita)
+ Sinistra
+ center
+ Right

## Tipo di cella
<a name="v9-panels-table-cell-type"></a>

Per impostazione predefinita, Grafana sceglie automaticamente le impostazioni di visualizzazione. Puoi sovrascrivere le impostazioni scegliendo una delle seguenti opzioni per impostare l'impostazione predefinita per tutti i campi. È disponibile una configurazione aggiuntiva per alcuni tipi di celle.

**Nota**  
Se li imposti nella scheda **Campo**, il tipo verrà applicato a tutti i campi, incluso il campo dell'ora. Puoi impostarli nella scheda **Ignora** per applicare la modifica a uno o più campi.

**Testo a colori**

Se sono impostate delle soglie, il testo del campo viene visualizzato con il colore di soglia appropriato.

**Sfondo a colori (sfumato o solido)**

Se sono impostate delle soglie, lo sfondo del campo viene visualizzato con il colore di soglia appropriato.

**Gauge**

Le celle possono essere visualizzate come indicatore grafico, con diversi tipi di presentazione.

**Di base**

La modalità base mostrerà un indicatore semplice con i livelli di soglia che definiscono il colore del misuratore.

**Gradiente**

I livelli di soglia definiscono un gradiente.

**LCD**

L'indicatore è suddiviso in piccole celle accese o spente.

**Visualizzazione JSON**

Mostra il valore formattato come codice. Se un valore è un oggetto, la vista JSON che consente la navigazione dell'oggetto JSON verrà visualizzata al passaggio del mouse.

## Ispezione del valore della cella
<a name="v9-panels-table-cell-value"></a>

Consente l'ispezione del valore dalla cella della tabella. Il valore grezzo viene presentato in una finestra modale.

**Nota**  
L'ispezione del valore delle celle è disponibile solo quando la modalità di visualizzazione delle celle è impostata su Auto, Testo a colori, Sfondo a colori o Visualizzazione JSON.

## Filtro a colonna
<a name="v9-panels-table-col-filter"></a>

È possibile modificare temporaneamente la modalità di visualizzazione dei dati delle colonne. Ad esempio, puoi ordinare i valori dal più alto al più basso o nascondere valori specifici. Per ulteriori informazioni, consulta [Filtrare le colonne della tabella](#v9-panels-table-filter), di seguito.

## Paginazione
<a name="v9-panels-table-pagination"></a>

Utilizzate questa opzione per abilitare o disabilitare l'impaginazione. È un'opzione front-end che non influisce sulle query. Se abilitata, la dimensione della pagina si adatta automaticamente all'altezza della tabella.

## Filtra le colonne della tabella
<a name="v9-panels-table-filter"></a>

Se attivi il **filtro Colonna**, puoi filtrare le opzioni della tabella.

**Per attivare il filtraggio delle colonne**

1. In Grafana, accedi alla dashboard con la tabella con le colonne che desideri filtrare.

1. Sul pannello della tabella che desideri filtrare, apri l'editor del pannello.

1. Scegliete la scheda **Campo**.

1. Nelle opzioni della **tabella**, attiva l'opzione **Filtro a colonne**.

Accanto al titolo di ogni colonna viene visualizzata un'icona di filtro.

**Filtra i valori delle colonne**

Per filtrare i valori delle colonne, scegli l'icona del filtro (imbuto) accanto al titolo di una colonna. Grafana mostra le opzioni di filtro per quella colonna.

Scegliete la casella di controllo accanto ai valori che desiderate visualizzare. Inserisci il testo nel campo di ricerca in alto per mostrare quei valori sul display in modo da poterli selezionare anziché scorrere per trovarli.

**Cancella i filtri delle colonne**

Le colonne con filtri applicati hanno un imbuto blu visualizzato accanto al titolo.

Per rimuovere il filtro, scegli l'icona blu dell'imbuto, quindi seleziona Cancella filtro.

## Piè di pagina del tavolo
<a name="v9-panels-table-footer"></a>

È possibile utilizzare il piè di pagina della tabella per mostrare [i calcoli sui campi](v9-panels-calculation-types.md).

Dopo aver abilitato il piè di pagina della tabella, puoi selezionare il **Calcolo** e quindi i **campi** che desideri calcolare.

Il sistema applica il calcolo a tutti i campi numerici se non si seleziona un campo.

**Conta le righe**

Se desideri mostrare il numero di righe nel set di dati anziché il numero di valori nei campi selezionati, seleziona il calcolo del **conteggio** e abilita **Conta righe**.

# Pannello di testo
<a name="v9-panels-text"></a>

****  
**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 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)

Il pannello di testo consente di includere direttamente testo o HTML nelle dashboard. Questo può essere usato per aggiungere informazioni e descrizioni contestuali o incorporare codice HTML complesso.

**Mode** (Modalità)

La modalità determina la modalità di visualizzazione del contenuto incorporato. Ha le seguenti opzioni
+ **Markdown**: questa opzione formatta il contenuto come markdown.
+ **HTML**: questa impostazione rende il contenuto come HTML disinfettato.
+ **Codice**: questa impostazione esegue il rendering del contenuto all'interno di un editor di codice di sola lettura. Seleziona una lingua appropriata per applicare l'evidenziazione della sintassi al testo incorporato.

**Variabili**

Le variabili nel contenuto verranno espanse per la visualizzazione.

# Pannello delle serie temporali
<a name="v9-panels-time-series"></a>

****  
**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 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)

Il pannello delle serie temporali può renderizzare una serie temporale come una linea, un percorso di punti o una serie di barre. Questo tipo di grafico è abbastanza versatile da visualizzare quasi tutti i dati di serie temporali.

**Nota**  
È possibile migrare le visualizzazioni del pannello Graph alle visualizzazioni delle serie temporali. **Per migrare, nella scheda **Pannello, scegliete Visualizzazione delle serie temporali**.** Grafana trasferisce tutte le impostazioni applicabili.

**Topics**
+ [Opzioni del tooltip](v9-time-series-panel-tooltip.md)
+ [Opzioni della legenda](v9-time-series-panel-legend.md)
+ [Opzioni di stile del grafico](v9-time-series-graph.md)
+ [Opzioni dell'asse](v9-time-series-axis.md)
+ [Opzioni di colore](v9-time-series-color.md)

# Opzioni del tooltip
<a name="v9-time-series-panel-tooltip"></a>

****  
**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 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)

Quando si posiziona il cursore sul grafico, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip:
+  **Singola**: il tooltip al passaggio del mouse mostra solo la serie su cui stai passando il mouse.
+  **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie presenti nel grafico. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+  **Nascosto**: non visualizza il tooltip. 

# Opzioni della legenda
<a name="v9-time-series-panel-legend"></a>

****  
**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 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)

**Modalità Legenda**: scegli come appare la legenda.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Questa è l’impostazione predefinita.
+  **Tabella**: visualizza la legenda come tabella. 
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda**: scegli dove visualizzare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico. 

**Calcoli della legenda**

Scegli quali calcoli mostrare nella legenda. Per ulteriori informazioni, consulta [Tipi di calcolo](v9-panels-calculation-types.md).

# Opzioni di stile del grafico
<a name="v9-time-series-graph"></a>

****  
**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 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)

**Stile del grafico**

Utilizzate questa opzione per definire come visualizzare i dati delle serie temporali. È possibile utilizzare le sostituzioni per combinare più stili nello stesso grafico. Sono disponibili tre opzioni di stile. Alcune delle altre opzioni di stile si applicano solo a determinati stili di grafico.
+ **Linee**: visualizza le serie temporali come una linea su un grafico.
+ **Barre**: visualizza le serie temporali come una serie di barre su un grafico, una per ogni punto dati.
+ **Punti**: visualizza le serie temporali come punti su un grafico, uno per ogni punto dati.

**Allineamento delle barre**

Per i grafici a barre, imposta la posizione della barra rispetto al punto in cui verrà disegnato il punto sul grafico. Poiché una barra ha una larghezza, può essere posizionata prima, dopo o centrata sul punto. Le scelte per questa opzione sono **Prima**, **Centro** o **Dopo**.

**Larghezza della linea**

Imposta lo spessore della linea per i grafici a linee o lo spessore del contorno per ogni barra in un grafico a barre.

**Opacità di riempimento**

Imposta l'opacità di un colore di riempimento. I riempimenti vengono utilizzati, ad esempio, per mostrare l'area sotto la linea in un grafico a linee o come colore delle barre in un grafico a barre.

**modalità Gradiente**

La modalità Gradiente specifica il riempimento del gradiente, che si basa sul colore della serie. Per cambiare il colore, usa l'opzione del campo Schema di colori standard. Per ulteriori informazioni, consulta [Combinazione di colori](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme). Le opzioni della modalità gradiente sono:
+ **Nessuno**: nessun riempimento a gradiente.
+ **Opacità**: un gradiente di opacità in cui l'opacità del riempimento aumenta all'aumentare dei valori dell'asse Y.
+ **Tonalità: un gradiente basato sulla tonalità** del colore della serie.
+ **Schema**: una sfumatura di colore definita dalla combinazione di colori desiderata. Questa impostazione può essere utilizzata dal riempimento e dalla linea. Per ulteriori informazioni, consulta [Opzioni di colore](v9-time-series-color.md).

L'aspetto del gradiente viene modificato anche dall'impostazione dell'**opacità di riempimento**. 

**Mostra punti**

È possibile configurare la visualizzazione per aggiungere punti ai grafici a linee o a barre. **Puoi scegliere **Sempre**, **Mai o Automatico**.** Quando si utilizza **Auto**, Grafana determina se mostrare i punti in base alla densità dei dati. Se la densità dei dati è sufficientemente bassa, vengono visualizzati i punti.

**Dimensione in punti**

Imposta la dimensione dei punti disegnati, da 1 a 40 pixel di diametro.

**Interpolazione delle linee**

Scegli come Grafana interpola la linea della serie. **Le scelte sono **Linear**, **Smooth**, **Step before** e Step after.**

**Stile della riga**

Imposta lo stile della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard.

L'aspetto dello stile della linea è influenzato dalle impostazioni per **Spessore della linea** e **Opacità di riempimento**.

**Le scelte per lo stile della linea sono **Solid**, **Dash e Dots**.**

**Connect valori nulli**

Scegli come appaiono i valori nulli (lacune nei dati) sul grafico. I valori nulli possono essere collegati per formare una linea continua o, facoltativamente, impostare una soglia oltre la quale le lacune nei dati non devono più essere collegate. Puoi scegliere di **Non connettere mai** i punti dati con gli spazi vuoti, Connetti **sempre** i punti dati con gli spazi vuoti o impostare una **soglia** alla quale le lacune nei dati non devono più essere collegate.

**Serie Stack**

*L'impilamento* consente a Grafana di visualizzare le serie una sopra l'altra. Fai attenzione quando usi l'impilamento nella visualizzazione in quanto può facilmente creare grafici fuorvianti. [Per saperne di più sul motivo per cui l'impilamento potrebbe non essere l'approccio migliore, consulta The Issue with Stacking.](https://www.data-to-viz.com/caveat/stacking.html)

Le opzioni per l'impilamento sono:
+ **Disattiva: disattiva** l'impilamento delle serie.
+ **Normale**: impila le serie una sopra l'altra.
+ **100%**: impila per percentuale, dove tutte le serie insieme raggiungono il 100%.

**Impila le serie in gruppi**

È possibile sovrascrivere il comportamento di impilamento per impilare le serie in gruppi. Per ulteriori informazioni sulla creazione di un override, consulta. [Configura le sostituzioni dei campi](v9-panels-configure-overrides.md) Quando create l'override, date il nome del gruppo di impilamento di cui volete che la serie faccia parte.

**Compila di seguito per**

L'opzione **Riempi sotto** riempie l'area tra due serie. Questa opzione è disponibile solo come alternativa a una serie o a un campo. Usando questa opzione puoi riempire l'area tra due serie, anziché partire dalla linea della serie fino a 0. Ad esempio, se avete due serie chiamate *Max* e *Min*, potete selezionare la serie **Max** e sostituirla con **Riempi fino alla** serie **Min**.. Ciò riempirebbe solo l'area tra le due linee della serie.

# Opzioni dell'asse
<a name="v9-time-series-axis"></a>

****  
**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 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 opzioni nella categoria degli assi modificano il modo in cui vengono renderizzati gli assi X e Y. Alcune opzioni non hanno effetto finché non si fa clic all'esterno della casella delle opzioni del campo che si sta modificando. Puoi anche premere`Enter`.

**Posizionamento**

Seleziona il posizionamento dell'asse Y. Le opzioni sono:
+ **Automatico** — Grafana assegna automaticamente l'asse Y alla serie. Quando ci sono due o più serie con unità diverse, Grafana assegna l'asse sinistro alla prima unità e l'asse destro alle unità successive.
+ **Sinistra**: visualizza tutti gli assi Y sul lato sinistro.
+ **Destra**: visualizza tutti gli assi Y sul lato destro.
+ **Nascosto**: nasconde tutti gli assi Y.

[Per assegnare assi a ciascun campo o serie, aggiungi sostituzioni di campo.](v9-panels-configure-overrides.md)

**Etichetta**

Imposta un'etichetta di testo sull'asse Y. Se hai più di un asse Y, puoi assegnare etichette diverse usando un override.

**Width** (Larghezza)

Imposta una larghezza fissa dell'asse. Per impostazione predefinita, Grafana calcola dinamicamente la larghezza di un asse.

Impostando la larghezza dell'asse, i dati con diversi tipi di assi possono condividere le stesse proporzioni di visualizzazione. Questa impostazione semplifica il confronto dei dati di più di un grafico perché gli assi non vengono spostati o allungati in prossimità visiva l'uno dell'altro.

**Soft min e soft max**

Impostate un'opzione **Soft min** o **soft max** per un migliore controllo dei limiti dell'asse Y. Per impostazione predefinita, Grafana imposta automaticamente l'intervallo per l'asse Y in base al set di dati.

Le impostazioni Soft min e soft max consentono la visibilità di piccole modifiche quando non sono presenti modifiche importanti. Gli hard min o max, derivati dalle opzioni di campo min e max standard, possono impedire ai picchi intermittenti di appiattire i dettagli utili tagliando i picchi oltre un punto specifico.

Per definire i limiti rigidi dell'asse Y, è possibile impostare opzioni standard. min/max Per ulteriori informazioni, consulta [Configurare le opzioni standard](v9-panels-configure-standard-options.md).

**Dimensionamento**

Imposta la scala dell'asse Y. **Le scelte sono **lineari** o logaritmiche.** Se si sceglie logaritmica, è possibile scegliere ulteriormente tra scale logaritmiche in base 2 o base 10.

**Transform** (Trasforma)

È possibile sovrascrivere una serie per applicare una trasformazione ai valori su un grafico (senza influire sui valori sottostanti o sui valori nelle descrizioni dei comandi, nei menu contestuali o nelle legende). Sono disponibili due opzioni di trasformazione:
+ **Trasformazione Y negativa**: inverte i risultati in valori negativi sull'asse Y.
+ **Costante**: mostra il primo valore come linea costante.

# Opzioni di colore
<a name="v9-time-series-color"></a>

****  
**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 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)

Per impostazione predefinita, il grafico utilizza l'opzione [Schema colori standard per assegnare i colori](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme) delle serie. È inoltre possibile utilizzare la legenda per aprire il selettore dei colori facendo clic sull'icona dei colori della serie di legende. L'impostazione del colore in questo modo crea automaticamente una regola di sostituzione che imposta un colore specifico per una serie specifica.

Le seguenti sono opzioni aggiuntive che è possibile utilizzare per ignorare i colori predefiniti delle serie.

**Palette classica**

La configurazione più comune consiste nell'utilizzare la **palette Classic** per i grafici. Questo schema assegna automaticamente un colore per ogni campo o serie in base al relativo ordine. Se l'ordine di un campo cambia nella query, cambia anche il colore. È possibile configurare manualmente un colore per un campo specifico utilizzando una regola di esclusione.

**Colore singolo**

Utilizzate questa modalità per specificare un colore. Puoi anche fare clic sull'icona della linea colorata accanto a ciascuna serie nella legenda per aprire il selettore di colori. Questo crea automaticamente un nuovo override che imposta lo schema di colori su un solo colore e sul colore selezionato.

**Combinazioni di colori per valore**

Se si seleziona uno schema di colori per valore, ad esempio **Dalla soglia (per valore)** o **Green-Yellow-Red (per valore)**, viene visualizzata l'opzione **Serie di colori per** valore. Questa opzione controlla il valore (Last, Min, Max) da utilizzare per assegnare il colore alla serie.

**Scheme (modalità gradiente)**

**L'opzione della **modalità Gradiente** situata sotto **gli stili del grafico** ha una modalità denominata Schema.** **Quando attivate **Scheme**, la linea o la barra riceve un colore sfumato definito dallo schema di colori selezionato.**

**Dalle soglie**

Se la **combinazione di colori** è impostata su **Dalle soglie (in base al valore)** e la **modalità Gradiente** è impostata su **Schema**, il colore della linea o della barra cambia man mano che superano le soglie definite. Verranno visualizzati solo i colori esatti scelti nello schema.

**Combinazioni di colori a gradiente**

L'uso di uno schema di colori sfumato *senza* impostare la **modalità Gradiente** su **Schema** significa che i colori scelti formeranno un gradiente tra i colori scelti, man mano che i valori della serie si spostano tra le soglie impostate.

# Pannello Traces (Beta)
<a name="v9-panels-traces"></a>

****  
**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 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 *tracce* sono una visualizzazione che consente di tracciare e registrare una richiesta mentre attraversa i servizi dell'infrastruttura.

Per ulteriori informazioni sulle tracce, vedere. [Tracciamento in Explore](v9-explore-tracing.md)

# WindRose
<a name="v9-panels-windrose"></a>

****  
**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 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)

Il WindRose pannello riceve i dati non elaborati delle serie temporali, li converte e li mappa in un grafico. WindRose 

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/windrose.png)


## Opzioni
<a name="v9-panels-windrose-options"></a>

Il WindRose pannello supporta le seguenti opzioni:
+ Frequenza dell'asse
+ Stile dell'asse (gradi o bussola)
+ Scala (lineare, quadrata, logaritmica)

# Esplora nella versione 9 di Grafana
<a name="v9-explore"></a>

****  
**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 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)

L'interfaccia utente della dashboard di Grafana offre funzionalità per creare dashboard per la visualizzazione. *Explore* elimina le opzioni della dashboard e del pannello in modo che tu possa concentrarti sulla query. Ti aiuta a eseguire l'iterazione fino a ottenere una query funzionante e quindi puoi creare una dashboard a partire dalla query.

**Nota**  
Se vuoi solo esplorare i tuoi dati e non vuoi creare una dashboard, Explore lo rende molto più semplice. Se la tua fonte di dati supporta dati grafici e tabellari, Explore mostra i risultati sia come grafico che come tabella. Ciò consente di visualizzare contemporaneamente le tendenze dei dati e ulteriori dettagli.

## Inizia a esplorare
<a name="v9-explore-start"></a>

**Nota**  
Per accedere a Explore, devi avere un ruolo di editor o amministratore.

**Per accedere a Explore**

1. Nella tua area di lavoro Grafana, scegli la voce di menu Esplora dalla barra dei menu a sinistra.

   Si apre una scheda Esplora vuota.

   In alternativa, per iniziare con un'interrogazione esistente in un pannello, scegliete l'opzione Esplora dal menu del pannello. Si apre una scheda Esplora con la query del pannello e ti consente di modificare o iterare la query all'esterno della dashboard.

1. Scegli la tua fonte di dati dal menu a discesa in alto a sinistra. [Prometheus](prometheus-data-source.md) ha un'implementazione Explore personalizzata, le altre fonti di dati utilizzano il loro editor di query standard.

1. Nel campo della query, scrivi la tua query per esplorare i tuoi dati. Ci sono tre pulsanti accanto al campo di interrogazione, un pulsante di cancellazione (X), un pulsante di aggiunta di query (\$1) e il pulsante di rimozione della query (-). Proprio come il normale editor di query, puoi aggiungere e rimuovere più interrogazioni.

   Per ulteriori dettagli sulle interrogazioni, consulta. [Interroga e trasforma i dati](v9-panels-query-xform.md)

## Dividi e confronta
<a name="v9-explore-compare"></a>

La visualizzazione divisa offre un modo semplice per confrontare grafici e tabelle side-by-side o per esaminare i dati correlati in un'unica pagina.

**In alto, apri una vista divisa.**

1. Nella vista Esplora, scegli il pulsante **Dividi** per duplicare la query corrente e dividere la pagina in due side-by-side query.
**Nota**  
È possibile selezionare un'altra fonte di dati per la nuova query che, ad esempio, consente di confrontare la stessa query per due server diversi o di confrontare l'ambiente di staging con l'ambiente di produzione.

   Nella visualizzazione divisa, è possibile collegare i timepicker di entrambi i pannelli (se ne modificate uno, cambia anche l'altro) selezionando un pulsante di sincronizzazione temporale collegato a uno dei timepicker. Il collegamento dei timepicker mantiene sincronizzati l'ora di inizio e quella di fine delle interrogazioni con visualizzazione divisa. Garantisce che si stia osservando lo stesso intervallo di tempo in entrambi i pannelli divisi.

1. Per chiudere l'interrogazione appena creata, fate clic sul pulsante Chiudi divisione.

## Condividi il link abbreviato
<a name="v9-explore-share"></a>

La funzionalità Condividi link abbreviati consente di creare file più piccoli e semplici nel formato /goto/:uid URLs invece di utilizzare un formato più lungo con i parametri di interrogazione. URLs **Per creare un collegamento abbreviato ai risultati della query, selezionate l'opzione Condividi nella barra degli strumenti Esplora.** Un link abbreviato che non viene mai utilizzato verrà eliminato automaticamente dopo sette (7) giorni.

# Gestione delle query in Explore
<a name="v9-explore-manage"></a>

****  
**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 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)

Per facilitare il debug delle query, Explore consente di esaminare le richieste e le risposte alle query, nonché le statistiche sulle query, tramite l'ispettore Query. [Questa funzionalità è simile alle attività di Pannello Inspector Ispeziona le [prestazioni delle query e Ispeziona i dati di richiesta e risposta delle query](v9-panels-panel-inspector.md#v9-panels-query-performance).](v9-panels-panel-inspector.md#v9-panels-query-request-response)

## Cronologia delle query
<a name="v9-explore-manage-history"></a>

La cronologia delle query è un elenco di query utilizzate in Explore. La cronologia è memorizzata nel database Grafana e non è condivisa con altri utenti. Il periodo di conservazione delle query nella cronologia è di due settimane. Le interrogazioni più vecchie di due settimane vengono eliminate automaticamente. Per aprire e interagire con la cronologia, seleziona il pulsante **Cronologia delle interrogazioni** in Esplora.

**Nota**  
Le query speciali (preferite) non sono soggette al periodo di conservazione di due settimane e non vengono eliminate.

**Visualizza la cronologia delle interrogazioni**

La cronologia delle interrogazioni consente di visualizzare la cronologia delle interrogazioni. Per ogni singola interrogazione, puoi:
+ Eseguire una query.
+ Creare e and/or modificare un commento.
+ Copia un'interrogazione negli appunti.
+ Copia negli appunti un link abbreviato con la query.
+ Aggiungi (ai preferiti) un'interrogazione.

**Gestisci le interrogazioni preferite**

Tutte le interrogazioni che sono state contrassegnate come speciali nella scheda Cronologia delle interrogazioni vengono visualizzate nell'elenco Speciali. Ciò consente di accedere più rapidamente alle query preferite e di riutilizzarle senza doverle digitare da zero.

**Ordinamento della cronologia delle interrogazioni**

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.

**Per ordinare la cronologia delle query**

1. Seleziona il campo **Ordina le interrogazioni per**.

1. Seleziona una delle seguenti opzioni:
   + Prima il più recente
   + Prima il più vecchio

**Filtrare la cronologia delle interrogazioni**

Puoi filtrare la cronologia delle query nella scheda Cronologia delle query e Speciali in base a una fonte di dati specifica.

**Filtrare la cronologia in base a una fonte di dati**

1. Seleziona il **campo Filtra le interrogazioni per fonti di dati specifiche.**

1. Seleziona la fonte di dati per la quale desideri filtrare la cronologia. Puoi selezionare più fonti di dati.

Nella scheda **Cronologia delle interrogazioni** è anche possibile filtrare le query per data utilizzando lo slider:
+ Usa il cursore verticale per filtrare le query per data.
+ Regola la data di inizio trascinando la maniglia superiore.
+ Regola la data di fine trascinando la maniglia superiore.

**Ricerca nella cronologia delle interrogazioni**

Puoi cercare nella cronologia tra le domande e i commenti. È possibile cercare le query nella scheda Cronologia delle interrogazioni e nella scheda Speciali.

**Per effettuare ricerche nella cronologia delle interrogazioni**

1. Seleziona il campo **Interrogazioni di ricerca**.

1. Inserisci il termine che stai cercando nel campo di ricerca.

**Impostazioni della cronologia delle interrogazioni**

È possibile personalizzare la cronologia delle interrogazioni nella scheda Impostazioni. Le opzioni sono descritte nella tabella seguente.


| Impostazione | Valore predefinito | 
| --- | --- | 
| Cambia la scheda attiva predefinita | Scheda della cronologia delle interrogazioni | 

**Nota**  
Le impostazioni della cronologia delle interrogazioni sono globali e vengono applicate a entrambi i pannelli in modalità split.

## Funzionalità specifiche di Prometheus
<a name="v9-explore-manage-prometheus"></a>

Explore offre un'esperienza di interrogazione personalizzata per Prometheus. *Quando viene eseguita una query, in realtà esegue 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, il 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 se vuoi solo esplorare quali metriche sono disponibili.

**Campo di interrogazione**

Il campo Query supporta il completamento automatico per i nomi e le funzioni delle metriche, paragonabile all'editor di query standard di Prometheus. È possibile premere il tasto Invio per creare una nuova riga e Shift\$1Invio per eseguire una query.

Il menu di completamento automatico può essere attivato premendo Ctrl\$1Spazio. Il menu di completamento automatico contiene una nuova sezione Cronologia con un elenco di interrogazioni eseguite di recente.

I suggerimenti possono apparire nel campo della query: selezionali per aggiornare la query con la modifica suggerita.
+ Per i contatori (metriche che aumentano in modo monotono), verrà suggerita una funzione di frequenza.
+ Per i bucket, verrà suggerita una funzione istogramma.
+ Per le regole di registrazione, è possibile espandere le regole.

**Filtri da tabella**

Selezionate il pulsante di filtro nella colonna dell'**etichetta** di un pannello Tabella per aggiungere filtri all'espressione di interrogazione. È possibile aggiungere filtri anche per più interrogazioni: il filtro viene aggiunto per tutte le interrogazioni.

# Accedi a Esplora
<a name="v9-explore-logs"></a>

****  
**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 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)

Oltre alle metriche, Explore consente di esaminare i log nelle seguenti fonti di dati:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Durante il monitoraggio dell'infrastruttura e la risposta agli incidenti, puoi approfondire le metriche e i log per individuarne la causa. Explore consente inoltre di correlare metriche e log visualizzandoli. side-by-side Questo crea un nuovo flusso di lavoro di debug.

1. Ricevi un avviso.

1. Approfondisci ed esamina le metriche.

1. Esegui nuovamente il drill down e cerca nei log relativi alla metrica e all'intervallo di tempo (e, in futuro, alle tracce distribuite).

## Visualizzazione dei log
<a name="v9-explore-logs-viz"></a>

I risultati delle interrogazioni di log sono mostrati sotto forma di istogrammi nel grafico e i singoli log sono spiegati nelle sezioni seguenti.

Se l'origine dati supporta un istogramma del volume di log a intervallo completo, il grafico con la distribuzione dei log per tutte le query di log inserite viene visualizzato automaticamente. Questa funzionalità è attualmente supportata dalle fonti di dati OpenSearch e Loki.

**Nota**  
In Loki, questo istogramma del volume di log a intervallo completo viene visualizzato mediante query metriche che possono essere costose a seconda dell'intervallo di tempo richiesto. Questa interrogazione può essere particolarmente difficile da elaborare per le installazioni di Loki più piccole. Per mitigare questo problema, consigliamo di utilizzare un proxy come [nginx](https://www.nginx.com/) davanti a Loki per impostare un timeout personalizzato (ad esempio 10 secondi) per queste query. Le query sull'istogramma del volume di log possono essere identificate cercando le query con l'intestazione HTTP `X-Query-Tags` con valore`Source=logvolhist`; queste intestazioni vengono aggiunte da Grafana a tutte le query sull'istogramma del volume di log.

Se l'origine dati non supporta il caricamento dell'istogramma del volume di log a intervallo completo, il modello di log calcola una serie temporale basata sul conteggio delle righe di registro raggruppato in un intervallo di tempo calcolato automaticamente e il timestamp della prima riga di registro ancorerà quindi l'inizio dell'istogramma al risultato. **La fine della serie temporale è ancorata all'intervallo To del selettore temporale.**

**Livello di registro**

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, cerca di scoprire se il suo contenuto corrisponde a una delle espressioni supportate (vedi sotto per maggiori informazioni). Il livello di registro è sempre determinato dalla prima corrispondenza. Nel caso in cui Grafana non sia in grado di determinare un livello di registro, verrà visualizzato con un livello di registro sconosciuto.

**Suggerimento**  
Se usi la fonte di dati Loki e questa `level` è nella tua riga di registro, usa i parser (JSON, logfmt, regex,..) per estrarre le informazioni sul livello in un'etichetta di livello che viene utilizzata per determinare il livello di log. Ciò consentirà all'istogramma di mostrare i vari livelli di log in barre separate.

**Livelli di registro supportati e 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 | 
| trace | trace | blu chiaro | 
| \$1 | sconosciuto | grigio | 

## Registra la navigazione
<a name="v9-explore-logs-nav"></a>

L'interfaccia di navigazione dei log, accanto alle righe dei log, può essere utilizzata per richiedere altri log. Puoi farlo selezionando il pulsante **Older logs** nella parte inferiore della navigazione. Quando raggiungi il limite di righe e desideri visualizzare altri log, puoi usarlo per recuperare altri log. Ogni richiesta viene visualizzata nella navigazione come una pagina separata. Ogni pagina mostra il timestamp di partenza e di arrivo delle righe di registro in entrata. Puoi vedere i risultati precedenti facendo clic sulla pagina per visualizzarli. Explore memorizza nella cache le ultime cinque richieste eseguite dalla navigazione dei log, in modo da non rieseguire la stessa query quando si fa clic su quelle pagine.

## Opzioni di visualizzazione
<a name="v9-explore-logs-vis-options"></a>

È possibile personalizzare la modalità di visualizzazione dei registri e selezionare le colonne da visualizzare.

**Time** (Orario)

Mostra o nasconde la colonna temporale. Questo è il timestamp associato alla riga di registro riportata dalla fonte di dati.

**Etichette uniche**

Mostra o nasconde la colonna delle etichette univoche che include solo etichette non comuni. Tutte le etichette comuni sono visualizzate sopra.

**Avvolgi le linee**

Impostalo su True se desideri che lo schermo utilizzi l'avvolgimento delle linee. Se impostato su False, risulterà in uno scorrimento orizzontale.

**Abbellisci JSON**

Imposta questa opzione per `true` stampare correttamente tutti i log JSON. Questa impostazione non influisce sui log in formati diversi da JSON.

**Deduplicazione**

I dati di registro possono essere molto ripetitivi e Explore può aiutare nascondendo le righe di registro duplicate. È possibile utilizzare alcuni algoritmi di deduplicazione diversi:
+ **Esatto**: le corrispondenze esatte vengono eseguite sull'intera riga ad eccezione dei campi data.
+ **Numeri**: corrispondono alla riga dopo aver eliminato numeri come durate, indirizzi IP e così via.
+ **Firma**: la deduplicazione più aggressiva, che rimuove tutte le lettere, i numeri e le corrispondenze dagli spazi bianchi e dalla 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 abbiamo aggiunto la possibilità di filtrare (filtro positivo) e filtrare (filtro negativo) le etichette selezionate. Ogni campo o etichetta ha anche un'icona delle statistiche per visualizzare le statistiche relative a tutti i log visualizzati.

**Sfuggire alle nuove righe**

Explore rileva automaticamente alcune sequenze con escape errato nelle righe di registro, come newlines (,) o tabs ()`\n`. `\r` `\t` Quando rileva tali sequenze, Explore fornisce l'opzione «Escape newlines».

Explore è in grado di correggere automaticamente le sequenze evase in modo errato che ha rilevato

**Per correggere automaticamente le sequenze di escape**

1. Seleziona **Escape newlines** per sostituire le sequenze.

1. Controlla manualmente le sostituzioni per confermarne la correttezza.

Explore sostituisce queste sequenze. **In tal caso, l'opzione cambierà da **Escape newlines a Remove escape**.** Valuta le modifiche poiché l'analisi potrebbe non essere accurata in base all'input ricevuto. **È possibile annullare le sostituzioni selezionando Remove escape.**

**Collegamenti dati**

Utilizzando i collegamenti dati, è possibile trasformare qualsiasi parte di un messaggio di registro in un collegamento interno o esterno. Il link creato è visibile come pulsante nella sezione **Collegamenti** all'interno della visualizzazione dei **dettagli del registro**.

**Attiva/disattiva la visibilità del campo**

Espandi una riga di registro e fai clic sull'icona a forma di occhio per mostrare o nascondere i campi.

## Funzionalità specifiche di Loki
<a name="v9-explore-logs-loki"></a>

Loki è il sistema di aggregazione dei log open source di Grafana Labs. Loki è progettato per essere conveniente, in quanto non indicizza il contenuto dei log, ma piuttosto un set di etichette per ogni flusso di log. I log di Loki vengono interrogati in modo simile all'interrogazione con i selettori di etichette in Prometheus. Utilizza etichette per raggruppare i flussi di log che possono essere abbinati alle etichette Prometheus. [Per ulteriori informazioni su Grafana Loki, puoi consultare il Grafana Loki Github.](https://github.com/grafana/loki)

Per ulteriori informazioni, vedi [Loki](using-loki-in-AMG.md) su come eseguire query per i dati di registro.

**Passa dalle metriche ai log**

Se passi da una query Prometheus a una query di log (puoi prima eseguire una suddivisione per avere metriche e log fianco a fianco), manterrà le etichette della tua query che esistono nei log e le userà per interrogare i flussi di log. Ad esempio, se hai la seguente query su Prometheus:

```
grafana_alerting_active_alerts{job="grafana"}
```

dopo il passaggio all'origine dati Logs, cambierà in:

```
{job="grafana"}
```

Ciò restituirà un blocco di log nell'intervallo di tempo selezionato in cui è possibile eseguire la ricerca.

## Esempio di log
<a name="v9-explore-logs-sample"></a>

Se l'origine dati selezionata implementa log sample e supporta sia le query di log che quelle metriche, per le query metriche sarai in grado di visualizzare automaticamente esempi di righe di log che hanno contribuito alle metriche visualizzate. Questa funzionalità è attualmente supportata dalle fonti di dati Loki.

**Tailing dal vivo**

Usa la funzione Live Tailing per visualizzare i log in tempo reale sulle fonti di dati supportate.

Seleziona il pulsante **Live** nella barra degli strumenti Esplora per passare alla visualizzazione Live tail.

Nella visualizzazione Live tail, i nuovi log verranno visualizzati nella parte inferiore dello schermo e avranno uno sfondo a contrasto sbiadito, in modo da poter tenere traccia delle novità. Seleziona il pulsante **Pausa** o scorri la visualizzazione dei log per mettere in pausa il Live Tailing ed esplorare i log precedenti senza interruzioni. Seleziona il pulsante **Riprendi** per riprendere il Live Tailing o seleziona il pulsante **Stop** per uscire da Live Tailing e tornare alla visualizzazione standard di Esplora.

# Tracciamento in Explore
<a name="v9-explore-tracing"></a>

****  
**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 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)

Explore consente di visualizzare le tracce provenienti da fonti di dati di tracciamento.

Sono supportate le origini dati seguenti.
+ [Jaeger](jaeger-data-source.md)
+ [Tempo](tempo-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Per informazioni su come configurare le query per le fonti di dati sopra elencate, consulta la documentazione relativa a una fonte di dati specifica.

## Spiegazione di Trace View
<a name="v9-explore-trace-view"></a>

Questa sezione spiega gli elementi del pannello di controllo di Trace View.

**Intestazione**

L'intestazione della vista di traccia contiene i seguenti elementi
+ Titolo dell'intestazione: mostra il nome dello span principale e dell'ID di traccia.
+ Ricerca: evidenzia gli intervalli contenenti il testo cercato.
+ Metadati: vari metadati sulla traccia.

**Minimappa**

Mostra una vista condensata della sequenza temporale della traccia. Trascina il puntatore sulla minimappa per ingrandire un intervallo di tempo più piccolo. Lo zoom aggiornerà anche la timeline principale, quindi è facile vedere intervalli più brevi. Passando il mouse sulla minimappa, quando viene ingrandita, verrà visualizzato il pulsante Reimposta selezione che reimposta lo zoom.

**Pianificazione**

Mostra l'elenco degli 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 del 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.

**Dettagli Span**

Facendo clic in un punto qualsiasi della riga di estensione vengono visualizzati i dettagli relativi all'intervallo, inclusi i seguenti.
+ Nome operazione
+ Metadati Span
+ Tag: tutti i tag associati 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.

**Grafico dei nodi**

Facoltativamente, è possibile espandere il grafico del nodo per la traccia visualizzata. A seconda della fonte di dati, questo può mostrare gli intervalli della traccia come nodi nel grafico o aggiungere un contesto aggiuntivo, incluso il grafico del servizio basato sulla traccia corrente.

**Traccia nei log**

È possibile passare da un intervallo in una vista di traccia direttamente ai log pertinenti per quell'intervallo. È disponibile per le fonti di dati Tempo, Jaeger e Zipkin. Fai riferimento alla loro documentazione pertinente per istruzioni su come configurare ciascuna fonte di dati.

Fate clic sull'icona del documento per aprire una visualizzazione divisa in Explore con l'origine dati configurata e interrogare i log pertinenti per l'intervallo.

## Visualizzazione del grafico dei servizi
<a name="v9-explore-trace-graph"></a>

La visualizzazione Service Graph visualizza le metriche di ampiezza (traccia i dati relativi a tassi, tassi di errore e durate (RED)) e i grafici dei servizi. Una volta impostati i requisiti, questa visualizzazione preconfigurata è immediatamente disponibile.

Per ulteriori informazioni, consulta la pagina delle sorgenti dati di [Tempo](tempo-data-source.md). Puoi anche vedere la [pagina di visualizzazione del grafico dei servizi](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) nella *documentazione di Tempo*.

# Inspector in Explore
<a name="v9-explore-inspector"></a>

****  
**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 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)

L'ispettore ti aiuta a comprendere e risolvere le tue domande. È possibile ispezionare i dati grezzi, esportarli in un file con valori separati da virgole (CSV), esportare i risultati del registro in formato TXT e visualizzare le richieste di query.

## Interfaccia utente Inspector
<a name="v9-explore-inspector-ui"></a>

L'ispettore ha le seguenti schede:
+ **Scheda Statistiche**: mostra quanto tempo impiega la query e quanto restituisce.
+ **Scheda Query**: mostra le richieste al server inviate quando Grafana interroga l'origine dati.
+ **Scheda JSON**: consente di visualizzare e copiare i dati JSON e la struttura del frame di dati JSON.
+ **Scheda Dati**: mostra i dati grezzi restituiti dalla query.
+ **Scheda Errore**: mostra l'errore. Visibile solo quando la query restituisce un errore.

## Compiti di Inspector
<a name="v9-explore-inspector-tasks"></a>

È possibile eseguire diverse attività nell'ispettore Explore.

**Apri l'Inspector**

Dopo aver eseguito l'interrogazione che desideri ispezionare, seleziona il pulsante **Inspector**.

Il riquadro Inspector si apre nella parte inferiore dello schermo.

*Esamina i risultati grezzi delle interrogazioni*

È possibile visualizzare i risultati non elaborati delle query, ossia i dati restituiti dall'interrogazione in una tabella.

Nella scheda **Inspector**, fate clic sulla scheda **Dati**.

Per interrogazioni multiple o per interrogazioni su più nodi, sono disponibili opzioni aggiuntive.
+ **Mostra frame di dati:** seleziona i dati del set di risultati che desideri visualizzare.
+ **Serie unite per ora:** visualizza i dati grezzi di tutte le tue query contemporaneamente, un set di risultati per colonna. Puoi fare clic sull'intestazione di una colonna per ordinare i dati.

**Scarica i risultati non elaborati delle query in formato CSV**

Dopo aver visualizzato i risultati non elaborati dell'interrogazione, puoi generare un file CSV dei risultati. Otterrete un file CSV del risultato visualizzato, quindi assicuratevi di rifinire i risultati per ottenere i risultati desiderati prima di generare il file CSV.

**Per generare il file CSV, seleziona **Scarica CSV nella scheda** Inspector.**

**Per scaricare un file CSV formattato specificamente per Excel, espandi **le opzioni Dati** e attiva l'interruttore **Scarica per Excel** prima di selezionare l'opzione Scarica CSV.**

*Scarica i risultati del registro in formato TXT*

**È possibile generare un file TXT dei registri attualmente visualizzati selezionando **Scarica registri** nella scheda Inspector.**

**Scarica i risultati della traccia**

In base al tipo di origine dati, Grafana può generare un file JSON per i risultati di traccia in uno dei formati supportati: Jaeger, Zipkin o OTLP.

Per scaricare le tracce, seleziona **Scarica tracce** nella scheda **Inspector**.

**Ispeziona le prestazioni delle interrogazioni**

La scheda **Statistiche** mostra le statistiche che indicano la durata della query, il numero di query inviate e il numero di righe restituite. Queste informazioni possono aiutarti a risolvere i problemi delle tue query, soprattutto se uno qualsiasi dei numeri è inaspettatamente alto o basso.

Le statistiche sono di sola lettura.

**Visualizza il modello JSON**

Puoi esplorare ed esportare dati e modelli JSON di frame di dati.

**Per visualizzare il modello JSON**

1. Nel pannello Inspector, fate clic sulla scheda **JSON**.

1. Dal menu a discesa **Seleziona sorgente**, scegliete una delle seguenti opzioni:
   + **Dati**: visualizza un oggetto JSON che rappresenta i dati restituiti a Explore.
   + **DataFrame struttura**: visualizza il set di risultati non elaborato.

1. È possibile espandere o comprimere parti del file JSON per visualizzare sezioni separate. Puoi anche selezionare l'opzione Copia **negli appunti per copiare** il corpo JSON e incollarlo in un'altra applicazione.

**Visualizza la richiesta e la risposta non elaborate alla fonte di dati**

Mentre lavori con Explore e la scheda Inspector, puoi visualizzare i dati grezzi di richiesta e risposta che stai generando con una query. In Inspector, seleziona la scheda **Query** e scegli **Aggiorna** per visualizzare i dati grezzi.

Grafana invia la query al server e visualizza il risultato. È possibile approfondire parti specifiche della query, espanderla o comprimerla interamente o copiare i dati negli appunti per utilizzarli in altre applicazioni.

# Avvisi nella versione 9 di Grafana
<a name="v9-alerts"></a>

****  
**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 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)

Gli avvisi Grafana ti forniscono avvisi affidabili e utilizzabili che ti aiutano a conoscere i problemi nei sistemi subito dopo che si sono verificati, riducendo al minimo l'interruzione dei tuoi servizi.

Amazon Managed Grafana include l'accesso a un sistema di avvisi aggiornato, *Grafana alerting, che centralizza le informazioni sugli avvisi* in un'unica visualizzazione ricercabile. Include le seguenti funzionalità:
+ Crea e gestisci avvisi Grafana in una vista centralizzata.
+ Crea e gestisci avvisi gestiti da Cortex e Loki tramite un'unica interfaccia.
+ Visualizza le informazioni sugli avvisi da Prometheus, Amazon Managed Service for Prometheus e altre fonti di dati compatibili con Alertmanager.

Quando crei il tuo spazio di lavoro Amazon Managed Grafana, puoi scegliere se utilizzare gli avvisi Grafana o il. [Avvisi classici del pannello di controllo](old-alerts-overview.md) Questa sezione tratta gli avvisi Grafana.

**Nota**  
Se hai creato il tuo spazio di lavoro con gli avvisi classici abilitati e desideri passare agli avvisi Grafana, puoi [passare](v9-alerting-use-grafana-alerts.md) da un sistema di avviso all'altro. .

## Limitazioni degli avvisi Grafana
<a name="v9-alert-limitations"></a>
+ Il sistema di avvisi Grafana può recuperare le regole da tutte le fonti di dati Amazon Managed Service per Prometheus, Prometheus, Loki e Alertmanager disponibili. Potrebbe non essere in grado di recuperare le regole da altre fonti di dati supportate.
+ Le regole di avviso definite in Grafana, anziché in Prometheus, inviano più notifiche al tuo punto di contatto. Se utilizzi avvisi Grafana nativi, ti consigliamo di continuare con gli avvisi Grafana classici e di non abilitare la nuova funzionalità di avviso Grafana. Se desideri visualizzare gli avvisi definiti nella tua fonte di dati Prometheus, ti consigliamo di abilitare Grafana Alerting, che invia una sola notifica per gli avvisi creati in Prometheus Alertmanager.
**Nota**  
Questa limitazione non è più una limitazione nelle aree di lavoro Amazon Managed Grafana che supportano Grafana v10.4 e versioni successive.

**Topics**
+ [Limitazioni degli avvisi Grafana](#v9-alert-limitations)
+ [Panoramica di](v9-alerting-overview.md)
+ [Esplorazione degli avvisi](v9-alerting-explore.md)
+ [Configurare gli avvisi](v9-alerting-setup.md)
+ [Migrazione degli avvisi della dashboard classica agli avvisi Grafana](v9-alerting-use-grafana-alerts.md)
+ [Gestisci le tue regole di avviso](v9-alerting-managerules.md)
+ [Gestisci le notifiche di avviso](v9-alerting-managenotifications.md)

# Panoramica di
<a name="v9-alerting-overview"></a>

****  
**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 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)

Quanto segue offre una panoramica di come funziona Grafana Alerting e presenta alcuni dei concetti chiave che interagiscono e costituiscono il fulcro del suo motore di avvisi flessibile e potente.

1. **Origine dati**

   Si connette ai dati da utilizzare tramite avvisi. Questi dati sono spesso dati di serie temporali, servono per avvisi e mostrano i dettagli di un sistema da monitorare e analizzare. Per ulteriori informazioni, consulta le fonti di [dati](AMG-data-sources-builtin.md).

1. **Regole di avviso**

   Imposta i criteri di valutazione che determinano se un'istanza di avviso verrà attivata. Una regola di avviso è costituita da una o più query ed espressioni per estrarre dati dall'origine dati, da una condizione che descrive la necessità di un avviso, la frequenza di valutazione e, facoltativamente, la durata per cui la condizione deve essere soddisfatta affinché venga attivato un avviso.

   Gli avvisi gestiti Grafana supportano gli avvisi multidimensionali, il che significa che ogni regola di avviso può creare più istanze di avviso. Questo è eccezionalmente potente se si osservano più serie in una singola espressione.

1. **Etichette**

   Abbina una regola di avviso e le relative istanze alle politiche di notifica e ai silenzi. Possono essere utilizzati anche per raggruppare gli avvisi in base alla gravità.

1. **Politiche di notifica**

   Imposta dove, quando e come vengono indirizzati gli avvisi per avvisare il team quando viene attivato l'avviso. Ogni politica di notifica specifica una serie di etichette corrispondenti per indicare di quali avvisi è responsabile. A una politica di notifica è assegnato un punto di contatto costituito da uno o più notificanti.

1. **Punti di contatto**

   Definisci in che modo i tuoi contatti vengono avvisati quando viene attivato un avviso. Supportiamo una moltitudine di ChatOps strumenti per garantire che gli avvisi arrivino al tuo team.

## Funzionalità
<a name="v9-alerting-features"></a>

**Una pagina per tutti gli avvisi**

Un'unica pagina Grafana Alerting consolida sia gli avvisi gestiti da Grafana che gli avvisi che risiedono nella fonte di dati compatibile con Prometheus in un unico posto.

**Avvisi multidimensionali**

Le regole di avviso possono creare più istanze di avviso individuali per regola di avviso, note come avvisi multidimensionali, offrendoti la potenza e la flessibilità necessarie per ottenere visibilità sull'intero sistema con un solo avviso.

**Avvisi di routing**

Indirizza ogni istanza di avviso verso un punto di contatto specifico in base alle etichette che definisci. Le politiche di notifica sono l'insieme di regole relative a dove, quando e come gli avvisi vengono indirizzati ai punti di contatto.

**Silenziamento degli avvisi**

I silenzi consentono di interrompere la ricezione di notifiche persistenti da una o più regole di avviso. È inoltre possibile sospendere parzialmente un avviso in base a determinati criteri. Silences dispone di una sezione dedicata per una migliore organizzazione e visibilità, in modo da poter scansionare le regole degli avvisi in pausa senza ingombrare la visualizzazione principale degli avvisi.

**Tempi di silenziamento**

Con gli orari di silenziamento, puoi specificare un intervallo di tempo in cui non desideri che vengano generate o inviate nuove notifiche. Puoi anche bloccare le notifiche di avviso per periodi di tempo ricorrenti, ad esempio durante un periodo di manutenzione.

# Esplorazione degli avvisi
<a name="v9-alerting-explore"></a>

****  
**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 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)

Che tu stia iniziando o espandendo l'implementazione di Grafana Alerting, scopri di più sui concetti chiave e sulle funzionalità disponibili che ti aiutano a creare, gestire e agire sui tuoi avvisi e a migliorare la capacità del tuo team di risolvere rapidamente i problemi.

Prima di tutto, diamo un'occhiata ai diversi tipi di regole di avviso offerti da Grafana Alerting.

## Tipi di regole di avviso
<a name="v9-alerting-explore-rule-types"></a>

**Regole gestite da Grafana**

Le regole gestite da Grafana sono il tipo di regola di avviso più flessibile. Ti consentono di creare avvisi che possono agire sui dati provenienti da qualsiasi delle nostre fonti di dati supportate. Oltre a supportare più fonti di dati, puoi anche aggiungere espressioni per trasformare i dati e impostare condizioni di avviso. Questo è l'unico tipo di regola che consente di inviare avvisi da più fonti di dati in un'unica definizione di regola.

**Regole di Mimir e Loki**

Per creare avvisi Mimir o Loki devi disporre di un'origine dati Prometheus o Loki compatibile. Puoi verificare se la tua origine dati supporta la creazione di regole tramite Grafana testando l'origine dati e osservando se l'API del righello è supportata.

**Regole di registrazione**

Le regole di registrazione sono disponibili solo per le fonti di dati Prometheus o Loki compatibili. Una regola di registrazione consente di precalcolare le espressioni più necessarie o computazionalmente costose e di salvarne il risultato in un nuovo set di serie temporali. Ciò è utile se si desidera eseguire avvisi su dati aggregati o se si dispone di dashboard che eseguono ripetutamente query su espressioni computazionalmente costose.

## Concetti e caratteristiche chiave
<a name="v9-alerting-explore-features"></a>

La tabella seguente include un elenco di concetti chiave, funzionalità e relative definizioni, progettato per aiutarti a sfruttare al meglio gli avvisi Grafana.


| Concetto o funzionalità chiave | Definizione | 
| --- | --- | 
|  Fonti di dati per gli avvisi  |  Seleziona le fonti di dati da cui desideri interrogare e visualizzare metriche, log e tracce.  | 
|  Fornitura di avvisi  |  Gestisci le tue risorse di avviso e inseriscile nel tuo sistema Grafana utilizzando il provisioning dei file o Terraform.  | 
|  Gestore degli avvisi  |  Gestisce il routing e il raggruppamento delle istanze di avviso.  | 
|  Regola di avviso  |  Una serie di criteri di valutazione per stabilire quando una regola di avviso deve essere attivata. Una regola di avviso è costituita da una o più interrogazioni ed espressioni, da una condizione, dalla frequenza di valutazione e dalla durata della soddisfazione della condizione. Una regola di avviso può generare più istanze di avviso.  | 
|  Istanza di avviso  |  Un'istanza di avviso è un'istanza di una regola di avviso. Una regola di avviso monodimensionale ha un'istanza di avviso. Una regola di avviso multidimensionale ha una o più istanze di avviso. Una singola regola di avviso che corrisponde a più risultati, ad esempio CPU contro 10 VMs, viene contata come istanze di avviso multiple (in questo caso 10). Questo numero può variare nel tempo. Ad esempio, una regola di avviso che monitora l'utilizzo della CPU per tutti gli utenti VMs di un sistema include più istanze di avviso man mano che VMs vengono aggiunte. Per ulteriori informazioni sulle quote di istanze di avviso, vedere. [Errori relativi alla quota raggiunta](v9-alerting-managerules-grafana.md#v9-alerting-rule-quota-reached)  | 
|  Gruppo di avvisi  |  Alertmanager raggruppa le istanze di avviso per impostazione predefinita utilizzando le etichette per la politica di notifica principale. Questo controlla la deduplicazione e i gruppi di istanze di avviso, che vengono inviate ai punti di contatto.  | 
|  Punto di contatto  |  Definisci in che modo i tuoi contatti vengono avvisati quando viene attivata una regola di avviso.  | 
|  Modello di messaggio  |  Crea modelli personalizzati riutilizzabili e usali nei punti di contatto.  | 
|  Politica di notifica  |  Set di regole per dove, quando e come gli avvisi vengono raggruppati e indirizzati ai punti di contatto.  | 
|  Etichette e abbinatori di etichette  |  Le etichette identificano in modo univoco le regole di avviso. Collegano le regole di avviso alle politiche e ai silenzi di notifica, determinando quale politica deve gestirle e quali regole di avviso devono essere silenziate.  | 
|  Silenzi  |  Blocca le notifiche provenienti da una o più istanze di avviso. La differenza tra un intervallo di silenzio e uno di silenziamento è che un silenzio dura solo per un periodo di tempo specificato, mentre un intervallo di silenziamento è pensato per essere ricorrente in base a una pianificazione. Utilizza gli abbinatori di etichette per silenziare le istanze di avviso.  | 
|  Tempi di silenziamento  |  Specificate un intervallo di tempo in cui non desiderate che vengano generate o inviate nuove notifiche. Puoi anche bloccare le notifiche di avviso per periodi di tempo ricorrenti, ad esempio durante un periodo di manutenzione. Deve essere collegato a una politica di notifica esistente.  | 

# Origini dati
<a name="v9-alerting-explore-datasources"></a>

****  
**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 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)

Esistono diverse [fonti di dati](AMG-data-sources-builtin.md) compatibili con Grafana Alerting. Ogni fonte di dati è supportata da un plugin. Puoi utilizzare una delle fonti di dati integrate elencate di seguito.

Queste sono le fonti di dati compatibili e supportate da Amazon Managed Grafana.
+ [Connect a un'origine dati Alertmanager](data-source-alertmanager.md)
+ [Connect a una fonte di CloudWatch dati Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connect a una fonte OpenSearch di dati Amazon Service](using-Amazon-OpenSearch-in-AMG.md)
+ [Connect a un'origine AWS IoT SiteWise dati](using-iotsitewise-in-AMG.md)
+ [Connect a una fonte di AWS IoT TwinMaker dati](AMG-iot-twinmaker.md)
+ [Connect ad Amazon Managed Service for Prometheus e alle fonti di dati Prometheus open source](prometheus-data-source.md)
+ [Connettiti a una fonte di dati Amazon Timestream](timestream-datasource.md)
+ [Connect a una fonte di dati Amazon Athena](AWS-Athena.md)
+ [Connect a una fonte di dati Amazon Redshift](AWS-Redshift.md)
+ [Connect a un'origine AWS X-Ray dati](x-ray-data-source.md)
+ [Connect a un'origine dati di Azure Monitor](using-azure-monitor-in-AMG.md)
+ [Connect a una fonte di dati di Google Cloud Monitoring](using-google-cloud-monitoring-in-grafana.md)
+ [Connect a una fonte di dati Graphite](using-graphite-in-AMG.md)
+ [Connect a una fonte di dati InfluxDB](using-influxdb-in-AMG.md)
+ [Connect a una fonte di dati Loki](using-loki-in-AMG.md)
+ [Connect a un'origine dati Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [Connect a una fonte di dati MySQL](using-mysql-in-AMG.md)
+ [Connect a un'origine dati OpenTSDB](using-opentsdb-in-AMG.md)
+ [Connect a un'origine dati PostgreSQL](using-postgresql-in-AMG.md)
+ [Connect a una fonte di dati Jaeger](jaeger-data-source.md)
+ [Connect a una fonte di dati Zipkin](zipkin-data-source.md)
+ [Connect a una sorgente dati Tempo](tempo-data-source.md)
+ [Configurare un'origine TestData dati per i test](testdata-data-source.md)

# Informazioni sulle regole di avviso
<a name="v9-alerting-explore-rules"></a>

****  
**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 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)

Una regola di avviso è un insieme di criteri di valutazione che determina se un'istanza di avviso verrà attivata. La regola è costituita da una o più interrogazioni ed espressioni, una condizione, la frequenza di valutazione e, facoltativamente, la durata per la quale la condizione viene soddisfatta.

Mentre le interrogazioni e le espressioni selezionano il set di dati da valutare, una condizione imposta la soglia che un avviso deve soddisfare o superare per creare un avviso.

Un intervallo specifica la frequenza con cui viene valutata una regola di avviso. La durata, se configurata, indica per quanto tempo deve essere soddisfatta una condizione. Le regole di avviso possono anche definire il comportamento di avviso in assenza di dati.

**Topics**
+ [Tipi di regole di avviso](v9-alerting-explore-rules-types.md)
+ [Istanze di avviso](v9-alerting-rules-instances.md)
+ [Namespace e gruppi](v9-alerting-rules-grouping.md)
+ [Modello di notifica](v9-alerting-rules-notification-templates.md)

# Tipi di regole di avviso
<a name="v9-alerting-explore-rules-types"></a>

****  
**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 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)

Grafana supporta diversi tipi di regole di avviso. Le seguenti sezioni ne spiegheranno i vantaggi e gli inconvenienti e ti aiuteranno a scegliere il tipo di avviso giusto per il tuo caso d'uso.

Regole gestite da Grafana

Le regole gestite da Grafana sono il tipo di regola di avviso più flessibile. Ti consentono di creare avvisi che possono agire sui dati provenienti da qualsiasi fonte di dati esistente.

Oltre a supportare qualsiasi fonte di dati, puoi aggiungere [espressioni](v9-panels-query-xform-expressions.md) per trasformare i dati ed esprimere le condizioni di avviso.

Regole di Mimir, Loki e Cortex

Per creare avvisi Mimir, Loki o Cortex devi disporre di un'origine dati Prometheus compatibile. Puoi verificare se la tua fonte di dati è compatibile testandola e controllando i dettagli se l'API del righello è supportata.

Regole di registrazione

Le regole di registrazione sono disponibili solo per fonti di dati Prometheus compatibili come Mimir, Loki e Cortex.

Una regola di registrazione consente di salvare il risultato di un'espressione in un nuovo set di serie temporali. Ciò è utile se desideri eseguire avvisi su dati aggregati o se disponi di dashboard che interrogano ripetutamente la stessa espressione.

Scopri di più sulle [regole di registrazione](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus.

# Istanze di avviso
<a name="v9-alerting-rules-instances"></a>

****  
**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 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)

Gli avvisi gestiti Grafana supportano gli avvisi multidimensionali. Ogni regola di avviso può creare più istanze di avviso. Ciò è utile se si osservano più serie in una singola espressione.

Considerate la seguente espressione PromQL:

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

Una regola che utilizza questa espressione creerà tante istanze di avviso quante sono CPUs state osservate durante la valutazione, permettendo a un'unica regola di riportare lo stato di ogni CPU.

# Namespace e gruppi
<a name="v9-alerting-rules-grouping"></a>

****  
**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 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)

Gli avvisi possono essere organizzati utilizzando regole e namespace gestiti da Folders for Grafana per le regole e i nomi dei gruppi di Mimir, Loki o Prometheus.

**Spazi dei nomi**

Quando si creano regole gestite da Grafana, la cartella può essere utilizzata per eseguire il controllo degli accessi e concedere o negare l'accesso a tutte le regole all'interno di una cartella specifica.

**Groups (Gruppi)**

**Tutte le regole all'interno di un gruppo vengono valutate allo stesso intervallo.**

Le regole di avviso e le regole di registrazione all'interno di un gruppo verranno sempre valutate **in sequenza**, il che significa che nessuna regola verrà valutata contemporaneamente e in ordine di apparizione.

**Suggerimento**  
Se desideri che le regole vengano valutate contemporaneamente e con intervalli diversi, valuta la possibilità di archiviarle in gruppi diversi.

# Modello di notifica
<a name="v9-alerting-rules-notification-templates"></a>

****  
**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 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 notifiche inviate tramite punti di contatto vengono create utilizzando modelli di notifica. I modelli predefiniti di Grafana si basano sul [sistema di template Go, in cui alcuni campi vengono valutati come testo, mentre altri vengono valutati come HTML (il che può influire](https://golang.org/pkg/text/template) sull'escape).

Il modello predefinito [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) è un utile riferimento per i modelli personalizzati.

Poiché la maggior parte dei campi dei punti di contatto può essere modellata, è possibile creare modelli personalizzati riutilizzabili e utilizzarli in più punti di contatto. Per maggiori informazioni sulle notifiche personalizzate tramite modelli, consulta. [Personalizza le notifiche](v9-alerting-notifications.md)

**Modelli annidati**

È possibile incorporare modelli all'interno di altri modelli.

Ad esempio, è possibile definire un frammento di modello utilizzando la `define` parola chiave.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

È quindi possibile incorporare modelli personalizzati all'interno di questo frammento utilizzando la parola chiave. `template` Esempio:

```
Alert summary:
{{ template "mytemplate" . }}
```

È possibile utilizzare una delle seguenti opzioni di modello integrate per incorporare modelli personalizzati.


| Name | Note | 
| --- | --- | 
|  `default.title`  |  Visualizza informazioni sullo stato di alto livello.  | 
|  `default.message`  |  Fornisce un riepilogo formattato degli allarmi attivati e risolti.  | 
|  `teams.default.message`  |  Simile a`default.messsage`, formattato per Microsoft Teams.  | 

**HTML nei modelli di notifica**

Il codice HTML nei modelli di notifica di avviso non è disponibile. Non supportiamo il rendering del codice HTML nella notifica risultante.

Alcuni notificanti supportano metodi alternativi per modificare l'aspetto della notifica risultante. Ad esempio, Grafana installa il modello base per avvisare le e-mail di. `<grafana-install-dir>/public/emails/ng_alert_notification.html` È possibile modificare questo file per cambiare l'aspetto di tutte le e-mail di avviso.

# Avvisi su dati numerici
<a name="v9-alerting-explore-numeric"></a>

****  
**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 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)

Questo argomento descrive come Grafana gestisce gli avvisi su dati numerici anziché su serie temporali.

Tra alcune fonti di dati, i dati numerici che non sono serie temporali possono essere avvisati direttamente o passati a Server Side Expressions (SSE). Ciò consente una maggiore elaborazione e la conseguente efficienza all'interno dell'origine dati e può anche semplificare le regole di avviso. Quando si inviano avvisi su dati numerici anziché su dati di serie temporali, non è necessario ridurre ogni serie temporale etichettata a un unico numero. I numeri etichettati vengono invece restituiti a Grafana.

**Dati tabulari**

Questa funzionalità è supportata con fonti di dati di backend che interrogano dati tabulari:
+ Origini dati SQL come MySQL, Postgres, MSSQL e Oracle.
+ I servizi basati su Azure Kusto: Azure Monitor (Logs), Azure Monitor (Azure Resource Graph) e Azure Data Explorer.

Una query con avvisi gestiti Grafana o SSE è considerata numerica con queste fonti di dati, se:
+ L'opzione «Format AS» è impostata su «Tabella» nella query sull'origine dei dati.
+ La risposta alla tabella restituita a Grafana dalla query include solo una colonna numerica (ad esempio int, double, float) e facoltativamente colonne di stringa aggiuntive.

Se sono presenti colonne di stringhe, tali colonne diventano etichette. Il nome della colonna diventa il nome dell'etichetta e il valore di ogni riga diventa il valore dell'etichetta corrispondente. Se vengono restituite più righe, ogni riga deve essere identificata in modo univoco con le relative etichette.

**Esempio**

Per una tabella MySQL chiamata «»: DiskSpace


| Orario | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
|  2021-7 giugno  |  web 1  |  /ecc  |  3  | 
|  2021-giugno-7  |  web 2  |  /var  |  4  | 
|  2021-7 giugno  |  web 3  |  /var  |  8  | 
|  ...  |  ...  |  ...  |  ...  | 

È possibile interrogare il filtraggio dei dati in tempo, ma senza restituire la serie temporale a Grafana. Ad esempio, un avviso che si attiva per ogni host o disco quando c'è meno del 5% di spazio libero:

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
   SELECT
      Host, 
      Disk, 
      Avg(PercentFree) 
   FROM DiskSpace
   Group By
      Host, 
      Disk 
   Where __timeFilter(Time)
```

Questa query restituisce la seguente risposta della Tabella a Grafana:


| Host | Disk | PercentFree | 
| --- | --- | --- | 
|  web1  |  /ecc  |  3  | 
|  web2  |  /var  |  4  | 
|  web 3  |  /var  |  0  | 

Quando questa query viene utilizzata come **condizione** in una regola di avviso, verrà inviata un'allerta con valori diversi da zero. Di conseguenza, vengono prodotte tre istanze di avviso:


| Etichette | Status | 
| --- | --- | 
|  \$1host=WEB1, disk=/etc\$1  |  Avviso  | 
|  \$1host=Web2, disco=/var\$1  |  Avviso  | 
|  \$1host=WEB3, disco=/var\$1  |  Normale  | 

# Etichette e annotazioni
<a name="v9-alerting-explore-labels"></a>

****  
**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 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 etichette e le annotazioni contengono informazioni su un avviso. Sia le etichette che le annotazioni hanno la stessa struttura: un insieme di valori denominati; tuttavia gli usi previsti sono diversi. Un esempio di etichetta o di annotazione equivalente potrebbe essere. `alertname="test"`

La differenza principale tra un'etichetta e un'annotazione è che le etichette vengono utilizzate per differenziare un avviso da tutti gli altri avvisi, mentre le annotazioni vengono utilizzate per aggiungere informazioni aggiuntive a un avviso esistente.

Ad esempio, considera due avvisi di CPU elevati: uno per e l'altro per. `server1` `server2` In questo esempio, potremmo avere un'etichetta chiamata `server` dove il primo avviso ha l'etichetta `server="server1"` e il secondo avviso ha l'etichetta`server="server2"`. Tuttavia, potremmo anche voler aggiungere una descrizione a ciascun avviso`"The CPU usage for server1 is above 75%."`, ad esempio, dove `server1` `75%` vengono sostituiti con il nome e l'utilizzo della CPU del server ([Modelli di etichette e annotazioni](v9-alerting-explore-labels-templating.md)per informazioni su come eseguire questa operazione, consulta la documentazione). Questo tipo di descrizione sarebbe più adatto come annotazione.

## Etichette
<a name="v9-alerting-explore-labels-labels"></a>

Le etichette contengono informazioni che identificano un avviso. Un esempio di etichetta potrebbe essere`server=server1`. Ogni avviso può avere più di un'etichetta e il set completo di etichette per un avviso è denominato set di etichette. È questo set di etichette che identifica l'avviso.

Ad esempio, un avviso potrebbe avere l'etichetta impostata `{alertname="High CPU usage",server="server1"}` mentre un altro avviso potrebbe avere l'etichetta impostata`{alertname="High CPU usage",server="server2"}`. Si tratta di due avvisi separati perché, sebbene le `alertname` etichette siano le stesse, le `server` etichette sono diverse.

L'etichetta impostata per un avviso è una combinazione delle etichette dell'origine dati, delle etichette personalizzate della regola di avviso e di una serie di etichette riservate come. `alertname`

**Etichette personalizzate**

Le etichette personalizzate sono etichette aggiuntive della regola di avviso. Come le annotazioni, le etichette personalizzate devono avere un nome e il loro valore può contenere una combinazione di testo e codice modello che viene valutata quando viene generato un avviso. [La documentazione su come creare modelli di etichette personalizzate è disponibile qui.](v9-alerting-explore-labels-templating.md)

Quando si utilizzano etichette personalizzate con modelli, è importante assicurarsi che il valore dell'etichetta non cambi tra valutazioni consecutive della regola di avviso, poiché ciò finirebbe per creare un gran numero di avvisi distinti. Tuttavia, è possibile che il modello produca valori di etichetta diversi per avvisi diversi. Ad esempio, non inserite il valore della query in un'etichetta personalizzata poiché ciò finirà per creare un nuovo set di avvisi ogni volta che il valore cambia. Utilizzate invece le annotazioni.

È inoltre importante assicurarsi che l'etichetta impostata per un avviso non contenga due o più etichette con lo stesso nome. Se un'etichetta personalizzata ha lo stesso nome di un'etichetta dell'origine dati, sostituirà quell'etichetta. Tuttavia, se un'etichetta personalizzata ha lo stesso nome di un'etichetta riservata, l'etichetta personalizzata verrà omessa dall'avviso.

## Annotazioni
<a name="v9-alerting-explore-labels-annotations"></a>

Le annotazioni sono coppie denominate che aggiungono informazioni aggiuntive agli avvisi esistenti. Ci sono una serie di annotazioni suggerite in Grafana `description` come`summary`,`runbook_url`, `dashboardUId` e. `panelId` Come le etichette personalizzate, le annotazioni devono avere un nome e il loro valore può contenere una combinazione di testo e codice modello che viene valutata quando viene generato un avviso. Se un'annotazione contiene codice modello, il modello viene valutato una volta quando viene generato l'avviso. Non viene rivalutato, anche quando l'avviso viene risolto. [La documentazione su come modellare le annotazioni è disponibile qui.](v9-alerting-explore-labels-templating.md)

# Come funziona l'abbinamento delle etichette
<a name="v9-alerting-explore-labels-matching"></a>

****  
**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 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)

Usa le etichette e gli abbinatori di etichette per collegare le regole di avviso alle politiche di notifica e ai silenzi. Ciò consente un modo molto flessibile di gestire le istanze di avviso, specificare quale politica deve gestirle e quali avvisi silenziare.

**Un label matchers è composto da 3 parti distinte, l'**etichetta**, il **valore e l'operatore**.**
+ Il campo **Etichetta** è il nome dell'etichetta da abbinare. Deve corrispondere esattamente al nome dell'etichetta.
+ Il campo **Valore** corrisponde al valore corrispondente per il nome dell'**etichetta** specificato. Il modo in cui corrisponde dipende dal valore **dell'operatore**.
+ Il campo **Operatore** è l'operatore da confrontare con il valore dell'etichetta. Gli operatori disponibili sono:


| Operatore | Description | 
| --- | --- | 
|  `=`  |  Seleziona etichette che siano esattamente uguali al valore.  | 
|  `!=`  |  Seleziona etichette che non sono uguali al valore.  | 
|  `=~`  |  Seleziona le etichette che corrispondono regolarmente al valore.  | 
|  `!~`  |  Seleziona etichette che non corrispondono in modo regolare al valore.  | 

Se si utilizzano più abbinatori di etichette, questi vengono combinati utilizzando l'operatore logico AND. Ciò significa che tutti gli abbinatori devono corrispondere per collegare una regola a una politica.

**Scenario di esempio**

Se definisci il seguente set di etichette per il tuo avviso:

```
{ foo=bar, baz=qux, id=12 }
```

quindi:
+ Un label matcher definito come `foo=bar` corrisponde a questa regola di avviso.
+ Un label matcher definito come *non `foo!=bar`* corrisponde a questa regola di avviso.
+ Un label matcher definito come `id=~[0-9]+` corrisponde a questa regola di avviso.
+ Un label matcher definito come `baz!~[0-9]+` corrisponde a questa regola di avviso.
+ Due label matcher definiti `foo=bar` e `id=~[0-9]+` corrispondenti a questa regola di avviso.

# Etichette in Grafana Alerting
<a name="v9-alerting-explore-labels-alerting"></a>

****  
**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 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)

Questo argomento spiega perché le etichette sono un componente fondamentale degli avvisi.
+ Il set completo di etichette per un avviso è ciò che identifica in modo univoco un avviso all'interno degli avvisi Grafana.
+ L'Alertmanager utilizza le etichette per abbinare gli avvisi per silenzi e gruppi di avvisi nelle politiche di notifica.
+ L'interfaccia utente di avviso mostra le etichette per ogni istanza di avviso generata durante la valutazione di quella regola.
+ I punti di contatto possono accedere alle etichette per generare dinamicamente notifiche contenenti informazioni specifiche sull'avviso che genera una notifica.
+ È possibile aggiungere etichette a una regola di [avviso.](v9-alerting-managerules.md) Le etichette sono configurabili manualmente, utilizzano funzioni modello e possono fare riferimento ad altre etichette. Le etichette aggiunte a una regola di avviso hanno la precedenza in caso di collisione tra etichette (tranne nel caso delle etichette riservate Grafana, vedi sotto per ulteriori informazioni).

**Compatibilità con Alertmanager esterno**

L'Alertmanager integrato di Grafana supporta sia le chiavi che i valori delle etichette Unicode. [Se si utilizza un Prometheus Alertmanager esterno, le chiavi delle etichette devono essere compatibili con il relativo modello di dati.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) **Ciò significa che le chiavi di etichetta devono contenere solo **lettere ASCII**, **numeri** e caratteri di sottolineatura e corrispondere all'espressione regolare.** `[a-zA-Z_][a-zA-Z0-9_]*` Tutti i caratteri non validi verranno rimossi o sostituiti dal motore di avviso Grafana prima di essere inviati all'Alertmanager esterno secondo le seguenti regole:
+ `Whitespace`verrà rimosso.
+ `ASCII characters`sarà sostituito con`_`.
+ `All other characters`verranno sostituiti con la loro rappresentazione esadecimale minuscola. Se questo è il primo carattere, verrà preceduto da. `_`

**Nota**  
Se più chiavi di etichetta vengono ridefinite con lo stesso valore, ai duplicati verrà aggiunto un breve hash dell'etichetta originale come suffisso.

**Etichette riservate Grafana**

**Nota**  
Le etichette con il prefisso `grafana_` sono riservate da Grafana per usi speciali. Se viene aggiunta un'etichetta configurata manualmente a partire da `grafana_` essa, può essere sovrascritta in caso di collisione.

Le etichette riservate Grafana possono essere utilizzate allo stesso modo delle etichette configurate manualmente. L'elenco attuale delle etichette riservate disponibili è:


| Etichetta | Description | 
| --- | --- | 
|  cartella\$1grafana  |  Titolo della cartella contenente l'avviso.  | 

# Modelli di etichette e annotazioni
<a name="v9-alerting-explore-labels-templating"></a>

****  
**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 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)

In Grafana, crei modelli di etichette e annotazioni proprio come faresti in Prometheus. Se hai già usato Prometheus, dovresti conoscere le variabili `$value` and, che contengono le etichette e `$labels` il valore dell'avviso. È possibile utilizzare le stesse variabili in Grafana, anche se l'avviso non utilizza un'origine dati Prometheus. Se non hai mai usato Prometheus prima, non preoccuparti perché ognuna di queste variabili e come modellarle ti verranno spiegate mentre segui il resto di questa pagina.

## Il linguaggio di template di Go
<a name="v9-alerting-explore-labels-templating-go"></a>

[I modelli per etichette e annotazioni sono scritti nel linguaggio di template di Go, text/template.](https://pkg.go.dev/text/template)

**Tag di apertura e chiusura**

In text/template, i modelli iniziano `{{` e finiscono con `}}` indipendentemente dal fatto che il modello stampi una variabile o esegua strutture di controllo come le istruzioni if. Questo è diverso da altri linguaggi di template come Jinja, dove la stampa di una variabile utilizza `{{` e e le strutture di controllo utilizzano e`}}`. `{%` `%}`

**Print (Stampa)**

Per stampare il valore di qualcosa usa e. `{{` `}}` È possibile stampare il risultato di una funzione o il valore di una variabile. Ad esempio, per stampare la `$labels` variabile devi scrivere quanto segue:

```
{{ $labels }}
```

**Iterate sulle etichette**

Per iterare su ogni etichetta `$labels` puoi usare un. `range` Qui `$k` si riferisce al nome e `$v` al valore dell'etichetta corrente. Ad esempio, se la tua query restituisse un'etichetta`instance=test`, allora `$k` lo sarebbe `instance` e `$v` lo sarebbe`test`.

```
{{ range $k, $v := $labels }}
{{ $k }}={{ $v }}
{{ end }}
```

## Le variabili labels, value e values
<a name="v9-alerting-explore-labels-templating-variables"></a>

**La variabile labels**

La `$labels` variabile contiene le etichette della query. Ad esempio, una query che verifica se un'istanza è inattiva potrebbe restituire un'etichetta di istanza con il nome dell'istanza inattiva. Ad esempio, supponiamo di avere una regola di avviso che si attiva quando una delle istanze rimane inattiva per più di 5 minuti. Desideri aggiungere un riepilogo all'avviso che indichi quale istanza è inattiva. Con la `$labels` variabile, puoi creare un riepilogo che stampa l'etichetta dell'istanza nel riepilogo:

```
Instance {{ $labels.instance }} has been down for more than 5 minutes
```

**Etichette con punti**

Se l'etichetta che desideri stampare contiene un punto (punto o punto) nel nome, l'utilizzo dello stesso punto nel modello non funzionerà:

```
Instance {{ $labels.instance.name }} has been down for more than 5 minutes
```

Questo perché il modello sta tentando di utilizzare un campo inesistente chiamato `name` in. `$labels.instance` Dovresti invece usare la `index` funzione, che stampa l'etichetta `instance.name` nella `$labels` variabile:

```
Instance {{ index $labels "instance.name" }} has been down for more than 5 minutes
```

**La variabile value**

La `$value` variabile funziona in modo diverso da Prometheus. In `$value` Prometheus è presente un numero in virgola mobile contenente il valore dell'espressione, mentre in Grafana è una stringa contenente le etichette e i valori di tutte le espressioni Threshold, Reduce e Math e Classic Conditions per questa regola di avviso. Non contiene i risultati delle interrogazioni, in quanto possono restituire da 10 a 10.000 righe o metriche.

Se dovessi utilizzare la `$value` variabile nel riepilogo di un avviso:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $value }})
```

Il riepilogo potrebbe essere simile al seguente:

```
api has an over 5% of responses with 5xx errors: [ var='B' labels={service=api} value=6.789 ]
```

Qui `var='B'` si fa riferimento all'espressione con RefID B. In Grafana, tutte le interrogazioni e le espressioni sono identificate da un RefID che identifica ogni query ed espressione in una regola di avviso. Analogamente `labels={service=api}` si riferisce alle etichette e si riferisce al valore. `value=6.789`

Avrete notato che non esiste un RefID A. Questo perché nella maggior parte delle regole di avviso il RefID A fa riferimento a una query e poiché le query possono restituire molte righe o serie temporali in cui non sono incluse. `$value`

**La variabile values**

Se la `$value` variabile contiene più informazioni del necessario, è possibile invece stampare le etichette e il valore delle singole espressioni utilizzando`$values`. Al contrario`$value`, la `$values` variabile è una tabella di oggetti contenente le etichette e i valori in virgola mobile di ciascuna espressione, indicizzati in base al relativo RefID.

Se dovessi stampare il valore dell'espressione con refID nel riepilogo `B` dell'avviso:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ $values.B }}%
```

Il riepilogo conterrà solo il valore:

```
api has an over 5% of responses with 5xx errors: 6.789%
```

Tuttavia, mentre `{{ $values.B }}` stampa il numero 6.789, in realtà si tratta di una stringa, poiché si stampa l'oggetto, che contiene sia le etichette che il valore per RefID B, non il valore in virgola mobile di B. Per utilizzare il valore a virgola mobile di RefID B è necessario utilizzare il campo da. `Value` `$values.B` Se dovessi umanizzare il valore in virgola mobile nel riepilogo di un avviso:

```
{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanize $values.B.Value }}%
```

**Nessun dato, errori di runtime e timeout**

Se la query inclusa nella regola di avviso non restituisce dati o ha esito negativo a causa di un errore nell'origine dati o di un timeout, anche tutte le espressioni Threshold, Reduce o Math che utilizzano quella query non restituiranno dati o un errore. Quando ciò accade, queste espressioni saranno assenti da. `$values` È buona norma verificare che sia presente un RefID prima di utilizzarlo, altrimenti il modello si interromperà nel caso in cui la query non restituisca dati o restituisca un errore. Puoi farlo usando un'istruzione if:

```
{{ if $values.B }}{{ $labels.service }} has over 5% of responses with 5xx errors: {{ humanizePercentage $values.B.Value }}{{ end }}
```

## Condizioni classiche
<a name="v9-alerting-explore-labels-templating-classic"></a>

Se la regola utilizza le condizioni classiche anziché le espressioni Threshold, Reduce e Math, la `$values` variabile viene indicizzata sia in base all'ID di riferimento che alla posizione della condizione nella condizione classica. Ad esempio, se hai una condizione classica con RefID B contenente due condizioni, allora `$values` conterrà due condizioni e. `B0` `B1`

```
The first condition is {{ $values.B0 }}, and the second condition is {{ $values.B1 }}
```

## Funzioni
<a name="v9-alerting-explore-labels-templating-functions"></a>

Le seguenti funzioni sono disponibili anche quando si espandono etichette e annotazioni:

**args**

La `args` funzione traduce un elenco di oggetti in una mappa con le chiavi arg0, arg1 ecc. Questo ha lo scopo di consentire il passaggio di più argomenti ai modelli.

**Esempio**

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**URL esterno**

La `externalURL` funzione restituisce l'URL esterno del server Grafana come configurato nei file ini.

**Esempio**

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

La `graphLink` funzione restituisce il percorso della visualizzazione grafica [Esplora nella versione 9 di Grafana](v9-explore.md) per l'espressione e l'origine dati specificate.

**Esempio**

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**umanizzare**

La `humanize` funzione umanizza i numeri decimali.

**Esempio**

```
{{ humanize 1000.0 }}
```

```
1k
```

**umanizza 1024**

`humanize1024`Funziona in modo simile `humanize` ma utilizza 1024 come base anziché 1000.

**Esempio**

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**Durata umanizzata**

La `humanizeDuration` funzione umanizza una durata in secondi.

**Esempio**

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**Umanizza la percentuale**

La `humanizePercentage` funzione umanizza un valore di rapporto rispetto a una percentuale.

**Esempio**

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**Umanizza il timestamp**

La `humanizeTimestamp` funzione umanizza un timestamp Unix.

**Esempio**

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**partita**

La `match` funzione abbina il testo a un modello di espressione regolare.

**Esempio**

```
{{ match "a.*" "abc" }}
```

```
true
```

**PathPrefix**

La `pathPrefix` funzione restituisce il percorso del server Grafana come configurato nei file ini.

**Esempio**

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

La `tableLink` funzione restituisce il percorso della vista tabulare [Esplora nella versione 9 di Grafana](v9-explore.md) per l'espressione e l'origine dati specificate.

**Esempio**

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**titolo**

La `title` funzione rende maiuscolo il primo carattere di ogni parola.

**Esempio**

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**a Lower**

La `toLower` funzione restituisce tutto il testo in lettere minuscole.

**Esempio**

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**a TOUPPER**

La `toUpper` funzione restituisce tutto il testo in maiuscolo.

**Esempio**

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

La `reReplaceAll` funzione sostituisce il testo corrispondente all'espressione regolare.

**Esempio**

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Stato e integrità delle regole di allarme
<a name="v9-alerting-explore-state"></a>

****  
**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 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)

Lo stato e lo stato di integrità delle regole di avviso consentono di comprendere diversi indicatori chiave di stato relativi agli avvisi.

Esistono tre componenti chiave: stato della *regola di avviso, stato* dell'*istanza di avviso e stato* della *regola di avviso*. Sebbene correlati, ogni componente trasmette informazioni leggermente diverse.

**Stato della regola di avviso**

Una regola di avviso può trovarsi in uno dei seguenti stati:


| Stato | Description | 
| --- | --- | 
|  Normale  |  Nessuna delle serie temporali restituite dal motore di valutazione è in `Firing` stato `Pending` or.  | 
|  Pending (In attesa)  |  Almeno una serie temporale restituita dal motore di valutazione è`Pending`.  | 
|  Sparare  |  Almeno una serie temporale restituita dal motore di valutazione è`Firing`.  | 

**Nota**  
Gli avvisi passeranno prima a `pending` e poi`firing`, quindi occorreranno almeno due cicli di valutazione prima che venga attivato un avviso.

**Stato dell'istanza di avviso**

Un'istanza di avviso può trovarsi in uno dei seguenti stati:


| Stato | Description | 
| --- | --- | 
|  Normale  |  Lo stato di un avviso che non è né attivo né in sospeso, tutto funziona correttamente.  | 
|  Pending (In attesa)  |  Lo stato di un avviso che è stato attivo per un periodo inferiore alla durata della soglia configurata.  | 
|  Avviso  |  Lo stato di un avviso che è stato attivo per un periodo superiore alla durata della soglia configurata.  | 
|  NoData  |  Non è stato ricevuto alcun dato per la finestra temporale configurata.  | 
|  Errore  |  L'errore che si è verificato durante il tentativo di valutare una regola di avviso.  | 

**Stato della regola di avviso**

Una regola di avviso può avere uno dei seguenti stati di integrità:


| Stato | Description | 
| --- | --- | 
|  Ok  |  Nessun errore durante la valutazione di una regola di avviso.  | 
|  Errore  |  Si è verificato un errore durante la valutazione di una regola di avviso.  | 
|  NoData  |  L'assenza di dati in almeno una serie temporale restituita durante la valutazione di una regola.  | 

**Avvisi speciali per `NoData` e `Error`**

Quando la valutazione di una regola di avviso produce lo stato `NoData` o`Error`, Grafana Alerting genererà istanze di avviso con le seguenti etichette aggiuntive:


| Etichetta | Description | 
| --- | --- | 
|  nome dell'avviso  |  In uno `DatasourceNoData` o `DatasourceError` in base allo stato.  | 
|  datasource\$1uid  |  L'UID della fonte di dati che ha causato lo stato.  | 

È possibile gestire questi avvisi allo stesso modo degli avvisi normali aggiungendo un silenzio, un indirizzamento verso un punto di contatto e così via.

# Punti di contatto
<a name="v9-alerting-explore-contacts"></a>

****  
**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 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)

Utilizza i punti di contatto per definire in che modo i tuoi contatti vengono avvisati quando viene attivata una regola di avviso. Un punto di contatto può avere uno o più tipi di punti di contatto, ad esempio email, Slack, webhook e così via. Quando viene attivata una regola di avviso, viene inviata una notifica a tutti i tipi di punti di contatto elencati per un punto di contatto. I punti di contatto possono essere configurati per Grafana Alertmanager e per gestori di avvisi esterni.

Puoi anche utilizzare i modelli di notifica per personalizzare i messaggi di notifica per i tipi di punti di contatto.

**Tipi di punti di contatto supportati**

La tabella seguente elenca i tipi di punti di contatto supportati da Grafana.


| Name | Tipo | 
| --- | --- | 
|  Amazon SNS  |  `sns`  | 
|  OpsGenie  |  `opsgenie`  | 
|  Pager Duty  |  `pagerduty`  | 
|  Slack  |  `slack`  | 
|  VictorOps  |  `victorops`  | 

Per ulteriori informazioni sui punti di contatto, vedere [Lavorare con i punti di contatto](v9-alerting-contact-points.md) e[Personalizza le notifiche](v9-alerting-notifications.md).

# Notifications
<a name="v9-alerting-explore-notifications"></a>

****  
**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 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)

Grafana utilizza Alertmanager per inviare notifiche di attivazione e avvisi risolti. [Grafana ha il proprio Alertmanager, denominato «Grafana» nell'interfaccia utente, ma supporta anche l'invio di notifiche da altri Alertmanager, come Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/) Grafana Alertmanager utilizza politiche di notifica e punti di contatto per configurare come e dove inviare una notifica, con quale frequenza deve essere inviata una notifica e se gli avvisi devono essere inviati tutti nella stessa notifica, inviati in notifiche raggruppate sulla base di un set di etichette o come notifiche separate.

## Politiche di notifica
<a name="v9-alerting-explore-notifications-policies"></a>

Le politiche di notifica controllano quando e dove vengono inviate le notifiche. Una politica di notifica può scegliere di inviare tutti gli avvisi insieme nella stessa notifica, inviare avvisi in notifiche raggruppate in base a un set di etichette o inviare avvisi come notifiche separate. È possibile configurare ogni politica di notifica per controllare la frequenza di invio delle notifiche e disporre di uno o più orari di silenziamento per inibire le notifiche in determinate ore del giorno e in determinati giorni della settimana.

Le politiche di notifica sono organizzate in una struttura ad albero in cui alla radice dell'albero è presente una politica di notifica chiamata politica principale. Può esistere una sola politica principale e la politica principale non può essere eliminata.

Le politiche di routing specifiche sono figli della politica principale e possono essere utilizzate per abbinare tutti gli avvisi o un sottoinsieme di avvisi in base a un set di etichette corrispondenti. Una politica di notifica corrisponde a un avviso quando le etichette corrispondenti corrispondono alle etichette dell'avviso.

Una politica di routing specifica può avere politiche secondarie proprie, chiamate politiche annidate, che consentono una corrispondenza aggiuntiva degli avvisi. Un esempio di policy di routing specifica potrebbe essere l'invio di avvisi di infrastruttura al team Ops; mentre una policy secondaria potrebbe inviare avvisi ad alta priorità a Pagerduty e avvisi a bassa priorità a Slack.

Tutti gli avvisi, indipendentemente dalle loro etichette, corrispondono alla policy principale. Tuttavia, quando la politica principale riceve un avviso, esamina ogni politica di routing specifica e invia l'avviso alla prima politica di routing specifica che corrisponde all'avviso. Se la politica di routing specifica prevede ulteriori politiche secondarie, può tentare di abbinare l'avviso a una delle sue politiche annidate. Se nessuna politica annidata corrisponde all'avviso, la politica di routing specifica è la politica di routing corrispondente. Se non esistono politiche di routing specifiche o nessuna politica di routing specifica corrisponde all'avviso, la politica principale è la politica corrispondente.

## Punti di contatto
<a name="v9-alerting-explore-notifications-contacts"></a>

I punti di contatto contengono la configurazione per l'invio di notifiche. Un punto di contatto è un elenco di integrazioni, ognuna delle quali invia una notifica a un particolare indirizzo e-mail, servizio o URL. I punti di contatto possono avere più integrazioni dello stesso tipo o una combinazione di integrazioni di diverso tipo. Ad esempio, un punto di contatto potrebbe contenere un'integrazione Pager Duty, un'integrazione Pager Duty e Slack o un'integrazione Pager Duty, un'integrazione Slack e due integrazioni Amazon SNS. Puoi anche configurare un punto di contatto senza integrazioni, nel qual caso non vengono inviate notifiche.

Un punto di contatto non può inviare notifiche finché non è stato aggiunto a una politica di notifica. Una politica di notifica può inviare avvisi solo a un punto di contatto, ma un punto di contatto può essere aggiunto a più politiche di notifica contemporaneamente. Quando un avviso corrisponde a un criterio di notifica, l'avviso viene inviato al punto di contatto in quella politica di notifica, che quindi invia una notifica a ciascuna integrazione nella relativa configurazione.

**Nota**  
Per informazioni sulle integrazioni supportate per i punti di contatto, consulta[Punti di contatto](v9-alerting-explore-contacts.md).

## Modelli di notifiche
<a name="v9-alerting-explore-notifications-templating"></a>

Puoi personalizzare le notifiche con modelli. Ad esempio, i modelli possono essere utilizzati per modificare il titolo e il messaggio delle notifiche inviate a Slack.

I modelli non si limitano a una singola integrazione o a un singolo punto di contatto, ma possono essere utilizzati in diverse integrazioni nello stesso punto di contatto e persino in integrazioni tra diversi punti di contatto. Ad esempio, un utente Grafana può creare un modello chiamato `custom_subject_or_title` e utilizzarlo sia per gli argomenti dei modelli in Pager Duty che per i titoli dei messaggi Slack senza dover creare due modelli separati.

Tutti i modelli di notifica sono scritti nel [linguaggio dei modelli di Go](https://pkg.go.dev/text/template) e si trovano nella scheda Punti di contatto della pagina Avvisi.

## Silenzi
<a name="v9-alerting-explore-notifications-silences"></a>

Puoi usare i silenzi per disattivare le notifiche provenienti da una o più regole di attivazione. I silenzi non impediscono che gli avvisi si attivino o vengano risolti, né nascondono gli avvisi di attivazione nell'interfaccia utente. Un silenzio dura quanto la sua durata, che può essere configurata in minuti, ore, giorni, mesi o anni.

# Configurare gli avvisi
<a name="v9-alerting-setup"></a>

****  
**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 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)

Configura le funzionalità e le integrazioni di cui hai bisogno per creare e gestire i tuoi avvisi.

**Topics**
+ [Aggiungere un Alertmanager esterno](v9-alerting-setup-alertmanager.md)
+ [Fornitura di risorse Grafana Alerting](v9-alerting-setup-provision.md)

# Aggiungere un Alertmanager esterno
<a name="v9-alerting-setup-alertmanager"></a>

****  
**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 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)

Configura Grafana per utilizzare un Alertmanager esterno come unico Alertmanager per ricevere tutti i tuoi avvisi. Questo Alertmanager esterno può quindi essere configurato e amministrato dall'interno di Grafana stessa.

Dopo aver aggiunto Alertmanager, puoi utilizzare l'interfaccia utente Grafana Alerting per gestire silenzi, punti di contatto e politiche di notifica. Un'opzione a discesa in queste pagine consente di passare da un gestore di avvisi all'altro.

**Nota**  
A partire da Grafana 9.2, la configurazione URL dei gestori di avvisi esterni dalla scheda Amministrazione nella pagina Avvisi è obsoleta. Verrà rimosso in una versione futura.

I gestori di avvisi esterni dovrebbero ora essere configurati come fonti di dati utilizzando Grafana Configuration dal menu di navigazione principale di Grafana. Ciò consente di gestire i punti di contatto e le politiche di notifica dei gestori di avvisi esterni dall'interno di Grafana e crittografa anche le credenziali di autenticazione di base HTTP che in precedenza erano visibili durante la configurazione dei gestori di avvisi esterni tramite URL.

Per aggiungere un Alertmanager esterno, completa i seguenti passaggi.

1. Fai clic su Configurazione, quindi su Origini dati.

1. Cerca Alertmanager.

1. Scegli la tua implementazione e compila i campi della pagina, come richiesto.

   Se stai effettuando il provisioning della tua fonte di dati, imposta il flag `handleGrafanaManagedAlerts` nel `jsonData` campo per inviare avvisi gestiti da Grafana `true` a questo Alertmanager.
**Nota**  
Sono supportate le implementazioni Prometheus, Grafana Mimir e Cortex di Alertmanager. Per Prometheus, i punti di contatto e le politiche di notifica sono di sola lettura nell'interfaccia utente di Grafana Alerting.

1. Fai clic su Salva e prova.

# Fornitura di risorse Grafana Alerting
<a name="v9-alerting-setup-provision"></a>

****  
**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 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)

L'infrastruttura di allarme è spesso complessa, con molte parti della pipeline che spesso risiedono in luoghi diversi. La scalabilità di tutto questo tra più team e organizzazioni è un compito particolarmente impegnativo. Grafana Alerting Provisioning semplifica questo processo consentendoti di creare, gestire e mantenere i dati di avviso nel modo più adatto alla tua organizzazione.

Ci sono due opzioni tra cui scegliere:

1. Effettua il provisioning delle tue risorse di avviso utilizzando l'API HTTP Alerting Provisioning.
**Nota**  
In genere, non è possibile modificare le regole di avviso fornite tramite API dall'interfaccia utente di Grafana.  
Per abilitare la modifica, aggiungi l' x-disable-provenanceintestazione alle seguenti richieste quando crei o modifichi le regole di avviso nell'API:  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Fornisci le tue risorse di avviso utilizzando Terraform.

**Nota**  
Attualmente, il provisioning for Grafana Alerting supporta regole di avviso, punti di contatto, tempi di silenziamento e modelli. Le risorse di avviso fornite utilizzando il provisioning di file o Terraform possono essere modificate solo nella fonte che le ha create e non dall'interno di Grafana o da qualsiasi altra fonte. Ad esempio, se esegui il provisioning delle risorse di avviso utilizzando file dal disco, non puoi modificare i dati in Terraform o dall'interno di Grafana.

**Topics**
+ [Crea e gestisci risorse di avviso utilizzando Terraform](v9-alerting-setup-provision-terraform.md)
+ [Visualizzazione delle risorse di avviso assegnate a Grafana](v9-alerting-setup-provision-view.md)

# Crea e gestisci risorse di avviso utilizzando Terraform
<a name="v9-alerting-setup-provision-terraform"></a>

****  
**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 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)

Usa il provider Grafana di Terraform per gestire le tue risorse di avviso e fornirle nel tuo sistema Grafana. Il supporto del provider Terraform per Grafana Alerting semplifica la creazione, la gestione e la manutenzione dell'intero stack Grafana Alerting come codice.

Per ulteriori informazioni sulla gestione delle risorse di avviso utilizzando Terraform, consulta la documentazione di [Grafana Provider](https://registry.terraform.io/providers/grafana/grafana/latest/docs) nella documentazione di Terraform.

Completa le seguenti attività per creare e gestire le tue risorse di avviso utilizzando Terraform.

1. Crea una chiave API per il provisioning.

1. Configura il provider Terraform.

1. Definisci le tue risorse di avviso in Terraform.

1. Corri `terraform apply` a fornire le tue risorse di avviso.

## Prerequisiti
<a name="v9-alerting-setup-provision-tf-prerequisites"></a>
+ Assicurati di avere il [provider grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 o versione successiva.
+ Assicurati di utilizzare Grafana 9.1 o versioni successive. Se hai creato la tua istanza Amazon Managed Grafana con Grafana versione 9, questo sarà vero.

## Crea una chiave API per il provisioning
<a name="v9-alerting-setup-provision-tf-apikey"></a>

Puoi [creare una normale chiave API Grafana](Using-Grafana-APIs.md) per autenticare Terraform con Grafana. La maggior parte degli strumenti esistenti che utilizzano chiavi API dovrebbe funzionare automaticamente con il nuovo supporto Grafana Alerting. Per informazioni specifiche sulla creazione di chiavi da utilizzare con Terraform, consulta [Using Terraform for Amazon Managed Grafana automation](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/).

**Per creare una chiave API per il provisioning**

1. Crea un nuovo account di servizio per la tua pipeline CI.

1. Assegna il ruolo «Accedi all'API di provisioning delle regole di avviso».

1. Crea un nuovo token per l'account di servizio.

1. Assegna un nome e salva il token per utilizzarlo in Terraform.

In alternativa, puoi utilizzare l'autenticazione di base. Per visualizzare tutti i formati di autenticazione supportati, consulta l'[autenticazione Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) nella documentazione di Terraform.

## Configura il provider Terraform
<a name="v9-alerting-setup-provision-tf-configure"></a>

[Il supporto Grafana Alerting è incluso come parte del provider Grafana Terraform.](https://registry.terraform.io/providers/grafana/grafana/latest/docs)

Di seguito è riportato un esempio che è possibile utilizzare per configurare il provider Terraform.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Fornisci punti di contatto e modelli
<a name="v9-alerting-setup-provision-tf-contacts"></a>

I punti di contatto collegano uno stack di avvisi al mondo esterno. Spiegano a Grafana come connettersi ai sistemi esterni e dove inviare le notifiche. Ci sono oltre quindici diverse [integrazioni](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) tra cui scegliere. Questo esempio utilizza un punto di contatto Slack.

**Per fornire punti di contatto e modelli**

1. Copia questo blocco di codice in un file.tf sul tuo computer locale. *<slack-webhook-url>*Sostituiscilo con l'URL del webhook di Slack (o un altro contatto)

   Questo esempio crea un punto di contatto che invia notifiche di avviso a Slack.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Inserisci il testo per la notifica nel campo di testo.

   Il `text` campo supporta modelli in [stile Go.](https://pkg.go.dev/text/template) Ciò ti consente di gestire i tuoi modelli di notifica Grafana Alerting direttamente in Terraform.

1. Esegui il comando `terraform apply`.

1. Vai all'interfaccia utente di Grafana e controlla i dettagli del tuo punto di contatto.

   Non è possibile modificare le risorse fornite tramite Terraform dall'interfaccia utente. Ciò garantisce che lo stack di avvisi rimanga sempre sincronizzato con il codice.

1. Fai clic su **Test** per verificare che il punto di contatto funzioni correttamente.

**Nota**  
Puoi riutilizzare gli stessi modelli in molti punti di contatto. Nell'esempio precedente, un modello condiviso viene incorporato utilizzando l'istruzione `{{ template "Alert Instance Template" . }}`  
Questo frammento può quindi essere gestito separatamente in Terraform:  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Fornisci politiche e routing di notifica
<a name="v9-alerting-setup-provision-tf-notifications"></a>

Le politiche di notifica indicano a Grafana come indirizzare le istanze di avviso, anziché dove. Collegano gli avvisi di attivazione ai punti di contatto precedentemente definiti utilizzando un sistema di etichette e abbinatori.

**Per fornire politiche di notifica e routing**

1. Copia questo blocco di codice in un file.tf sul tuo computer locale.

   In questo esempio, gli avvisi sono raggruppati per`alertname`, il che significa che tutte le notifiche provenienti da avvisi con lo stesso nome vengono raggruppate nello stesso messaggio Slack.

   Se desideri indirizzare notifiche specifiche in modo diverso, puoi aggiungere delle politiche secondarie. Le politiche secondarie consentono di applicare il routing a diversi avvisi in base alla corrispondenza delle etichette. In questo esempio, applichiamo una tempistica di silenziamento a tutti gli avvisi con l'etichetta a=b.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. Nel campo mute\$1timings, collega una tempistica di silenziamento alla tua politica di notifica.

1. Esegui il comando `terraform apply`.

1. Vai all'interfaccia utente di Grafana e controlla i dettagli della tua politica di notifica.
**Nota**  
Non è possibile modificare le risorse fornite da Terraform dall'interfaccia utente. Ciò garantisce che lo stack di avvisi rimanga sempre sincronizzato con il codice.

1. Fai clic su **Test** per verificare che il punto di notifica funzioni correttamente.

## Fornisci tempi di silenziamento
<a name="v9-alerting-setup-provision-tf-mutetiming"></a>

Le tempistiche di silenziamento offrono la possibilità di disattivare le notifiche di avviso per periodi di tempo definiti.

**Per fornire tempi di silenziamento**

1. Copia questo blocco di codice in un file.tf sul tuo computer locale.

   In questo esempio, le notifiche di avviso vengono disattivate nei fine settimana.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Esegui il comando `terraform apply`.

1. Vai all'interfaccia utente di Grafana e controlla i dettagli della tua tempistica di silenziamento.

1. Fai riferimento alla tempistica di silenziamento appena creata in una politica di notifica utilizzando il campo. `mute_timings` In questo modo la tempistica di silenziamento verrà applicata ad alcune o a tutte le notifiche.
**Nota**  
Non è possibile modificare le risorse fornite da Terraform dall'interfaccia utente. Ciò garantisce che lo stack di avvisi rimanga sempre sincronizzato con il codice.

1. Fai clic su **Test** per verificare che la tempistica di silenziamento funzioni correttamente.

## Fornisci regole di avviso
<a name="v9-alerting-setup-provision-tf-rules"></a>

[Le regole di avviso](v9-alerting-managerules.md) consentono di inviare avvisi su qualsiasi fonte di dati Grafana. Questa può essere una fonte di dati che hai già configurato, oppure puoi [definire le tue fonti di dati in Terraform](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source) insieme alle regole di avviso.

**Per fornire regole di avviso**

1. Crea una fonte di dati su cui interrogare e una cartella in cui archiviare le regole.

   In questo esempio, viene utilizzata la fonte di [Configurare un'origine TestData dati per i test](testdata-data-source.md) dati.

   Gli avvisi possono essere definiti su qualsiasi origine dati di backend in Grafana.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Definisci una regola di avviso.

   Per ulteriori informazioni sulle regole di avviso, consulta [come creare avvisi gestiti da Grafana](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/).

1. Crea un gruppo di regole contenente una o più regole.

   In questo esempio, viene utilizzato il gruppo di `grafana_rule_group` risorse.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Vai all'interfaccia utente di Grafana e controlla la tua regola di avviso.

   Puoi vedere se la regola di avviso è attiva. È inoltre possibile visualizzare una visualizzazione di ciascuna delle fasi di interrogazione della regola di avviso.

   Quando viene attivato l'avviso, Grafana indirizza una notifica attraverso la politica che hai definito.

   Ad esempio, se hai scelto Slack come punto di contatto, l'[Alertmanager](https://github.com/prometheus/alertmanager) integrato di Grafana pubblica automaticamente un messaggio su Slack.

# Visualizzazione delle risorse di avviso assegnate a Grafana
<a name="v9-alerting-setup-provision-view"></a>

****  
**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 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)

 Puoi verificare che le tue risorse per gli avvisi siano state create a Grafana.

**Per visualizzare le risorse assegnate a Grafana**

1. Apri l'istanza Grafana.

1. Vai a Avvisi.

1. Fai clic su una cartella di risorse per gli avvisi, ad esempio Regole di avviso.

   Le risorse assegnate sono etichettate come **Provisioned**, in modo che sia chiaro che non sono state create manualmente.

**Nota**  
Non è possibile modificare le risorse assegnate da Grafana. È possibile modificare le proprietà della risorsa solo modificando il file di provisioning e riavviando Grafana o effettuando un hot reload. Ciò impedisce che vengano apportate modifiche alla risorsa che verrebbero sovrascritte se si rifornisse un file o si effettuasse un hot reload.

# Migrazione degli avvisi della dashboard classica agli avvisi Grafana
<a name="v9-alerting-use-grafana-alerts"></a>

****  
**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 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 aree di lavoro che scelgono di non utilizzare gli avvisi Grafana, utilizzano il classico avviso della dashboard. Per passare al nuovo avviso Grafana, devi attivare la funzione.

Puoi configurare la tua istanza Amazon Managed Grafana per utilizzare gli avvisi Grafana utilizzando l'API Console di gestione AWS Amazon Managed Grafana. AWS CLI Per dettagli su come configurare Amazon Managed Grafana, inclusa l'attivazione o la disattivazione degli avvisi Grafana, consulta. [Configura uno spazio di lavoro Amazon Managed Grafana](AMG-configure-workspace.md)

**Nota**  
Quando usi gli avvisi Grafana, le regole di avviso definite in Grafana, anziché in Prometheus, inviano più notifiche al tuo punto di contatto. Se utilizzi avvisi Grafana nativi, ti consigliamo di continuare con gli avvisi Grafana classici e di non abilitare la nuova funzionalità di avviso Grafana. Se desideri visualizzare gli avvisi definiti nella tua fonte di dati Prometheus, ti consigliamo di abilitare Grafana Alerting, che invia una sola notifica per gli avvisi creati in Prometheus Alertmanager.  
Questa limitazione è stata rimossa nelle aree di lavoro Amazon Managed Grafana che supportano Grafana v10.4 e versioni successive.

## Migrazione al sistema di avvisi Grafana
<a name="v9-alerting-use-grafana-alerts-opt-in"></a>

Quando gli avvisi Grafana sono attivati, gli avvisi della dashboard classica esistenti migrano in un formato compatibile con gli avvisi Grafana. Nella pagina Avvisi dell'istanza Grafana, puoi visualizzare gli avvisi migrati insieme ai nuovi avvisi. Con gli avvisi Grafana, le regole di avviso gestite da Grafana inviano più notifiche anziché un singolo avviso quando vengono abbinate.

L'accesso in lettura e scrittura ai classici avvisi della dashboard e agli avvisi Grafana è regolato dalle autorizzazioni delle cartelle che li memorizzano. Durante la migrazione, le autorizzazioni classiche per gli avvisi della dashboard vengono abbinate alle autorizzazioni delle nuove regole come segue:
+ Se la dashboard dell'avviso originale dispone di autorizzazioni, la migrazione crea una cartella denominata con questo formato in modo che `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` corrisponda alle autorizzazioni della dashboard originale (incluse le autorizzazioni ereditate dalla cartella).
+ Se non ci sono autorizzazioni della dashboard e la dashboard si trova in una cartella, la regola viene collegata a questa cartella e ne eredita le autorizzazioni.
+ Se non ci sono autorizzazioni per la dashboard e la dashboard si trova nella cartella Generale, la regola viene collegata alla cartella Avvisi generali e la regola eredita le autorizzazioni predefinite.

**Nota**  
Poiché non è `Keep Last State` disponibile alcuna opzione per gli avvisi `NoData` in Grafana, questa opzione diventa disponibile `NoData` durante la classica migrazione delle regole. L'opzione `Keep Last State` di `Error` gestione viene migrata a una nuova opzione. `Error` Per corrispondere al comportamento di`Keep Last State`, in entrambi i casi, durante la migrazione Amazon Managed Grafana crea automaticamente un silenzio per ogni regola di avviso della durata di un anno.

I canali di notifica vengono migrati a una configurazione Alertmanager con i percorsi e i ricevitori appropriati. I canali di notifica predefiniti vengono aggiunti come punti di contatto al percorso predefinito. I canali di notifica non associati ad alcun avviso della Dashboard vanno al `autogen-unlinked-channel-recv` percorso.

### Limitazioni
<a name="v9-alerting-use-grafana-alerts-limitations"></a>
+ Il sistema di avviso Grafana può recuperare le regole da tutte le fonti di dati Prometheus, Loki e Alertmanager disponibili. Potrebbe non essere in grado di recuperare le regole di avviso da altre fonti di dati supportate.
+ La migrazione avanti e indietro tra gli avvisi Grafana e il classico avviso della dashboard può comportare la perdita di dati per le funzionalità supportate in un sistema, ma non nell'altro.
**Nota**  
Se si torna alla versione classica degli avvisi della dashboard, si perderanno tutte le modifiche apportate alla configurazione degli avvisi effettuate mentre gli avvisi Grafana erano abilitati, incluse le nuove regole di avviso create.

# Gestisci le tue regole di avviso
<a name="v9-alerting-managerules"></a>

****  
**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 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)

Una regola di avviso è un insieme di criteri di valutazione che determina se un avviso verrà attivato. La regola di avviso è costituita da una o più interrogazioni ed espressioni, una condizione, la frequenza di valutazione e, facoltativamente, la durata durante la quale la condizione viene soddisfatta.

Mentre le interrogazioni e le espressioni selezionano il set di dati da valutare, una condizione imposta la soglia che un avviso deve soddisfare o superare per creare un avviso. Un intervallo specifica la frequenza con cui viene valutata una regola di avviso. La durata, se configurata, indica per quanto tempo deve essere soddisfatta una condizione. Le regole di avviso possono anche definire il comportamento di avviso in assenza di dati.

**Nota**  
Le regole di avviso gestite da Grafana possono essere modificate o eliminate solo dagli utenti con autorizzazioni di modifica per la cartella in cui sono archiviate le regole.  
Le regole di avviso per un'istanza Grafana Mimir o Loki esterna possono essere modificate o eliminate dagli utenti con ruoli di Editor o Amministratore.

**Topics**
+ [Creazione di regole di avviso gestite da Grafana](v9-alerting-managerules-grafana.md)
+ [Creazione di regole di avviso gestite da Grafana Mimir o Loki](v9-alerting-managerules-mimir-loki.md)
+ [Creazione di regole di registrazione gestite da Grafana, Mimir o Loki](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana, Mimir o Loki, gruppi di regole e namespace](v9-alerting-managerules-mimir-loki-groups.md)
+ [Visualizza e modifica le regole di avviso](v9-alerting-managerules-view-edit.md)

# Creazione di regole di avviso gestite da Grafana
<a name="v9-alerting-managerules-grafana"></a>

****  
**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 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)

Grafana consente di creare regole di avviso che interrogano una o più fonti di dati, riducono o trasformano i risultati e li confrontano tra loro o con soglie fisse. Quando queste vengono eseguite, Grafana invia notifiche al punto di contatto.

**Per aggiungere una regola gestita Grafana**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona **Avvisi (campanella) per aprire la pagina** Avvisi che elenca **gli avvisi** esistenti.

1. **Scegli Nuova regola di avviso.**

1. Nel **passaggio 1**, aggiungi il nome, il tipo e la posizione di archiviazione della regola, come segue:
   + In **Nome regola**, aggiungi un nome descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.
   + Dal menu a discesa **Tipo di regola**, seleziona **Avviso gestito Grafana**.
   + Dal menu a discesa **Cartella**, seleziona la cartella in cui desideri archiviare la regola. Se non si seleziona una cartella, la regola viene memorizzata nella `General` cartella. Per creare una cartella, seleziona il menu a discesa e inserisci un nuovo nome per la cartella.

1. Nel **passaggio 2**, aggiungi le interrogazioni e le espressioni da valutare.
   + Mantieni il nome predefinito o passa il mouse sopra e scegli l'icona di modifica per modificare il nome.
   + Per le query, seleziona una fonte di dati dal menu a discesa.
   + Aggiungi una o più [domande](v9-panels-query-xform-expressions.md) o espressioni.
   + Per ogni espressione, seleziona una **condizione classica** per creare una singola regola di avviso oppure scegli tra le opzioni **Math**, **Reduce** e **Resample** per generare avvisi separati per ogni serie. Per i dettagli su queste opzioni, consulta. [Regole singole e multidimensionali](#v9-alerting-single-multi-rule)
   + Scegli **Esegui interrogazioni** per verificare che l'interrogazione abbia esito positivo.

1. Nel **passaggio 3**, aggiungi le condizioni.
   + Dal menu a discesa **Condizione**, seleziona la query o l'espressione per avviare la regola di avviso.
   + Per **Evaluate every**, specificate la frequenza di valutazione. Deve essere un multiplo di 10 secondi. Ad esempio, `1m`, `30s`.
   + Per **Evaluate for**, specifica la durata per la quale la condizione deve essere vera prima che venga avviato un avviso.
**Nota**  
Dopo che una condizione viene violata, l'avviso entra in `Pending` stato. Se la condizione rimane violata per la durata specificata, l'avviso passa allo stato. `Firing` Se non viene più soddisfatto, viene ripristinato lo stato. `Normal`
   + In **Configura nessun dato e gestione degli errori**, configura il comportamento di avviso in assenza di dati. Utilizza le linee guida contenute in. [Nessuna gestione di dati o casi di errore](#v9-alerting-rule-no-data-error)
   + Scegli **Anteprima avvisi** per verificare il risultato dell'esecuzione della query in questo momento. L'anteprima non esclude dati e condizioni di gestione degli errori.

1. Nel **passaggio 4**, aggiungi ulteriori metadati associati alla regola.
   + Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida in[Etichette e annotazioni](v9-alerting-explore-labels.md).
   + Aggiungi l'URL, il pannello, la dashboard e l'avviso IDs del Runbook.
   + Aggiungi etichette personalizzate.

1. Scegli **Salva** per salvare la regola o **Salva ed esci** per salvare la regola e tornare alla pagina **Avvisi**.

Dopo aver creato la regola, puoi creare una notifica per la regola. Per ulteriori informazioni sulle notifiche, consultare [Gestisci le notifiche di avviso](v9-alerting-managenotifications.md).

## Regole singole e multidimensionali
<a name="v9-alerting-single-multi-rule"></a>

Per le regole di avviso gestite da Grafana, puoi creare una regola con una condizione classica oppure puoi creare una regola multidimensionale.

**Regola monodimensionale (condizione classica)**

Utilizza un'espressione di condizione classica per creare una regola che avvia un singolo avviso quando viene soddisfatta la relativa condizione. Per una query che restituisce più serie, Grafana non tiene traccia dello stato di avviso di ciascuna serie. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie.

Per ulteriori informazioni su come formattare le espressioni, consulta [Espressioni](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) nella documentazione di *Grafana*.

**Regola multidimensionale**

Per generare un'istanza di avviso separata per ogni serie restituita nella query, create una regola multidimensionale.

**Nota**  
Ogni istanza di avviso generata da una regola multidimensionale viene conteggiata ai fini della quota totale di avvisi. Le regole non vengono valutate quando si raggiunge la quota di avvisi. Per ulteriori informazioni sulle quote per le regole multidimensionali, vedere. [Errori relativi alla quota raggiunta](#v9-alerting-rule-quota-reached)

Per creare più istanze da una singola regola `Math``Reduce`, usa o `Resample` espressioni per creare una regola multidimensionale. Ad esempio, puoi:
+ Aggiungi un'`Reduce`espressione per ogni query per aggregare i valori nell'intervallo di tempo selezionato in un unico valore. (Non necessario per [le regole che utilizzano dati numerici)](v9-alerting-explore-numeric.md).
+ Aggiungi un'`Math`espressione con la condizione per la regola. Ciò non è necessario nel caso in cui una query o un'espressione di riduzione restituisca già 0 se la regola non deve avviare un avviso o un numero positivo se deve avviare un avviso. 

  Alcuni esempi: 
  + `$B > 70`se deve avviare un avviso nel caso in cui il valore di B query/expression sia superiore a 70. 
  + `$B < $C * 100`nel caso in cui debba avviare un allarme se il valore di B è inferiore al valore di C moltiplicato per 100. Se le query confrontate contengono più serie nei risultati, le serie di query diverse vengono abbinate se hanno le stesse etichette o una è un sottoinsieme dell'altra.

**Nota**  
Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili nella pagina della community Le [variabili di modello non sono supportate nelle query di avviso durante la configurazione](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) di Alert.



**Considerazioni sulle prestazioni per le regole multidimensionali**

Ogni istanza di avviso viene conteggiata ai fini della quota di avvisi. Le regole multidimensionali che creano più istanze di quelle che possono essere inserite all'interno della quota di avvisi non vengono valutate e restituiscono un errore di quota. Per ulteriori informazioni, consulta [Errori relativi alla quota raggiunta](#v9-alerting-rule-quota-reached).

Gli avvisi multidimensionali possono avere un forte impatto sulle prestazioni del tuo spazio di lavoro Grafana, nonché sulle prestazioni delle tue fonti di dati, poiché Grafana le interroga per valutare le tue regole di avviso. Le seguenti considerazioni possono essere utili per ottimizzare le prestazioni del sistema di monitoraggio.
+ **Frequenza di valutazione delle regole**: la proprietà **Evaluate Every** di una regola di avviso controlla la frequenza di valutazione delle regole. Si consiglia di utilizzare la frequenza di valutazione più bassa accettabile. 
+ **Cardinalità del set di risultati**: il numero di istanze di avviso create con una regola ne influisce sulle prestazioni. Supponiamo che stiate monitorando gli errori di risposta delle API per ogni percorso API, su ogni macchina virtuale del vostro parco macchine. Questo set ha una cardinalità del numero di percorsi moltiplicato per il numero di. VMs È possibile ridurre la cardinalità del set di risultati, ad esempio, monitorando gli errori totali per macchina virtuale anziché per percorso per macchina virtuale.
+ **Complessità della query**: le interrogazioni che le fonti di dati possono elaborare e a cui rispondere rapidamente consumano meno risorse. Sebbene questa considerazione sia meno importante delle altre considerazioni sopra elencate, se le hai ridotte il più possibile, l'analisi delle prestazioni delle singole query potrebbe fare la differenza. È inoltre necessario essere consapevoli dell'impatto sulle prestazioni che la valutazione di queste regole ha sulle fonti di dati. Le query di avviso sono spesso la maggior parte delle query gestite dai database di monitoraggio, quindi anche gli stessi fattori di carico che influiscono sull'istanza Grafana influiscono anche su di esse.

## Errori relativi alla quota raggiunta
<a name="v9-alerting-rule-quota-reached"></a>

Esiste una quota per il numero di istanze di avviso che è possibile avere all'interno di un singolo spazio di lavoro. Quando raggiungi quel numero, non puoi più creare nuove regole di avviso in quell'area di lavoro. Con gli avvisi multidimensionali, il numero di istanze di avviso può variare nel tempo.

Quando si lavora con le istanze di avviso, è importante ricordare quanto segue.
+ Se si creano solo regole monodimensionali, ogni regola è una singola istanza di avviso. È possibile creare lo stesso numero di regole in un unico spazio di lavoro pari alla quota dell'istanza di avviso e non di più.
+ Le regole multidimensionali creano più istanze di avviso, tuttavia il numero non è noto finché non vengono valutate. Ad esempio, se crei una regola di avviso che tiene traccia dell'utilizzo della CPU delle tue istanze Amazon EC2, potrebbero esserci 50 istanze EC2 al momento della creazione (e quindi 50 istanze di avviso), ma se aggiungi altre 10 istanze EC2 una settimana dopo, la valutazione successiva ha 60 istanze di avviso.

  Il numero di istanze di avviso viene valutato quando si crea un avviso multidimensionale e non è possibile crearne uno che superi immediatamente la quota di istanze di avviso. Poiché il numero di istanze di avviso può cambiare, la quota viene verificata ogni volta che vengono valutate le regole.
+ Al momento della valutazione della regola, se una regola comporta il superamento della quota prevista per le istanze di avviso, tale regola non viene valutata finché non viene effettuato un aggiornamento della regola di avviso che porta il numero totale di istanze di avviso al di sotto della quota di servizio. Quando ciò accade, si riceve una notifica di avviso che informa che la quota è stata raggiunta (la notifica utilizza la politica di notifica per la regola in fase di valutazione). La notifica include un'`Error`annotazione con il valore. `QuotaReachedError`
+ Una regola che causa un `QuotaReachedError` arresto nella valutazione. La valutazione viene ripresa solo quando viene effettuato un aggiornamento e la valutazione successiva all'aggiornamento non causa di per sé un. `QuotaReachedError` Una regola che non viene valutata mostra l'errore **Quota raggiunta** nella console Grafana.
+ È possibile ridurre il numero di istanze di avviso rimuovendo le regole di avviso o modificando gli avvisi multidimensionali per avere meno istanze di avviso (ad esempio, inserendo un avviso sugli errori per macchina virtuale anziché un avviso di errore per API in una macchina virtuale).
+ Per riprendere le valutazioni, aggiorna l'avviso e salvalo. È possibile aggiornarlo per ridurre il numero di istanze di avviso oppure, se sono state apportate altre modifiche per ridurre il numero di istanze di avviso, è possibile salvarlo senza modifiche. Se può essere ripreso, lo è. Se ne causa un altro`QuotaReachedError`, non puoi salvarlo.
+ Quando un avviso viene salvato e riprende la valutazione senza superare la quota di avvisi, l'errore Quota **raggiunta** può continuare a essere visualizzato nella console Grafana per qualche tempo (fino all'intervallo di valutazione), tuttavia, la valutazione della regola di avviso inizia e gli avvisi vengono inviati se viene raggiunta la soglia della regola.
+ Per i dettagli sulla quota di avvisi e su altre quote, vedi. [Quote del servizio Amazon Managed Grafana](AMG_quotas.md)

## Nessuna gestione di dati o casi di errore
<a name="v9-alerting-rule-no-data-error"></a>

Scegliete le opzioni su come gestire il comportamento di avviso in assenza di dati o in caso di errori.

Le opzioni per la gestione dell'assenza di dati sono elencate nella tabella seguente.


| Opzione No Data | Comportamento | 
| --- | --- | 
|  Nessun dato  |  Crea un avviso `DatasourceNoData` con il nome e l'UID della regola di avviso e l'UID dell'origine dati che non ha restituito dati come etichette.  | 
|  Avviso  |  Imposta lo stato della regola di avviso su. `Alerting`  | 
|  OK  |  Imposta lo stato della regola di avviso su`Normal`.  | 

Le opzioni per la gestione dei casi di errore sono elencate nella tabella seguente.


| Opzione di errore o timeout | Comportamento | 
| --- | --- | 
|  Avviso  |  Imposta lo stato della regola di avviso su `Alerting`  | 
|  OK  |  Imposta lo stato della regola di avviso su `Normal`  | 
|  Errore  |  Crea un avviso `DatasourceError` con il nome e l'UID della regola di avviso e l'UID dell'origine dati che non ha restituito dati come etichette.  | 

# Creazione di regole di avviso gestite da Grafana Mimir o Loki
<a name="v9-alerting-managerules-mimir-loki"></a>

****  
**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 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)

Utilizzando Grafana, è possibile creare regole di avviso per un'istanza Grafana Mimir o Loki esterna.

**Nota**  
Grafana Mimir può connettersi alle sorgenti dati Amazon Managed Service for Prometheus e Prometheus.

**Prerequisiti**
+ Verifica di disporre delle autorizzazioni di scrittura per l'origine dati Prometheus. Altrimenti, non sarai in grado di creare o aggiornare le regole di avviso gestite da Cortex.
+ Per le sorgenti dati Grafana Mimir e Loki, abilita l'API ruler configurando i rispettivi servizi.
  + **Loki** — Il tipo di archiviazione delle `local` regole, predefinito per l'origine dati Loki, supporta solo la visualizzazione delle regole. Per modificare le regole, configura uno degli altri tipi di archiviazione.
  + **Grafana Mimir** — Usa il `/api/prom` prefisso legacy, non. `/prometheus` L'origine dati Prometheus supporta sia Grafana Mimir che Prometheus e Grafana prevede che sia l'API Query che l'API Ruler siano sotto lo stesso URL. Non è possibile fornire un URL separato per l'API Ruler.

**Nota**  
**Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.**

**Per aggiungere una regola di avviso gestito Grafana, Mimir o Loki**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona **Avvisi (campanella) per aprire la pagina** Avvisi che elenca **gli avvisi** esistenti.

1. **Scegli Crea regola di avviso.**

1. Nel **passaggio 1**, scegli il tipo di regola e i dettagli, come segue:
   + Scegli **Mimir o Loki alert**.
   + In **Nome regola, aggiungi un nome** descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.
   + Dal menu a discesa **Seleziona origine dati**, seleziona un'origine dati Prometheus o Loki.
   + Dal menu a discesa **Namespace**, seleziona uno spazio dei nomi di regole esistente. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo. Per ulteriori informazioni, consulta [Gruppi di regole e namespace Cortex o Loki](alert-rules.md#alert-rule-groups).
   + Dal menu a discesa **Gruppo**, seleziona un gruppo esistente all'interno del namespace selezionato. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. Le regole appena create vengono aggiunte alla fine del gruppo. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, con lo stesso tempo di valutazione.

1. Nel **passaggio 2**, aggiungi la query da valutare.

   Il valore può essere un'espressione PromQL o LogQL. La regola avvia un avviso se il risultato della valutazione presenta almeno una serie con un valore maggiore di 0. Viene creato un avviso per ogni serie.

1. Nel **passaggio 3**, specificare l'intervallo di valutazione degli avvisi.

   Nella casella di testo **Per** della condizione, specifica la durata per la quale la condizione deve essere vera prima che venga avviato l'avviso. Se si specifica`5m`, le condizioni devono essere vere per cinque minuti prima che l'avviso venga avviato.
**Nota**  
Quando viene soddisfatta una condizione, l'avviso entra in `Pending` stato. Se la condizione rimane attiva per la durata specificata, l'avviso passa allo `Firing` stato. Se non viene più soddisfatta, torna allo `Normal` stato.

1. Nel **passaggio 4**, aggiungi ulteriori metadati associati alla regola.
   + Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida in[Etichette e annotazioni](v9-alerting-explore-labels.md).
   + Aggiungi l'URL, il pannello, la dashboard e l'avviso IDs del Runbook.
   + Aggiungi etichette personalizzate.

1. Scegli **Anteprima avvisi** per valutare la regola e vedere quali avvisi produrrebbe. Visualizza un elenco di avvisi con lo stato e il valore di ciascuno.

1. Scegli **Salva** per salvare la regola o **Salva ed esci** per salvare la regola e tornare alla pagina **Avvisi.**

Dopo aver creato la regola, puoi creare una notifica per la regola. Per ulteriori informazioni sulle notifiche, consultare [Gestisci le notifiche di avviso](v9-alerting-managenotifications.md).

# Creazione di regole di registrazione gestite da Grafana, Mimir o Loki
<a name="v9-alerting-managerules-mimir-loki-recording"></a>

****  
**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 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)

È possibile creare e gestire regole di registrazione per un'istanza Grafana Mimir o Loki esterna. Le regole di registrazione calcolano in anticipo le espressioni più richieste o quelle più dispendiose dal punto di vista computazionale e salvano il risultato come una nuova serie temporale. L'interrogazione di questa nuova serie temporale è più rapida, soprattutto per le dashboard, poiché interrogano la stessa espressione ogni volta che le dashboard si aggiornano.

**Prerequisiti**

Per le sorgenti dati Grafana Mimir e Loki, abilita l'API ruler configurando i rispettivi servizi.
+ **Loki** — Il tipo di archiviazione delle `local` regole, predefinito per l'origine dati Loki, supporta solo la visualizzazione delle regole. Per modificare le regole, configura uno degli altri tipi di archiviazione.
+ **Grafana Mimir** — Quando configuri un'origine dati in modo che punti a Grafana Mimir, usa il prefisso legacy, not. `/api/prom` `/prometheus` L'origine dati Prometheus supporta sia Grafana Mimir che Prometheus e Grafana prevede che sia l'API Query che l'API Ruler si trovino nello stesso URL. Non è possibile fornire un URL separato per l'API Ruler.

**Nota**  
**Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.**

**Per aggiungere una regola di registrazione gestita Grafana, Mimir o Loki**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona **Avvisi (campanella) per aprire la pagina** Avvisi che elenca **gli avvisi** esistenti.

1. **Scegli Crea regola di avviso.**

1. Nel **passaggio 1**, aggiungi il tipo di regola, il nome della regola e la posizione di archiviazione, come segue.
   + Seleziona l'opzione delle **regole di registrazione Mimir o Loki**.
   + In **Nome regola, aggiungi un nome** descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.
   + Dal menu a discesa **Seleziona origine dati**, seleziona un'origine dati Prometheus o Loki.
   + Dal menu a discesa **Namespace**, seleziona uno spazio dei nomi di regole esistente. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo. Per ulteriori informazioni, consulta [Gruppi di regole e namespace Cortex o Loki](alert-rules.md#alert-rule-groups).
   + Dal menu a discesa **Gruppo**, seleziona un gruppo esistente all'interno del namespace selezionato. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. Le regole appena create vengono aggiunte alla fine del gruppo. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, con lo stesso tempo di valutazione.

1. Nel **passaggio 2**, aggiungi la query da valutare.

   Il valore può essere un'espressione PromQL o LogQL. La regola avvia un avviso se il risultato della valutazione presenta almeno una serie con un valore maggiore di 0. Viene creato un avviso per ogni serie.

1. Nel **passaggio 3**, aggiungi ulteriori metadati associati alla regola.
   + Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida in[Annotazioni ed etichette per le regole di avviso](alert-rules.md#alert-rule-labels).
   + Aggiungi l'URL, il pannello, la dashboard e l'avviso IDs del Runbook.
   + Aggiungi etichette personalizzate.

1. Scegli **Salva** per salvare la regola o **Salva ed esci** per salvare la regola e tornare alla pagina **Avvisi**.

# Grafana, Mimir o Loki, gruppi di regole e namespace
<a name="v9-alerting-managerules-mimir-loki-groups"></a>

****  
**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 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)

Puoi organizzare le tue regole. Le regole vengono create all'interno di gruppi di regole e i gruppi di regole sono organizzati in namespace. Le regole all'interno di un gruppo di regole vengono eseguite in sequenza a intervalli regolari. L'intervallo predefinito è di un minuto. È possibile rinominare gli spazi dei nomi e i gruppi di regole Grafana Mimir o Loki e modificare gli intervalli di valutazione dei gruppi di regole.

**Per modificare un gruppo di regole o uno spazio dei nomi**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. Passa a una regola all'interno del gruppo di regole o dello spazio dei nomi che desideri modificare.

1. Scegliete l'**icona Modifica** (penna).

1. Apportate modifiche al gruppo di regole o al namespace.
**Nota**  
Per i namespace, puoi solo modificare il nome. Per i gruppi di regole, è possibile modificare il nome o l'intervallo di valutazione per le regole del gruppo. Ad esempio, è possibile scegliere di `1m` fare in modo che le regole vengano valutate una volta al minuto o `30s` una volta ogni 30 secondi.

1. Scegli **Save changes (Salva modifiche)**.

# Visualizza e modifica le regole di avviso
<a name="v9-alerting-managerules-view-edit"></a>

****  
**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 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)

La pagina Avvisi elenca le **regole di avviso.** Per impostazione predefinita, le regole sono raggruppate per tipi di origini dati. La sezione **Grafana** elenca le regole gestite da Grafana e la sezione **Cortex/Loki elenca le regole per le fonti** di dati compatibili con Prometheus. È possibile visualizzare le regole di avviso per le fonti di dati compatibili con Prometheus, ma non è possibile modificarle.

La sezione Mimir/Cortex/Loki delle regole elenca tutte le regole per le fonti di dati Mimir, Cortex o Loki. In questa sezione sono elencate anche le regole di avviso cloud.

Quando gestisci grandi volumi di avvisi, puoi utilizzare funzionalità estese di ricerca delle regole di avviso per filtrare cartelle, gruppi di valutazione e regole. Inoltre, puoi filtrare le regole di avviso in base alle loro proprietà come etichette, stato, tipo e stato di integrità.

**Nota**  
È possibile visualizzare le definizioni delle interrogazioni per gli avvisi predisposti, ma non modificarle. La possibilità di visualizzarli consente di verificare che le query e le definizioni delle regole siano corrette senza dover tornare al repository di provisioning per le definizioni delle regole.

## Visualizza le regole di avviso
<a name="v9-alerting-managerules-view"></a>

Utilizzando gli avvisi Grafana, puoi visualizzare tutti i tuoi avvisi in un'unica pagina.

**Per visualizzare i dettagli degli avvisi**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.** Per impostazione predefinita, le regole vengono visualizzate in gruppi per tipo di origine dati. È inoltre possibile visualizzare in base allo stato corrente di ogni avviso (questi sono descritti più dettagliatamente nel testo seguente).

1. In **Visualizza come**, puoi passare dalla visualizzazione di gruppo a quella dello stato scegliendo l'opzione che preferisci.

1. Scegli la freccia accanto a una riga per visualizzare ulteriori dettagli per quella riga. I dettagli di una regola includono le etichette delle regole, le annotazioni, le fonti di dati e le interrogazioni, nonché un elenco di istanze di avviso risultanti dalla regola.

**Nota**  
Per ulteriori informazioni sulla comprensione dei dettagli degli avvisi, consulta. [Stato e integrità delle regole di allarme](v9-alerting-explore-state.md)

**Visualizzazione di gruppo**

La visualizzazione di gruppo mostra le regole di avviso Grafana raggruppate per cartella e le regole di avviso Loki o Prometheus raggruppate per \$1. `namespace` `group` Questa è la visualizzazione predefinita dell'elenco delle regole, destinata alla gestione delle regole. È possibile espandere ogni gruppo per visualizzare un elenco delle regole in esso contenute. Espandi ulteriormente una regola per visualizzarne i dettagli. Puoi anche espandere i pulsanti di azione e gli avvisi risultanti dalla regola per visualizzarne i dettagli.

**Visualizzazione dello stato**

La visualizzazione dello stato mostra le regole di avviso raggruppate per stato. Utilizzate questa visualizzazione per avere una panoramica delle regole e dello stato in cui si trovano. Ogni regola può essere espansa per visualizzarne i dettagli. I pulsanti di azione e tutti gli avvisi generati da questa regola; ogni avviso può essere ulteriormente espanso per visualizzarne i dettagli.

**Filtra le regole di avviso**

È possibile filtrare le regole di avviso visualizzate nella pagina **Avvisi in diversi** modi.
+ È possibile filtrare per visualizzare le regole che interrogano una fonte di dati specifica scegliendo **Seleziona origini dati**, quindi selezionando un'origine dati in base alla quale filtrare.
+ Puoi filtrare per etichette scegliendo i criteri di ricerca in **Cerca per etichetta**. Ad esempio, puoi digitare per `environment=production,region=~US|EU,severity!=warning` filtrare le avvertenze relative alla produzione negli Stati Uniti e nell'UE.
+ Puoi filtrare per visualizzare le regole in uno stato specifico scegliendo **Filtra avvisi per stato**, quindi selezionando lo stato che desideri visualizzare.

## Modifica o elimina le regole di avviso
<a name="v9-alerting-managerules-edit"></a>

Le regole di avviso gestite da Grafana possono essere modificate o eliminate solo dagli utenti con autorizzazioni di modifica per la cartella in cui sono archiviate le regole. Le regole di avviso per un'istanza esterna di Mimir o Loki possono essere modificate o eliminate dagli utenti con ruoli di Editor o Amministratore.

**Per modificare o eliminare una regola**

1. Espandi una regola fino a visualizzare i controlli delle regole per **Visualizza**, **Modifica** ed **Elimina**.

1. Scegli **Modifica** per aprire la pagina di creazione della regola. Effettua gli aggiornamenti nello stesso modo in cui crei una regola. Per i dettagli, consulta le istruzioni in [Creazione di regole di avviso gestite da Grafana](v9-alerting-managerules-grafana.md) o[Creazione di regole di avviso gestite da Grafana Mimir o Loki](v9-alerting-managerules-mimir-loki.md).

1. Facoltativamente, scegli **Elimina** per eliminare una regola.

## Esporta le regole di avviso
<a name="v9-alerting-managerules-export"></a>

**Puoi esportare le regole in YAML o JSON nell'area di lavoro Grafana, scegliendo Esporta.** Ti darà la possibilità di definire una nuova regola, quindi esportarla. È possibile creare una regola utilizzando l'interfaccia utente e quindi esportarla per utilizzarla nell'API di provisioning o negli script terraform.

**Nota**  
Questa funzionalità è supportata sia nell'area di lavoro Grafana che nell'interfaccia di provisioning.

# Gestisci le notifiche di avviso
<a name="v9-alerting-managenotifications"></a>

****  
**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 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)

La scelta di come, quando e dove inviare le notifiche di avviso è una parte importante della configurazione del sistema di avviso. Queste decisioni avranno un impatto diretto sulla capacità di risolvere rapidamente i problemi e di non perdere nulla di importante.

Come primo passo, definisci i tuoi *punti di contatto*; a chi inviare le notifiche di avviso. Un punto di contatto può essere un insieme di destinazioni per le notifiche corrispondenti. Aggiungi modelli di notifica ai punti di contatto per riutilizzarli e inviare messaggi coerenti nelle notifiche.

Successivamente, crea una *politica di notifica*, che è un insieme di regole per stabilire dove, quando e come gli avvisi vengono indirizzati ai punti di contatto. In una politica di notifica, definisci dove inviare le notifiche di avviso scegliendo uno dei punti di contatto che hai creato. Aggiungi tempi di silenziamento alla tua politica di notifica. Un *periodo di silenziamento* è un intervallo di tempo ricorrente durante il quale non desideri che vengano inviate notifiche.

*Quando viene valutata una regola di avviso, il righello di avviso invia istanze di avviso all'Alertmanager: una regola di avviso può attivare più istanze di avviso individuali.*

L'Alertmanager riceve queste istanze di avviso e quindi gestisce gli orari di silenziamento, raggruppa gli avvisi e invia notifiche ai punti di contatto come definito nella politica di notifica.

**Topics**
+ [Gestore degli avvisi](v9-alerting-managenotifications-alertmanager.md)
+ [Lavorare con i punti di contatto](v9-alerting-contact-points.md)
+ [Utilizzo delle politiche di notifica](v9-alerting-notification-policies.md)
+ [Personalizza le notifiche](v9-alerting-notifications.md)
+ [Silenziamento delle notifiche di avviso per le fonti di dati Prometheus](v9-alerting-silences.md)
+ [Tempi di silenziamento](v9-alerting-notification-muting.md)
+ [Visualizza e filtra per gruppi di avvisi](v9-alerting-viewfiltergroups.md)
+ [Visualizza gli errori di notifica](v9-alerting-viewnotificationerrors.md)

# Gestore degli avvisi
<a name="v9-alerting-managenotifications-alertmanager"></a>

****  
**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 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)

Alertmanager consente di gestire e rispondere agli avvisi in modo rapido ed efficiente. Riceve avvisi, gestisce le disattivazioni, l'inibizione, il raggruppamento e il routing inviando notifiche tramite il canale prescelto, ad esempio e-mail o Slack.

In Grafana, puoi usare Grafana Alertmanager o un Alertmanager esterno. Puoi anche eseguire più gestori di avvisi; la tua decisione dipende dalla configurazione e da dove vengono generati gli avvisi.

**Gestore avvisi Grafana**

Grafana Alertmanager è un Alertmanager interno preconfigurato e disponibile per la selezione di default se si esegue Grafana on-premise o open source.

Grafana Alertmanager può ricevere avvisi da Grafana, ma non può ricevere avvisi dall'esterno di Grafana, ad esempio da Mimir o Loki.

**Nota**  
Le regole di inibizione non sono supportate in Grafana Alertmanager.

**Gestore di avvisi esterno**

Se desideri utilizzare un unico gestore di avvisi per ricevere tutti gli avvisi Grafana, Loki, Mimir e Prometheus, puoi configurare Grafana per utilizzare un Alertmanager esterno. Questo Alertmanager esterno può essere configurato e amministrato dall'interno di Grafana stessa.

Ecco due esempi di quando potresti voler configurare il tuo alertmanager esterno e inviare i tuoi avvisi lì invece di Grafana Alertmanager:

1. Disponi già di gestori di avvisi in sede nella tua infrastruttura Cloud che hai configurato e desideri continuare a utilizzare, perché hai altri generatori di avvisi, come Prometheus.

1. Desideri utilizzare sia Prometheus on-premise che Grafana ospitato per inviare avvisi allo stesso gestore di avvisi che funziona nella tua infrastruttura Cloud.

I gestori degli avvisi sono visibili dal menu a discesa delle pagine Avvisi, punti di contatto e Politiche di notifica.

Se stai effettuando il provisioning della tua fonte di dati, imposta il flag `handleGrafanaManagedAlerts` nel `jsonData` campo per inviare avvisi gestiti da Grafana `true` a questo Alertmanager.

# Lavorare con i punti di contatto
<a name="v9-alerting-contact-points"></a>

****  
**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 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)

Utilizza i punti di contatto per definire in che modo i tuoi contatti vengono avvisati quando viene avviato un avviso. Un punto di contatto può avere una o più integrazioni di punti di contatto, ad esempio Amazon Simple Notification Service o Slack. Quando viene avviato un avviso, viene inviata una notifica a tutte le integrazioni dei punti di contatto elencate per un punto di contatto. Facoltativamente, utilizza i [modelli di notifica](v9-alerting-create-templates.md) per personalizzare i messaggi di notifica per i tipi di punti di contatto.

**Nota**  
Puoi creare e modificare punti di contatto per gli avvisi gestiti da Grafana. I punti di contatto per gli avvisi di Alertmanager sono di sola lettura.

## Lavorare con i punti di contatto
<a name="v9-alerting-working-contact-points"></a>

Le seguenti procedure descrivono in dettaglio come aggiungere, modificare, testare ed eliminare i punti di contatto.

**Per aggiungere un punto di contatto**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli **Punti di contatto**, quindi Aggiungi punto di contatto.**

1. Dal menu a discesa **Alertmanager**, seleziona un Alertmanager. Il Grafana Alertmanager è selezionato per impostazione predefinita.

1. Inserite un **nome per il punto** di contatto.

1. Da **Integrazione con i punti di contatto**, scegli un tipo e i campi obbligatori in base a quel tipo. Ad esempio, se scegli Slack, inserisci i canali Slack e gli utenti che devono essere contattati.

1. Se disponibile per il punto di contatto selezionato, scegli le **impostazioni opzionali desiderate per specificare impostazioni** aggiuntive.

1. In **Impostazioni di notifica**, seleziona facoltativamente **Disabilita messaggio risolto** se non desideri ricevere una notifica quando si risolve un avviso.

1. Se il tuo punto di contatto necessita di più tipi di punti di contatto, puoi scegliere **Aggiungi integrazione dei punti di contatto** e ripetere i passaggi per ogni tipo di punto di contatto necessario.

1. Scegli **Salva punto di contatto** per salvare le modifiche.

**Per modificare un punto di contatto**

1. Scegli **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti.

1. Seleziona il punto di contatto da modificare, quindi scegli l'icona **Modifica** (penna).

1. Apporta le modifiche necessarie, quindi scegli **Salva punto di contatto** per salvare le modifiche.

Dopo aver creato il punto di contatto, puoi inviare una notifica di prova per verificare che sia configurato correttamente.

**Per inviare una notifica di prova**

1. Scegli **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. Seleziona il punto di contatto da testare, quindi scegli l'icona **Modifica** (penna).

1. Seleziona l'icona **Test** (aeroplano di carta).

1. Scegli se inviare una notifica di test predefinita o scegli **Personalizzata** per aggiungere annotazioni ed etichette personalizzate nella notifica di test.

1. Scegli **Invia notifica di test** per testare l'avviso con i punti di contatto indicati.

È possibile eliminare i punti di contatto che non sono utilizzati in base a una politica di notifica.

**Per eliminare un punto di contatto**

1. Scegliete **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. Seleziona il punto di contatto da eliminare, quindi scegli l'icona **Elimina** (cestino).

1. Nella finestra di dialogo di conferma, scegli **Sì, elimina**.

**Nota**  
Se il punto di contatto è utilizzato in base a una politica di notifica, è necessario eliminare la politica di notifica o modificarla per utilizzare un punto di contatto diverso prima di eliminare il punto di contatto.

## Elenco dei notificanti supportati
<a name="v9-alerting-contactpoint-supported-notifiers"></a>


|  Name  |  Tipo  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Pager Duty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Utilizzo delle politiche di notifica
<a name="v9-alerting-notification-policies"></a>

****  
**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 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 politiche di notifica determinano il modo in cui gli avvisi vengono indirizzati ai punti di contatto. Le politiche hanno una struttura ad albero, in cui ciascuna politica può avere una o più politiche secondarie. Ogni politica, ad eccezione della politica principale, può anche corrispondere a etichette di avviso specifiche. Ogni avviso viene valutato in base alla politica principale e quindi a ciascuna politica secondaria. Se si abilita l'`Continue matching subsequent sibling nodes`opzione per una politica specifica, la valutazione continua anche dopo una o più corrispondenze. Le impostazioni di configurazione e le informazioni sui punti di contatto di una politica principale regolano il comportamento di un avviso che non corrisponde a nessuna delle politiche secondarie. Una politica principale regola qualsiasi avviso che non corrisponde a una politica specifica.

**Nota**  
È possibile creare e modificare politiche di notifica per gli avvisi gestiti da Grafana. Le politiche di notifica per gli avvisi di Alertmanager sono di sola lettura.

**Raggruppamento delle notifiche**

Il raggruppamento classifica le notifiche di avviso di natura simile in un'unica canalizzazione. Ciò consente di controllare le notifiche di avviso durante interruzioni più ampie, quando più parti di un sistema si guastano contemporaneamente, provocando l'avvio simultaneo di un numero elevato di avvisi.

**Esempio di raggruppamento**

Supponiamo di avere 100 servizi connessi a un database in ambienti diversi. Questi servizi sono differenziati dall'etichetta. `env=environmentname` È in vigore una regola di avviso per monitorare se i servizi possono raggiungere il database. La regola di avviso crea avvisi `alertname=DatabaseUnreachable` denominati.

Se si verifica una partizione di rete in cui metà dei servizi non riesce più a raggiungere il database, vengono avviati 50 avvisi diversi. In questa situazione, si desidera ricevere una notifica a pagina singola (anziché 50) con un elenco degli ambienti interessati.

È possibile configurare il raggruppamento in modo che sia `group_by: [alertname]` (senza utilizzare l'`env`etichetta, che è diversa per ogni servizio). Con questa configurazione, Grafana invia un'unica notifica compatta che contiene tutti gli ambienti interessati da questa regola di avviso.

**Gruppi speciali**

Grafana ha due gruppi speciali. Il gruppo predefinito, `group_by: null` raggruppa *tutti gli* avvisi in un unico gruppo. È inoltre possibile utilizzare un'etichetta speciale denominata `...` per raggruppare gli avvisi in base a tutte le etichette, disabilitando efficacemente il raggruppamento e inviando ogni avviso nel proprio gruppo.

## Utilizzo delle notifiche
<a name="v9-alerting-notification-policies-working"></a>

Le procedure seguenti mostrano come creare e gestire le politiche di notifica.

**Per modificare la politica di notifica principale**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. Nella sezione **Root policy**, scegli l'icona **Modifica** (penna).

1. Nel **Punto di contatto predefinito**, aggiorna il punto di contatto a cui devono essere inviate le notifiche relative alle regole quando le regole di avviso non corrispondono a nessuna politica specifica.

1. In **Raggruppa per**, scegli le etichette (o i gruppi speciali) in base ai quali raggruppare gli avvisi.

1. Nelle **opzioni di temporizzazione**, seleziona una delle seguenti opzioni.
   + **Attesa di gruppo**: tempo necessario per memorizzare nel buffer gli avvisi dello stesso gruppo prima di inviare una notifica iniziale. Il valore predefinito è 30 secondi.
   + Intervallo di **gruppo: intervallo** di tempo minimo tra due notifiche per un gruppo. Il valore predefinito è 5 minuti.
   + Intervallo di **ripetizione: intervallo** di tempo minimo prima di inviare nuovamente una notifica se non sono stati aggiunti nuovi avvisi al gruppo. L'impostazione predefinita è 4 ore.

1. Scegli **Salva** per salvare le modifiche.

**Per aggiungere una nuova politica specifica di primo livello**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Nella sezione **Routing specifico**, scegli Nuova politica specifica.**

1. Nella sezione **Etichette corrispondenti**, aggiungi una o più etichette di avviso corrispondenti. Ulteriori informazioni sulla corrispondenza delle etichette sono disponibili più avanti in questo argomento.

1. In **Punto di contatto**, aggiungi il punto di contatto a cui inviare notifiche se l'avviso corrisponde a questa politica specifica. Le politiche annidate hanno la precedenza su questo punto di contatto.

1. Facoltativamente, abilita **Continua a far corrispondere i nodi di pari livello successivi** per continuare a far corrispondere le politiche di pari livello anche dopo che l'avviso corrisponde alla politica corrente. Quando questo criterio è abilitato, puoi ricevere più di una notifica per lo stesso avviso.

1. Facoltativamente, seleziona **Ignora raggruppamento** per specificare un raggruppamento diverso dalla politica principale.

1. Facoltativamente, seleziona Ignora gli **orari generali per sovrascrivere le opzioni di temporizzazione** nella politica di notifica di gruppo.

1. Scegli **Salva** per salvare le modifiche.

**Per aggiungere una politica annidata**

1. Espandi la politica specifica in base alla quale desideri creare una politica annidata.

1. Scegli **Aggiungi politica annidata**, quindi aggiungi i dettagli (come quando aggiungi una politica specifica di primo livello).

1. Scegli **Salva** per salvare le modifiche.

**Per modificare una politica specifica**

1. Dalla pagina **Avvisi**, scegli **Criteri di notifica** per aprire la pagina che elenca le politiche esistenti.

1. Seleziona la politica che desideri modificare, quindi scegli l'icona **Modifica** (penna).

1. Apporta eventuali modifiche (come quando aggiungi una politica specifica di primo livello).

1. Scegli **Salva policy**.

**Ricerca di politiche**

Puoi cercare nell'albero delle politiche per *Label Matchers* o per *punti di contatto*.
+ Per effettuare la ricerca per punto di contatto, inserisci un nome parziale o completo di un punto di contatto nel campo **Cerca per punto di contatto**.
+ Per effettuare la ricerca per etichetta, inserisci un abbinatore di etichette valido nel campo **Cerca per etichetta**. È possibile inserire più abbinatori, separati da una virgola. Ad esempio, un input matcher valido potrebbe essere. `severity=high, region=~EMEA|NA`
**Nota**  
Durante la ricerca per etichetta, tutte le politiche corrispondenti corrisponderanno esattamente. Le corrispondenze parziali e le corrispondenze in stile regex non sono supportate.

**Come funziona la corrispondenza delle etichette**

Una politica corrisponde a un avviso se le etichette dell'avviso corrispondono a tutte le *etichette corrispondenti* specificate nella politica.
+ **Etichetta**: il nome dell'etichetta da abbinare. Deve corrispondere esattamente al nome dell'etichetta dell'avviso.
+ **Operatore**: l'operatore utilizzato per confrontare il valore dell'etichetta con il valore dell'etichetta corrispondente. Gli operatori disponibili sono:
  + `=`Seleziona le etichette il cui valore corrisponde esattamente alla stringa fornita.
  + `!=`Seleziona le etichette il cui valore non corrisponde alla stringa fornita.
  + `=~`Seleziona le etichette il cui valore corrisponde al valore interpretato dall'espressione regolare della stringa fornita (la stringa fornita viene interpretata come un'espressione regolare).
  + `!=`Seleziona le etichette che non corrispondono all'espressione regolare fornita.
+ **Valore**: il valore a cui abbinare il valore dell'etichetta. Può corrispondere come stringa o come espressione regolare, a seconda dell'operatore scelto.

# Personalizza le notifiche
<a name="v9-alerting-notifications"></a>

****  
**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 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)

Personalizza le tue notifiche con i modelli di notifica.

Puoi utilizzare i modelli di notifica per modificare il titolo, il messaggio e il formato del messaggio nelle notifiche.

I modelli di notifica non sono legati a integrazioni di punti di contatto specifiche, come email o Slack. Tuttavia, puoi scegliere di creare modelli di notifica separati per diverse integrazioni di punti di contatto.

Puoi utilizzare i modelli di notifica per:
+ Aggiungere, rimuovere o riordinare le informazioni nella notifica, tra cui riepilogo, descrizione, etichette e annotazioni, valori e link
+ Formatta il testo in grassetto e corsivo e aggiungi o rimuovi interruzioni di riga

Non è possibile utilizzare i modelli di notifica per:
+ Modifica il design delle notifiche nei servizi di messaggistica istantanea come Slack e Microsoft Teams

**Topics**
+ [Usare il linguaggio di template di Go](v9-alerting-notifications-go-templating.md)
+ [Crea modelli di notifica](v9-alerting-create-templates.md)
+ [Riferimento modello](v9-alerting-template-reference.md)

# Usare il linguaggio di template di Go
<a name="v9-alerting-notifications-go-templating"></a>

****  
**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 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)

[Scrivi modelli di notifica nel linguaggio di template di Go, text/template.](https://pkg.go.dev/text/template)

Questa sezione fornisce una panoramica del linguaggio di template di Go e dei modelli di scrittura in text/template.

## Dot
<a name="v9-go-dot"></a>

 text/template C'è un cursore speciale chiamato punto, ed è scritto come`.`. Puoi pensare a questo cursore come a una variabile il cui valore cambia a seconda del punto del modello in cui viene utilizzato. Ad esempio, all'inizio di un modello di notifica `.` si fa riferimento all'`ExtendedData`oggetto, che contiene una serie di campi tra cui `Alerts``Status`, `GroupLabels``CommonLabels`, `CommonAnnotations` e`ExternalURL`. Tuttavia, dot potrebbe fare riferimento a qualcos'altro quando viene utilizzato in un `range` elenco completo, all'interno di un `with` o quando si scrivono modelli di funzionalità da utilizzare in altri modelli. Puoi vedere esempi di ciò in[Crea modelli di notifica](v9-alerting-create-templates.md), e tutti i dati e le funzioni in[Riferimento modello](v9-alerting-template-reference.md).

## Tag di apertura e chiusura
<a name="v9-go-openclosetags"></a>

In text/template, i modelli iniziano `{{` e finiscono con `}}` indipendentemente dal fatto che il modello stampi una variabile o esegua strutture di controllo come le istruzioni if. Questo è diverso da altri linguaggi di template come Jinja, dove la stampa di una variabile utilizza `{{` e e le strutture di controllo utilizzano e`}}`. `{%` `%}`

## Print (Stampa)
<a name="v9-go-print"></a>

Per stampare il valore di qualcosa usa e. `{{` `}}` È possibile stampare il valore di un punto, un campo di punti, il risultato di una funzione e il valore di una [variabile](#v9-go-variables). Ad esempio, per stampare il `Alerts` campo a cui si riferisce il punto `ExtendedData` devi scrivere quanto segue:

```
{{ .Alerts }}
```

## Esegui iterazioni sugli avvisi
<a name="v9-go-iterate-alerts"></a>

Per stampare solo le etichette di ogni avviso, anziché tutte le informazioni sull'avviso, puoi utilizzare `range` a per iterare gli avvisi in: `ExtendedData`

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

All'interno dell'intervallo il punto non si riferisce più a`ExtendedData`, ma a un. `Alert` È possibile utilizzare `{{ .Labels }}` per stampare le etichette di ogni avviso. Funziona perché `{{ range .Alerts }}` cambia il punto per fare riferimento all'avviso corrente nell'elenco degli avvisi. Quando l'intervallo è terminato, il punto viene ripristinato al valore che aveva prima dell'inizio dell'intervallo, che in questo esempio è`ExtendedData`:

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Esegui iterazioni su annotazioni ed etichette
<a name="v9-go-iterate-labels"></a>

Scriviamo un modello per stampare le etichette di ogni avviso nel formato`The name of the label is $name, and the value is $value`, dove `$name` e `$value` contiene il nome e il valore di ogni etichetta.

Come nell'esempio precedente, utilizzate un intervallo per scorrere gli avvisi in `.Alerts` modo che il punto si riferisca all'avviso corrente nell'elenco degli avvisi, quindi utilizzate un secondo intervallo sulle etichette ordinate in modo che dot venga aggiornato una seconda volta per fare riferimento all'etichetta corrente. All'interno del secondo intervallo usa `.Name` e stampa `.Value` il nome e il valore di ogni etichetta:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Dichiarazioni If
<a name="v9-go-if"></a>

È possibile utilizzare le istruzioni if nei modelli. Ad esempio, per stampare `There are no alerts` se non sono presenti avvisi, `.Alerts` è necessario scrivere quanto segue:

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Con
<a name="v9-go-with"></a>

With è simile alle istruzioni if, tuttavia a differenza delle istruzioni if, `with` aggiorna dot per fare riferimento al valore di with:

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variabili
<a name="v9-go-variables"></a>

Le variabili in text/template devono essere create all'interno del modello. Ad esempio, per creare una variabile chiamata `$variable` con il valore corrente di dot devi scrivere quanto segue:

```
{{ $variable := . }}
```

Puoi usare `$variable` all'interno di un intervallo o `with` e farà riferimento al valore di dot nel momento in cui la variabile è stata definita, non al valore corrente di dot.

Ad esempio, non puoi scrivere un modello da utilizzare `{{ .Labels }}` nel secondo intervallo perché qui il punto si riferisce all'etichetta corrente, non all'avviso corrente:

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Puoi risolvere questo problema definendo una variabile chiamata `$alert` nel primo intervallo e prima del secondo intervallo:

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Intervallo con indice
<a name="v9-go-rangeindex"></a>

È possibile ottenere l'indice di ogni avviso all'interno di un intervallo definendo le variabili di indice e valore all'inizio dell'intervallo:

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Definire i modelli
<a name="v9-go-define"></a>

È possibile definire modelli che possono essere utilizzati all'interno di altri modelli, utilizzando `define` e il nome del modello tra virgolette doppie. Non è necessario definire modelli con lo stesso nome di altri modelli, inclusi modelli predefiniti come `__subject``__text_values_list`,`__text_alert_list`, `default.title` e`default.message`. Se è stato creato un modello con lo stesso nome di un modello predefinito o un modello in un altro modello di notifica, Grafana potrebbe utilizzare entrambi i modelli. Grafana non impedisce o mostra un messaggio di errore quando ci sono due o più modelli con lo stesso nome.

```
{{ define "print_labels" }}
{{ end }}
```

## Incorpora modelli
<a name="v9-go-embed"></a>

È possibile incorporare un modello definito all'interno del modello utilizzando `template` il nome del modello tra virgolette doppie e il cursore da passare al modello:

```
{{ template "print_labels" . }}
```

## Passa i dati ai modelli
<a name="v9-go-passdata"></a>

All'interno di un modello, il punto si riferisce al valore passato al modello.

Ad esempio, se a un modello viene passato un elenco di avvisi di attivazione, dot si riferisce a quell'elenco di avvisi di attivazione:

```
{{ template "print_alerts" .Alerts }}
```

Se al modello vengono passate le etichette ordinate per un avviso, dot si riferisce all'elenco di etichette ordinate:

```
{{ template "print_labels" .SortedLabels }}
```

Questo è utile quando si scrivono modelli riutilizzabili. Ad esempio, per stampare tutti gli avvisi potresti scrivere quanto segue:

```
{{ template "print_alerts" .Alerts }}
```

Quindi, per stampare solo gli avvisi di attivazione, puoi scrivere questo:

```
{{ template "print_alerts" .Alerts.Firing }}
```

Funziona perché entrambi `.Alerts` `.Alerts.Firing` sono elenchi di avvisi.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Commenti
<a name="v9-go-comments"></a>

Puoi aggiungere commenti con `{{/*` e`*/}}`:

```
{{/* This is a comment */}}
```

Per evitare che i commenti aggiungano interruzioni di riga, usa:

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Indentazione
<a name="v9-go-indentation"></a>

Puoi usare l'indentazione, sia di tabulazioni che di spazi, e le interruzioni di riga, per rendere i modelli più leggibili:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Tuttavia, l'indentazione nel modello sarà presente anche nel testo. Successivamente vedremo come rimuoverlo.

## Rimuovi spazi e interruzioni di riga
<a name="v9-go-removespace"></a>

In text/template uso `{{-` e `-}}` per rimuovere gli spazi iniziali e finali e le interruzioni di riga.

Ad esempio, quando si utilizzano indentazioni e interruzioni di riga per rendere un modello più leggibile:

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

L'indentazione e le interruzioni di riga saranno presenti anche nel testo:

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Puoi rimuovere i rientri e le interruzioni di riga dal testo cambiando la posizione `}}` `-}}` all'inizio di ogni intervallo:

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

I rientri e le interruzioni di riga nel modello sono ora assenti dal testo:

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Crea modelli di notifica
<a name="v9-alerting-create-templates"></a>

****  
**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 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)

Crea modelli di notifica riutilizzabili da inviare ai tuoi punti di contatto.

Puoi aggiungere uno o più modelli al tuo modello di notifica.

Il nome del modello di notifica deve essere univoco. Non è possibile avere due modelli con lo stesso nome nello stesso modello di notifica o in modelli di notifica diversi. Evita di definire modelli con lo stesso nome dei modelli predefiniti, ad esempio: `__subject``__text_values_list`,`__text_alert_list`, `default.title` e`default.message`.

Nella scheda Punti di contatto, puoi visualizzare un elenco dei tuoi modelli di notifica.

## Creazione di modelli di notifica
<a name="v9-alerting-creating-templates"></a>

**Per creare un modello di notifica**

1. Fai clic su **Aggiungi modello**.

1. Scegli un nome per il modello di notifica, ad esempio`email.subject`.

1. Scrivi il contenuto del modello nel campo del contenuto.

   Esempio:

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Fai clic su Salva.

   `{{ define "email.subject" }}`(`email.subject`dov'è il nome del modello) e `{{ end }}` viene aggiunto automaticamente all'inizio e alla fine del contenuto.

**Per creare un modello di notifica che contenga più di un modello:**

1. Fai clic su **Aggiungi modello**.

1. Inserisci un nome per il modello di notifica generale. Ad esempio, `email`.

1. Scrivi ogni modello nel campo Contenuto, incluso `{{ define "name-of-template" }}` e `{{ end }}` all'inizio e alla fine di ogni modello. È possibile utilizzare nomi descrittivi per ciascuno dei modelli nel modello di notifica, ad esempio, `email.subject` o`email.message`. In questo caso, non riutilizzare il nome del modello di notifica inserito in precedenza.

   Le sezioni seguenti mostrano esempi dettagliati di modelli che potresti creare.

1. Fai clic su Salva.

## Creazione di un modello per l'oggetto di un'e-mail
<a name="v9-alerting-create-template-subject"></a>

Crea un modello per l'oggetto di un'e-mail che contenga il numero di avvisi di attivazione e risolti, come in questo esempio:

```
1 firing alerts, 0 resolved alerts
```

**Per creare un modello per l'oggetto di un'e-mail**

1. Crea un modello chiamato `email.subject` con il seguente contenuto:

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Usa il modello quando crei l'integrazione del punto di contatto inserendolo nel campo **Oggetto** con la `template` parola chiave.

   ```
   {{ template "email.subject" . }}
   ```

## Creazione di un modello per il messaggio di un'e-mail
<a name="v9-alerting-create-template-message"></a>

Crea un modello per il messaggio di un'e-mail che contenga un riepilogo di tutti gli avvisi di attivazione e risolti, come in questo esempio:

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Per creare un modello per il messaggio di un'e-mail**

1. Crea un modello di notifica chiamato `email` con due modelli nel contenuto: `email.message_alert` e`email.message`.

   Il `email.message_alert` modello viene utilizzato per stampare le etichette e i valori per ogni avviso di attivazione e risolto, mentre il `email.message` modello contiene la struttura dell'e-mail.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Utilizza il modello per creare l'integrazione del punto di contatto inserendolo nel campo **Text Body** con la `template` parola chiave.

   ```
   {{ template "email.message" . }}
   ```

## Creazione di un modello per il titolo di un messaggio Slack
<a name="v9-alerting-create-template-slack-title"></a>

Crea un modello per il titolo di un messaggio Slack che contenga il numero di avvisi attivati e risolti, come nell'esempio seguente:

```
1 firing alerts, 0 resolved alerts
```

**Per creare un modello per il titolo di un messaggio Slack**

1. Crea un modello chiamato `slack.title` con il seguente contenuto:

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Usa il modello quando crei l'integrazione del tuo punto di contatto inserendolo nel campo **Titolo** con la `template` parola chiave.

   ```
   {{ template "slack.title" . }}
   ```

## Creazione di un modello per il contenuto di un messaggio Slack
<a name="v9-alerting-create-template-slack-message"></a>

Crea un modello per il contenuto di un messaggio Slack che contenga una descrizione di tutti gli avvisi attivati e risolti, comprese le etichette, le annotazioni e l'URL della dashboard:

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Per creare un modello per il contenuto di un messaggio Slack**

1. Crea un modello chiamato `slack` con due modelli nel contenuto: `slack.print_alert` e`slack.message`.

   Il `slack.print_alert` modello viene utilizzato per stampare le etichette, le annotazioni e DashboardURL mentre il `slack.message` modello contiene la struttura della notifica.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Usa il modello quando crei l'integrazione del punto di contatto inserendolo nel campo **Text Body con la parola chiave**. `template`

   ```
   {{ template "slack.message" . }}
   ```

## Crea modelli sia per email che per Slack con modelli condivisi
<a name="v9-alerting-create-shared-templates"></a>

Invece di creare modelli di notifica separati per ogni punto di contatto, come email e Slack, puoi condividere lo stesso modello.

Ad esempio, se desideri inviare un'email con questo oggetto e un messaggio Slack con questo titolo`1 firing alerts, 0 resolved alerts`, puoi creare un modello condiviso.

**Per creare un modello condiviso**

1. Crea un modello chiamato `common.subject_title` con il seguente contenuto:

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Per le e-mail, esegui il modello dal campo dell'oggetto nell'integrazione del punto di contatto e-mail:

   ```
   {{ template "common.subject_title" . }}
   ```

1. Per Slack, esegui il modello dal campo del titolo nell'integrazione con i punti di contatto Slack:

   ```
   {{ template "common.subject_title" . }}
   ```

## Utilizzo dei modelli di notifica
<a name="v9-alerting-use-notification-templates"></a>

Utilizza i modelli nei punti di contatto per personalizzare le notifiche.

**Per utilizzare un modello durante la creazione di un punto di contatto**

1. Dal menu **Avvisi**, scegli **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti.

1. Scegli **Aggiungi punto di contatto**. In alternativa, puoi modificare un punto di contatto esistente scegliendo l'icona **Modifica** (penna) accanto al punto di contatto che desideri modificare.

1. Inserisci i modelli che desideri utilizzare in uno o più campi, come **Messaggio** o **Oggetto**. Per inserire un modello, usa il modulo`{{ template "template_name" . }}`, sostituendolo *template\$1name* con il nome del modello che desideri utilizzare.

1. Fai clic su **Salva punto di contatto**.

# Riferimento modello
<a name="v9-alerting-template-reference"></a>

****  
**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 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)

Questa sezione fornisce informazioni di riferimento per la creazione dei modelli.

## Dati del modello
<a name="v9-alerting-template-data"></a>

I seguenti dati vengono passati ai modelli di messaggio.


| Name | Tipo | Note | 
| --- | --- | --- | 
|  `Receiver`  |  stringa  |  Nome del punto di contatto a cui viene inviata la notifica.  | 
|  `Status`  |  stringa  |  attivazione se viene attivato almeno un avviso, altrimenti risolto.  | 
|  `Alerts`  |  Alert  |  Elenco degli oggetti di avviso inclusi in questa notifica (vedi sotto).  | 
|  `GroupLabels`  |  KeyValue  |  Etichette in base alle quali questi avvisi sono stati raggruppati.  | 
|  `CommonLabels`  |  KeyValue  |  Etichette comuni a tutti gli avvisi inclusi in questa notifica.  | 
|  `CommonAnnotations`  |  KeyValue  |  Annotazioni comuni a tutti gli avvisi inclusi in questa notifica.  | 
|  `ExternalURL`  |  stringa  |  Link di ritorno al Grafana che ha inviato la notifica. Se si utilizza un Alertmanager esterno, ricollega a questo Alertmanager.  | 

Il `Alerts` tipo espone due funzioni per filtrare gli avvisi restituiti.
+ `Alerts.Firing`— Restituisce un elenco di avvisi di attivazione.
+ `Alerts.Resolved`— Restituisce un elenco di avvisi risolti.

**Avviso (tipo)**

Il tipo di avviso contiene i seguenti dati.


| Name | Tipo | Note | 
| --- | --- | --- | 
|  Status  |  stringa  |  `firing` o `resolved`.  | 
|  Etichette  |  KeyValue  |  Un set di etichette allegate all'avviso.  | 
|  Annotazioni  |  KeyValue  |  Un insieme di annotazioni allegate all'avviso.  | 
| Valori | KeyValue | I valori di tutte le espressioni, incluse le condizioni classiche | 
|  StartsAt  |  Time.time  |  L'ora in cui l'allarme ha iniziato a scattare.  | 
|  EndsAt  |  Tempo. Tempo  |  Impostato solo se è nota l'ora di fine di un avviso. Altrimenti impostato su un periodo di timeout configurabile dal momento in cui è stato ricevuto l'ultimo avviso.  | 
|  URL del generatore  |  stringa  |  Un link a Grafana o un gestore di avvisi esterno.  | 
|  URL silenzioso  |  stringa  |  Un link per silenziare l'avviso (con le etichette precompilate per questo avviso). Solo per gli avvisi gestiti da Grafana.  | 
|  URL del pannello di controllo  |  stringa  |  Collegamento alla dashboard di Grafana, se la regola di avviso appartiene a una di esse. Solo per gli avvisi gestiti da Grafana.  | 
|  URL del pannello  |  stringa  |  Collegamento al pannello di dashboard di Grafana, se la regola di avviso appartiene a uno. Solo per gli avvisi gestiti da Grafana.  | 
|  Impronta digitale  |  stringa  |  Impronta digitale che può essere utilizzata per identificare l'avviso.  | 
|  ValueString  |  stringa  |  Una stringa che contiene le etichette e il valore di ogni espressione ridotta nell'avviso.  | 

 **ExtendedData**

L' ExtendedData oggetto contiene le seguenti proprietà.


| Name | Tipo | Description | Esempio | 
| --- | --- | --- | --- | 
|  Ricevitore  |  `string`  |  Il nome del punto di contatto che invia la notifica.  |  `{{ .Receiver }}`  | 
|  Status  |  `string`  |  Lo stato è `firing if at least one alert is firing, otherwise resolved.`  |  `{{ .Status }}`  | 
|  Avvisi  |  `[]Alert`  |  Elenco di tutti gli allarmi attivi e risolti in questa notifica.  |  `There are {{ len .Alerts }} alerts`  | 
|  Avvisi di attivazione  |  `[]Alert`  |  Elenco di tutti gli allarmi di attivazione contenuti in questa notifica.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Avvisi risolti  |  `[]Alert`  |  Elenco di tutti gli avvisi risolti in questa notifica.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Le etichette che raggruppano questi avvisi in questa notifica.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Le etichette comuni a tutti gli avvisi di questa notifica.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Le annotazioni comuni a tutti gli avvisi di questa notifica.  |  `{{ .CommonAnnotations }}`  | 
|  URL esterno  |  `string`  |  Un collegamento all'area di lavoro Grafana o Alertmanager che ha inviato questa notifica.  |  `{{ .ExternalURL }}`  | 

**KeyValue tipo**

Il `KeyValue` tipo è un insieme di coppie di key/value stringhe che rappresentano etichette e annotazioni.

Oltre all'accesso diretto ai dati archiviati come file`KeyValue`, esistono anche metodi per ordinare, rimuovere e trasformare i dati.


| Name | Arguments (Argomenti) | Valori restituiti | Note | Esempio | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Elenco ordinato di coppie di stringhe di chiavi e valori  |    | `{{ .Annotations.SortedPairs }}` | 
|  Rimuovi  |  [] stringa  |  KeyValue  |  Restituisce una copia della Key/Value mappa senza le chiavi fornite.  | `{{ .Annotations.Remove "summary" }}` | 
|  Nomi  |    |  [] stringa  |  Elenco dei nomi delle etichette  | `{{ .Names }}` | 
|  Valori  |    |  [] stringa  |  Elenco dei valori delle etichette  | `{{ .Values }}` | 

**Time** (Orario)

L'ora proviene dal [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)pacchetto Go. È possibile stampare un orario in diversi formati. Ad esempio, per stampare l'ora di attivazione di un avviso nel formato`Monday, 1st January 2022 at 10:00AM`, scrivi il seguente modello:

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Puoi trovare un riferimento per il formato orario di Go [qui](https://pkg.go.dev/time#pkg-constants).

## Funzioni del modello
<a name="v9-alerting-template-functions"></a>

Utilizzando le funzioni del modello è possibile elaborare etichette e annotazioni per generare notifiche dinamiche. Sono disponibili le seguenti funzioni.


| Name | Tipo di argomento | Tipo restituito | Description | 
| --- | --- | --- | --- | 
|  `humanize`  |  numero o stringa  |  stringa  |  Converte un numero in un formato più leggibile, utilizzando prefissi metrici.  | 
|  `humanize1024`  |  numero o stringa  |  stringa  |  Come humanize, ma usa 1024 come base anziché 1000.  | 
|  `humanizeDuration`  |  numero o stringa  |  stringa  |  Converte una durata in secondi in un formato più leggibile.  | 
|  `humanizePercentage`  |  numero o stringa  |  stringa  |  Converte un valore del rapporto in una frazione di 100.  | 
|  `humanizeTimestamp`  |  numero o stringa  |  stringa  |  Converte un timestamp Unix in pochi secondi in un formato più leggibile.  | 
|  `title`  |  stringa  |  stringa  |  Strings.title, mette in maiuscolo il primo carattere di ogni parola.  | 
|  `toUpper`  |  stringa  |  stringa  |  stringhe. ToUpper, converte tutti i caratteri in lettere maiuscole.  | 
|  `toLower`  |  stringa  |  stringa  |  stringhe. ToLower, converte tutti i caratteri in minuscolo.  | 
|  `match`  |  motivo, testo  |  Booleano  |  espressione regolare. MatchString Verifica una corrispondenza regexp non ancorata.  | 
|  `reReplaceAll`  |  modello, sostituzione, testo  |  stringa  |  Regexp. ReplaceAllString Sostituzione Regexp, non ancorata.  | 
|  `graphLink`  |  string - Oggetto JSON con e campi `expr` `datasource`  |  stringa  |  Restituisce il percorso della visualizzazione grafica in Explore per l'espressione e l'origine dati specificate.  | 
|  `tableLink`  |  string - Oggetto JSON con `expr` e campi `datasource`  |  stringa  |  Restituisce il percorso della vista tabulare in Explore per l'espressione e l'origine dati specificate.  | 
|  `args`  |  [] interfaccia \$1\$1  |  mappa [stringa] interfaccia \$1\$1  |  Converte un elenco di oggetti in una mappa con chiavi, ad esempio arg0, arg1. Utilizzate questa funzione per passare più argomenti ai modelli.  | 
|  `externalURL`  |  nulla  |  stringa  |  Restituisce una stringa che rappresenta l'URL esterno.  | 
|  `pathPrefix`  |  nulla  |  stringa  |  Restituisce il percorso dell'URL esterno.  | 

La tabella seguente mostra esempi di utilizzo di ciascuna funzione.


| Funzione | TemplateString | Input | Expected (Atteso) | 
| --- | --- | --- | --- | 
|  umanizzare  |  \$1umanizza \$1value\$1  |  1234567,0  |  1,235 M  | 
|  umanizza 1024  |  \$1humanize1024 \$1value\$1  |  1048576,0  |  1 Mi  | 
|  Durata umanizzata  |  \$1UmanizeDuration \$1value\$1  |  899,99  |  14 m 59 s  | 
|  Umanizza la percentuale  |  \$1humanizePercentage \$1value\$1  |  0,1234567  |  12,35%  | 
|  Umanizza il timestamp  |  \$1humanizeTimestamp \$1value\$1  |  1435065584,128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  titolo  |  \$1\$1valore \$1 titolo\$1  |  un B C  |  Aa Bb Cc  | 
|  toUpper  |  \$1\$1valore \$1 toUpper\$1  |  un dB C  |  A B C  | 
|  toLower  |  \$1\$1valore \$1 toLower\$1  |  un B C  |  a b c  | 
|  match  |  \$1match «a\$1» \$1labels.instance\$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll «localhost :( .\$1)» «my.domain: \$11" \$1labels.instance\$1\$1  |  host locale: 3000  |  mio.domain:3000  | 
|  GraphLink  |  \$1\$1graphLink «\$1\$1" expr\$1»:\$1 "up\$1»,\$1 "fonte dati\$1»:\$1 "gdev-prometheus\$1"\$1»\$1\$1  |    |  /esplorare? left= ["ora-1h», "adesso», "gdev-prometheus», \$1"datasource» :"gdev-prometheus», "expr» :"up», "instant» :false, "range» :true\$1]  | 
|  TableLink  |  \$1\$1tableLink «\$1\$1" expr\$1»:\$1 "up\$1»,\$1 "fonte dati\$1»:\$1 "gdev-prometheus\$1"\$1»\$1\$1  |    |  /esplorare? left= ["ora-1h», "adesso», "gdev-prometheus», \$1"datasource» :"gdev-prometheus», "expr» :"up», "instant» :true, "range» :false\$1]  | 
|  args  |  \$1\$1define «x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1template «x» (args 1 «2")\$1\$1  |    |  1 2  | 
|  URL esterno  |  \$1URL esterno\$1  |    |  http://localhost/path/prefix  | 
|  Prefisso del percorso  |  \$1PathPrefix\$1  |    |  /percorso/prefisso  | 

# Silenziamento delle notifiche di avviso per le fonti di dati Prometheus
<a name="v9-alerting-silences"></a>

****  
**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 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)

*Per le fonti di dati esterne di Alert Manager (incluso Amazon Managed Service for Prometheus), puoi sopprimere le notifiche di avviso con un silenzio.* Un silenzio impedisce solo la creazione di notifiche: i silenzi non impediscono la valutazione delle regole di avviso e non impediscono la visualizzazione delle istanze di avviso nell'interfaccia utente. Quando si silenzia un avviso, si specifica un intervallo di tempo entro il quale tale avviso deve essere soppresso.

È possibile configurare i silenzi per un'origine dati esterna di Alertmanager.

**Nota**  
Per sopprimere le notifiche di avviso a intervalli di tempo regolari o per altre fonti di dati (ad esempio, durante i normali periodi di manutenzione), utilizza anziché i silenzi. [Tempi di silenziamento](v9-alerting-notification-muting.md)

**Per aggiungere un silenzio**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. Scegli **Silences per aprire un elenco** di pagine esistenti. [Lavorare con i punti di contatto](v9-alerting-contact-points.md)

1. **Scegli il gestore di avvisi esterno dal menu a discesa Alertmanager.**

1. **Seleziona** Aggiungi silenzio.

1. Seleziona la data di inizio e di fine in **Silenzio inizio e fine** per indicare quando il silenzio deve entrare in vigore e quando dovrebbe finire.

   In alternativa all'impostazione di un'ora di fine, in **Durata**, specifica per quanto tempo viene applicato il silenzio. Questo aggiorna automaticamente l'ora di fine nel campo di **inizio e fine del silenzio**.

1. Nei campi **Nome** e **Valore**, inserisci una o più *etichette corrispondenti*. Gli abbinatori determinano a quali regole si applica il silenzio. La corrispondenza delle etichette viene discussa più dettagliatamente seguendo questa procedura.

1. Facoltativamente, aggiungi un **commento** o modifica il **Creatore** per impostare il proprietario del silenzio.

1. Scegli **Crea** per creare il silenzio.

Puoi modificare un silenzio esistente scegliendo l'icona **Modifica** (penna).

**Corrispondenza delle etichette per la soppressione degli avvisi**

Quando si crea un silenzio, si crea una serie di *etichette corrispondenti* come parte del silenzio. Si tratta di un insieme di regole sulle etichette che devono corrispondere affinché l'avviso venga soppresso. Le etichette corrispondenti sono costituite da tre parti:
+ **Etichetta**: il nome dell'etichetta da abbinare. Deve corrispondere esattamente al nome dell'etichetta dell'avviso.
+ **Operatore**: l'operatore utilizzato per confrontare il valore dell'etichetta con il valore dell'etichetta corrispondente. Gli operatori disponibili sono:
  + `=`Seleziona le etichette il cui valore corrisponde esattamente alla stringa fornita.
  + `!=`Seleziona le etichette il cui valore non corrisponde alla stringa fornita.
  + `=~`Seleziona le etichette il cui valore corrisponde al valore interpretato dall'espressione regolare della stringa fornita (la stringa fornita viene interpretata come un'espressione regolare).
  + `!=`Seleziona le etichette che non corrispondono all'espressione regolare fornita.
+ **Valore**: il valore a cui abbinare il valore dell'etichetta. Può corrispondere come stringa o come espressione regolare, a seconda dell'operatore scelto.

Un silenzio termina alla data di fine indicata, ma è possibile terminare manualmente la soppressione in qualsiasi momento.

**Per terminare un silenzio manualmente**

1. Nella pagina **Avvisi**, scegli **Silenzi** per visualizzare l'elenco dei silenzi esistenti.

1. **Seleziona il silenzio che vuoi terminare e scegli Annulla silenzio.** Questo termina la soppressione degli avvisi.
**Nota**  
La disattivazione del silenzio interrompe la soppressione degli avvisi, come se l'ora di fine fosse impostata per l'ora corrente. I silenzi terminati (automaticamente o manualmente) vengono conservati ed elencati per cinque giorni. Non è possibile rimuovere manualmente un silenzio dall'elenco.

**Creazione di un collegamento al modulo per la creazione del silenzio**

È possibile creare un URL per il modulo di creazione del silenzio con i dettagli già compilati. Gli operatori possono utilizzarlo per sopprimere rapidamente un allarme durante un evento operativo.

Quando create un collegamento a un modulo di silenzio, utilizzate un parametro di `matchers` query per specificare le etichette corrispondenti e un parametro di `comment` query per specificare un commento. Il `matchers` parametro richiede uno o più valori nel modulo`[label][operator][value]`, separati da virgole.

**URL di esempio**

Per creare un collegamento a un modulo silenzioso, con etichette corrispondenti `severity=critical` e`cluster!~europe-.*`, con un commento che dice`Silencing critical EU alerts`, usa un URL come il seguente. Sostituisci *mygrafana* con il nome host dell'istanza Grafana.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Per creare un collegamento a una nuova pagina silenziosa per un Alertmanager esterno, aggiungi un parametro di `alertmanager` query con il nome dell'origine dati Alertmanage, ad esempio. `alertmanager=myAlertmanagerdatasource`

# Tempi di silenziamento
<a name="v9-alerting-notification-muting"></a>

****  
**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 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)

Una tempistica di silenziamento è un intervallo di tempo ricorrente in cui non vengono generate o inviate nuove notifiche relative a una policy. Utilizzali per evitare che gli avvisi si attivino in un periodo specifico e ricorrente, ad esempio un periodo di manutenzione regolare.

Analogamente ai silenzi, i tempi di disattivazione dell'audio non impediscono la valutazione delle regole di avviso né impediscono la visualizzazione delle istanze di avviso nell'interfaccia utente. Impediscono solo la creazione di notifiche.

È possibile configurare i tempi di silenziamento gestiti da Grafana e i tempi di silenziamento per un'origine dati Alertmanager esterna.

**Tempi di silenziamento rispetto ai silenzi**

La tabella seguente evidenzia le differenze tra i tempi di silenziamento e i silenzi.


| Tempistica del silenziamento | Silenzio | 
| --- | --- | 
|  Utilizza definizioni di intervalli di tempo che possono ripetersi.  |  Ha un'ora di inizio e di fine fisse.  | 
|  Viene creato e quindi aggiunto alle politiche di notifica.  |  Utilizza le etichette per confrontarle con un avviso per determinare se silenziarlo o meno.  | 
|  Funziona con avvisi Grafana e gestori di avvisi esterni.  |  Funziona solo con gestori di avvisi esterni.  | 

**Per creare una tempistica di silenziamento**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Nella sezione Tempi di **silenziamento, scegli il pulsante Aggiungi tempi di** silenziamento.**

1. Scegli l'intervallo di tempo a cui desideri applicare la tempistica di silenziamento.

1. Scegli **Invia per creare la tempistica** del silenziamento.

**Per aggiungere una tempistica di silenziamento a una politica di notifica**

1. **Seleziona la politica di notifica a cui desideri aggiungere la tempistica di silenziamento e scegli il pulsante Modifica.**

1. Dal menu a discesa **Tempi di silenziamento, seleziona gli** orari di silenziamento che desideri aggiungere alla politica.

   **Scegli il pulsante Salva politica.**

**Intervalli di tempo**

Un intervallo di tempo è una definizione per un intervallo di tempo. Se un avviso viene avviato durante questo intervallo, viene soppresso. Gli intervalli sono supportati utilizzando `:` (ad esempio,). `monday:thursday` Una temporizzazione di silenziamento può contenere più intervalli di tempo. Un intervallo di tempo è costituito da più campi (i dettagli sono riportati nell'elenco seguente), che devono corrispondere tutti per eliminare gli avvisi. Ad esempio, se si specificano i giorni della settimana `monday:friday` e l'intervallo di orario dalle 8:00 alle 9:00, gli avvisi vengono eliminati dalle 8:00 alle 9:00, dal lunedì al venerdì, ma non, ad esempio, dalle 8:00 alle 9 il sabato.
+ **Intervallo di tempo**: l'ora del giorno in cui sopprimere le notifiche. È composto da due sottocampi, Ora di **inizio e Ora** di **fine**. Un esempio di ora è`14:30`. L'ora è espressa nella notazione di 24 ore, in UTC.
+ **Giorni della settimana**: i giorni della settimana. Può essere un singolo giorno, ad esempio un intervallo`monday`, ad esempio`monday:friday`, o un elenco di giorni separati da virgole, ad esempio. `monday, tuesday, wednesday`
+ **Mesi**: i mesi da selezionare. È possibile specificare i mesi con designazioni numeriche o con il nome completo del mese, ad esempio, `1` oppure `january` entrambi specificano gennaio. È possibile specificare un solo mese, un intervallo di mesi o un elenco di mesi separati da virgole.
+ **Giorni del mese**: le date entro un mese. I valori possono variare da `1` -`31`. I valori negativi specificano i giorni del mese in ordine inverso, quindi `-1` rappresentano l'ultimo giorno del mese. I giorni del mese possono essere specificati come un singolo giorno, un intervallo di giorni o un elenco di giorni separato da virgole.
+ **Anni**: l'anno o gli anni per l'intervallo. Ad esempio, `2023:2025`.

Ciascuno di questi elementi può essere un elenco e almeno un elemento nell'elemento deve essere soddisfatto per avere una corrispondenza. Quindi, se imposti gli anni`2023:2025, 2027`, allora sarebbe vero nel 2023, 2024, 2025 e 2027 (ma non nel 2026).

Se un campo viene lasciato vuoto, qualsiasi momento corrisponderà al campo. Un momento deve corrispondere a tutti i campi per corrispondere a un intervallo di tempo completo.

Se desideri specificare una durata esatta, specifica tutte le opzioni necessarie per tale durata. Ad esempio, se desideri creare un intervallo di tempo per il primo lunedì del mese, per marzo, giugno, settembre e dicembre, tra le 12:00 e le 24:00 UTC, la specifica dell'intervallo di tempo potrebbe essere:
+ Intervallo di tempo:
  + Ora di inizio: `12:00`
  + Ora di fine: `24:00`
+ Giorni della settimana: `monday`
+ Mesi: `3, 6, 9, 12`
+ Giorni del mese: `1:7`

# Visualizza e filtra per gruppi di avvisi
<a name="v9-alerting-viewfiltergroups"></a>

****  
**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 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)

I gruppi di avvisi mostrano avvisi raggruppati provenienti da un'istanza di Alertmanager. Per impostazione predefinita, le regole di avviso sono raggruppate in base alle chiavi di etichetta per la politica principale nelle politiche di notifica. Il raggruppamento delle regole di avviso comuni in un unico gruppo di avvisi impedisce l'attivazione di regole di avviso duplicate.

È possibile visualizzare i gruppi di avvisi e anche filtrare le regole di avviso che corrispondono a criteri specifici.

**Per visualizzare i gruppi di avvisi**

1. Nel menu Grafana, fai clic sull'icona **Avvisi** (campana) per aprire la pagina Avvisi che elenca gli avvisi esistenti.

1. Fai clic su **Gruppi di avvisi** per aprire la pagina che elenca i gruppi esistenti.

1. Dal menu a discesa **Alertmanager**, seleziona un Alertmanager esterno come fonte di dati.

1. Dal menu a discesa **personalizzato raggruppa per**, seleziona una combinazione di etichette per visualizzare un raggruppamento diverso da quello predefinito. Ciò è utile per eseguire il debug e verificare il raggruppamento delle politiche di notifica.

Se un avviso non contiene le etichette specificate nel raggruppamento della policy principale o nel raggruppamento personalizzato, l'avviso viene aggiunto a un gruppo catch all con un'intestazione di. `No grouping`

**Per filtrare per etichetta**
+ In **Cerca**, inserisci un'etichetta esistente per visualizzare gli avvisi corrispondenti all'etichetta.

  Ad esempio, `environment=production,region=~US|EU,severity!=warning`.

**Per filtrare per stato**
+ In **Stati**, seleziona gli stati Attivo, Soppresso o Non elaborato per visualizzare gli avvisi corrispondenti allo stato selezionato. Tutti gli altri avvisi sono nascosti.

# Visualizza gli errori di notifica
<a name="v9-alerting-viewnotificationerrors"></a>

****  
**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 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)

Visualizza gli errori di notifica e scopri perché non sono stati inviati o non sono stati ricevuti.

**Nota**  
Questa funzionalità è supportata solo per Grafana Alertmanager.

**Per visualizzare gli errori di notifica**

1. Nel menu Grafana, fai clic sull'icona **Avvisi** (campana) per aprire la pagina Avvisi che elenca gli avvisi esistenti.

1. Scegli **Punti di contatto** per visualizzare un elenco dei punti di contatto esistenti.

   Se qualche punto di contatto non funziona, un messaggio nell'angolo destro dello schermo avvisa l'utente del fatto che ci sono errori e quanti sono.

1. Fai clic su un punto di contatto per visualizzare i dettagli degli errori relativi a quel punto di contatto.

   I dettagli dell'errore vengono visualizzati se si posiziona il puntatore del mouse sull'icona Errore.

   Se un punto di contatto ha più di un'integrazione, vengono visualizzati tutti gli errori per ciascuna delle integrazioni elencate.

1. Nella colonna Health, controlla lo stato della notifica.

   Può essere OK, Nessun tentativo o Errore.