

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

# Funzionamento nella versione 10 di Grafana
<a name="using-grafana-v10"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 10 di Grafana.

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

# Dashboard in Grafana versione 10
<a name="v10-dashboards"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-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](v10-dash-using-dashboards.md)
+ [Creazione di dashboard](v10-dash-building-dashboards.md)
+ [Gestione dei dashboard](v10-dash-managing-dashboards.md)
+ [Gestione delle playlist](v10-dash-managing-playlists.md)
+ [Condivisione di dashboard e pannelli](v10-dash-sharing.md)
+ [Variabili](v10-dash-variables.md)
+ [Valutazione dell'utilizzo del pannello di controllo](v10-dash-assess-dashboard-usage.md)
+ [Risoluzione dei problemi relativi ai dashboard](v10-dash-troubleshoot.md)
+ [Ricerca nelle dashboard nella versione 10 di Grafana](v10-search.md)

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-dash-features"></a>

Puoi utilizzare le dashboard per personalizzare la presentazione dei tuoi dati. L'immagine seguente mostra l'interfaccia del pannello di controllo nell'area di lavoro Amazon Managed Grafana.

![\[Un'immagine che mostra l'interfaccia per le dashboard in un'area di lavoro Amazon Managed Grafana, con punti salienti dei pulsanti per le diverse funzionalità.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Funzionalità  |  Description  | 
| --- | --- | 
| **1. Home** | Seleziona l'icona principale di Grafana per essere reindirizzato alla home page configurata nell'istanza Grafana. | 
| **2. Titolo** | Quando selezioni il titolo della dashboard, puoi cercare le dashboard contenute nella cartella corrente. | 
| **3. Condivisione di un pannello di controllo** | 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. Salva dashboard** | Scegli l'icona Salva per salvare le modifiche alla dashboard. | 
| **6. Approfondimenti sulla dashboard** | Scegli di visualizzare le analisi sulla tua dashboard, comprese le informazioni sugli utenti, sulle attività e sul numero di query. Per ulteriori informazioni, consulta [Valutazione dell'utilizzo del pannello di controllo](v10-dash-assess-dashboard-usage.md). | 
| **7. Impostazioni del pannello di controllo** | Utilizza questa opzione per modificare il nome, la cartella o 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](v10-dash-modify-settings.md) | 
| **8. Menu a discesa Time Picker** |  Utilizza per selezionare le opzioni relative all'intervallo di tempo e impostare intervalli di tempo assoluti personalizzati. È possibile modificare le impostazioni del **fuso orario** e **dell'anno fiscale** dai controlli dell'intervallo di tempo facendo clic sul pulsante **Modifica impostazioni temporali**. Le impostazioni dell'orario vengono salvate in base al pannello di controllo.  | 
| **9. Rimpicciolisci l'intervallo di tempo** |  Usare per rimpicciolire l'intervallo di tempo. Per ulteriori informazioni su come utilizzare i controlli dell'intervallo di tempo, vedere[Impostazione dell'intervallo di tempo della dashboard](#v10-dash-setting-dashboard-time-range).  | 
| **10. Aggiorna dashboard** | Seleziona questa opzione per attivare immediatamente le interrogazioni e aggiornare i dati del dashboard. | 
| **11. Aggiorna l'intervallo di tempo della dashboard** | Seleziona un intervallo di tempo di aggiornamento automatico del pannello di controllo. | 
| **12. Modalità di visualizzazione**  | Seleziona questa opzione per visualizzare il pannello di controllo 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.  | 
| **13. 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, seleziona **Aggiungi pannello**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Legenda del grafico** | Modifica i colori delle serie, l'asse y e la visibilità delle serie direttamente dalla legenda. | 
| **15. 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/v10-dash-using-dashboards.html)  | 

## Tasti di scelta rapida
<a name="v10-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 del pannello di controllo. 
+ `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 tutto schermo 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="v10-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 consente di tornare indietro nel tempo, rispetto alla data e all'ora correnti, oppure. `now` 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`  | 
| Esercizio fiscale precedente |  `now-1y/fy`  |  `now-1y/fy`  | 

**Nota**  
 Grafana Alerting non supporta le seguenti sintassi:  
`now+n`per timestamp futuri.
`now-1n/n`per l'*inizio di n fino alla fine di n*, perché si tratta di un timestamp assoluto.

**Controlli comuni per l'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 gli orari esatti dell'intervallo e la loro origine (ad esempio l'ora locale del browser). 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.** Puoi anche scegliere da un elenco di intervalli di tempo assoluti utilizzati di recente.
+ L'**intervallo di tempo semirelativo** può essere selezionato nelle impostazioni dell'intervallo di tempo assoluto. Ad esempio, per mostrare l'attività a partire da una data specifica, puoi scegliere un'ora assoluta per l'ora di inizio e un'ora relativa (ad esempio`now`) per l'ora di fine.

  Utilizzando un intervallo di tempo semi-relativo, man mano che il tempo avanza, la dashboard si ingrandirà automaticamente e progressivamente per mostrare più cronologia e meno dettagli. Allo stesso ritmo, con la diminuzione dell'alta risoluzione dei dati, le tendenze storiche sull'intero periodo di tempo diventeranno più chiare.
**Nota**  
Gli avvisi non supportano intervalli di tempo semi-relativi.
+ **Rimpicciolisci** selezionando l'icona di zoom indietro (o usando Cmd\$1Z o Ctrl\$1Z come scorciatoia da tastiera). Ciò aumenta la visualizzazione, mostrando un intervallo di tempo più ampio nella visualizzazione della dashboard o del pannello.
+ **Ingrandisci** selezionando un intervallo di tempo che desideri visualizzare sul grafico della visualizzazione.
**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](#v10-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="v10-dash-building-dashboards"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. Una dashboard è composta da [pannelli](v10-panels-viz.md) con visualizzazioni. A ogni pannello è associata una query per estrarre i dati da uno dei tuoi. [Connessione alle origini dati](AMG-data-sources.md)

Puoi creare dashboard più interattivi e dinamici aggiungendo e utilizzando [variabili](v10-dash-variables.md). Invece di codificare il server, l'applicazione o altri nomi nelle query metriche, puoi utilizzare variabili al loro posto.

**Topics**
+ [Creazione di dashboard](v10-dash-creating.md)
+ [Importazione di dashboard](v10-dash-importing.md)
+ [Esportazione di pannelli di controllo](v10-dash-exporting.md)
+ [Modifica delle impostazioni del pannello di controllo](v10-dash-modify-settings.md)
+ [Variabili URL del pannello di controllo](v10-dash-dashboard-url-variables.md)
+ [Gestione dei pannelli della libreria](v10-dash-manage-library-panels.md)
+ [Gestione della cronologia delle versioni del dashboard](v10-dash-manage-version-history.md)
+ [Gestione dei collegamenti alla dashboard](v10-dash-manage-dashboard-links.md)
+ [Annota le visualizzazioni](v10-dash-annotations.md)
+ [Modello JSON del pannello di controllo](v10-dash-dashboard-json-model.md)
+ [Procedure consigliate per i dashboard](v10-dash-bestpractices.md)

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 un pannello di controllo**

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 ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md).

 Per creare una dashboard:

1. Accedi a Grafana e seleziona **Dashboards** dal menu a sinistra.

1. Seleziona **Nuovo, quindi **Nuovo**** pannello di controllo.

1. Nella dashboard vuota, seleziona **\$1 Aggiungi visualizzazione**. Si apre la nuova finestra di dialogo di visualizzazione.

1. Seleziona una fonte di dati. Puoi scegliere una fonte di dati esistente, una delle fonti di dati integrate di Grafana per i test, oppure scegliere **Configura una nuova origine dati** per configurarne una nuova (solo gli utenti con autorizzazioni di amministratore possono configurare nuove fonti di dati).

   Si apre la visualizzazione **del pannello Modifica**, con l'origine dati selezionata. È possibile modificare la fonte di dati per il pannello in un secondo momento, utilizzando la scheda **Query** dell'editor del pannello, se necessario.

1. Scrivi o costruisci una query nel linguaggio di interrogazione della tua fonte di dati. Scegli l'icona Aggiorna dashboard per eseguire una query sull'origine dati, visualizzando i risultati man mano che procedi.

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](v10-panels-viz.md).

1. In **Opzioni del pannello**, puoi inserire un titolo e una descrizione per il pannello. 

1. La maggior parte delle visualizzazioni necessita di alcune modifiche prima di visualizzare le informazioni esatte di cui hai bisogno. È possibile regolare le impostazioni del pannello nei seguenti modi.
   + [Configura le mappature dei valori](v10-panels-configure-value-mappings.md)
   + [Opzioni specifiche per la visualizzazione](v10-panels-viz.md)
   + [Sostituisci i valori dei campi](v10-panels-configure-overrides.md)
   + [Configura le soglie](v10-panels-configure-thresholds.md)
   + [Configura le opzioni standard](v10-panels-configure-standard-options.md)

1. Quando hai finito di configurare il pannello, scegli **Salva** per salvare la dashboard.

   In alternativa, seleziona **Applica** per visualizzare le modifiche senza uscire dall'editor del pannello.

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

1. Scegli **Save** (Salva).

1. Facoltativamente, puoi aggiungere altri pannelli alla dashboard scegliendo **Aggiungi** nell'intestazione della dashboard e selezionando **Visualization** dal menu a discesa.

**Copiare una dashboard esistente**

Puoi copiare rapidamente una dashboard esistente per iniziare subito a crearne una nuova.

**Per copiare una dashboard esistente**

1. Seleziona **Dashboard** dal menu a sinistra.

1. Scegli la dashboard che desideri copiare per aprirla.

1. Seleziona **Impostazioni** (icona a forma di ingranaggio) in alto a destra della dashboard.

1. Seleziona **Salva** con nome nell'angolo in alto a destra della dashboard.

1. (Facoltativo) Specificate il nome, la cartella, la descrizione e se copiare o meno i tag originali della dashboard per la dashboard copiata.

1. Seleziona **Salva**.

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

**Per configurare le righe ripetute**

1. Seleziona **Dashboard** dal menu a sinistra, quindi scegli la dashboard che desideri modificare.

1. Nella parte superiore della dashboard, seleziona **Aggiungi**, quindi seleziona **Riga** dal menu a discesa.

   Se la dashboard è vuota, puoi selezionare alternativamente il pulsante **\$1 Aggiungi riga** al centro della dashboard.

1. Passa il mouse sul titolo della riga e seleziona l'icona **Impostazioni** (ingranaggio) che appare.

1. Nella finestra di dialogo **Opzioni di 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. 

1. Selezionare **Update (Aggiorna)**.

**Righe ripetute e fonte di dati speciale del pannello di controllo**

Se una riga include pannelli che utilizzano la speciale origine dati [Dashboard](AMG-data-sources.md#AMG-data-sources-special), l'origine dati che utilizza un set di risultati di un altro pannello nella stessa dashboard, i pannelli corrispondenti nelle righe ripetute faranno riferimento al pannello nella riga originale, non a quelli nelle righe ripetute.

Ad esempio, in una dashboard:
+ `Row 1`include `Panel 1A` e`Panel 1B`.
+ `Panel 1B`utilizza i risultati di `Panel 1A` utilizzando la fonte di `Dashboard` dati.
+ La ripetizione `Row 2` include `Panel 2A` e. `Panel 2B`
+ `Panel 2B`riferimenti`Panel 1A`, no`Panel 2A`.

**Per spostare un pannello**

1. Apri il pannello di controllo .

1. Selezionate il 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, trascinate l'angolo inferiore destro del pannello. Puoi ridimensionare un pannello della dashboard in base alle tue esigenze.

# Importazione di dashboard
<a name="v10-dash-importing"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 importare dashboard preconfigurate nel tuo spazio di lavoro Amazon Managed Grafana.

**Per importare un pannello di controllo**

1. Accedi al tuo spazio di lavoro Amazon Managed Grafana.

1. Seleziona **Dashboard** dal menu a sinistra.

1. Seleziona **Nuovo** e scegli **Importa** nel menu a discesa.

1. Successivamente devi scegliere la definizione JSON della dashboard da importare. Hai tre scelte su come importare JSON:
   + Carica un file contenente il pannello di controllo JSON.
   + Copia direttamente il testo JSON nell'area di testo.
   + Incolla l'URL o l'ID di un pannello di controllo Grafana Labs nel campo. Per ulteriori informazioni sulla dashboard di grafana.com URLs, consulta la sezione successiva.
   + (Facoltativo) Modifica i dettagli del pannello di controllo che desideri modificare.
   + Seleziona una fonte di dati, se necessario.
   + Scegli **Importa**.
   + Salva la dashboard.

## Ricerca di dashboard su grafana.com
<a name="v10-dash-import-from-grafana"></a>

La pagina [Dashboards](https://grafana.com/grafana/dashboards/) su grafana.com fornisce dashboard per le applicazioni server più comuni. Sfoglia una libreria di dashboard ufficiali e create dalla community e importale per iniziare rapidamente a funzionare.

**Nota**  
Per importare dashboard da grafana.com, il tuo spazio di lavoro Amazon Managed Grafana deve avere accesso a Internet.

# Esportazione di pannelli di controllo
<a name="v10-dash-exporting"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 l'interfaccia utente Grafana o l'API HTTP per esportare i dashboard.

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.

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

**Per esportare una dashboard**

1. Apri il pannello di controllo che desideri esportare.

1. Seleziona l'icona di condivisione.

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

1. Scegli **Salva su file.**

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

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. 
   + **Fuso orario**: specifica il fuso orario locale del servizio o del sistema che stai monitorando. Questo può essere utile quando si monitora un sistema o un servizio che opera in diversi fusi orari.
     + **Predefinito**: 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.
     + **Ora locale del browser**: viene utilizzato il fuso orario configurato per il browser dell'utente di visualizzazione. 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.
   + **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 ritardo**: sostituisci l'`now`ora inserendo un ritardo. Utilizzate questa opzione per gestire i ritardi noti nell'aggregazione dei dati ed evitare valori nulli.
   + **Nascondi selettore orario**: seleziona questa opzione se non desideri che il pannello di controllo visualizzi il selettore orario.

**Nota**  
Per avere il controllo dell'ora, i dati devono includere una colonna temporale. Consulta la documentazione relativa alla 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. In alternativa, per i plug-in di origine dati che installi da[Trova i plugin con il catalogo dei plugin](grafana-plugins.md#plugin-catalog), puoi utilizzare la [documentazione sul sito Web di Grafana](https://grafana.com/docs/grafana/v10.3/datasources/) Labs.

**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.](v10-dash-variables.md)

**Per aggiungere una variabile**

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**, aggiungi il nome della variabile. Questo è il nome che utilizzerai 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. 

**Per aggiungere un link**

1. Nella pagina **delle impostazioni della dashboard**, scegli **Collegamenti** dal menu della sezione a sinistra e poi il pulsante **Aggiungi link**.

1. Inserisci un 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**  
L'utilizzo dei tag crea un menu a discesa dinamico di dashboard, tutte dotate di un tag specifico.

1. Per aggiungere un link web, 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 di una 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. I metadati JSON definiscono la dashboard.

**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.](v10-dash-dashboard-json-model.md)

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-dash-manage-dashboard-links.md) [modelli e le variabili](v10-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 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](v10-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.](v10-dash-variable-add.md#v10-dash-variable-add-adhoc)

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, sostituisci 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.

# Gestione dei pannelli della libreria
<a name="v10-dash-manage-library-panels"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

**Per creare un pannello della libreria**

1. Apri il pannello che desideri convertire in un pannello della libreria in modalità di modifica.

1. Nelle opzioni di visualizzazione del pannello, fate clic sull'opzione freccia rivolta verso il basso per avviare le modifiche alla visualizzazione.

1. Seleziona **i pannelli Libreria**, quindi **\$1 Crea pannello Libreria**. Si apre la finestra di dialogo di creazione.

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

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

1. Selezionate il **pannello Crea libreria** per salvare le modifiche apportate alla libreria.

1. Salva la dashboard.

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.

**Puoi anche creare un pannello della libreria direttamente dal menu di modifica di qualsiasi pannello, selezionando Altro...** quindi **Crea pannello libreria**.

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

**Per aggiungere un pannello della libreria a una dashboard**

1. Seleziona **Dashboard** nel menu a sinistra.

1. Seleziona **Nuovo**, quindi scegli **Nuova dashboard** dal menu a discesa.

1. Nella dashboard vuota, seleziona **\$1 Importa il pannello della libreria**. Vedrai un elenco dei pannelli della tua 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.

**Per scollegare un pannello della libreria**

1. Seleziona **Dashboard** nel menu a sinistra.

1. Seleziona i **pannelli Libreria**.

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

1. Seleziona il pannello che desideri scollegare.

1. Seleziona il titolo del pannello (o posiziona il puntatore del mouse in un punto qualsiasi del pannello) per visualizzare il menu delle azioni nell'angolo superiore destro del pannello.

1. Seleziona **Edit (Modifica)**. Il pannello si aprirà in modalità di modifica.

1. Seleziona **Scollega** nell'angolo in alto a destra della pagina.

1. Scegli **Sì, scollega**.

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

È possibile visualizzare un elenco dei pannelli della libreria disponibili e cercare un pannello della libreria.

**Per visualizzare un elenco dei pannelli della libreria**

1. Seleziona **Dashboard** nel menu a sinistra.

1. Seleziona i **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ù.

**Per eliminare un pannello della libreria**

1. Seleziona **Dashboard** nel menu a sinistra.

1. Seleziona i **pannelli Libreria**.

1. Selezionate l'icona di eliminazione accanto al nome del pannello della libreria per il pannello che desiderate eliminare.

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 da non perdere le versioni precedenti della dashboard. Un elenco di queste versioni è disponibile accedendo alle impostazioni della dashboard e selezionando **Versioni** nel menu a sinistra.

**Nota**  
Vengono salvate le 20 versioni più recenti di una dashboard.

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. Viene visualizzata la visualizzazione delle differenze tra le versioni. 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 facendo clic sul pulsante **Visualizza JSON Diff** in basso.

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

Se devi ripristinare una versione della dashboard salvata in precedenza, puoi selezionare il pulsante **Ripristina** a destra di una riga nell'elenco delle versioni della dashboard oppure selezionare il** <x>pulsante **Ripristina alla versione** nella vista delle differenze. Selezionando una di queste opzioni ti verrà richiesto 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. Ciò garantisce che le versioni precedenti della dashboard non siano influenzate dalla modifica.

# Gestione dei collegamenti alla dashboard
<a name="v10-dash-manage-dashboard-links"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 un 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.

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.

**Per aggiungere un link a una dashboard**

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. Seleziona **Collegamenti**, quindi **Aggiungi link alla dashboard** o **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 ti colleghi a molte dashboard, per impostazione predefinita, Grafana le visualizza side-by-side tutte nella parte superiore della dashboard. Selezionando questa opzione e aggiungendo un titolo opzionale, i link verranno visualizzati in un menu a discesa.
   + **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 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](v10-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.

**Per aggiungere un collegamento URL a una dashboard**

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

1. Seleziona **Collegamenti**, quindi **Aggiungi link alla dashboard** o **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.
   + **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` — Definire 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 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. Selezionare **Aggiungi**.

**Aggiornamento di un link alla dashboard**

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

**Per aggiornare un link alla dashboard**

1. Nelle **impostazioni della dashboard,** nella scheda **Collegamenti**, seleziona il link esistente che desideri modificare.

1. Modifica le impostazioni, quindi scegli **Aggiorna**.

**Duplicazione di un link alla dashboard**

Per duplicare un link esistente alla dashboard, seleziona l'icona di duplicazione accanto al link esistente che desideri duplicare.

**Eliminazione di un link alla dashboard**

Per eliminare un link esistente alla dashboard, seleziona l'icona del cestino accanto al link 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 vedere i link disponibili ai pannelli, seleziona l'icona a destra del titolo del 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. Posiziona il cursore sul pannello a cui desideri aggiungere un link.

  1. Seleziona il menu e scegli **Modifica** oppure puoi usare la scorciatoia da tastiera. `e`

  1. Espandi la sezione **delle opzioni del pannello** e scorri verso il basso fino a **Collegamenti del pannello**.

  1. Seleziona **Aggiungi link**.

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

  1. Inserisci l'**URL** a cui desideri collegarti. Premi `Ctrl+Space` (o`Cmd+Space`) e seleziona il 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. Seleziona un pannello (o posiziona il cursore sul pannello) per visualizzare un menu delle azioni in alto a destra del pannello.

  1. Dal menu, seleziona **Modifica**.

     Puoi anche usare la scorciatoia da tastiera,`e`.

  1. Espandi la sezione **delle opzioni del pannello** e scorri verso il basso fino a **Collegamenti del pannello**.

  1. Trova il link che desideri modificare e seleziona l'icona **Modifica** (matita) accanto ad esso.

  1. Apporta le modifiche necessarie:

  1. Seleziona **Salva** per salvare le modifiche e chiudere la finestra.

  1. Salva le modifiche alla dashboard selezionando **Salva** in alto a destra.
+ **Eliminazione di un collegamento al pannello**

  1. Seleziona un pannello (o posiziona il cursore sul pannello) per visualizzare un menu delle azioni in alto a destra del pannello.

  1. Dal menu, seleziona **Modifica**.

     Puoi anche usare la scorciatoia da tastiera,`e`.

  1. Espandi la sezione **delle opzioni del pannello** e scorri verso il basso fino a **Collegamenti del pannello**.

  1. Trova il link che desideri eliminare e seleziona l'icona **X** accanto ad esso.

  1. Seleziona **Salva** in alto a destra per salvare le modifiche alla dashboard.

# Annota le visualizzazioni
<a name="v10-dash-annotations"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 consentono di contrassegnare punti su una visualizzazione con eventi complessi. Vengono visualizzate come linee verticali e icone su tutti i pannelli grafici. 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.

È possibile annotare le visualizzazioni in tre modi:
+ Direttamente nel pannello, utilizzando la query di annotazioni [integrata](#v10-dash-built-in-query).
+ Utilizzando l'API HTTP Grafana.
+ Configurazione delle interrogazioni di annotazione nelle impostazioni della dashboard.

Nei primi due casi, stai creando nuove annotazioni, mentre nell'ultimo stai interrogando le annotazioni esistenti provenienti da fonti di dati. Anche la query di annotazione integrata supporta questa funzionalità.

Questa sezione spiega la prima e la terza opzione; per informazioni sull'utilizzo dell'API HTTP Grafana, fare riferimento a. [API per le annotazioni](Grafana-API-Annotations.md)

Le annotazioni sono supportate per i seguenti tipi di visualizzazione:
+ Serie temporali 
+ Cronologia dello stato
+ Candelabro

## Crea annotazioni nei pannelli
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana offre la possibilità di aggiungere eventi di annotazione direttamente da un pannello utilizzando la [query di annotazioni integrata](#v10-dash-built-in-query) presente in tutte le dashboard. Le annotazioni create in questo modo vengono archiviate in Grafana.

Per aggiungere annotazioni direttamente nel pannello:
+ La dashboard deve essere già stata salvata.
+ La query integrata deve essere abilitata.

**Per aggiungere un'annotazione**

1. Nella dashboard, seleziona il pannello a cui stai aggiungendo l'annotazione. Apparirà un menu contestuale. 

1. Nel menu contestuale, seleziona **Aggiungi annotazione.**

1. (Facoltativo) Aggiungi una descrizione e dei tag dell'annotazione.

1. Seleziona **Salva**.

In alternativa, per aggiungere un'annotazione, premi `Ctrl` (o`Cmd`) mentre selezioni il pannello e verrà visualizzato il **popover Aggiungi annotazione**.

**Annotazioni regionali**

Puoi anche creare annotazioni che coprono un'area o un periodo di tempo in una visualizzazione.

**Per aggiungere un'annotazione regionale**

1. Nella dashboard, premete `Ctrl` (o`Cmd`) mentre selezionate un'area del pannello.

1.  Aggiungi una descrizione dell'annotazione e dei tag (opzionale). 

1.  Fai clic su **Salva**. 

**Per modificare un'annotazione**

1. Nella dashboard, posiziona il mouse su un indicatore di annotazione su un pannello.

1. Seleziona l'icona **Modifica** (matita) nel tooltip di annotazione.

1. Modifica i tag descrittivi and/or .

1. Seleziona **Salva**.

**Per eliminare un'annotazione**

1. Nella dashboard, posiziona il mouse su un indicatore di annotazione su un pannello.

1. Seleziona l'icona **Elimina** (cestino) nel tooltip di annotazione.

## Recupera le annotazioni tramite le impostazioni della dashboard
<a name="v10-dash-fetch-annotations"></a>

Nelle impostazioni della dashboard, in **Annotazioni**, puoi aggiungere nuove query per recuperare le annotazioni utilizzando qualsiasi fonte di dati, inclusa la fonte di dati di annotazione dati integrata. Le query di annotazione restituiscono eventi che possono essere visualizzati come marcatori di eventi nei grafici della dashboard. 

**Per aggiungere una nuova interrogazione di annotazione**

1. Seleziona l'icona **Impostazioni** (ingranaggio) nell'intestazione della dashboard per aprire il menu delle impostazioni.

1. Seleziona **Annotazioni**.

1. Fai clic su **Aggiungi interrogazione di annotazione.**

1. Immettete un nome per la query di annotazione.

   Questo nome viene assegnato all'interruttore (casella di controllo) che consente di abilitare la visualizzazione degli eventi di annotazione derivanti da questa query. 

1. Seleziona la fonte di dati per le annotazioni.

   Puoi anche scegliere **Open advanced data source picker** per visualizzare altre opzioni, inclusa l'aggiunta di una nuova origine dati (disponibile solo per gli amministratori).

1. **Se non desideri utilizzare subito la query di annotazione, deseleziona la casella di controllo Abilitato.**

1. **Se non desideri che l'interruttore della query di annotazione venga visualizzato nella dashboard, seleziona la casella di controllo Nascosto.**

1. Seleziona un colore per i marker degli eventi.

1. Nel menu **a discesa Mostra in**, scegli una delle seguenti opzioni:
   + **Tutti i pannelli**: le annotazioni vengono visualizzate su tutti i pannelli che supportano le annotazioni.
   + **Pannelli selezionati**: le annotazioni vengono visualizzate su tutti i pannelli selezionati.
   + **Tutti i pannelli tranne**: le annotazioni vengono visualizzate su tutti i pannelli tranne quelli selezionati.

1. Configura l'interrogazione.

   Le opzioni di interrogazione delle annotazioni sono diverse per ogni fonte di dati. Per informazioni sulle annotazioni in una fonte di dati specifica, consulta. [Connessione alle origini dati](AMG-data-sources.md)

## Interrogazione integrata
<a name="v10-dash-built-in-query"></a>

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, che sono archiviati in Grafana, e li mostrerà nel pannello in cui sono stati creati. Ciò include le annotazioni della cronologia dello stato di avviso.

Per impostazione predefinita, la query di annotazione integrata utilizza l'origine dati `Grafana` speciale e le annotazioni manuali sono supportate solo utilizzando questa fonte di dati. È possibile utilizzare un'altra origine dati nella query di annotazione incorporata, ma sarà possibile creare annotazioni automatiche solo utilizzando l'editor di query per tale origine dati.

Per aggiungere annotazioni direttamente alla dashboard, questa query deve essere abilitata.

**Per confermare che la query integrata è abilitata**

1. Seleziona l'icona **delle impostazioni** della dashboard (ingranaggio) nell'intestazione della dashboard per aprire il menu delle impostazioni della dashboard.

1. Seleziona **Annotazioni**. 

1. Trova la query **Annotazioni e avvisi (integrata)**.

   Se mostra **Disabilitato** prima del nome della query, dovrai selezionare il nome della query per aprirla e aggiornare l'impostazione.

**Per impedire che le annotazioni vengano recuperate e disegnate**

1. Seleziona l'icona **delle impostazioni** della dashboard (ingranaggio) nell'intestazione della dashboard per aprire il menu delle impostazioni della dashboard.

1. Seleziona **Annotazioni**. 

1. Seleziona la query **Annotazioni e avvisi (integrata)**.

1. Seleziona l'interruttore **Abilitato** per disattivarlo.

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. Tuttavia, questo funziona solo se le annotazioni nella dashboard di origine avevano tag in base ai quali filtrare.

**Filtraggio delle query per tag**

**È possibile creare nuove query per recuperare le annotazioni dalla query di annotazione incorporata utilizzando l'origine `Grafana` dati impostando Filter by to.** `Tags`

Ad esempio, create il nome `outages` di una query di annotazione e specificate un tag. `outage` Questa query mostrerà tutte le annotazioni (da qualsiasi dashboard o tramite API) con il `outage` tag. 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, **abilita Match any** e Grafana mostrerà le annotazioni che contengono uno qualsiasi dei tag che hai fornito.

 Puoi anche utilizzare le variabili del modello nella query dei tag. Ciò significa che se disponi di una dashboard che mostra le statistiche per diversi servizi e di una variabile modello che determina quali servizi mostrare, puoi utilizzare la stessa variabile modello nella tua query di annotazione per mostrare solo le annotazioni per quei servizi. 

# Modello JSON del pannello di controllo
<a name="v10-dash-dashboard-json-model"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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, seleziona l'icona delle **impostazioni della dashboard** (a forma di ingranaggio).

1. Seleziona il **modello JSON**.

## Campi JSON
<a name="v10-dash-json-fields"></a>

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": [],
  "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) | 
| `title` | titolo attuale del pannello di controllo | 
| `tags` | tag associati alla dashboard, una serie di stringhe | 
| `style` | tema del pannello di controllo, ad esempio o `dark` `light` | 
| `timezone` | fuso orario del pannello di controllo, ad esempio o `utc` `browser` | 
| `editable` | 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 o `last 6 hours` `last 7 days` | 
| `timepicker` | metadati timepicker, consulta la sezione [timepicker](#v10-dash-json-panels) per i dettagli | 
| `templating` | [metadati basati sui modelli, consulta la sezione relativa ai modelli per i dettagli](#v10-dash-json-panels) | 
| `annotations` | [metadati delle annotazioni, vedi le annotazioni per sapere come aggiungerli](v10-dash-annotations.md) | 
| `refresh` | intervallo di aggiornamento automatico | 
| `schemaVersion` | versione dello schema JSON (numero intero), incrementata ogni volta che un aggiornamento Grafana apporta modifiche a questo schema | 
| `version` | versione della dashboard (numero intero), incrementata ogni volta che la dashboard viene aggiornata | 
| `panels` | array di pannelli (vedi la sezione successiva per i dettagli) | 

## Riquadri
<a name="v10-dash-json-panels"></a>

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`— da 1 a 24 (la larghezza del pannello di controllo è suddivisa 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, nella stessa unità di`h`.

La griglia ha una gravità negativa che si sposta verso l'alto dei pannelli 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"
      }
    ]
  }
```

La tabella seguente descrive l'utilizzo dei campi di modello.


| Name | Utilizzo | 
| --- | --- | 
|  `enable`  |  se il template è abilitato o meno  | 
|  `list`  |  una matrice di oggetti, ciascuno dei quali rappresenta una variabile di modello  | 
|  `allFormat`  |  formato da utilizzare durante il recupero di tutti i valori dalla fonte di dati, tra cui`wildcard`, `glob``regex`,`pipe`.  | 
|  `current`  |  mostra la variabile attualmente selezionata text/value sulla dashboard  | 
|  `datasource`  |  mostra la fonte di dati per le variabili  | 
|  `includeAll`  |  se tutte le opzioni di valore sono disponibili o meno  | 
|  `multi`  |  se è possibile selezionare o meno più valori dalla lista di valori variabili  | 
|  `multiFormat`  |  formato da usare durante il recupero delle serie temporali dalla fonte di dati  | 
|  `name`  |  nome della variabile  | 
|  `options`  |  matrice di text/value coppie di variabili disponibili per la selezione sulla dashboard  | 
|  `query`  |  query sull'origine dei dati utilizzata per recuperare i valori di una variabile  | 
|  `refresh`  |  configura quando aggiornare una variabile  | 
|  `regex`  |  estrae parte del nome di una serie o di un segmento di nodo metrico  | 
|  `type`  |  tipo di variabile`custom`, o `query` `interval`  | 

# Procedure consigliate per i dashboard
<a name="v10-dash-bestpractices"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 sulle migliori pratiche per gli amministratori e gli utenti di Grafana su come creare e gestire i dashboard Grafana.

Per informazioni sui diversi tipi di dashboard che puoi creare, consulta le dashboard [Grafana: una guida completa a tutti i diversi tipi di dashboard che puoi](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) creare post sul sito Web di Grafana Labs.

**Nota**  
Questa sezione può aiutarti a creare una strategia per il monitoraggio e la manutenzione del pannello di controllo. Conoscete meglio i vostri sistemi e dovreste usare questa sezione per guidarvi nella comprensione. In definitiva, è tua responsabilità creare la strategia migliore per il tuo sistema.

## Strategie comuni di osservabilità
<a name="v10-dash-common-observability-strategies"></a>

Quando hai molte cose da monitorare, come una server farm, hai bisogno di una strategia per decidere cosa è abbastanza importante da monitorare. Questa pagina descrive diversi metodi comuni per scegliere cosa monitorare.

Una strategia logica consente di creare dashboard uniformi e scalare più facilmente la piattaforma di osservabilità.

**Linee guida per le strategie**
+ Il metodo USE ti dice quanto sono felici le tue macchine, il metodo RED ti dice quanto sono felici i tuoi utenti.
+ USE riporta le cause dei problemi.
+ RED riporta l'esperienza dell'utente ed è più probabile che riporti i sintomi dei problemi.
+ Il monitoraggio di entrambi è importante per comprendere il sistema. È buona norma prestare attenzione ai sintomi anziché alle cause. In genere, gli avvisi sono configurati sui dashboard RED.

**Metodo USE**

USE sta per:
+ **Utilizzo**: percentuale di tempo in cui la risorsa è occupata, ad esempio l'utilizzo della CPU del nodo.
+ **Saturazione**: quantità di lavoro che una risorsa deve svolgere, spesso la lunghezza della coda o il carico dei nodi.
+ **Errori**: conteggio degli eventi di errore.

Questo metodo è ideale per le risorse hardware dell'infrastruttura, come CPU, memoria e dispositivi di rete. [Per ulteriori informazioni, consulta il post sul blog di Brendan Gregg The USE Method.](http://www.brendangregg.com/usemethod.html)

**Metodo RED**

RED sta per:
+ **Velocità**: richieste al secondo
+ **Errori**: numero di richieste non riuscite.
+ **Durata**: quantità di tempo impiegata da queste richieste, distribuzione delle misurazioni della latenza.

Questo metodo è più applicabile ai servizi, in particolare a un ambiente di microservizi. Per ciascuno dei tuoi servizi, utilizza il codice per esporre queste metriche per ogni componente. I dashboard RED sono utili per avvisare e. SLAs Una dashboard RED ben progettata funge da proxy per l'esperienza utente.

Per ulteriori informazioni, consulta il post sul blog di Tom Wilkie [The RED method: How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**I quattro segnali dorati**

Secondo il [manuale di Google SRE](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), se riesci a misurare solo quattro metriche del tuo sistema rivolto agli utenti, concentrati su queste quattro.

Questo metodo è simile al metodo RED, ma include la saturazione.
+ **Latenza**: tempo impiegato per soddisfare una richiesta.
+ **Traffico**: quanta richiesta viene immessa nel sistema.
+ **Errori**: percentuale di richieste non riuscite.
+ **Saturazione**: quanto è «pieno» il sistema,

## Modello di maturità per la gestione delle dashboard
<a name="v10-dash-management-maturity-model"></a>

*La maturità della gestione delle dashboard* si riferisce a quanto sia ben progettato ed efficiente il tuo ecosistema di dashboard. Ti consigliamo di rivedere periodicamente la configurazione della dashboard per valutare a che punto sei e come puoi migliorare.

In generale, la maturità della dashboard può essere definita come bassa, media o alta. 

 Gran parte del contenuto di questo argomento è stato tratto dal talk [Fool-Proof Kubernetes Dashboards for Sleep-Deprived](https://www.youtube.com/watch?v=YE2aQFiMGfY) Oncalls del KubeCon 2019. 

**Basso: stato predefinito**

In questa fase, non è disponibile una strategia di gestione del pannello di controllo coerente. Quasi tutti iniziano da qui.

Come fai a sapere che sei qui?
+ Tutti possono modificare le tue dashboard.
+ Molte dashboard copiate, riutilizzo minimo o nullo delle dashboard.
+ Dashboard uniche che durano per sempre.
+ Nessun controllo della versione (dashboard JSON nel controllo della versione).
+ Naviga molto alla ricerca di dashboard, cerca la dashboard giusta. Ciò significa perdere molto tempo a cercare la dashboard di cui hai bisogno.
+ Non hai avvisi che ti indirizzino alla dashboard giusta.

**Dashboard metodici di medie dimensioni**

In questa fase, stai iniziando a gestire l'uso della dashboard con dashboard metodiche. Potresti aver definito una strategia, ma ci sono alcune cose che potresti migliorare.

 Come fai a sapere che sei qui? 
+ Previeni l'espansione incontrollata utilizzando le variabili del modello. Ad esempio, non è necessaria una dashboard separata per ogni nodo, è possibile utilizzare variabili di query. Ancora meglio, puoi trasformare l'origine dei dati anche in una variabile modello, in modo da poter riutilizzare la stessa dashboard su diversi cluster e backend di monitoraggio.

  Per idee, consulta l'elenco degli esempi in[Variabili](v10-dash-variables.md),.
+ Dashboard metodici secondo una strategia di [osservabilità](#v10-dash-common-observability-strategies).
+ Dashboard gerarchici con approfondimenti al livello successivo.
+ Il design del pannello di controllo riflette le gerarchie dei servizi. Ad esempio, è possibile utilizzare il metodo RED con una riga per servizio. L'ordine delle righe potrebbe riflettere il flusso di dati, mentre scorri verso il basso la dashboard.
+ Confronta i like con i like: dividi le dashboard dei servizi quando la grandezza è diversa. Assicurati che le metriche aggregate non offuschino informazioni importanti.
+ Grafici espressivi con un uso significativo del colore e degli assi di normalizzazione, ove possibile.
  + Esempio di colore significativo: il blu significa che è buono, il rosso significa che è cattivo. [Le soglie](v10-panels-configure-thresholds.md) possono aiutare in questo senso.
  + Esempio di normalizzazione degli assi: quando confronti l'utilizzo della CPU, misura in percentuale anziché in numero grezzo, poiché le macchine possono avere un numero diverso di core. La normalizzazione dell'utilizzo della CPU in base al numero di core riduce il carico cognitivo perché lo spettatore può fidarsi che tutti i core vengano utilizzati al 100%, senza dover conoscerne il numero. CPUs
+ La navigazione diretta riduce le ipotesi.
  + Le variabili del modello rendono più difficile la navigazione in modo casuale o senza meta.
  + La maggior parte delle dashboard dovrebbe essere collegata tramite avvisi.
  + La navigazione è diretta tramite link. Per ulteriori informazioni, consulta [Gestione dei collegamenti alla dashboard](v10-dash-manage-dashboard-links.md).
+  Dashboard JSON con controllo della versione. 

**Utilizzo altamente ottimizzato**

In questa fase, hai ottimizzato l'uso della gestione della dashboard con una strategia coerente e ponderata. Richiede manutenzione, ma i risultati ne valgono la pena.
+ Ridurre attivamente l'espansione incontrollata.
  + Esamina regolarmente le dashboard esistenti per assicurarti che siano ancora pertinenti.
  + Solo i dashboard approvati sono stati aggiunti all'elenco dei dashboard principali.
  + Monitoraggio dell'utilizzo della dashboard. Puoi sfruttare le [informazioni sull'utilizzo](v10-dash-assess-dashboard-usage.md).
+ Coerenza fin dalla progettazione.
+ Utilizza le librerie di script per generare dashboard e garantire la coerenza nel modello e nello stile.
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ Nessuna modifica nel browser. I visualizzatori della dashboard modificano le visualizzazioni con variabili.
+ La ricerca di dashboard è l'eccezione, non la regola.
+ Esegui sperimentazioni e test in un'istanza Grafana separata dedicata a tale scopo, non in un'istanza di produzione. Quando una dashboard nell'ambiente di test si dimostra utile, aggiungi quella dashboard all'istanza principale di Grafana.

## Le migliori pratiche per la creazione di dashboard
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

Questa sezione descrive alcune best practice da seguire per la creazione di dashboard Grafana.

**Prima di iniziare**

 Ecco alcuni principi da considerare prima di creare una dashboard. 

**Una dashboard dovrebbe raccontare una storia o rispondere a una domanda**

Che storia stai cercando di raccontare con la tua dashboard? Prova a creare una progressione logica dei dati, ad esempio da grandi a piccoli o da generali a specifici. Qual è l'obiettivo di questa dashboard? (Suggerimento: se la dashboard non ha un obiettivo, chiediti se ne hai davvero bisogno.)

Mantieni i tuoi grafici semplici e concentrati sulla risposta alla domanda che ti stai ponendo. Ad esempio, se la tua domanda è «quali server sono in difficoltà?» , allora forse non è necessario mostrare tutti i dati del server. Basta mostrare i dati per chi è in difficoltà.

**Le dashboard dovrebbero ridurre il carico cognitivo, non aumentarlo**

Il *carico cognitivo* è fondamentalmente la difficoltà con cui devi pensare a qualcosa per capirlo. Rendi la tua dashboard facile da interpretare. Gli altri utenti e voi future (quando starete cercando di capire cosa si è rotto alle 2 del mattino) lo apprezzerete.

 Chiediti: 
+ Posso dire cosa rappresenta esattamente ogni grafico? È ovvio o devo pensarci?
+ Se lo mostro a qualcun altro, quanto tempo impiegheranno a capirlo? Si perderanno?

**Avere una strategia di monitoraggio**

È facile creare nuove dashboard. È più difficile ottimizzare la creazione di dashboard e rispettare un piano, ma ne vale la pena. Questa strategia dovrebbe governare sia lo schema generale del dashboard che imporre la coerenza nella progettazione delle singole dashboard.

Per ulteriori informazioni, consulta [le strategie comuni di osservabilità](#v10-dash-common-observability-strategies) e i [livelli di maturità della gestione dei dashboard](#v10-dash-management-maturity-model).

**Scrivilo**

Una volta che hai una strategia o delle linee guida di progettazione, scrivile per mantenere la coerenza nel tempo.

**Le migliori pratiche da seguire**
+ Quando crei una nuova dashboard, assicurati che abbia un nome significativo.
  + Se stai creando una dashboard per giocare o sperimentare, inserisci la parola `TEST` o `TMP` nel nome.
  + Prendi in considerazione l'idea di includere il tuo nome o le tue iniziali nel nome della dashboard o come tag in modo che le persone sappiano chi è il proprietario della dashboard.
  + Rimuovi i pannelli di controllo temporanei degli esperimenti quando hai finito di usarli.
+ Se crei molte dashboard correlate, pensa a come incrociarle per facilitarne la navigazione. Per ulteriori informazioni, consulta [Best practice per la gestione delle dashboard](#v10-dash-best-practices-for-managing-dashboards), più avanti in questa sezione.
+ Grafana recupera i dati da una fonte di dati. È importante una conoscenza di base delle fonti di dati [Connessione alle origini dati](AMG-data-sources.md) in generale e specifiche.
+ Evita l'aggiornamento non necessario della dashboard per ridurre il carico sulla rete o sul backend. Ad esempio, se i dati cambiano ogni ora, non è necessario impostare la frequenza di aggiornamento della dashboard su 30 secondi.
+ Usa gli assi Y sinistro e destro per visualizzare serie temporali con unità o intervalli diversi.
+ Aggiungi documentazione a dashboard e pannelli.
  + Per aggiungere documentazione a una dashboard, aggiungi una [visualizzazione del pannello di testo](v10-panels-text.md) alla dashboard. Registra elementi come lo scopo della dashboard, i link alle risorse utili e tutte le istruzioni di cui gli utenti potrebbero aver bisogno per interagire con la dashboard.
  + Per aggiungere documentazione a un pannello, modifica le impostazioni del pannello e aggiungi una descrizione. Qualsiasi testo che aggiungi verrà visualizzato se posizioni il cursore sul piccolo angolo `i` in alto a sinistra del pannello.
+ [Riutilizza le dashboard e rafforza la coerenza utilizzando modelli e variabili.](v10-dash-variables.md)
+ Fai attenzione a impilare i dati dei grafici. Le visualizzazioni possono essere fuorvianti e nascondere dati importanti. Si consiglia di disattivarlo nella maggior parte dei casi.

## Le migliori pratiche per la gestione delle dashboard
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 Questa pagina descrive alcune best practice da seguire per la gestione delle dashboard Grafana. 

**Prima di iniziare**

Ecco alcuni principi da considerare prima di iniziare a gestire le dashboard.

**Osservabilità strategica**

Esistono diverse strategie di [osservabilità comuni](#v10-dash-common-observability-strategies). Dovresti ricercarli e decidere se uno di essi funziona per te o se vuoi inventarne uno tuo. Ad ogni modo, prepara un piano, scrivilo e seguilo.

Adatta la tua strategia alle mutevoli esigenze, se necessario.

**Livello di maturità**

Qual è il livello di maturità della tua dashboard? Analizza la configurazione attuale della dashboard e confrontala con il modello di [maturità della gestione della dashboard](#v10-dash-management-maturity-model). Capire dove ti trovi può aiutarti a decidere come arrivare dove vuoi essere.

**Le migliori pratiche da seguire**
+ Evita la proliferazione incontrollata delle dashboard, ovvero la crescita incontrollata delle dashboard. L'espansione incontrollata delle dashboard influisce negativamente sul tempo necessario per trovare la dashboard giusta. Duplicare le dashboard e modificare «una cosa» (peggio ancora: mantenere i tag originali) è il tipo di espansione incontrollata più semplice.
  + Esamina periodicamente le dashboard e rimuovi quelle non necessarie.
  + Se crei una dashboard temporanea, magari per testare qualcosa, inserisci come prefisso il nome. `TEST:` Elimina la dashboard quando hai finito.
+ Copiare i dashboard senza modifiche significative non è una buona idea.
  + Ti perdi gli aggiornamenti alla dashboard originale, come le modifiche alla documentazione, le correzioni di bug o le aggiunte alle metriche.
  + In molti casi vengono create delle copie per personalizzare semplicemente la visualizzazione impostando i parametri del modello. Ciò dovrebbe invece essere fatto mantenendo un collegamento alla dashboard principale e personalizzando la visualizzazione con [i parametri URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables).
+ Quando devi copiare una dashboard, rinominala chiaramente e *non* copiare i tag della dashboard. I tag sono metadati importanti per i dashboard utilizzati durante la ricerca. La copia dei tag può generare false corrispondenze.
+ Gestisci una dashboard composta da dashboard o dashboard con riferimenti incrociati. Questa operazione può essere eseguita in diversi modi: 
  + Crea collegamenti alla dashboard, ai pannelli o ai dati. I link possono andare ad altre dashboard o a sistemi esterni. Per ulteriori informazioni, consulta [Gestire i collegamenti alla dashboard](v10-dash-manage-dashboard-links.md).
  +  Aggiungi un [pannello con l'elenco della dashboard](v10-panels-dashboard-list.md). Puoi quindi personalizzare ciò che vedi effettuando ricerche per tag o cartelle.
  + Aggiungi un [pannello di testo](v10-panels-dashboard-list.md) e usa markdown per personalizzare la visualizzazione. 

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Nella pagina **Dashboard** del tuo spazio di lavoro (disponibile selezionando **Dashboard** dal menu a sinistra), puoi eseguire attività di gestione delle dashboard, inclusa l'organizzazione delle dashboard in cartelle.

Per ulteriori informazioni sulla creazione di dashboard, consulta. [Creazione di dashboard](v10-dash-building-dashboards.md)

## Sfoglia i pannelli di controllo
<a name="v10-dash-browse-dashboards"></a>

Nella pagina **Dashboard**, puoi sfogliare e gestire cartelle e dashboard. Ciò include opzioni per:
+ Crea cartelle e dashboard.
+ Sposta i dashboard tra le cartelle.
+ Elimina più dashboard e cartelle.
+ Accedere a una cartella.
+ Gestisci le autorizzazioni delle cartelle. Per ulteriori informazioni, consulta [Autorizzazioni per dashboard e cartelle](dashboard-and-folder-permissions.md).

## Creazione di cartelle della dashboard
<a name="v10-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. Le sottocartelle consentono di creare una gerarchia annidata nell'organizzazione del dashboard.

**Prerequisiti**

Assicurati di disporre delle autorizzazioni di amministratore Grafana. Per ulteriori informazioni sulle autorizzazioni della dashboard, consulta. [Autorizzazioni per dashboard e cartelle](dashboard-and-folder-permissions.md)

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

1. Accedi a Grafana. 

1. Nel menu a sinistra, seleziona **Dashboard**.

1. Nella pagina **Dashboard**, seleziona **Nuovo**, quindi scegli **Nuova cartella** nel menu a discesa.

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.

**Per modificare il nome di una cartella**

1. Seleziona **Dashboard** nel menu a sinistra.

1. Seleziona la cartella da rinominare

1. Seleziona l'icona **Modifica titolo** (matita) nell'intestazione e aggiorna il nome della cartella.

   Il nuovo nome della cartella viene salvato automaticamente.

**Autorizzazioni per le cartelle**

È possibile assegnare autorizzazioni a una cartella. La dashboard nella cartella eredita tutte le autorizzazioni che hai assegnato alla cartella. Puoi assegnare le autorizzazioni ai ruoli, ai team e agli utenti dell'organizzazione.

**Per modificare le autorizzazioni per una cartella**

1. Seleziona **Dashboard** dal menu a sinistra.

1. Seleziona la cartella nell'elenco.

1. Nella pagina dei dettagli della cartella, seleziona **Azioni cartella** e seleziona **Gestisci le autorizzazioni** nell'elenco a discesa.

1. Aggiorna le autorizzazioni come desideri.

Le modifiche vengono salvate automaticamente.

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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.

**Per accedere a una playlist**

1. Seleziona **Playlist** dal menu a sinistra.

1. Scegli una playlist dall'elenco delle 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.

**Per iniziare una playlist**

1. Accedi alla pagina delle 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**<playlist name>.

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.


| Modalità | Description | 
| --- | --- | 
| Modalità normale |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| modalità TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-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/v10-dash-managing-playlists.html)  | 
| modalità Kiosk |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-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/v10-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="v10-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.

**Per creare una playlist**

1. Seleziona **Dashboard** dal menu a sinistra.

1. Seleziona **Playlist** nella pagina della playlist.

1. Seleziona **Nuova playlist**.

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

1. Immettete un intervallo di tempo nella casella di testo **Intervallo.** 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 delle 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. Seleziona **Salva** per salvare le modifiche.

## Salvare una playlist
<a name="v10-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.

**Per salvare una playlist**

1. Seleziona **Dashboard** nel menu a sinistra.

1. Seleziona **Playlist** per visualizzare le playlist a tua disposizione.

1. Scegli la playlist che preferisci.

1. Modifica la playlist.

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

1. Seleziona **Salva** per salvare le modifiche.

## Modifica o eliminazione di una playlist
<a name="v10-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, oppure puoi eliminare la playlist.

**Per modificare una playlist**

1. Seleziona **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. Seleziona **Salva** per salvare le modifiche.

**Per eliminare una playlist**

1. Seleziona **Playlist**.

1. Seleziona **Rimuovi** accanto alla playlist che desideri eliminare.

**Per riorganizzare l'ordine della dashboard in una playlist**

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

1. Seleziona **Salva** per salvare le modifiche.

**Per rimuovere un pannello di controllo**

1. Seleziona **Rimuovi** per rimuovere una dashboard dalla playlist.

1. Seleziona **Salva** per salvare le modifiche.

## Condivisione di una playlist in modalità visualizzazione
<a name="v10-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.

**Per condividere una playlist in modalità di visualizzazione**

1. Dal menu a **sinistra del pannello** di controllo, scegli **Playlist**.

1. Seleziona **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. Seleziona **Copia l'indirizzo del link** per copiare l'URL negli appunti.

1. Incolla l'URL nella tua destinazione.

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

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 un pannello di controllo
<a name="v10-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.

**Per condividere una dashboard**

1. Seleziona **Dashboard** dal menu a sinistra nel tuo spazio di lavoro.

1. Scegli la dashboard che desideri condividere.

1. Seleziona l'icona di condivisione nella parte superiore dello schermo.

   La finestra di dialogo di condivisione si apre e mostra 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.

**Per condividere un link diretto**

1. Seleziona **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.

**Per pubblicare un'istantanea**

1. Seleziona la scheda **Istantanea.**

1. Seleziona l'**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 un pannello di controllo**

Le dashboard Grafana possono essere facilmente esportate e importate. Per ulteriori informazioni, consulta le sezioni di importazione ed esportazione in. [Creazione di dashboard](v10-dash-building-dashboards.md)

## Condivisione di un pannello
<a name="v10-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.

**Per condividere un pannello**

1. Seleziona il titolo del pannello che desideri condividere. Si apre il menu del pannello.

1. Seleziona **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.

**Per utilizzare un link diretto**

1. Seleziona **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.

**Pubblicazione di un'istantanea di un pannello**

Un'istantanea di un pannello è una condivisione pubblica di 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.

**Per pubblicare un'istantanea di un pannello**

1. Nella finestra di dialogo **Share Panel**, selezionate la scheda **Istantanea.**

1. Selezionate **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**.

**Per creare un pannello della libreria**

1. Seleziona il **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, viene selezionata la cartella principale.

1. Seleziona il **pannello Crea libreria** per salvare le modifiche.

1. Salva la dashboard.

# Variabili
<a name="v10-dash-variables"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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).
+ Per impostazione predefinita, le variabili preselezionano il valore più alto nell'elenco a discesa. Se invece desideri scegliere un valore vuoto, modifica le impostazioni della variabile come segue:

  1. Seleziona la casella di controllo **Includi tutte le opzioni**.

  1. Nel campo **Personalizza tutti i valori**, inserisci il valore`+`.

**Topics**
+ [Aggiungere e gestire variabili](v10-dash-variable-add.md)
+ [Ispeziona variabili](v10-dash-variable-add-inspect.md)
+ [Sintassi variabile](v10-dash-variable-syntax.md)

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 in 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. | 
| Personalizzato | Definite manualmente le opzioni delle variabili utilizzando un elenco separato da virgole. | 
| Text box (Casella di testo) | Visualizza un campo di immissione di testo libero con un valore predefinito opzionale. | 
| Costante | Definire una costante nascosta. | 
| Origine dati | Cambia rapidamente la fonte di dati per un intero pannello di controllo. | 
| Interval | Le variabili di intervallo rappresentano intervalli di tempo. | 
| 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). | 
| Variabili globali | Variabili integrate che possono essere utilizzate nelle espressioni dell'editor di query. | 
| Variabili concatenate | Le interrogazioni variabili possono contenere altre variabili. | 

**Topics**
+ [Inserimento delle opzioni generali](#v10-dash-variable-options)
+ [Aggiungere una variabile di interrogazione](#v10-dash-variable-add-query)
+ [Aggiungere una variabile personalizzata](#v10-dash-variable-add-custom)
+ [Aggiungere una variabile alla casella di testo](#v10-dash-variable-add-text)
+ [Aggiungere una variabile costante](#v10-dash-variable-add-constant)
+ [Aggiungere una variabile di origine dati](#v10-dash-variable-add-datasource)
+ [Aggiungere una variabile di intervallo](#v10-dash-variable-add-internal)
+ [Aggiungere filtri ad hoc](#v10-dash-variable-add-adhoc)
+ [Configura le opzioni di selezione delle variabili](#v10-dash-variable-add-selection)
+ [Variabili globali](#v10-dash-variable-add-global)
+ [Variabili concatenate](#v10-dash-variable-add-chained)
+ [Gestisci le variabili](#v10-dash-variable-add-manage)
+ [Filtra le variabili con regex](#v10-dash-variable-add-filter)

## Inserimento delle opzioni generali
<a name="v10-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 **Nuova variabile**.

1. Inserisci 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 elenco a discesa delle variabili.

## Aggiungere una variabile di interrogazione
<a name="v10-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. Immettete 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**: esegue una query sull'origine 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.
   + La query deve restituire valori denominati `__text` e`__value`. Ad esempio, in SQL, è possibile utilizzare una query come`SELECT hostname AS __text, id AS __value from MyTable`. Le interrogazioni per altre lingue varieranno a seconda della sintassi.
   + Se hai bisogno di più spazio in un editor di interrogazioni con un singolo 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](#v10-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](#v10-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="v10-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](#v10-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. Nell'elenco **Valori separati da virgole**, inserisci 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.](#v10-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="v10-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. Usa questo tipo di variabile se hai metriche con cardinalità elevata o se desideri aggiornare più pannelli in una dashboard contemporaneamente.

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

1. Immettete 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="v10-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](v10-dash-variable-syntax.md#v10-dash-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="v10-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.

   Puoi anche scegliere **Apri selettore avanzato di origini dati** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo amministratori). Per ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md).

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](#v10-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="v10-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. Immettete 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="v10-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.

   Puoi anche scegliere **Apri selettore avanzato di origini dati** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo amministratori). Per ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md).

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="v10-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="v10-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, deve essere 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 viene interpolata di. `(host1|host2|host3)` Ogni valore viene 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 è formattata come. `("host1" OR "host2" OR "host3")` In questo caso, ogni valore viene escluso 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 raw](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Opzione Includi tutto
<a name="v10-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="v10-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="v10-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 interrogazioni. 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, ad esempio). `>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**

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

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.

**\$1\$1\$1timezone**

La `$__timezone` variabile restituisce il fuso orario attualmente selezionato `utc` o una voce del database del fuso orario IANA (ad esempio,). `America/New_York`

Se il fuso orario attualmente selezionato è l'*ora del browser*, Grafana proverà a determinare il fuso orario del browser.

## Variabili concatenate
<a name="v10-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.

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 di dashboard e 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 i 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="v10-dash-variable-add-manage"></a>

La pagina delle variabili consente di aggiungere variabili e gestire le variabili esistenti. Consente inoltre di [esaminare](v10-dash-variable-add-inspect.md) 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="v10-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**

Per questo 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
```

Questa espressione regolare:

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

Restituisce questi risultati:

```
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 interroga la 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.

# Ispeziona variabili
<a name="v10-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="v10-dash-variable-syntax"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 sul modo in cui Grafana interpreta i valori. Per ulteriori informazioni, consulta *Opzioni avanzate di formato variabile*, che segue questo elenco.
+ `[[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="v10-dash-assess-dashboard-usage"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 ogni dashboard e fonte di dati, puoi accedere alle informazioni sull'utilizzo.

**Informazioni approfondite sulla dashboard**

Per visualizzare le informazioni sull'utilizzo della **dashboard, seleziona 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).

**Approfondimenti 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. Seleziona **Connessioni** nella navigazione principale del tuo spazio di lavoro.

1. Seleziona **Fonti di dati**.

1. Scegli una fonte di dati.

1. Seleziona la scheda **Insights**.

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

Quando effettui l'accesso 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 riescano a 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="v10-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. Puoi ordinare i dashboard in base a quanto segue.
+ Visualizzazioni
+ Errori
+ Visualizzazioni
+ Ora di creazione
+ Ora aggiornata

# Risoluzione dei problemi relativi ai dashboard
<a name="v10-dash-troubleshoot"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 le seguenti strategie per aiutarti a risolvere i problemi più comuni del pannello di controllo. 

## La dashboard è lenta
<a name="v10-dash-dashboard-is-slow"></a>
+ Stai cercando di eseguire il rendering di 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 il numero di serie restituite.
+ A volte i nomi delle serie possono essere molto grandi. Ciò causa dimensioni di risposta maggiori. Prova `alias` a utilizzare per ridurre la dimensione dei nomi delle serie restituiti.
+ Stai interrogando molte serie temporali o un lungo intervallo di tempo? Entrambe queste condizioni possono far sì che Grafana o la tua fonte di dati raccolgano molti dati, il che potrebbe rallentare il dashboard. Prova a ridurne uno o entrambi.
+ Potrebbe esserci 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
<a name="v10-dash-refresh-rate-issues"></a>

Per impostazione predefinita, Grafana interroga la tua fonte di dati ogni 30 secondi. Tuttavia, l'impostazione di una frequenza di aggiornamento bassa sui dashboard comporta uno stress inutile sul backend. In molti casi, non è necessario interrogarlo frequentemente perché l'origine dati non invia i dati con una frequenza sufficiente per apportare modifiche ogni 30 secondi.

Consigliamo quanto segue:
+ Abilita l'aggiornamento automatico su dashboard, pannelli o variabili solo se necessario. Gli utenti possono aggiornare il browser manualmente.
+ Se hai bisogno dell'aggiornamento automatico, imposta la frequenza di aggiornamento su un periodo di tempo più lungo che abbia senso, ad esempio una volta al minuto, ogni 10 minuti o ogni ora.
+ Controlla l'intervallo di tempo della dashboard. Se la dashboard ha un intervallo di tempo più lungo, ad esempio una settimana, non hai davvero bisogno dell'aggiornamento automatico e dovresti disabilitarlo.

## La gestione o il rendering di dati nulli sono errati o creano confusione
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

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, ma ciò può essere ingannevole.

I grafici con l'opzione **Connect null values** impostata su **Always** collegheranno le righe in cui sono presenti valori mancanti.

Un modo per risolvere questo problema consiste nell'utilizzare le barre anziché le linee e impostare l'opzione **Nessun valore** (in **Opzioni standard**) su. `0` In questo caso, i dati mancanti verranno visualizzati come aree del grafico prive di dati.

# Ricerca nelle dashboard nella versione 10 di Grafana
<a name="v10-search"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 visualizzarne il contenuto.

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

Inserisci qualsiasi parte del nome della dashboard nella barra di ricerca. La ricerca restituisce 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="v10-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="v10-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.

## Palette di comandi
<a name="v10-search-palette"></a>

È possibile utilizzare la palette dei comandi per effettuare le seguenti operazioni:
+ Cerca e apri dashboard e cartelle.
+ Crea dashboard e regole di avviso.
+ Individua le pagine all'interno di Grafana.
+ Cambia il tema in chiaro o scuro.

In alto apri la palette dei comandi, inserisci `ctrl+k` (`cmd+k`in macOS). Puoi anche selezionare l'input di ricerca nella barra di navigazione Grafana.

**Nota**  
Per andare al passaggio precedente, premere `backspace` con la palette dei comandi vuota.

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 nel vostro spazio 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](v10-panels-editor-overview.md)
+ [La vista di ispezione del pannello](v10-panels-panel-inspector.md)
+ [Interroga e trasforma i dati](v10-panels-query-xform.md)
+ [Configura le opzioni del pannello](v10-panels-configure-panel-options.md)
+ [Configurazione delle opzioni standard](v10-panels-configure-standard-options.md)
+ [Configurare una legenda](v10-panels-configure-legend.md)
+ [Configurare i collegamenti dati](v10-panels-configure-data-links.md)
+ [Configurare le mappature dei valori](v10-panels-configure-value-mappings.md)
+ [Configurare le soglie](v10-panels-configure-thresholds.md)
+ [Configura le sostituzioni dei campi](v10-panels-configure-overrides.md)
+ [Visualizzazioni disponibili nella versione 10 di Grafana](v10-panels-viz.md)

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Nell'editor del pannello, puoi aggiornare tutti gli elementi di una visualizzazione, tra cui la fonte di dati, le interrogazioni, l'intervallo di tempo e le opzioni di visualizzazione.

Per aggiungere un pannello a una nuova dashboard, seleziona **\$1 Aggiungi visualizzazione** al centro della dashboard. Per aggiungere un pannello a una dashboard esistente, seleziona **Aggiungi** nell'intestazione della dashboard e seleziona **Visualizzazione** nel menu a discesa. Puoi anche copiare e incollare un pannello esistente dalla stessa dashboard o da una dashboard diversa.

## Menu del pannello
<a name="v10-panels-editor-menu"></a>

Per accedere all'editor dei pannelli, passa il mouse sull'angolo superiore destro di qualsiasi pannello. **Seleziona l'icona del menu del pannello che appare e seleziona Modifica.**

Il menu del pannello consente inoltre di accedere alle seguenti azioni:
+ **Visualizza**: visualizza il pannello a schermo intero.
+ **Modifica**: apre l'editor dei pannelli per modificare il pannello e le opzioni di visualizzazione.
+ **Condividi**: condividi il pannello come link o pannello della libreria.
+ **Esplora**: apri il pannello in **Esplora**, dove puoi concentrarti sulla tua ricerca.
+ **Ispeziona**: apri il **cassetto Inspect**, dove puoi esaminare i dati del pannello, le statistiche, i metadati, JSON e le query.
  + **Dati****: apri il **cassetto Inspect nella scheda** Dati.**
  + **Interrogazione****: apre il **cassetto Inspect** nella scheda Query.**
  + **Panel JSON****: apri il **cassetto Inspect** nella scheda JSON.**
+ **Estensioni**: accedi ad altre azioni fornite dalle applicazioni installate, come la dichiarazione di un incidente. Questa opzione è disponibile solo se sono installati plugin per app che aggiungono un'estensione al menu del pannello.
+ **Altro**: accedi ad altre azioni del pannello.
  + **Duplica**: crea una copia del pannello. I pannelli duplicati interrogano i dati separatamente dal pannello originale. Se desideri utilizzare gli stessi risultati della query, puoi utilizzare la fonte di `Dashboard` dati nel secondo pannello.
  + **Copia**: copia il pannello negli appunti.
  + **Crea pannello libreria**: crea un pannello che può essere importato in altre dashboard.
  + **Crea avviso**: apre la pagina di configurazione delle regole di avviso in **Avvisi**, dove puoi creare un [avviso gestito da Grafana in base alle query](v10-alerts.md) del pannello.
  + Nascondi legenda: **nasconde la legenda** del pannello.
  + **Chiedi aiuto**: invia un'istantanea o i dati del pannello al Supporto tecnico di Grafana Labs.
+ **Rimuovi: rimuovi** il pannello dalla dashboard.

## Editor di pannelli
<a name="v10-panels-editor-view"></a>

Questa sezione descrive le aree dell'editor del pannello Grafana.
+ Intestazione del pannello: la sezione dell'intestazione elenca la dashboard in cui viene visualizzato il pannello e i seguenti controlli:
  + **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:
  + **Vista 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](v10-panels-table.md).
  + **Riempi**: 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 mantenendo 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. Per ulteriori informazioni, consulta [Interroga e trasforma i dati](v10-panels-query-xform.md). Quando crei inizialmente una dashboard, ti viene richiesto di selezionare un'origine dati. È possibile aggiornare l'origine dati o la query in questa scheda.
  + **Scheda Trasforma**: applica le trasformazioni dei dati. Per ulteriori informazioni, consulta [Interroga e trasforma i dati](v10-panels-query-xform.md).
  + **Scheda Avviso**: scrivi le regole di avviso. Per ulteriori informazioni, consulta [Avvisi nella versione 10 di Grafana](v10-alerts.md).
+ Opzioni di visualizzazione del pannello: la sezione delle opzioni di visualizzazione contiene schede in cui è possibile configurare quasi ogni aspetto della visualizzazione dei dati. I dettagli variano in base al tipo di visualizzazione selezionato.

## Pannello, ispeziona il cassetto.
<a name="v10-panels-editor-inspect"></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 cassetto Panel Inspect si presenta come un cassetto sul lato destro. Selezionate la 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 sta effettuando il provisioning o la somministrazione di Grafana.
+ **Scheda Query**: mostra le richieste al server inviate quando Grafana interroga l'origine dati.
+ **Scheda Errore**: mostra tutti gli errori restituiti da una query. La scheda è visibile solo quando una query restituisce un errore.

# La vista di ispezione del pannello
<a name="v10-panels-panel-inspector"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 Amazon Managed 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:** nella parte superiore del riquadro. Selezionate la freccia nell'angolo in alto a destra 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 sta effettuando il provisioning o la somministrazione di Grafana.

1. **Scheda Query**: mostra le richieste inviate al server quando Grafana interroga l'origine dati.

1. **Scheda Errore**: mostra tutti gli errori. Visibile solo quando una query restituisce un errore.

## Scaricamento dei risultati non elaborati delle query
<a name="v10-panels-raw-query-results"></a>

Amazon Managed 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.

**Per scaricare i risultati grezzi delle interrogazioni**

1. Modifica il pannello che contiene i dati dell'interrogazione che desideri scaricare.

1. Nell'editor di query, selezionare **Query Inspector**.

1. Seleziona **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 alla data**: visualizza i dati grezzi di tutte le tue query contemporaneamente, un set di risultati per colonna. Seleziona l'intestazione di una colonna per riordinare i dati.

1. Per visualizzare i dati prima che il sistema applichi le sostituzioni dei campi, seleziona l'interruttore Dati **formattati**.

1. **Per scaricare un file CSV formattato specificamente per Excel, seleziona l'interruttore Scarica per Excel.**

1. Selezionare **Scarica CSV**.

## Controllo delle prestazioni delle interrogazioni
<a name="v10-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.

**Per controllare le prestazioni delle interrogazioni**

1. Modifica il pannello che contiene l'interrogazione con le prestazioni che desideri controllare.

1. Nell'editor di query, selezionare **Query Inspector**.

1. Seleziona **Statistiche**.

Le statistiche vengono visualizzate in formato di sola lettura.

## Ispezione della richiesta e della risposta alle interrogazioni
<a name="v10-panels-query-request-response"></a>

È possibile esaminare i dati della richiesta di interrogazione e della risposta quando si desidera risolvere una query che restituisce risultati imprevisti o non restituisce i risultati previsti.

1. Modificate il pannello che contiene l'interrogazione da esportare.

1. Nell'editor di query, selezionare **Query Inspector**.

1. Seleziona **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.

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Amazon Managed 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 interrogazione e i plug-in di origine dati implementano ciascuno un'interfaccia utente per la creazione di query chiamata editor di query.

**Topics**
+ [Informazioni sulle interrogazioni](#v10-panels-query-xform-about)
+ [Naviga nella scheda delle interrogazioni](#v10-panels-query-xform-navigate)
+ [Aggiungere una query](#v10-panels-query-xform-add)
+ [Gestisci le interrogazioni](#v10-panels-query-xform-manage)
+ [Opzioni di interrogazione](#v10-panels-query-xform-options)
+ [Scrivere interrogazioni sulle espressioni](v10-panels-query-xform-expressions.md)
+ [Condividi i risultati delle interrogazioni con un altro pannello](v10-panels-query-share.md)
+ [Trasformazione dei dati](v10-panels-xform.md)
+ [Risolvi i problemi relativi alle interrogazioni](v10-panels-query-troubleshoot.md)
+ [Tipi di calcolo](v10-panels-calculation-types.md)

## Informazioni sulle interrogazioni
<a name="v10-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 query 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 origine dati, incluse informazioni sulle query e sulla sintassi, consulta la documentazione sull'origine dati:
+ Per le fonti di dati incluse in Amazon Managed Grafana, consulta Origini [dati integrate](AMG-data-sources-builtin.md).
+ Per le fonti di dati incluse in Grafana Enterprise, vedere. [Connect a fonti di dati aziendali](AMG-data-sources-enterprise.md)
+ Per altri plugin di sorgenti dati che si installano tramite il[Trova i plugin con il catalogo dei plugin](grafana-plugins.md#plugin-catalog), la documentazione è collegata all'elenco nel catalogo dei plugin.

**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 ulteriori informazioni, consulta [Connessione alle origini dati](AMG-data-sources.md).

## Naviga nella scheda delle interrogazioni
<a name="v10-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 interrogazioni che hai scritto.
+ **Espressioni**: utilizza il generatore di espressioni per creare espressioni di avviso. Per ulteriori informazioni sulle espressioni, consulta [Scrivere interrogazioni sulle espressioni](v10-panels-query-xform-expressions.md).

## Aggiungere una query
<a name="v10-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](#v10-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="v10-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, rimuoverle, riordinarle e attivare la guida dell'editor di query.

## Opzioni di interrogazione
<a name="v10-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.
+ **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](v10-dash-variable-add.md#v10-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/v10-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/v10-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="v10-panels-query-xform-expressions"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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 più comunemente utilizzate dagli avvisi [Grafana](v10-alerts.md). 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 fonti di dati di backend. Si presume generalmente che i dati siano etichettati come dati di serie temporali. 

Le query sulle 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:

La seguente tabella di esempio produce 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 un valore pari a 1.


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

**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 esempio,). `-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 <Operation>numero = numero
+ <Operation>Serie numerica = serie
+ Serie <Operation>serie = 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 corrispondono esattamente, 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` è etichettato, si `{host=A}` 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 devi 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 è necessaria per questo controllo 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. Ciò può essere fatto 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` espresse in secondi, `m` `h` minuti, `d` ore, giorni, `w` settimane e `y` anni.
+ **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 noto
  + **riempimento con il successivo** valore noto
  + **fillna** per riempire le finestre di esempio vuote con NaNs

## Scrivere un'espressione
<a name="v10-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="v10-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. [Configura le regole di avviso gestite da Grafana](v10-alerting-configure-grafanamanaged.md)

Nel caso di utilizzo di un'espressione su più query, il motore di espressione richiede che tutte le query restituiscano un timestamp identico. Ad esempio, se si utilizza la matematica per combinare il risultato di più query SQL utilizzate da ciascuna`SELECT NOW() AS "time"`, l'espressione funzionerà solo se tutte le query restituiscono un timestamp identico, cosa che non sempre accade. `NOW()` Per risolvere questo problema, è possibile sostituirlo `NOW()` con un orario arbitrario, ad esempio`SELECT 1 AS "time"`, o qualsiasi altro timestamp UNIX valido.

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 un pannello di controllo](v10-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 dati **Grafana**, che restituisce una serie temporale casuale che puoi utilizzare per i test.

1. Aggiungi un secondo pannello e seleziona la fonte di 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="v10-panels-xform"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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="v10-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="v10-panels-xform-add"></a>

I seguenti passaggi ti guidano nell'aggiunta di una trasformazione ai dati. Questa documentazione non include i passaggi per ogni tipo di trasformazione.

**Per aggiungere una trasformazione a un pannello**

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

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

1. Dal menu delle azioni, scegli **Modifica**.

1. Seleziona la scheda **Trasforma**.

1. Seleziona 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="v10-panels-xform-debug"></a>

Per visualizzare i set di risultati in ingresso e in uscita della trasformazione, scegliete l'icona di debug (bug) sul lato destro della riga di trasformazione. Verranno visualizzati i dati di input e il risultato della trasformazione come output.

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

## Disabilita una trasformazione
<a name="v10-panels-xform-disable"></a>

Puoi disabilitare o nascondere una trasformazione scegliendo l'icona mostra (occhio) in alto a destra nella riga di trasformazione. Ciò disabilita le azioni applicate a quella specifica trasformazione e può aiutare a identificare i problemi quando si modificano più trasformazioni una dopo l'altra.

## Filtrare una trasformazione
<a name="v10-panels-xform-filter"></a>

Se la trasformazione utilizza più di una query, è possibile filtrarle e applicare la trasformazione selezionata a una sola delle interrogazioni. Per fare ciò, scegli l'icona del filtro in alto a destra nella riga di trasformazione. Si apre un menu a discesa con un elenco di interrogazioni utilizzate nel pannello. Da qui, puoi selezionare l'interrogazione che desideri trasformare.

Puoi anche filtrare in base alle annotazioni (che includono gli esempi) per applicare loro delle trasformazioni. Quando si esegue questa operazione, l'elenco dei campi cambia per riflettere quelli presenti nell'annotazione o nel tooltip del campione.

L'icona del filtro viene sempre visualizzata se il pannello contiene più di una query o fonte di dati (ovvero dati di pannello o annotazione), ma potrebbe non funzionare se sono state applicate trasformazioni precedenti per l'unione degli output delle query. Questo perché una trasformazione prende l'output di quella precedente.

## Eliminare una trasformazione
<a name="v10-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 **Trasforma**.

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

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 eseguire le seguenti trasformazioni sui dati.

## Aggiungi campo dal calcolo
<a name="v10-panels-xform-funcs-add"></a>

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.
  + **Operazione binaria**: applica operazioni binarie di base (ad esempio, somma o moltiplica) sui valori in una singola riga da due campi selezionati.
  + **Operazione unaria**: applica le operazioni unarie di base sui valori in una singola riga da un campo selezionato. Le operazioni disponibili sono:
    + **Valore assoluto (abs)**: restituisce il valore assoluto di una determinata espressione. Rappresenta la distanza da zero come numero positivo.
    + **Esponenziale naturale (exp)**: restituisce *e* elevato alla potenza di una determinata espressione.
    + **Logaritmo naturale (ln)**: restituisce il logaritmo naturale di una determinata espressione.
    + **Floor (floor)**: restituisce il numero intero più grande minore o uguale a una determinata espressione.
    + **Ceiling (ceil)**: restituisce il numero intero più piccolo maggiore o uguale a una determinata espressione.
  + Funzioni **cumulative: applica le funzioni** sulla riga corrente e su tutte le righe precedenti.
    + **Totale**: calcola il totale cumulativo fino alla riga corrente inclusa.
    + **Media**: calcola la media fino alla riga corrente inclusa.
  + **Funzioni della finestra**: applica le funzioni della finestra. La finestra può essere *trascinata* o *centrata*. Con una finestra finale, la riga corrente sarà l'ultima riga della finestra. Con una finestra centrata, la finestra sarà centrata sulla riga corrente. Per finestre di dimensioni pari, la finestra sarà centrata tra la riga corrente e la riga precedente.
    + **Media**: calcola la media mobile o la media progressiva.
    + ****— Calcola la deviazione standard mobile.
    + **Varianza**: calcola la varianza mobile.
  + **Indice di riga**: inserisce un campo con l'indice di riga.
+ **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**. Seleziona il campo per visualizzare un elenco di opzioni di calcolo che puoi utilizzare per creare il nuovo campo. Per informazioni sui calcoli disponibili, consulta [Tipi di calcolo](v10-panels-calculation-types.md).
+ **Operazione**: se si seleziona la modalità **operativa binaria** **o unaria**, 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.
+ **Come percentile**: se si seleziona la modalità **Indice di riga**, viene visualizzato l'interruttore **Come percentile**. Questo interruttore consente di trasformare l'indice di riga come percentuale del numero totale di righe.
+ **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.

**Nota**  
Le funzioni **cumulative e le funzioni** **Window** sono attualmente disponibili nell'anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

## Concatena i campi
<a name="v10-panels-xform-funcs-concat"></a>

**Concatena i campi**

Utilizzate questa trasformazione per combinare tutti i campi di tutti i frame in un unico risultato.

Ad esempio, se avete interrogazioni separate che recuperano dati sulla temperatura e sull'operatività (query A) e sull'indice di qualità dell'aria e informazioni sugli errori (query b), applicando la trasformazione concatenata si ottiene un frame di dati consolidato con tutte le informazioni pertinenti in un'unica vista.

Considerate questi due seguenti.

*Interrogazione A:*


| Temp | 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 | 

Questa trasformazione semplifica il processo di fusione dei dati provenienti da diverse fonti, fornendo una visione completa per l'analisi e la visualizzazione.

## Config dai risultati della query
<a name="v10-panels-xform-funcs-config"></a>

**Config dai risultati della query**

Utilizzate questa trasformazione per selezionare una query ed estrarre opzioni standard come **Min**, **Max**, **Unit** e **Thresholds** e applicarle ad altri risultati della query. Ciò consente una configurazione dinamica della visualizzazione, basata sui dati restituiti da una query specifica.

**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**: specifica un tipo di campo o usa un'espressione regolare del nome di campo, a seconda della selezione effettuata in **Applica a**.

**Tabella di mappatura dei campi**

Sotto le opzioni di configurazione, troverai la tabella di mappatura dei campi. Questa tabella elenca tutti i campi trovati nei dati restituiti dalla query di configurazione, insieme alle opzioni **Usa come** e **Seleziona**. Fornisce il controllo sulla mappatura dei campi alle proprietà di configurazione e, per più righe, consente di scegliere il valore da selezionare.

L'esempio seguente mostra una query di input e una query utilizzata come configurazione del campo.

*Query di input*


| Orario | Valore | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*Interrogazione di configurazione*


| Orario | Valore | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

*Query di output (uguale a input, ma ora con configurazione nel campo del valore)*


| Orario | Valore (configurazione: Max=100) | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

Ogni campo ha ora un set massimo di opzioni di configurazione. Opzioni come **Min**, **Max**, **Unit** e **Thresholds** fanno parte della configurazione del campo. Se impostate, vengono utilizzate dalla visualizzazione anziché dalle opzioni configurate manualmente nel riquadro delle opzioni dell'editor del pannello.

**Mappature dei valori**

È inoltre possibile trasformare il risultato di una query in mappature di valori. Con questa opzione, ogni riga del risultato della query di configurazione definisce una singola riga di mappatura dei valori. Guarda l'esempio seguente.

*Risultato della query di configurazione*


| Valore | Testo | Colore | 
| --- | --- | --- | 
| L | Bassa | blu | 
| M | Media | verde | 
| H | Elevata | rosso | 

*Nella mappatura del campo, specificare:*


| Campo | Usa come | Select | 
| --- | --- | --- | 
| Valore | Mappature dei valori/Valore | Tutti i valori | 
| Testo | Mappature di valori/ Testo | Tutti i valori | 
| Colore | Mappature di valori/ Colore | Tutti i valori | 

Grafana crea mappature dei valori dai risultati della query e le applica ai risultati delle query di dati reali. Dovresti vedere i valori mappati e colorati in base ai risultati della query di configurazione.

## Converti il tipo di campo
<a name="v10-panels-xform-funcs-convert"></a>

Usa questa trasformazione per modificare il tipo di campo del campo specificato.

Questa trasformazione ha le seguenti opzioni:
+ **Campo**: seleziona uno dei campi disponibili.
+ **as**: seleziona il formato in cui FieldType 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 a DateFormat come input da una stringa, come `yyyy-mm-dd` o`DD MM YYYY hh:mm:ss`.
  + **Booleano**: renderà i valori booleani.
  + **Enum: renderà i valori enumerati**.
    + Mostrerà una tabella per gestire le enumerazioni.
  + **Altro**: tenta di analizzare i valori come json.

Ad esempio, considera la seguente query che potrebbe essere modificata selezionando il campo Time, come **Time** e Date Format as. `YYYY`


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

Il risultato:


| Orario | Mark | Valore | 
| --- | --- | --- | 
| 2017-01-01 00:00:00 | sopra | 25 | 
| 2018-01-01 00:00:00 | sotto | 22 | 
| 2019-01-01 00:00:00 | sotto | 29 | 
| 2020-01-01 00:00:00 | sopra | 22 | 

Questa trasformazione consente di adattare in modo flessibile i tipi di dati, garantendo compatibilità e coerenza nelle visualizzazioni.

## Estrai campi
<a name="v10-panels-xform-funcs-extract"></a>

Usa questa trasformazione per selezionare una fonte di dati ed estrarne il contenuto in diversi formati. Questa trasformazione ha i seguenti campi:
+ **Origine**: seleziona il campo per l'origine dei dati.
+ **Formato**: scegli una delle seguenti opzioni:
  + **JSON**: analizza il contenuto JSON dalla fonte.
  + **Coppie chiave\$1valore**: analizza il contenuto nel formato o dalla fonte. `a=b` `c:d`
  + **Automatico**: scopri automaticamente i campi.
+ **Sostituisci tutti i campi**: (Facoltativo) Seleziona questa opzione per nascondere tutti gli altri campi e visualizzare solo il campo calcolato nella visualizzazione.
+ **Keep Time** - (Facoltativo) Disponibile solo se l'opzione **Sostituisci tutti i campi** è impostata su True. Mantiene il campo temporale nell'output.

Considerate il seguente set di dati:

**Esempio di set di dati**


| Time stamp | json\$1data | 
| --- | --- | 
| 1636678740000000000 | \$1"valore»: 1\$1 | 
| 1636678680000000000 | \$1"valore»: 5\$1 | 
| 1636678620000000000 | \$1"valore»: 12\$1 | 

È possibile preparare i dati da utilizzare da un [pannello Time series](v10-panels-time-series.md) con questa configurazione:
+ Fonte: json\$1data
+ Formato: JSON
  + Campo: valore
  + Alias: my\$1value
+ Sostituisci tutti i campi: true
+ Mantieni il tempo: vero

Questo genererà il seguente output:

**Dati trasformati**


| Time stamp | my\$1value | 
| --- | --- | 
| 1636678740000000000 | 1 | 
| 1636678680000000000 | 5 | 
| 1636678620000000000 | 12 | 

Con questa trasformazione, puoi estrarre e formattare i dati in vari modi. È possibile personalizzare il formato di estrazione in base alle esigenze specifiche dei dati.

## Cerca i campi dalla risorsa
<a name="v10-panels-xform-funcs-lookup"></a>

Usa questa trasformazione per arricchire il valore di un campo cercando campi aggiuntivi da una fonte esterna.

Questa trasformazione ha i seguenti campi:
+ **Campo**: seleziona un campo di testo dal tuo set di dati.
+ **Ricerca****: scegli tra **Paesi**, **Stati Uniti** e aeroporti.**

**Nota**  
Questa trasformazione supporta solo dati spaziali.

Ad esempio, se disponi di questi dati:

**Esempio di set di dati**


| Location (Ubicazione) | Valori | 
| --- | --- | 
| AL | 0 | 
| AK | 10 | 
| Arizona | 5 | 
| Arkansas | 1 | 
| Da qualche parte | 5 | 

Con questa configurazione:
+ Campo: posizione
+ Ricerca: Stati Uniti

Otterrai il seguente risultato:

**Dati trasformati**


| Location (Ubicazione) | ID | Name | Lng | Lat | Valori | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80,891064 | 12,448457 | 0 | 
| AK | AK | Arkansas | -100,891064 | 24,448457 | 10 | 
| Arizona |  |  |  |  | 5 | 
| Arkansas |  |  |  |  | 1 | 
| Da qualche parte |  |  |  |  | 5 | 

Questa trasformazione consente di aumentare i dati recuperando informazioni aggiuntive da fonti esterne, fornendo un set di dati più completo per l'analisi e la visualizzazione.

## Filtra i dati per query RefID
<a name="v10-panels-xform-funcs-queryrefid"></a>

Utilizzate questa trasformazione per nascondere una o più interrogazioni nei pannelli con più interrogazioni.

Grafana visualizza le lettere di identificazione della query in testo grigio scuro. Scegli 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 valori
<a name="v10-panels-xform-funcs-values"></a>

Usa questa trasformazione per filtrare selettivamente i punti dati direttamente all'interno della visualizzazione. Questa trasformazione offre opzioni per includere o escludere i dati in base a una o più condizioni applicate a un campo selezionato.

Questa trasformazione è molto 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 aggiuntive 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 minimo e massimo.

Considerate il seguente set di dati:


| Orario | Temperatura | Altitude (Altitudine) | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Se **includi** i punti dati con una temperatura inferiore a 30°C, la configurazione sarà la seguente:
+ Tipo di filtro: 'Includi'
+ Condizione: righe in cui «Temperatura» corrisponde a «Inferiore a» «30"

E otterrai il seguente risultato, in cui sono incluse solo le temperature inferiori a 30 °C:

**Dati trasformati**


| Orario | Temperatura | Altitude (Altitudine) | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

È possibile 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: «Includi» le righe che «corrispondono a tutte le condizioni»
+ Condizione 1: righe in cui «Temperatura» corrisponde a «Inferiore» a «30»
+ Condizione 2: righe in cui «Altitudine» corrisponde a «Maggiore» di «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 corrispondono** **a una delle condizioni che hai** aggiunto.

Nell'esempio precedente, abbiamo scelto **Abbina tutto** perché volevamo includere le righe con una temperatura inferiore a 30°C *E* un'altitudine superiore a 100. Se volessimo includere invece le righe che hanno una temperatura inferiore a 30°C *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.

Questa trasformazione versatile del filtraggio dei dati consente di includere o escludere selettivamente i punti dati in base a condizioni specifiche. Personalizza i criteri per personalizzare la presentazione dei dati in modo da soddisfare le tue esigenze analitiche uniche.

## Filtra i campi per nome
<a name="v10-panels-xform-funcs-name"></a>

Utilizza questa trasformazione per rimuovere parti dei risultati della query. Esistono tre modi per filtrare i nomi dei campi:
+ Inserisci un'espressione regolare.
+ Seleziona manualmente i campi inclusi.
+ Usa una variabile del dashboard.

*Usa un'espressione regolare*

Quando si filtra utilizzando un'espressione regolare, vengono inclusi i nomi di campo che corrispondono all'espressione regolare. Ad esempio, l'utilizzo dell'espressione regolare `'prod.*'` restituirebbe solo i campi che iniziano con `prod`

L'espressione regolare può includere una variabile di dashboard interpolata utilizzando la `${variableName}` sintassi.

*Seleziona manualmente i campi inclusi*

Seleziona o deseleziona i nomi dei campi per rimuoverli dal risultato. Se è inclusa anche un'espressione regolare, vengono inclusi i campi che corrispondono all'espressione, anche se non sono selezionati.

*Usa una variabile del pannello di controllo*

Seleziona **Dalla variabile** per selezionare una variabile del dashboard utilizzata per includere i campi. Impostando una variabile di dashboard con scelte multiple, gli stessi campi possono essere visualizzati in più visualizzazioni.

Questa trasformazione offre flessibilità nella personalizzazione dei risultati delle query per concentrarsi sui campi specifici necessari per un'analisi e una visualizzazione efficaci.

## Stringa di formato
<a name="v10-panels-xform-funcs-string"></a>

Utilizzate questa trasformazione per personalizzare l'output di un campo di stringa. Questa trasformazione ha i seguenti campi:
+ **Maiuscolo**: formatta l'intera stringa in caratteri maiuscoli.
+ **Minuscole**: formatta l'intera stringa in caratteri minuscoli.
+ **Frase maiuscola**: formatta il primo carattere della stringa in maiuscolo.
+ **Maiuscole e minuscole**: formatta il primo carattere di ogni parola nella stringa in maiuscolo.
+ **Pascal case** — Formatta il primo carattere di ogni parola nella stringa in maiuscolo e non include spazi tra le parole.
+ **Camel case**: formatta il primo carattere di ogni parola nella stringa in maiuscolo, tranne la prima parola, e non include spazi tra le parole.
+ **Snake case**: formatta tutti i caratteri della stringa in lettere minuscole e utilizza caratteri di sottolineatura anziché spazi tra le parole.
+ **Kebab case**: formatta tutti i caratteri della stringa in lettere minuscole e utilizza trattini anziché spazi tra le parole.
+ **Trim** — Rimuove tutti gli spazi iniziali e finali dalla stringa.
+ **Sottostringa** — Restituisce una sottostringa della stringa, utilizzando le posizioni iniziale e finale specificate.

Questa trasformazione offre un modo conveniente per standardizzare e personalizzare la presentazione dei dati delle stringhe per una migliore visualizzazione e analisi.

**Nota**  
Questa trasformazione è attualmente disponibile in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

## Ora di formattazione
<a name="v10-panels-xform-funcs-time"></a>

Utilizzate questa trasformazione per personalizzare l'output di un campo temporale. L'output può essere formattato utilizzando [stringhe di formato Moment.js](https://momentjs.com/docs/#/displaying/). Ad esempio, se si desidera visualizzare solo l'anno di un campo orario, è possibile utilizzare la stringa di formato 'YYYY' per mostrare l'anno solare (ad esempio, 1999 o 2012).

**Prima della trasformazione:**


| Time stamp | Event | 
| --- | --- | 
| 1636678740000000000 | Avvio del sistema | 
| 1636678680000000000 | Login utente | 
| 1636678620000000000 | Dati aggiornati | 

**Dopo aver applicato 'YYYY-MM-DD HH:mm:ss':**


| Time stamp | Event | 
| --- | --- | 
| 2021-11-12 14:25:40 | Avvio del sistema | 
| 2021-11-12 14:24:40 | Login utente | 
| 2021-11-12 14:23:40 | Dati aggiornati | 

Questa trasformazione consente di personalizzare la rappresentazione del tempo nelle visualizzazioni, offrendo flessibilità e precisione nella visualizzazione dei dati temporali.

**Nota**  
Questa trasformazione è disponibile in aree di lavoro compatibili con Grafana v10 come funzionalità alfa.

## Gruppo da
<a name="v10-panels-xform-funcs-group"></a>

Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. Seleziona 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.

## Raggruppamento in matrice
<a name="v10-panels-xform-funcs-groupmatrix"></a>

Utilizzate questa trasformazione per combinare tre campi, utilizzati come input per i campi dei **valori **Colonna**, **Riga** e Cella** dall'output della query, e generare una matrice. La matrice viene calcolata come segue:

**Dati originali**


| ID del server | Temperatura della CPU | Stato del server | 
| --- | --- | --- | 
| server 1 | 82 | OK | 
| server 2 | 8.6 | OK | 
| server 3 | 59,6 | Arresto | 

Possiamo generare una matrice usando i valori di `Server Status` come nomi di colonna, i `Server ID` valori come nomi di riga e `CPU Temperature` come contenuto di ogni cella. Il contenuto di ogni cella verrà visualizzato per la combinazione di colonne (`Server Status`) e righe esistente (`Server ID`). Per il resto delle celle, puoi selezionare il valore da visualizzare tra: **Null**, **True**, **False** o **Empty**.

**Output**


| Stato del server IDServer  | OK | Arresto | 
| --- | --- | --- | 
| server 1 | 82 |  | 
| server 2 | 8.6 |  | 
| server 3 |  | 59,6 | 

Utilizzate questa trasformazione per costruire una matrice specificando i campi dai risultati della query. L'output della matrice riflette le relazioni tra i valori univoci in questi campi. Ciò consente di presentare relazioni complesse in un formato a matrice chiaro e strutturato.

## Da gruppo a tabella nidificata
<a name="v10-panels-xform-funcs-grouptable"></a>

Utilizza questa trasformazione per raggruppare i dati in base a un valore di campo (colonna) specificato ed elaborare il calcolo su ciascun gruppo. Vengono generati record che condividono lo stesso valore del campo raggruppato, da visualizzare in una tabella nidificata.

**Per calcolare una statistica per un campo, seleziona la casella accanto al campo e scegli l'opzione Calcola.** Verrà aggiunta un'altra casella di selezione con le statistiche da selezionare.

La tabella seguente mostra dati di esempio.


| 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 prevede due fasi. Innanzitutto, specifica uno o più campi in base ai quali raggruppare i dati. Questo raggruppa tutti gli stessi valori di quei campi, come se li ordinassi. Ad esempio, se raggruppi per `Server ID` campo, Grafana raggruppa i dati in questo modo:


| ID del server | Dati | 
| --- | --- | 
| Orario | Temperatura della CPU | Stato del server | 
| --- | --- | --- | 
| Orario | Temperatura della CPU | Stato del server | 
| --- | --- | --- | 
| Orario | Temperatura della CPU | Stato del server | 
| --- | --- | --- | 
| server 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 07/07/2020 11:34:20AM | 80 | Arresto | 
| 07/07/2020 9:28:06 | 80 | OK | 
| 07/07/2020 9:23:07 | 86 | OK | 
| 07/07/2020 10:32:20 | 90 | Sovraccarico | 
| 07/07/2020 9:30:05 | 88 | OK | 
| 07/07/2020 9:25:05 | 88 | OK | 
| 07/07/2020 11:34:20AM | 62 | OK | 
| 07/07/2020 10:31:22 | 55 | OK | 
| 07/07/2020 9:30:57 | 62 | Reebooting (Riavvio in corso) | 

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, potresti voler calcolare la temperatura media della CPU per ciascuno di questi server. A tale scopo, aggiungi il calcolo della media applicato al campo Temperatura della CPU per ottenere il seguente risultato:


| ID del server | Temperatura della CPU (media) |  | 
| --- | --- | --- | 
| Orario | Stato del server | 
| --- | --- | 
| Orario | Stato del server | 
| --- | --- | 
| Orario | Stato del server | 
| --- | --- | 
| server 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 2 | 8.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| server 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 07/07/2020 11:34:20AM | Arresto | 
| 07/07/2020 9:28:06 | OK | 
| 07/07/2020 9:23:07 | OK | 
| 07/07/2020 10:32:20 | Sovraccarico | 
| 07/07/2020 9:30:05 | OK | 
| 07/07/2020 9:25:05 | OK | 
| 07/07/2020 11:34:20AM | OK | 
| 07/07/2020 10:31:22 | OK | 
| 07/07/2020 9:30:57 | Reebooting (Riavvio in corso) | 

## Crea una mappa termica
<a name="v10-panels-xform-funcs-heatmap"></a>

Usa questa trasformazione per preparare i dati dell'istogramma per visualizzare le tendenze nel tempo. Simile alla visualizzazione della mappa termica, questa trasformazione converte le metriche degli istogrammi in intervalli temporali.

**X Bucket**

Questa impostazione determina come l'asse x viene suddiviso in secchi.
+ **Dimensione**: specifica un intervallo di tempo nel campo di immissione. Ad esempio, un intervallo di tempo di `1h` crea celle larghe un'ora sull'asse x.
+ **Conteggio**: per le non-time-related serie, utilizzate questa opzione per definire il numero di elementi in un bucket.

**Secchio Y**

Questa impostazione determina come l'asse y viene suddiviso in secchi.
+ **Linear** (Lineare)
+ **Logaritmico**: scegli tra log base 2 o log base 10.
+ **Symlog**: utilizza una scala logaritmica simmetrica. Scegli tra log base 2 o log base 10, tenendo conto dei valori negativi.

Supponiamo di avere il seguente set di dati:


| Time stamp | Valore | 
| --- | --- | 
| 2023-01-01 12:00:00 | 5 | 
| 2023-01-01 12:15:00 | 10 | 
| 2023-01-01 12:30:00 | 15 | 
| 2023-01-01 12:45:00 | 8 | 
+ Con X Bucket impostato su `Size: 15m` e Y Bucket as`Linear`, l'istogramma organizza i valori in intervalli di tempo di 15 minuti sull'asse x e linearmente sull'asse y.
+ Per X Bucket as `Count: 2` e Y Bucket as`Logarithmic (base 10)`, l'istogramma raggruppa i valori in secchi di due sull'asse x e utilizza una scala logaritmica sull'asse y.

## Istogramma
<a name="v10-panels-xform-funcs-histogram"></a>

Utilizzate questa trasformazione per generare un istogramma basato sui dati di input, che consente di visualizzare la distribuzione dei valori.
+ **Dimensione del bucket**: l'intervallo tra gli elementi più bassi e più alti in un bucket (da XMin a XMax).
+ Offset del **bucket: l'offset** per i bucket. non-zero-based
+ **Combina serie**: crea un istogramma unificato utilizzando tutte le serie disponibili.

**Dati originali**

Serie 1:


| A | B | C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

Serie 2:


| C | 
| --- | 
| 5 | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**Output**


| XMin | XMax | A | B | C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5 | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

Visualizza la distribuzione dei valori utilizzando l'istogramma generato, fornendo informazioni sulla diffusione e sulla densità dei dati.

## Partecipa per campo
<a name="v10-panels-xform-funcs-joinfield"></a>

Usa questa trasformazione per unire più risultati in un'unica tabella, permettendo il consolidamento dei dati provenienti da diverse query.

È particolarmente utile per convertire più risultati di 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 | 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 | 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 | 

## Unisciti per etichette
<a name="v10-panels-xform-funcs-joinlabel"></a>

Usa questa trasformazione per unire più risultati in un'unica tabella.

Ciò è particolarmente utile per convertire più risultati di serie temporali in un'unica tabella ampia con un campo **Label** condiviso.
+ **Unisci**: seleziona l'etichetta con cui unirti tra le etichette disponibili o comuni in tutte le serie temporali.
+ **Valore**: il nome del risultato di output.

**Esempio**

Ingresso 1: `series1{what='Temp', cluster='A', job='J1'}`


| Orario | Valore | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Ingresso 2: `series2{what='Temp', cluster='B', job='J1'}`


| Orario | Valore | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Ingresso 3: `series3{what='Speed', cluster='B', job='J1'}`


| Orario | Valore | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

Config:

```
value: 'what'
```

Output:


| cluster | job | Temp | Velocità | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

Combina e organizza i dati delle serie temporali in modo efficace con questa trasformazione per ottenere informazioni complete.

## Etichette per campi
<a name="v10-panels-xform-funcs-labelstofields"></a>

Usa questa trasformazione per convertire i risultati delle serie temporali con etichette o tag in una tabella, includendo le chiavi e i valori di ogni etichetta nel risultato. Visualizza le etichette come colonne o valori di riga per una migliore visualizzazione dei dati.

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à **Colonne**, 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.

Per illustrare ciò, ecco un esempio in cui sono presenti due query che restituiscono serie temporali senza etichette sovrapposte.
+ Serie 1 — etichette `Server=ServerA`
+ Serie 2 — etichette `Datacenter=EU`

Ciò risulterà innanzitutto in queste due tabelle:


| Orario | Server | Valore | 
| --- | --- | --- | 
| 07/07/2020 11:34:20 | Server 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 | Server A | 10 |  | 
| 07/07/2020 11:34:20 |  | 20 | UE | 

## Limite
<a name="v10-panels-xform-funcs-limit"></a>

Usa questa trasformazione per limitare il numero di righe visualizzate, fornendo una visione più mirata dei tuoi dati. Ciò è particolarmente utile quando si ha a che fare con set di dati di grandi dimensioni.

Di seguito è riportato un esempio che illustra l'impatto della trasformazione **Limit** su una risposta proveniente da una 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 | 

Questa trasformazione ti aiuta a personalizzare la presentazione visiva dei tuoi dati per concentrarti sui dati più pertinenti.

## Unisci serie/tabelle
<a name="v10-panels-xform-funcs-merge"></a>

Utilizzate questa trasformazione per combinare il risultato di più interrogazioni in un unico risultato, il che è particolarmente utile quando si utilizza la visualizzazione del pannello tabellare. La trasformazione unisce i valori nella stessa riga se i campi condivisi contengono gli stessi dati.

Ecco un esempio di illustrazione dell'impatto della trasformazione **Merge series/tables** su due query che restituiscono dati di tabella:

*Interrogazione A:*


| Orario | Processo | 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 | 

Questa trasformazione combina i valori della Query A e della Query B in una tabella unificata, migliorando la presentazione per una migliore comprensione.

## Organizza i campi per nome
<a name="v10-panels-xform-funcs-organize"></a>

Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti da una singola query nel pannello. 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.

**Trasformazione dei campi**

Grafana mostra un elenco di campi restituiti dalla query. Puoi:
+ **Modifica l'ordine dei campi**: trascina un campo in una nuova posizione nell'elenco.
+ **Nascondi o mostra un campo**: utilizza l'icona a forma di occhio accanto al nome del campo per attivare o disattivare la visibilità di un campo.
+ **Rinomina campi****: digita un nuovo nome nella casella Rinomina.**

**Esempio**

Dato questo risultato iniziale della query:


| Orario | Metrica | Valore | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatura | 25 | 
| 2020-07-07 11:34:20 | Umidità | 22 | 
| 2020-07-07 10:32:20 | Umidità | 29 | 

Puoi applicare una modifica del campo di ridenominazione per creare:


| Orario | Sensor | Leggere | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatura | 25 | 
| 2020-07-07 11:34:20 | Umidità | 22 | 
| 2020-07-07 10:32:20 | Umidità | 29 | 

Questa trasformazione consente di personalizzare la visualizzazione dei risultati delle query, garantendo una rappresentazione chiara e approfondita dei dati in Grafana.

## Partizione per valori
<a name="v10-panels-xform-funcs-partition"></a>

Utilizzate questa trasformazione per semplificare il processo di rappresentazione grafica di più serie senza la necessità di più interrogazioni con clausole diverse. `WHERE`

**Nota**  
Questa funzione è disponibile in aree di lavoro compatibili con Grafana versione 9 e successive.

Ciò è particolarmente utile quando si utilizza una tabella SQL di metriche, come in questo esempio:


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

Con il trasformatore *Partition by values*, puoi emettere una singola query e dividere i risultati per valori univoci in una o più colonne (campi) 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 | 

Questa trasformazione semplifica il processo e migliora la flessibilità di visualizzazione di più serie all'interno della stessa visualizzazione di serie temporali.

## Prepara le serie temporali
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

Utilizza questa trasformazione per risolvere i problemi quando un'origine dati restituisce dati di serie temporali in un formato non compatibile con la visualizzazione desiderata. Questa trasformazione consente di convertire i dati delle serie temporali tra formati ampi e lunghi.

**Serie temporali a più fotogrammi**

Utilizzate questa opzione per trasformare il frame di dati della serie temporale dal formato ampio al formato lungo. Ciò è particolarmente utile quando la fonte di dati fornisce informazioni sulle serie temporali in un formato che deve essere rimodellato per una compatibilità ottimale con la visualizzazione.

*Esempio*

Questo input:


| Time stamp | Value1 | Value2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

Potrebbe essere trasformato in:


| Time stamp | Variabile | Valore | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Value1 | 10 | 
| 2023-01-01 00:00:00 | Value2 | 20 | 
| 2023-01-01 01:00:00 | Value1 | 15 | 
| 2023-01-01 01:00:00 | Value2 | 25 | 

**Ampie serie temporali**

Utilizzate questa opzione per trasformare il frame di dati della serie temporale dal formato lungo al formato ampio. Ciò è particolarmente utile quando la fonte di dati fornisce dati di serie temporali in un formato lungo e la visualizzazione richiede un formato ampio.

*Esempio*

Questo input:


| Time stamp | Variabile | Valore | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | Value1 | 10 | 
| 2023-01-01 00:00:00 | Value2 | 20 | 
| 2023-01-01 01:00:00 | Value1 | 15 | 
| 2023-01-01 01:00:00 | Value2 | 25 | 

Potrebbe essere trasformato in:


| Time stamp | Value1 | Value2 | 
| --- | --- | --- | 
| 2023-01-01 00:00:00 | 10 | 20 | 
| 2023-01-01 01:00:00 | 15 | 25 | 

## Ridurre
<a name="v10-panels-xform-funcs-reduce"></a>

Usa questa trasformazione applica un calcolo a ciascun campo nel frame di dati e restituisce un singolo valore. Questa trasformazione è particolarmente utile per consolidare più dati di serie temporali in un formato riepilogativo più compatto. I campi temporali vengono rimossi quando si applica questa trasformazione.

Considerate l'input:

Interrogazione A:


| Orario | Temp | Operatività | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15,4 | 1230233 | 

Interrogazione B:


| Orario | AQI | Errori | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 6,5 | 15 | 
| 2020-07-07 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 | Operatività | 
| --- | --- | 
| 15.4 | 1230233 | 

Interrogazione B:


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

## Rinomina tramite regex
<a name="v10-panels-xform-funcs-rename"></a>

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. Potresti impostare l'espressione regolare su `([^\.]+)\..+` e il pattern sostitutivo su`$1`, `web-01.example.com` diventerebbe. `web-01`

Questa trasformazione consente di personalizzare i dati per soddisfare le esigenze di visualizzazione, rendendo le dashboard più informative e intuitive.

## Da righe a campi
<a name="v10-panels-xform-funcs-row"></a>

Usa questa trasformazione per convertire le righe in campi separati. Ciò può essere utile perché 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 **Usa come**). 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 invece.
+ 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 fonte 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) | 
| --- | --- | 
| 100 | 200 | 

Le etichette aggiuntive possono ora essere utilizzate nel nome visualizzato del campo 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.

Questa trasformazione consente la conversione delle righe in singoli campi, facilita la configurazione dinamica dei campi e associa campi aggiuntivi alle etichette.

## Da serie a righe
<a name="v10-panels-xform-funcs-series"></a>

Usa questa trasformazione per combinare il risultato di più query 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 | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 2020-07-07 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*Interrogazione B:*


| Orario | Umidità | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 2020-07-07 10:32:20 | 29 | 
| 2020-07-07 09:30:57 | 33 | 

Ecco il risultato dopo aver applicato la trasformazione Series to rows.


| Orario | Metrica | Valore | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Temperatura | 25 | 
| 2020-07-07 11:34:20 | Umidità | 22 | 
| 2020-07-07 10:32:20 | Umidità | 29 | 
| 2020-07-07 10:31:22 | Temperatura | 22 | 
| 2020-07-07 09:30:57 | Umidità | 33 | 
| 2020-07-07 09:30:05 | Temperatura | 19 | 

Questa trasformazione facilita il consolidamento dei risultati di più interrogazioni su serie temporali, fornendo un set di dati semplificato e unificato per analisi e visualizzazione efficienti in formato tabulare.

## Ordina per
<a name="v10-panels-xform-funcs-sort"></a>

Utilizzate questa trasformazione per ordinare ogni frame all'interno del risultato di una query in base a un campo specifico, semplificando la comprensione e l'analisi dei dati. Configurando il campo desiderato per l'ordinamento, puoi controllare l'ordine in cui i dati vengono presentati nella tabella o nella visualizzazione.

Utilizzate l'interruttore **Reverse** per ordinare inversamente i valori all'interno del campo specificato. Questa funzionalità è particolarmente utile quando si desidera passare rapidamente dall'ordine crescente a quello decrescente per soddisfare le proprie esigenze analitiche.

Ad esempio, in uno scenario in cui i dati di serie temporali vengono recuperati da una fonte di dati, è possibile applicare la trasformazione **Ordina** per disporre i frame di dati in base al timestamp, in ordine crescente o decrescente, a seconda dei requisiti analitici. Questa funzionalità consente di navigare e interpretare facilmente i dati delle serie temporali, ottenendo informazioni preziose dalla presentazione organizzata e visivamente coerente.

## Spatial
<a name="v10-panels-xform-funcs-spatial"></a>

Utilizzate questa trasformazione per applicare operazioni spaziali ai risultati delle query.
+ **Azione**: seleziona un'azione:
  + **Prepara campo spaziale**: imposta un campo geometrico basato sui risultati di altri campi.
    + **Modalità di posizione**: seleziona una modalità di localizzazione (queste opzioni sono condivise dalle modalità **Calcola valore** e **Trasforma**):
      + **Automatico**: identifica automaticamente i dati sulla posizione in base ai nomi dei campi predefiniti.
      + **Coordinate:** specifica i campi di latitudine e longitudine.
      + **Geohash: specifica un campo geohash**.
      + **Ricerca: specifica i campi di posizione di** Gazetteer.
  + **Calcola valore**: utilizza la geometria per definire un nuovo campo (). heading/distance/area
    + **Funzione**: scegli un'operazione matematica da applicare alla geometria:
      + **Intestazione**: calcola la direzione tra due punti.
      + **Area**: calcola l'area racchiusa da un poligono definito dalla geometria.
      + **Distanza**: calcola la distanza tra due punti.
  + **Trasforma**: applica le operazioni spaziali alla geometria.
    + **Operazione** — Scegliete un'operazione da applicare alla geometria:
      + **Come linea**: crea una feature a linea singola con un vertice in ogni riga.
      + **Line Builder**: crea una linea tra due punti.

Questa trasformazione consente di manipolare e analizzare i dati geospaziali, abilitando operazioni come la creazione di linee tra i punti, il calcolo delle proprietà spaziali e altro ancora.

## Trasformazione da serie temporale a tabella
<a name="v10-panels-xform-funcs-seriestotable"></a>

Utilizzate questa trasformazione per convertire i risultati delle serie temporali in una tabella, trasformando un frame di dati di serie temporali in un campo di **tendenza**. Il campo **Trend** può quindi essere renderizzato utilizzando il [tipo di cella sparkline](v10-panels-table.md#v10-panels-table-cell-type), generando un grafico sparkline in linea per ogni riga della tabella. Se sono presenti più interrogazioni relative a serie temporali, ciascuna genererà un frame di dati della tabella separato. Questi possono essere uniti utilizzando trasformazioni di unione o unione per produrre un'unica tabella con più sparkline per riga.

Per ogni valore del campo **Trend** generato, è possibile selezionare una funzione di calcolo. L'impostazione predefinita è **Ultimo valore non nullo**. Questo valore viene visualizzato accanto alla linea sparkline e utilizzato per ordinare le righe della tabella.

## Analisi della regressione
<a name="v10-panels-xform-funcs-regression"></a>

Utilizzate questa trasformazione per creare un nuovo frame di dati contenente i valori previsti da un modello statistico. Ciò è utile per individuare una tendenza nei dati caotici. Funziona adattando una funzione matematica ai dati, utilizzando la regressione lineare o polinomiale. Il frame di dati può quindi essere utilizzato in una visualizzazione per visualizzare una linea di tendenza.

Esistono due modelli diversi:
+  **Regressione lineare**: adatta una funzione lineare ai dati.
+  **Regressione polinomiale**: adatta una funzione polinomiale ai dati.

**Nota**  
Questa trasformazione è attualmente disponibile in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

# Risolvi i problemi relativi alle interrogazioni
<a name="v10-panels-query-troubleshoot"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-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.

# Tipi di calcolo
<a name="v10-panels-calculation-types"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 i valori | Array con tutti i valori | 
| Tutti valori univoci | Array con tutti i valori univoci | 
| 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 | Primo valore in un campo | 
| Primo\$1 (non nullo) | Innanzitutto, valore non nullo in un campo (esclude anche) NaNs | 
| Ultimo | Ultimo valore in un campo | 
| Ultimo\$1 (non nullo) | Ultimo valore non nullo in un campo (esclude anche) NaNs | 
| 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 | 

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

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 è una rappresentazione visiva dei dati che puoi personalizzare definendo una query sull'origine dati, trasformando e formattando i dati e configurando le impostazioni di visualizzazione.

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
+ Configura righe e pannelli ripetuti

## Modifica di un pannello
<a name="v10-panels-edit-a-panel"></a>

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

**Per modificare un pannello**

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. Scegli il 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="v10-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 in un tooltip nell'editor del pannello 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](v10-dash-variables.md) nel campo **Titolo** e **Descrizione**, ma non variabili globali.](v10-dash-variable-add.md#v10-dash-variable-add-global)

## Visualizzazione di un modello JSON di un pannello
<a name="v10-panels-json-model"></a>

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

**Per visualizzare un modello JSON a pannello**

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. Dal menu, selezionate **Inspect > Panel JSON**.

1. Nel campo **Seleziona sorgente**, scegliete 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 la struttura dei dati del pannello, incluse eventuali trasformazioni, configurazioni di campo e configurazioni di override che sono state applicate.

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

## Configurazione dei pannelli ripetuti
<a name="v10-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. Per ulteriori informazioni sui pannelli ripetuti, consulta. [Creazione di dashboard](v10-dash-creating.md)

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

*Prerequisiti*
+ Assicuratevi che la query includa una variabile multivalore.

**Per configurare i pannelli ripetuti**

1. Modifica il pannello che desideri ripetere.

1. Nel riquadro delle opzioni di visualizzazione, scegliete **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. Non è possibile mescolare 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="v10-panels-configure-standard-options"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

Un elenco completo delle opzioni di formattazione dei campi è incluso più avanti in questo argomento.

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

**Per configurare le opzioni standard**

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

1. Dal menu delle azioni, scegli **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, selezionatela al di fuori della casella delle opzioni del campo che state modificando o premete **Invio**.

**Definizioni delle opzioni standard**

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**  
Grafana Labs lavora costantemente per aggiungere ed espandere opzioni per tutte le visualizzazioni, quindi tutte le opzioni potrebbero non essere disponibili per tutte le visualizzazioni.

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

Consente di scegliere l'unità da utilizzare in un campo. Scegli il 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="v10-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 un'unità personalizzata che deve seguire il valore.
+ **prefisso:** <prefix>per un'unità personalizzata che deve precedere il valore.
+ **ora:** <format>per formati di data e ora personalizzati, digita ad esempio`time:YYYY-MM-DD`. Per la sintassi e le opzioni del [formato](https://momentjs.com/docs/#/displaying/), consultate il formato nella *documentazione di Moment.js*.
+ **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="v10-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.**

### Unità di scala
<a name="v10-panels-standard-options-scale-units"></a>

Per impostazione predefinita, Grafana ridimensiona automaticamente l'unità in base alla grandezza del valore. Ad esempio, se hai un valore di 0,14 kW, Grafana lo mostrerà come 140 W. Un altro esempio è che 3000 kW verranno visualizzati come tre MW. Se si desidera disabilitare questo comportamento, è possibile disattivare l'interruttore delle unità di **scala**.

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

Consente di impostare il valore minimo utilizzato nei calcoli della soglia percentuale. Lascia vuoto per calcolare automaticamente il minimo.

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

Consente di impostare il valore massimo utilizzato nei calcoli della soglia percentuale. Lascia vuoto per calcolare automaticamente il massimo.

## Campo min/max
<a name="v10-panels-standard-options-fieldminmax"></a>

Per impostazione predefinita, il minimo e il massimo calcolati si baseranno sul minimo e sul massimo, in tutte le serie e i campi. L'attivazione del campo min/max calcolerà il minimo o il massimo per ogni campo singolarmente, in base al minimo o al massimo di quel campo.

## Decimali
<a name="v10-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="v10-panels-standard-options-displayname"></a>

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

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.

Dato un campo con un nome e le etichette `Temp` di: `{"Loc"="PBI", "Sensor"="3"}`


| Sintassi delle espressioni | Esempio | Renderizza su | Spiegazione | 
| --- | --- | --- | --- | 
| \$1\$1\$1\$1field.displayName\$1 | Uguale alla sintassi | Temp \$1Loc="PBI", Sensor="3"\$1 | Visualizza il nome del campo e le etichette, \$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 graffe 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", Sensor="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\$1values\$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="v10-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 tavolozze:


| modalità colore | Description | 
| --- | --- | 
| Colore singolo | Specificate un solo colore, utile in una regola di override | 
| Sfumature di un colore | Seleziona le sfumature di un singolo 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 | 
| Palette classica (in base al nome della serie) | Grafana assegnerà il colore in base al nome della serie. Utile quando i nomi delle serie da visualizzare dipendono dai dati disponibili. | 
| Green-Yellow-Red (per valore) | Combinazione di colori continua | 
| Red-Yellow-Green (per valore) | Combinazione di colori continua | 
| Blue-Yellow-Red (per valore) | Combinazione di colori continua | 
| Giallo-Rosso (per valore) | Schema di colori continuo | 
| Blu-Viola (in base al valore) | Schema di colori continuo | 
| Giallo-Blu (per valore) | Schema di colori continuo | 
| Blues (per valore) | Combinazione di colori continua (sfondo del pannello in blu) | 
| Rossi (per valore) | Combinazione di colori continua (lo sfondo del pannello diventa rosso) | 
| Verdi (per valore) | Combinazione di colori continua (lo sfondo del pannello diventa verde) | 
| Viola (per valore) | Combinazione di colori continua (lo sfondo del pannello diventa viola) | 

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

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

# Configurare una legenda
<a name="v10-panels-configure-legend"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

Le legende sono supportate per le seguenti visualizzazioni:
+ [Grafico a barre](v10-panels-bar-chart.md)
+ [Candeliere](v10-panels-candlestick.md)
+ [Istogramma](v10-panels-histogram.md)
+ [Grafico a torta](v10-panels-piechart.md)
+ [Cronologia dello stato](v10-panels-state-timeline.md)
+ [Cronologia dello stato](v10-panels-status-history.md)
+ [Serie temporali](v10-panels-time-series.md)
+ [Tendenza](v10-panels-trend.md)

Anche [le [geomaps](v10-panels-geomap.md) e le Heatmap](v10-panels-heatmap.md) hanno delle legende, ma offrono solo la possibilità di visualizzare o meno una legenda e non supportano altre opzioni di legenda.

## Opzioni relative alla legenda
<a name="v10-panels-legend-options"></a>

Puoi trovare le seguenti opzioni nella sezione **Legenda** del riquadro di modifica del pannello.

**Nota**  
Non tutte le opzioni elencate si applicano a tutte le visualizzazioni con legende.

**Visibilità**

Imposta se la legenda viene visualizzata o meno. Usa l'interruttore per attivare o disattivare una legenda.

**Mode** (Modalità)

Imposta il formato in cui viene visualizzata la legenda. Scegli tra:
+ **Elenco**
+ **Tabella**

Quando si formatta una legenda come tabella, è possibile che vengano visualizzate anche altre informazioni sulla legenda, ad esempio i valori associati o la posizione in cui si trova nella visualizzazione.

**Posizionamento**

Imposta il punto in cui nella visualizzazione viene visualizzata una legenda. Scegli tra:
+ **In basso**
+ **Right**

**Width** (Larghezza)

Se si imposta la posizione della legenda su **Destra**, l'opzione **Larghezza** diventa disponibile. Lascia il campo vuoto per consentire a Grafana di impostare automaticamente la larghezza della legenda o inserisci un valore nel campo.

**Valori**

È possibile aggiungere più contesto a una visualizzazione aggiungendo serie, valori di dati o [calcoli](v10-panels-calculation-types.md) a una legenda. Puoi aggiungere tutti i valori che desideri. Dopo aver applicato le modifiche, puoi scorrere la legenda per visualizzare tutti i valori.

## Cambiare il colore di una serie
<a name="v10-panels-legend-change-color"></a>

Per impostazione predefinita, Grafana imposta il colore dei dati della serie, ma puoi cambiarli tramite la legenda del pannello.

**Per cambiare il colore di una serie**

1. Vai al pannello che desideri aggiornare.

1. Nella legenda, seleziona la barra dei colori associata alla serie.

1. Seleziona un colore preimpostato nella scheda **Colori** o imposta un colore personalizzato nella scheda **Personalizzato**, utilizzando il selettore o i valori RGB.

1. Salva la dashboard.

## Isolamento dei dati delle serie in una visualizzazione
<a name="v10-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 tramite la legenda, che isola i dati che si desidera visualizzare. **Quando si esegue questa operazione, Grafana crea automaticamente una nuova sovrascrittura nella scheda Sostituisci.**

**Per isolare i dati delle serie in una visualizzazione**

1. Vai al pannello che desideri aggiornare.

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 salvare le modifiche in modo che vengano visualizzate da tutti gli utenti del pannello, salvate la dashboard.

Per tornare alla visualizzazione predefinita che include tutti i dati, fai clic due volte sull'etichetta di una serie.

## Ordinamento delle serie
<a name="v10-panels-legend-sort"></a>

Quando si formatta una legenda come tabella e vi si aggiungono valori, è possibile ordinare le serie nella tabella in base a tali valori.

**Per ordinare le serie**

1. Vai al pannello che desideri aggiornare.

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

1. Dal menu, scegli **Modifica**.

1. Scorri fino alla sezione **Legenda** del riquadro di modifica del pannello.

1. In **Valori**, seleziona il valore o il calcolo che desideri mostrare.

   La legenda ora mostra i valori.

1. Scegli l'intestazione del nome del calcolo nella tabella della legenda per ordinare i valori nella tabella in ordine crescente o decrescente.

**Nota**  
Questa funzionalità è supportata solo in questi pannelli: grafico a barre, istogramma, serie temporali.

# Configurare i collegamenti dati
<a name="v10-panels-configure-data-links"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 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, puoi aggiungere un datalink a uno o due di essi. È inoltre possibile collegare i pannelli utilizzando collegamenti dati.

Il link stesso è accessibile in diversi modi a seconda della visualizzazione. Per la visualizzazione delle serie temporali, ad esempio, si sceglie un punto o una linea di dati. Per visualizzazioni di grandi aree, come stat, gauge o bar gauge, puoi scegliere un punto qualsiasi della visualizzazione per aprire il menu contestuale.

Se nella visualizzazione è presente un solo collegamento dati, scegliendo un punto qualsiasi della visualizzazione si apre il collegamento anziché il menu contestuale.

**Visualizzazioni supportate**
+ Grafico a barre
+ Manometro a barra
+ Candelabro
+ Canvas
+ Gauge
+ Geomappa
+ Mappa termica
+ Istogramma
+ Grafico a torta
+ Stat
+ Cronologia dello stato
+ Cronologia dello stato
+ Tabella
+ Serie temporali
+ Tendenza

## Variabili di collegamento dati
<a name="v10-panels-data-link-variables"></a>

Le variabili nei link dati consentono di indirizzare le persone a una dashboard dettagliata con filtri di dati conservati. Ad esempio, è possibile utilizzare una variabile per specificare un'etichetta, un intervallo di tempo, una serie o una selezione di variabili.

Per visualizzare un elenco di variabili disponibili, digita `$` nel campo **URL** del collegamento dati.

Puoi anche usare variabili modello nei tuoi link dati URLs, vedi[Variabili](v10-dash-variables.md).

### Variabili del pannello dell'intervallo di tempo
<a name="v10-panels-time-range-panel-variables"></a>

Queste variabili consentono di includere l'intervallo di tempo corrente nell'URL del collegamento dati.
+ `__url_time_range`— intervallo di tempo della dashboard corrente (ad es.`?from=now-6h&to=now`)
+ `$__from` – Per ulteriori informazioni, consulta [Variabili globali](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to` – Per ulteriori informazioni, consulta [Variabili globali](v10-dash-variable-add.md#v10-dash-variable-add-global).

### Variabili di serie
<a name="v10-panels-series-variables"></a>

Le variabili specifiche della serie sono disponibili nello `__series` spazio dei nomi:
+ `__series.name`— nome della serie nell'URL

### Variabili di campo
<a name="v10-panels-field-variables"></a>

Le variabili specifiche del campo sono disponibili nello spazio dei nomi`__field`:
+ `__field.name`— il nome del campo
+ `__field.labels.<LABEL>`— il valore dell'etichetta rispetto all'URL. Se l'etichetta contiene punti, usa la `__field.labels["<LABEL>"]` sintassi.

### Variabili di valore
<a name="v10-panels-value-variables"></a>

Le variabili specifiche del valore sono disponibili nello spazio dei nomi`__value`:
+ `__value.time`— data e ora del valore (epoca Unix ms) all'URL (ad es.) `?time=1560268814105`
+ `__value.raw`— valore grezzo
+ `__value.numeric`— rappresentazione numerica di un valore
+ `__value.text`— rappresentazione testuale di un valore
+ `__value.calc`— nome del calcolo se il valore è il risultato del calcolo

L'utilizzo di una variabile con un valore specifico nei collegamenti dati può mostrare risultati diversi a seconda dell'opzione impostata della modalità Tooltip.

### Variabili di dati
<a name="v10-panels-data-variables"></a>

Per accedere ai valori di altri campi usa:
+ `__data.fields[i]`— Valore del campo `i` (sulla stessa riga).
+ `__data.fields["NameOfField"]`— Valore del campo che utilizza il nome anziché l'indice.
+ `__data.fields[i].labels.cluster`— Accedere alle etichette di un altro campo.

### Variabili del modello
<a name="v10-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.

`${var-myvar:queryparam}`— dove `var-myvar` è il nome della variabile modello che corrisponde a quella della dashboard corrente che desideri utilizzare.


| Stato variabile | Risultato nell'URL creato | 
| --- | --- | 
| ha selezionato un valore | var-myvar=value1 | 
| valori multipli selezionati | var-myvar=value1&var-myvar=value2 | 
| selezionato All | var-myvar=All | 

Se desideri aggiungere tutte le variabili della dashboard corrente all'URL, usa`${__all_variables}`.

## Aggiungere un collegamento dati
<a name="v10-panels-add-a-datalink"></a>

Puoi aggiungere collegamenti dati ai tuoi pannelli.

1. Passa al pannello a cui desideri aggiungere il collegamento dati.

1. Passa il mouse sul pannello per visualizzare l'icona del menu nell'angolo in alto a destra.

1. Dal menu, scegliete **Modifica** per aprire l'editor del pannello.

1. Nel riquadro di **modifica del pannello**, scorri verso il basso fino alla sezione **Collegamenti dati** ed espandila.

1. Scegli **Aggiungi link**.

1. Nella finestra di dialogo che si apre, inserisci un **titolo**. Si tratta di un'etichetta leggibile dall'uomo per il collegamento, che verrà visualizzata nell'interfaccia utente.

1. Inserisci l'**URL** o la variabile a cui desideri collegarti.

   Per aggiungere una variabile di collegamento dati, seleziona il campo **URL**, quindi immetti `$` o premi Ctrl\$1Spazio o Cmd\$1Spazio per visualizzare un elenco di variabili disponibili.

1. **Se desideri che il link si apra in una nuova scheda, seleziona Apri in una nuova scheda.**

1. Scegli **Salva** per salvare le modifiche e chiudere la finestra di dialogo.

1. Salva le modifiche nella dashboard.

# Configurare le mappature dei valori
<a name="v10-panels-configure-value-mappings"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 la modalità di visualizzazione dei dati.

Le mappature dei valori ignorano la formattazione delle unità impostata nelle [opzioni standard](v10-panels-configure-standard-options.md) dell'editor dei pannelli, come il colore o il numero di posizioni decimali visualizzate. Quando le mappature dei valori sono presenti in un pannello, Grafana ne visualizza un riepilogo nella sezione **Mappature dei valori** dell'editor dei pannelli.

**Visualizzazioni supportate**
+ Grafico a barre
+ Manometro a barra
+ Candelabro
+ Canvas
+ Gauge
+ Geomappa
+ Istogramma
+ Grafico a torta
+ Stat
+ Cronologia dello stato
+ Cronologia dello stato
+ Tabella
+ Serie temporali
+ Tendenza

## Tipi di mappature dei valori
<a name="v10-panels-value-mappings-types"></a>

Grafana supporta i seguenti tipi di mappatura dei valori:
+ **Valore**: associa valori specifici a un testo e a un colore. Ad esempio, è possibile configurare una mappatura dei valori in modo che tutte le istanze del valore `10` appaiano come `Perfection!` anziché come numeri. Utilizzate una mappatura dei **valori** quando desiderate formattare un singolo valore.
+ **Intervallo**: associa gli intervalli numerici al testo e a un colore. Ad esempio, se un valore rientra in un determinato intervallo, è possibile configurare una mappatura dei valori dell'intervallo per visualizzare `Low` o `High` anziché il numero. Usa la mappatura degli **intervalli** quando desideri formattare più valori continui.
+ **Regex**: mappa le espressioni regolari su testo e colore. 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. Usa la mappatura **Regex** quando desideri formattare il testo e il colore di un valore di espressione regolare.
+ **Speciale**: mappa valori speciali come`Null`, `NaN` (non un numero) e valori booleani come e su un testo `true` e `false` un colore. Ad esempio, è possibile configurare una mappatura di valori speciale in modo che `null` i valori appaiano come. `N/A` Usa la mappatura **speciale** quando desideri formattare valori non comuni, booleani o vuoti.

## Aggiungere una mappatura dei valori
<a name="v10-panels-value-mappings-add"></a>

Puoi aggiungere mappature di valore ai tuoi pannelli.

**Per aggiungere una mappatura dei valori**

1. Vai al pannello che desideri aggiornare.

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

1. Dal menu, scegli **Modifica**.

1. Nella sezione **Mappature dei valori**, scegli **Aggiungi mappature di valore**.

1. Scegli **Aggiungi una nuova mappatura**, quindi seleziona una delle seguenti opzioni:
   + **Valore**: inserisci un singolo valore da abbinare.
   + **Intervallo**: inserisci i valori iniziale e finale di un intervallo da abbinare.
   + **Regex**: immetti un modello di espressione regolare da abbinare.
   + **Speciale**: scegli un valore speciale da abbinare.

1. (Facoltativo) Immettete il testo visualizzato.

1. (Facoltativo) Imposta il colore.

1. Scegliete **Aggiorna** per salvare la mappatura dei valori.

**Dopo aver aggiunto una mappatura, il pulsante **Modifica mappature di valori sostituisce il pulsante Aggiungi mappature di valore**.** Scegli il pulsante Modifica per aggiungere o aggiornare le mappature.

# Configurare le soglie
<a name="v10-panels-configure-thresholds"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Nei dashboard, una soglia è un valore o limite impostato per una metrica che viene riflessa visivamente quando viene raggiunta o superata. Le soglie sono un modo per applicare stili e colori alle visualizzazioni in modo condizionale in base ai risultati delle query.

È possibile utilizzare le soglie per:
+ Le linee colorate della griglia o le aree della griglia in una visualizzazione di serie temporali.
+ Colora lo sfondo o il testo del valore in una visualizzazione statistica.
+ Definisci le regioni e i colori delle regioni in una sequenza temporale dello stato.
+ Linee di colore in una visualizzazione di serie temporali.
+ Colora l'indicatore e gli indicatori di soglia in un indicatore.
+ Indicatori a colori in una geomappa.
+ Colora il testo o lo sfondo delle celle in una tabella.

**Visualizzazioni supportate**
+ Grafico a barre
+ Manometro a barra
+ Candelabro
+ Canvas
+ Gauge
+ Geomappa
+ Istogramma
+ Stat
+ Cronologia dello stato
+ Cronologia dello stato
+ Tabella
+ Serie temporali
+ Tendenza

## Soglie predefinite
<a name="v10-panels-thresholds-default"></a>

Nelle visualizzazioni che supportano le soglie, Grafana ha le seguenti impostazioni di soglia predefinite:
+ 80 = rosso
+ Base = verde
+ Modalità = Assoluta
+ Mostra soglie = Disattivata (per alcune visualizzazioni)

  Per ulteriori informazioni, consulta [Mostra le soglie](#v10-panels-thresholds-show).

## Opzioni relative alle soglie
<a name="v10-panels-thresholds-options"></a>

È possibile impostare le seguenti opzioni per definire ulteriormente l'aspetto delle soglie.

### Valore delle soglie
<a name="v10-panels-thresholds-value"></a>

Questo numero è il valore che attiva la soglia. In questo campo puoi anche impostare il colore associato alla soglia.

Il valore **di base** rappresenta l'infinito negativo. Per impostazione predefinita, è impostato sul colore verde, che in genere è il colore «buono».

### modalità Soglie
<a name="v10-panels-thresholds-mode"></a>

Esistono due modalità di soglia:
+ 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.

### Mostra le soglie
<a name="v10-panels-thresholds-show"></a>

**Nota**  
Questa opzione è supportata solo per il grafico a barre, il candeliere, le serie temporali e le visualizzazioni delle tendenze.

Imposta se e come vengono mostrate le soglie nella visualizzazione con le seguenti opzioni.
+ **Disattivato**: le soglie non vengono visualizzate.
+ **Come linee: le** soglie vengono visualizzate come linee orizzontali nella visualizzazione.
+ **Come linee (tratteggiate)**: le soglie vengono visualizzate come linee orizzontali tratteggiate.
+ **Come regioni piene: le** soglie vengono visualizzate come regioni orizzontali.
+ **Come regioni e linee piene: le** soglie vengono visualizzate come regioni orizzontali separate da linee.
+ **Come regioni e linee piene (tratteggiate)**: le soglie vengono visualizzate come regioni orizzontali separate da linee tratteggiate.

## Aggiungere una soglia
<a name="v10-panels-thresholds-add"></a>

Puoi aggiungere tutte le soglie che desideri a una visualizzazione. Grafana ordina automaticamente i valori delle soglie dal più alto al più basso.

**Per aggiungere una soglia**

1. Vai al pannello che desideri aggiornare.

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

1. Dal menu, seleziona **Modifica**.

1. Scorri fino alla sezione **Soglie** o accedi `Thresholds` nella barra di ricerca nella parte superiore del riquadro di modifica del pannello.

1. Scegli **\$1 Aggiungi soglia**.

1. Inserisci un nuovo valore di soglia o usa le frecce su e giù sul lato destro del campo per aumentare o diminuire il valore in modo incrementale.

1. Fate clic sul cerchio colorato a sinistra del valore di soglia per aprire il selettore dei colori, in cui è possibile aggiornare il colore della soglia.

1. **In **modalità Soglie**, selezionate **Assoluto** o Percentuale.**

1. In **Mostra soglie**, imposta la modalità di visualizzazione della soglia o disattivala.

Per eliminare una soglia, accedi al pannello che contiene la soglia e scegli l'icona del cestino accanto alla soglia che desideri rimuovere.

# Configura le sostituzioni dei campi
<a name="v10-panels-configure-overrides"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 `bytes` aggiungendo un override utilizzando il matcher **regex Fields with name matching** e quindi si aggiunge l'opzione Unit alla regola di sostituzione.

## Esempio 1: temperatura del formato
<a name="v10-panels-overrides-format-temperature"></a>

Supponiamo che il nostro set di risultati sia un frame di dati composto da due campi: `time` e`temperature`.


| 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="v10-panels-overrides-format-humidity"></a>

Supponiamo che il nostro set di risultati sia un frame di dati composto da quattro campi: `time``high temp`,`low temp`, e`humidity`.


| 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% | 

## Aggiungere una sovrascrittura di campo
<a name="v10-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.

**Per aggiungere una sovrascrittura dei campi**

1. Modifica il pannello a cui desideri aggiungere un'eccezione.

1. Nel riquadro laterale delle opzioni del pannello, scegli **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 con espressione regolare corrispondente al nome:** specifica 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. [Questo seleziona i campi da sovrascrivere, ma non rinomina i campi; a tale scopo, usa la trasformazione Rename by regex.](v10-panels-xform-functions.md)
   + **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. Scegliete **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 scegliendo **Aggiungi proprietà di sostituzione** oppure puoi scegliere **Aggiungi sostituzioni e selezionare un campo diverso a cui aggiungere sostituzioni**.

1. Al termine, scegli **Salva per salvare tutte le modifiche** al pannello nella dashboard.

## L'eliminazione di un campo sostituisce
<a name="v10-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.

**Per eliminare un campo, sovrascrivi**

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. Scegli l'override che desideri eliminare, quindi scegli l'icona del cestino associata.

## Sostituzioni dei campi di visualizzazione
<a name="v10-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.

**Nota**  
**Le impostazioni di sostituzione visualizzate nella scheda **Tutte** sono uguali a quelle visualizzate nella scheda Sostituzioni.**

## Modificare l'override di un campo
<a name="v10-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.

**Per modificare un campo, sovrascrivi**

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.
   + Elimina le proprietà di override esistenti scegliendo la **X** accanto alla proprietà.
   + Aggiungi una proprietà sostitutiva selezionando **Aggiungi proprietà sostitutiva.**

# Visualizzazioni disponibili nella versione 10 di Grafana
<a name="v10-panels-viz"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 le visualizzazioni integrate, le relative opzioni e l'utilizzo tipico.

Un pannello comune da cui iniziare e per apprendere le nozioni di base sull'uso dei pannelli è il pannello. [Serie temporali](v10-panels-time-series.md)

**Nota**  
Se non sei sicuro di quale visualizzazione scegliere, Grafana può fornire suggerimenti di visualizzazione basati sulla query del pannello. Quando si seleziona una visualizzazione, Grafana mostrerà un'anteprima con quella visualizzazione applicata.
+ Grafici e diagrammi
  + La [serie temporale](v10-panels-time-series.md) è la visualizzazione predefinita e principale del grafico.
  + [Cronologia dello stato](v10-panels-state-timeline.md) per i cambiamenti di stato nel tempo.
  + [Cronologia dello stato](v10-panels-status-history.md) periodico nel tempo.
  + [Il grafico a barre](v10-panels-bar-chart.md) mostra tutti i dati categoriali.
  + [L'istogramma](v10-panels-histogram.md) calcola e mostra la distribuzione dei valori in un grafico a barre.
  + [Heatmap](v10-panels-heatmap.md) visualizza i dati in due dimensioni, utilizzate tipicamente per l'entità di un fenomeno.
  + Il [grafico a torta](v10-panels-piechart.md) viene in genere utilizzato laddove la proporzionalità è importante.
  + [Candlestick](v10-panels-candlestick.md) è in genere utilizzato per i dati finanziari in cui l'attenzione è rivolta al movimento. price/data 
  + Il [calibro](v10-panels-gauge.md) è la tradizionale immagine arrotondata che mostra la distanza di una singola metrica da una soglia.
  + [Tendenza](v10-panels-trend.md) per i set di dati che hanno una x numerica sequenziale diversa dal tempo.
  + [XY Chart](v10-panels-xychart.md) offre un modo per visualizzare valori x e y arbitrari in un grafico.
+ Statistiche e numeri
  + [Stat](v10-panels-stat.md) per statistiche importanti e sparkline opzionale.
  + [Il manometro è un indicatore a barre](v10-panels-bar-gauge.md) orizzontale o verticale.
+ Misc (Vari)
  + La [tabella](v10-panels-table.md) è la visualizzazione principale e unica della tabella.
  + [Logs](v10-panels-logs.md) è la visualizzazione principale per i log.
  + [Grafo a nodi](v10-panels-node-graph.md) per grafici o reti diretti.
  + [Traces](v10-panels-traces.md) è la visualizzazione principale per le tracce.
  + [Flame graph](v10-panels-flamegraph.md) è la visualizzazione principale per la profilazione.
  + [Geomap](v10-panels-geomap.md) ti aiuta a visualizzare i dati geospaziali.
  + [Datagrid](v10-panels-datagrid.md) consente di creare e manipolare dati e funge da fonte di dati per altri pannelli.
+ Widget
  + L'[elenco dei dashboard può elencare](v10-panels-dashboard-list.md) i dashboard.
  + [L'elenco degli avvisi può elencare](v10-panels-alert-list.md) gli avvisi.
  + [Il testo](v10-panels-text.md) può mostrare markdown e html.
  + [Le notizie](v10-panels-news.md) possono mostrare feed RSS.

## Ottieni di più
<a name="v10-panels-getmore"></a>

Puoi aggiungere altri tipi di visualizzazione installando i plugin del pannello da. [Trova i plugin con il catalogo dei plugin](grafana-plugins.md#plugin-catalog)

## Esempi
<a name="v10-panels-examples"></a>

Nelle sezioni seguenti puoi trovare esempi di visualizzazioni.

## Grafi
<a name="v10-panels-ex-graphs"></a>

Per i grafici a linee, ad area e a barre basati sul tempo, consigliamo la visualizzazione predefinita delle [serie temporali](v10-panels-time-series.md).

![\[Un'immagine che mostra esempi di visualizzazioni di serie temporali in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/time_series_example.png)


[Per i dati categoriali, usa un grafico a barre.](v10-panels-bar-chart.md)

![\[Un'immagine che mostra esempi di visualizzazioni di grafici a barre in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/barchart_example.png)


## Grandi numeri e statistiche
<a name="v10-panels-ex-numbers"></a>

Una visualizzazione [statistica](v10-panels-stat.md) mostra un valore statistico di grandi dimensioni con un grafico sparkline opzionale. È possibile controllare lo sfondo o il colore del valore utilizzando soglie o scale di colori.

![\[Un'immagine che mostra un esempio di visualizzazione delle statistiche in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/stat_panel_example.png)


## Gauge
<a name="v10-panels-ex-gauge"></a>

Se vuoi presentare un valore in relazione a un valore minimo e massimo, hai due opzioni. [Innanzitutto un calibro radiale standard:](v10-panels-gauge.md)

![\[Un'immagine che mostra un esempio di visualizzazione del calibro in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/gauge_example.png)


In secondo luogo, Grafana ha anche un [indicatore a barre](v10-panels-bar-gauge.md) orizzontale o verticale con tre modalità di visualizzazione distinte.

![\[Un'immagine che mostra un esempio di visualizzazione del calibro in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Tabella
<a name="v10-panels-ex-table"></a>

[Per mostrare i dati in un layout tabellare, usa una visualizzazione tabellare.](v10-panels-table.md)

![\[Un'immagine che mostra un esempio di visualizzazione di tabella in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/table_example.png)


## Grafico a torta
<a name="v10-panels-ex-piechart"></a>

Per visualizzare serie ridotte, o valori di una serie, di una o più interrogazioni, in relazione tra loro, utilizza una visualizzazione a [torta](v10-panels-piechart.md).

![\[Un'immagine che mostra un esempio di visualizzazione di un grafico a torta in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/pie_chart_example.png)


## Mappe di calore
<a name="v10-panels-ex-heatmaps"></a>

Per mostrare la distribuzione del valore nel tempo, utilizza una visualizzazione con mappa [termica](v10-panels-heatmap.md).

![\[Un'immagine che mostra un esempio di visualizzazione della mappa termica in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Cronologia dello stato
<a name="v10-panels-ex-state"></a>

Una [cronologia dello stato](v10-panels-state-timeline.md) mostra i cambiamenti di stato discreti nel tempo. Se utilizzate con le serie temporali, le soglie vengono utilizzate per trasformare i valori numerici in regioni statali discrete.

![\[Un'immagine che mostra un esempio di visualizzazione della sequenza temporale dello stato in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/state_timeline_example.png)


# Elenco avvisi
<a name="v10-panels-alert-list"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 gli elenchi di avvisi per visualizzare i tuoi avvisi. È possibile configurare l'elenco per mostrare lo stato corrente. Per ulteriori informazioni sugli avvisi, vedere[Avvisi nella versione 10 di Grafana](v10-alerts.md).

Utilizza queste impostazioni per perfezionare la visualizzazione.

## Opzioni
<a name="v10-panels-alert-list-options"></a>
+ **Modalità di gruppo**: scegli tra il **raggruppamento predefinito** per mostrare le istanze di avviso raggruppate in base alla relativa regola di avviso e il **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
  + **Ora (asc)**: vengono innanzitutto le istanze di avviso attive più recenti.
  + **Ora (desc)**: vengono visualizzate per prime le istanze di avviso attive più vecchie.
+  **Avvisi da questa dashboard**: mostra gli avvisi solo dalla dashboard in cui si trova l'elenco degli avvisi.

## Filtro
<a name="v10-panels-alert-filter"></a>

Queste opzioni consentono di limitare gli avvisi visualizzati solo a quelli che corrispondono alla query, alla cartella o ai tag scelti:
+ **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="v10-panels-alert-state-filter"></a>

Scegli quali stati di avviso visualizzare in questo pannello.
+ Avvisi/ Attivazione
+ Pending (In attesa)
+ Nessun dato
+ Normale
+ Errore

# Elenco delle annotazioni
<a name="v10-panels-annotations"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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'elenco delle 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="v10-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="v10-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 sulla visualizzazione stessa.

## Comportamento dei link
<a name="v10-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.

# Grafico a barre
<a name="v10-panels-bar-chart"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 grafici a barre consentono di rappresentare graficamente dati categoriali.

![\[Un'immagine che mostra esempi di visualizzazioni di grafici a barre in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/barchart_example.png)


## Formati di dati supportati
<a name="v10-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="v10-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="v10-panels-bar-chart-options"></a>

Usa queste opzioni per affinare la visualizzazione.

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

**Ruota le etichette di spunta sull'asse x**

 Quando il grafico è orientato verticalmente, questa impostazione ruota le etichette sotto le barre. Questa impostazione è utile quando le etichette dei grafici a barre sono lunghe e si sovrappongono.

**Lunghezza massima dell'etichetta di spunta sull'asse X**

Imposta la lunghezza massima delle etichette dei grafici a barre. Le etichette più lunghe della lunghezza massima vengono troncate con ellissi.

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

**Larghezza del gruppo**

Controlla la larghezza dei gruppi.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Larghezza della barra**

Controlla la larghezza delle barre.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Raggio della barra**

Controlla il raggio delle barre.
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**Evidenzia l'intera area al passaggio del mouse**

Controlla se l'intera area circostante della barra viene evidenziata quando passi il mouse sopra la barra.

**Larghezza della linea**

Controlla la larghezza delle linee delle barre.

**Riempi l'opacità**

Controlla l'opacità di riempimento delle barre.

**modalità Gradiente**

Imposta la modalità del riempimento a 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 le descrizioni dei comandi. 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.

**Dimensione del testo**

Inserisci un valore per modificare la dimensione del testo sul grafico a barre.

## Opzioni relative alla legenda
<a name="v10-panels-bar-chart-legend"></a>

**modalità Legend**

Utilizza queste impostazioni per definire come appare la legenda nella visualizzazione. Per ulteriori informazioni, consulta [Configurare una legenda](v10-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 posizionare la legenda.
+ **In basso**: sotto il grafico.
+ A **destra**: a destra del grafico.

**Valori della legenda**

Scegli i valori dei dati delle serie o i calcoli standard da mostrare nella legenda. Puoi averne più di uno. Per ulteriori informazioni, consulta [Configurare una legenda](v10-panels-configure-legend.md).

## Opzioni dell'asse
<a name="v10-panels-bar-chart-axis"></a>

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

Per nascondere selettivamente gli assi, l'[aggiunta di campi sostituisce quelli destinati a campi specifici.](v10-panels-configure-overrides.md)

**Etichetta**

Imposta un'etichetta di testo sull'asse Y. Se hai più di un asse Y, puoi assegnare etichette diverse con un'eccezione.

**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. 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 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 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. Per ulteriori informazioni, consulta [Configurazione delle opzioni standard](v10-panels-configure-standard-options.md).

**Visualizza più assi y**

In alcuni casi, potresti voler visualizzare più assi y. Ad esempio, se disponi di un set di dati che mostra sia la temperatura che l'umidità nel tempo, potresti voler mostrare due assi y con unità diverse per queste due serie.

Puoi farlo [aggiungendo](v10-panels-configure-overrides.md) sostituzioni di campo. Segui i passaggi tutte le volte necessarie per aggiungere tutti gli assi y necessari.

# Manometro a barra
<a name="v10-panels-bar-gauge"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 indicatori a barre semplificano 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.

![\[Un'immagine che mostra un esempio di visualizzazione del calibro a barre in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Opzioni di valore
<a name="v10-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 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 Tipi di [calcolo](v10-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.

## Opzioni relative agli indicatori a barre
<a name="v10-panels-bar-gauge-options"></a>

Regola la modalità di visualizzazione dell'indicatore a barra.

**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, 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.

**Visualizzazione dei valori**

Scegli una modalità di visualizzazione dei valori.
+ **Colore del valore**: il colore del valore è determinato dal valore.
+ **Colore del testo**: il colore del valore è il colore del testo predefinito.
+ **Nascosto**: i valori sono nascosti.

**Posizionamento del nome**

Scegli una modalità di posizionamento del nome.

**Nota**  
Questa opzione si applica solo quando l'orientamento del manometro è orizzontale. Quando l'indicatore a barre è orientato in verticale, i nomi vengono sempre posizionati nella parte inferiore di ogni indicatore di barra.
+ **Automatico**: Grafana determina il posizionamento migliore.
+ **In alto**: i nomi vengono posizionati sulla parte superiore di ogni indicatore a barre.
+ **A sinistra**: i nomi vengono posizionati a sinistra di ogni indicatore a barre.

**Mostra l'area vuota**

Seleziona questa opzione se desideri rendere la regione vuota delle barre in grigio scuro. Non applicabile alla modalità di visualizzazione LCD retrò.

**Dimensione della barra**

Scegli una modalità di dimensione della barra.
+ **Automatico**: Grafana determina la dimensione migliore del calibro a barre.
+ **Manuale**: configura manualmente la dimensione dell'indicatore a barra.

**Larghezza minima**

Limita la larghezza minima della colonna della barra quando l'indicatore è orientato verticalmente.

Mostra automaticamente la barra di scorrimento dell'asse x quando c'è una grande quantità di dati.

**Nota**  
Questa opzione si applica solo quando la dimensione della barra è impostata su manuale.

**Altezza minima**

Limita l'altezza minima della fila di barre quando l'indicatore è orientato orizzontalmente.

Mostra automaticamente la barra di scorrimento dell'asse y quando c'è una grande quantità di dati.

**Nota**  
Questa opzione si applica solo quando la dimensione della barra è impostata su manuale.

**Altezza massima**

Limita l'altezza massima della fila di barre quando l'indicatore è orientato orizzontalmente.

Mostra automaticamente la barra di scorrimento dell'asse y quando c'è una grande quantità di dati.

**Nota**  
Questa opzione si applica solo quando la dimensione della barra è impostata su manuale.

# Candelabro
<a name="v10-panels-candlestick"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 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.

![\[Un'immagine che mostra un esempio di visualizzazione a candela in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


Le visualizzazioni a candela si basano su e includono molte impostazioni di configurazione comuni. [Serie temporali](v10-panels-time-series.md)

## Modalità
<a name="v10-panels-candlestick-mode"></a>

Le opzioni della modalità consentono di attivare o disattivare le dimensioni utilizzate per la visualizzazione.
+ **Candele**: limita le dimensioni del pannello alle dimensioni di apertura, altezza, altezza minima e chiusura utilizzate dalle visualizzazioni a candela.
+ **Volume**: limita la dimensione del pannello alla dimensione del volume.
+ **Entrambi**: il comportamento predefinito per il pannello a candele. Include visualizzazioni sia a candele che a volume.

## Stile a candela
<a name="v10-panels-candlestick-style"></a>
+ **Candele**: lo stile di visualizzazione predefinito, crea visualizzazioni a forma di candela tra le dimensioni di apertura e chiusura.
+ **Barre OHLC**: visualizzano i valori di apertura, massimo, minimo e chiusura delle quattro dimensioni principali.

## Strategia del colore
<a name="v10-panels-candlestick-color"></a>
+ **Since 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*.
+ **Since Prior Close**: un metodo di visualizzazione alternativo in cui il colore della candela si basa sul movimento dei prezzi o sulla variazione di valore tra periodi. 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
<a name="v10-panels-candlestick-updown"></a>

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
<a name="v10-panels-candlestick-ohlc"></a>

Il pannello a forma di candela tenterà di mappare i campi alla dimensione appropriata.
+ **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 specificato. (ad esempio numero di operazioni)

**Nota**  
La legenda del candeliere non mostra questi valori.

Per mappare correttamente queste dimensioni, la tabella dei risultati delle interrogazioni basata sui dati deve includere *almeno* le seguenti colonne.
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

Se per qualche motivo non è possibile mappare i dati a queste dimensioni (ad esempio, perché i nomi delle colonne non sono gli stessi), puoi mapparli manualmente utilizzando i campi **Apri**, **Alto**, **Basso** e **Chiudi nelle** opzioni **Candlestick** nell'editor del pannello.

## Campi aggiuntivi
<a name="v10-panels-candlestick-other"></a>

**Campi aggiuntivi**

Il pannello a candela si basa sulla visualizzazione delle serie temporali. Può visualizzare dimensioni di dati aggiuntive oltre a quelle di apertura, massima, bassa, chiusura e volume. Le opzioni **Includi** e **Ignora** consentono di visualizzare altri dati inclusi, come medie mobili semplici, bande di Bollinger e altro, utilizzando gli stessi stili e configurazioni disponibili in. [Serie temporali](v10-panels-time-series.md)

# Canvas
<a name="v10-panels-canvas"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 tele combinano la potenza di Grafana con la flessibilità degli elementi personalizzati. Le tele sono pannelli estensibili costruiti su misura 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="v10-panels-canvas-elements"></a>

Puoi aggiungere questi elementi sulla tua tela. L'aggiunta di più e diversi tipi di elementi consente di personalizzare una visualizzazione in modi che non sono possibili con nessun'altra visualizzazione.

**Valore del parametro**

L'elemento con valore metrico consente di selezionare facilmente i dati che si desidera visualizzare sull'area di disegno. Questo elemento ha una modalità di *modifica* unica che può essere attivata tramite l'opzione **Modifica** del menu contestuale o facendo doppio clic sul pannello. 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.

**Ellisse**

L'elemento ellisse consente di aggiungere un'ellisse di base alla tela. Un elemento ellittico può visualizzare testo (sia dati fissi che dati di campo) e il suo colore di sfondo può essere modificato in base alle soglie di dati.

**Rettangolo**

L'elemento rettangolare consente di aggiungere un rettangolo di base alla tela. Gli elementi rettangolari possono visualizzare testo (sia dati fissi che dati di campo) e il colore di sfondo può essere modificato in base alle soglie di dati.

**Icona**

L'elemento icona consente di aggiungere un'icona supportata all'area di disegno. Le icone possono avere i loro colori impostati in base a soglie o mappature di valori.

**Server**

L'elemento server consente di rappresentare facilmente un singolo server, una pila di server, un database o un terminale. Gli elementi del server supportano il colore di stato, il colore della lampadina e la frequenza di lampeggiamento della lampadina, tutti configurabili tramite valori fissi o di campo.

**Button**

L'elemento button consente di aggiungere un pulsante di base all'area di disegno. Gli elementi del pulsante supportano l'attivazione di chiamate API di base non autenticate. Le impostazioni API si trovano nell'editor degli elementi del pulsante. Puoi anche passare variabili di modello nell'editor API.

**Nota**  
La scelta di un pulsante attiverà una chiamata API solo quando la modifica in linea è disabilitata. Per informazioni, consulta [Modifica della tela](#v10-panels-canvas-editing).

## Connessioni
<a name="v10-panels-canvas-connections"></a>

Quando si crea una tela, è possibile collegare gli elementi tra loro per creare visualizzazioni più complesse. È possibile creare connessioni trascinandole dall'ancoraggio di connessione di un elemento all'ancoraggio di connessione di un altro elemento. È inoltre possibile creare connessioni con lo sfondo dell'area di disegno. Gli ancoraggi di connessione vengono visualizzati quando si passa il mouse su un elemento e la modifica in linea è attivata. Per rimuovere una connessione, selezionatela e premete o. `Delete` `Backspace`

È possibile impostare sia la dimensione che il colore delle connessioni in base a valori fissi o di campo. Per farlo, accedete alla modalità di modifica del pannello, selezionate la connessione e modificate le proprietà della connessione nell'editor del pannello.

## Modifica della tela
<a name="v10-panels-canvas-editing"></a>

**Editor in linea**

Puoi modificare l'area di disegno in linea mentre ti trovi nel contesto della modalità dashboard.

**Panoramica e zoom**

Tu e attivate il panning e lo zoom in un'area di disegno. Ciò consente sia di creare che di navigare tra progetti più complessi.

**Nota**  
La panoramica e lo zoom sono attualmente disponibili in anteprima presso Grafana Labs. Il supporto è limitato e potrebbero verificarsi modifiche sostanziali prima della disponibilità generale.

**Menu contestuale**

Il menu contestuale consente di eseguire attività comuni in modo rapido ed efficiente. 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 (o equivalente) 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 all'area di disegno.

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="v10-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.

**Collegamenti dati**

Le tele supportano [i collegamenti dati](v10-panels-configure-data-links.md). È possibile creare un collegamento dati per un elemento con valore metrico e visualizzarlo per tutti gli elementi che utilizzano il nome del campo seguendo questi passaggi.

**Per creare un collegamento dati per un elemento**

1. Imposta un elemento da collegare a un valore di campo.

1. Disattiva l'interruttore di modifica in linea.

1. Crea una sovrascrittura per **Fields with name e seleziona il nome** del campo dell'elemento dall'elenco.

1. Scegliete il **pulsante della proprietà \$1 Add override**.

1. Seleziona **Datalinks > Datalinks** dall'elenco.

1. Scegli **\$1 Aggiungi link, aggiungi** un titolo e un URL per il link dati.

1. Passa il mouse sull'elemento per visualizzare il tooltip del collegamento dati.

1. Scegli l'elemento per poter aprire il collegamento dati.

Se più elementi utilizzano lo stesso nome di campo e desideri controllare quali elementi visualizzano il collegamento dati, puoi creare un nome di campo univoco utilizzando la [Aggiungi campo dal calcolo](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) trasformazione. L'alias che crei nella trasformazione apparirà come un campo che puoi usare con un elemento.

# Elenco dashboard
<a name="v10-panels-dashboard-list"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 elenchi di dashboard consentono di visualizzare collegamenti dinamici ad altri 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.
+ **Includi intervallo di tempo corrente**: seleziona questa opzione per propagare l'intervallo di tempo della dashboard corrente ai link del dashboard. Quando l'utente seleziona un link, la dashboard collegata si apre con l'intervallo di tempo indicato già impostato.
+ **Includi i valori delle variabili del modello correnti**: selezionate questa opzione per includere le variabili di modello attualmente utilizzate come parametri di interrogazione in un link. Quando l'utente seleziona un link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori dell'elenco. Per ulteriori informazioni, consulta [Variabili URL del pannello di controllo](v10-dash-dashboard-url-variables.md).
+ **Specializzato**: mostra le dashboard contrassegnate 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. Devi 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.

# Datagrid
<a name="v10-panels-datagrid"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

**Nota**  
La visualizzazione della griglia di dati è attualmente disponibile in anteprima da Grafana Labs. Il supporto è limitato e potrebbero verificarsi modifiche sostanziali prima della disponibilità generale.

Datagrids ti offre la possibilità di creare, modificare e perfezionare i dati all'interno di Grafana. Pertanto, questo pannello può fungere da fonte di dati per altri pannelli all'interno di una dashboard.

![\[Un'immagine che mostra un esempio di visualizzazione datagrid in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


Grazie a essa, puoi manipolare i dati richiesti da qualsiasi fonte di dati, puoi iniziare da una lavagna vuota o puoi estrarre i dati da un file trascinato e rilasciato. È quindi possibile utilizzare il pannello come semplice visualizzazione tabulare oppure modificare i dati, e persino rimuoverli del tutto, per creare una tabula rasa.

La modifica del set di dati modifica l'origine dati per utilizzare l'origine dati **Grafana** integrata, sostituendo le vecchie impostazioni dell'origine dati e le relative query, copiando anche il set di dati corrente nel modello di dashboard.

È quindi possibile utilizzare il pannello come fonte di dati per altri pannelli, utilizzando l'origine dati integrata **Dashboard** per estrarre i dati datagrid. Ciò offre un'esperienza di dashboard interattiva, in cui è possibile modificare i dati e visualizzare le modifiche riflesse negli altri pannelli.

Per ulteriori informazioni sulle fonti di dati **Grafana** e **Dashboard**, vedere. [Fonti di dati speciali](AMG-data-sources.md#AMG-data-sources-special)

## Menu contestuale
<a name="v10-panels-datagrid-context"></a>

Per offrire un'esperienza più semplificata, il datagrid dispone di un menu contestuale a cui è possibile accedere facendo clic con il pulsante destro del mouse su una cella, un'intestazione di colonna o un selettore di riga. A seconda dello stato del datagrid, il menu contestuale offre diverse opzioni, tra cui le seguenti.
+ Elimina o cancella tutte le righe e le colonne.
+ Rimuovi tutti i dati esistenti (rendendo il datagrid vuoto).
+ Attiva la funzionalità di ricerca, che consente di trovare parole chiave all'interno del set di dati.

L'eliminazione di una riga o di una colonna rimuoverà i dati dal datagrid, mentre la cancellazione di una riga o di una colonna rimuoverà solo i dati dalle celle, lasciando intatta la riga o la colonna.

**Menu dell'intestazione**

Puoi anche accedere a un menu di intestazione scegliendo l'icona a discesa accanto al titolo dell'intestazione. Da qui, non solo puoi eliminare o cancellare una colonna, ma anche rinominarla, bloccarla o convertire il tipo di campo della colonna.

## Selezione delle serie
<a name="v10-panels-datagrid-selectseries"></a>

Se sono presenti più serie, puoi impostare il datagrid per visualizzare il set di dati preferito utilizzando il menu a discesa **Seleziona serie** nelle opzioni del pannello.

## Usare i datagrids
<a name="v10-panels-datagrid-using"></a>

I datagrid offrono vari modi di interagire con i dati. Puoi modificare, spostare, cancellare e rimuovere righe e colonne; utilizzare la funzionalità di ricerca integrata per trovare dati specifici; convertire tipi di campo o bloccare lo scorrimento orizzontale su una colonna specifica.

**Aggiungere dati**

È possibile aggiungere dati a un datagrid creando una nuova colonna o riga.

**Per aggiungere una nuova colonna**

1. In un pannello esistente, scegliete il pulsante **\$1** nell'intestazione della tabella dopo l'ultima colonna.

1. Aggiungete un nome per la nuova colonna.

1. Seleziona un punto qualsiasi all'esterno del campo o premi `Enter` per salvare la colonna.

Ora puoi aggiungere dati in ogni cella.

Per aggiungere una nuova riga, scegli un pulsante **\$1** dopo l'ultima riga. Il pulsante è presente in ogni cella dopo l'ultima riga e selezionandolo si attiva la creazione di una nuova riga e si attiva anche la cella scelta.

**Modifica dei dati**

È possibile spostare colonne e righe in base alle esigenze.

**Per spostare una colonna**

1. Tieni premuta l'intestazione della colonna che deve essere spostata.

1. Trascina la colonna nella posizione desiderata.

1. Rilascia la colonna per completare lo spostamento.

Per spostare una riga, selezionate e tenete premuto il selettore di riga dalla colonna numerica situata all'estrema sinistra della griglia e trascinatelo nella posizione desiderata. Rilascia la riga per completare lo spostamento.

**Selezione di più celle**

Puoi selezionare più celle scegliendo una singola cella e trascinandola sulle altre. Questa selezione può essere utilizzata per copiare i dati dalle celle selezionate o per eliminarli utilizzando la `Delete` chiave.

**Eliminazione o cancellazione di più righe o colonne**

Per eliminare o cancellare più righe, puoi fare quanto segue.

**Per eliminare o cancellare più righe o colonne**

1. Passa il mouse sulla colonna numerica (a sinistra della prima colonna della griglia) per visualizzare la casella di controllo della riga.

1. Seleziona le caselle di controllo relative alle righe con cui vuoi lavorare. Per selezionare più righe consecutive, tieni premuto il `Shift` tasto mentre fai clic sulla prima e sull'ultima riga. Per selezionare righe non consecutive, tenete premuto il tasto `Ctrl` (o`Cmd`) mentre fate clic sulle righe desiderate.

1. Fate clic con il pulsante destro del mouse (o equivalente) per accedere al menu contestuale.

1. **Seleziona **Elimina righe o Cancella righe.****

Le stesse regole si applicano alle colonne facendo clic sulle intestazioni delle colonne.

Per eliminare tutte le righe, utilizza la casella di controllo **Seleziona tutto** nell'angolo in alto a sinistra del datagrid. Questo seleziona tutte le righe e ti consente di eliminarle utilizzando il menu contestuale.

# Grafico della fiamma
<a name="v10-panels-flamegraph"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 grafici Flame consentono di visualizzare i dati di profilazione. Utilizzando questa visualizzazione, il profilo può essere rappresentato come un grafico a fiamma, una tabella o entrambi.

![\[Un'immagine che mostra un esempio di visualizzazione del grafico a fiamma in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## modalità Flame graph
<a name="v10-panels-flamegraph-mode"></a>

Un grafico a fiamma sfrutta la natura gerarchica dei dati di profilazione. Condensa i dati in un formato che consente di vedere facilmente quali percorsi di codice consumano la maggior parte delle risorse di sistema, ad esempio il tempo della CPU, gli oggetti allocati o lo spazio durante la misurazione della memoria. Ogni blocco nel grafico a fiamma rappresenta una chiamata di funzione in uno stack e la sua larghezza ne rappresenta il valore.

Le sezioni in grigio sono un insieme di funzioni che rappresentano un valore relativamente piccolo e vengono compresse in un'unica sezione per motivi di prestazioni.

Puoi passare il mouse su una funzione specifica per visualizzare una descrizione che mostra dati aggiuntivi su quella funzione, come il valore della funzione, la percentuale del valore totale e il numero di esempi relativi a quella funzione.

**Azioni a discesa**

Puoi fare clic su una funzione per mostrare un menu a discesa con azioni aggiuntive: 
+ **Blocco** di messa a **fuoco**: quando scegliete il blocco Focus, il blocco o la funzione viene impostato sul 100% della larghezza del grafico a fiamma e tutte le relative funzioni secondarie vengono visualizzate con la larghezza aggiornata rispetto alla larghezza della funzione principale. In questo modo è più facile approfondire le parti più piccole del grafico della fiamma.
+ **Copia il nome della funzione**: quando si sceglie **Copia il nome della funzione**, viene copiato il nome completo della funzione rappresentata dal blocco.
+ Visualizzazione a **sandwich: la visualizzazione** a sandwich consente di mostrare il contesto della funzione su cui si è fatto clic. Mostra tutti i chiamanti della funzione nella parte superiore e tutti i chiamanti nella parte inferiore. Questo mostra il contesto aggregato della funzione, quindi se la funzione esiste in più punti del grafico a fiamma, tutti i contesti vengono mostrati e aggregati nella visualizzazione a sandwich.

**Barra di stato**

 La barra di stato mostra i metadati relativi al grafico a fiamma e alle modifiche attualmente applicate, ad esempio quale parte del grafico è a fuoco o quale funzione viene mostrata nella visualizzazione a sandwich. Fai clic sulla **X** nella pillola della barra di stato per rimuovere la modifica.

## Barra degli strumenti
<a name="v10-panels-flamegraph-toolbar"></a>

**Cerca**

È possibile utilizzare il campo di ricerca per trovare funzioni con un nome particolare. Tutte le funzioni del grafico a fiamma che corrispondono alla ricerca rimarranno colorate mentre le altre funzioni saranno disattivate.

**Selettore dello schema dei colori**

È possibile passare da una funzione di colorazione all'altra in base al valore o al nome del pacchetto per collegare visivamente le funzioni dello stesso pacchetto.

**Allineamento del testo**

Allinea il testo a sinistra o a destra per mostrare le parti più importanti del nome della funzione quando non rientra nel blocco.

**Selettore di visualizzazione**

Puoi scegliere di mostrare solo il grafico della fiamma, solo la tabella o entrambi contemporaneamente.

## Modalità Top Table
<a name="v10-panels-flamegraph-toptablemode"></a>

La tabella superiore mostra le funzioni del profilo in formato tabella. La tabella ha tre colonne: simboli, self e total. Per impostazione predefinita, la tabella viene ordinata in base al tempo automatico, ma può essere riordinata in base al tempo totale o al nome del simbolo facendo clic sulle intestazioni delle colonne. Ogni riga rappresenta i valori aggregati per la funzione specificata se la funzione appare in più punti del profilo.

Ci sono anche pulsanti di azione sulla sinistra per ogni riga. Il primo pulsante cerca il nome della funzione, mentre il secondo pulsante mostra la visualizzazione a sandwich della funzione.

## Data API (API dati).
<a name="v10-panels-flamegraph-dataapi"></a>

Per eseguire il rendering del grafico a fiamma, è necessario formattare i dati del frame di dati utilizzando un modello di set [annidato](https://wikipedia.org/wiki/Nested_set_model).

Un modello a set annidato garantisce che ogni elemento del grafico a fiamma sia codificato solo in base al suo livello di nidificazione come valore intero, ai relativi metadati e al relativo ordine nel frame di dati. Ciò significa che l'ordine degli elementi è significativo e deve essere corretto. L'ordinamento è un attraversamento in base alla profondità degli elementi nel grafico a fiamma che ricrea il grafico senza bisogno di valori a lunghezza variabile nel frame di dati, come in un array per bambini.

Campi obbligatori:


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
| level | numero | Il livello di nidificazione dell'elemento. In altre parole, quanti elementi si trovano tra questo elemento e l'elemento superiore del grafico a fiamma. | 
| value | numero | Il valore assoluto o cumulativo dell'articolo. Ciò si traduce nella larghezza dell'elemento nel grafico. | 
| etichetta | stringa | Etichetta da mostrare per l'articolo specifico. | 
| self | numero | Valore proprio che di solito è il valore cumulativo dell'articolo meno la somma dei valori cumulativi dei suoi figli immediati. | 

# Gauge
<a name="v10-panels-gauge"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 indicatori sono visualizzazioni a valore singolo che possono ripetere un indicatore per ogni serie, colonna o riga.

![\[Un'immagine che mostra un esempio di visualizzazione del calibro in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/gauge_example.png)


## Opzioni di valore
<a name="v10-panels-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 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](v10-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
<a name="v10-panels-gauge-gauge"></a>

Regola la modalità di visualizzazione dell'indicatore.

**Orientation** (Orientamento)

Scegliete una direzione di impilamento.
+ **Automatico**: gli indicatori vengono visualizzati in righe e colonne.
+ **Orizzontale**: gli indicatori vengono visualizzati dall'alto verso il basso.
+ **Verticale**: gli indicatori vengono visualizzati da sinistra a destra.

**Mostra le etichette delle soglie**

Controlla se vengono visualizzati i valori di soglia.

**Mostra gli indicatori di soglia**

Controlla se viene mostrata una banda di soglia al di fuori della banda di valori dell'indicatore interno.

**Dimensione del calibro**

Scegli una modalità di dimensione del calibro
+ **Automatico**: Grafana determina la dimensione del calibro migliore.
+ **Manuale**: configura manualmente la dimensione del misuratore.

**Larghezza minima**

Imposta la larghezza minima degli indicatori orientati verticalmente.

Se impostate una larghezza minima, la barra di scorrimento dell'asse x viene visualizzata automaticamente quando c'è una grande quantità di dati.

**Nota**  
Questa opzione si applica solo quando la dimensione del misuratore è impostata su manuale.

**Altezza minima**

Imposta l'altezza minima degli indicatori orientati orizzontalmente.

Se impostate un'altezza minima, la barra di scorrimento dell'asse y viene visualizzata automaticamente quando c'è una grande quantità di dati.

**Nota**  
Questa opzione si applica solo quando la dimensione del misuratore è impostata su manuale.

**Neutro**

Imposta il valore iniziale da cui verrà riempito ogni indicatore.

## Dimensione del testo
<a name="v10-panels-gauge-textsize"></a>

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.

# Geomappa
<a name="v10-panels-geomap"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 geomappe consentono di visualizzare e personalizzare la mappa del mondo utilizzando dati geospaziali. È possibile configurare vari stili di sovrapposizione e impostazioni di visualizzazione della mappa per concentrarsi facilmente sulle importanti caratteristiche dei dati basate sulla posizione.

**Nota**  
È possibile aggiungere i propri dati geospaziali in cima ai livelli delle mappe di base forniti da. AWS I layer della mappa di base devono provenire tutti da. [https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com) 

![\[Un'immagine che mostra un esempio di visualizzazione della mappa geografica a Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## Vista mappa
<a name="v10-panels-geomap-view"></a>

La visualizzazione della mappa controlla la vista 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 l'*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 *l'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="v10-panels-geomap-layers"></a>

Le mappe geografiche supportano 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](#v10-panels-geomap-markers)esegue il rendering di un marker in ogni punto dati.
+ [Livello di mappa termica](#v10-panels-geomap-heatmap)visualizza una mappa termica dei dati.
+ [Strato GeoJSON](#v10-panels-geomap-geojson)esegue il rendering di dati statici da un file GeoJSON.
+ [Livello notte/giorno (Alpha)](#v10-panels-geomap-nightday)esegue il rendering di una regione notturna o diurna.
+ [Route Layer (anteprima)](#v10-panels-geomap-route)esegue il rendering dei punti dati come percorso.
+ [Livello di foto (anteprima)](#v10-panels-geomap-photos)esegue il rendering di una foto in ogni punto dati.
+ [Livello di rete (anteprima)](#v10-panels-geomap-network)visualizza un grafico di rete a partire dai dati.

Esistono anche due tipi di livelli sperimentali (o alfa).
+ 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.

**Nota**  
Livelli contrassegnati come *anteprima* o *alfa* nell'anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

**Controlli a 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 geomappa. Quando si aggiunge un layer, viene richiesto di selezionare un tipo di layer. È possibile modificare il tipo di livello in qualsiasi momento durante la configurazione del pannello.
+ 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 dots/grab maniglie) consente di modificare l'ordine dei livelli. I dati sui livelli superiori verranno visualizzati sopra i dati sui livelli inferiori. La visualizzazione 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 di geomappa per creare visualizzazioni ricche e dettagliate.

**Location (Ubicazione)**

Geomaps 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*:, `latitude` `lat`
  + *longitudine*:`longitude`,, `lng` `lon`
  + *ricerca*: `lookup`
+ **Coords** specifica che la 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="v10-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.
+ **Size** configura la dimensione dei marker. L'impostazione predefinita è `Fixed size` che rende uguali tutte le dimensioni dei marker indipendentemente dai dati; tuttavia, esiste anche un'opzione per ridimensionare i marker in base ai dati corrispondenti al campo selezionato. `Min`e la dimensione del `Max` marker deve essere impostata in modo tale che il livello Marker possa scalare all'interno di questo intervallo.
+ **Symbol** consente di scegliere il simbolo, l'icona o l'immagine per contribuire a fornire un contesto visivo aggiuntivo ai dati. Scegli tra le risorse incluse in Grafana, come i simboli semplici o la libreria Unicon. Puoi anche specificare un URL contenente una risorsa di immagini. L'immagine deve essere una grafica vettoriale scalabile (SVG).
+ **Symbol Vertical Align** configura l'allineamento verticale del simbolo rispetto al punto dati. Si noti che l'angolo di rotazione del simbolo viene applicato prima attorno al punto dati, quindi l'allineamento verticale viene applicato rispetto alla rotazione del simbolo.
+ **Symbol Horizontal Align** configura l'allineamento orizzontale del simbolo rispetto al punto dati. Si noti che l'angolo di rotazione del simbolo viene applicato prima attorno al punto dati, quindi l'allineamento orizzontale viene applicato rispetto alla rotazione del simbolo.
+ **Il colore** configura il colore dei marker. L'impostazione predefinita `Fixed color` imposta tutti i marker su un colore specifico. È inoltre possibile impostare colori condizionali in base ai valori dei punti dati del campo selezionato e allo schema di colori impostato nella sezione **Opzioni standard**.
+ **L'opacità di riempimento configura la** trasparenza di ogni marker.
+ **L'angolo di rotazione** configura l'angolo di rotazione di ciascun marker. L'impostazione predefinita è **Valore fisso**, che fa ruotare tutti i marker con lo stesso angolo indipendentemente dai dati; tuttavia, esiste anche un'opzione per impostare la rotazione dei marker in base ai dati corrispondenti a un campo selezionato.
+ **L'etichetta di testo configura un'etichetta** di testo per ogni marker.
+ **Mostra legenda** consente di attivare o disattivare la legenda per i livelli.
+ **Visualizza tooltip** consente di attivare o disattivare i tooltip per il livello.

## Livello di mappa termica
<a name="v10-panels-geomap-heatmap"></a>

Il livello di mappa termica raggruppa vari punti dati per visualizzare posizioni con densità diverse.

![\[Un'immagine che mostra un esempio di mappa termica che utilizza la visualizzazione della mappa geografica in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


Per aggiungere un livello di mappa termica:

Scegli nel menu a discesa sotto Data Layer e seleziona. `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. **Il valore fisso** 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.
+ **Opacity configura l'opacità** di ogni cluster.
+ **Display tooltip consente di attivare o disattivare i tooltip** per il livello.

## Strato GeoJSON
<a name="v10-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.
+ **Visualizza tooltip** consente di attivare o disattivare i tooltip per il livello.

## Livello notte/giorno (Alpha)
<a name="v10-panels-geomap-nightday"></a>

Il livello Notte/Giorno mostra le regioni diurne e notturne in base all'intervallo di tempo corrente.

![\[Un'immagine che mostra un esempio di livello notte/giorno che utilizza la visualizzazione geomappa in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Opzioni**
+ **Mostra** alterna la sorgente temporale dall'intervallo temporale del pannello.
+ **Colore della regione notturna** sceglie il colore per la regione notturna.
+ **Visualizza il sole** alterna l'icona del sole.
+ **Opacità** da 0 (trasparente) a 1 (opaco).
+ **Visualizza tooltip** consente di attivare o disattivare i tooltip per il livello.

**Nota**  
[Per ulteriori informazioni, consulta Estensioni per -. OpenLayers DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)

## Route Layer (anteprima)
<a name="v10-panels-geomap-route"></a>

Il layer Route esegue il rendering dei punti dati come percorso.

**Nota**  
Il layer Route è attualmente in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

![\[Un'immagine che mostra un esempio di un layer di percorso che utilizza la visualizzazione della mappa geografica in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Opzioni**
+ **La dimensione** imposta lo spessore del percorso. Valore fisso per impostazione predefinita. Quando sono selezionati i dati del campo, è possibile impostare l'intervallo minimo e massimo entro il quale i dati del campo possono essere scalati.
+ **Il colore** imposta il colore del percorso. Impostato su un colore fisso per impostazione predefinita, puoi anche associare il colore ai dati del campo.
+ **L'opacità di riempimento** configura l'opacità del percorso.
+ **L'etichetta di testo configura un'etichetta** di testo per ogni percorso.
+ **Arrow** configura lo stile delle frecce da visualizzare lungo il percorso, in ordine di dati.
  + **Nessuno**
  + **Avanti**
  + **Inverso**
+ **Visualizza tooltip** consente di attivare o disattivare i tooltip per il livello.

**Nota**  
Per ulteriori informazioni, consultate [Estensioni per OpenLayers -](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html) Flow Line Style.

## Livello di foto (anteprima)
<a name="v10-panels-geomap-photos"></a>

Il livello Foto esegue il rendering di una foto in ogni punto dati.

**Nota**  
Il livello Foto è attualmente in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

**Opzioni**
+ **Image Source Field** consente di selezionare un campo stringa contenente dati di immagine come file binario di immagini codificate Base64 (). `data:image/png;base64,...`
+ **Kind** imposta lo stile della cornice attorno alle immagini. Scegli tra:
  + **Square**
  + **Circle** (Cerchio)
  + **Ancorato**
  + **Folio**
+ **Ritaglia** cambia se le immagini vengono ritagliate per adattarle.
+ **Shadow** attiva o disattiva l'ombreggiatura di un riquadro dietro le immagini.
+ **Border** imposta la dimensione del bordo attorno alle immagini.
+ **Il colore del bordo** imposta il colore del bordo attorno alle immagini.
+ Il **raggio** imposta la dimensione complessiva delle immagini in pixel.
+ **Visualizza tooltip** consente di attivare o disattivare i tooltip per il livello.

**Nota**  
Per ulteriori informazioni, consultate [Estensioni per OpenLayers -](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html) Image Photo Style.

## Livello di rete (anteprima)
<a name="v10-panels-geomap-network"></a>

Il livello di rete esegue il rendering di un grafico di rete. Questi livelli supportano lo stesso formato di dati supportato dalla visualizzazione del grafico dei nodi, con l'aggiunta di dati geospaziali inclusi nei dati dei nodi. I dati geospaziali vengono utilizzati per localizzare e renderizzare i nodi sulla mappa.

**Nota**  
Il livello Rete è attualmente in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

![\[Un'immagine che mostra esempi di visualizzazioni di rete all'interno di una geomappa a Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**Nota**  
Il livello di rete è attualmente in anteprima pubblica. Grafana Labs offre un supporto limitato e potrebbero verificarsi modifiche sostanziali prima che la funzionalità venga resa disponibile al pubblico.

**Opzioni**
+ **Arrow** imposta la direzione della freccia da visualizzare per ogni spigolo, mentre avanti significa da origine a destinazione. Scegli tra:
  + **Nessuno**
  + **Avanti**
  + **Inverso**
  + **Entrambi**
+ **Mostra legenda** consente di attivare o disattivare la legenda del layer. La legenda supporta solo i dati dei nodi.
+ **Visualizza tooltip** consente di attivare o disattivare i tooltip per il livello.

**Stili dei nodi**
+ **Size** configura la dimensione dei nodi. L'impostazione predefinita è **Dimensione fissa**, che rende uguali tutte le dimensioni dei nodi indipendentemente dai dati; tuttavia, esiste anche un'opzione per ridimensionare i nodi in base ai dati corrispondenti a un campo selezionato. Le dimensioni **minime** e **massime** dei nodi devono essere impostate in modo che i nodi possano scalare all'interno di questo intervallo.
+ **Il colore** configura il colore dei nodi. L'impostazione predefinita è **Colore fisso**, che imposta tutti i nodi su un colore specifico. È inoltre possibile impostare colori condizionali in base ai valori dei punti dati del campo selezionato e allo schema di colori impostato nella sezione **Opzioni standard**.
+ Il **simbolo** consente di scegliere il simbolo, l'icona o l'immagine per fornire un contesto visivo aggiuntivo ai dati. Scegli tra le risorse incluse in Grafana, come simboli semplici o la libreria Unicon. Puoi anche specificare un URL contenente una risorsa di immagini. L'immagine deve essere una grafica vettoriale scalabile (SVG).
+ **Fill opacity configura la trasparenza** di ogni nodo.
+ **L'angolo di rotazione** configura l'angolo di rotazione di ciascun nodo. L'impostazione predefinita è **Valore fisso**, che fa ruotare tutti i nodi con lo stesso angolo indipendentemente dai dati; tuttavia, esiste anche un'opzione per impostare la rotazione dei nodi in base ai dati corrispondenti a un campo selezionato.
+ **L'etichetta di testo** configura un'etichetta di testo per ogni nodo.

**Stili Edge**
+ **La dimensione** configura la larghezza della linea dei bordi. L'impostazione predefinita è **Dimensione fissa**, che rende uguali tutte le larghezze delle linee dei bordi indipendentemente dai dati; tuttavia, esiste anche un'opzione per ridimensionare i bordi in base ai dati corrispondenti a un campo selezionato. Le dimensioni **minime** e **massime** dei bordi devono essere impostate in modo che i bordi possano scalare all'interno di questo intervallo.
+ **Il colore** configura il colore dei bordi. L'impostazione predefinita è **Colore fisso**, che imposta tutti i bordi su un colore specifico. È inoltre possibile impostare colori condizionali in base ai valori dei punti dati del campo selezionato e allo schema di colori impostato nella sezione **Opzioni standard**.
+ **L'opacità di riempimento** configura la trasparenza di ogni bordo.
+ **L'etichetta di testo** configura un'etichetta di testo per ogni bordo.

## Strato CARTO
<a name="v10-panels-geomap-carto"></a>

I livelli CARTO non sono supportati in Amazon Managed Grafana.

## Strato di file XYZ
<a name="v10-panels-geomap-xyz"></a>

I tile layer XYZ non sono supportati in Amazon Managed Grafana.

## Apri il livello Street Map
<a name="v10-panels-geomap-osm"></a>

I livelli Open Street Map (diversi dalla mappa di base predefinita) non sono supportati in Amazon Managed Grafana.

## Layer ArcGIS
<a name="v10-panels-geomap-arcgis"></a>

I layer ArcGIS non sono supportati in Amazon Managed Grafana.

## Controlli della mappa
<a name="v10-panels-geomap-controls"></a>

La sezione dei controlli della mappa contiene varie opzioni per le informazioni sulla mappa e le sovrapposizioni degli strumenti.

**Zoom**

Opzioni per i 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 la 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*

Ottiene 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 il 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.

# Mappa termica
<a name="v10-panels-heatmap"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

![\[Un'immagine che mostra un esempio di visualizzazione della mappa termica in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Calcola a partire dai dati
<a name="v10-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.
+ symlog — **Scala Symlog**.

## Assi Y.
<a name="v10-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.

**Visualizza più assi y**

In alcuni casi, potresti voler visualizzare più assi y. Ad esempio, se disponi di un set di dati che mostra sia la temperatura che l'umidità nel tempo, potresti voler mostrare due assi y con unità diverse per queste due serie.

Puoi farlo [aggiungendo](v10-panels-configure-overrides.md) sostituzioni di campo. Segui i passaggi tutte le volte necessarie per aggiungere tutti gli assi y necessari.

## Colori
<a name="v10-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="v10-panels-heatmap-cell"></a>

Usa queste impostazioni per affinare la visualizzazione.

## Opzioni di visualizzazione aggiuntive
<a name="v10-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.
+ **Mostra scala di colori: mostra una scala** di colori nella descrizione del comando. La scala dei colori rappresenta la mappatura tra il valore del bucket e il colore.

**Legenda**

Scegli se visualizzare la legenda della mappa termica sulla visualizzazione.

**Esemplari**

Imposta il colore usato per mostrare i dati del campione.

# Istogramma
<a name="v10-panels-histogram"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

![\[Un'immagine che mostra un esempio di visualizzazione dell'istogramma in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/histogram-example.png)


## Formati supportati
<a name="v10-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="v10-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 inferiore alla 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.

**Larghezza della linea**

Controlla la larghezza delle linee delle barre.

**Riempi l'opacità**

Controlla l'opacità di riempimento delle barre.

**modalità Gradiente**

Imposta la modalità del riempimento a 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.

## Opzioni relative alla legenda
<a name="v10-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. Per ulteriori informazioni sulla legenda, consulta [Configurare](v10-panels-configure-legend.md) una legenda.

**Modalità Legenda**

Utilizza queste impostazioni per definire come appare la 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 leggenda**

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](v10-panels-calculation-types.md).

**Calcoli delle legende**

Scegli quali calcoli mostrare nella legenda. Puoi selezionarne più di uno.

# Log
<a name="v10-panels-logs"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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 [Livello di log](v10-explore-logs.md#v10-explore-log-level).

## Dettagli del registro
<a name="v10-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.

# Notizie
<a name="v10-panels-news"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 delle notizie mostra un feed RSS. Per impostazione predefinita, visualizza gli articoli del blog Grafana Labs e gli utenti possono modificarlo inserendo un URL del feed RSS diverso.

**Inserisci l'URL di un RSS nella sezione Visualizzazione.** Questo tipo di visualizzazione non accetta altre richieste e gli utenti non dovrebbero aspettarsi di poter filtrare o interrogare i dati del feed RSS in alcun modo utilizzando questa visualizzazione.

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

# Grafico dei nodi
<a name="v10-panels-node-graph"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 grafici dei nodi possono visualizzare grafici o reti diretti. Utilizzano un 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="v10-panels-node-graph-requirements"></a>

Un grafico a 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 con questo grafico. Se desideri utilizzarlo come sviluppatore di fonti di dati, consulta la sezione sull'API dei dati.

Un grafo a nodi è composto 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="v10-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="v10-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="v10-panels-node-graph-navigation"></a>

**Pan**

È possibile eseguire una panoramica all'interno del grafico del nodo selezionando una posizione esterna a qualsiasi nodo o bordo e trascinando il puntatore.

**Ingrandisci o riduci**

È possibile eseguire lo zoom utilizzando i pulsanti nell'angolo superiore sinistro del grafico del nodo oppure utilizzare la rotellina del mouse o altri input di scorrimento con il tasto `Ctrl` (o`Cmd`).

**Esplora i 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 selezionabili 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 (`˄`o`˅`) mostra quale statistica è attualmente utilizzata per l'ordinamento e la direzione di ordinamento.

Scegliete un nodo, quindi selezionate l'opzione **Mostra nel grafico** per tornare al layout del grafico concentrandovi sul nodo selezionato e mostrandolo nel contesto del grafico completo.

## Data API (API dati).
<a name="v10-panels-node-graph-data-api"></a>

Questa visualizzazione richiede una forma specifica dei dati da restituire dalla fonte dei dati per poterla visualizzare 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. | 
| color | stringa/numero | Può essere usato per specificare un solo colore invece di usare `arc__` i campi per specificare le sezioni a colori. Può essere una stringa (deve essere una stringa di colori HTML accettabile) o un numero, nel qual caso il comportamento dipende dall'`field.config.color.mode`impostazione. Questo può essere usato, ad esempio, per creare colori sfumati controllati da un valore di campo. | 
| icon | stringa | Nome dell'icona da mostrare all'interno del nodo anziché le statistiche predefinite. Sono consentite solo le icone grafane integrate (vedi le icone disponibili [qui](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)). | 
| NodeRadius | numero | Valore del raggio in pixel. Utilizzato per gestire la dimensione del nodo. | 
| evidenziato | Booleano | Imposta se il nodo deve essere evidenziato. Utilizzatelo, ad esempio, per rappresentare un percorso specifico nel grafico evidenziando diversi nodi e spigoli. L’impostazione predefinita è `false`. | 

# Grafico a torta
<a name="v10-panels-piechart"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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'immagine che mostra un esempio di visualizzazione di un grafico a torta in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/pie_chart_example.png)


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="v10-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](v10-panels-calculation-types.md).

**Limite**

Quando si visualizzano tutti i valori di una singola serie, ciò limita il numero di valori visualizzati.

**Campi**

Seleziona almeno un campo 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="v10-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.

## Opzioni relative alla legenda
<a name="v10-panels-piechart-legend"></a>

Utilizza queste impostazioni per definire come appare la legenda nella visualizzazione. Per ulteriori informazioni sulla legenda, consulta [Configurare una legenda](v10-panels-configure-legend.md).

**Visibilità della legenda**

Usa l'interruttore **Visibilità** per mostrare o nascondere la legenda.

**modalità Legenda**

Imposta la modalità di visualizzazione della legenda.
+ **Elenco**: visualizza la legenda sotto forma di elenco. Questa è la modalità di visualizzazione predefinita della legenda.
+ **Tabella**: visualizza la legenda come tabella.

**Posizionamento della leggenda**

Scegli dove visualizzare la legenda.
+ **In basso**: sotto il grafico.
+ A **destra**: a destra del grafico.

**Valori della legenda**

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](v10-panels-configure-legend.md).

# Stat
<a name="v10-panels-stat"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 statistiche mostrano un valore stat grande con un grafico sparkline opzionale. Puoi controllare lo sfondo o il colore del valore utilizzando soglie o sostituzioni.

![\[Un'immagine che mostra un esempio di visualizzazione delle statistiche in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/stat_panel_example.png)


Per impostazione predefinita, una statistica 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="v10-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="v10-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](v10-panels-calculation-types.md).
  + **Campi**: seleziona i campi visualizzati nella visualizzazione.
+ **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 nella visualizzazione.

## Stili di statistiche
<a name="v10-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 renderizzato dalla visualizzazione. **Se il valore non è importante, lo sono solo il nome e il colore, quindi cambia 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.

**Layout ampio**

Imposta se il layout ampio è abilitato o meno. Il layout ampio è abilitato per impostazione predefinita.
+ **Attivato**: il layout ampio è attivato.
+ **Disattivato**: il layout ampio è disattivato.

**Nota**  
Questa opzione è applicabile solo quando la **modalità Testo** è impostata su **Valore e nome**. Quando il layout ampio è attivato, il valore e il nome vengono visualizzati side-by-side con il valore sulla destra, se il pannello è sufficientemente largo. Quando il layout ampio è disattivato, il valore viene sempre visualizzato sotto il nome.

**Modalità colore**

Seleziona una modalità di colore.
+ **Nessuno**: al valore non viene applicato alcun colore.
+ **Valore**: applica i colori all'area del valore e del grafico.
+ **Sfumatura di sfondo**: applica il colore al valore, all'area del grafico e allo sfondo, con una leggera sfumatura di sfondo.
+ **Sfondo solido**: applica il colore al valore, all'area del grafico e allo sfondo, con un colore di sfondo solido.

**Modalità grafico**

Seleziona una modalità grafico e sparkline.
+ **Nessuno**: nasconde il grafico e mostra solo il valore.
+ **Area**: mostra il grafico dell'area sotto il 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.

**Mostra la variazione percentuale**

Imposta se visualizzare o meno la variazione percentuale. Per impostazione predefinita, non viene visualizzato.

**Nota**  
Questa opzione non è applicabile quando l'impostazione **Mostra**, in **Opzioni valore**, è impostata su **Tutti i valori**.

## Dimensione del testo
<a name="v10-panels-stat-textsize"></a>

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.

# Cronologia dello stato
<a name="v10-panels-state-timeline"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 cronologie degli stati mostrano 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.

![\[Un'immagine che mostra un esempio di visualizzazione della cronologia di uno stato in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/state_timeline_example.png)


## Opzioni della cronologia dello stato
<a name="v10-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.

**Connect valori nulli**

Scegli in che modo i valori nulli, che sono lacune nei dati, appaiono nel grafico. I valori nulli possono essere collegati per formare una linea continua o impostati su una soglia oltre la quale le lacune nei dati non sono più collegate.
+ **Mai**: i punti dati delle serie temporali con lacune nei dati non vengono mai collegati.
+ **Sempre**: i punti dati delle serie temporali con lacune nei dati sono sempre connessi.
+ **Soglia**: specifica una soglia oltre la quale le lacune nei dati non sono più connesse. Ciò può essere utile quando le lacune connesse nei dati hanno una dimensione nota o rientrano in un intervallo noto e le lacune al di fuori di questo intervallo non devono più essere collegate.

**Valori di disconnessione**

Scegli se impostare una soglia oltre la quale i valori nei dati devono essere disconnessi.
+ **Mai**: i punti dati delle serie temporali nei dati non vengono mai disconnessi.
+ **Soglia**: specifica una soglia al di sopra della quale i valori nei dati vengono disconnessi. Ciò può essere utile quando i valori desiderati nei dati hanno una dimensione nota o rientrano in un intervallo noto e i valori al di fuori di questo intervallo non devono più essere collegati.

## Mappature dei valori
<a name="v10-panels-state-timeline-valuemap"></a>

Per assegnare colori a valori booleani o stringhe, usa. [Configurare le mappature dei valori](v10-panels-configure-value-mappings.md)

## Dati di serie temporali con soglie
<a name="v10-panels-state-timeline-threshold"></a>

La visualizzazione può essere utilizzata anche con dati di serie temporali. In questo caso, le soglie vengono utilizzate per trasformare le serie temporali in regioni statali colorate discrete.

## Opzioni relative alla legenda
<a name="v10-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 definire come appare la legenda nella visualizzazione. Per ulteriori informazioni sulla legenda, consulta [Configurare una legenda](v10-panels-configure-legend.md).
+ **Elenco**: visualizza la legenda sotto forma di elenco. Questa è la modalità predefinita.
+ **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](v10-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

# Cronologia dello stato
<a name="v10-panels-status-history"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 cronologie degli stati mostrano 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.

## Dati supportati
<a name="v10-panels-status-history-supporteddata"></a>

Una 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="v10-panels-status-history-options"></a>

Utilizzate queste opzioni per affinare la visualizzazione.

**Mostra valori**

Controlla se i valori vengono visualizzati all'interno delle caselle dei valori. **Auto** renderizzerà i valori se c'è spazio sufficiente.

**Larghezza della colonna**

Controlla la larghezza dei riquadri. 1 = spazio massimo e 0 = spazio minimo.

**Larghezza della linea**

Controlla la larghezza delle linee delle regioni statali.

**Riempi l'opacità**

Controlla l'opacità di riempimento delle aree statali.

## Mappature dei valori
<a name="v10-panels-status-history-valuemap"></a>

Per assegnare colori a valori booleani o stringhe, usa. [Configurare le mappature dei valori](v10-panels-configure-value-mappings.md)

## Dati di serie temporali con soglie
<a name="v10-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="v10-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, impostate **lo schema di colori** su Dalle soglie.**

**modalità Legenda**

Utilizza queste impostazioni per definire come appare la legenda nella visualizzazione. Per ulteriori informazioni sulla legenda, consulta [Configurare una legenda](v10-panels-configure-legend.md).
+ **Elenco**: visualizza la legenda sotto forma di elenco. Questa è la modalità predefinita.
+ **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](v10-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

# Tabella
<a name="v10-panels-table"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 tabelle sono molto flessibili e supportano più modalità per le serie temporali e per le tabelle, le annotazioni e i dati JSON non elaborati. Questa visualizzazione fornisce anche opzioni di formattazione della data, formattazione dei valori e colorazione.

![\[Un'immagine che mostra un esempio di visualizzazione tabellare in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/table_example.png)


**Nota**  
Le annotazioni e gli avvisi non sono supportati nelle tabelle.

## Ordina colonna
<a name="v10-panels-table-sort"></a>

Scegli il titolo di una colonna per modificare l'ordinamento da predefinito a decrescente a crescente. Ogni volta che selezionate la colonna, l'ordinamento passa all'opzione successiva del ciclo. È possibile ordinare in base a più colonne tenendo premuto il `shift` tasto quando si selezionano colonne aggiuntive.

## Opzioni della tabella
<a name="v10-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="v10-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`, tutte le colonne verranno impostate su una larghezza di 100 pixel (la modifica avviene quando si esce dal campo).

## Larghezza minima della colonna
<a name="v10-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 imposti il valore minimo su`75`, tutte le colonne verranno ridimensionate in modo da non essere inferiori a 75 pixel di larghezza.

Per i dispositivi con schermo piccolo, come smartphone o tablet, puoi ridurre il valore predefinito dei `150` pixel `50` per consentire il corretto rendering dei pannelli basati su tabelle nelle dashboard.

## Allineamento delle colonne
<a name="v10-panels-table-alignment"></a>

Scegli come Grafana deve allineare il contenuto delle celle.
+ Auto (impostazione predefinita)
+ Sinistra
+ center
+ Right

## Tipo di cella
<a name="v10-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.

Inoltre, le etichette visualizzate accanto agli indicatori possono essere impostate in modo da essere colorate in base al valore, corrispondere al colore del testo del tema o essere nascoste.
+ **Colore del valore**
+ **Colore del testo**
+ **Nascosto**

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

**Sparkline**

Mostra i valori renderizzati come sparkline. Richiede [serie temporali per la trasformazione dei dati della tabella](v10-panels-xform-functions.md#v10-panels-xform-funcs-series).

## Ispezione del valore delle celle
<a name="v10-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="v10-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](#v10-panels-table-filter).

## Paginazione
<a name="v10-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="v10-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 a forma di filtro (imbuto).

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

Seleziona tra diversi operatori per visualizzare i valori delle colonne:
+ **Contiene**: corrisponde a un modello regex (operatore predefinito).
+ **Espressione: valuta un'espressione** booleana. Il carattere `$` rappresenta il valore della colonna nell'espressione (ad esempio,). `$ >= 10 ≈& $ <= 12`
+ **Operatori di confronto**: è possibile utilizzare gli operatori di confronto tipici: `=``!=`,`<`,,`<=`,`>`,`>=`.

Scegliete la casella di controllo sopra i pulsanti **Ok** e **Annulla** per aggiungere o rimuovere tutti i valori visualizzati dal filtro.

**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="v10-panels-table-footer"></a>

È possibile utilizzare il piè di pagina della tabella per mostrare [i calcoli sui campi](v10-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**.

# Testo
<a name="v10-panels-text"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 visualizzazioni di testo consentono 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.

# Serie temporali
<a name="v10-panels-time-series"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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'immagine che mostra esempi di visualizzazioni di serie temporali in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/time_series_example.png)


Le visualizzazioni delle serie temporali sono il modo predefinito e principale per visualizzare i dati delle serie temporali sotto forma di grafico. Possono renderizzare le serie come linee, punti o barre. Sono abbastanza versatili 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](v10-time-series-panel-tooltip.md)
+ [Opzioni della legenda](v10-time-series-panel-legend.md)
+ [Stili di grafico](v10-time-series-graph.md)
+ [Opzioni dell'asse](v10-time-series-axis.md)
+ [Opzioni di colore](v10-time-series-color.md)

# Opzioni del tooltip
<a name="v10-time-series-panel-tooltip"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 del tooltip controllano la sovrapposizione di informazioni che appare quando passi il mouse sui punti dati nel grafico.

**modalità Tooltip**
+ **Singola**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui si sta posizionando il mouse.
+ **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.

# Opzioni della legenda
<a name="v10-time-series-panel-legend"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 relative alla legenda controllano i nomi e le statistiche delle serie che appaiono sotto o a destra del grafico.

**modalità Legend**

Utilizza queste impostazioni per definire come appare la legenda nella visualizzazione. Per ulteriori informazioni sulla legenda, vedere[Configurare una legenda](v10-panels-configure-legend.md).
+ **Elenco**: visualizza la legenda sotto forma di elenco. Questa è la modalità di visualizzazione predefinita di una 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 quali [calcoli standard](v10-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

# Stili di grafico
<a name="v10-time-series-graph"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Utilizzate questa opzione per definire come visualizzare i dati delle serie temporali. È possibile utilizzare le sostituzioni per combinare più stili nello stesso 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
<a name="v10-time-series-graph-bar"></a>

Imposta la posizione della barra rispetto a un punto dati, dove il punto verrebbe disegnato sul grafico. Poiché una barra ha una larghezza, può essere posizionata prima, dopo o centrata sul punto. Le scelte per questa opzione sono:
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/bar-alignment-before.png)**Prima**: la barra viene disegnata prima del punto. Il punto viene posizionato nell'angolo finale della barra.
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/bar-alignment-center.png)**Centro**: la barra viene disegnata attorno al punto. Il punto viene posizionato al centro della barra. Questa è l’impostazione predefinita.
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/bar-alignment-after.png)**Dopo**: la barra viene disegnata dopo il punto. Il punto viene posizionato nell'angolo principale della barra.

## Larghezza della linea
<a name="v10-time-series-graph-linewidth"></a>

Lo spessore della linea è un cursore che controlla lo spessore delle linee delle serie o il contorno delle barre.

## Opacità di riempimento
<a name="v10-time-series-graph-fill"></a>

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
<a name="v10-time-series-graph-gradient"></a>

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](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme).

Le opzioni della modalità gradiente sono:
+ **Nessuno**: nessun riempimento a gradiente. Questa è l'impostazione predefinita.
+ **Opacità**: un gradiente di opacità in cui l'opacità del riempimento aumenta all'aumentare dei valori dell'asse Y.
+ **Tonalità: un gradiente sottile basato sulla tonalità** del colore della serie.
+ **Schema**: una sfumatura di colore definita dalla combinazione di colori desiderata. Questa impostazione viene utilizzata per l'area di riempimento e la linea. Per ulteriori informazioni, consulta [Opzioni di colore](v10-time-series-color.md).

L'aspetto del gradiente è influenzato dall'impostazione dell'**opacità di riempimento**.

## Mostra punti
<a name="v10-time-series-graph-showpoints"></a>

Puoi configurare la visualizzazione per aggiungere punti a linee o barre, con le seguenti opzioni.
+ **Automatico**: Grafana determina se mostrare i punti in base alla densità dei dati. I punti vengono visualizzati quando la densità è bassa.
+ **Sempre**: i punti vengono visualizzati, indipendentemente dalla densità dei dati.
+ **Mai**: non mostra punti.

## Dimensione in punti
<a name="v10-time-series-graph-pointsize"></a>

Imposta la dimensione dei punti, da 1 a 40 pixel di diametro.

## Interpolazione delle linee
<a name="v10-time-series-graph-interpolation"></a>

Scegli come Grafana interpola la linea della serie.

![\[Un'immagine che mostra diversi modi di tracciare linee tra i punti in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/line-interpolation.png)


Le opzioni sono:
+ **Lineare**: i punti sono uniti da linee rette.
+ **Liscio**: i punti sono uniti da linee curve che attenuano le transizioni tra i punti.
+ **Passaggio precedente**: la linea viene visualizzata come passaggi tra i punti. I punti vengono renderizzati alla fine del passaggio.
+ **Passo dopo**: la linea viene visualizzata come passaggi tra i punti. I punti vengono renderizzati all'inizio del passaggio.

## Stile della riga
<a name="v10-time-series-graph-linestyle"></a>

Imposta lo stile della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard.

Le scelte per lo stile della linea sono:
+ **Solido**: visualizza una linea continua. Questa è l'impostazione predefinita.
+ **Dash**: visualizza una linea tratteggiata. Quando scegli questa opzione, viene visualizzato un elenco in cui selezionare la lunghezza e lo spazio (lunghezza, distanza) per i trattini delle linee. La spaziatura dei trattini è impostata su 10, 10 per impostazione predefinita.
+ **Punti: visualizza linee** tratteggiate. Quando si sceglie questa opzione, viene visualizzato un elenco in cui selezionare la lunghezza dello spazio per la spaziatura dei punti. La spaziatura tra i punti è impostata su 10 per impostazione predefinita.

## Connect valori nulli
<a name="v10-time-series-graph-null"></a>

Scegli in che modo i valori nulli, che sono lacune nei dati, appaiono nel grafico. I valori nulli possono essere collegati per formare una linea continua o impostati su una soglia oltre la quale le lacune nei dati non sono più collegate.

Le scelte su come connettere i valori nulli sono:
+ **Mai**: i punti dati delle serie temporali con lacune nei dati non vengono mai collegati.
+ **Sempre**: i punti dati delle serie temporali con lacune nei dati sono sempre connessi.
+ **Soglia**: specifica una soglia oltre la quale le lacune nei dati non sono più connesse. Ciò può essere utile quando le lacune connesse nei dati hanno una dimensione nota o rientrano in un intervallo noto e le lacune al di fuori dell'intervallo non devono più essere collegate.

## Valori di disconnessione
<a name="v10-time-series-graph-disconnect"></a>

Scegli se aggiungere uno spazio tra i valori nei dati che hanno intervalli di tempo tra loro superiori a una soglia specificata.

Le scelte per i valori di disconnessione sono:
+ **Mai**: i punti dati delle serie temporali non vengono mai disconnessi.
+ **Soglia**: specifica una soglia oltre la quale i valori nei dati vengono disconnessi. Ciò può essere utile quando i valori desiderati nei dati hanno una dimensione nota o rientrano in un intervallo noto e i valori al di fuori di questo intervallo non devono più essere collegati.

## Serie Stack
<a name="v10-time-series-graph-stack"></a>

*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 scelte 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%.

**Sovrapposizione delle 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](v10-panels-configure-overrides.md)

**Per impilare le serie in gruppi**

1. Modifica il pannello e scegli **Sostituisci**.

1. Crea una sovrascrittura dei campi per l'opzione **Stack** series.

1. **In modalità impilamento, seleziona Normale.**

1. Assegna un nome al gruppo di impilamento in cui desideri che compaia la serie.

   L'opzione relativa al nome del gruppo di impilamento è disponibile solo quando create un'eccezione.

## Compila i campi seguenti per
<a name="v10-time-series-graph-fillbelow"></a>

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é 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="v10-time-series-axis"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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`.

## Time zone (Fuso orario)
<a name="v10-time-series-axis-timezone"></a>

Imposta i fusi orari desiderati da visualizzare lungo l'asse x.

## Placement
<a name="v10-time-series-axis-placement"></a>

Seleziona la posizione dell'asse Y. Le opzioni sono:
+ **Automatico**: 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.

Per nascondere selettivamente gli assi, [aggiungi una sovrascrittura di campo destinata](v10-panels-configure-overrides.md) a campi specifici.

## Etichetta
<a name="v10-time-series-axis-label"></a>

Imposta un'etichetta di testo sull'asse y. Se hai più di un asse y, puoi assegnare etichette diverse usando un override.

## Larghezza
<a name="v10-time-series-axis-width"></a>

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.

## Mostra le linee della griglia
<a name="v10-time-series-axis-gridlines"></a>

Imposta la visibilità della linea della griglia dell'asse.
+ **Automatico**: mostra automaticamente le linee della griglia in base alla densità dei dati.
+ **Attivo**: mostra sempre le linee della griglia.
+ **Disattivata**: non mostra mai le linee della griglia.

## Colore
<a name="v10-time-series-axis-color"></a>

Imposta il colore dell'asse.
+ **Testo**: imposta il colore in base al colore del testo del tema.
+ **Serie**: imposta il colore in base al colore della serie.

## Mostra bordo
<a name="v10-time-series-axis-border"></a>

Imposta la visibilità del bordo dell'asse.

## Dimensionare
<a name="v10-time-series-axis-scale"></a>

Imposta la scala dei valori dell'asse y.
+ **Lineare**: divide la scala in parti uguali.
+ **Logaritmica: utilizza una scala logaritmica**. Quando si seleziona questa opzione, viene visualizzato un elenco in cui scegliere una scala logaritmica binaria (base 2) o comune (base 10).
+ **Symlog**: utilizza una scala logaritmica simmetrica. Quando si seleziona questa opzione, viene visualizzato un elenco in cui scegliere una scala logaritmica binaria (base 2) o comune (base 10). L'opzione di soglia lineare consente di impostare la soglia alla quale la scala passa da lineare a logaritmica.

## Zero centrato
<a name="v10-time-series-axis-centered"></a>

Imposta l'asse y in modo che sia centrato su zero.

## Soft min e soft max
<a name="v10-time-series-axis-softminmax"></a>

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 possono impedire l'ingrandimento di piccole variazioni nei dati quando sono per lo più piatti. Al contrario, i valori hard min e max aiutano a evitare di oscurare i dettagli utili dei dati, eliminando i picchi intermittenti oltre un punto specifico.

Per definire limiti rigidi dell'asse y, impostate le opzioni standard. min/max Per ulteriori informazioni, consulta [Configurare le opzioni standard](v10-panels-configure-standard-options.md).

## Trasformazione
<a name="v10-time-series-axis-transform"></a>

Utilizzate questa opzione per trasformare i valori della serie senza influire sui valori mostrati nella descrizione comandi, nei menu contestuali o nella legenda. 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.

**Nota**  
L'opzione di trasformazione è disponibile solo come alternativa.

## Visualizza più assi y
<a name="v10-time-series-axis-multiple"></a>

In alcuni casi si desidera visualizzare più assi y. Ad esempio, se disponi di un set di dati che mostra sia la temperatura che l'umidità nel tempo, puoi mostrare due assi y con unità diverse per queste due serie.

[Per visualizzare più assi y, aggiungete un campo override.](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field) Segui i passaggi tutte le volte necessarie per aggiungere tutti gli assi y necessari.

# Opzioni di colore
<a name="v10-time-series-color"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme) delle serie. È inoltre possibile utilizzare la legenda per aprire il selettore dei colori selezionando l'icona a 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
<a name="v10-time-series-color-classic"></a>

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
<a name="v10-time-series-color-single"></a>

Utilizzate questa modalità per specificare un colore. Puoi anche selezionare l'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
<a name="v10-time-series-color-byvalue"></a>

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)
<a name="v10-time-series-color-gradient"></a>

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

# Tracce
<a name="v10-panels-traces"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 visualizzazioni di Traces ti consentono di seguire una richiesta mentre attraversa i servizi della tua infrastruttura. La visualizzazione delle tracce mostra i dati delle tracce in un diagramma che consente di interpretarli facilmente.

Per ulteriori informazioni sulle tracce e su come utilizzarle, consulta la seguente documentazione:
+ [Tracciamento in Explore](v10-explore-tracing.md)
+ [Fonte dati Tempo](tempo-data-source.md)
+ [Guida introduttiva a Tempo](https://grafana.com/docs/tempo/latest/getting-started/) nella documentazione di *Grafana Labs* Tempo.

## Aggiungere un pannello con visualizzazioni di tracciamento
<a name="v10-panels-traces-add"></a>

Una volta che i dati di tracciamento sono disponibili nello stack Grafana, puoi aggiungere pannelli di tracciamento alle dashboard Grafana.

L'utilizzo di una variabile del dashboard`traceID`, consente di creare una query per mostrare tracce specifiche per un determinato ID di traccia. Per ulteriori informazioni sulle variabili del dashboard, consulta la [documentazione Variables](v10-dash-variables.md). 

**Prerequisiti**

Prima di iniziare è necessario disporre di quanto segue:
+ Uno spazio di lavoro Amazon Managed Grafana.
+ Una [fonte di dati Tempo](tempo-data-source.md) connessa al tuo spazio di lavoro.

Per visualizzare e analizzare i dati delle tracce in una dashboard, è necessario aggiungere la visualizzazione delle tracce alla dashboard e definire una query utilizzando l'editor del pannello. L'interrogazione determina i dati che vengono visualizzati nella visualizzazione. Per ulteriori informazioni sull'editor dei pannelli, consultate la [documentazione dell'editor dei pannelli](v10-panels-editor-overview.md).

Questa procedura utilizza variabili e modelli di dashboard per consentire di inserire una traccia IDs che può quindi essere visualizzata. Utilizzerai una variabile chiamata `traceId` e la aggiungerai come query modello.

**Per aggiungere una query di visualizzazione delle tracce**

1. Nel tuo spazio di lavoro, crea una nuova dashboard o vai a una dashboard esistente in cui desideri aggiungere le visualizzazioni delle tracce.

1. Scegli **Aggiungi visualizzazione** da una nuova dashboard o scegli **Aggiungi pannello** su una dashboard esistente.

1. Seleziona la fonte di dati di tracciamento appropriata.

1. **In alto a destra dell'editor del pannello, scegliete la scheda **Visualizzazioni** e selezionate Tracce.**

1. Nelle **opzioni del pannello**, inserite un **titolo per il** pannello di tracciamento. Per ulteriori informazioni sull'editor dei pannelli, consultate[Configura le opzioni del pannello](v10-panels-configure-panel-options.md).

1. Nell'editor di query, seleziona la scheda del tipo di query **TraceQL**.

1.  Inserisci `${traceId}` nel campo di interrogazione TraceQL per creare una variabile del dashboard. Questa variabile viene utilizzata come query del modello.

1. Scegliete **Applica** nell'editor del pannello per aggiungere il pannello alla dashboard.

1. Vai alle **Impostazioni** del pannello di controllo e aggiungi una nuova variabile chiamata`traceId`, di tipo variabile **Personalizzata**, assegnandole un'etichetta, se necessario. Scegli **Applica** per aggiungere la variabile alla dashboard.

1. Verifica che il pannello funzioni utilizzando un ID di traccia valido per l'origine dati utilizzata per il pannello di tracciamento e modificando l'ID nella variabile del dashboard.

## Aggiungere TraceQL con visualizzazioni di tabelle
<a name="v10-panels-traces-traceql"></a>

Sebbene sia possibile aggiungere una visualizzazione di traccia a una dashboard, dover aggiungere manualmente trace IDs come variabile del dashboard è complicato. È più utile invece poter utilizzare le query TraceQL per cercare tipi specifici di tracce e quindi selezionare le tracce appropriate dai risultati corrispondenti.

**Prerequisiti**

Questa procedura presuppone che sia stata completata la procedura precedente.

**Per aggiungere TraceQL con visualizzazioni di tabelle**

1. Nella stessa dashboard in cui hai aggiunto la visualizzazione della traccia, scegli **Aggiungi pannello per aggiungere un nuovo pannello** di visualizzazione.

1. Seleziona la stessa fonte di dati di traccia che hai usato nella sezione precedente.

1. **In alto a destra dell'editor del pannello, seleziona la scheda **Visualizzazioni**, quindi scegli Tabella.**

1. **Nell'editor di query, scegli la scheda TraceQL.**

1. Nelle **opzioni del pannello**, inserisci un **titolo per il** pannello di tracciamento.

1. Aggiungi una query TraceQL appropriata per cercare le tracce che desideri visualizzare nella dashboard. Ad esempio, ecco una semplice query statica proveniente da un server chiamato. *my-server*

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   È possibile scrivere la query TraceQL come query modello per sfruttare altre variabili del dashboard, se esistenti. Ciò consente di creare query dinamiche basate su queste variabili.

Quando i risultati vengono restituiti da una query, i risultati vengono visualizzati nella tabella del pannello.

I risultati della visualizzazione delle tracce includono collegamenti alla pagina **Esplora** che esegue il rendering della traccia. Puoi aggiungere altri link alle tracce nella tabella che compila la variabile del `traceId` dashboard quando selezionata, in modo che la traccia venga visualizzata nella stessa dashboard.

Per creare un set di link dati nel pannello, utilizzate la procedura seguente.

**Per utilizzare una variabile per aggiungere altri collegamenti alle tracce**

1. Nel menu a destra, in **Collegamenti dati**, scegli **Aggiungi link**.

1. Aggiungi un **titolo** per il collegamento dati.

1. Trova il percorso della dashboard cercando nella barra degli indirizzi del browser quando viene visualizzato il pannello di controllo completo. Poiché si tratta di un collegamento a una dashboard nello stesso stack Grafana, è richiesto solo il percorso della dashboard.

   Ad esempio, se il percorso è:

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   Quindi il percorso verso la dashboard è:

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. Nel campo **URL**, crea un riferimento automatico alla dashboard che contiene entrambi i pannelli. Questo riferimento automatico utilizza il valore della traccia selezionata nella tabella per compilare la variabile del dashboard. Utilizza il percorso per la dashboard del passaggio precedente, quindi inserisci il valore dell'`traceId`utilizzo dei risultati selezionati dalla tabella TraceQL. L'ID di traccia viene esposto utilizzando il campo `traceID` dati nei risultati restituiti, quindi utilizzalo come valore per la variabile del dashboard. Esempio:

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. Scegli **Salva** per salvare il link ai dati.

1. Scegliete **Applica** dall'editor del pannello per applicare il pannello alla dashboard.

1. Salva il pannello di controllo.

Ora dovresti vedere un elenco di tracce corrispondenti nella visualizzazione della tabella. Selezionando i campi **TraceID** **o** SpanID avrai la possibilità di aprire la pagina Esplora per visualizzare **la** traccia o di seguire il collegamento dei dati, selezionando qualsiasi altro campo (ad esempio`Start time`, `Duration` o) segue automaticamente il collegamento dati`Name`, compilando la variabile del dashboard e quindi mostrando `traceId` la traccia pertinente nel pannello di traccia. 

# Tendenza
<a name="v10-panels-trend"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 visualizzazioni delle tendenze devono essere utilizzate per set di dati che hanno una X numerica sequenziale che non indica il tempo. Alcuni esempi sono i grafici delle funzioni, le rpm/torque curve, le relazioni tra domanda e offerta e i grafici dell'altitudine o della frequenza cardiaca lungo un percorso di gara (con x come distanza o durata dalla partenza).

Le visualizzazioni delle tendenze supportano tutti gli stili e le opzioni visivi disponibili nella visualizzazione delle serie [temporali](v10-panels-time-series.md) con le seguenti eccezioni:
+ Nessuna annotazione o regione temporale
+ Nessun cursore (o mirino) condiviso
+ Nessun asse x con più fusi orari
+ Nessuna possibilità di modificare l'intervallo di tempo del pannello di controllo tramite selezione mediante trascinamento

**X Selezione del campo**

Utilizzate questa opzione per selezionare un campo che contiene valori numerici crescenti.

 Ad esempio, è possibile rappresentare la potenza e la coppia del motore rispetto alla velocità, dove la velocità viene tracciata sull'asse x e la potenza e la coppia sugli assi y.

# Grafico XY
<a name="v10-panels-xychart"></a>

I grafici XY forniscono un modo per visualizzare valori x e y arbitrari in un grafico in modo da poter mostrare facilmente la relazione tra due variabili. I grafici XY vengono in genere utilizzati per creare grafici a dispersione. È inoltre possibile utilizzarli per creare grafici a bolle, in cui i valori dei campi determinano la dimensione di ogni bolla.

![\[Un'immagine che mostra un esempio di visualizzazione del grafico XY in Grafana.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/viz/xy-chart-example.png)


## Formati di dati supportati
<a name="v10-panels-xychart-formats"></a>

È possibile utilizzare qualsiasi tipo di dati tabulari con almeno due campi numerici in un grafico XY. Questo tipo di visualizzazione non richiede dati temporali.

## Opzioni del pannello
<a name="v10-panels-xychart-paneloptions"></a>

Nella sezione **Opzioni del pannello** del riquadro dell'editor del pannello, impostate le opzioni di base come il titolo e la descrizione del pannello. In questa sezione puoi anche configurare pannelli ripetuti. Per ulteriori informazioni, consulta [Configura le opzioni del pannello](v10-panels-configure-panel-options.md).

## Opzioni del grafico XY
<a name="v10-panels-xychart-options"></a>

**Mappatura delle serie**

Imposta il modo in cui i dati delle serie vengono mappati nel grafico.
+ **Automatico**: genera automaticamente serie da tutti i frame di dati (o set di dati) disponibili. È possibile filtrare per selezionare solo un frame.
+ **Manuale**: definisci in modo esplicito la serie selezionando tra i frame di dati disponibili.

A seconda della mappatura della serie selezionata, le opzioni **Frame**, **X-field e **Y-field**** sono diverse. Le sezioni Mappatura automatica e manuale delle serie descrivono queste diverse opzioni.

**Opzioni di mappatura automatica delle serie**

Quando selezionate **Auto** come modalità di mappatura delle serie, le seguenti opzioni sono preconfigurate, ma potete anche definirle voi stessi.
+ **Frame**: per impostazione predefinita, un grafico XY mostra tutti i frame di dati. È possibile filtrare per selezionare solo un frame.
+ **Campo X**: seleziona il campo rappresentato da X. Per impostazione predefinita, questo è il primo campo numerico in ogni frame di dati.
+ **Campo Y**: dopo aver impostato il campo X, per impostazione predefinita, tutti i campi numerici rimanenti nel frame di dati vengono designati come campi Y. È possibile utilizzare questa opzione per scegliere esplicitamente quali campi utilizzare per Y.

  Le serie del grafico sono generate dai campi Y. Per apportare modifiche a una serie in un grafico XY, sostituisci il campo Y. Qualsiasi campo utilizzato nel campo Dimensione o Colore non genera una serie.

  Puoi anche utilizzare le sostituzioni per escludere i campi Y singolarmente. A tale scopo, aggiungi un override con le seguenti proprietà per ogni campo Y che desideri rimuovere:
  + **Tipo di override: campi con nome**
  + Sostituisci proprietà: **Serie > Nascondi** nell'area
  + **Zona: Viz**

**Opzioni di mappatura manuale delle serie**

Quando selezioni **Manuale** come modalità delle serie, puoi aggiungere, modificare ed eliminare le serie. Per gestire una serie, seleziona il campo **Serie**. Per rinominare la serie, seleziona il nome della serie.

In modalità **Manuale**, è necessario impostare le seguenti opzioni:
+ **Frame**: seleziona il frame di dati o il set di dati. Puoi aggiungere tutti i frame che desideri.
+ **Campo X**: seleziona il campo rappresentato da X.
+ **Campo Y**: seleziona il campo rappresentato da Y.

**Campo relativo alle dimensioni**

Usa questa opzione per impostare i valori del campo che controllano la dimensione dei punti nel grafico. Questo valore è relativo al valore minimo e massimo di tutti i valori nel frame di dati.

Quando si seleziona questa opzione, è possibile impostare le opzioni relative alla dimensione minima e massima in punti.

**Campo di colore**

Usa questa opzione per impostare i valori del campo che controllano il colore dei punti nel grafico. Per utilizzare le opzioni di valore del colore nelle **opzioni Standard**, è necessario impostare questo campo.

In genere, questa opzione viene utilizzata quando nel grafico è visualizzata una sola serie.

**Mostra**

Imposta il modo in cui i valori vengono rappresentati nella visualizzazione.
+ **Punti**: visualizza i valori come punti. Quando si seleziona questa opzione, viene visualizzata anche l'opzione relativa alla dimensione in punti.
+ **Righe**: aggiunge una linea tra i valori. Quando si seleziona questa opzione, vengono visualizzate anche le opzioni relative allo stile e allo spessore della linea.
+ **Entrambi**: visualizza sia i punti che le linee.

**Dimensione in punti**

Imposta la dimensione di tutti i punti del grafico, da uno a 100 pixel di diametro. La dimensione predefinita è di cinque pixel. È possibile impostare un override per impostare la dimensione dei pixel per serie (campo Y).

**Dimensione min/massima in punti**

Usa queste opzioni per controllare la dimensione minima o massima in punti quando hai impostato l'opzione **Dimensione** del campo. Puoi sovrascrivere queste opzioni per serie specifiche.

**Stile della riga**

Imposta lo stile della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard.
+ **Solido**: visualizza una linea continua. Questa è l'impostazione predefinita.
+ **Dash**: visualizza una linea tratteggiata. Quando si sceglie questa opzione, viene visualizzato un elenco a discesa in cui è possibile selezionare l'impostazione della lunghezza e dello spazio per i trattini delle linee. Per impostazione predefinita, la lunghezza e lo spazio sono impostati su. `10, 10`
+ **Punti**: visualizza linee tratteggiate. Quando si sceglie questa opzione, viene visualizzato un elenco a discesa in cui è possibile selezionare la spaziatura tra i punti. Per impostazione predefinita, la spaziatura tra i punti è impostata su `0, 10` (il primo numero rappresenta la lunghezza dei punti ed è sempre zero).

**Larghezza della linea**

Imposta la larghezza delle linee, in pixel.

## Opzioni del tooltip
<a name="v10-panels-xychart-tooltipoptions"></a>

Le opzioni del tooltip controllano la sovrapposizione di informazioni che appare quando passi il mouse sui punti dati nel grafico.

**modalità Tooltip**
+ **Singola**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui si sta posizionando il mouse.
+ **Nascosto**: non visualizzare il tooltip quando interagisci con la visualizzazione.

Utilizzate un override per nascondere le singole serie dal tooltip.

**Altezza massima**

Imposta l'altezza massima della casella del tooltip. L'impostazione predefinita è 600 pixel.

## Opzioni relative alla legenda
<a name="v10-panels-xychart-legendoptions"></a>

Le opzioni relative alla legenda controllano i nomi e le statistiche delle serie che appaiono sotto o a destra del grafico. Per ulteriori informazioni sulla legenda, vedere[Configurare una legenda](v10-panels-configure-legend.md).

**Visibilità**

Attiva o disattiva l'interruttore per attivare o disattivare la legenda.

**Mode** (Modalità)

Utilizza queste impostazioni per definire come appare la legenda nella visualizzazione.
+ **Elenco**: visualizza la legenda sotto forma di elenco. Questa è la modalità di visualizzazione predefinita di una legenda.
+ **Tabella**: visualizza la legenda come tabella.

**Posizionamento**

Scegli dove visualizzare la legenda.
+ **In basso**: sotto il grafico.
+ A **destra**: a destra del grafico.

**Valori**

Scegliete quali [calcoli standard](v10-panels-calculation-types.md) mostrare nella legenda. Puoi averne più di uno.

**Width** (Larghezza)

Controlla la larghezza della legenda quando viene posizionata sul lato destro della visualizzazione. Questa opzione viene visualizzata solo se si imposta la posizione della legenda su **Destra**.

## Opzioni degli assi
<a name="v10-panels-xychart-axis"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 fate clic all'esterno della casella delle opzioni del campo che state modificando. Puoi anche premere`Enter`.

**Posizionamento (asse y)**

Seleziona il posizionamento dell'asse Y. Le opzioni sono:
+ **Automatico**: 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.

Per nascondere selettivamente gli assi, [aggiungi un campo override](v10-panels-configure-overrides.md) destinato a campi specifici.

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

**Mostra le linee della griglia**

Imposta la visibilità della linea della griglia dell'asse.
+ **Automatico**: mostra automaticamente le linee della griglia in base alla densità dei dati.
+ **Attivo**: mostra sempre le linee della griglia.
+ **Disattivata**: non mostra mai le linee della griglia.

**Color** (Colore)

Imposta il colore dell'asse.
+ **Testo**: imposta il colore in base al colore del testo del tema.
+ **Serie**: imposta il colore in base al colore della serie.

**Mostra bordo**

Imposta la visibilità del bordo dell'asse.

**Dimensionamento**

Imposta la scala dei valori dell'asse y.
+ **Lineare**: divide la scala in parti uguali.
+ **Logaritmica: utilizza una scala logaritmica**. Quando si seleziona questa opzione, viene visualizzato un elenco in cui scegliere una scala logaritmica binaria (base 2) o comune (base 10).
+ **Symlog**: utilizza una scala logaritmica simmetrica. Quando si seleziona questa opzione, viene visualizzato un elenco in cui scegliere una scala logaritmica binaria (base 2) o comune (base 10). L'opzione di soglia lineare consente di impostare la soglia alla quale la scala passa da lineare a logaritmica.

*Zero centrato*

Imposta l'asse y in modo che sia centrato su zero.

**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 possono impedire l'ingrandimento di piccole variazioni nei dati quando sono per lo più piatti. Al contrario, i valori hard min e max aiutano a evitare di oscurare i dettagli utili dei dati, eliminando i picchi intermittenti oltre un punto specifico.

Per definire limiti rigidi dell'asse y, impostate le opzioni standard. min/max Per ulteriori informazioni, consulta [Configurare le opzioni standard](v10-panels-configure-standard-options.md).

**Transform** (Trasforma)

Utilizzate questa opzione per trasformare i valori della serie senza influire sui valori mostrati nella descrizione comandi, nei menu contestuali o nella legenda. 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.

**Nota**  
L'opzione di trasformazione è disponibile solo come alternativa.

**Visualizza più assi y**

In alcuni casi si desidera visualizzare più assi y. Ad esempio, se disponi di un set di dati che mostra sia la temperatura che l'umidità nel tempo, puoi mostrare due assi y con unità diverse per queste due serie.

[Per visualizzare più assi y, aggiungi un campo override.](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field) Segui i passaggi tutte le volte necessarie per aggiungere tutti gli assi y necessari.

## Opzioni standard
<a name="v10-panels-xychart-standard"></a>

**Le opzioni standard** dell'editor dei pannelli consentono di modificare la modalità di visualizzazione dei dati dei campi nella visualizzazione. Quando impostate un'opzione standard, la modifica viene applicata a tutti i campi o a tutte le serie. Per un controllo più granulare sulla visualizzazione dei campi, fare riferimento a[Configura le sostituzioni dei campi](v10-panels-configure-overrides.md).

È possibile personalizzare le seguenti opzioni standard:
+ **Campo min/max**: abilita **Field min/max per consentire a** Grafana di calcolare il minimo o il massimo di ogni campo singolarmente, in base al valore minimo o massimo del campo.
+ **Combinazione di colori**: imposta colori singoli o multipli per l'intera visualizzazione.

Per ulteriori informazioni, consulta [Configurazione delle opzioni standard](v10-panels-configure-standard-options.md).

## Collegamenti dati
<a name="v10-panels-xychart-datalinks"></a>

I link dati consentono di collegarsi ad altri pannelli, dashboard e risorse esterne mantenendo il contesto del pannello sorgente. È possibile creare collegamenti che includono il nome della serie o anche il valore sotto il cursore.

Per ogni collegamento dati, impostate le seguenti opzioni:
+ **Titolo**
+ **URL**
+ **Apri in una nuova scheda**

Per ulteriori informazioni, consulta [Configurare i collegamenti dati](v10-panels-configure-data-links.md).

## Sostituzioni dei campi
<a name="v10-panels-xychart-fieldoverrides"></a>

Le sostituzioni consentono di personalizzare le impostazioni di visualizzazione per campi o serie specifici. Quando aggiungi una regola di esclusione, puoi scegliere come target un particolare set di campi e definire più opzioni per la modalità di visualizzazione di tali campi.

Scegliete una delle seguenti opzioni di sostituzione:
+ **Campi con nome**: seleziona un campo dall'elenco di tutti i campi disponibili.
+ **Campi con espressione regolare corrispondente al nome:** specifica i campi da sovrascrivere con un'espressione regolare.
+ **Campi con tipo**: seleziona i campi per tipo, ad esempio stringa, numerico o orario.
+ **Campi restituiti dalla query**: seleziona tutti i campi restituiti da una query specifica.
+ **Campi con valori**: seleziona tutti i campi restituiti dalla condizione di riduzione definita, ad esempio **Min**, **Max**, **Count** o **Total**.

Per ulteriori informazioni, consulta [Configura le sostituzioni dei campi](v10-panels-configure-overrides.md).

# Esplora nella versione 10 di Grafana
<a name="v10-explore"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

Questa pagina ti consentirà di iniziare a esplorare i tuoi dati. I seguenti argomenti forniscono maggiori dettagli sulle funzionalità e sugli usi specifici di Explore.
+ [Gestione delle query in Explore](v10-explore-manage.md)
+ [Accedi a Explore](v10-explore-logs.md)
+ [Tracciamento in Explore](v10-explore-tracing.md)
+ [Editor di correlazioni in Explore](v10-explore-correlations.md)
+ [Inspector in Explore](v10-explore-inspector.md)

## Inizia a esplorare
<a name="v10-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.

   Puoi anche scegliere **Open advanced data source picker** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo per gli amministratori).

1. Scrivi l'interrogazione utilizzando l'editor di query fornito dall'origine dati selezionata.

   Per ulteriori dettagli sulle interrogazioni, vedere. [Interroga e trasforma i dati](v10-panels-query-xform.md)

1. Esegui la query utilizzando il pulsante nell'angolo in alto a destra.

## Dividi e confronta
<a name="v10-explore-compare"></a>

La visualizzazione divisa offre un modo semplice per confrontare le visualizzazioni side-by-side o per esaminare i dati correlati in un'unica pagina.

**In alto apri la 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, i timepicker di entrambi i pannelli possono essere collegati (se ne modificate uno, anche l'altro viene modificato) 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, scegliete il pulsante **Chiudi divisione**.

## Struttura del contenuto
<a name="v10-explore-outline"></a>

La struttura del contenuto è una barra di navigazione laterale che tiene traccia delle query e delle visualizzazioni create in Explore. Ti consente di navigare rapidamente tra di loro.

La struttura del contenuto funziona anche in una visualizzazione divisa. Quando si utilizza la visualizzazione divisa, la struttura del contenuto viene generata per ogni riquadro.

**Per aprire la struttura del contenuto**

1. Seleziona il pulsante **Struttura** nell'angolo in alto a sinistra della schermata **Esplora**.

1. Seleziona un'icona del pannello nella struttura del contenuto per accedere a quel pannello.

## Condividi Esplora URLs
<a name="v10-explore-shareurl"></a>

Quando usi Explore, l'URL nella barra degli indirizzi del browser si aggiorna man mano che apporti modifiche alle query. Puoi condividere o aggiungere questo URL ai preferiti.

**Nota**  
Explore può generare un periodo relativamente lungo URLs. Puoi anche generare e condividere un [link abbreviato](#v10-explore-share) se l'URL è troppo lungo per i tuoi strumenti.

**Generazione di Explore URLs da strumenti esterni**

Poiché Explore URLs ha una struttura definita, puoi creare un URL da strumenti esterni e aprirlo in Grafana. La struttura dell'URL è:

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

dove:
+ `org_id`è l'ID dell'organizzazione
+ `schema_version`è la versione dello schema (deve essere impostata sulla versione più recente, ovvero`1`.
+ `panes`è un oggetto JSON composto da riquadri con codifica URL, in cui ogni chiave è l'ID del riquadro e ogni valore è un oggetto che corrisponde allo schema seguente:

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**Nota**  
I `to` campi `from` and accettano anche gli intervalli relativi, come descritto nell'argomento. [Impostazione dell'intervallo di tempo della dashboard](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range)

## Condividi link abbreviato
<a name="v10-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. Se un link viene utilizzato almeno una volta, non verrà eliminato.

**Condivisione di link abbreviati con tempo assoluto**

I link brevi hanno due opzioni: mantenere l'ora relativa (ad esempio, da due ore fa all'ora corrente) o l'ora assoluta (ad esempio, dalle 8:00 alle 10:00). La condivisione di un link abbreviato per impostazione predefinita copierà l'intervallo di tempo selezionato, relativo o assoluto. Scegliendo il pulsante a discesa accanto al pulsante di condivisione del link abbreviato e selezionando una delle opzioni in **Time-Sync URL Links** potrai creare un link breve con l'ora assoluta, il che significa che chiunque riceva il link vedrà gli stessi dati che stai vedendo, anche se apre il link in un altro momento. Questa opzione non influirà sull'intervallo di tempo selezionato nella vista Esplora.

# Gestione delle query in Explore
<a name="v10-explore-manage"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 gestire le query che hai creato in Explore, inclusa una cronologia delle query che hai eseguito e delle query che hai inserito come preferiti.

## Cronologia delle query
<a name="v10-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.

## Visualizzazione della cronologia delle query
<a name="v10-explore-manage-history-view"></a>

La cronologia delle interrogazioni consente di visualizzare la cronologia delle interrogazioni. Per ogni singola interrogazione, puoi:
+ Eseguire la 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 domande preferite
<a name="v10-explore-manage-history-favorites"></a>

Tutte le interrogazioni che sono state contrassegnate come speciali nella scheda Cronologia delle interrogazioni vengono visualizzate nella scheda Speciali. Ciò consente di accedere più rapidamente alle query preferite e di riutilizzarle senza doverle digitare da zero.

## Ordinamento della cronologia delle interrogazioni
<a name="v10-explore-manage-history-sort"></a>

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
<a name="v10-explore-manage-history-filter"></a>

Puoi filtrare la cronologia delle query nella scheda Cronologia delle query e Speciali in base a una fonte di dati specifica.

**Per 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.

**Nota**  
Le query eseguite utilizzando l'origine dati mista verranno visualizzate solo quando si filtra per l'origine mista e non quando si filtra in base alle singole fonti di dati.

Nella scheda **Cronologia delle query** è anche possibile filtrare le query per data utilizzando il cursore:
+ Usa il cursore verticale per filtrare le query per data.
+ Regola la data di inizio trascinando la maniglia inferiore.
+ Regola la data di fine trascinando la maniglia superiore.

## Ricerca nella cronologia delle interrogazioni
<a name="v10-explore-manage-history-search"></a>

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
<a name="v10-explore-manage-history-settings"></a>

È possibile personalizzare la cronologia delle interrogazioni nella scheda Impostazioni. Le opzioni sono descritte nella tabella seguente.


| Impostazione | Valore predefinito | 
| --- | --- | 
| Modificare 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.

# Accedi a Explore
<a name="v10-explore-logs"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 ti consente di esaminare i tuoi log in diverse fonti di dati, tra cui:
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-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 i log con altri segnali di telemetria come metriche, tracce o profili, visualizzandoli. side-by-side

I risultati delle query di registro vengono visualizzati come singole righe di registro e come un grafico che mostra il volume dei log per il periodo di tempo selezionato.

## Volume dei registri
<a name="v10-explore-logs-volume"></a>

Quando si lavora con fonti di dati che supportano un volume di log a gamma completa, Explore visualizza automaticamente un grafico che mostra la distribuzione dei log per tutte le query di log inserite. Questa funzionalità è attualmente supportata dalle fonti di dati OpenSearch e Loki.

**Nota**  
In Loki, questo volume di log a intervallo completo viene reso mediante una query metrica che può essere costosa a seconda dell'intervallo di tempo richiesto. Questa query può essere particolarmente difficile da elaborare per installazioni Loki più piccole. Per mitigare questo problema, puoi usare 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 la fonte di dati non supporta il caricamento dell'intero volume di log dell'intervallo, il modello di log calcola una serie temporale contando le righe di registro e organizzandole in bucket in base a un intervallo di tempo calcolato automaticamente. Il timestamp della prima riga di registro viene utilizzato per ancorare l'inizio del volume dei log nei risultati. **La fine della serie temporale è ancorata all'intervallo To del selettore orario.** In questo modo, puoi comunque analizzare e visualizzare i dati di registro in modo efficiente anche quando la fonte di dati non offre un supporto completo.

## Log
<a name="v10-explore-logs-overview"></a>

Nelle sezioni seguenti, troverai spiegazioni dettagliate su come visualizzare e interagire con i singoli log in Explore.

## Navigazione nei log
<a name="v10-explore-logs-navigation"></a>

La navigazione dei log, sul lato destro delle righe dei log, può essere utilizzata per richiedere facilmente registri aggiuntivi. Puoi farlo facendo clic sul pulsante **Log precedenti** nella parte inferiore della navigazione. Ciò è particolarmente utile quando raggiungi il limite di righe e desideri visualizzare più registri. Ogni richiesta eseguita dalla navigazione viene quindi visualizzata nella navigazione come pagina separata. Ogni pagina mostra `from` e `to` ora delle righe di registro in entrata. Puoi vedere i risultati precedenti facendo clic su ciascuna pagina. Explore memorizza le cache in cui vengono eseguite le ultime cinque richieste dalla navigazione dei log, in modo da non dover rieseguire le stesse query quando si fa clic sulle pagine, risparmiando tempo e risorse.

## Opzioni di visualizzazione
<a name="v10-explore-log-visualization-options"></a>

 È possibile personalizzare la modalità di visualizzazione dei registri e selezionare le colonne da visualizzare. 


| Opzione | Description | 
| --- | --- | 
| 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 | Imposta questa opzione true se desideri che il display utilizzi l'avvolgimento delle linee. Se impostato sufalse, 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. Le corrispondenze esatte vengono eseguite sull'intera riga ad eccezione dei campi data. Le corrispondenze dei numeri vengono eseguite sulla riga dopo aver eliminato numeri come durate, indirizzi IP e così via. La firma è la deduplicazione più aggressiva in quanto rimuove tutte le lettere, i numeri e le corrispondenze dagli spazi bianchi e dalla punteggiatura rimanenti. | 
| Visualizza 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). | 

## Scarica le righe di registro
<a name="v10-explore-download-log-lines"></a>

Per scaricare i risultati del registro in uno `txt` dei due `json` formati, utilizzate il pulsante **Download**. Questa funzione consente di salvare i dati di registro per ulteriori analisi o di condividerli con altri in un formato comodo e accessibile.

## Registra le meta-informazioni sui risultati
<a name="v10-explore-log-result-meta-information"></a>

Sopra le righe di registro ricevute puoi trovare le meta-informazioni essenziali, tra cui:
+ **Numero di log ricevuti**: indica il numero totale di log ricevuti per la query o l'intervallo di tempo corrente.
+ **Errore**: visualizza un possibile errore nei risultati del registro.
+ **Etichette comuni**: mostra le etichette comuni.
+ **Byte totali elaborati**: rappresenta la dimensione cumulativa dei dati di registro elaborati in byte.

**Nota**  
La disponibilità di determinate meta informazioni può dipendere dall'origine dei dati e, di conseguenza, è possibile visualizzare solo alcuni di questi dettagli per fonti di dati specifiche.

## Sfuggire alle nuove righe
<a name="v10-explore-log-escaping-newlines"></a>

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 un'opzione Escape newlines.**

**Per correggere automaticamente le sequenze con escape errato rilevate da Explore**

1. Scegliete **Escape newlines** per sostituire le sequenze.

1. Esamina 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.**

## Livello di log
<a name="v10-explore-log-level"></a>

Per i log in cui viene specificata un'`level`etichetta, utilizziamo il valore di questa etichetta per determinare il livello di registro e aggiornare di conseguenza il colore di ogni riga di registro. Se il log non ha un'etichetta di livello specificata, cerchiamo di scoprire se il suo contenuto corrisponde a una delle espressioni supportate (vedi la tabella seguente per maggiori informazioni). Il livello di registro è sempre determinato dalla prima corrispondenza. Nel caso in cui Grafana non sia in grado di dedurre un campo a livello di registro, verrà visualizzato con un livello di log sconosciuto.

**Nota**  
Se utilizzi una fonte di dati Loki e `level` fa parte della tua riga di registro, puoi utilizzare i parser (JSON, logfmt, regex,..) per estrarre le informazioni sul livello in un'etichetta di livello che viene utilizzata per determinare il valore del livello. Ciò consentirà all'istogramma di mostrare i vari livelli di log come barre separate.

**Livelli di registro supportati e mappatura delle abbreviazioni e delle espressioni a livello di registro:** 


| Livello di log | Colore | Espressioni supportate | 
| --- | --- | --- | 
| critico | viola | emergenza, fatale, allerta, critica, critica | 
| error | rosso | Errore, errore, errore | 
| attenzione | giallo | avvertire, avvertire | 
| Info | verde | info, informazioni, informazioni, avvisi | 
| debug | blu | debug, debug | 
| trace | blu chiaro | trace | 
| sconosciuto | grigio | \$1 | 

## Evidenzia parole cercate
<a name="v10-explore-highlight-searched-words"></a>

Se la query include parole o espressioni specifiche da cercare, Explore le evidenzierà nelle righe di registro per una migliore visibilità. Questa funzione di evidenziazione semplifica l'identificazione e la messa a fuoco dei contenuti pertinenti nei log.

**Nota**  
La capacità di evidenziare le parole di ricerca può variare a seconda della fonte dei dati. Per alcune fonti di dati, l'evidenziazione delle parole di ricerca potrebbe non essere disponibile.

## Visualizzazione dei dettagli del registro
<a name="v10-explore-log-details-view"></a>

In Explore, ogni riga di registro ha una sezione espandibile denominata *Dettagli di registro* che può essere aperta scegliendo la riga di registro. La visualizzazione dei dettagli del registro fornisce informazioni aggiuntive e opzioni di esplorazione sotto forma di *campi* e *collegamenti* allegati alle righe di registro, che consentono un'interazione e un'analisi più solide.

**Campi**

Nella visualizzazione dei dettagli del registro, è possibile filtrare i campi visualizzati in due modi: un filtro positivo (per concentrarsi su un campo specifico) e un filtro negativo (per escludere determinati campi). Questi filtri aggiorneranno la query corrispondente che ha prodotto la riga di registro, aggiungendo di conseguenza le espressioni di uguaglianza e disuguaglianza. Se la fonte di dati supporta, come nel caso di Loki e OpenSearch, i dettagli del registro controlleranno se il campo è già presente nella query corrente mostrando lo stato attivo (solo per i filtri positivi), permettendoti di disattivarlo dalla query o di cambiare l'espressione del filtro da positiva a negativa.

Puoi selezionare un sottoinsieme di campi da visualizzare nell'elenco dei log anziché nella riga completa del registro facendo clic sull'icona a forma di occhio. Ogni campo ha un'icona delle statistiche per visualizzare le statistiche relative a tutti i log visualizzati.

**Link**

Grafana offre la funzionalità di collegamenti o correlazioni di dati, che consente di convertire qualsiasi parte di un messaggio di registro in un collegamento interno o esterno. Questi collegamenti possono essere utilizzati per accedere a dati correlati o risorse esterne, fornendo un modo semplice e conveniente per esplorare ulteriori informazioni.

## Contesto del registro
<a name="v10-explore-log-context"></a>

Il contesto di registro visualizza righe di contesto aggiuntive che circondano una voce di registro che corrisponde a una particolare query di ricerca. Questo può essere utile per comprendere il contesto della voce di registro ed è simile al `-C` parametro del `grep` comando.

È possibile che si verifichino lunghe righe di testo che rendono difficile la lettura e l'analisi del contesto relativo a ciascuna voce di registro. È qui che l'interruttore **Wrap lines** può tornare utile. Attivando questo interruttore, Grafana avvolgerà automaticamente lunghe righe di testo in modo che rientrino nella larghezza visibile del visualizzatore. Ciò può semplificare la lettura e la comprensione delle voci di registro. 

 Il pulsante **Apri in visualizzazione divisa** consente di eseguire la query contestuale per una voce di registro in una schermata divisa nella vista Esplora. Scegliendo questo pulsante si aprirà un nuovo riquadro Esplora con l'interrogazione contestuale visualizzata accanto alla voce di registro, semplificando l'analisi e la comprensione del contesto circostante.

La query contestuale del registro può anche essere aperta in una nuova scheda del browser premendo il tasto `Ctrl` (o`Cmd`) mentre si sceglie il pulsante per aprire la modalità contestuale. Quando viene aperta in una nuova scheda, vengono applicati anche i filtri selezionati in precedenza.

## Copia la riga di registro
<a name="v10-explore-copy-log-line"></a>

È possibile copiare facilmente il contenuto di una riga di registro selezionata negli appunti scegliendo il pulsante **Copia riga di registro**.

## Copia il link nella riga di registro
<a name="v10-explore-copy-link-to-log-line"></a>

Il collegamento delle righe di registro in Grafana consente di navigare rapidamente verso voci di registro specifiche per un'analisi precisa. Scegliendo il pulsante **Copia collegamento breve** per una riga di registro, è possibile generare e copiare un breve URL che fornisce l'accesso diretto alla voce esatta del registro entro un intervallo di tempo assoluto. Quando apri il link, Grafana scorrerà automaticamente fino alla riga di registro corrispondente e la evidenzierà con uno sfondo blu, facilitando l'identificazione e la concentrazione delle informazioni pertinenti.

**Nota**  
Questa funzionalità è supportata solo in Loki e in altre fonti di dati che forniscono un `id` campo.

## Tailing dal vivo
<a name="v10-explore-log-live-tailing"></a>

Per visualizzare i log in tempo reale dalle fonti di dati supportate, puoi sfruttare la funzione Live Tailing di Explore.

**Per visualizzare i log in tempo reale con live tailing**

1. Scegli il pulsante **Live** nella barra degli strumenti Esplora per passare alla visualizzazione Live tail.

1. Nella visualizzazione Live Tail, i nuovi log appariranno nella parte inferiore dello schermo e avranno uno sfondo a contrasto sbiadito, che ti permetterà di tracciare facilmente le novità.

1. Se desideri mettere in pausa il Live Tailing ed esplorare i log precedenti senza interruzioni, puoi farlo scegliendo il pulsante **Pausa** o semplicemente scorrendo la visualizzazione dei log.

1. **Per cancellare la visualizzazione e rimuovere tutti i log dal display, scegli il pulsante Cancella registri.** Questa azione ripristinerà la visualizzazione del registro e ti fornirà una tabula rasa per continuare l'analisi dei log.

1. **Per riprendere Live Tailing e continuare a visualizzare i log in tempo reale, scegli il pulsante Riprendi.**

1. **Se desideri uscire da Live Tailing e tornare alla visualizzazione standard Esplora, scegli il pulsante Stop.**

Utilizzando la funzione Live tailing, puoi tenere d'occhio i log più recenti man mano che arrivano, facilitando il monitoraggio degli eventi in tempo reale e l'individuazione tempestiva dei problemi.

**Esempio di log**

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.

**Passa dalle metriche ai log**

 Se provieni da un'origine dati di metrica che implementa `DataSourceWithQueryExportSupport` (come Prometheus) a un'origine di dati di registrazione che supporta `DataSourceWithQueryImportSupport` (come Loki), allora manterrà le etichette della tua query che esistono nei log e le userà per interrogare i flussi di log.

Ad esempio, la seguente `grafana_alerting_active_alerts{job='grafana'}` query Prometheus dopo il passaggio all'origine dati Loki, cambierà in. `{job='grafana'}` Ciò restituirà un blocco di log nell'intervallo di tempo selezionato in cui è possibile eseguire la ricerca. grepped/text 

# Tracciamento in Explore
<a name="v10-explore-tracing"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 usare Explore per visualizzare le tracce provenienti da fonti di dati di tracciamento.

Sono supportate le origini dati seguenti.
+ [Tempo](tempo-data-source.md) (formati di inserimento supportati: Jaeger e OpenTelemetry Zipkin)
+ [Jaeger](jaeger-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.

## Editor della query
<a name="v10-explore-trace-queryeditor"></a>

Puoi interrogare e cercare dati di tracciamento utilizzando l'editor di query di un'origine dati.

Ogni fonte di dati può avere il proprio editor di query. L'editor di query per l'origine dati Tempo è leggermente diverso dall'editor di query per l'origine dati Jaeger.

Per informazioni sull'interrogazione di ciascuna fonte di dati, consulta la relativa documentazione.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## Spiegazione di Trace View
<a name="v10-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.
+ Cerca: evidenzia le aree contenenti il testo cercato.
+ Metadati: vari metadati relativi alla 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 ripristina lo zoom.**

**Filtri Span**

Utilizzando i filtri Span, puoi filtrare gli intervalli nel visualizzatore della timeline di traccia. Più filtri aggiungi, più specifici sono gli intervalli filtrati.

Puoi aggiungere uno o più dei seguenti filtri:
+ Nome del servizio di risorse
+ Nome Span
+ Durata
+ Tag (che includono tag, tag di processo e campi di registro)

Per mostrare solo gli intervalli corrispondenti, scegli l'interruttore **Mostra solo corrispondenze**.

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

Scegliendo la riga di estensione vengono visualizzati i dettagli relativi all'estensione, 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.

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

Scegliete l'icona del documento per aprire una vista divisa in Explore con l'origine dati configurata e interrogare i log pertinenti per l'intervallo.

**Ricalca le metriche**

**Nota**  
Questa funzionalità è attualmente in versione beta

Puoi passare da un intervallo in una vista di traccia direttamente alle metriche pertinenti per quell'intervallo. Questa funzione è disponibile per le sorgenti dati Tempo, Jaeger e Zipkin. Fate riferimento alla loro documentazione pertinente per i dettagli sulla configurazione.

**Traccia fino ai profili**

Utilizzando Trace to profiles, puoi sfruttare la capacità di Grafana di correlare segnali diversi aggiungendo la funzionalità di collegamento tra tracce e profili.

## Grafico dei nodi
<a name="v10-explore-trace-node-graph"></a>

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.

## Visualizzazione del grafico dei servizi
<a name="v10-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 dell'origine 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 *Grafana Labs Tempo.*

## Data API (API dati).
<a name="v10-explore-trace-dataapi"></a>

Questa visualizzazione richiede una forma specifica dei dati da restituire dalla fonte dei dati per visualizzarli correttamente.

L'origine dati deve restituire il frame e il set `frame.meta.preferredVisualisationType = 'trace'` di dati.

**Struttura del frame di dati**

Campi obbligatori;


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
| TraceID | stringa | Identificatore per l'intera traccia. Dovrebbe esserci una sola traccia nel frame di dati. | 
| SPanID | stringa | Identificatore per l'intervallo corrente. L'intervallo IDs deve essere unico per traccia. | 
| ParentsPanID | stringa | spanID dello span principale per creare una relazione genitore-figlio nella vista trace. Può essere utilizzato undefined per root span senza un genitore. | 
| serviceName | stringa | Nome del servizio di cui fa parte questo span. | 
| ServiceTags | TraceKeyValuePair[] | Elenco dei tag rilevanti per il servizio. | 
| startTime | numero | Ora di inizio dell'intervallo in millisecondi. | 
| durata | numero | Durata dell'intervallo in millisecondi. | 

 Campi opzionali: 


| Nome del campo | Tipo | Description | 
| --- | --- | --- | 
| log | TraceLog[] | Elenco dei log associati all'intervallo corrente. | 
| tag | TraceKeyValuePair[] | Elenco dei tag associati all'intervallo corrente. | 
| avvisi | stringa [] | Elenco degli avvisi associati all'intervallo corrente. | 
| StackTraces | stringa [] | Elenco delle tracce dello stack associate all'intervallo corrente. | 
| errorIconColor | stringa | Colore dell'icona di errore nel caso in cui span sia etichettato con. error: true | 

Per informazioni dettagliate sui tipi [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), vedere [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)e oltre [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12). GitHub

# Editor di correlazioni in Explore
<a name="v10-explore-correlations"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 correlazioni consentono agli utenti di creare un collegamento tra due fonti di dati qualsiasi. Per ulteriori informazioni, inclusa una panoramica delle correlazioni, vedere. [Correlazioni nella versione 10 di Grafana](v10-correlations.md)

## Creazione di una correlazione
<a name="v10-explore-corr-create-a-correlation"></a>

Puoi creare correlazioni dalla pagina Esplora.

**Per creare una correlazione**

1. Nel tuo spazio di lavoro Amazon Managed Grafana, vai alla pagina Esplora.

1. Seleziona una fonte di dati che desideri utilizzare come fonte per una nuova correlazione.

1. Esegui una query che produce dati in una visualizzazione supportata.
**Nota**  
[Le visualizzazioni supportate sono [Logs](v10-panels-logs.md) e Table.](v10-panels-table.md)

1. [Scegli **\$1 Aggiungi** nella barra degli strumenti in alto e seleziona **Aggiungi correlazione** (puoi anche selezionare **Correlations** Editor dalla palette dei comandi).](v10-search.md#v10-search-palette)

   Esplora è ora in modalità Correlation Editor, indicata da un bordo blu e dalla barra superiore. Puoi uscire da Correlations Editor scegliendo **Esci** nella barra in alto.

1. È ora possibile creare le seguenti nuove correlazioni per la visualizzazione con collegamenti allegati ai dati che è possibile utilizzare per creare una nuova query:
   + *Registri: i* collegamenti vengono visualizzati accanto ai valori dei campi all'interno dei dettagli del registro per ogni riga del registro.
   + *Tabella*: ogni cella della tabella è un collegamento.

1. Scegli un link per aggiungere una nuova correlazione. I link sono associati a un campo che viene utilizzato come campo di risultato di una correlazione. Per ulteriori dettagli, consultare [Configurazione della correlazione](v10-correlations-config.md).

1. Nella visualizzazione divisa che si apre, utilizza il riquadro destro per impostare l'origine della query di destinazione della correlazione. Per ulteriori dettagli, consultare [Interrogazione target](v10-correlations-config.md#v10-correlations-config-target-query).

1. Crea una query di destinazione utilizzando la [sintassi delle](v10-dash-variable-syntax.md) variabili con le variabili dall'elenco fornito nella parte superiore del riquadro. L'elenco contiene valori di esempio dalla riga di dati selezionata.

1. Fornisci un'etichetta e una descrizione (opzionale). Un'etichetta verrà utilizzata come nome del collegamento all'interno della visualizzazione e può contenere variabili.

1. Fornisci trasformazioni (opzionale; vedi sotto per i dettagli).

1. Scegli **Salva** nella barra degli strumenti in alto per salvare la correlazione e uscire dalla modalità Correlation Editor. Il collegamento utilizzato per creare la correlazione viene sostituito con un collegamento dati in ogni riga. Quando il link è selezionato, la query definita verrà eseguita in un altro riquadro, con le variabili sostituite dinamicamente con i valori della riga selezionata.

## Trasformazioni
<a name="v10-explore-corr-transformations"></a>

Le trasformazioni consentono di estrarre i valori esistenti in un campo con altri dati. Ad esempio, utilizzando una trasformazione, è possibile estrarre una parte di una riga di registro da utilizzare in una correlazione. Per ulteriori dettagli sulle trasformazioni nelle correlazioni, vedere. [Trasformazioni di correlazione](v10-correlations-config.md#v10-correlations-config-transformations)

Dopo aver scelto uno dei link generati in modalità editor, puoi aggiungere trasformazioni selezionando **Aggiungi trasformazione** nel menu a discesa **Trasformazioni**.

**Per utilizzare una trasformazione in una correlazione**

1. Seleziona un campo a cui applicare la trasformazione. Seleziona la parte del campo che desideri utilizzare per la trasformazione. Ad esempio, una riga di registro. Una volta selezionato, il valore di questo campo verrà utilizzato per aiutarti a creare la trasformazione.

1. Seleziona il tipo di trasformazione. Vedi [Trasformazioni di correlazione](v10-correlations-config.md#v10-correlations-config-transformations) per le opzioni e le impostazioni pertinenti. 

1. In base alla selezione effettuata, è possibile che vengano inserite una o più variabili oppure potrebbe essere necessario fornire ulteriori specifiche nelle opzioni visualizzate.

1. Seleziona **Aggiungi trasformazione alla correlazione** per aggiungere le variabili specificate all'elenco delle variabili disponibili.

**Nota**  
Per le espressioni regolari in questa finestra di dialogo, viene richiamata `Variable Name` qui quella a `mapValue` cui si fa riferimento in altra documentazione. Grafana evidenzia qualsiasi testo che corrisponde all'espressione nel valore del campo. Usa i gruppi di acquisizione delle espressioni regolari per selezionare quale parte della corrispondenza deve essere estratta. Quando viene fornita un'espressione regolare valida, la variabile e il valore di quella variabile vengono visualizzati sotto il `Variable Name` campo.

## Esempi di correlazioni
<a name="v10-explore-corr-examples"></a>

Gli esempi seguenti mostrano come creare correlazioni utilizzando l'editor di correlazioni in Explore. Se desideri seguire questi esempi, assicurati di configurare una fonte di [dati di test](testdata-data-source.md).

### Creazione di una correlazione testo-grafico
<a name="v10-explore-corr-text-to-graph"></a>

Questo esempio mostra come creare una correlazione utilizzando Correlations Editor in Explore.

Le correlazioni consentono di utilizzare i risultati di una query per eseguire una nuova query in qualsiasi fonte di dati. In questo esempio, eseguirai una query che esegue il rendering di dati tabulari. I dati verranno utilizzati per eseguire una query diversa che produce un risultato grafico.

Per seguire questo esempio, assicurati di aver impostato una [fonte di dati di test](testdata-data-source.md).

**Per creare una correlazione testo-grafico**

1. **In Grafana, vai a Esplora.**

1. Seleziona la **fonte dei dati di test** dal menu a discesa in alto a sinistra della pagina.

1. Scegli **\$1 Aggiungi** nel menu a discesa a destra e seleziona **Aggiungi** correlazione.

1. Esplora è ora in modalità Correlation Editor, indicata da un bordo blu.

1. Seleziona lo scenario seguente dal menu a discesa dello scenario: File **CSV**.

1. **Seleziona il file, population\$1by\$1state.csv.** Ogni cella è un collegamento su cui puoi fare clic per iniziare a creare una nuova correlazione.

1. Fai clic su una cella qualsiasi della `State` colonna per creare una nuova correlazione che colleghi un collegamento dati a quella voce. Ad esempio, seleziona. `California`

1. Nella vista divisa, seleziona la stessa fonte di dati selezionata nel riquadro a sinistra. L'helper sopra l'editor di query contiene tutte le variabili disponibili, è possibile utilizzare la query di destinazione. Le variabili contengono tutti i campi di dati (colonne della tabella) della riga selezionata.

1. Nel menu **Scenario**, selezionate Valori **metrici CSV**. Il `String Input` campo nell'editor di Query fornisce variabili con valori di popolazione per ogni anno:. `${1980},${2000},${2020}` Questo genererà un grafico utilizzando valori variabili.

1. Nel campo **Alias** dell'editor di query, immettere`${State}`.

   Eseguite un'interrogazione per verificare che produca un grafico utilizzando i valori di esempio delle variabili.

1. Scegliete **Salva** per salvare la correlazione e uscire dall'Editor delle correlazioni.

   Dopo aver salvato la correlazione, Explore eseguirà nuovamente la query nel riquadro di sinistra. Facendo clic sul nome di uno stato, la query a destra viene rieseguita con i valori della riga inserita nel file CSV, modificando così il grafico. La query viene rieseguita con valori aggiornati ogni volta che si fa clic sul nome di uno stato.

È possibile applicare gli stessi passaggi a qualsiasi fonte di dati. Le correlazioni consentono di creare collegamenti nelle visualizzazioni per eseguire query dinamiche basate su dati selezionati. In questo esempio abbiamo utilizzato i dati restituiti da una query per creare una nuova query che genera visualizzazioni diverse utilizzando la stessa fonte di dati. Tuttavia, puoi creare correlazioni tra qualsiasi fonte di dati per creare flussi di esplorazione personalizzati.

### Creazione di una correlazione tra log e tabella
<a name="v10-explore-corr-logs-to-table"></a>

In questo esempio, creerai una correlazione per dimostrare come utilizzare le trasformazioni per estrarre valori dalla riga di log e da un altro campo.

Per seguire questo esempio, assicurati di aver impostato una fonte di [dati di test](testdata-data-source.md).

**Per creare una correlazione tra log e tabella**

1. **In Grafana, vai a Esplora.**

1. Seleziona la **fonte dei dati di test** dal menu a discesa in alto a sinistra della pagina.

1. Scegli **\$1 Aggiungi** nel menu a discesa a destra e seleziona **Aggiungi** correlazione.

1. Esplora è ora in modalità Correlation Editor, indicata da un bordo blu.

1. Nel menu **Scenario**, seleziona **Registri**.

1. Espandi una riga di registro per visualizzare i link di correlazione. Seleziona `Correlate with hostname`.

1. Esplora si apre in visualizzazione divisa. Seleziona la stessa fonte di dati che hai selezionato nel riquadro a sinistra. L'helper sopra l'editor di query contiene tutte le variabili disponibili che puoi utilizzare nella query di destinazione.

1. Espandi la sezione Trasformazioni e fai clic su **Aggiungi** trasformazione.

1. **Nel menu a discesa **Campo**, seleziona messaggio.** La riga del registro viene visualizzata come dati di esempio.

1. In **Tipo**, selezionate **Logfmt**. Questo compila l'elenco delle variabili.

1. Scegli **Aggiungi trasformazione alla correlazione**.

1. Scegli di nuovo **Aggiungi trasformazione** e in **Campo**, seleziona **hostname**.

1. In **Tipo**, seleziona **Espressione regolare**.

1. In **Espressione**, inserisci quanto segue:`-([0-9]\*)`. Questo seleziona qualsiasi numero a destra del trattino.

1. In **Nome variabile**, inserisci quanto segue:. `hostNumber` Questo compila l'elenco delle variabili. 

1. Scegli **Aggiungi trasformazione alla correlazione** per aggiungerla alle altre variabili.

1. Nell'editor delle sorgenti dati, apri il menu a discesa **Scenario** e seleziona Contenuto **CSV**.

1. Nella casella di testo sottostante, fornisci quanto segue e salva la correlazione:

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   Questo chiude la vista divisa e riesegue la query a sinistra. Espandi qualsiasi riga di registro per visualizzare il pulsante di correlazione. *Scegliendo il pulsante di correlazione si apre la visualizzazione divisa con `time` (un campo), `msg` (estratto con *logfmt* dalla riga di registro), `host number` (estratto con *regex* da) e (estratto con logfmt dalla riga di registro`hostname`). `status`*

# Inspector in Explore
<a name="v10-explore-inspector"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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="v10-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 delle query non elaborati, ovvero 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**

Grafana genera un file CSV nella posizione di download predefinita del browser. Puoi aprirlo nel visualizzatore che preferisci.

1. Nella scheda **Inspector**, ottieni risultati di interrogazione non elaborati seguendo le istruzioni precedenti.

1. Perfezionate le impostazioni delle interrogazioni fino a visualizzare i dati grezzi che desiderate esportare.

1. Scegli **Download CSV** (Scarica CSV).

**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 genera un file JSON per i risultati di traccia in uno dei formati supportati: Jaeger, Zipkin o OTLP.

1. Apri l'Inspector.

1. Ispeziona i risultati della query di registro. Perfeziona i risultati fino a visualizzare i log non elaborati che desideri esportare.

1. Scegli **Scarica** registri.

**Controlla le prestazioni delle query**

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 vengono visualizzate in formato 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.

# Correlazioni nella versione 10 di Grafana
<a name="v10-correlations"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 collegamenti interattivi per le visualizzazioni Explore per eseguire query relative ai dati presentati impostando le correlazioni.

Una correlazione definisce il modo in cui i dati di un'origine dati vengono utilizzati per interrogare i dati in un'altra fonte di dati. Alcuni esempi:
+ Il nome di un'applicazione restituito in un'origine dati di log può essere utilizzato per interrogare le metriche relative a tale applicazione in un'origine dati di metrica.
+ Un nome utente restituito da un'origine dati SQL può essere utilizzato per interrogare i log relativi a quel particolare utente in un'origine dati di log.

Explore utilizza le correlazioni definite dall'utente per visualizzare i link all'interno delle visualizzazioni. È possibile fare clic su un collegamento per eseguire la query correlata e visualizzare i risultati in Explore Split View.

Esplora le visualizzazioni che attualmente supportano la visualizzazione dei link in base alle correlazioni:
+ [Log](v10-panels-logs.md)
+ [Tabella](v10-panels-table.md)

[È possibile configurare le correlazioni utilizzando la pagina **Amministrazione > Plugin e dati > Correlazioni** in Grafana o direttamente in Esplora.](v10-explore-correlations.md)

**Topics**
+ [Configurazione della correlazione](v10-correlations-config.md)
+ [Crea una nuova correlazione](v10-correlations-create.md)

# Configurazione della correlazione
<a name="v10-correlations-config"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 correlazione è configurata con le seguenti opzioni: 

**Etichetta**  
Etichetta del link, mostrata nella visualizzazione.

**Descrizione**  
Descrizione facoltativa.

**Fonte dei dati di origine**  
La fonte dei risultati per i quali sono visualizzati i link.

**Campo dei risultati**  
Definisce dove viene mostrato il link in una visualizzazione.

**Interrogazione target**  
La query di destinazione viene eseguita quando si fa clic su un collegamento.

**Trasformazioni**  
Le manipolazioni facoltative dei dati di origine inclusi vengono passate alla query di destinazione.

Per informazioni dettagliate sulla creazione di una correlazione, consulta [Creare una](v10-correlations-create.md) correlazione.

## Fonte dei dati e campo dei risultati
<a name="v10-correlations-config-source-and-result"></a>

I collegamenti sono mostrati in Esplora le visualizzazioni per i risultati della fonte di dati di origine della correlazione. A uno dei campi viene assegnato un collegamento in base al risultato fornito nella configurazione di correlazione (il campo dei risultati). Ogni visualizzazione mostra i campi con collegamenti in un modo diverso. 

## Interrogazione target
<a name="v10-correlations-config-target-query"></a>

La query di destinazione viene eseguita quando si fa clic su un collegamento nella visualizzazione. È possibile utilizzare l'editor di query dell'origine dati di destinazione selezionata per specificare la query di destinazione. È possibile accedere ai risultati dei dati di origine all'interno della query di destinazione con variabili.

### Variabili di correlazione
<a name="v10-correlations-config-variables"></a>

È possibile utilizzare le variabili all'interno della query di destinazione per accedere ai dati di origine relativi alla query. Le correlazioni utilizzano la sintassi delle [variabili Grafana](v10-dash-variable-syntax.md). Le variabili vengono riempite con i valori dei risultati di origine quando viene scelto il collegamento. È possibile utilizzare due tipi di variabili:
+ [Variabili di campo](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (per accedere ai valori e alle etichette dei campi).
+ Variabili di correlazione (per accedere ai valori e alle trasformazioni dei campi).

Esempio: se i risultati di origine contengono un campo chiamato`employee`, è possibile accedere al valore del campo con:
+ Una variabile di campo`${__data.fields.employee}`.
+ Una variabile di correlazione che associa il valore del campo precedente a`${employee}`.

Oltre a mappare i valori dei campi su nomi di variabili più brevi, è possibile creare più variabili di correlazione applicando trasformazioni ai campi esistenti.

La correlazione crea un collegamento dati solo se tutte le variabili hanno valori nella riga di dati selezionata. [Le variabili globali](v10-dash-variable-add.md#v10-dash-variable-add-global) fanno eccezione a questa regola e non devono essere compilate utilizzando i dati restituiti. Queste variabili vengono interpolate automaticamente dalle fonti di dati.

### Trasformazioni di correlazione
<a name="v10-correlations-config-transformations"></a>

Le trasformazioni forniscono un modo per estrarre più variabili dai valori di campo. L'output delle trasformazioni è un insieme di nuove variabili a cui è possibile accedere come qualsiasi altra variabile.

Esistono due tipi di trasformazioni: logfmt ed espressione regolare.

Ogni trasformazione utilizza un valore di campo selezionato come input. L'output di una trasformazione è un insieme di nuove variabili basate sul tipo e sulle opzioni della trasformazione.

### Trasformazione Logfmt
<a name="v10-correlations-config-logfmt-transformation"></a>

[La trasformazione logfmt decostruisce un valore di campo contenente testo formattato con coppie chiave/valore logfmt.](https://brandur.org/logfmt) Ogni coppia diventa una variabile con la chiave come nome della variabile.

La trasformazione logfmt richiede solo di specificare il nome del campo di input se si desidera che la trasformazione si applichi a un campo diverso da quello dei risultati. Variabili di output di esempio per: `field = "host=srv001 endpoint=/test app=foo"`


| nome | value | 
| --- | --- | 
| host | srv001 | 
| endpoint | /test | 
| app | foo | 

### Trasformazione delle espressioni regolari
<a name="v10-correlations-config-regular-expression-transformation"></a>

La trasformazione delle espressioni regolari decostruisce un valore di campo in base all'espressione regolare fornita.

Opzioni di trasformazione delle espressioni regolari:

**campo**  
Nome del campo di input

**espressione**  
Espressione regolare. I gruppi di acquisizione denominati vengono mappati su variabili che corrispondono al nome del gruppo. Se vengono utilizzati gruppi corrispondenti senza nome, viene creata una variabile a partire dalla prima corrispondenza. Il valore sostituisce la variabile che corrisponde al campo di input oppure viene creata una nuova variabile se viene fornito mapValue (vedere gli esempi nella tabella seguente).

**MapValue**  
Utilizzato con semplici gruppi regex senza gruppi corrispondenti denominati. Per impostazione predefinita, la prima corrispondenza sostituisce la variabile con il nome del campo utilizzato come input. Per modificare questo comportamento predefinito, puoi specificare la proprietà MapValue. Il nome fornito viene utilizzato per creare una nuova variabile. Ciò può essere utile se la query di destinazione richiede sia il valore esatto che una parte del valore estratto con la trasformazione.

Esempio: supponiamo che il nome del campo selezionato sia `employee` e che il valore del campo sia. `John Doe`

Diverse variabili di output basate sulle opzioni expression e mapValue:


| expression | MapValue | variabili di output | comment | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | Nessun valore MapValue fornito. La prima corrispondenza viene mappata alla variabile del nome di campo esistente ()employee. | 
| /(\$1w\$1) (\$1w\$1)/ | nome | name=John | La prima corrispondenza viene mappata su una nuova variabile chiamata. name  | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Quando vengono utilizzati gruppi denominati, questi sono i nomi delle variabili di output e mapValue viene ignorato. | 
| /(?\$1w\$1) (?\$1w\$1)/ | nome | firstName=John, lastName=Doe | Come sopra | 

# Crea una nuova correlazione
<a name="v10-correlations-create"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 creare correlazioni nell'editor di correlazioni Explore o utilizzando la pagina di **amministrazione** Grafana nel tuo spazio di lavoro Amazon Managed Grafana.

**Prerequisiti**

Devi avere l'autorizzazione per aggiungere nuove correlazioni. Solo gli utenti con autorizzazioni di scrittura per le fonti di dati possono definire nuove correlazioni.

## Creazione di una correlazione nell'editor di correlazioni di Explore
<a name="v10-correlations-create-explore"></a>

Puoi creare una correlazione nell'editor di correlazione di Explore. Per ulteriori dettagli, consultare [Creazione di una correlazione](v10-explore-correlations.md#v10-explore-corr-create-a-correlation).

## Creazione di una correlazione nella pagina Amministrazione
<a name="v10-correlations-create-administration"></a>

È possibile utilizzare la pagina di **amministrazione** della console Grafana per creare una correlazione.

**Per creare una correlazione nella pagina Amministrazione**

1. Vai alla sezione **Amministrazione** di Grafana.

1. In **Plugin e dati**, apri la pagina **Correlazioni**.

1. Scegli il pulsante **Aggiungi** nell'angolo in alto a destra.

1. Fornisci un'**etichetta** per la correlazione.

1. (Facoltativo) Fornisci una **descrizione**.

1. Vai alla pagina successiva.

1. Fornisci la **fonte di dati di destinazione**.

1. Fornisci una **query di destinazione** utilizzando variabili.

1. Vai alla pagina successiva.

1. Fornisci **la fonte dei dati di origine**.

1. Fornisci il **campo dei risultati**.

1. Aggiungi trasformazioni se hai bisogno di variabili che non siano campi nell'origine dati di origine.

1. Scegli **Aggiungi** per aggiungere una nuova trasformazione.

1. Seleziona il tipo di trasformazione.

1. Configura la trasformazione in base al tipo selezionato.

1. Salva la correlazione.

Puoi modificare una correlazione allo stesso modo, ma durante la modifica non puoi modificare le fonti di dati selezionate.

# Avvisi nella versione 10 di Grafana
<a name="v10-alerts"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Con Grafana v10, 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. Gli avvisi Grafana sono stati introdotti come funzionalità opzionale in Grafana v8 e hanno GrafanaLabs annunciato la rimozione degli avvisi precedenti nella versione 11.

**Nota**  
Questa documentazione riguarda gli avvisi Grafana. Per informazioni sugli avvisi preesistenti, vedere. [Avvisi classici del pannello di controllo](old-alerts-overview.md)

Grafana Alerting consente di conoscere i problemi dei sistemi subito dopo che si sono verificati.

Monitora i dati delle metriche in entrata o le voci di registro e configura il sistema di avviso per monitorare eventi o circostanze specifici e quindi inviare notifiche quando vengono rilevati questi elementi.

In questo modo, si elimina la necessità del monitoraggio manuale e si fornisce una prima linea di difesa contro le interruzioni del sistema o le modifiche che potrebbero trasformarsi in incidenti gravi.

Utilizzando Grafana Alerting, crei query ed espressioni da più fonti di dati, indipendentemente da dove siano archiviati i dati, offrendoti la flessibilità di combinare dati e avvisi su metriche e log in modi nuovi e unici. Puoi quindi creare, gestire e intervenire sui tuoi avvisi da un'unica visualizzazione consolidata e migliorare la capacità del tuo team di identificare e risolvere rapidamente i problemi.

Con le regole di avviso di Mimir e Loki puoi eseguire espressioni di avviso più vicine ai tuoi dati e su larga scala, il tutto gestito dall'interfaccia utente Grafana che conosci già.

**Nota**  
Se stai migrando da una versione precedente di Grafana, in cui utilizzavi gli avvisi Grafana precedenti, potresti trovare utile vedere [le differenze tra gli avvisi Grafana precedenti e i nuovi avvisi](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new) Grafana.

## Caratteristiche e vantaggi principali
<a name="v10-alerting-key-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 una sola regola di avviso. A tale scopo, è possibile aggiungere etichette alla query per specificare quale componente viene monitorato e generare più istanze di avviso per una singola regola di avviso. Ad esempio, se si desidera monitorare ogni server in un cluster, un avviso multidimensionale avviserà ogni CPU, mentre un avviso standard avviserà l'intero server.

**Avvisi di percorso**

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.

**Silenzia gli avvisi**

I silenzi impediscono la creazione delle notifiche e durano solo per un periodo di tempo specificato. 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**

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

## Progetta il tuo sistema di avviso
<a name="v10-alerting-design"></a>

Monitorare sistemi IT complessi e capire se tutto è attivo e funziona correttamente è un compito difficile. La creazione di un efficace sistema di gestione degli avvisi è quindi essenziale per informarvi quando qualcosa va storto prima che comincino a influire sui risultati aziendali.

La progettazione e la configurazione di una configurazione di gestione degli avvisi che funzioni richiede tempo.

Ecco alcuni suggerimenti su come creare una configurazione di gestione degli avvisi efficace per la tua azienda:

**Quali sono le metriche chiave per la tua attività che desideri monitorare e segnalare?**
+ Trova eventi importanti da conoscere e che non siano così banali o frequenti da essere ignorati dai destinatari.
+ Gli avvisi devono essere creati solo per eventi di grandi dimensioni che richiedono un'attenzione o un intervento immediato.
+ Considera la qualità piuttosto che la quantità.

**Che tipo di avviso desideri utilizzare?**
+ Scegli tra Avvisi gestiti da Grafana o Avvisi gestiti da Grafana Mimir o Loki; o entrambi.

**Come vuoi organizzare i tuoi avvisi e le notifiche?**
+ Sii selettivo su chi impostare per ricevere avvisi. Valuta la possibilità di inviarli a chi è in chiamata o a un canale Slack specifico.
+ Automatizza il più possibile utilizzando l'API Alerting o gli avvisi come codice (Terraform).

**Come si può ridurre l'affaticamento dovuto all'allerta?**
+ Evita avvisi rumorosi e non necessari utilizzando silenzi, tempi di silenziamento o mettendo in pausa la valutazione delle regole di avviso.
+ Ottimizza continuamente le regole di avviso per verificarne l'efficacia. Rimuovi le regole di avviso per evitare duplicazioni o avvisi inefficaci.
+ Rifletti attentamente sui livelli di priorità e gravità.
+ Rivedi continuamente le tue soglie e le regole di valutazione.

## Limitazioni degli avvisi Grafana
<a name="v10-alerting-limitations"></a>
+ Quando aggrega regole da altri sistemi, 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.

**Topics**
+ [Caratteristiche e vantaggi principali](#v10-alerting-key-features)
+ [Progetta il tuo sistema di avviso](#v10-alerting-design)
+ [Limitazioni degli avvisi Grafana](#v10-alerting-limitations)
+ [Panoramica di](v10-alerting-overview.md)
+ [Configurare gli avvisi](v10-alerting-setup.md)
+ [Configurare gli avvisi](v10-alerting-configure.md)
+ [Gestisci i tuoi avvisi](v10-alerting-manage.md)

# Panoramica di
<a name="v10-alerting-overview"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 sia alle prime armi o un utente più esperto di Grafana Alerting, scopri di più sui fondamenti e sulle funzionalità disponibili che ti aiutano a creare, gestire e rispondere agli avvisi e a migliorare la capacità del tuo team di risolvere rapidamente i problemi.

## Principi
<a name="v10-alerting-overview-principles"></a>

Nei sistemi di avviso basati su Prometheus, è disponibile un generatore di avvisi che crea avvisi e un ricevitore di avvisi che riceve avvisi. Ad esempio, Prometheus è un generatore di avvisi ed è responsabile della valutazione delle regole di avviso, mentre Alertmanager è un ricevitore di avvisi ed è responsabile del raggruppamento, dell'inibizione, del silenziamento e dell'invio di notifiche sulla attivazione e sugli avvisi risolti.

Grafana Alerting si basa sul modello Prometheus di progettazione di sistemi di allarme. Dispone di un generatore di avvisi interno responsabile della pianificazione e della valutazione delle regole di avviso, nonché di un ricevitore di avvisi interno responsabile del raggruppamento, dell'inibizione, del silenziamento e dell'invio delle notifiche. Grafana non utilizza Prometheus come generatore di avvisi perché Grafana Alerting deve funzionare con molte altre fonti di dati oltre a Prometheus. Tuttavia, utilizza Alertmanager come ricevitore di avvisi.

Gli avvisi vengono inviati al destinatario degli avvisi dove vengono instradati, raggruppati, inibiti, silenziati e notificati. In Grafana Alerting, il ricevitore di avvisi predefinito è l'Alertmanager incorporato in Grafana e viene chiamato Grafana Alertmanager. [Tuttavia, è possibile utilizzare anche altri gestori di avvisi, denominati gestori di avvisi esterni.](v10-alerting-setup-alertmanager.md)

## Nozioni fondamentali
<a name="v10-alerting-overview-fundamentals"></a>

Di seguito viene fornita una panoramica delle diverse parti degli avvisi Grafana.

### Regole di avviso
<a name="v10-alerting-overview-alert-rules"></a>

Una regola di avviso è un insieme di criteri che determinano quando un avviso deve essere attivato. Consiste in una o più interrogazioni ed espressioni, una condizione che deve essere soddisfatta, un intervallo che determina la frequenza con cui viene valutata la regola di avviso e una durata durante la quale deve essere soddisfatta la condizione affinché venga attivato un avviso.

Le regole di avviso vengono valutate in base al rispettivo intervallo e ogni regola di avviso può avere zero, uno o un numero qualsiasi di avvisi attivati alla volta. Lo stato della regola di avviso è determinato dal numero massimo di `severe` avvisi, che può essere Normale, In sospeso o Attivo. Ad esempio, se almeno uno degli avvisi di una regola di avviso è attivo, viene attivata anche la regola di avviso. Lo stato di integrità di una regola di avviso è determinato dallo stato della sua valutazione più recente. Questi possono essere OK, Error e NoData.

Una caratteristica molto importante delle regole di avviso è che supportano annotazioni ed etichette personalizzate. Queste consentono di utilizzare gli avvisi con metadati aggiuntivi come riepiloghi e descrizioni e di aggiungere etichette aggiuntive per indirizzare gli avvisi verso politiche di notifica specifiche.

### Avvisi
<a name="v10-alerting-overview-alerts"></a>

Gli avvisi sono identificati in modo univoco da set di coppie denominate Labels. key/value Ogni chiave è un nome di etichetta e ogni valore è un valore di etichetta. Ad esempio, un avviso potrebbe avere le etichette `foo=bar` e un altro avviso potrebbe avere le etichette`foo=baz`. Un avviso può avere molte etichette, ad esempio`foo=bar,bar=baz`, ma non può avere la stessa etichetta due volte, ad esempio`foo=bar,foo=baz`. Inoltre, due avvisi non possono avere le stesse etichette e, se due avvisi hanno la stessa etichetta, uno degli avvisi verrà scartato. `foo=bar,bar=baz` `foo=bar,bar=baz` Gli avvisi vengono risolti quando la condizione nella regola di avviso non è più soddisfatta o la regola di avviso viene eliminata.

In Grafana Managed Alerts, gli avvisi possono essere negli stati Normale, In sospeso, Avviso, Nessun dato o Errore. Negli avvisi gestiti dall'origine dati, come Mimir e Loki, gli avvisi possono essere in modalità Normale, In sospeso e Avviso, ma non in modalità Errore. NoData 

### Punti di contatto
<a name="v10-alerting-overview-contact-points"></a>

I punti di contatto determinano dove vengono inviate le notifiche. Ad esempio, potresti avere un punto di contatto che invia notifiche a un indirizzo email, a Slack, a un sistema di gestione degli incidenti (IRM) come Grafana OnCall o Pagerduty o a un webhook.

Le notifiche inviate dai punti di contatto possono essere personalizzate utilizzando modelli di notifica. È possibile utilizzare i modelli di notifica per modificare il titolo, il messaggio e la struttura della notifica. I modelli di notifica non sono specifici per singole integrazioni o punti di contatto.

### Politiche di notifica
<a name="v10-alerting-overview-notification-policies"></a>

Le politiche di notifica raggruppano gli avvisi e quindi li indirizzano ai punti di contatto. Determinano quando vengono inviate le notifiche e con quale frequenza le notifiche devono essere ripetute.

Gli avvisi vengono abbinati alle politiche di notifica utilizzando labelmatcher. Si tratta di espressioni leggibili dall'uomo che affermano se le etichette dell'avviso corrispondono esattamente, non corrispondono esattamente, contengono o non contengono il testo previsto. Ad esempio, il matcher `foo=bar` abbina gli avvisi all'etichetta `foo=bar` mentre il matcher `foo=~[a-zA-Z]+` abbina gli avvisi con qualsiasi etichetta chiamata foo con un valore che corrisponde all'espressione regolare. `[a-zA-Z]+`

Per impostazione predefinita, un avviso può corrispondere a una sola politica di notifica. Tuttavia, con la `continue` funzionalità è possibile fare in modo che gli avvisi corrispondano a un numero qualsiasi di politiche di notifica contemporaneamente. Per ulteriori informazioni sulle politiche di notifica, vedere Politiche [di notifica](v10-alerting-explore-notifications-policies-details.md).

### Silenzi e tempi di silenziamento
<a name="v10-alerting-overview-silences-and-mute-timings"></a>

I silenzi e le tempistiche di silenziamento consentono di mettere in pausa le notifiche per avvisi specifici o addirittura per intere politiche di notifica. Utilizza il silenzio per mettere in pausa le notifiche ad hoc, ad esempio mentre lavori alla correzione di un avviso, e utilizza i tempi di silenziamento per sospendere le notifiche a intervalli regolari, ad esempio durante le normali finestre di manutenzione programmate.

**Topics**
+ [Principi](#v10-alerting-overview-principles)
+ [Nozioni fondamentali](#v10-alerting-overview-fundamentals)
+ [Fonti di dati e avvisi Grafana](v10-alerting-overview-datasources.md)
+ [Avvisi su dati numerici](v10-alerting-overview-numeric.md)
+ [Etichette e annotazioni](v10-alerting-overview-labels.md)
+ [Informazioni sulle regole di avviso](v10-alerting-explore-rules.md)
+ [Gestore degli avvisi](v10-alerting-explore-alertmanager.md)
+ [Punti di contatto](v10-alerting-explore-contacts.md)
+ [Notifications](v10-alerting-explore-notifications.md)
+ [Avvisi relativi all'elevata disponibilità](v10-alerting-explore-high-availability.md)

# Fonti di dati e avvisi Grafana
<a name="v10-alerting-overview-datasources"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 compatibili con Grafana Alerting. Ogni fonte di dati è supportata da un plugin. Gli avvisi Grafana richiedono che i plug-in delle sorgenti dati siano plug-in di *backend*, al fine di valutare le regole utilizzando l'origine dati, poiché il motore di valutazione funziona sul backend. I plugin devono inoltre specificare che sono compatibili con gli avvisi Grafana.

Le fonti di dati vengono aggiunte e aggiornate nel tempo. È noto che le seguenti fonti di dati sono compatibili con gli avvisi Grafana.
+ [Connect a una fonte di CloudWatch dati Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connect a un'origine dati di Azure Monitor](using-azure-monitor-in-AMG.md)
+ [Connect a una fonte OpenSearch di dati Amazon Service](using-Amazon-OpenSearch-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 ad Amazon Managed Service for Prometheus e alle fonti di dati Prometheus open source](prometheus-data-source.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)

Per informazioni più dettagliate sulle sorgenti di dati e sui plug-in di sorgenti dati in Amazon Managed Grafana, consulta. [Connessione alle origini dati](AMG-data-sources.md)

# Avvisi su dati numerici
<a name="v10-alerting-overview-numeric"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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
<a name="v10-alerting-numeric-tabular"></a>

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 di una 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
<a name="v10-alerting-numeric-tabexample"></a>

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 interrogazione viene utilizzata come **condizione** in una regola di avviso, verrà generata l'allerta da un valore diverso 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="v10-alerting-overview-labels"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-alerting-overview-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="v10-alerting-overview-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.](v10-alerting-overview-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="v10-alerting-overview-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.](v10-alerting-overview-labels-templating.md)

**Topics**
+ [Etichette](#v10-alerting-overview-labels-labels)
+ [Annotazioni](#v10-alerting-overview-labels-annotations)
+ [Come funziona l'abbinamento delle etichette](v10-alerting-overview-labels-matching.md)
+ [Etichette in Grafana Alerting](v10-alerting-overview-labels-alerting.md)
+ [Modelli di etichette e annotazioni](v10-alerting-overview-labels-templating.md)

# Come funziona l'abbinamento delle etichette
<a name="v10-alerting-overview-labels-matching"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 matcher è 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 le 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.

## Esempio
<a name="v10-alerting-overview-labels-matching-ex"></a>

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.

## Escludi etichette
<a name="v10-alerting-overview-labels-matching-exclude"></a>

Puoi anche scrivere abbinatori di etichette per escludere le etichette.

Ecco un esempio che mostra come escludere l'etichetta`team`. Puoi scegliere tra uno qualsiasi di questi valori per escludere l'etichetta.
+ `team=""`
+ `team!~.+`
+ `team=~^$`

# Etichette in Grafana Alerting
<a name="v10-alerting-overview-labels-alerting"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.](v10-alerting-configure.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
<a name="v10-alerting-overview-labels-alerting-external"></a>

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
<a name="v10-alerting-overview-labels-alerting-reserved"></a>

**Nota**  
Le etichette con il prefisso `grafana_` sono riservate da Grafana per usi speciali. Se viene aggiunta un'etichetta configurata manualmente all'inizio, verrà sovrascritta in caso di collisione. `grafana_`

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="v10-alerting-overview-labels-templating"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 modelli per includere dati provenienti da interrogazioni ed espressioni in etichette e annotazioni. Ad esempio, potresti voler impostare l'etichetta di gravità per un avviso in base al valore della query o utilizzare l'etichetta dell'istanza della query in un'annotazione di riepilogo in modo da sapere quale server sta riscontrando un utilizzo elevato della CPU.

Tutti i modelli devono essere scritti in [text/template](https://pkg.go.dev/text/template). Indipendentemente dal fatto che stiate creando un modello di etichetta o di un'annotazione, dovreste scrivere ogni modello in linea all'interno dell'etichetta o dell'annotazione che state modellando. Ciò significa che non è possibile condividere modelli tra etichette e annotazioni e sarà invece necessario copiare i modelli ovunque si desideri utilizzarli.

Ogni modello viene valutato ogni volta che viene valutata la regola di avviso e viene valutato separatamente per ogni avviso. Ad esempio, se la regola di avviso ha un'annotazione di riepilogo basata su un modello e la regola di avviso ha 10 avvisi di attivazione, il modello verrà eseguito 10 volte, una volta per ogni avviso. Dovresti cercare di evitare il più possibile di eseguire calcoli costosi nei tuoi modelli.

## Esempi
<a name="v10-alerting-overview-labels-templating-examples"></a>

Invece di scrivere un tutorial completo, text/template, the following examples attempt to show the most common use-cases we have seen for templates. You can use these examples verbatim, or adapt them as necessary for your use case. For more information about how to write text/template consulta la documentazione del [testo/modello](https://pkg.go.dev/text/template).

**Stampa tutte le etichette, separate da virgole**

Per stampare tutte le etichette, separate da virgole, stampa la `$labels` variabile:

```
{{ $labels }}
```

Ad esempio, se viene fornito un avviso con le etichette `alertname=High CPU usage``instance=server1`, `grafana_folder=CPU alerts` verrà stampato: 

```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```

**Nota**  
Se si utilizzano condizioni classiche, `$labels` non conterrà alcuna etichetta della query. Per ulteriori informazioni[, fare riferimento alla variabile \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).

**Stampa tutte le etichette, una per riga**

Per stampare tutte le etichette, una per riga, usa a per `range` iterare su ogni key/value coppia e stamparle singolarmente. Qui `$k` si riferisce al nome e `$v` al valore dell'etichetta corrente: 

```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```

Ad esempio, se viene fornito un avviso con le etichette `alertname=High CPU usage``instance=server1`, `grafana_folder=CPU alerts` verrà stampato:

```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```

**Nota**  
Se si utilizzano condizioni classiche, `$labels` non conterrà alcuna etichetta della query. Per ulteriori informazioni[, fare riferimento alla variabile \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).

**Stampa una singola etichetta**

Per stampare una singola etichetta usa la `index` funzione con la `$labels` variabile: 

```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```

Ad esempio, dato un avviso con l'etichetta`instance=server1`, questo stamperebbe:

```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```

**Nota**  
Se si utilizzano condizioni classiche, `$labels` non conterrà alcuna etichetta della query. Per ulteriori informazioni[, fare riferimento alla variabile \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable).

**Stampa il valore di una query**

Per stampare il valore di una query istantanea è possibile stampare il relativo Ref ID utilizzando la `index` funzione e la `$values` variabile: 

```
{{ index $values "A" }}
```

Ad esempio, data una query istantanea che restituisce il valore 81.2345, verrà stampato:

```
81.2345
```

Per stampare il valore di una query con intervallo, è necessario innanzitutto ridurlo da una serie temporale a un vettore istantaneo con un'espressione di riduzione. È quindi possibile stampare il risultato dell'espressione reduce utilizzando invece il relativo ID Ref. Ad esempio, se l'espressione reduce prende la media di A e ha l'ID Ref B, dovresti scrivere: 

```
{{ index $values "B" }}
```

**Stampa il valore umanizzato di una query**

Per stampare il valore umanizzato di una query istantanea usa la `humanize` funzione:

```
{{ humanize (index $values "A").Value }}
```

Ad esempio, data una query istantanea che restituisce il valore 81.2345, verrà stampato: 

```
81.234
```

Per stampare il valore umanizzato di una query con intervallo, è necessario innanzitutto ridurlo da una serie temporale a un vettore istantaneo con un'espressione di riduzione. È quindi possibile stampare il risultato dell'espressione reduce utilizzando invece il relativo ID Ref. Ad esempio, se l'espressione reduce prende la media di A e ha l'ID Ref B, dovresti scrivere: 

```
{{ humanize (index $values "B").Value }}
```

**Stampa il valore di una query in percentuale**

Per stampare il valore di una query istantanea in percentuale, usa la `humanizePercentage` funzione:

```
{{ humanizePercentage (index $values "A").Value }}
```

Questa funzione prevede che il valore sia un numero decimale compreso tra 0 e 1. Se il valore è invece un numero decimale compreso tra 0 e 100, è possibile dividerlo per 100 nella query o utilizzando un'espressione matematica. Se la query è una query a intervallo, è necessario innanzitutto ridurla da una serie temporale a un vettore istantaneo con un'espressione di riduzione.

**Imposta una severità in base al valore di una query**

Per impostare un'etichetta di gravità in base al valore di una query, utilizzate l'istruzione if e la funzione greater than comparison. Assicurati di utilizzare i decimali (`80.0`,, `50.0``0.0`, ecc.) quando esegui confronti con `$values` poiché non text/template supporta la coercizione dei tipi. [Puoi trovare un elenco di tutte le funzioni di confronto supportate qui.](https://pkg.go.dev/text/template#hdr-Functions)

```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```

**Stampa tutte le etichette partendo da una condizione classica**

Non è possibile `$labels` stampare etichette dalla query se si utilizzano condizioni classiche, ma è necessario utilizzare `$values` al suo posto. Il motivo è che le condizioni classiche scartano queste etichette per imporre un comportamento unidimensionale (al massimo un avviso per regola di avviso). Se le condizioni classiche non eliminassero queste etichette, le interrogazioni che restituivano numerose serie temporali farebbero sì che gli avvisi si alternassero tra l'attivazione e la risoluzione costante, poiché le etichette cambierebbero ogni volta che veniva valutata la regola di avviso.

La `$values` variabile contiene invece i valori ridotti di tutte le serie temporali per tutte le condizioni che si verificano. Ad esempio, se hai una regola di avviso con una query A che restituisce due serie temporali e una condizione classica B con due condizioni, allora `$values` conterrebbe `B0``B1`, `B2` e`B3`. Se la condizione classica B avesse una sola condizione, `$values` conterrebbe solo `B0` e`B1`.

Per stampare tutte le etichette di tutte le serie storiche di cottura, usa il seguente modello (assicurati di sostituirlo `B` nell'espressione regolare con l'ID Ref della condizione classica se è diversa): 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```

Ad esempio, una condizione classica per due serie temporali che superano una singola condizione stamperebbe: 

```
B0: instance=server1
B1: instance=server2
```

Se la condizione classica presenta due o più condizioni e una serie temporale supera più condizioni contemporaneamente, le relative etichette verranno duplicate per ogni condizione superata: 

```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```

Se devi stampare etichette uniche, dovresti invece prendere in considerazione la possibilità di modificare le regole di avviso da unidimensionali a multidimensionali. Puoi farlo sostituendo la tua condizione classica con espressioni di riduzione e matematiche.

**Stampa tutti i valori da una condizione classica**

Per stampare tutti i valori di una condizione classica, prendi l'esempio precedente e sostituiscilo `$v.Labels` con`$v.Value`: 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```

Ad esempio, una condizione classica per due serie temporali che superano una singola condizione stamperebbe: 

```
B0: 81.2345
B1: 84.5678
```

Se la condizione classica ha due o più condizioni e una serie temporale supera più condizioni contemporaneamente, `$values` conterrà i valori di tutte le condizioni: 

```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```

## Variabili
<a name="v10-alerting-overview-labels-templating-variables"></a>

Le seguenti variabili sono disponibili per la creazione di modelli di etichette e annotazioni:

### La variabile labels
<a name="v10-alerting-overview-labels-templating-the-labels-variable"></a>

La `$labels` variabile contiene tutte le etichette della query. Ad esempio, supponiamo di avere una query che restituisce l'utilizzo della CPU per tutti i server e di avere una regola di avviso che si attiva quando uno dei server ha superato l'80% di utilizzo della CPU negli ultimi 5 minuti. Desideri aggiungere un'annotazione di riepilogo all'avviso che indichi quale server sta riscontrando un utilizzo elevato della CPU. Con la `$labels` variabile puoi scrivere un modello che stampa una frase leggibile dall'uomo come: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```

**Nota**  
Se si utilizza una condizione classica, `$labels` non conterrà alcuna etichetta della query. Le condizioni classiche eliminano queste etichette per imporre un comportamento unidimensionale (al massimo un avviso per regola di avviso). Se desideri utilizzare le etichette della query nel tuo modello, segui il precedente esempio *Stampa tutte le etichette da una* condizione classica.

### La variabile value
<a name="v10-alerting-overview-labels-templating-the-value-variable"></a>

La `$value` variabile è una stringa contenente le etichette e i valori di tutte le query istantanee, le espressioni threshold, reduce e matematiche e le condizioni classiche nella regola di avviso. Non contiene i risultati delle interrogazioni con intervalli, in quanto possono restituire da 10 a 10.000 righe o metriche. In tal caso, per query particolarmente grandi un singolo avviso potrebbe utilizzare 10 secondi MBs di memoria e Grafana esaurirebbe la memoria molto rapidamente.

Per stampare la `$value` variabile nel riepilogo dovresti scrivere qualcosa del genere: 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```

E sarebbe simile a questo:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```

Qui `var='A'` si riferisce alla query istantanea con Ref ID A, `labels={instance=instance1}` si riferisce alle etichette e `value=81.234` si riferisce all'utilizzo medio della CPU negli ultimi 5 minuti.

Se vuoi stampare solo una parte della stringa invece della stringa completa, usa la `$values` variabile. Contiene le stesse informazioni`$value`, ma in una tabella strutturata, ed è molto più facile da usare rispetto alla scrittura di un'espressione regolare che corrisponda solo al testo desiderato.

### La variabile values
<a name="v10-alerting-overview-labels-templating-the-values-variable"></a>

La `$values` variabile è una tabella contenente le etichette e i valori in virgola mobile di tutte le query e le espressioni istantanee, indicizzate in base al relativo codice Ref. IDs

Per stampare il valore della query istantanea con Ref ID A:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```

Ad esempio, dato un avviso con le etichette `instance=server1` e una query istantanea con il valore`81.2345`, questo stamperebbe:

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```

Se la query in Ref ID A è una query di intervallo anziché una query istantanea, aggiungi un'espressione di riduzione con Ref ID B e sostituiscila `(index $values "A")` con`(index $values "B")`:

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```

## Funzioni
<a name="v10-alerting-overview-labels-templating-functions"></a>

Le seguenti funzioni sono disponibili per la creazione di modelli di 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.

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**URL esterno**

La `externalURL` funzione restituisce l'URL esterno del server Grafana.

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

La `graphLink` funzione restituisce il percorso della visualizzazione grafica [Esplora nella versione 10 di Grafana](v10-explore.md) per l'espressione e l'origine dati specificate.

```
{{ 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.

```
{{ humanize 1000.0 }}
```

```
1k
```

**umanizza 1024**

`humanize1024`Funziona in modo simile `humanize` ma utilizza 1024 come base anziché 1000.

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**Durata umanizzata**

La `humanizeDuration` funzione umanizza una durata in secondi.

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**Umanizza la percentuale**

La `humanizePercentage` funzione umanizza un valore di rapporto rispetto a una percentuale.

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**Umanizza il timestamp**

La `humanizeTimestamp` funzione umanizza un timestamp Unix.

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**partita**

La `match` funzione abbina il testo a un modello di espressione regolare.

```
{{ match "a.*" "abc" }}
```

```
true
```

**PathPrefix**

La `pathPrefix` funzione restituisce il percorso del server Grafana.

```
{{ pathPrefix }}
```

```
/grafana
```

**TableLink**

La `tableLink` funzione restituisce il percorso della vista tabulare [Esplora nella versione 10 di Grafana](v10-explore.md) per l'espressione e l'origine dati specificate.

```
{{ 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.

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**a Lower**

La `toLower` funzione restituisce tutto il testo in lettere minuscole.

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**a TOUPPER**

La `toUpper` funzione restituisce tutto il testo in maiuscolo.

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

La `reReplaceAll` funzione sostituisce il testo corrispondente all'espressione regolare.

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# Informazioni sulle regole di avviso
<a name="v10-alerting-explore-rules"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 la durata entro la quale la condizione deve essere soddisfatta per iniziare a funzionare.

Mentre le interrogazioni e le espressioni selezionano il set di dati da valutare, una *condizione* imposta la soglia che i dati devono 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](v10-alerting-explore-rules-types.md)
+ [Regole di registrazione](v10-alerting-explore-rule-recording.md)
+ [Domande e condizioni](v10-alerting-explore-rules-queries.md)
+ [Istanze di avviso](v10-alerting-rules-instances.md)
+ [Namespace, cartelle e gruppi](v10-alerting-rules-grouping.md)
+ [Valutazione delle regole di avviso](v10-alerting-rules-evaluation.md)
+ [Stato e integrità delle regole di allarme](v10-alerting-explore-state.md)
+ [Modello di notifica](v10-alerting-rules-notification-templates.md)

# Tipi di regole di avviso
<a name="v10-alerting-explore-rules-types"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. Scopri di più su ciascuno dei tipi di regole di avviso, su come funzionano e decidi qual è la migliore per il tuo caso d'uso.

## Regole gestite da Grafana
<a name="v10-alerting-explore-rule-types-grafana"></a>

Le regole gestite 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 più fonti di dati, puoi aggiungere [espressioni](v10-panels-query-xform-expressions.md) per trasformare i dati ed esprimere le condizioni di avviso.

In Grafana, avvisi gestiti:
+ Le regole di avviso vengono create all'interno di Grafana, sulla base di una o più fonti di dati.
+ Le regole di avviso vengono valutate dal motore di valutazione delle regole di avviso all'interno di Grafana.
+ Gli avvisi vengono inviati utilizzando il Grafana Alertmanager interno.

**Nota**  
Puoi anche configurare gli avvisi da inviare utilizzando un Alertmanager esterno o utilizzare gestori di avvisi interni ed esterni. [Per ulteriori informazioni, consulta Aggiungere un alertmanager esterno.](v10-alerting-setup-alertmanager.md)

## Regole gestite dalle fonti di dati
<a name="v10-alerting-explore-rule-types-datasource"></a>

Per creare regole di avviso gestite dall'origine dati, 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 Ruler è supportata.

Negli avvisi gestiti dalle fonti di dati:
+ Le regole di avviso vengono create e archiviate all'interno dell'origine dati stessa.
+ Le regole di avviso possono essere create solo sulla base dei dati di Prometheus.
+ La valutazione e la distribuzione delle regole di avviso sono distribuite su più nodi per un'elevata disponibilità e tolleranza agli errori.

## Scegli un tipo di regola di avviso
<a name="v10-alerting-explore-rule-types-choose"></a>

Quando scegli il tipo di regola di avviso da utilizzare, considera il seguente confronto tra le regole di avviso gestite da Grafana e le regole di avviso gestite dall'origine dei dati.


| Funzionalità | Regola di avviso gestita da Grafana | Regola di avviso gestita da Loki/mimir | 
| --- | --- | --- | 
| Crea regole di avviso basate sui dati provenienti da una qualsiasi delle nostre fonti di dati supportate | Sì | No: puoi creare regole di avviso solo basate sui dati di Prometheus. L'origine dati deve avere l'API Ruler abilitata.  | 
| Mescola e abbina le fonti di dati | Sì | No | 
| Include il supporto per le regole di registrazione | No | Sì | 
| Aggiungi espressioni per trasformare i dati e impostare le condizioni di avviso | Sì | No | 
| Usa immagini nelle notifiche di avviso | Sì | No | 
| Dimensionamento | Richiedono più risorse, dipendono dal database e sono suscettibili di errori temporanei. Scalano solo verticalmente. | Memorizza le regole di avviso all'interno della fonte di dati stessa e consenti una scalabilità «infinita». Genera e invia notifiche di avviso dalla posizione dei tuoi dati. | 
| Valutazione e distribuzione delle regole di avviso | La valutazione e la distribuzione delle regole di avviso vengono eseguite dall'interno di Grafana, utilizzando un Alertmanager esterno o entrambi. | La valutazione delle regole di avviso e l'invio degli avvisi sono distribuiti, il che significa che non esiste un unico punto di errore. | 

# Regole di registrazione
<a name="v10-alerting-explore-rule-recording"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 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.

L'interrogazione di questa nuova serie temporale è più veloce, soprattutto per i dashboard, poiché interrogano la stessa espressione ogni volta che i dashboard si aggiornano.

Scopri di più sulle [regole di registrazione](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus.

# Domande e condizioni
<a name="v10-alerting-explore-rules-queries"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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, le query svolgono un ruolo fondamentale nel recupero e nella trasformazione dei dati da fonti di dati supportate, che includono database come MySQL e PostgreSQL, database di serie temporali come Prometheus, InfluxDB e Graphite e servizi come Amazon, Azure Monitor e Google Cloud Monitoring. OpenSearch CloudWatch

Per ulteriori informazioni sulle fonti di dati supportate, consulta. [Fonti di dati e avvisi Grafana](v10-alerting-overview-datasources.md)

Il processo di esecuzione di una query prevede la definizione dell'origine dati, la specificazione dei dati desiderati da recuperare e l'applicazione di filtri o trasformazioni pertinenti. Per costruire queste query vengono utilizzati linguaggi di query o sintassi specifici dell'origine dati scelta.

In Alerting, si definisce una query per ottenere i dati da misurare e una condizione che deve essere soddisfatta prima che venga attivata una regola di avviso.

Una regola di avviso è costituita da una o più interrogazioni ed espressioni che selezionano i dati da misurare.

Per ulteriori informazioni su interrogazioni ed espressioni, vedere. [Interroga e trasforma i dati](v10-panels-query-xform.md)

## Interrogazioni relative alle fonti di dati
<a name="v10-alerting-explore-rules-queries-data-source-queries"></a>

Le interrogazioni in Grafana possono essere applicate in vari modi, a seconda della fonte di dati e del linguaggio di interrogazione utilizzati. 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.

Alcuni tipi comuni di componenti di interrogazione includono: 

**Metriche o campi dati**: specifica le metriche o i campi dati specifici che desideri recuperare, come l'utilizzo della CPU, il traffico di rete o le letture dei sensori.

**Intervallo** di tempo: definisci l'intervallo di tempo per il quale desideri recuperare i dati, ad esempio l'ultima ora, un giorno specifico o un intervallo di tempo personalizzato.

**Filtri**: applica filtri per restringere i dati in base a criteri specifici, ad esempio filtrando i dati in base a un tag, un host o un'applicazione specifici.

**Aggregazioni**: esegui aggregazioni sui dati per calcolare metriche come medie, somme o conteggi in un determinato periodo di tempo.

**Raggruppamento**: raggruppa i dati in base a dimensioni o tag specifici per creare viste o suddivisioni aggregate.

**Nota**  
Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili [qui](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) nei forum di Grafana Labs.

## Interrogazioni sulle espressioni
<a name="v10-alerting-explore-rules-queries-expression-queries"></a>

In Grafana, un'espressione viene utilizzata per eseguire calcoli, trasformazioni o aggregazioni sui dati interrogati dall'origine dati. Consente di creare metriche personalizzate o modificare metriche esistenti in base a operazioni matematiche, funzioni o espressioni logiche.

Sfruttando le query di espressione, gli utenti possono eseguire attività come il calcolo della variazione percentuale tra due valori, applicare funzioni come funzioni logaritmiche o trigonometriche, aggregare dati su intervalli di tempo o dimensioni specifici e implementare la logica condizionale per gestire diversi scenari.

In Alerting, puoi usare solo espressioni per le regole di avviso gestite da Grafana. Per ogni espressione, puoi scegliere tra le espressioni matematiche, di riduzione e di ricampionamento. Queste sono chiamate regole multidimensionali, perché generano un avviso separato per ogni serie.

Puoi anche utilizzare una condizione classica, che crea una regola di avviso che attiva un singolo avviso quando viene soddisfatta la relativa condizione. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie.

**Nota**  
Le condizioni classiche esistono principalmente per motivi di compatibilità e dovrebbero essere evitate se possibile.

**Ridurre**

Aggrega i valori delle serie temporali nell'intervallo temporale selezionato in un unico valore.

**Math** (Matematica)

Esegue calcoli matematici in formato libero functions/operations su serie temporali e dati numerici. Può essere utilizzato per preelaborare i dati delle serie temporali o per definire una condizione di avviso per i dati numerici.

**Ricampionare**

Riallinea un intervallo di tempo a un nuovo set di timestamp, utile quando si confrontano dati di serie temporali provenienti da diverse fonti di dati in cui i timestamp altrimenti non si allineerebbero.

**Threshold**

Verifica se alcuni dati delle serie temporali corrispondono alla condizione di soglia.

L'espressione di soglia consente di confrontare due valori singoli. Viene restituita `0` quando la condizione è falsa e `1` se la condizione è vera. Sono disponibili le seguenti funzioni di soglia:
+ È superiore a (x > y)
+ È inferiore a (x < y)
+ È inferiore a (x y1 E x < y2)
+ < y1 AND x >È al di fuori dell'intervallo (x y2)

**Condizione classica**

Verifica se alcuni dati delle serie temporali corrispondono alla condizione di avviso.

**Nota**  
Le classiche interrogazioni con espressioni di condizione producono sempre una sola istanza di avviso, indipendentemente dal numero di serie temporali che soddisfano la condizione. Le condizioni classiche esistono principalmente per motivi di compatibilità e dovrebbero essere evitate se possibile.

## Aggregazioni
<a name="v10-alerting-explore-rules-queries-aggregations"></a>

Grafana Alerting offre le seguenti funzioni di aggregazione per consentirti di affinare ulteriormente la tua query.

Queste funzioni sono disponibili solo per le espressioni condizionali **Reduce** e **Classic**.


| Funzione | Expression | Cosa fa | 
| --- | --- | --- | 
| avg | Riduci/Classico | Visualizza la media dei valori | 
| min | Riduci/Classic | Visualizza il valore più basso | 
| max | Riduci/Classic | Visualizza il valore più alto | 
| sum | Riduci/Classic | Visualizza la somma di tutti i valori | 
| count | Riduci/Classic | Conta il numero di valori nel risultato | 
| last | Riduci/Classic | Visualizza l'ultimo valore | 
| median | Riduci/Classic | Visualizza il valore mediano | 
| diff | Classic | Visualizza la differenza tra il valore più recente e quello più vecchio | 
| diff\$1abs | Classic | Visualizza il valore assoluto di diff | 
| percent\$1diff | Classic | Visualizza il valore percentuale della differenza tra il valore più recente e quello più vecchio | 
| percent\$1diff\$1abs | Classic | Visualizza il valore assoluto di percent\$1diff | 
| count\$1non\$1null | Classic | Visualizza un conteggio di valori nel set di risultati che non lo sono null | 

## Condizione di avviso
<a name="v10-alerting-explore-rules-queries-alert-condition"></a>

Una condizione di avviso è l'interrogazione o l'espressione che determina se l'avviso verrà attivato o meno a seconda del valore che produce. Può esserci una sola condizione che determinerà l'attivazione dell'avviso.

Dopo aver definito le and/or espressioni delle interrogazioni, scegline una come condizione della regola di avviso.

Quando i dati richiesti soddisfano la condizione definita, Grafana attiva l'avviso associato, che può essere configurato per inviare notifiche attraverso vari canali come e-mail, Slack o. PagerDuty Le notifiche ti informano sulla condizione soddisfatta, consentendoti di intraprendere le azioni appropriate o di indagare sul problema sottostante.

Per impostazione predefinita, l'ultima espressione aggiunta viene utilizzata come condizione di avviso.

## Soglia di ripristino
<a name="v10-alerting-explore-rules-queries-recovery-threshold"></a>

Per ridurre il rumore generato dagli avvisi che lampeggiano, è possibile impostare una soglia di ripristino diversa dalla soglia di avviso.

Gli avvisi flapping si verificano quando una metrica si aggira intorno alla soglia di avviso e possono portare a frequenti cambiamenti di stato, con conseguente generazione di troppe notifiche.

Le regole di avviso gestite da Grafana vengono valutate per un intervallo di tempo specifico. Durante ogni valutazione, il risultato della query viene confrontato con la soglia impostata nella regola di avviso. Se il valore di una metrica è superiore alla soglia, viene attivata una regola di avviso e viene inviata una notifica. Quando il valore scende al di sotto della soglia ed è presente un avviso attivo per questa metrica, l'avviso viene risolto e viene inviata un'altra notifica.

Può essere difficile creare una regola di avviso per una metrica rumorosa. Cioè, quando il valore di una metrica supera e scende continuamente al di sopra e al di sotto di una soglia. Questa operazione si chiama flapping e genera una serie di notifiche di attivazione (risolte) e una cronologia dello stato di allarme rumoroso.

Ad esempio, se hai un avviso di latenza con una soglia di 1000 ms e il numero oscilla intorno a 1000 (ad esempio 980 ->1010 -> 990 -> 1020 e così via), ognuna di queste attiverà una notifica.

Per risolvere questo problema, puoi impostare una soglia di ripristino (personalizzata), che in pratica significa avere due soglie anziché una. Un avviso viene attivato quando viene superata la prima soglia e viene risolto solo quando viene superata la seconda soglia.

Ad esempio, è possibile impostare una soglia di 1000 ms e una soglia di ripristino di 900 ms. In questo modo, una regola di avviso smetterà di attivarsi solo quando scende al di sotto di 900 ms e il flapping viene ridotto.

# Istanze di avviso
<a name="v10-alerting-rules-instances"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 ne CPUs osserviamo dopo la prima valutazione, permettendo a una singola regola di riportare lo stato di ogni CPU.

# Namespace, cartelle e gruppi
<a name="v10-alerting-rules-grouping"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 cartelle per le regole gestite da Grafana e i namespace per le regole e i nomi dei gruppi di Mimir, Loki o Prometheus.

**Namespace e cartelle**

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.

Un namespace contiene uno o più gruppi. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari. L'intervallo predefinito è di un minuto. È possibile rinominare i namespace e i gruppi delle regole Grafana Mimi o Loki e modificare gli intervalli di valutazione dei gruppi.

**Groups (Gruppi)**

Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, il che significa che nessuna regola verrà valutata contemporaneamente e in ordine di apparizione. L'intervallo predefinito è di un minuto. È possibile rinominare gli spazi dei nomi delle regole Grafana Mimir o Loki o gli spazi dei nomi e i gruppi delle regole Loki e modificare gli intervalli di valutazione dei gruppi.

**Suggerimento**  
Se desideri che le regole vengano valutate contemporaneamente e con intervalli diversi, valuta la possibilità di archiviarle in gruppi diversi.

**Nota**  
Le regole di avviso gestite da Grafana vengono valutate contemporaneamente anziché in sequenza.

# Valutazione delle regole di avviso
<a name="v10-alerting-rules-evaluation"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Utilizzate la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e con quale rapidità deve cambiare il suo stato.

A tale scopo, è necessario assicurarsi che la regola di avviso rientri nel gruppo di valutazione corretto e impostare un periodo di attesa più adatto al caso d'uso.

## Gruppo di valutazione
<a name="v10-alerting-rules-evaluation-group"></a>

Ogni regola di avviso fa parte di un gruppo di valutazione. Ogni gruppo di valutazione contiene un intervallo di valutazione che determina la frequenza con cui viene controllata la regola di avviso.

Le regole di avviso **gestite da fonti di dati** all'interno dello stesso gruppo vengono valutate una dopo l'altra, mentre le regole di avviso in gruppi diversi possono essere valutate contemporaneamente. Questa funzionalità è particolarmente utile quando si desidera garantire che le regole di registrazione vengano valutate prima di qualsiasi regola di avviso.

Le regole di avviso **gestite da Grafana** vengono valutate contemporaneamente, indipendentemente dal gruppo di regole di avviso. L'intervallo di valutazione predefinito è impostato su 10 secondi, il che significa che le regole di avviso gestite da Grafana vengono valutate ogni 10 secondi rispetto alla finestra di 10 secondi più vicina sull'orologio, ad esempio 10:00:00, 10:00:10, 10:00:20 e così via. Puoi anche configurare il tuo intervallo di valutazione, se necessario.

**Nota**  
I gruppi di valutazione e il raggruppamento degli avvisi nelle politiche di notifica sono due cose distinte. Il raggruppamento in criteri di notifica consente di inviare più avvisi che condividono le stesse etichette nello stesso messaggio temporale.

## Periodo in sospeso
<a name="v10-alerting-rules-evaluation-pending-period"></a>

Impostando un periodo di attesa, è possibile evitare avvisi non necessari per problemi temporanei.

Nel periodo in sospeso, si seleziona il periodo in cui una regola di avviso può violare la condizione finché non viene attivata.

**Esempio**

Immagina di avere un intervallo di valutazione delle regole di avviso impostato ogni 30 secondi e il periodo in sospeso su 90 secondi.

La valutazione avverrà nel modo seguente:

[00:30] Prima valutazione: condizione non soddisfatta.

[01:00] Seconda valutazione: condizione violata. Il contatore in sospeso inizia. **L'avviso inizia a essere sospeso.**

[01:30] Terza valutazione: condizione violata. Contatore in sospeso = 30 secondi. **Stato in sospeso.**

[02:00] Quarta valutazione: condizione violata. **Contatore in sospeso = 60. Stato in sospeso.**

[02:30] Quinta valutazione: condizione violata. Contatore pendente = 90. **L'avviso inizia a sparare**

Se la regola di avviso presenta una condizione che deve essere violata per un determinato periodo di tempo prima di agire, il suo stato cambia come segue:
+ Quando la condizione viene violata per la prima volta, la regola passa allo stato «in sospeso».
+ La regola rimane nello stato «in sospeso» fino a quando la condizione non viene violata per il periodo di tempo richiesto (periodo in sospeso).
+ Una volta trascorso il tempo richiesto, la regola passa allo stato di «attivazione».
+ Se la condizione non viene più violata durante il periodo in sospeso, la regola torna allo stato normale.

**Nota**  
Se desideri ignorare lo stato in sospeso, puoi semplicemente impostare il periodo in sospeso su 0. In questo modo si salta effettivamente il periodo di attesa e la regola di avviso inizierà a funzionare non appena la condizione viene violata.

Quando viene attivata una regola di avviso, vengono generate istanze di avviso, che vengono quindi inviate all'Alertmanager.

# Stato e integrità delle regole di allarme
<a name="v10-alerting-explore-state"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. | 

**Mantieni l'ultimo stato**

È possibile configurare una regola di avviso per mantenere l'ultimo stato quando viene rilevato `Error` lo stato `NoData` o. In questo modo si eviterà che gli avvisi vengano attivati e che si risolvano e si riattivino. Proprio come la normale valutazione, la regola di avviso passerà da una `Pending` a una `Firing` volta trascorso il periodo di attesa.

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

# Modello di notifica
<a name="v10-alerting-rules-notification-templates"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-alerting-manage-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.

# Gestore degli avvisi
<a name="v10-alerting-explore-alertmanager"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 utilizzare 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 per impostazione predefinita.

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.

# Punti di contatto
<a name="v10-alerting-explore-contacts"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 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 Pagerduty, un'integrazione Amazon SNS e Slack o un'integrazione Pagerduty, 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.

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 [Configurare i punti di contatto](v10-alerting-configure-contactpoints.md) e[Personalizza le notifiche](v10-alerting-manage-notifications.md).

# Notifications
<a name="v10-alerting-explore-notifications"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 vostra capacità di risolvere rapidamente i problemi e di non tralasciare nulla di importante.

Come primo passo, definisci i tuoi [punti di contatto](v10-alerting-explore-contacts.md), che definiscono dove inviare le notifiche di avviso. Un punto di contatto è un insieme di una o più integrazioni utilizzate per inviare notifiche. Aggiungi modelli di notifica ai punti di contatto per riutilizzarli e inviare messaggi coerenti nelle notifiche.

Successivamente, crea una politica di notifica che consiste in 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.

## Gestori di avvisi
<a name="v10-alerting-explore-notifications-alertmanager"></a>

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="v10-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 predefinita. Può esserci solo una politica predefinita e la politica predefinita 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 annidata può avere le proprie politiche annidate, che consentono un'ulteriore corrispondenza degli avvisi. Un esempio di policy annidata 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 etichette, corrispondono alla politica predefinita. Tuttavia, quando la politica predefinita riceve un avviso, esamina ogni politica annidata e invia l'avviso alla prima politica nidificata che corrisponde all'avviso. Se la politica annidata include ulteriori politiche annidate, può tentare di abbinare l'avviso a una delle sue politiche nidificate. Se nessuna politica annidata corrisponde all'avviso, la politica stessa è la politica corrispondente. Se non ci sono politiche nidificate o nessuna politica nidificata corrisponde all'avviso, la politica predefinita è la politica corrispondente.

Per informazioni più dettagliate sulle politiche di notifica, vedere. [Politiche di notifica](v10-alerting-explore-notifications-policies-details.md)

## Modelli di notifica
<a name="v10-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.

Per informazioni più dettagliate sulla personalizzazione delle notifiche, consulta. [Personalizza le notifiche](v10-alerting-manage-notifications.md)

## Silenzi
<a name="v10-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.

Per informazioni più dettagliate sull'uso dei silenzi, vedere[Silenziamento delle notifiche di avviso](v10-alerting-silences.md).

# Politiche di notifica
<a name="v10-alerting-explore-notifications-policies-details"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 offrono un modo flessibile per indirizzare gli avvisi a vari ricevitori diversi. Utilizzando label matchers, puoi modificare l'invio delle notifiche di avviso senza dover aggiornare ogni singola regola di avviso.

In questa sezione, scoprirai di più su come funzionano e sono strutturate le politiche di notifica, in modo da poter sfruttare al massimo la configurazione delle politiche di notifica.

## Albero delle politiche
<a name="v10-alerting-explore-notifications-policy-tree"></a>

Le politiche di notifica *non* sono un elenco, ma sono strutturate secondo una struttura ad albero. Ciò significa che ogni policy può avere policy secondarie e così via. La radice dell'albero dei criteri di notifica è denominata **Politica di notifica predefinita**.

Ogni policy è costituita da una serie di abbinatori di etichette (0 o più) che specificano quali etichette sono o non sono interessati a gestire.

Per ulteriori informazioni sulla corrispondenza delle etichette, consulta[Come funziona l'abbinamento delle etichette](v10-alerting-overview-labels-matching.md).

**Nota**  
Se non hai configurato alcun abbinatore di etichette per la tua politica di notifica, la politica di notifica corrisponderà a *tutte le* istanze di avviso. Ciò potrebbe impedire la valutazione delle politiche relative ai minori a meno che tu non abbia abilitato **Continua ad abbinare fratelli** nella politica di notifica.

## Routing
<a name="v10-alerting-explore-notifications-routing"></a>

Per determinare quale politica di notifica gestirà quali istanze di avviso, devi iniziare esaminando il set esistente di politiche di notifica, a partire dalla politica di notifica predefinita.

Se non sono configurate politiche diverse dalla politica predefinita, la politica predefinita gestirà l'istanza di avviso.

Se vengono definite politiche diverse da quelle predefinite, verranno valutate tali politiche di notifica nell'ordine in cui vengono visualizzate.

Se una politica di notifica contiene criteri di abbinamento delle etichette che corrispondono alle etichette dell'istanza di avviso, passerà alle relative politiche secondarie e, se presenti, continuerà a cercare eventuali criteri secondari che potrebbero avere abbinatori di etichette che restringono ulteriormente il set di etichette e così via fino a quando non saranno più disponibili criteri secondari.

Se nessun criterio figlio è definito in un criterio di notifica o se nessuno dei criteri figlio ha abbinamenti di etichette che corrispondono alle etichette dell'istanza di avviso, viene utilizzato il criterio di notifica principale.

Non appena viene trovata una politica corrispondente, il sistema non continua a cercare altre politiche corrispondenti. Se desideri continuare a cercare altre politiche che potrebbero corrispondere, abilita **Continua ad abbinare i fratelli** in base a quella particolare politica.

Infine, se nessuna delle politiche di notifica è selezionata, viene utilizzata la politica di notifica predefinita.

### Esempio di routing
<a name="v10-alerting-explore-notifications-routing-example"></a>

Ecco un esempio di un albero di policy di notifica relativamente semplice e di alcune istanze di avviso.

![\[Un'immagine che mostra una serie di politiche di notifica in una struttura ad albero e una serie di istanze di avviso con etichette diverse da abbinare alle politiche.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/notification-routing.png)


Ecco un'analisi dettagliata di come vengono selezionate queste politiche:

**Pod stuck in CrashLoop** non ha un'`severity`etichetta, quindi nessuna delle sue politiche per bambini corrisponde. Ha un'`team=operations`etichetta, quindi la prima politica corrisponde.

La `team=security` politica non viene valutata poiché abbiamo già trovato una corrispondenza e **Continue matching siblings** non è stata configurata per quella politica.

**Utilizzo del disco: l'80%** ha `team` sia un'`severity`etichetta che corrisponde a una politica secondaria del team operativo.

La **voce di registro non autorizzata** ha un'`team`etichetta ma non corrisponde alla prima policy (`team=operations`) poiché i valori non sono gli stessi, quindi continuerà a cercare e corrisponderà alla `team=security` policy. Non ha criteri secondari, quindi l'`severity=high`etichetta aggiuntiva viene ignorata.

## Ereditarietà
<a name="v10-alerting-explore-notifications-inheritance"></a>

Oltre a essere un concetto utile per indirizzare le istanze di avviso, le politiche secondarie ereditano anche le proprietà dalla politica principale. Ciò vale anche per tutte le politiche che sono politiche secondarie della politica di notifica predefinita.

Le seguenti proprietà vengono ereditate dalle politiche secondarie:
+ Punto di contatto
+ Opzioni di raggruppamento
+ Opzioni di tempistica
+ Tempi di silenziamento

Ognuna di queste proprietà può essere sovrascritta da una singola politica se si desidera sovrascrivere le proprietà ereditate.

Per ereditare un punto di contatto dalla politica principale, lasciala vuota. **Per ignorare le opzioni di raggruppamento ereditate, abilita Ignora raggruppamento.** **Per sovrascrivere le opzioni di temporizzazione ereditate, abilita Sovrascrivi i tempi generali.**

### Esempio di ereditarietà
<a name="v10-alerting-explore-notifications-inheritance-example"></a>

L'esempio seguente mostra come l'albero delle politiche di notifica del nostro esempio precedente consenta alle politiche secondarie di `team=operations` ereditare il proprio punto di contatto.

In questo modo, possiamo evitare di dover specificare lo stesso punto di contatto più volte per ogni politica sui minori.

![\[Un'immagine che mostra una serie di politiche di notifica in una struttura ad albero, con punti di contatto assegnati ad alcune politiche, ma con alcune politiche per bambini che ereditano i punti di contatto dei genitori, anziché definire i propri.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/notification-inheritance.png)


## Opzioni di configurazione aggiuntive
<a name="v10-alerting-explore-notifications-additional-configuration-options"></a>

### Raggruppamento
<a name="v10-alerting-explore-notifications-grouping"></a>

Il raggruppamento è una funzionalità importante di Grafana Alerting in quanto consente di raggruppare gli avvisi pertinenti in un numero inferiore di notifiche. Ciò è particolarmente importante se le notifiche vengono inviate ai primi soccorritori, come i tecnici di guardia, dove ricevere molte notifiche in un breve periodo di tempo può essere difficile e in alcuni casi può influire negativamente sulla capacità del primo soccorritore di rispondere a un incidente. Ad esempio, si consideri un'interruzione di corrente di grandi dimensioni in cui molti sistemi sono inattivi. In questo caso, il raggruppamento può fare la differenza tra ricevere 1 telefonata e 100 telefonate.

Puoi scegliere come raggruppare gli avvisi utilizzando l'opzione Raggruppa per in una politica di notifica. Per impostazione predefinita, le politiche di notifica in Grafana raggruppano gli avvisi per regola di avviso utilizzando le `grafana_folder` etichette `alertname` e (poiché i nomi degli avvisi non sono univoci in più cartelle). Se desideri raggruppare gli avvisi in base a qualcosa di diverso dalla regola di avviso, modifica il raggruppamento in base a qualsiasi altra combinazione di etichette.

#### Disabilita il raggruppamento
<a name="v10-alerting-explore-notifications-disable-grouping"></a>

Se desideri ricevere ogni avviso come notifica separata, puoi farlo raggruppandoli in base a un'etichetta speciale chiamata. `...` Ciò è utile quando gli avvisi vengono inviati a un sistema automatizzato anziché a un primo soccorritore.

#### Un unico gruppo per tutti gli avvisi
<a name="v10-alerting-explore-notifications-a-single-group-for-all-alerts"></a>

Se desideri ricevere tutti gli avvisi insieme in un'unica notifica, puoi farlo lasciando vuoto il campo Raggruppa.

### Opzioni di temporizzazione
<a name="v10-alerting-explore-notifications-timing-options"></a>

Le opzioni di tempistica determinano la frequenza di invio delle notifiche per ogni gruppo di avvisi. È necessario conoscere tre timer: Attesa di gruppo, Intervallo di gruppo e Intervallo di ripetizione.

#### Attesa di gruppo
<a name="v10-alerting-explore-notifications-group-wait"></a>

L'attesa di gruppo è la quantità di tempo che Grafana attende prima di inviare la prima notifica per un nuovo gruppo di avvisi. Maggiore è l'attesa di gruppo, maggiore è il tempo a disposizione per l'arrivo di altri avvisi. Più breve è l'attesa di gruppo, tanto prima verrà inviata la prima notifica, ma con il rischio di inviare notifiche incomplete. Dovresti sempre scegliere un'attesa di gruppo più adatta al tuo caso d'uso.

**Impostazione predefinita**: 30 secondi

#### Intervallo di gruppo
<a name="v10-alerting-explore-notifications-group-interval"></a>

Una volta inviata la prima notifica per un nuovo gruppo di avvisi, Grafana avvia il timer a intervalli di gruppo. Questo è il periodo di tempo che Grafana attende prima di inviare notifiche sulle modifiche al gruppo. Ad esempio, un altro avviso di attivazione potrebbe essere appena stato aggiunto al gruppo mentre un avviso esistente potrebbe essere stato risolto. Se un avviso è arrivato troppo tardi per essere incluso nella prima notifica a causa dell'attesa di gruppo, verrà incluso nelle notifiche successive dopo l'intervallo di gruppo. Una volta trascorso l'intervallo di gruppo, Grafana ripristina il timer degli intervalli di gruppo. Questo si ripete finché non ci sono più avvisi nel gruppo, dopodiché il gruppo viene eliminato.

**Impostazione predefinita**: 5 minuti

#### Intervallo di ripetizione
<a name="v10-alerting-explore-notifications-repeat-interval"></a>

L'intervallo di ripetizione determina la frequenza con cui le notifiche vengono ripetute se il gruppo non è cambiato dall'ultima notifica. Puoi considerarle come promemoria del fatto che alcuni avvisi sono ancora attivi. L'intervallo di ripetizione è strettamente correlato all'intervallo di gruppo, il che significa che l'intervallo di ripetizione non deve essere solo maggiore o uguale all'intervallo di gruppo, ma deve anche essere un multiplo dell'intervallo di gruppo. Se l'intervallo di ripetizione non è un multiplo dell'intervallo di gruppo, verrà forzato a formare un unico intervallo. Ad esempio, se l'intervallo di ripetizione è di 5 minuti e l'intervallo di ripetizione è di 9 minuti, l'intervallo di ripetizione verrà arrotondato al multiplo di 5 più vicino, ovvero 10 minuti.

**Impostazione predefinita: 4 ore**

# Avvisi relativi all'elevata disponibilità
<a name="v10-alerting-explore-high-availability"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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)

Amazon Managed Grafana è configurato per l'alta disponibilità, inclusa l'esecuzione di più istanze su più zone di disponibilità per ogni area di lavoro che crei.

Grafana Alerting utilizza il modello Prometheus per separare la valutazione delle regole di avviso dall'invio delle notifiche. In questo modello, la valutazione delle regole di avviso viene eseguita nel generatore di avvisi e l'invio delle notifiche avviene nel ricevitore degli avvisi. In Grafana Alerting, il generatore di avvisi è lo Scheduler e il ricevitore è l'Alertmanager.

Con le configurazioni ad alta disponibilità, tutte le regole di avviso vengono valutate in tutte le istanze. Si può pensare alla valutazione delle regole di avviso come a una duplicazione. In questo modo Grafana Alerting assicura che finché almeno un'istanza Grafana funziona, le regole di avviso vengano comunque valutate e le notifiche per gli avvisi vengano comunque inviate. Vedrai questa duplicazione nella cronologia dello stato ed è un buon modo per capire se stai utilizzando l'alta disponibilità.

# Configurare gli avvisi
<a name="v10-alerting-setup"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

**Prerequisiti**

Prima di configurare gli avvisi, devi fare quanto segue.
+ Configura le tue [fonti di dati](AMG-data-sources.md).
+ Assicurati che l'origine dati che scegli sia compatibile e supportata dagli avvisi [Grafana](v10-alerting-overview-datasources.md).

**Per configurare gli avvisi**

1. Configurare le [regole di avviso](v10-alerting-configure.md).
   + Crea regole di avviso e regole di registrazione gestite da Grafana o gestite dall'origine dati.

1. [Configura i](v10-alerting-configure-contactpoints.md) punti di contatto.
   + Controlla il punto di contatto predefinito e aggiorna il contatto del tuo sistema.
   + Facoltativamente, aggiungi nuovi punti di contatto e integrazioni.

1. [Configura le politiche di notifica](v10-alerting-explore-notifications-policies-details.md)
   + Controlla la politica di notifica predefinita e aggiorna il tuo sistema.
   + Facoltativamente, aggiungi altre politiche annidate.
   + Facoltativamente, aggiungi etichette e abbinatori di etichette per controllare il routing degli avvisi.

I seguenti argomenti forniscono ulteriori informazioni sulle opzioni di configurazione aggiuntive, tra cui la configurazione di gestori di avvisi esterni e il routing degli avvisi gestiti da Grafana all'esterno di Grafana.

**Topics**
+ [Migrazione degli avvisi della dashboard classica agli avvisi Grafana](v10-alerting-use-grafana-alerts.md)
+ [Aggiungere un Alertmanager esterno](v10-alerting-setup-alertmanager.md)
+ [Fornitura di risorse Grafana Alerting](v10-alerting-setup-provision.md)

# Migrazione degli avvisi della dashboard classica agli avvisi Grafana
<a name="v10-alerting-use-grafana-alerts"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. [Avvisi classici del pannello di controllo](old-alerts-overview.md) Per passare al nuovo avviso Grafana, devi attivare la funzione. Per maggiori dettagli sulle differenze tra gli avvisi classici sulla dashboard e gli avvisi Grafana, consulta. [Avvisi Grafana e avvisi dashboard legacy](#v10-alerting-diff-old-new) GrafanaLabs ha annunciato che gli avvisi classici della dashboard verranno rimossi nella versione 11.

Quando utilizzi gli avvisi di dashboard classici, Amazon Managed Grafana ti mostra un'anteprima degli avvisi Grafana in cui puoi rivedere e modificare gli avvisi aggiornati prima di finalizzare l'aggiornamento.

## Visualizzazione in anteprima degli avvisi Grafana
<a name="v10-alerting-preview-grafana-alerts"></a>

Puoi visualizzare in anteprima i tuoi avvisi negli avvisi Grafana prima della migrazione. Nell'anteprima, puoi apportare modifiche agli avvisi che cambieranno la migrazione.

**Per visualizzare in anteprima la migrazione degli avvisi Grafana**

1. Accedi al tuo spazio di lavoro Grafana.

1. Dal menu a sinistra, scegli **Avvisi (versione precedente) per visualizzare gli avvisi** correnti.

1. Dal menu a sinistra, scegli **Alerting upgrade** per visualizzare i tuoi avvisi in Grafana alerting.

   Da questa vista, puoi vedere come appariranno i tuoi avvisi dopo la migrazione.

**Nota**  
Da questa visualizzazione, puoi anche apportare modifiche che influiranno sulla migrazione. Per annullare le modifiche apportate, scegli **Reimposta aggiornamento** in alto a destra nella pagina di aggiornamento.

Quando sei pronto per aggiornare i tuoi avvisi, consulta la sezione successiva.

## Migrazione al sistema di avvisi Grafana
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

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)

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="v10-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.

## Avvisi Grafana e avvisi dashboard legacy
<a name="v10-alerting-diff-old-new"></a>

Introdotti in Grafana 8, gli avvisi Grafana presentano diversi miglioramenti rispetto agli avvisi della dashboard legacy.

### Avvisi multidimensionali
<a name="v10-alerts-diff-multi-dimensional"></a>

Ora puoi creare avvisi che ti offrono visibilità a livello di sistema con un'unica regola di avviso. Genera più istanze di avviso da un'unica regola di avviso. Ad esempio, è possibile creare una regola per monitorare l'utilizzo del disco di più punti di montaggio su un singolo host. Il motore di valutazione restituisce più serie temporali da una singola query, con ogni serie temporale identificata dal relativo set di etichette.

### Crea avvisi al di fuori delle dashboard
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

A differenza degli avvisi del dashboard legacy, gli avvisi Grafana consentono di creare query ed espressioni che combinano dati provenienti da più fonti in modi unici. Puoi comunque collegare dashboard e pannelli alle regole di avviso utilizzando il relativo ID e risolvere rapidamente i problemi del sistema sotto osservazione.

Poiché gli avvisi unificati non sono più direttamente collegati alle interrogazioni dei pannelli, non includono immagini o valori di query nell'e-mail di notifica. È possibile utilizzare modelli di notifica personalizzati per visualizzare i valori delle query.

### Crea regole di avviso per Loki e Grafana Mimir
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

In Grafana Alerting, puoi gestire le regole di avviso di Loki e Grafana Mimir utilizzando la stessa interfaccia utente e API degli avvisi gestiti Grafana.

### Visualizza e cerca avvisi da fonti di dati compatibili con Prometheus
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Gli avvisi per le fonti di dati compatibili con Prometheus sono ora elencati nella sezione Avvisi Grafana. Puoi cercare etichette su più fonti di dati per trovare rapidamente gli avvisi pertinenti.

### Avvisi speciali per stato NoData di avviso ed errore
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting ha introdotto un nuovo concetto di stati di allerta. Quando la valutazione di una regola di avviso produce uno stato NoData o un errore, Grafana Alerting genererà avvisi speciali con le seguenti etichette:
+ `alertname`con valore DatasourceNoData o in DatasourceError base allo stato.
+ `rulename`nome della regola di avviso a cui appartiene l'avviso speciale.
+ `datasource_uid`avrà l'UID della fonte di dati che ha causato lo stato.
+ Tutte le etichette e le annotazioni della regola di avviso originale

È possibile gestire questi avvisi allo stesso modo degli avvisi normali aggiungendo un silenzio, un percorso verso un punto di contatto e così via.

**Nota**  
Se la regola utilizza molte fonti di dati e una o più non restituisce alcun dato, verrà creato l'avviso speciale per ogni fonte di dati che ha causato lo stato di avviso.

# Aggiungere un Alertmanager esterno
<a name="v10-alerting-setup-alertmanager"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

**Nota**  
Non puoi utilizzare Amazon Managed Service for Prometheus come gestore di avvisi esterno.

Dopo aver aggiunto l'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.

I gestori di avvisi esterni sono 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.

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

**Per aggiungere un Alertmanager esterno**

1. Scegli **Connessioni** dal menu principale a sinistra.

1. Cercare `Alertmanager`.

1. Scegli il pulsante **Crea una nuova fonte di dati**.

1. 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. **Scegli Salva e prova**.

# Fornitura di risorse Grafana Alerting
<a name="v10-alerting-setup-provision"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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](v10-alerting-setup-provision-terraform.md)
+ [Visualizzazione delle risorse di avviso assegnate a Grafana](v10-alerting-setup-provision-view.md)

# Crea e gestisci risorse di avviso utilizzando Terraform
<a name="v10-alerting-setup-provision-terraform"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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="v10-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="v10-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="v10-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 altri dettagli del punto di 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="v10-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="v10-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="v10-alerting-setup-provision-tf-rules"></a>

[Le regole di avviso](v10-alerting-configure.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="v10-alerting-setup-provision-view"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

# Configurare gli avvisi
<a name="v10-alerting-configure"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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**
+ [Configura le regole di avviso gestite da Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Configurazione delle regole di avviso gestite dall'origine dati](v10-alerting-configure-datasourcemanaged.md)
+ [Configurare le regole di registrazione](v10-alerting-configure-recordingrules.md)
+ [Configurare i punti di contatto](v10-alerting-configure-contactpoints.md)
+ [Configurazione delle politiche di notifica](v10-alerting-configure-notification-policies.md)

# Configura le regole di avviso gestite da Grafana
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 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. È supportato anche l'utilizzo di immagini nelle notifiche di avviso. Questo è l'unico tipo di regola che consente l'invio di avvisi da più fonti di dati in un'unica definizione di regola.

È possibile creare più istanze di avviso come risultato di un'unica regola di avviso (nota anche come avviso multidimensionale).

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.

Se elimini una risorsa di avviso creata nell'interfaccia utente, non puoi più recuperarla. Per eseguire un backup della configurazione e poter ripristinare le risorse di avviso eliminate, crea le risorse di avviso utilizzando Terraform o l'API Alerting.

Nelle seguenti procedure, esamineremo il processo di creazione delle regole di avviso gestite da Grafana.

Per creare una regola di avviso gestita da Grafana, utilizza il flusso di creazione degli avvisi in-workspace e segui questi passaggi per aiutarti.

**Imposta il nome della regola di avviso**

1. Scegli **Avvisi** -> **Regole di avviso** -> **\$1 Nuova regola di avviso**.

1. Inserisci un nome per identificare la tua regola di avviso.

   Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.

Quindi, definisci una query per ottenere i dati che desideri misurare e una condizione da soddisfare prima che venga attivata una regola di avviso.

**Per definire l'interrogazione e la condizione**

1. Seleziona una fonte di dati.

1. Dal menu a discesa **Opzioni**, specifica un [intervallo di tempo](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**Nota**  
Grafana Alerting supporta solo intervalli di tempo relativi fissi, ad esempio. `now-24hr: now`  
Non supporta intervalli di tempo assoluti: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` o intervalli di tempo semi-relativi:. `now/d to: now`

1. Aggiungi una query.

   Per aggiungere più [interrogazioni](v10-panels-query-xform.md#v10-panels-query-xform-add), scegli **Aggiungi interrogazione**.

   Tutte le regole di avviso sono gestite da Grafana per impostazione predefinita. Se desideri passare a una regola di avviso gestita dall'origine dati, fai clic su **Passa a una regola di avviso gestita dall'origine dati**.

1. [Aggiungi una o più espressioni.](v10-panels-query-xform-expressions.md)

   1. 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 un avviso separato per ogni serie.
**Nota**  
Quando si utilizza Prometheus, è possibile utilizzare un vettore istantaneo e funzioni integrate, quindi non è necessario aggiungere espressioni aggiuntive.

   1. Scegliete **Anteprima** per verificare che l'espressione abbia esito positivo.

1. [Facoltativo] Per aggiungere una soglia di ripristino, attiva l'opzione **Soglia di ripristino personalizzata** e inserisci un valore per indicare quando la regola di avviso deve smettere di funzionare.

   È possibile aggiungere solo una soglia di ripristino in una query e deve essere la condizione di avviso.

1. Scegli **Imposta come condizione di avviso** sulla query o sull'espressione che desideri impostare come condizione di avviso.

Utilizza la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e la velocità con cui deve cambiare il suo stato.

A tale scopo, è necessario assicurarsi che la regola di avviso rientri nel gruppo di valutazione corretto e impostare un periodo di attesa più adatto al caso d'uso.

**Per impostare il comportamento di valutazione degli avvisi**

1. Seleziona una cartella o scegli **\$1 Nuova cartella**.

1. Seleziona un gruppo di valutazione o fai clic su **\$1 Nuovo gruppo di valutazione**.

   Se state creando un nuovo gruppo di valutazione, specificate l'intervallo per il gruppo.

   Tutte le regole all'interno dello stesso gruppo vengono valutate contemporaneamente nello stesso intervallo di tempo.

1. Inserisci un periodo in sospeso.

   Il periodo in sospeso è il periodo in cui una regola di avviso può violare la condizione finché non viene attivata.

   **Una volta soddisfatta una condizione, l'avviso passa allo stato In sospeso.** **Se la condizione rimane attiva per la durata specificata, l'avviso passa allo stato **Attivo**, altrimenti torna allo stato Normale.**

1. Attiva le notifiche di avviso di pausa, se necessario.
**Nota**  
Metti in pausa la valutazione delle regole di avviso per evitare allarmi rumorosi durante l'ottimizzazione degli avvisi. La pausa interrompe la valutazione delle regole di avviso e non crea alcuna istanza di avviso. Ciò è diverso dagli orari di silenziamento, che impediscono l'invio delle notifiche, ma consentono comunque la valutazione delle regole di avviso e la creazione di istanze di avviso.  
È possibile sospendere la valutazione delle regole di avviso per evitare allarmi rumorosi durante l'ottimizzazione degli avvisi. La pausa interrompe la valutazione delle regole di avviso e non crea alcuna istanza di avviso. Ciò è diverso dagli orari di silenziamento, che impediscono l'invio delle notifiche, ma consentono comunque la valutazione delle regole di avviso e la creazione di istanze di avviso.

1. In **Configure no data and error handling**, configura il comportamento di avviso in assenza di dati.

   Utilizza le linee guida riportate più avanti in questa sezione.

Aggiungi etichette alle regole di avviso per impostare quale politica di notifica deve gestire le istanze di allarme di licenziamento.

Tutte le regole e le istanze di avviso, indipendentemente dalle relative etichette, corrispondono alla politica di notifica predefinita. Se non ci sono politiche nidificate o nessuna politica nidificata corrisponde alle etichette nella regola di avviso o nell'istanza di avviso, la politica di notifica predefinita è la politica corrispondente.

**Per configurare le notifiche**

1. Aggiungi etichette se desideri modificare il modo in cui vengono instradate le notifiche.

   Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa oppure aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

1. Visualizza l'anteprima della configurazione del routing delle istanze di avviso.

   In base alle etichette aggiunte, le istanze di avviso vengono indirizzate alle politiche di notifica visualizzate.

   Espandi ogni politica di notifica per visualizzare ulteriori dettagli.

1. Scegli **Visualizza dettagli** per visualizzare i dettagli sul routing degli avvisi e un'anteprima.

Aggiungi [annotazioni](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) per fornire più contesto sull'avviso nel tuo messaggio di notifica di avviso.

Le annotazioni aggiungono metadati per fornire ulteriori informazioni sull'avviso nel messaggio di notifica di avviso. Ad esempio, aggiungi un'annotazione di **riepilogo** per indicare quale valore ha causato l'attivazione dell'avviso o su quale server è avvenuto.

**Per aggiungere annotazioni**

1. [Facoltativo] Aggiungi un riepilogo.

   Breve riassunto di quello che è successo e perché.

1. [Facoltativo] Aggiungi una descrizione.

   Descrizione del funzionamento della regola di avviso.

1. [Facoltativo] Aggiungi un URL del Runbook.

   Pagina web in cui conservi il runbook per l'avviso

1. [Facoltativo] Aggiungi un'annotazione personalizzata

1. [Facoltativo] Aggiungi un link alla dashboard e al pannello.

   Collega gli avvisi ai pannelli di una dashboard.

1. Scegli **Salva regola**.

**Regola singola e multidimensionale**

Per gli avvisi gestiti da Grafana, puoi creare una regola con una condizione classica oppure puoi creare una regola multidimensionale.
+ **Regola con condizione classica**

  Usa l'espressione di condizione classica per creare una regola che attiva 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.
+ **Regola multidimensionale**

  Per generare un avviso separato per ogni serie, crea una regola multidimensionale. Usa `Math``Reduce`, o `Resample` espressioni per creare una regola multidimensionale. Esempio:
  + 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)](v10-alerting-overview-numeric.md).
  + Aggiungi un'`Math`espressione con la condizione per la regola. Non necessario nel caso in cui una query o un'espressione di riduzione restituisca già `0` se la regola non deve attivarsi o un numero positivo se deve attivarsi. Alcuni esempi: `$B > 70` se dovesse attivarsi nel caso in cui il valore di B query/expression sia superiore a 70. `$B < $C * 100`nel caso in cui si attivasse se il valore di B è inferiore al valore di C moltiplicato per 100. Se le query confrontate hanno 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 all'indirizzo [https://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert

**Nessuna configurazione per la gestione dei dati e degli errori**

Configura il comportamento di avviso quando la valutazione della regola di avviso non restituisce dati o restituisce errori.

**Nota**  
Le regole di avviso configurate per essere attivate quando una valutazione non restituisce dati o errori vengono attivate solo al termine dell'intera durata del periodo di valutazione. **Ciò significa che anziché essere attivata immediatamente quando viene violata la condizione della regola di avviso, la regola di avviso attende il termine del periodo impostato come campo For e quindi viene attivata, riducendo il rumore di avviso e consentendo problemi temporanei di disponibilità dei dati.**

Se la valutazione della regola di avviso non restituisce dati, è possibile impostare lo stato della regola di avviso in modo che appaia come segue:


| Nessun dato | Description | 
| --- | --- | 
| Nessun dato | Crea un nuovo 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 La regola di avviso attende il termine del tempo impostato nel campo For prima di essere attivata. | 
| Ok | Imposta lo stato della regola di avviso su. Normal | 

Se la valutazione restituisce un errore, puoi impostare lo stato della regola di avviso in modo che appaia come segue:


| Errore | Description | 
| --- | --- | 
| Errore | Crea un'istanza di 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. | 
| Avviso | Imposta lo stato della regola di avviso su. Alerting La regola di avviso attende il termine del tempo impostato nel campo For prima di essere attivata. | 
| Ok | Imposta lo stato della regola di avviso su. Normal | 

**Risolve le istanze di avviso obsolete**

Un'istanza di avviso è considerata obsoleta se la sua dimensione o serie è scomparsa completamente dai risultati della query per due intervalli di valutazione.

Le istanze di avviso non aggiornate che si trovano negli `Error` stati`Alerting`/`NoData`/vengono contrassegnate automaticamente come `Resolved` e l'`grafana_state_reason`annotazione viene aggiunta all'istanza di avviso con il motivo. `MissingSeries`

**Crea avvisi dai pannelli**

Crea avvisi da qualsiasi tipo di pannello. Ciò significa che puoi riutilizzare le interrogazioni nel pannello e creare avvisi basati su di esse.

1. **Accedi a una dashboard nella sezione Dashboard.**

1. Nell'angolo in alto a destra del pannello, scegli i tre punti (ellissi).

1. **Dal menu a discesa, seleziona **Altro...**, quindi scegli Nuova regola di avviso.**

Si aprirà il modulo delle regole di avviso, che ti consentirà di configurare e creare l'avviso in base alla query del pannello corrente.

# Configurazione delle regole di avviso gestite dall'origine dati
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 regole di avviso per un'istanza Grafana Mimir o Loki esterna con l'API dei righelli abilitata; queste sono chiamate regole di avviso gestite dall'origine dei dati.

**Nota**  
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.  
Se elimini una risorsa di avviso creata nell'interfaccia utente, non puoi più recuperarla. Per eseguire un backup della configurazione e poter ripristinare le risorse di avviso eliminate, crea le risorse di avviso utilizzando Terraform o l'API Alerting.

**Prerequisiti**
+ Verifica di disporre dell'autorizzazione di scrittura per l'origine dati Prometheus o Loki. In caso contrario, non sarà possibile creare o aggiornare le regole di avviso gestite di Grafana Mimir.
+ 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 delle regole.
  + **Grafana Mimir**: usa il prefisso. `/prometheus` [https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) 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.**

Nelle seguenti procedure, ti guideremo attraverso il processo di creazione delle regole di avviso gestite dalle origini dati.

Per creare una regola di avviso gestita dall'origine dati, utilizza il flusso di creazione di avvisi in-workspace e segui questi passaggi per aiutarti.

**Per impostare il nome della regola di avviso**

1. Scegli **Avvisi** -> **Regole di avviso** -> **\$1 Nuova regola di avviso**.

1. Inserisci un nome per identificare la tua regola di avviso.

   Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.

Definisci una query per ottenere i dati che desideri misurare e una condizione da soddisfare prima che venga attivata una regola di avviso.

**Per definire l'interrogazione e la condizione**

1. Tutte le regole di avviso sono gestite da Grafana per impostazione predefinita. Per passare a una regola di avviso gestita dall'origine dati, scegli **Passa a una regola di avviso gestita dall'origine dati**.

1. Seleziona una fonte di dati dall'elenco a discesa.

   Puoi anche scegliere **Apri selettore avanzato di sorgenti dati** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo amministratori).

1. Inserisci una query PromQL o LogQL.

1. Scegli **Anteprima** avvisi.

Utilizza la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e la velocità con cui deve cambiare il suo stato.

**Per impostare il comportamento di valutazione degli avvisi**

1. Seleziona uno spazio dei nomi o scegli **\$1 Nuovo** spazio dei nomi.

1. Seleziona un gruppo di valutazione o scegli **\$1** Nuovo gruppo di valutazione.

   Se state creando un nuovo gruppo di valutazione, specificate l'intervallo per il gruppo.

   Tutte le regole all'interno dello stesso gruppo vengono valutate in sequenza nello stesso intervallo di tempo.

1. Inserisci un periodo in sospeso.

   Il periodo in sospeso è il periodo in cui una regola di avviso può violare la condizione finché non viene attivata.

   Una volta soddisfatta una condizione, l'avviso entra nello stato. `Pending` Se la condizione rimane attiva per la durata specificata, l'avviso passa allo `Firing` stato, altrimenti torna allo `Normal` stato.

Aggiungi etichette alle regole di avviso per impostare quale politica di notifica deve gestire le istanze di allarme di licenziamento.

Tutte le regole e le istanze di avviso, indipendentemente dalle relative etichette, corrispondono alla politica di notifica predefinita. Se non ci sono politiche nidificate o nessuna politica nidificata corrisponde alle etichette nella regola di avviso o nell'istanza di avviso, la politica di notifica predefinita è la politica corrispondente.

**Per configurare le notifiche**
+ Aggiungi etichette se desideri modificare il modo in cui vengono instradate le notifiche.

  Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa oppure aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

Aggiungi [annotazioni](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) per fornire più contesto all'avviso nelle notifiche di avviso.

Le annotazioni aggiungono metadati per fornire ulteriori informazioni sull'avviso nelle notifiche di avviso. Ad esempio, aggiungi un'`Summary`annotazione per indicare quale valore ha causato l'attivazione dell'avviso o su quale server è avvenuto.

**Per aggiungere annotazioni**

1. [Facoltativo] Aggiungi un riepilogo.

   Breve riassunto di quello che è successo e perché.

1. [Facoltativo] Aggiungi una descrizione.

   Descrizione del funzionamento della regola di avviso.

1. [Facoltativo] Aggiungi un URL del Runbook.

   Pagina web in cui conservi il runbook per l'avviso

1. [Opzionale] Aggiungi un'annotazione personalizzata

1. [Facoltativo] Aggiungi un link alla dashboard e al pannello.

   Collega gli avvisi ai pannelli di una dashboard.

1. Scegli **Salva regola**.

# Configurare le regole di registrazione
<a name="v10-alerting-configure-recordingrules"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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ù veloce, soprattutto per le dashboard, poiché interrogano la stessa espressione ogni volta che le dashboard si aggiornano.

**Nota**  
Le regole di registrazione vengono eseguite come regole di istanza e vengono eseguite ogni 10 secondi.

**Prerequisiti**
+ Verifica di disporre delle autorizzazioni di scrittura per l'origine dati Prometheus o Loki. Creerai o aggiornerai le regole di avviso nella tua fonte di dati.
+ 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 prefisso. `/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 creare regole di registrazione**

1. **Dalla console Grafana, nel menu Grafana, scegli **Avvisi, Regole di avviso**.**

1. Scegli **Nuova** regola di registrazione.

1. Imposta il nome della regola.

   Il nome della regola di registrazione deve essere un nome metrico di Prometheus e non contenere spazi bianchi.

1. Definisci l'interrogazione
   + Seleziona la tua fonte di dati Loki o Prometheus.
   + Inserisci una query.

1. Aggiungi namespace e gruppo.
   + Dal menu a discesa **Namespace**, seleziona uno spazio dei nomi di regole esistente o aggiungine uno nuovo. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo.
   + Dal menu a discesa **Gruppo**, seleziona un gruppo esistente all'interno del namespace selezionato o aggiungine uno nuovo. 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. Aggiungi etichette.
   + Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa o aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

1. Scegli **Salva regola** per salvare la regola o **Salva regola ed esci** per salvare la regola e tornare alla pagina Avvisi.

# Configurare i punti di contatto
<a name="v10-alerting-configure-contactpoints"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

**Nota**  
Puoi creare e modificare punti di contatto per gli avvisi gestiti da Grafana. I punti di contatto per gli avvisi gestiti dall'origine dati sono di sola lettura.

## Lavorare con i punti di contatto
<a name="v10-alerting-configure-contactpoints-working"></a>

Le seguenti procedure mostrano come aggiungere, modificare, eliminare e testare un punto di contatto.

**Per aggiungere un punto di contatto**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Punti di contatto.**

1. Dal menu a discesa **Scegli Alertmanager**, seleziona un Alertmanager. Il Grafana Alertmanager è selezionato per impostazione predefinita.

1. Nella scheda **Punti di contatto**, scegli **\$1 Aggiungi** punto di contatto.

1. Inserisci un **nome** per il punto di contatto.

1. Da **Integrazione**, scegli un tipo e compila 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. Per aggiungere un'altra integrazione con i punti di contatto, scegli **Aggiungi integrazione con i punti di contatto** e ripeti i passaggi per ogni tipo di punto di contatto necessario.

1. Salvare le modifiche.

**Per modificare un punto di contatto**

1. **Nel menu a sinistra, scegli Avvisi.**

1. Scegli **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti.

1. Seleziona il punto di contatto da modificare, quindi scegli **Modifica**.

1. Aggiorna il punto di contatto, quindi salva le modifiche.

È possibile eliminare i punti di contatto che non sono utilizzati in base a una politica di notifica.

**Per eliminare un punto di contatto**

1. **Nel menu a sinistra, scegli Avvisi.**

1. Scegli **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. In **Punti di contatto**, seleziona il punto di contatto da eliminare, quindi scegli **Altro**, **Elimina**.

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.

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. **Nel menu a sinistra, scegli Avvisi.**

1. Scegli **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. In **Punti di contatto**, seleziona il punto di contatto da testare, quindi scegli **Modifica**. Se necessario, puoi anche creare un nuovo punto di contatto.

1. Scegli **Test** per aprire la finestra di dialogo per il test dei punti di contatto.

1. Scegli se inviare una notifica di test predefinita o scegli **Personalizzato** 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.

## Configura le integrazioni dei punti di contatto
<a name="v10-alerting-configure-contactpoints-integration"></a>

Configura le integrazioni dei punti di contatto in Grafana per selezionare il tuo canale di comunicazione preferito per ricevere notifiche quando le tue regole di avviso sono attive. Ogni integrazione ha le proprie opzioni di configurazione e il proprio processo di configurazione. Nella maggior parte dei casi, ciò comporta la fornitura di una chiave API o di un URL Webhook.

Una volta configurato, puoi utilizzare le integrazioni come parte dei tuoi punti di contatto per ricevere notifiche ogni volta che l'avviso cambia stato. In questa sezione, illustreremo i passaggi di base per configurare un'integrazione, ad esempio, in modo da poter iniziare a ricevere avvisi in tempo reale e rimanere aggiornato sui dati di monitoraggio. PagerDuty 

**Elenco delle integrazioni supportate**

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` | 

**Configurazione PagerDuty per gli avvisi**

Per eseguire la configurazione PagerDuty, è necessario fornire una chiave di integrazione. Fornisci i seguenti dettagli.


| Impostazione | Description | 
| --- | --- | 
| Chiave di integrazione | Chiave di integrazione per PagerDuty | 
| Gravità | Livello per notifiche dinamiche. Il valore predefinito è “critical”. | 
| Dettagli personalizzati | Dettagli aggiuntivi sull'evento | 

Il `CustomDetails` campo è un oggetto contenente coppie chiave-valore arbitrarie. I dettagli definiti dall'utente vengono uniti a quelli utilizzati di default.

I valori predefiniti per `CustomDetails` sono:

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

In caso di chiavi duplicate, i dettagli definiti dall'utente sovrascrivono quelli predefiniti.

# Configurazione delle politiche di notifica
<a name="v10-alerting-configure-notification-policies"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 annidate. Ogni politica, ad eccezione della politica predefinita, può anche corrispondere a etichette di avviso specifiche.

Ogni avviso viene valutato in base alla politica predefinita e successivamente in base a ciascuna politica annidata.

Se abiliti l'`Continue matching subsequent sibling nodes`opzione per una politica annidata, 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. Un criterio predefinito regola qualsiasi avviso che non corrisponde a un criterio annidato.

Per ulteriori informazioni sulle politiche di notifica, vedere. [Notifications](v10-alerting-explore-notifications.md)

Le seguenti procedure mostrano come creare e gestire le politiche di notifica.

**Per modificare la politica di notifica predefinita**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Scegli Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Nella sezione Politica **predefinita, scegli**...** , **Modifica**.

1. In **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 in base alle quali raggruppare gli avvisi. Se per questa politica corrispondono più avvisi, questi vengono raggruppati in base a queste etichette. Viene inviata una notifica per gruppo. Se il campo è vuoto (impostazione predefinita), tutte le notifiche vengono inviate in un unico gruppo. Utilizza un'etichetta speciale `...` per raggruppare gli avvisi in base a tutte le etichette (il che di fatto disabilita il raggruppamento).

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 creare una nuova politica di notifica, è necessario seguirne la struttura ad albero. Le nuove politiche create sul tronco dell'albero (la politica predefinita) sono i rami degli alberi. Ogni ramo può avere le proprie politiche annidate. Questo è il motivo per cui aggiungerai sempre una nuova politica **annidata**, in base alla politica predefinita o in base a una politica già annidata.

**Per aggiungere una nuova politica annidata**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Scegli Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Per aggiungere una politica specifica di primo livello, vai alla sezione Routing specifico (alla politica predefinita o a un'altra politica esistente in cui desideri aggiungere una nuova politica annidata) e scegli \$1 Nuova politica nidificata.**

1. Nella sezione delle etichette corrispondenti, aggiungi una o più regole per abbinare le etichette degli avvisi.

1. Nel menu a discesa **Punto di contatto**, seleziona il punto di contatto a cui inviare notifiche se un avviso corrisponde solo a questa politica specifica e non a nessuna delle politiche annidate.

1. Facoltativamente, abilita **Continua ad abbinare 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 questa opzione è abilitata, puoi ricevere più di una notifica per ogni avviso.

1. Facoltativamente, abilita il **raggruppamento Override** per specificare lo stesso raggruppamento della politica predefinita. Se l'opzione non è abilitata, viene utilizzato il raggruppamento di criteri predefinito.

1. Facoltativamente, abilita **Ignora gli orari generali per sovrascrivere le** opzioni di temporizzazione configurate nella politica di notifica di gruppo.

1. Scegli **Salva** per salvare le modifiche.

**Per modificare una politica annidata**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Politiche di notifica.**

1. Seleziona la politica che desideri modificare, quindi scegli**...** , **Modifica**.

1. Apporta eventuali modifiche (come quando aggiungi una politica annidata).

1. Salvare le modifiche.

**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**. Le politiche che utilizzano quel punto di contatto verranno evidenziate nell'interfaccia utente.
+ Per effettuare la ricerca per etichetta, inserisci un abbinatore di etichette valido nel campo di immissione **Cerca per abbinatori**. È 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.

# Gestisci i tuoi avvisi
<a name="v10-alerting-manage"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 impostato le regole di avviso, i punti di contatto e le politiche di notifica, puoi utilizzare gli avvisi Grafana per gestire gli avvisi nella pratica.

**Topics**
+ [Personalizza le notifiche](v10-alerting-manage-notifications.md)
+ [Gestisci i punti di contatto](v10-alerting-manage-contactpoints.md)
+ [Silenziamento delle notifiche di avviso](v10-alerting-silences.md)
+ [Visualizza e filtra le regole di avviso](v10-alerting-manage-rules-viewfilter.md)
+ [Tempi di silenziamento](v10-alerting-manage-muting.md)
+ [Visualizza lo stato e lo stato delle regole di avviso](v10-alerting-manage-rulestate.md)
+ [Visualizza e filtra per gruppi di avvisi](v10-alerting-manage-viewfiltergroups.md)
+ [Visualizza gli errori di notifica](v10-alerting-manage-viewnotificationerrors.md)

# Personalizza le notifiche
<a name="v10-alerting-manage-notifications"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 specifici, come Amazon SNS 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, inclusi il riepilogo, la descrizione, le etichette e le annotazioni, i valori e i collegamenti
+ 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](v10-alerting-notifications-go-templating.md)
+ [Crea modelli di notifica](v10-alerting-create-templates.md)
+ [Utilizzo di modelli di notifica](#v10-alerting-use-notification-templates)
+ [Riferimento modello](v10-alerting-template-reference.md)

# Usare il linguaggio di template di Go
<a name="v10-alerting-notifications-go-templating"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-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 elenco `range` superiore a un elenco, quando viene utilizzato all'interno di un `with` o quando si scrivono modelli di funzionalità da utilizzare in altri modelli. Puoi vederne alcuni esempi in[Crea modelli di notifica](v10-alerting-create-templates.md), e tutti i dati e le funzioni in[Riferimento modello](v10-alerting-template-reference.md).

## Tag di apertura e chiusura
<a name="v10-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="v10-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](#v10-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="v10-go-iterate-alerts"></a>

Per stampare solo le etichette di ogni avviso, anziché tutte le informazioni sull'avviso, puoi utilizzare `range` a per ripetere 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="v10-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 }}
```

## Le funzioni dell'indice
<a name="v10-go-index"></a>

Per stampare un'annotazione o un'etichetta specifica, usa la `index` funzione.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Dichiarazioni If
<a name="v10-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="v10-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="v10-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="v10-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="v10-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 }}
```

## Esegui modelli
<a name="v10-go-execute"></a>

È possibile eseguire 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="v10-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="v10-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="v10-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="v10-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="v10-alerting-create-templates"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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="v10-alerting-creating-templates"></a>

**Per creare un modello di notifica**

1. Scegli **Avvisi**, **Punti di contatto**.

1. Scegli la scheda **Modelli di notifica**, quindi **\$1 Aggiungi modello di notifica**.

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. Salvare le modifiche.

   `{{ 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. Scegli **Avvisi**, **Punti di contatto**.

1. Scegli la scheda **Modelli di notifica**, quindi **\$1 Aggiungi modello di notifica**.

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 successive mostrano esempi dettagliati di modelli che potresti creare.

1. Fai clic su Salva.

## Visualizza in anteprima i modelli di notifica
<a name="v10-alerting-preview-templates"></a>

Visualizza in anteprima l'aspetto dei modelli di notifica prima di utilizzarli nei punti di contatto, aiutandoti a comprendere il risultato del modello che stai creando e dandoti la possibilità di correggere eventuali errori prima di salvare il modello.

**Nota**  
Le anteprime delle notifiche sono disponibili solo per Grafana Alertmanager.

**Per visualizzare in anteprima i modelli di notifica**

1. Scegli **Avvisi**, **Punti di contatto**.

1. Scegli la scheda **Modelli di notifica**, quindi **\$1 Aggiungi modello di notifica** o modifica un modello esistente.

1. Aggiungi o aggiorna il contenuto del modello.

   Vengono forniti dati predefiniti ed è possibile aggiungere o modificare i dati degli avvisi e le istanze di avviso. È possibile aggiungere i dati di avviso direttamente nella finestra dei dati Payload stessa oppure fare clic su **Seleziona istanze di avviso** o **Aggiungi** avvisi personalizzati.

1. [Facoltativo] Per aggiungere dati di avviso da istanze di avviso esistenti:

   1. Scegli **Seleziona istanze di avviso**.

   1. Passa il mouse sulle istanze di avviso per visualizzare ulteriori informazioni su ciascuna istanza di avviso/

   1. Scegli **Conferma** per aggiungere l'istanza di avviso al payload.

1. [Facoltativo] Per aggiungere dati di avviso utilizzando l'editor di dati di avviso, scegli **Aggiungi dati personalizzati**:

   1. Aggiungi annotazioni, etichette personalizzate o imposta una dashboard o un pannello.

   1. Attiva o Risolto, a seconda che tu voglia aggiungere avvisi di attivazione o risolti alla notifica.

   1. **Scegli Aggiungi dati di avviso.**

   1. Scegli **Aggiorna anteprima** per vedere come apparirà il contenuto del modello e i dati del payload corrispondenti.

   Se ci sono errori nel modello, questi vengono visualizzati nell'anteprima e puoi correggerli prima di salvarli.

1. Salvare le modifiche.

## Creazione di un modello per l'oggetto del messaggio
<a name="v10-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="v10-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="v10-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. Esegui il modello dal campo del titolo nell'integrazione del tuo punto di contatto.

   ```
   {{ template "slack.title" . }}
   ```

## Creazione di un modello per il contenuto di un messaggio Slack
<a name="v10-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.

**Nota**  
Questo modello è solo per gli avvisi gestiti da Grafana. Per utilizzare il modello per gli avvisi gestiti dall'origine dati, elimina i riferimenti a dashboardURL e silenceURL. [Per ulteriori informazioni sulla configurazione delle notifiche di Prometheus, consulta la documentazione di Prometheus sulle notifiche.](https://prometheus.io/docs/alerting/latest/notifications/)

```
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. Esegui il modello dal campo del corpo del testo nell'integrazione del punto di contatto:

   ```
   {{ template "slack.message" . }}
   ```

## Crea modelli sia per email che per Slack con modelli condivisi
<a name="v10-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 di modelli di notifica
<a name="v10-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 la scheda **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti.

1. Scegli **New (Nuovo)**. In alternativa, puoi modificare un punto di contatto esistente scegliendo l'icona **Modifica**.

1. Inserisci i modelli che desideri utilizzare in un campo, ad esempio **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. Scegli **Salva punto di contatto**.

# Riferimento modello
<a name="v10-alerting-template-reference"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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.

**Avviso (tipo)**

Il tipo di avviso contiene i seguenti dati.


| Name | Tipo | Description | Esempio | 
| --- | --- | --- | --- | 
|  Status  |  stringa  |  `firing` o `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Etichette  |  KeyValue  |  Un set di etichette allegate all'avviso.  | \$1\$1 .Labels \$1\$1 | 
|  Annotazioni  |  KeyValue  |  Un insieme di annotazioni allegate all'avviso.  | \$1\$1 .Annotations \$1\$1 | 
| Valori | KeyValue | I valori di tutte le espressioni, incluse le condizioni classiche | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  Time.time  |  L'ora in cui l'allarme ha iniziato a scattare.  | \$1\$1 .StartsAt \$1\$1 | 
|  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.  | \$1\$1 .EndsAt \$1\$1 | 
|  URL del generatore  |  stringa  |  Un link a Grafana o Alertmanager esterno.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  URL silenzioso  |  stringa  |  Un link per silenziare l'avviso (con le etichette precompilate per questo avviso). Solo per gli avvisi gestiti da Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  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.  | \$1\$1 .DashboardURL \$1\$1 | 
|  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.  | \$1\$1 .PanelURL \$1\$1 | 
|  Impronta digitale  |  stringa  |  Impronta digitale che può essere utilizzata per identificare l'avviso.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  stringa  |  Una stringa che contiene le etichette e il valore di ogni espressione ridotta nell'avviso.  | \$1\$1 .ValueString \$1\$1 | 

 **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` se viene attivato almeno un avviso, altrimenti`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 di nomi  | `{{ .Names }}` | 
|  Valori  |    |  [] stringa  |  Elenco di valori  | `{{ .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).

# Gestisci i punti di contatto
<a name="v10-alerting-manage-contactpoints"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 a elenco dei **punti di contatto** elenca tutti i punti di contatto e i modelli di notifica esistenti.

Nella scheda **Punti di contatto**, puoi:
+ Cerca nomi e tipi di punti di contatto e integrazioni.
+ Visualizza tutti i punti di contatto e le integrazioni esistenti.
+ Visualizza per quante politiche di notifica viene utilizzato ciascun punto di contatto e accedi direttamente alle politiche di notifica collegate.
+ Visualizza lo stato delle consegne delle notifiche.
+ Esporta i singoli punti di contatto o tutti i punti di contatto in formato JSON, YAML o Terraform.
+ Elimina i punti di contatto che non sono utilizzati da una politica di notifica.

Nella scheda **Modelli di notifica**, puoi:
+ Visualizzare, modificare, copiare o eliminare i modelli di notifica esistenti.

# Silenziamento delle notifiche di avviso
<a name="v10-alerting-silences"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 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.

**Nota**  
Per sopprimere le notifiche di avviso a intervalli di tempo regolari, ad esempio durante i normali periodi di manutenzione, utilizzate [Tempi di silenziamento](v10-alerting-manage-muting.md) anziché i silenzi.

**Per aggiungere un silenzio**

1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. **Scegli Silenzi.**

1. **Scegli un Alertmanager dal menu a discesa Alertmanager.**

1. **Scegli Crea 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.

1. 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 **Etichetta** e **Valore**, inserisci una o più *etichette corrispondenti*. Gli abbinatori determinano a quali regole si applica il silenzio. Tutti gli avvisi corrispondenti (in stato di attivazione) verranno visualizzati nel campo Istanze di **avvisi interessati**.

1. **Facoltativamente, aggiungi un commento che descriva il silenzio.**

1. Seleziona **Invia**.

**Per modificare un silenzio**

1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. Scegli **Silenze** per visualizzare l'elenco dei silenzi esistenti.

1. Trova il silenzio che desideri modificare, quindi scegli **Modifica** (icona a forma di penna).

1. Apporta le modifiche desiderate, quindi scegli **Invia** per salvare le modifiche.

Puoi modificare un silenzio esistente scegliendo l'icona **Modifica** (penna).

**Per creare un collegamento URL a un modulo di silenzio**

Quando ti colleghi a un modulo di silenzio, fornisci le etichette corrispondenti predefinite e commenta i parametri tramite `matcher` e `comment` query. Il `matcher` parametro deve avere il seguente formato, in `[label][operator][value]` cui il `operator` parametro può essere uno dei seguenti: `=` (equals, not regex), (not equals, not regex), `!=` (equals, regex), (not equals, regex), `=~` (not equals, regex). `!~` L'URL può contenere molti `matcher` parametri di query con la chiave. Ad esempio, per creare un collegamento a un modulo silenzioso con etichette `severity=critical` & `cluster!~europe-.*` e commenti corrispondenti`Silence critical EU alerts`, crea un URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Per creare un collegamento a una nuova pagina di silenzio per un Alertmanager esterno, aggiungi un `alertmanager` parametro di query

**Per rimuovere un silenzio**

1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. Scegli **Silenze** 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.

# Visualizza e filtra le regole di avviso
<a name="v10-alerting-manage-rules-viewfilter"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. Qui sono elencate anche le regole di avviso 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à.

## Visualizza le regole di avviso
<a name="v10-alerting-manage-rules-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 **Avvisi, Regole di avviso**.** Per impostazione predefinita, viene visualizzata la visualizzazione a elenco.

1. In **Visualizza come**, puoi passare dalla visualizzazione Raggruppata a quella Elenco e quella a Stato scegliendo l'opzione che preferisci.

1. Espandi la riga delle regole per visualizzare le etichette delle regole, le annotazioni, le fonti di dati, le domande sulle regole e un elenco di istanze di avviso risultanti dalla regola.

Da questa pagina, puoi anche creare copie di una regola di avviso per aiutarti a riutilizzare le regole esistenti.

## Esporta le regole di avviso
<a name="v10-alerting-manage-rules-export"></a>

Puoi esportare le regole in YAML o JSON nell'area di lavoro Grafana.
+ Scegli l'icona **Esporta gruppo di regole** accanto a ciascun gruppo di regole di avviso da esportare in YAML, JSON o Terraform.
+ Scegli **Esporta regole** per esportare tutte le regole di avviso gestite da Grafana in YAML, JSON o Terraform.
+ Scegli **Altro**, **Modifica esportazione** accanto a ogni singola regola di avviso all'interno di un gruppo per modificare le regole di avviso predisposte ed esportare una versione modificata.

## Visualizza le definizioni delle interrogazioni per gli avvisi predisposti
<a name="v10-alerting-manage-rules-querydef"></a>

Visualizza le definizioni delle query di sola lettura per gli avvisi predisposti. Verifica rapidamente se le tue query sulle regole di avviso sono corrette, senza dover accedere al tuo repository «as-code» per le definizioni delle regole.

**Visualizzazione raggruppata**

La visualizzazione raggruppata 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.

## Regole di filtraggio degli avvisi
<a name="v10-alerting-manage-rules-filter"></a>

È possibile filtrare le regole di avviso visualizzate nella pagina **Avvisi in diversi** modi.

**Per filtrare le regole di avviso**

1. Da **Seleziona fonti di dati**, seleziona una fonte di dati. Puoi visualizzare le regole di avviso che interrogano l'origine dati selezionata.

1. In **Cerca per etichetta**, inserisci i criteri di ricerca utilizzando i selettori di etichette. Ad esempio, `environment=production;region=~US|EU,severity!=warning`.

1. Da **Filtra gli avvisi per stato**, seleziona lo stato di avviso che desideri visualizzare. Puoi visualizzare le regole di avviso che corrispondono a quello stato. Le regole che corrispondono ad altri stati sono nascoste.

# Tempi di silenziamento
<a name="v10-alerting-manage-muting"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 vs silenzi
<a name="v10-alerting-manage-muting-compare"></a>

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

## Aggiunge una tempistica di silenziamento
<a name="v10-alerting-manage-muting-add"></a>

Puoi creare tempi di silenziamento nell'area di lavoro Grafana.

**Per aggiungere una tempistica di silenziamento**

1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. **Scegli **Politiche di notifica**, quindi seleziona la scheda Tempi di disattivazione dell'audio.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. Scegli il pulsante **\$1** Aggiungi temporizzazione del silenziamento.

1. Compila il modulo per creare un [intervallo di tempo in base al quale](#v10-alerting-manage-muting-interval) confrontare i tempi di silenziamento.

1. Salva i tempi di silenziamento.

## Aggiungere una tempistica di silenziamento a una politica di notifica
<a name="v10-alerting-manage-muting-add-notif"></a>

Una volta stabilita una tempistica di silenziamento, è possibile utilizzarla aggiungendola alla politica di notifica che si desidera disattivare a intervalli regolari.

**Per aggiungere una tempistica di silenziamento a una politica di notifica**

1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. Scegli **Criteri di notifica, quindi seleziona la scheda Politiche** di **notifica**.

1. **Seleziona la politica di notifica a cui desideri aggiungere la tempistica di silenziamento e scegli...** **, Modifica.**

1. Dal menu a discesa **Tempi di silenziamento**, seleziona gli orari di silenziamento che desideri aggiungere alla politica.

1. Salvare le modifiche.

## Intervalli di tempo
<a name="v10-alerting-manage-muting-interval"></a>

Un intervallo di tempo è una durata specifica durante la quale gli avvisi vengono soppressi. La durata è in genere costituita da un intervallo di tempo specifico e dai giorni della settimana, del mese o dell'anno. 

Le opzioni relative all'intervallo di tempo di Support sono:
+ **Intervallo** di tempo: l'orario comprensivo dell'ora di inizio e al netto dell'ora di fine (in UTC), se non è stata selezionata alcuna località, altrimenti l'ora locale.
+ **Posizione**: imposta la posizione per l'ora: l'intervallo di tempo viene visualizzato nell'ora locale della località.
+ **Giorni della settimana**: il giorno o l'intervallo di giorni della settimana. Ad esempio, `monday:thursday`.
+ **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.
+ **Mesi**: i mesi dell'anno in formato numerico o nel nome completo del mese di calendario. Ad esempio, `1, may:august`.
+ **Anni**: l'anno o gli anni dell'intervallo. Ad esempio, `2023:2024`.

Ciascuno di questi elementi può essere un elenco e almeno un elemento nell'elemento deve essere soddisfatto per avere una corrispondenza. I campi supportano anche gli intervalli, utilizzando`:`. Ad esempio, `monday:thursday`.

Se un campo viene lasciato vuoto, qualsiasi momento corrisponderà al campo. Affinché un istante o corrisponda a un intervallo di tempo completo, tutti i campi devono corrispondere. Una temporizzazione di silenziamento può contenere più intervalli di tempo.

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 lo stato e lo stato delle regole di avviso
<a name="v10-alerting-manage-rulestate"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 forniscono diversi indicatori chiave di stato relativi agli avvisi.

Esistono tre componenti:
+ [Stato della regola di avviso](#v10-alerting-manage-rulestate-state)
+ [Stato dell'istanza di avviso](#v10-alerting-manage-rulestate-instance)
+ [Stato della regola di avviso](#v10-alerting-manage-rulestate-health)

Sebbene correlati, ogni componente trasmette informazioni leggermente diverse.

**Per visualizzare lo stato e l'integrità delle regole di avviso**

1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. Scegli **Regole di avviso** per visualizzare l'elenco degli avvisi esistenti.

1. Scegli una regola di avviso per visualizzarne lo stato e lo stato di salute.

## Stato della regola di avviso
<a name="v10-alerting-manage-rulestate-state"></a>

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 passano prima a `pending` e poi`firing`, quindi occorrono almeno due cicli di valutazione prima che venga attivato un avviso.

## Stato dell'istanza di avviso
<a name="v10-alerting-manage-rulestate-instance"></a>

Un'istanza di avviso può trovarsi in uno dei seguenti stati:


| Stato | Description | 
| --- | --- | 
| Normale | Lo stato di un avviso che non è né pending néfiring. Tutto funziona come previsto. | 
| 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. | 
| Nessun dato | Non sono stati ricevuti dati per la finestra temporale configurata. | 
| Avviso | Si è verificato un errore durante il tentativo di valutare una regola di avviso. | 

## Mantieni l'ultimo stato
<a name="v10-alerting-manage-rulestate-keepstate"></a>

È possibile configurare una regola di avviso per mantenere l'ultimo stato quando viene rilevato `Error` uno stato `NoData` or. In questo modo si eviterà che gli avvisi vengano attivati e che si risolvano e si riattivino. Proprio come la normale valutazione, la regola di avviso passerà da una `pending` a una `firing` volta trascorso il periodo di attesa.

## Stato della regola di avviso
<a name="v10-alerting-manage-rulestate-health"></a>

Una regola di avviso può avere uno dei seguenti stati di integrità.


| Stato | Description | 
| --- | --- | 
| Ok | Nessun errore nella valutazione della regola di avviso. | 
| Errore | Si è verificato un errore durante la valutazione della regola di avviso. | 
| NoData | L'assenza di dati in almeno una serie temporale restituita durante la valutazione di una regola. | 
| \$1stato\$1, KeepLast | La regola avrebbe ricevuto un altro stato, ma è stata configurata per mantenere l'ultimo stato della regola di avviso. | 

## Avvisi speciali per un NoData errore
<a name="v10-alerting-manage-rulestate-special"></a>

Quando la valutazione di una regola di avviso produce lo stato `NoData` o`Error`, l'avviso Grafana genererà istanze di avviso con le seguenti etichette aggiuntive.


| Etichetta | Description | 
| --- | --- | 
| nome dell'avviso | Uno DatasourceNoData o l'altroDatasourceError, a seconda dello stato. | 
| datasource\$1uid | L'UID della fonte di dati che ha causato lo stato. | 

**Nota**  
Per generare le etichette aggiuntive è necessario impostare la gestione di assenza di dati `NoData` o `Error` errori su o nella regola di avviso, come descritto nell'[Configura le regole di avviso gestite da Grafana](v10-alerting-configure-grafanamanaged.md)argomento.

È possibile gestire questi avvisi allo stesso modo degli avvisi normali, ad esempio aggiungendo silenzi, indirizzando verso un punto di contatto e così via.

# Visualizza e filtra per gruppi di avvisi
<a name="v10-alerting-manage-viewfiltergroups"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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 predefinita 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. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.**

1. Scegli **Gruppi per visualizzare i gruppi** esistenti.

1. Dal menu a discesa **Alertmanager**, seleziona un Alertmanager esterno come fonte di dati.

1. Dal menu a discesa **Raggruppa per personalizzato**, 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`

È possibile filtrare gli avvisi per etichetta o stato degli avvisi.

**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="v10-alerting-manage-viewnotificationerrors"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.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. Dal menu a sinistra, scegli **Avvisi, quindi** **Punti di contatto**.

   Se qualche punto di contatto non funziona, un messaggio nell'angolo destro dell'area di lavoro indica che ci sono errori e quanti sono.

1. Seleziona 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.