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 in Grafana versione 8
<a name="using-grafana-v8"></a>

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

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 8 di Grafana.

**Topics**
+ [Riquadri](Grafana-panels.md)
+ [Pannelli di controllo](dashboard-overview.md)
+ [Esplora](explore.md)
+ [Collegamento](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [Modelli e variabili](templates-and-variables.md)
+ [Avvisi Grafana](alerts-overview.md)

# Riquadri
<a name="Grafana-panels"></a>

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

Il pannello è l'elemento costitutivo di visualizzazione di base in un server Grafana. Un pannello è una rappresentazione visiva di una o più interrogazioni ad eccezione di alcuni pannelli per usi speciali. Le interrogazioni visualizzano i dati nel tempo. Ciò può variare dalle fluttuazioni di temperatura allo stato attuale del server a un elenco di registri o avvisi.

Ogni pannello dispone di un editor di query specifico per la fonte di dati selezionata nel pannello. L'editor di query consente di estrarre una visualizzazione da visualizzare sul pannello.



Per visualizzare i dati, è necessario aggiungere almeno una fonte di dati all'area di lavoro. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md).

È disponibile un'ampia varietà di opzioni di stile e formattazione per ogni pannello. I pannelli possono essere trascinati, riorganizzati e ridimensionati.

**Topics**
+ [Aggiungere un pannello](add-a-panel-to-a-dashboard.md)
+ [Eliminazione di un pannello](Deleting-a-panel.md)
+ [Query](panel-queries.md)
+ [Interrogazioni registrate](recorded-queries.md)
+ [Trasformazioni](panel-transformations.md)
+ [Opzioni e sostituzioni dei campi](field-options-overrides.md)
+ [Editor di pannelli](AMG-panel-editor.md)
+ [Pannelli della biblioteca](AMG-library-panel.md)
+ [Visualizzazioni](AMG-visualizations.md)

# Aggiungere un pannello
<a name="add-a-panel-to-a-dashboard"></a>

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

 Puoi usare i pannelli per mostrare i tuoi dati in forma visiva. Questo argomento illustra i passaggi di base per creare un pannello. 

**Per aggiungere un pannello a una dashboard**

1.  Scegli la dashboard a cui desideri aggiungere un pannello. 

1.  Scegli l'icona **Aggiungi pannello**. 

1.  Scegli **Aggiungi nuovo pannello**. 

    L'area di lavoro Grafana crea un pannello grafico vuoto con l'origine dati predefinita selezionata. 

1.  Sebbene non sia obbligatorio, ti consigliamo di aggiungere un titolo e una descrizione utili al pannello. Facoltativamente, puoi usare le variabili che hai definito in entrambi i campi, ma non le variabili globali. Per ulteriori informazioni, consulta [Modelli e variabili](templates-and-variables.md).
   + **Titolo del pannello**: il testo inserito in questo campo viene visualizzato nella parte superiore del pannello nell'editor del pannello e nella dashboard.
   + **Descrizione**: il testo inserito in questo campo viene visualizzato in un tooltip nell'angolo superiore sinistro del pannello. Scrivi una descrizione del pannello e dei dati che stai visualizzando.

1. Scrivi una richiesta per il pannello. Per visualizzare una visualizzazione, ogni pannello necessita di almeno una query. Le interrogazioni vengono scritte nella scheda **Query** dell'editor del pannello. Per ulteriori informazioni, consulta [Query](panel-queries.md).

   1. Scegliete una fonte di dati. Nella prima riga della scheda **Query**, scegli l'elenco a discesa per visualizzare tutte le fonti di dati disponibili. Questo elenco include tutte le fonti di dati che hai aggiunto. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md). 

   1. Scrivi o costruisci una query nel linguaggio di query della tua fonte di dati. Le opzioni possono variare. Consulta la documentazione specifica sulla fonte di dati per linee guida specifiche. 

1.  Nella sezione **Visualizzazione** della scheda **Pannello**, scegli un tipo di visualizzazione. L'area di lavoro Grafana mostra un'anteprima dei risultati della query con quella visualizzazione applicata. 

1. **Ti consigliamo di aggiungere una nota per descrivere le modifiche prima di scegliere Salva.** Le note sono utili se devi ripristinare la dashboard a una versione precedente. 

1.  Per salvare la dashboard, scegli **Salva** nell'angolo in alto a destra dello schermo. 

# Eliminazione di un pannello
<a name="Deleting-a-panel"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.md)  
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 eliminare un pannello in Grafana, completa i seguenti passaggi:
+  **Scegli il menu a discesa accanto al titolo del pannello e seleziona Rimuovi pannello.** 

or
+ Passa il puntatore sul pannello e usa la sequenza di scelte rapide da tastiera «p r».

# Query
<a name="panel-queries"></a>

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

 I pannelli dell'area di lavoro Grafana utilizzano *le interrogazioni* per comunicare con le fonti di dati e ottenere dati per la visualizzazione. Una query è una domanda scritta nel linguaggio di interrogazione utilizzato dalla fonte di dati. Se la query è formata correttamente, la fonte di dati risponde. Nelle opzioni dell'origine dati del pannello, puoi regolare la frequenza con cui la query viene inviata alla fonte dati e il numero di punti dati raccolti. 

 Le aree di lavoro Grafana supportano fino a 26 interrogazioni per pannello. 

## Editor di query
<a name="query-editors"></a>

 Gli editor di query sono moduli che consentono di scrivere domande. A seconda della fonte di dati, l'editor di query potrebbe fornire il completamento automatico, i nomi delle metriche o il suggerimento di variabili. 

 A causa delle differenze tra i linguaggi di query, le fonti di dati potrebbero disporre di editor di query dall'aspetto diverso.

## Sintassi delle query
<a name="query-syntax"></a>

 Le fonti di dati hanno linguaggi e sintassi di query diversi per richiedere i dati. Ecco due esempi di interrogazioni.

 **PostgreSQL** 

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

 **ProMQL** 

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

 Per ulteriori informazioni sulla scrittura di una query per la tua fonte di dati, consulta la documentazione relativa a tale fonte di dati. Le fonti di dati sono elencate in[Connessione alle origini dati](AMG-data-sources.md).

## Interfaccia utente della scheda Query
<a name="query-tab-ui"></a>

 La scheda **Query** è composta dai seguenti elementi: 
+  Selettore della fonte di dati 
+  Opzioni di interrogazione 
+  Pulsante Query Inspector 
+  Elenco dell'editor di query 

### Selettore della fonte di dati
<a name="data-source-selector"></a>

 Il selettore dell'origine dati è un elenco a discesa. Sceglilo per selezionare una fonte di dati che hai aggiunto. Quando crei un pannello, Amazon Managed Grafana seleziona automaticamente la tua fonte di dati predefinita. Per ulteriori informazioni sulle fonti di dati, consulta. [Connessione alle origini dati](AMG-data-sources.md) 

 Oltre alle fonti di dati che hai configurato nell'area di lavoro Grafana, sono disponibili tre fonti di dati speciali. 
+ **TestDataDB**: una fonte di dati integrata che genera dati casuali sulle camminate. L'origine dati Grafana è utile per testare visualizzazioni ed eseguire esperimenti.
+  **Mista**: una fonte di dati per interrogare più fonti di dati nello stesso pannello. Quando questa origine dati è selezionata, puoi selezionare una fonte di dati per ogni nuova query che aggiungi.
  +  La prima interrogazione utilizzerà l'origine dati selezionata prima di selezionare **Mista**. 
  +  Non è possibile modificare un'interrogazione esistente per utilizzare l'origine dati mista. 
+ **Dashboard**: una fonte di dati per l'utilizzo di un set di risultati da un altro pannello nella stessa dashboard. 

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

 Per visualizzare le impostazioni per l'origine dati selezionata, scegli **Opzioni di interrogazione** accanto al selettore dell'origine dati. Le modifiche che apporti qui influiscono solo sulle interrogazioni eseguite in questo pannello. 

 Amazon Managed Grafana imposta le impostazioni predefinite che vengono visualizzate in testo grigio scuro. Le modifiche vengono visualizzate in testo bianco. Per riportare un campo all'impostazione predefinita, elimina il testo bianco dal campo. 

 È possibile utilizzare le seguenti opzioni di interrogazione delle fonti di dati del pannello: 
+  **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 li consolida (riduce il numero di punti restituiti aggregandoli per media, max o altra funzione). 

   Esistono due ragioni principali per limitare il numero di punti: prestazioni e livellamento della linea. Il valore predefinito è la larghezza (o il numero di pixel) del grafico, che evita di avere più punti dati di quanti ne possa visualizzare il pannello grafico. 

   Con i dati in streaming, il valore massimo dei punti dati viene utilizzato per il rolling buffer. (Lo streaming è un flusso continuo di dati e il buffering è un modo per dividere il flusso in blocchi). 
+  **Intervallo minimo**: imposta un limite minimo per l'intervallo calcolato automaticamente, in genere l'intervallo minimo di scrape. Se un punto dati viene salvato ogni 15 secondi, non è necessario avere un intervallo inferiore a quello. Un altro caso d'uso consiste nell'impostarlo su un valore minimo superiore all'intervallo di scrape per ottenere query più dettagliate e ben funzionanti. 
+  Intervallo: un **intervallo** di tempo che puoi utilizzare per aggregare o raggruppare i punti dati in base al tempo. 

   Amazon Managed Grafana calcola automaticamente un intervallo appropriato che può essere utilizzato come variabile nelle query basate su modelli. La variabile è espressa in secondi:; o in millisecondi:`$__interval`. `$__interval_ms` Viene in genere utilizzato in funzioni di aggregazione come o. `sum` `average` 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. Se l'utente ingrandisce molto, l'intervallo aumenta con conseguente aggregazione più dettagliata. Se l'utente ingrandisce, l'intervallo diminuisce con conseguente aggregazione più dettagliata. 

   Per ulteriori informazioni, consulta [Variabili globali](variables-types.md#global-variables). 
+  **Tempo relativo**: sostituisce l'intervallo di tempo relativo per i singoli pannelli, rendendoli diversi da quello selezionato nel selettore temporale della dashboard nell'angolo in alto a destra della dashboard. Ciò consente di mostrare le metriche relative a periodi di tempo o giorni diversi sulla stessa dashboard. 
+  **Time shift**: fornisce un altro modo per ignorare l'intervallo di tempo per i singoli pannelli. Questa funzione funziona solo con intervalli di tempo relativi ed è possibile regolare l'intervallo di tempo. 

   Ad esempio, puoi spostare l'intervallo di tempo per il pannello in modo che sia 2 ore prima rispetto al selettore orario del pannello di controllo. Per ulteriori informazioni, consulta [Controlli dell'intervallo di tempo](dashboard-time-range-controls.md). 
+  **Timeout della cache**: (questo campo è visibile solo se è disponibile nell'origine dati). Sostituisce il timeout predefinito della cache se l'archivio delle serie temporali dispone di una cache per le query. Viene specificato come valore numerico in secondi. 

### Pulsante Query Inspector
<a name="query-inspector-button"></a>

 Puoi scegliere **Query inspector** per aprire la scheda **Query** dell'ispettore del pannello. Nella scheda **Query**, puoi vedere la richiesta di interrogazione inviata dal pannello e la risposta. 

 Scegli **Aggiorna** per visualizzare il testo completo della richiesta inviata da questo pannello al server. 

**Nota**  
 È necessario aggiungere almeno una query prima che Query Inspector possa restituire risultati. 

 Per ulteriori informazioni sull'ispettore del pannello, vedere. [Ispeziona un pannello](inspect-a-panel.md) 

### Elenco dell'editor di query
<a name="query-editor-list"></a>

 Nell'interfaccia utente, le query sono organizzate in righe di query comprimibili. Ogni riga di query contiene un editor di query ed è identificata da una lettera (A, B, C e così via). 

## Condivisione dei risultati delle interrogazioni tra i pannelli
<a name="share-query-results-between-panels"></a>

 Con Amazon Managed Grafana, puoi 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 richieste 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, Amazon Managed Grafana invia una query e gli altri pannelli utilizzano i risultati della query per creare visualizzazioni. 

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

**Per condividere le interrogazioni relative alle fonti di dati con un altro pannello**

1.  Crea una dashboard. Per ulteriori informazioni, consulta [Creazione di un pannello di controllo](getting-started-grafanaui.md#create-a-dashboard). 

1.  Aggiungi un pannello. Per ulteriori informazioni, consulta [Aggiungere un pannello](add-a-panel-to-a-dashboard.md). 

1.  Cambia il titolo in**Source panel**. Utilizzerai questo pannello come fonte per gli altri pannelli. Definite la o le interrogazioni che verranno condivise. Se al momento non disponi di un'origine dati disponibile, puoi utilizzare l'origine dati **Grafana**, che restituisce una serie temporale casuale che puoi utilizzare per i test. 

1.  Aggiungi un secondo pannello, quindi seleziona l'origine dati del **pannello** di controllo 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. 

 Per accedere a un pannello in cui è definita un'interrogazione, scegliete quell'interrogazione. 

# Interrogazioni registrate
<a name="recorded-queries"></a>

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

Puoi vedere le tendenze nel tempo scattando un'istantanea di un punto dati su un intervallo prestabilito utilizzando le query registrate. Questo può darti un'idea delle tendenze storiche.

Per i plugin che non restituiscono serie temporali, potrebbe essere utile tracciare dati storici. Ad esempio, potresti voler eseguire una query **ServiceNow**per visualizzare una cronologia dei tempi di risposta alle richieste, ma puoi restituire solo le point-in-time metriche correnti.

## Come funzionano le interrogazioni registrate
<a name="how-recorded-queries-work"></a>

Le query registrate funzionano solo con i plugin di origine dati di backend. Per ulteriori informazioni, consulta il plugin [Backend](https://grafana.com/tutorials/build-a-data-source-backend-plugin/) Data Source. È possibile registrare tre tipi di interrogazioni:
+ riga e colonna singole: una query che restituisce una sola riga e colonna.
+ conteggio delle righe: una query che restituisce righe significative da contare.
+ espressione - Qualsiasi espressione. Per ulteriori informazioni sulla creazione e l'utilizzo di espressioni, consulta [Espressioni](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

Dopo aver creato o abilitato un'interrogazione registrata, crea immediatamente un'istantanea e continua a creare istantanee all'intervallo impostato. La query registrata interrompe l'acquisizione di istantanee quando è disabilitata, eliminata o quando Grafana non è in esecuzione. I punti dati vengono raccolti nel backend eseguendo la query registrata e inoltrando ogni risultato a un'istanza Prometheus abilitata alla scrittura remota.

**Nota**  
È necessario configurare un'origine dati Prometheus e associarla a una destinazione di scrittura remota prima di poter utilizzare le query registrate.

## Creare un'interrogazione registrata
<a name="create-a-recorded-query"></a>

Per creare un'interrogazione registrata, completare i seguenti passaggi:

1. Trova o crea un'interrogazione che desideri registrare su una dashboard in un pannello di modifica. La query deve restituire solo una riga e una colonna. Se ne restituisce di più, è comunque possibile registrare il numero di risultati restituiti utilizzando l'opzione *count*. L'origine dati della query deve essere una fonte di dati di backend. Le espressioni possono essere utilizzate per aggregare i dati di una query di serie temporali. Per ulteriori informazioni sulla creazione e l'utilizzo di espressioni, consulta [Espressioni](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

1. Scegliete il menu **Record Query** che si trova nell'editor delle interrogazioni.

1. Inserite le informazioni di interrogazione registrate. Tutti i campi sono obbligatori se non diversamente indicato. 
   + Nome: nome dell'interrogazione registrata.
   + Descrizione - (opzionale) Descrivi l'interrogazione registrata come desideri che appaia nell'elenco delle interrogazioni registrate.
   + Intervallo: l'intervallo in cui verrà scattata l'istantanea. L'intervallo inizia quando si crea l'interrogazione registrata e si interrompe se si mette in pausa o si elimina l'interrogazione registrata. [Per ulteriori informazioni sulla sospensione e l'eliminazione delle interrogazioni registrate, consulta Gestione delle interrogazioni registrate.](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries)
   + Intervallo: l'intervallo di tempo relativo dell'interrogazione. Se si seleziona un intervallo di 30 m e un intervallo di 1 ora, l'interrogazione scatterà un'istantanea ogni ora degli ultimi 30 minuti.
   + Conta i risultati della query: se desideri contare le righe restituite dalla query, attiva questa opzione. Se questa opzione è disattivata, la query deve restituire una riga con un valore.

1. Verifica la query registrata scegliendo il pulsante Test Recorded Query.

1. Scegli **Avvia la registrazione della query**.

## Aggiungere una query registrata
<a name="Adding-a-recorded-query"></a>

È possibile aggiungere interrogazioni registrate esistenti ai pannelli di una dashboard. Per ogni query registrata che aggiungi, viene creata una query Prometheus:. `generated_recorded_query_name{id="generated_id", name="recorded query name"}` La query creata da Prometheus restituisce tutte le istantanee raccolte dalla query registrata.

1. Accedi a un pannello in una dashboard in cui desideri aggiungere una query registrata.

1. Scegli il menu **\$1 Interrogazione registrata**.

1. Se desideri filtrare le query registrate per fonte di dati, seleziona una fonte di dati dal menu a discesa Filtra per fonte di dati.

1. Scegli il menu **Aggiungi** sulla query registrata per aggiungerla al pannello.

Dopo aver aggiunto la query registrata al pannello, la fonte di dati del pannello diventerà`-- Mixed --`. La query registrata è rappresentata da un'`Prometheus`interrogazione con un'etichetta che corrisponde al nome della query registrata. Fai riferimento a [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) per saperne di più sulla fonte di dati Prometheus.

Se dopo aver aggiunto una query registrata, viene visualizzata un'interrogazione con un'origine `-- Mixed --` dati anziché un'origine dati Prometheus, ciò potrebbe significare che non è stata impostata `Prometheus ` una destinazione di scrittura remota per le query registrate. Fate riferimento a [Target di scrittura remoto](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target) per configurare un punto di scrittura remoto.

## Utilizzo di un'interrogazione registrata
<a name="using-a-recorded-query"></a>

Per utilizzare un'interrogazione registrata, creane una e aggiungila a una dashboard. Dopodiché, può essere gestita in **Preferenze** dalla scheda **Interrogazioni registrate**.

## Gestione delle interrogazioni registrate
<a name="managing-recorded-queries"></a>

Le interrogazioni registrate possono essere messe in pausa o attivate ed eliminate dalla scheda Interrogazioni registrate in Preferenze. L'eliminazione di una query registrata la rimuoverà da Grafana, ma le informazioni raccolte in Prometheus rimarranno lì. Mettere in pausa una query registrata non raccoglierà più nuovi punti dati finché non verrà ripristinata.

## Obiettivo di scrittura remoto
<a name="remote_write_target"></a>

La destinazione di scrittura remota è l'origine dati **Prometheus** su cui vengono scritti i punti dati di interrogazione registrati. Avrai bisogno di un Prometheus con la scrittura remota abilitata e dovrai creare una fonte di dati per questo Prometheus.

****Per modificare la destinazione di scrittura remota, scegli **Modifica destinazione di scrittura remota** nel menu della console nella scheda Interrogazioni registrate in Preferenze.**** Seleziona l'origine dati **Prometheus** con la scrittura remota abilitata e inserisci il percorso di scrittura remota.

# Trasformazioni
<a name="panel-transformations"></a>

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

Le trasformazioni elaborano il set di risultati prima che venga passato alla visualizzazione. Puoi accedere alle trasformazioni nella scheda **Trasforma** dell'editor di pannelli Amazon Managed Grafana.

Puoi utilizzare le trasformazioni per rinominare i campi, unire serie temporali separate, eseguire calcoli matematici tra query e altro ancora. Se disponi di dashboard di grandi dimensioni o di query complesse, la possibilità di riutilizzare i risultati delle query da un pannello all'altro può offrire un enorme miglioramento delle prestazioni.

**Nota**  
Le trasformazioni a volte producono dati che non possono essere rappresentati graficamente. Quando ciò accade, Amazon Managed Grafana mostra un suggerimento sulla visualizzazione. Scegli il suggerimento per passare alla visualizzazione delle tabelle. Questo spesso ti aiuta a capire meglio cosa sta facendo la trasformazione ai tuoi dati. 

Amazon Managed Grafana applica le trasformazioni nella sequenza in cui sono elencate sullo schermo. Ogni trasformazione crea un nuovo set di risultati che viene passato alla trasformazione successiva nella pipeline. 

L'ordine può fare un'enorme differenza nell'aspetto dei risultati. Ad esempio, se si utilizza la riduzione della trasformazione per condensare tutti i risultati di una colonna in un unico valore, è possibile applicare le trasformazioni solo a quel singolo valore. 

**Prerequisiti**

Prima di applicare le trasformazioni, devono essere soddisfatte tutte le seguenti condizioni:
+ Hai inserito una query e restituito dati da una fonte di dati. [Per ulteriori informazioni sulle interrogazioni, vedere Interrogazioni.](panel-queries.md)
+ È stata applicata una visualizzazione che supporta le query, ad esempio una delle seguenti visualizzazioni:
  + Indicatore a barra
  + Gauge
  + Grafico
  + Mappa termica
  + Log
  + Stat
  + Tabella

## Applicare una trasformazione
<a name="apply-a-transformation"></a>

 Le trasformazioni sono disponibili nella scheda **Trasforma** nel riquadro inferiore dell'editor del pannello, accanto alla scheda **Interrogazioni**. 

**Per applicare una trasformazione**

1.  Nel pannello a cui desiderate aggiungere le trasformazioni, scegliete il titolo del pannello, quindi scegliete **Modifica**. 

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

1.  Selezionate una trasformazione. 

    Nella riga di trasformazione che appare, puoi configurare le opzioni di trasformazione. 

1.  Per applicare un'altra trasformazione, scegli **Aggiungi trasformazione**. Tieni presente che la trasformazione successiva agisce sul set di risultati restituito dalla trasformazione precedente. 

 In caso di problemi, scegliete l'icona del bug per eseguire [il debug delle trasformazioni](#debug-transformations). 

 Per rimuovere una trasformazione, scegli l'icona del cestino. 

## Tipi e opzioni di trasformazione
<a name="transformation-types-and-options"></a>

 Le aree di lavoro Grafana includono le seguenti trasformazioni. 

**Topics**
+ [Ridurre](#reduce)
+ [Unione](#merge)
+ [Filtra per nome](#filter-by-name)
+ [Filtra i dati per query](#filter-data-by-query)
+ [Organizza i campi](#organize-fields)
+ [Unisci per campo (outer join)](#join-by-field-outer-join)
+ [Aggiungi campo dal calcolo](#add-field-from-calculation)
+ [Etichette per i campi](#labels-to-fields)
+ [Raggruppa per](#sort-by)
+ [Raggruppa per](#group-by)
+ [Da serie a righe](#series-to-rows)
+ [Filtra i dati per valore](#filter-data-by-value)
+ [Trasformazioni di debug](#debug-transformations)

### Ridurre
<a name="reduce"></a>

 Applica una trasformazione **Reduce** quando desideri semplificare i risultati fino a ridurli a un unico valore. Reduce rimuove fondamentalmente la componente temporale. Se visualizzato come tabella, riduce una colonna a una riga (valore). 

 Nel campo **Calcoli**, inserisci uno o più tipi di calcolo. Scegli di visualizzare un elenco di scelte di calcolo. Per informazioni sui calcoli disponibili, vedere[Elenco dei calcoli](list-of-calculations.md).

Dopo aver selezionato almeno un calcolo, Amazon Managed Grafana visualizza un valore utilizzando il calcolo selezionato. Se selezioni più di un calcolo, viene visualizzato più di un valore. 

### Unione
<a name="merge"></a>

 Utilizzate questa trasformazione per combinare i risultati di più interrogazioni in un unico risultato. Ciò è utile quando si utilizza la visualizzazione del pannello tabellare. I valori che possono essere uniti vengono combinati nella stessa riga. I valori possono essere uniti se i campi condivisi contengono gli stessi dati. 

 Nell'esempio seguente, due query restituiscono i dati della tabella. I dati vengono visualizzati come due tabelle separate prima di applicare la trasformazione. 

Interrogazione A


|  Orario  |  Processo  |  Operatività  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nodo  |  25260122  | 
|  2020-07-07 11:24:20  |  locandina  |  123001233  | 

Interrogazione B


|  Orario  |  Processo  |  Errori  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nodo  |  15  | 
|  2020-07-07 11:24:20  |  locandina  |  5  | 

 Ecco il risultato dopo aver applicato la trasformazione **Merge**. 


|  Orario  |  Processo  |  Errori  |  Uptime  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  nodo  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  locandina  |  5  |  123001233  | 

### Filtra per nome
<a name="filter-by-name"></a>

 Utilizzate questa trasformazione per rimuovere parti dei risultati della query. 

 Amazon Managed Grafana visualizza il campo **Identifier**, seguito dai campi restituiti dalla tua query. 

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

### Filtra i dati per query
<a name="filter-data-by-query"></a>

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

 Amazon Managed Grafana visualizza le lettere identificative della query in testo grigio scuro. Per attivare il filtro, scegli un identificatore di query. Se la lettera di interrogazione è bianca, vengono visualizzati i risultati. Se la lettera di interrogazione è scura, i risultati sono nascosti. 

### Organizza i campi
<a name="organize-fields"></a>

 Utilizzate questa trasformazione per rinominare, riordinare o nascondere i campi restituiti dalla query. 

**Nota**  
 Questa trasformazione funziona solo nei pannelli che hanno una sola interrogazione. Se il pannello ha più interrogazioni, è necessario applicare una trasformazione **Join by field (outer join)** o rimuovere le interrogazioni aggiuntive. 

 Amazon Managed Grafana visualizza un elenco di campi restituiti dalla query. Puoi apportare una delle seguenti modifiche: 
+  Modifica l'ordine dei campi facendo una pausa su un campo. Il cursore si trasforma in una mano, quindi puoi trascinare il campo nella nuova posizione. 
+  Nascondi o mostra un campo scegliendo l'icona a forma di occhio accanto al nome del campo. 
+  Rinomina i campi digitando un nuovo nome nella casella **Rinomina**. 

### Unisci per campo (outer join)
<a name="join-by-field-outer-join"></a>

 Usa questa trasformazione per unire più serie temporali a partire da un risultato impostato per campo. 

 Questa trasformazione è utile se desideri combinare le interrogazioni in modo da poter calcolare i risultati dei campi. 

### Aggiungi campo dal calcolo
<a name="add-field-from-calculation"></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 ogni riga di campi selezionati in modo indipendente. 
  +  **Opzione binaria**: applica un'operazione matematica di base (`sum``multiply`, e così via) sui valori in una singola riga da due campi selezionati. 
+  **Nome campo**: seleziona i nomi dei campi che desideri utilizzare nel calcolo per il nuovo campo. 
+  **Calcolo:** seleziona un calcolo da utilizzare quando Amazon Managed Grafana crea il nuovo campo. Scegli il campo per visualizzare un elenco di opzioni di calcolo. Per informazioni sui calcoli disponibili, vedere[Elenco dei calcoli](list-of-calculations.md). 
+  **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) Utilizza questa opzione se desideri nascondere tutti gli altri campi e visualizzare solo il campo calcolato nella visualizzazione. 

### Etichette per i campi
<a name="labels-to-fields"></a>

**Nota**  
 Per applicare questa trasformazione, la tua query deve restituire campi etichettati. 

 Quando selezioni questa trasformazione, Amazon Managed Grafana trasforma automaticamente tutti i dati etichettati in campi. 

 Ad esempio, considera il risultato di una query di due serie temporali. 

 1: etichette Server=Server A, Datacenter=EU 2: etichette Server=Server B, datacenter=EU 

 Questa trasformazione risulterebbe nella tabella seguente. 


|  Orario  |  Server  |  Datacenter  |  Valore  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  Server A  |  UE  |  1  | 
|  2020-07-07 11:34:20  |  Server B  |  UE  |  2  | 

 **Nome del campo Valore**; Se hai selezionato `Server` come **nome del campo Valore**, otterrai un campo per ogni valore dell'`Server`etichetta. 


|  Orario  |  Datacenter  |  Server A  |  Server B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  UE  |  1  |  2  | 

### Raggruppa per
<a name="sort-by"></a>

Questa trasformazione ordina ogni frame in base al campo configurato. Quando `reverse` è selezionata, i valori vengono restituiti nell'ordine inverso.

### Raggruppa per
<a name="group-by"></a>

 Questa trasformazione raggruppa i dati in base a un valore di campo (colonna) specificato ed elabora i calcoli su ciascun gruppo. I calcoli disponibili sono gli stessi della trasformazione Reduce. 

 Ecco un esempio di dati originali. 


|  Orario  |  ID del server  |  Temperatura della CPU  |  Stato del server  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  Arresto  | 
|  2020-07-07 11:34:20  |  server 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  server 2  |  90  |  Sovraccarico  | 
|  2020-07-07 10:31:22  |  server 3  |  55  |  OK  | 
|  2020-07-07 09:30:57  |  server 3  |  62  |  Reebooting (Riavvio in corso)  | 
|  2020-07-07 09:30:05  |  server 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  server 2  |  88  |  OK  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  OK  | 

 Questa trasformazione avviene in due fasi. Innanzitutto, specifichi 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 **raggruppi per** `Server ID` campo, i dati verranno raggruppati in questo modo: 


|  Orario  |  ID del server  |  Temperatura della CPU  |  Stato del server  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  server 1  |  80  |  Arresto  | 
|  2020-07-07 09:28:06  |  server 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  server 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

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 il calcolo verrà applicato a ciascun gruppo di righe. Ad esempio, potresti voler calcolare la media `CPU temperature` per ciascuno di questi server. Puoi aggiungere il calcolo della *media* applicato al `CPU Temperature` campo per ottenere quanto segue.


|  ID del server  |  Temperatura della CPU (media)  | 
| --- | --- | 
|  server 1  |  82  | 
|  server 2  |  8.6  | 
|  server 3  |  59,6  | 

E puoi aggiungere più di uno di questi calcoli. Ad esempio, puoi utilizzare i seguenti calcoli. 
+  Per il campo`Time`, puoi calcolare l'*ultimo* valore, per sapere quando è stato ricevuto l'ultimo punto dati per ogni server. 
+  Per il campo`Server Status`, puoi calcolare l'*ultimo* valore per conoscere l'ultimo valore di stato per ogni server. 
+  Per il campo`Temperature`, puoi anche calcolare l'*ultimo* valore per conoscere l'ultima temperatura monitorata per ogni server. 

 La trasformazione Group By produce i seguenti risultati. 


|  ID del server  |  Temperatura della CPU (media)  |  Temperatura della CPU (ultima)  |  Ora (ultima)  |  Stato del server (ultimo)  | 
| --- | --- | --- | --- | --- | 
|  server 1  |  82  |  80  |  2020-07-07 11:34:20  |  Arresto  | 
|  server 2  |  8.6  |  90  |  2020-07-07 10:32:20  |  Sovraccarico  | 
|  server 3  |  59,6  |  62  |  2020-07-07 11:34:20  |  OK  | 

Usando questa trasformazione, puoi estrarre alcune informazioni chiave dalle tue serie temporali e visualizzarle in modo conveniente. 

### Da serie a righe
<a name="series-to-rows"></a>

Usa questa trasformazione per combinare i risultati 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 `Metric` colonna viene aggiunta in modo da poter vedere da quale query proviene la metrica. Personalizza questo valore definendolo nella `Label` query di origine. 

Nell'esempio seguente, due query restituiscono dati di serie temporali. Viene visualizzato come due tabelle separate prima dell'applicazione della 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  | 

 L'applicazione della trasformazione produce i seguenti risultati. `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  | 

### Filtra i dati per valore
<a name="filter-data-by-value"></a>

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

Questa trasformazione è utile se l'origine dati non filtra nativamente in base ai valori. È inoltre possibile utilizzarla per restringere i valori da visualizzare se si utilizza una query condivisa.

 Le condizioni disponibili per tutti i campi sono le seguenti:
+  **Regex**: corrisponde a un'espressione regex. 
+  **Is Null**: corrisponde se il valore è nullo.
+  **Is Not Null**: corrisponde se il valore non è nullo.
+  **Uguale**: corrisponde se il valore è uguale al valore specificato. 
+  **Diverso**: corrisponde se il valore è diverso dal valore specificato. 

Le condizioni disponibili per i campi numerici sono le seguenti:
+  **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 al valore specificato. 
+  **Minore o uguale**: corrisponde se il valore è inferiore o uguale al valore specificato. 
+  **Intervallo**: corrisponde a un intervallo compreso tra un minimo e un massimo specificati. Il minimo e il massimo sono inclusi nell'intervallo.

È possibile aggiungere più di una condizione al filtro. Quando hai più di una condizione, puoi scegliere se desideri che l'azione di inclusione o esclusione venga applicata alle righe che soddisfano tutte o alcune delle condizioni che hai aggiunto.

Le condizioni non valide o configurate in modo incompleto vengono ignorate.

### Trasformazioni di debug
<a name="debug-transformations"></a>

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

 Amazon Managed Grafana mostra la vista di debug della trasformazione sotto la riga di trasformazione. 

# Opzioni e sostituzioni dei campi
<a name="field-options-overrides"></a>

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

 Questa sezione spiega cosa sono le opzioni di campo e le sostituzioni dei campi in Amazon Managed Grafana e come utilizzarle. 

 Il modello di dati utilizzato negli spazi di lavoro di Grafana, il data frame, è 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 Amazon Managed Grafana visualizza i dati. 

## Opzioni di campo
<a name="field-options-overview"></a>

 *Le opzioni di campo*, sia standard che personalizzate, sono disponibili nella scheda **Campo** dell'editor del pannello. Le modifiche apportate in questa scheda si applicano a tutti i campi (ovvero serie e colonne). Ad esempio, se si modifica l'unità in percentuale, tutti i campi con valori numerici vengono visualizzati in percentuale. Scopri come applicare un'opzione di campo in. [Configura tutti i campi](#configure-all-fields) 

## Sostituzioni dei campi
<a name="field-overrides-overview"></a>

 Le *sostituzioni dei campi* possono essere aggiunte nella scheda Sostituzioni dell'**editor del pannello**. Qui puoi aggiungere le stesse opzioni che trovi nella scheda **Campo**, ma vengono applicate solo a campi specifici. Scopri come applicare un override in[Configura campi specifici](#configure-specific-fields).

## Opzioni di campo e sostituzioni disponibili
<a name="available-field-options-and-overrides"></a>

 I tipi di opzioni di campo sono comuni sia alle opzioni di campo che alle sostituzioni dei campi. L'unica differenza è se la modifica verrà applicata a tutti i campi (applicata nella scheda **Campo**) o a un sottoinsieme di campi (applicata nella scheda **Sostituzioni**). 
+  [Opzioni di campo standard](#standard-field-options)si applicano a tutte le visualizzazioni dei pannelli che consentono le trasformazioni. 
+  [Opzioni dei campi della tabella](table-panel.md#table-field-options)si applicano solo alle visualizzazioni dei pannelli tabellari. 

### Configura tutti i campi
<a name="configure-all-fields"></a>

 Per modificare la modalità di visualizzazione dei dati in tutti i campi, puoi modificare un'opzione nella scheda **Campo**. Nella scheda **Sostituzioni**, puoi quindi sostituire le opzioni di campo per campi specifici. Per ulteriori informazioni, consulta [Configura campi specifici](#configure-specific-fields). 

 **Ad esempio, è possibile modificare il numero di posizioni decimali visualizzate in tutti i campi modificando l'opzione Decimali.** Per ulteriori informazioni sulle opzioni, vedere e. [Opzioni di campo standard](#standard-field-options) [Opzioni dei campi della tabella](table-panel.md#table-field-options) 

#### Modificare l'opzione di un campo
<a name="change-a-field-option"></a>

 Puoi modificare tutte le opzioni che desideri. 

**Per modificare un'opzione di campo**

1.  Scegliete il pannello che desiderate modificare, scegliete il titolo del pannello, quindi scegliete **Modifica**. 

1.  Scegli la scheda **Campo**. 

1.  Trova l'opzione che desideri modificare. Puoi definire quanto segue: 
   +  [Opzioni di campo standard](#standard-field-options), che si applicano a tutte le visualizzazioni dei pannelli che consentono trasformazioni. 
   +  [Opzioni dei campi della tabella](table-panel.md#table-field-options), che si applicano solo alle visualizzazioni dei pannelli delle tabelle. 

1.  Aggiungi opzioni aggiungendo valori nei campi. Per riportare le opzioni ai valori predefiniti, elimina il testo bianco nei campi. 

1.  Quando hai finito di apportare modifiche alla dashboard, scegli **Salva**. 

#### Esempio di opzione di campo
<a name="field-option-example"></a>

 Supponiamo che il set di risultati sia un frame di dati composto da due campi: tempo e temperatura. 


|  time  |  temperature  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47,0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 A ogni campo (colonna) di questa struttura possono essere applicate opzioni di campo in modo da alterarne la modalità di visualizzazione dei valori. Ad esempio, è possibile impostare l'unità su Temperatura > Celsius, ottenendo la tabella seguente. 


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

 La cifra decimale non significa nulla in questo caso. È possibile modificare i decimali `auto` da 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  | 

### Configura campi specifici
<a name="configure-specific-fields"></a>

 Puoi utilizzare le sostituzioni per modificare le impostazioni per uno o più campi. Le opzioni di campo per le sostituzioni sono esattamente le stesse delle opzioni di campo disponibili in una particolare visualizzazione. L'unica differenza è che scegli a quali campi applicarle. 

 **Ad esempio, è possibile modificare il numero di posizioni decimali visualizzate in tutti i campi o le colonne numerici modificando l'opzione **Decimali** per i **campi con** un tipo corrispondente a Numerico.** Per ulteriori informazioni sulle opzioni, consultate[Opzioni di campo standard](#standard-field-options), che si applicano a tutte le visualizzazioni dei pannelli che consentono le trasformazioni e[Opzioni dei campi della tabella](table-panel.md#table-field-options), che si applicano solo alle visualizzazioni dei pannelli tabellari. 

#### Aggiungere una sovrascrittura dei campi
<a name="add-a-field-override"></a>

 Puoi sovrascrivere tutte le opzioni di campo che desideri. 

**Per aggiungere un campo, sovrascrivi**

1.  Scegliete il pannello che desiderate modificare, scegliete il titolo del pannello, quindi scegliete **Modifica**. 

1.  Scegli la scheda **Sostituzioni.** 

1.  Scegli **Aggiungi una sostituzione per.** 

1.  Seleziona i campi a cui desideri applicare una regola di sostituzione. 
   +  **Campi con nome**: utilizza questa opzione per selezionare 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:** utilizzatelo per specificare i campi da sovrascrivere con un'espressione regolare. Le proprietà che aggiungi a una regola utilizzando questo selettore vengono applicate a tutti i campi in cui i nomi dei campi corrispondono all'espressione regolare. 
   +  **Campi con tipo**: utilizzalo per selezionare i campi per tipo, ad esempio stringa, numerico e così via. Le proprietà che aggiungi a una regola con questo selettore vengono applicate a tutti i campi che corrispondono al tipo selezionato. 

1.  Scegli **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 **Save** (Salva). 

#### Elimina l'override di un campo
<a name="delete-a-field-override"></a>

1.  Scegli la scheda Sostituzioni che contiene l'override che desideri eliminare. 

1.  Scegli l'icona del cestino accanto all'override. 

#### Esempio di sovrascrittura dei campi
<a name="field-override-example"></a>

Supponiamo che il nostro set di risultati sia un frame di dati composto da quattro campi: tempo, alta temperatura, bassa temperatura e umidità. 


|  time  |  alta temperatura  |  bassa temperatura  |  umidità  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30,0  |  67  | 
|  2020-01-02 03:05:00  |  47,0  |  34,0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31,0  |  68  | 

 Applichiamo le opzioni del campo da [Esempio di opzione di campo](#field-option-example) per applicare l'unità Celsius ed eliminare la cifra decimale. Ciò risulta nella tabella seguente. 


|  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 l'umidità non ha senso. È possibile risolvere questo problema applicando un'opzione di campo che sostituisce l'opzione di campo al campo di umidità e modificando l'unità in Misc > percent (0-100). Il risultato è una tabella molto più sensata. 


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

### Opzioni di campo standard
<a name="standard-field-options"></a>

 Questa sezione spiega le opzioni di campo disponibili. Sono elencate in ordine alfabetico. 

 È possibile applicare opzioni di campo standard alla maggior parte dei pannelli dell'area di lavoro 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 sceglierete una opzione esterna alla casella delle opzioni di campo che state modificando o premete Invio. 

 Per ulteriori informazioni sull'applicazione di queste opzioni, consulta le seguenti sezioni: 
+  [Configura tutti i campi](#configure-all-fields) 
+  [Configura campi specifici](#configure-specific-fields) 

#### Decimali
<a name="decimals"></a>

 Questa opzione imposta il numero di decimali da includere durante il rendering di un valore. Lascia vuoto affinché Amazon Managed Grafana utilizzi il numero di decimali fornito dall'origine dati. 

 Per modificare questa impostazione, inserisci un numero nel campo. 

#### Collegamenti dati
<a name="data-links-overview"></a>

 Questa opzione controlla l'URL a cui si collega un valore o una visualizzazione. Per ulteriori informazioni e istruzioni, consulta [Collegamenti dati](data-links.md). 

#### Display name (Nome visualizzato)
<a name="display-name"></a>

 Questa opzione imposta il titolo di visualizzazione di tutti i campi. È possibile utilizzare variabili nel titolo del campo. Per ulteriori informazioni sulla creazione di modelli e sulle variabili di modello, vedere. [Modelli e variabili](templates-and-variables.md) 

 Quando vengono visualizzate più statistiche, campi o serie, questo campo controlla il titolo di ogni statistica. Puoi usare espressioni come `${__field.name}` usare solo il nome della serie o il nome del campo nel titolo. 

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


|  Sintassi delle espressioni  |  Esempio  |  Renderizza su  |  Spiegazione  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  Uguale alla sintassi  |  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 relativa all'etichetta, Amazon Managed Grafana visualizza il valore dell'etichetta senza le parentesi.  | 
|  \$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. 

#### Max
<a name="max"></a>

 Questa opzione imposta il valore massimo utilizzato nei calcoli della soglia percentuale. Per il calcolo automatico basato su tutte le serie e i campi, lascia vuota questa impostazione. 

#### Min
<a name="min"></a>

 Questa opzione imposta il valore minimo utilizzato nei calcoli della soglia percentuale. Per il calcolo automatico basato su tutte le serie e i campi, lascia vuota questa impostazione. 

#### Nessun valore
<a name="no-value"></a>

 Inserisci ciò che Amazon Managed Grafana deve visualizzare se il valore del campo è vuoto o nullo. 

#### Unità
<a name="unit"></a>

 Questa opzione specifica l'unità che un campo deve utilizzare. Scegli il campo **Unità**, quindi approfondisci fino a trovare l'unità che desideri. L'unità selezionata viene applicata a tutti i campi tranne il tempo. 

##### Unità personalizzate
<a name="custom-units"></a>

 Puoi anche utilizzare l'elenco a discesa delle unità per specificare unità personalizzate, prefisso o suffisso personalizzato e formati. date/time 

 Per selezionare un'unità personalizzata, inserisci l'unità e seleziona l'ultima `Custom: xxx` opzione nell'elenco a discesa. 
+  `suffix:<suffix>`per l'unità personalizzata che dovrebbe andare dopo il valore. 
+  `time:<format>`per date/time formati personalizzati; ad esempio,`time:YYYY-MM-DD`. Per la sintassi e le opzioni del formato, vedete [Display](https://momentjs.com/docs/#/displaying/). 
+  `si:<base scale><unit characters>`per unità SI personalizzate; ad esempio,`si: mF`. Questa opzione è un po' più avanzata perché consente di specificare sia un'unità che la scala dei dati di origine. Ad esempio, se i dati di origine sono rappresentati come milli (migliaia di) unità, aggiungi all'unità il carattere di scala SI come prefisso. 
+  `count:<unit>`per un'unità di conteggio personalizzata. 
+  `currency:<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="string-units"></a>

 Amazon Managed Grafana a volte può analizzare le stringhe e mostrarle come numeri. Per fare in modo che Amazon Managed Grafana mostri la stringa originale, crea un campo override e aggiungi una proprietà dell'unità con l'unità. `string` 

#### Combinazione di colori
<a name="color-scheme"></a>

 L'opzione field color definisce il modo in cui Amazon Managed Grafana colora serie o campi. Esistono diverse modalità che funzionano in modo diverso e la loro utilità dipende in gran parte dalla visualizzazione attualmente selezionata. 

 Le modalità a colori continui utilizzano la percentuale di un valore rispetto a min e max per interpolare un colore. 
+  **Colore singolo**: set di colori specifico utilizzando il selettore di colori. Ciò è particolarmente utile se si utilizza una regola di override. 
+  **Dalle soglie**: colore derivato dalla soglia corrispondente. È utile per visualizzare indicatori, statistiche e tabelle. 

##### Colore per serie
<a name="color-by-series"></a>

 Amazon Managed Grafana include schemi di colori che definiscono il colore per serie. Ciò è utile, ad esempio, per grafici e diagrammi a torta. 

##### Colora per valore
<a name="color-by-value"></a>

 Amazon Managed Grafana include anche schemi di colori continui (gradienti). Ciò è utile per le visualizzazioni che colorano singoli valori, ad esempio i pannelli stat e il pannello tabellare. 

#### Soglie
<a name="thresholds-overview"></a>

 È possibile utilizzare le soglie per modificare il colore di un campo in base al valore. Per ulteriori informazioni e istruzioni, consulta [Soglie](thresholds.md). 

#### Mappatura dei valori
<a name="value-mapping"></a>

 È possibile utilizzare questa opzione per impostare regole che traducono un valore di campo o un intervallo di valori in testo esplicito. È possibile aggiungere più di una mappatura di valori. 
+  **Tipo di mappatura**: scegli un'opzione. 
  +  **Valore**: inserisci un valore. Se il valore del campo è maggiore o uguale al valore, viene visualizzato il **testo**. 
  +  **Da** e **a**: immettere un intervallo. Se il valore del campo è compreso o uguale ai valori dell'intervallo, viene visualizzato il **testo**. 
+  **Testo**: testo che viene visualizzato se le condizioni sono soddisfatte in un campo. Questo campo accetta variabili. 

# Editor di pannelli
<a name="AMG-panel-editor"></a>

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

 Questo argomento descrive le parti dell'editor di pannelli Amazon Managed Grafana e include collegamenti a cui puoi trovare ulteriori informazioni. 

## Apertura dell'editor dei pannelli
<a name="open-the-panel-editor"></a>

 Esistono diversi modi per accedere all'editor dei pannelli, chiamato anche schermata **Modifica pannello**, modalità di *modifica o modalità* di *modifica dei pannelli*. 
+  **Scegliete l'icona Aggiungi pannello** nella parte superiore dello schermo, quindi scegliete **Aggiungi nuovo pannello**. Il nuovo pannello si apre nell'editor dei pannelli. Per ulteriori informazioni su come aggiungere un pannello, consulta[Aggiungere un pannello](add-a-panel-to-a-dashboard.md). 
+  Scegliete il titolo di un pannello esistente, quindi scegliete **Modifica**. Il pannello si apre in modalità di modifica. 
+  Scegliete un punto qualsiasi di un pannello esistente, quindi **premete e** sulla tastiera. Il pannello si apre in modalità di modifica. 

## Ridimensionamento delle sezioni dell'editor dei pannelli
<a name="resize-panel-editor-sections"></a>

 Trascina per ridimensionare le sezioni dell'editor dei pannelli. Se il riquadro laterale diventa troppo stretto, le schede **Pannello**, **Campo** e **Sostituisci diventano** un elenco a discesa. 

## Parti dell'editor dei pannelli
<a name="parts-of-the-panel-editor"></a>

 Questa sezione descrive le parti della schermata dell'editor dei pannelli, con informazioni sui campi, le opzioni o le attività associate a ciascuna parte. 

### Header
<a name="header"></a>

 La sezione dell'intestazione elenca il nome della dashboard in cui si trova il pannello e alcuni comandi della dashboard. Puoi anche scegliere la freccia **Torna indietro** per tornare alla dashboard. 

 Sul lato destro dell'intestazione ci sono le seguenti opzioni: 
+  **Icona delle impostazioni della dashboard (a forma di ingranaggio)**: scegli di accedere alle impostazioni della dashboard. 
+  **Ignora**: scegli di annullare tutte le modifiche apportate al pannello dall'ultima volta che hai salvato la dashboard. 
+  **Salva**: scegli di salvare la dashboard, incluse tutte le modifiche che hai apportato nell'editor del pannello. 
+  **Applica**: scegli di applicare le modifiche apportate, quindi chiudi l'editor del pannello, tornando alla dashboard. Salva anche la dashboard per rendere permanenti le modifiche applicate. 

### Anteprima della visualizzazione
<a name="visualization-preview"></a>

 La sezione di anteprima della visualizzazione contiene le opzioni di visualizzazione, i controlli dell'intervallo di tempo, l'anteprima della visualizzazione e (se applicabile) il titolo, gli assi e la legenda del pannello. 
+  **Riempi**: l'anteprima della visualizzazione riempie lo spazio disponibile nella parte di anteprima. Se si modifica la larghezza del riquadro laterale o l'altezza del riquadro inferiore, la visualizzazione si adatta per occupare lo spazio disponibile. 
+  **Adatta**: l'anteprima della visualizzazione occupa lo spazio disponibile, ma mantiene le proporzioni del pannello. 
+  **Esatta**: l'anteprima della visualizzazione ha le dimensioni esatte di quelle sulla dashboard. Se lo spazio disponibile non è sufficiente, la visualizzazione si ridimensiona, preservando le proporzioni. 
+  **Controlli dell'intervallo di tempo**: per ulteriori informazioni, vedere. [Controlli dell'intervallo di tempo](dashboard-time-range-controls.md)

### Sezione dati (riquadro più basso)
<a name="data-section-bottom-pane"></a>

 La sezione dati contiene schede in cui è possibile inserire interrogazioni, trasformare i dati e creare regole di avviso (se applicabili). 
+  **Scheda Query**: seleziona la tua fonte di dati e inserisci le domande qui. Per ulteriori informazioni, consulta [Query](panel-queries.md). 
+  **Scheda Trasforma**: applica le trasformazioni dei dati. Per ulteriori informazioni, consulta [Trasformazioni](panel-transformations.md). 
+  **Scheda Avviso**: scrivi le regole di avviso. Per ulteriori informazioni, consulta [Avvisi Grafana](alerts-overview.md). 

### Opzioni del pannello e del campo (pannello laterale)
<a name="panel-and-field-options-side-pane"></a>

 Questa sezione contiene schede in cui è possibile controllare quasi ogni aspetto della visualizzazione dei dati. Non tutte le schede sono disponibili per ogni visualizzazione. 

 Le funzionalità di queste schede sono documentate nei seguenti argomenti: 
+  [Aggiungere un pannello](add-a-panel-to-a-dashboard.md) 
+  [Visualizzazioni](AMG-visualizations.md) 
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md) 
+  [Collegamenti al pannello](panel-links.md)e [Collegamenti dati](data-links.md) che ti aiutano a connettere la tua visualizzazione ad altre risorse 

# Pannelli della biblioteca
<a name="AMG-library-panel"></a>

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

 I pannelli Libreria consentono agli utenti di creare pannelli riutilizzabili in cui le modifiche apportate a un'istanza del pannello della libreria si riflettono su ogni dashboard e influiscono su tutte le altre istanze in cui viene utilizzato il pannello. Questi pannelli possono essere salvati in cartelle insieme alle dashboard e semplificare il riutilizzo dei pannelli su più dashboard. 

## Crea un pannello della libreria
<a name="library-panel-create"></a>

**Nota**  
Quando create i pannelli della libreria, anche il pannello sulla dashboard di origine viene convertito in un pannello della libreria. Dovrete salvare la dashboard originale una volta convertito un pannello.

**Per creare un pannello della libreria**

1. Crea un pannello come faresti normalmente. Puoi anche usare un pannello esistente.

1. Scegli il titolo del pannello e scegli **Modifica**.

1. Nel riquadro laterale delle opzioni di visualizzazione del pannello, scegli l'opzione freccia giù per apportare modifiche alla visualizzazione.

1. Scegliete **i pannelli Libreria** e scegliete **Crea nuovo pannello Libreria**. 

1. Immettete un nome per il pannello della libreria e selezionate la cartella in cui salvarlo.

1. Scegliete **Crea pannello libreria**, quindi salvate la dashboard.

Puoi anche creare pannelli di libreria utilizzando l'opzione **Condividi** per qualsiasi pannello.

Una volta creato, puoi modificare il pannello della libreria utilizzando qualsiasi dashboard in cui appare. Una volta salvate le modifiche al pannello della libreria, tutte le istanze del pannello della libreria rifletteranno tali modifiche.

## Aggiungi un pannello della libreria
<a name="library-panel-add"></a>

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

1. Metti in pausa l'opzione \$1 nel menu a sinistra, quindi scegli **Crea**.

1. Scegli **Aggiungi un pannello dalla libreria dei pannelli**.

1. Filtra l'elenco dei pannelli della libreria per trovare il pannello che desideri.

1. Scegli quel pannello e aggiungilo alla dashboard. 

## Scollega un pannello della libreria
<a name="library-panel-unlink"></a>

Se nella dashboard è presente un pannello della libreria che desideri modificare senza influire su tutte le altre istanze del pannello della libreria, puoi scollegare il pannello della libreria.

**Per scollegare un pannello della libreria da una dashboard**

1. Metti in pausa su **Dashboard** nel menu a sinistra, quindi scegli i pannelli **Libreria**.

1. Seleziona un pannello della libreria. Verrà visualizzato un elenco di tutte le dashboard in cui viene utilizzato il pannello della libreria.

1. Seleziona il pannello che desideri scollegare e aggiornare.

1. Scegli il titolo del pannello e scegli **Modifica**. 

1. Scegli **Scollega**. 

## Eliminare un pannello della libreria
<a name="library-panel-delete"></a>

Prima di eliminare un pannello della libreria, verificate che non sia più in uso su nessuna dashboard.

**Per eliminare un pannello della libreria**

1. Fai una pausa su **Dashboard** nel menu a sinistra, quindi scegli i **pannelli Libreria**.

1. Seleziona un pannello della libreria. Verrà visualizzato un elenco di tutte le dashboard in cui viene utilizzato il pannello della libreria.

1. Seleziona il pannello che desideri eliminare.

1. Scegliete l'icona di eliminazione accanto al nome del pannello. 

## Parti dell'editor dei pannelli
<a name="parts-of-the-panel-editor"></a>

 Questa sezione descrive le parti della schermata dell'editor dei pannelli, con informazioni su campi, opzioni o attività associati a ciascuna parte. 

### Header
<a name="header"></a>

 La sezione dell'intestazione elenca il nome della dashboard in cui si trova il pannello e alcuni comandi della dashboard. Puoi anche scegliere la freccia **Torna indietro** per tornare alla dashboard. 

 Sul lato destro dell'intestazione ci sono le seguenti opzioni: 
+  **Icona delle impostazioni della dashboard (ingranaggio)**: scegli di accedere alle impostazioni della dashboard. 
+  **Ignora**: scegli di annullare tutte le modifiche apportate al pannello dall'ultima volta che hai salvato la dashboard. 
+  **Salva**: scegli di salvare la dashboard includendo tutte le modifiche che hai apportato nell'editor del pannello. 
+  **Applica**: scegli di applicare le modifiche apportate, quindi chiudi l'editor del pannello, tornando alla dashboard. Salva anche la dashboard per rendere permanenti le modifiche applicate. 

### Anteprima della visualizzazione
<a name="visualization-preview"></a>

 La sezione di anteprima della visualizzazione contiene le opzioni di visualizzazione, i controlli dell'intervallo di tempo, l'anteprima della visualizzazione e (se applicabile) il titolo, gli assi e la legenda del pannello. 
+  **Riempi**: l'anteprima della visualizzazione riempie lo spazio disponibile nella parte di anteprima. Se si modifica la larghezza del riquadro laterale o l'altezza del riquadro inferiore, la visualizzazione si adatta per occupare lo spazio disponibile. 
+  **Adatta**: l'anteprima della visualizzazione occupa lo spazio disponibile, ma mantiene le proporzioni del pannello. 
+  **Esatta**: l'anteprima della visualizzazione ha le dimensioni esatte di quelle sulla dashboard. Se lo spazio disponibile non è sufficiente, la visualizzazione si ridimensiona, preservando le proporzioni. 
+  **Controlli dell'intervallo di tempo**: per ulteriori informazioni, vedere. [Controlli dell'intervallo di tempo](dashboard-time-range-controls.md)

### Sezione dati (riquadro più basso)
<a name="data-section-bottom-pane"></a>

 La sezione dati contiene schede in cui è possibile inserire interrogazioni, trasformare i dati e creare regole di avviso (se applicabili). 
+  **Scheda Query**: seleziona la tua fonte di dati e inserisci le domande qui. Per ulteriori informazioni, consulta [Query](panel-queries.md). 
+  **Scheda Trasforma**: applica le trasformazioni dei dati. Per ulteriori informazioni, consulta [Trasformazioni](panel-transformations.md). 
+  **Scheda Avviso**: scrivi le regole di avviso. Per ulteriori informazioni, consulta [Avvisi Grafana](alerts-overview.md). 

### Opzioni del pannello e del campo (pannello laterale)
<a name="panel-and-field-options-side-pane"></a>

 Questa sezione contiene schede in cui è possibile controllare quasi ogni aspetto della visualizzazione dei dati. Non tutte le schede sono disponibili per ogni visualizzazione. 

 Le funzionalità di queste schede sono documentate nei seguenti argomenti: 
+  [Aggiungere un pannello](add-a-panel-to-a-dashboard.md) 
+  [Visualizzazioni](AMG-visualizations.md) 
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md) 
+  [Collegamenti al pannello](panel-links.md)e [Collegamenti dati](data-links.md) che consentono di collegare la visualizzazione ad altre risorse 

# Visualizzazioni
<a name="AMG-visualizations"></a>

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

Amazon Managed Grafana offre una varietà di visualizzazioni per soddisfare diversi casi d'uso. Le seguenti sezioni elencano le visualizzazioni disponibili in Amazon Managed Grafana e le relative impostazioni di visualizzazione.

**Topics**
+ [Pannello dell'elenco degli avvisi](alert-list-panel.md)
+ [Pannello grafico a barre](bar-chart-panel.md)
+ [Pannello calibro a barra](alert-panel-bar-gauge-panel.md)
+ [Pannello dell'orologio](clock-panel.md)
+ [Pannello elenco del pannello di controllo](dashboard-list-panel.md)
+ [Pannello del calibro](gauge-panel.md)
+ [Pannello Geomap](AMG-Geomap.md)
+ [Pannello grafico](graph-panel.md)
+ [Mappa termica](visualization-heatmap.md)
+ [Pannello istogramma](histogram-panel.md)
+ [Pannello Logs](logs-panel.md)
+ [Pannello delle notizie](news-panel.md)
+ [Pannello grafico dei nodi (Beta)](node-graph-panel.md)
+ [Pannello grafico a torta](pie-chart-panel.md)
+ [Pannello Plotly](plotly-panel.md)
+ [Pannello Sankey](sankey-panel.md)
+ [Pannello Scatter](scatter-panel.md)
+ [Pannello Stat](stat-panel.md)
+ [Pannello della cronologia dello stato](state-timeline-panel.md)
+ [Pannello della cronologia dello stato](status-history-panel.md)
+ [Pannello da tavolo](table-panel.md)
+ [Pannello di testo](text-panel.md)
+ [Pannello delle serie temporali](time-series-panel.md)
+ [Soglie](thresholds.md)
+ [WindRose](windrose.md)
+ [Ispeziona un pannello](inspect-a-panel.md)
+ [Elenco dei calcoli](list-of-calculations.md)

# Pannello dell'elenco degli avvisi
<a name="alert-list-panel"></a>

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

Il pannello con l'elenco degli avvisi mostra gli avvisi della dashboard. È possibile configurare l'elenco per mostrare lo stato corrente o le modifiche recenti dello stato. Per ulteriori informazioni sugli avvisi, vedere[Avvisi Grafana](alerts-overview.md).

Utilizza queste impostazioni per perfezionare la visualizzazione.

## Opzioni
<a name="alert-list-panel-options"></a>
+  **Mostra**: scegli se il pannello deve visualizzare lo stato di avviso corrente o le modifiche recenti dello stato di avviso.
+  **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:
    + avviso: 1
    + nessuno\$1dato: 2
    + in sospeso: 3
    + ok: 4
    + in pausa: 5
+  **Avvisi da questa dashboard**: mostra gli avvisi solo dalla dashboard in cui si trova l'elenco degli avvisi.

## Filtro
<a name="alerts-panel-filter"></a>

Utilizza le seguenti opzioni per filtrare gli avvisi in modo che corrispondano alla query, alla cartella o ai tag che scegli:
+  **Nome dell'avviso**: immetti una richiesta relativa al nome dell'avviso. 
+  **Titolo del pannello** di controllo: immetti una domanda sul titolo del pannello di controllo.
+  **Cartella**: seleziona una cartella. Verranno visualizzati solo gli avvisi provenienti dai dashboard nella cartella selezionata.
+  **Tag del pannello di controllo:** seleziona uno o più tag. Verranno visualizzati solo gli avvisi provenienti dai dashboard con uno o più tag. 

## Filtro di stato
<a name="alert-panel-state-filter"></a>

Scegli quali stati di avviso visualizzare in questo pannello.
+ Ok
+ In pausa
+ Nessun dato
+ Errore di esecuzione
+ Avviso
+ Pending (In attesa)

# Pannello grafico a barre
<a name="bar-chart-panel"></a>

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

Questa visualizzazione del pannello consente di rappresentare graficamente dati categorici.

## Formati di dati supportati
<a name="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="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="bar-chart-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Orientation** (Orientamento)
+  **Automatico** — Grafana decide l'orientamento della barra in base alle dimensioni del pannello.
+  **Orizzontale**: rende l'asse X l'asse delle categorie.
+  **Verticale**: rende l'asse Y l'asse delle categorie.

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

La **larghezza del gruppo** controlla la larghezza dei gruppi. 0=min e 1=larghezza massima.

La **larghezza della barra** controlla la larghezza delle barre. 0=min e 1=larghezza massima.

**La larghezza della linea controlla la larghezza** della linea delle barre.

**L'opacità di riempimento** controlla l'opacità di riempimento delle barre.

La modalità **gradiente imposta la modalità di riempimento** del gradiente. Il gradiente di riempimento si basa sul colore della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard. L'aspetto del gradiente è influenzato dall'impostazione dell'opacità di riempimento.
+  **Nessuno**: nessun riempimento a gradiente, questa è l'impostazione predefinita.
+  **Opacità: la** trasparenza del gradiente viene calcolata in base ai valori sull'asse y. L'opacità del riempimento aumenta con i valori sull'asse Y.
+  **Tonalità**: il colore del gradiente viene generato in base alla tonalità del colore della linea.

**Modalità Tooltip**: quando si posiziona il cursore sulla visualizzazione, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip.
+  **Singolo**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui stai posizionando il mouse sulla visualizzazione.
+  **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie della visualizzazione. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+  **Nascosto**: non visualizza il tooltip quando interagisci con la visualizzazione.

**Nota**  
Utilizzate un override per nascondere le singole serie dal tooltip.

**Modalità Legenda**: utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Si tratta di una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda**: scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

**Calcoli della legenda**: scegli quali calcoli standard mostrare nella legenda. Puoi averne più di uno.

**Dimensione del testo**: inserisci un valore per modificare la dimensione del testo sul grafico a barre.

**Asse**: utilizza le seguenti impostazioni di campo per perfezionare la visualizzazione degli assi. Alcune opzioni di campo non influiranno sulla visualizzazione finché non fate clic all'esterno della casella delle opzioni di campo che state modificando o premete Invio.
+  **Posizionamento**: imposta il posizionamento dell'asse Y.
+  **Automatico** — Grafana assegna automaticamente l'asse Y alla serie. Quando ci sono due o più serie con unità diverse, Grafana assegna l'asse sinistro alla prima unità e quello destro alle unità successive.
+  **Sinistra**: visualizza tutti gli assi Y sul lato sinistro.
+  **Destra**: visualizza tutti gli assi Y sul lato destro.
+  **Nascosto**: nasconde tutti gli assi Y.
+  **Etichetta**: imposta un'etichetta di testo sull'asse Y. Se hai più di un asse Y, puoi assegnare etichette diverse con un'eccezione.
+  **Larghezza**: imposta una larghezza fissa dell'asse. Per impostazione predefinita, Grafana calcola dinamicamente la larghezza di un asse.

  Impostando la larghezza dell'asse, i dati con diversi tipi di assi possono condividere le stesse proporzioni di visualizzazione. Ciò semplifica il confronto di più dati di un grafico perché gli assi non vengono spostati o allungati in prossimità visiva l'uno dell'altro.
+  **Soft min e soft max**: impostate le opzioni soft min e soft max per un migliore controllo dei limiti dell'asse Y. Per impostazione predefinita, Grafana imposta automaticamente l'intervallo per l'asse Y in base al set di dati.

  Le impostazioni soft min e soft max possono impedire che i blip si trasformino in montagne quando i dati sono per lo più piatti, mentre le impostazioni hard min o max, derivate dalle opzioni di campo min e max standard, possono impedire ai picchi intermittenti di appiattire i dettagli utili ritagliando i picchi oltre un punto definito.

  È possibile impostare opzioni standard min/max per definire limiti rigidi dell'asse Y.

# Pannello calibro a barra
<a name="alert-panel-bar-gauge-panel"></a>

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

L'indicatore a barre semplifica i dati riducendo ogni campo a un unico valore. Sei tu a scegliere come Amazon Managed Grafana calcola la riduzione.

Questo pannello può mostrare uno o più indicatori a barre a seconda del numero di serie, righe o colonne restituite dalla query.

## Opzioni relative ai dati e ai campi
<a name="bar-gauge-data-and-field-options"></a>

Con le visualizzazioni a barre, puoi applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md) 
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md) 
+  [Soglie](thresholds.md) 

## Opzioni di visualizzazione
<a name="bar-gauge-display-options"></a>

Utilizza le seguenti opzioni per perfezionare la visualizzazione:
+  **Mostra**: scegli come Amazon Managed Grafana visualizza i tuoi dati.
  +  **Calcola**: mostra un valore calcolato in base a tutte le righe. Per un elenco dei calcoli disponibili, vedere[Elenco dei calcoli](list-of-calculations.md).
  +  **Tutti i valori**: mostra una statistica separata per ogni riga. Se selezioni questa opzione, puoi anche selezionare un **Limite** o il numero massimo di righe da visualizzare.
+  **Valore**: seleziona una funzione di riduzione che Amazon Managed Grafana utilizzerà per ridurre molti campi a un unico valore. Scegli la lista dei **valori** per visualizzare le funzioni e le brevi descrizioni. 
+  **Orientamento**: scegli una direzione di impilamento.
  +  **Auto**: Amazon Managed Grafana seleziona l'orientamento che ritiene più adatto.
  +  **Orizzontale**: le barre si estendono orizzontalmente, da sinistra a destra.
  +  **Verticale**: le barre si estendono verticalmente, dall'alto verso il basso.
+  **Modalità di visualizzazione**: scegli una modalità di visualizzazione.
  +  **Gradiente**: scegli un livello di soglia per definire un gradiente.
  +  **LCD retrò**: visualizza l'indicatore suddiviso in piccole celle accese o spente.
  +  **Base**: utilizza un solo colore in base alla soglia corrispondente.
+  **Mostra area vuota**: selezionate questa opzione se desiderate rendere l'area vuota delle barre in grigio scuro. Questa opzione non è disponibile per la modalità di visualizzazione LCD retrò.

# Pannello dell'orologio
<a name="clock-panel"></a>

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

Il pannello dell'orologio mostra l'ora corrente o un conto alla rovescia. Si aggiorna ogni secondo.
+ **Modalità**: l'impostazione predefinita è l'**ora**. Se scegli il **conto alla rovescia**, imposta la **scadenza del conto alla rovescia** per iniziare il conto alla rovescia.
+ **12 o 24 ore: le opzioni per mostrare l'ora** sono il formato 12 ore e il formato 24 ore.
+ **Fuso orario**: i fusi orari sono forniti dalla libreria moment timezone. L'impostazione predefinita è il fuso orario del computer.
+ **Scadenza del conto alla rovescia****: specifica l'ora e la data in cui eseguire il conto alla rovescia, se hai impostato la **modalità** sul conto alla rovescia.**
+ **Testo di fine del conto alla rovescia**: specifica il testo da mostrare al termine del conto alla rovescia.
+ **Opzioni di formattazione data/ora: personalizza** la dimensione, lo spessore e la formattazione del carattere. date/time Se stai visualizzando un conto alla rovescia e non vuoi vedere i secondi che scorrono, modifica il formato dell'ora impostandolo per l'orologio a 24 ore o `hh:mm` per l'orologio a 12 ore. `h:mm A` [Per un elenco completo delle opzioni, consulta Display.](https://momentjs.com/docs/#/displaying/)
+ **Bg Color**: seleziona un colore di sfondo per l'orologio.

# Pannello elenco del pannello di controllo
<a name="dashboard-list-panel"></a>

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

Il pannello con l'elenco delle dashboard mostra collegamenti dinamici ad altre dashboard. L'elenco può essere configurato per utilizzare dashboard contrassegnati con stelle, dashboard visualizzati 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
<a name="options-1"></a>

Utilizza le seguenti opzioni per perfezionare la visualizzazione:
+  **Speciale: visualizza i dashboard contrassegnati** con stelle in ordine alfabetico.
+  Visualizzate di **recente**: mostra le dashboard visualizzate di recente in ordine alfabetico.
+  **Ricerca**: visualizza le dashboard in base a query di ricerca o tag. Questa opzione richiede l'immissione di almeno un valore in **Query** o **Tags**.
+  **Mostra titoli**: mostra la selezione dell'elenco scelta (Specializzato, Visualizzato di recente, Cerca) come titolo.
+  **Numero massimo di articoli**: imposta il numero massimo di elementi da elencare per sezione. Ad esempio, con il valore predefinito di 10, se scegli di visualizzare le dashboard con stelle e quelle visualizzate di recente, il pannello mostra fino a 20 dashboard totali, 10 per sezione.

### Cerca
<a name="panel-dashboard-list-search"></a>

Le seguenti opzioni si applicano solo se è selezionata l'opzione **Cerca**.
+  **Interrogazione**: immettere l'interrogazione in cui si desidera 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**: inserisci i tag in cui desideri cercare. Tieni presente che i tag esistenti non verranno visualizzati durante la digitazione e i tag *fanno* distinzione tra maiuscole e minuscole.

**Nota**  
Quando vengono visualizzati più tag e stringhe, l'elenco della dashboard mostra quelli che soddisfano *tutte le* condizioni.

# Pannello del calibro
<a name="gauge-panel"></a>

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

 **Gauge** è un pannello a valore singolo che può ripetere un indicatore per ogni serie, colonna o riga.

## Opzioni relative ai dati e ai campi
<a name="gauge-panel-data-and-field-options"></a>

Le visualizzazioni degli indicatori consentono di applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md) 
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md) 
+  [Soglie](thresholds.md) 

## Opzioni di visualizzazione
<a name="gauge-panel-display-options-2"></a>

Per perfezionare la visualizzazione, utilizza le seguenti opzioni:
+  **Mostra**: scegli come Amazon Managed Grafana visualizza i tuoi dati.
  +  **Calcola**: mostra un **valore** calcolato in base a tutte le righe. Per un elenco dei calcoli disponibili, vedere[Elenco dei calcoli](list-of-calculations.md).
  +  **Tutti i valori**: mostra una statistica separata per ogni riga. Se selezioni questa opzione, puoi anche selezionare un **Limite** o il numero massimo di righe da visualizzare.
+  **Orientamento**: scegli una direzione di impilamento.
  +  **Auto**: Amazon Managed 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.
+  **Mostra etichette di soglia**: scegli se mostrare i valori di soglia.
+  **Mostra indicatori di soglia**: scegli se mostrare una banda di soglia al di fuori della banda di valori dell'indicatore interno.

# Pannello Geomap
<a name="AMG-Geomap"></a>

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

La visualizzazione del pannello **Geomap** consente di visualizzare e personalizzare la mappa del mondo utilizzando dati geospaziali. Per concentrarti facilmente sulle importanti caratteristiche dei dati basate sulla posizione, puoi configurare vari stili di sovrapposizione e impostazioni di visualizzazione della mappa.

## Livello dati
<a name="Data-Layer"></a>

Il livello dati del plug-in Geomap determina il modo in cui vengono visualizzati i dati geospaziali sulla parte superiore della mappa di base.

### Location (Ubicazione)
<a name="Location"></a>

Il pannello **Geomap** necessita di una fonte di dati geografici. Questi dati provengono da una query del database e sono disponibili quattro opzioni di mappatura per i dati.
+ Ricerca **automaticamente** i dati sulla posizione. Utilizzate questa opzione quando la ricerca si basa su uno dei seguenti nomi per i campi dati.
  + geohash: «geohash»
  + latitudine: «latitudine», «lat»
  + longitudine: «longitudine», «lng», «lon»
  + lookup: «cerca»
+  **Coords** specifica che la tua query contiene dati di coordinate. Ti verrà richiesto di selezionare i campi di dati numerici per latitudine e longitudine dalla query del database.
+  **Geohash specifica che la tua query contiene dati geohash**. Ti verrà richiesto di selezionare un campo di dati di tipo stringa per il geohash dalla query del database.
+  La **ricerca** specifica che la query contiene i dati del nome della posizione che devono essere mappati su un valore. Ti verrà richiesto di selezionare il campo di ricerca dalla query del database e un. ` gazetteer` ` gazetteer `È la directory utilizzata per mappare i dati richiesti su un punto geografico.

## Livello di marker
<a name="Markers-Layer"></a>

Il livello **Markers** consente di visualizzare i punti dati sotto forma di marker di diverse forme, ad esempio cerchi, quadrati, triangoli, stelle e altro.
+ **Marker Color configura il colore del** marker. La dimensione fissa predefinita mantiene tutti i punti di un unico colore. Esiste un'opzione alternativa per avere più colori a seconda dei valori dei punti dati e della soglia impostata nella sezione **Soglie**.
+  **Marker Size configura la dimensione** del marker. L'impostazione predefinita ` Fixed size` prevede che tutti i marker abbiano le stesse dimensioni indipendentemente dai punti dati. Tuttavia, esiste anche un'opzione per ridimensionare i cerchi in base ai punti dati corrispondenti. ` Min`e la dimensione del `Max ` marker deve essere impostata in modo tale che il livello Marker possa scalare all'interno di questi intervalli.
+  **Marker Shape offre la** flessibilità necessaria per visualizzare i punti dati in modo diverso.
  + Circle (Cerchio)
  + Square
  + Triangolo
  + Croce
  + X
+  **L'opacità di riempimento** configura la trasparenza di ogni marker.

## Livello di mappa termica
<a name="Heatmap-layer"></a>

Il livello **Heatmap** raggruppa vari punti dati per visualizzare posizioni con densità diverse. **Per aggiungere un livello di mappa termica, in **Data** Layer, scegli Heatmap.**



Analogamente a **Markers**, ti vengono richieste varie opzioni per determinare quali punti dati visualizzare e in che modo.
+ **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.

# Pannello grafico
<a name="graph-panel"></a>

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

Un pannello grafico può essere visualizzato come una linea, un percorso di punti o una serie di barre. Questo tipo di grafico è abbastanza versatile da visualizzare quasi tutti i dati di serie temporali.

## Opzioni relative ai dati e ai campi
<a name="graph-panel-data-and-field-options"></a>

Quando si utilizzano visualizzazioni grafiche, è possibile applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md) 
+ Avvisi. Questo è l'unico tipo di visualizzazione che consente di impostare avvisi. Per ulteriori informazioni, consulta [Avvisi Grafana](alerts-overview.md).
+  [Soglie](thresholds.md) 

## Opzioni di visualizzazione
<a name="graph-panel-display-options"></a>

Per perfezionare la visualizzazione, utilizza le seguenti impostazioni:
+  **Barre**: visualizza i valori come grafico a barre. 
+  **Linee**: visualizza i valori come grafico a linee. 
+  **Larghezza della linea**: specifica la larghezza della linea per una serie. Il valore di default è 1.
+  **Scala**: disegna i punti adiacenti come scala.
+  **Riempimento dell'area**: specifica la quantità di riempimento a colori per una serie. L'impostazione predefinita è 1; 0 è nessuna.
+  **Gradiente di riempimento**: specifica il grado di sfumatura sull'area di riempimento. L'impostazione predefinita è 0, che non indica alcun gradiente; 10 è un gradiente ripido.
+  **Punti: visualizza i punti** per i valori. 
+  **Raggio del punto**: controlla la dimensione dei punti.
+  **Soglie di avviso: visualizza le** soglie di avviso e le regioni sul pannello.

### Impilamento e valore nullo
<a name="stacking-and-null-value"></a>
+  **Pila**: ogni serie è impilata sopra l'altra.
+  **Percentuale**: ogni serie viene estratta come percentuale del totale di tutte le serie. Questa opzione è disponibile quando è selezionato **Stack**.
+  **Valore nullo**: specifica come vengono visualizzati i valori nulli. *Si tratta di un'impostazione importante.* Vedi la nota riportata di seguito.
  +  **connesso**: se nella serie è presente uno spazio vuoto, ovvero uno o più valori nulli, la riga salterà lo spazio vuoto e si connetterà al valore successivo non nullo. 
  +  **null** Se nella serie è presente uno spazio vuoto, ovvero un valore nullo, la riga del grafico verrà interrotta e mostrerà lo spazio vuoto. Questa è l'impostazione predefinita.
  +  **null as zero** — Se c'è uno spazio vuoto nella serie, ossia un valore nullo, questo verrà visualizzato come valore zero nel pannello grafico.

**Importante**  
Se state monitorando il carico della CPU di un server e il carico raggiunge il 100%, il server si bloccherà e l'agente che invia le statistiche non sarà in grado di raccogliere le statistiche di carico. Ciò comporta una lacuna nelle metriche e l'utilizzo dell'impostazione *null* predefinita significa che Amazon Managed Grafana mostrerà le lacune e indicherà che qualcosa non va. Se è impostato su *connesso*, sarà facile perdere questo segnale. 

### Posiziona il mouse sul tooltip
<a name="graph-panel-hover-tooltip"></a>

Usa queste impostazioni per modificare l'aspetto del tooltip che appare quando ti fermi sulla visualizzazione del grafico.
+  **Modalità**: determina il numero di serie visualizzate dal tooltip posizionato al passaggio del mouse.
  +  **Tutte le serie**: il tooltip al passaggio del mouse mostra tutte le serie nel grafico. Nell'elenco delle serie nel tooltip, l'area di lavoro Grafana evidenzia in grassetto la serie su cui stai facendo una pausa.
  +  **Singola**: il tooltip al passaggio del mouse mostra solo una singola serie, quella su cui stai facendo una pausa nel grafico.
+  **Ordinamento: ordina** **l'ordine delle serie nel tooltip posizionato al passaggio del mouse se è stata selezionata la modalità Tutte le serie.** Quando fai una pausa su un grafico, Amazon Managed Grafana mostra i valori associati alle linee. In genere, gli utenti sono più interessati ai valori più alti o più bassi. L'ordinamento di questi valori può semplificare notevolmente la ricerca dei dati desiderati.
  +  **Nessuno**: l'ordine delle serie nel tooltip è determinato dal tipo di ordinamento della query. Ad esempio, è possibile ordinare la serie alfabeticamente in base al nome della serie.
  +  **Crescente**: le serie nel tooltip al passaggio del mouse vengono ordinate per valore e in ordine crescente, con il valore più basso nella parte superiore dell'elenco.
  +  **Decrescente**: le serie presenti nel tooltip al passaggio del mouse sono ordinate per valore e in ordine decrescente, con il valore più alto in cima all'elenco.

## Sostituzioni delle serie
<a name="graph-panel-series-overrides"></a>

Le sostituzioni delle serie consentono di renderizzare una serie in un pannello grafico in modo diverso dalle altre. È possibile personalizzare le opzioni di visualizzazione in base alla serie o utilizzando le regole regex. Ad esempio, una serie può avere una larghezza di linea più spessa per farla risaltare o essere spostata sull'asse Y destro.

È possibile aggiungere più sostituzioni di serie.

**Per aggiungere una sovrascrittura di serie**

1. Scegli **Aggiungi sovrascrittura alla serie**.

1. In **Alias o regex**, digita o seleziona una serie. Scegli il campo per visualizzare un elenco delle serie disponibili.

   Ad esempio, `/Network.*/` corrisponderebbe a due serie denominate `Network out` e`Network in`.

1. Scegliete **\$1**, quindi selezionate uno stile da applicare alla serie. Puoi aggiungere più stili a ogni voce.
+  **Barre**: mostra le serie come grafico a barre. 
+  **Linee**: mostra le serie come grafico a linee. 
+  **Riempimento a linee**: mostra un grafico a linee con riempimento ad area. 
+  **Gradiente di riempimento: specifica la quantità del gradiente** di riempimento dell'area.
+  **Larghezza della linea: imposta lo spessore della linea**.
+  **Modalità punto nullo**: utilizzate questa opzione per ignorare i valori nulli o sostituirli con zero. Questo è importante se vuoi ignorare le lacune nei dati.
+  **Compila di seguito per**: riempi l'area tra due serie.
+  **Linea della scala**: mostra la serie come linea di scala.
+  **Trattini**: mostra una linea con trattini. 
+  **Hidden Series**: nasconde la serie. 
+  **Lunghezza trattino**: imposta la lunghezza dei trattini nella linea.
+  **Dash Space**: imposta la lunghezza degli spazi tra i trattini della linea.
+  **Punti**: mostra le serie come punti separati.
+  **Raggio del punto**: imposta il raggio per il rendering dei punti.
+  **Pila**: imposta il gruppo di pila per la serie.
+  **Colore**: imposta il colore della serie.
+  **Asse Y: imposta l'asse** y della serie.
+  **Z-index** — Imposta lo z-index della serie (ordine di rendering). Questa opzione è importante quando si sovrappongono stili diversi, come grafici a barre e grafici ad area.
+  Trasforma: trasforma il valore in negativo per renderlo al di sotto dell'asse y.
+  **Legenda**: controlla se una serie viene mostrata nella legenda.
+  **Nascondi nel tooltip**: controlla se una serie viene mostrata in un tooltip grafico.

## Axes (Asse)
<a name="graph-panel-axes"></a>

Utilizzate queste opzioni per controllare la visualizzazione degli assi nella visualizzazione.

### Y a sinistra Y/Right
<a name="left-yright-y"></a>

Le opzioni sono identiche per entrambi gli assi y.
+  **Mostra**: scegli di mostrare o nascondere l'asse.
+  **Unità**: scegli l'unità di visualizzazione per il valore y.
+  **Scala**: scegli la scala da usare per il valore y: **lineare** o **logaritmica**. **L'impostazione predefinita è lineare.**
+  **Y-Min** — Il valore y minimo. L'impostazione predefinita è **auto**.
+  **Y-Max**: il valore Y massimo. L'impostazione predefinita è **auto**.
+  **Decimali**: definisce quanti decimali vengono visualizzati per il valore y. L'impostazione predefinita è **auto**. 
+  **Etichetta**: specifica l'etichetta dell'asse y. L'impostazione predefinita è «»,

### Assi Y
<a name="y-axes"></a>
+  **Allinea: allinea** gli assi y sinistro e destro in base al valore. L'impostazione predefinita è unchecked/false.
+  **Livello**: immettete il valore da utilizzare per l'allineamento degli assi y sinistro e destro, a partire da Y=0. Il valore predefinito è 0. **Questa opzione è disponibile quando è selezionato Allinea.** 

### Asse X
<a name="x-axis"></a>
+  **Mostra**: scegli di mostrare o nascondere l'asse.
+  **Modalità**: la modalità di visualizzazione modifica completamente la visualizzazione del pannello grafico. È come avere tre pannelli in uno. La modalità principale è la modalità serie temporale con il tempo sull'asse x. Le altre due modalità sono una modalità grafico a barre di base con serie sull'asse x anziché sul tempo e una modalità istogramma.
  +  **Ora** (impostazione predefinita): l'asse x rappresenta il tempo e i dati sono raggruppati per ora (ad esempio, per ora o per minuto).
  +  **Serie**: i dati sono raggruppati per serie e non per ora. L'asse y rappresenta ancora il valore.
    +  **Valore**: questo è il tipo di aggregazione da utilizzare per i valori. L'impostazione predefinita è **totale** (somma dei valori).
  +  **Istogramma**: questa opzione converte il grafico in un istogramma. Un istogramma è un tipo di grafico a barre che raggruppa i numeri in intervalli, spesso chiamati secchi o contenitori. Le barre più alte indicano che in quell'intervallo rientrano più dati.

    Per ulteriori informazioni sugli istogrammi, vedere. [Introduzione agli istogrammi e alle mappe di calore](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)
    +  **Bucket: imposta** il numero di bucket in base ai quali raggruppare i valori. Se lasciato vuoto, Amazon Managed Grafana prova a calcolare un numero adeguato di bucket.
    +  **X-Min**: filtra dall'istogramma i valori inferiori a questo limite minimo.
    +  **X-Max**: filtra i valori superiori a questo limite massimo.

## Legenda
<a name="graph-panel-legend"></a>

Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.

### Opzioni
<a name="graph-panel-legends-options"></a>
+  **Mostra**: deseleziona per nascondere la legenda. L'impostazione predefinita è selezionata (true).
+  **Come tabella**: selezionare per visualizzare la legenda nella tabella. L'impostazione predefinita è selezionata (true).
+  **A destra**: selezionare per visualizzare la legenda a destra.
+  Larghezza: immetti la larghezza minima per la legenda in pixel. Questa opzione è disponibile quando è selezionata **l'opzione A destra**.

### Valori
<a name="graph-panel-values"></a>

È possibile visualizzare valori aggiuntivi accanto ai nomi delle legende.
+  **Min**: il valore minimo restituito dalla query metrica.
+  **Max**: il valore massimo restituito dalla query metrica.
+  **Media**: il valore medio restituito dalla query metrica.
+  **Corrente**: l'ultimo valore restituito dalla query metrica.
+  **Totale**: la somma di tutti i valori restituiti dalla query metrica.
+  **Decimali: quanti decimali** vengono visualizzati per i valori delle legende e le descrizioni dei comandi al passaggio del mouse sul grafico.

Amazon Managed Grafana calcola i valori della legenda sul lato client. Questi valori della legenda dipendono dal tipo di aggregazione o consolidamento dei punti utilizzato dalla query metrica. Tutti i valori della legenda sopra riportati non possono essere corretti contemporaneamente.

Ad esempio, se si traccia una frequenza di questo tipo richieste/secondo, utilizzando probabilmente la media come aggregatore, il totale nella legenda non rappresenterà il numero totale di richieste. È solo la somma di tutti i punti dati ricevuti da Amazon Managed Grafana. 

### Nascondi serie
<a name="graph-panel-hide-series"></a>

Nasconde le serie quando tutti i valori di una serie di una query metrica hanno un valore specifico.
+  **Con solo valori null**: value=NULL (impostazione predefinita deselezionata)
+  **Con solo zeri: value=ZERO** (impostazione predefinita deselezionata)

### Regioni temporali
<a name="graph-panel-time-regions"></a>

È possibile evidenziare aree temporali specifiche sul grafico per facilitare la visualizzazione, ad esempio, dei fine settimana, degli orari lavorativi e degli orari non lavorativi. Tutte le aree temporali configurate si riferiscono all'ora UTC.

# Mappa termica
<a name="visualization-heatmap"></a>

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

La visualizzazione del pannello heatmap consente di visualizzare gli istogrammi nel tempo. Per ulteriori informazioni sugli istogrammi, vedere. [Introduzione agli istogrammi e alle mappe di calore](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)

## Opzioni relative agli assi
<a name="heatmap-axes-options"></a>

Usa queste impostazioni per regolare il modo in cui gli assi vengono visualizzati nella visualizzazione.

### Asse Y
<a name="heatmap-y-axis"></a>
+  **Unità**: l'unità di visualizzazione per il valore dell'asse y
+  **Scala**: la scala da utilizzare per il valore dell'asse y
  +  **lineare**: scala lineare 
  +  **log (base 2)** — Scala logaritmica con base 2
  +  **log (base 10)** — Scala logaritmica con base 10
  +  **log (base 32)** — Scala logaritmica con base 32
  +  **log (base 1024)** — Scala logaritmica con base 1024
+  **Y-Min** — Il valore y minimo (l'impostazione predefinita è auto)
+  **Y-Max** — Il valore y massimo (l'impostazione predefinita è auto)
+  **Decimali**: numero di decimali con cui eseguire il rendering dei valori dell'asse y (l'impostazione predefinita è auto)

### Bucket
<a name="heatmap-buckets"></a>

**Nota**  
Se il formato dei dati è **Time series buckets**, questa sezione non è disponibile.
+  **Benne dell'asse Y**: il numero di bucket in cui verrà suddiviso l'asse y.
+  **Dimensioni** ***: la dimensione di ogni secchio sull'asse y (visibile solo se la scala è lineare).*** Questa opzione ha la priorità rispetto ai bucket **dell'asse Y.**
+  **Fattore di divisione** — (visibile solo se la **scala** è *log (base 2)* o superiore). Per impostazione predefinita, Amazon Managed Grafana divide i valori y per base di log. Con questa opzione, puoi dividere ogni bucket predefinito nel numero di bucket specificato.
+  **Bucket dell'asse X**: il numero di bucket in cui verrà suddiviso l'asse x.
+  **Dimensioni: la dimensione** di ogni secchio sull'asse x. Numero o intervallo di tempo (10 secondi, 5 m, 1 ora, ecc.). Intervalli supportati: ms, s, m, h, d, w, M, y. Questa opzione ha la priorità rispetto ai **bucket ad asse X.**

#### Legato a secchio
<a name="heatmap-bucket-bound"></a>

Quando il formato dei dati è costituito da bucket di serie temporali, l'origine dati restituisce serie con nomi che rappresentano bucket bound. Tuttavia, a seconda dell'origine dei dati, un limite può essere superiore o inferiore. È possibile utilizzare questa opzione per modificare un tipo di rilegatura. Se è impostata l'opzione **Auto**, viene scelta un'opzione associata in base al tipo di origine dati dei pannelli.

#### Dimensione bucket
<a name="heatmap-bucket-size"></a>

Le opzioni Bucket count e size vengono utilizzate da Amazon Managed Grafana per calcolare le dimensioni di ogni cella nella mappa termica. Puoi definire la dimensione del bucket tramite count (la prima casella di input) o specificando un intervallo di dimensioni. Per l'asse y, l'intervallo di dimensioni è solo un valore. **Per l'X-bucket, puoi specificare un intervallo di tempo nell'input Size.** Ad esempio, è possibile impostare l'intervallo di tempo su. `1h` In questo modo le celle saranno larghe 1 ora sull'asse x.

#### Formato dei dati
<a name="heatmap-data-format"></a>

Scegliete un'opzione nell'elenco **Formato**.
+ **Serie temporali**: Amazon Managed Grafana fa il punto della situazione analizzando tutti i valori delle serie temporali. **Le dimensioni e gli intervalli dei bucket sono impostati nelle opzioni Bucket.**
+ Bucket di **serie temporali: ogni serie temporale rappresenta già un bucket** sull'asse y. Il nome della serie temporale (alias) deve essere un valore numerico che rappresenta l'intervallo superiore o inferiore del bucket. L'area di lavoro Grafana non prevede periodi fissi, quindi le opzioni relative alle dimensioni del bucket sono nascoste.

## Opzioni di visualizzazione
<a name="heatmap-display-options"></a>

Usa queste impostazioni per affinare la visualizzazione.

### Colori
<a name="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 all'estrema sinistra dello spettro rappresenta il conteggio minimo e il colore all'estrema 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à) 
  +  **Opacità**: valore del bucket rappresentato dall'opacità delle celle. Una 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 `1` di, si otterrà una scala esponenziale. Nel caso di`1`, la scala sarà la stessa di quella lineare.
    +  **Esponente**: valore dell'esponente, maggiore di. `0`
  +  **spectrum**: valore del bucket rappresentato dal colore della cella.
    +  **Schema**: se la modalità è **spettro**, seleziona una combinazione di colori.

### Scala di colori
<a name="heatmap-color-scale"></a>

Per impostazione predefinita, Amazon Managed Grafana calcola i colori delle celle in base ai valori minimi e massimi dei bucket. Con **Min** e **Max**, puoi sovrascrivere questi valori. Pensate al valore del bucket come asse z e Min e Max rispettivamente come Z-Min e Z-Max.
+  **Min**: valore minimo utilizzato per il calcolo del colore delle celle. Se il valore del bucket è inferiore a Min, viene mappato al colore minimo. Il valore predefinito è `series min value`.
+  **Max**: 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 predefinito è `series max value`. 

### Legenda
<a name="heatmap-legend"></a>

Scegli se visualizzare o meno la legenda della mappa termica sulla visualizzazione. 

### Bucket
<a name="heatmap-legend-buckets"></a>
+  **Nascondi zero**: non disegnare celle con valori pari a zero.
+  **Spazio**: imposta lo spazio tra le celle in pixel. L'impostazione predefinita è 1 pixel.
+  **Rotondo**: imposta la rotondità della cella in pixel. Il valore predefinito è 0.

### Tooltip
<a name="heatmap-tooltip"></a>
+  **Mostra il tooltip:** mostra il tooltip della mappa termica.
+  **Istogramma**: mostra l'istogramma dell'asse y nella descrizione del comando. L'istogramma rappresenta la distribuzione dei valori del bucket per il timestamp specifico.
+  **Decimali**: imposta il numero di decimali con cui eseguire il rendering del valore del bucket (l'impostazione predefinita è auto).

# Pannello istogramma
<a name="histogram-panel"></a>

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

La visualizzazione dell'istogramma calcola la distribuzione dei valori e li presenta come un grafico a barre. L'asse Y e l'altezza di ogni barra rappresentano il conteggio dei valori che rientrano in ciascuna parentesi, mentre l'asse X rappresenta l'intervallo di valori.

La visualizzazione dell'istogramma supporta le serie temporali e qualsiasi risultato di tabella con uno o più campi numerici.

## Opzioni di visualizzazione
<a name="histogram-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Dimensioni del secchio**

La dimensione dei secchi. Lascialo vuoto per il dimensionamento automatico dei secchi (\$1 10% dell'intera gamma).

**Offset del secchio**

Se il primo bucket non deve iniziare da zero. Un offset diverso da zero sposta la finestra di aggregazione. Ad esempio, i bucket di 5 dimensioni che sono 0—5, 5—10, 10—15 con un offset predefinito pari a 0 diventerebbero 2—7, 7—12, 12—17 con un offset di 2; offset di 0, 5 o 10, in questo caso, di fatto non servirebbero a nulla. In genere, questa opzione verrebbe utilizzata con una dimensione del bucket definita in modo esplicito anziché in modo automatico. Affinché questa impostazione abbia effetto, la quantità di offset deve essere maggiore di 0 e minore della dimensione del bucket; i valori al di fuori di questo intervallo avranno lo stesso effetto dei valori all'interno di questo intervallo.

**Combina serie**

Questo unirà tutte le serie e i campi in un istogramma combinato.

**La larghezza della linea** controlla la larghezza della linea delle barre.

**L'opacità di riempimento** controlla l'opacità di riempimento delle barre.

La modalità **gradiente imposta la modalità di riempimento** del gradiente. Il gradiente di riempimento si basa sul colore della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard. L'aspetto del gradiente è influenzato dall'impostazione dell'opacità di riempimento.
+  **Nessuno**: nessun riempimento a gradiente, questa è l'impostazione predefinita.
+  **Opacità: la** trasparenza del gradiente viene calcolata in base ai valori sull'asse Y. L'opacità del riempimento aumenta con i valori sull'asse Y.
+  **Tonalità**: il colore del gradiente viene generato in base alla tonalità del colore della linea.

**Modalità tooltip** Quando si posiziona il cursore sul grafico, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip:
+  **Singola**: il tooltip al passaggio del mouse mostra solo la serie su cui stai passando il mouse.
+  **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie presenti nella visualizzazione. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+  **Nascosto**: non visualizza il tooltip. 

**Nota**  
Utilizzate un override per nascondere le singole serie dal tooltip.

## Opzioni relative alla legenda
<a name="histogram-legend"></a>

Quando l'opzione legenda è abilitata, può mostrare le mappature dei valori o le parentesi di soglia. Per mostrare le mappature dei valori nella legenda, è importante che l'opzione Combinazione di colori nelle opzioni standard sia impostata su Colore singolo o Palette classica. Per visualizzare le parentesi di soglia nella legenda, impostate lo schema di colori su Dalle soglie.

**Modalità Legenda** Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Si tratta di una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda** Scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

**Calcoli della legenda**

Scegli quali calcoli mostrare nella legenda. Per ulteriori informazioni, consulta [Elenco dei calcoli](list-of-calculations.md).

# Pannello Logs
<a name="logs-panel"></a>

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

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.

## Opzioni di visualizzazione
<a name="logs-panel-display-options"></a>

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.
+  **Avvolgi linee**: attiva l'avvolgimento delle linee. 
+  **Ordine**: visualizza i risultati in ordine temporale decrescente o crescente. L'impostazione predefinita è **Decrescente, che** mostra per primi i log più recenti. Imposta su **Ascendente** per mostrare per prime le righe di registro più vecchie.

# Pannello delle notizie
<a name="news-panel"></a>

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

Questo pannello mostra un feed RSS. Per impostazione predefinita, visualizza articoli dal blog Grafana Labs.

Nella sezione **Display**, nel campo **URL**, inserisci l'URL di un feed RSS. Questo tipo di pannello non accetta altre domande.

# Pannello grafico dei nodi (Beta)
<a name="node-graph-panel"></a>

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

Il pannello del grafico dei nodi visualizza grafici o reti diretti. Utilizza il layout a forza diretta per posizionare efficacemente i nodi in modo da facilitare la visualizzazione di mappe infrastrutturali complesse, gerarchie o diagrammi di esecuzione.

## Requisiti dei dati
<a name="node-graph-panel-requirements"></a>

Il pannello del grafico dei nodi richiede una forma specifica dei dati per poterne visualizzare i nodi e i bordi. Non tutte le fonti di dati o le query possono essere visualizzate in questo pannello.

*La visualizzazione del grafico dei nodi è composta da *nodi e bordi*.*
+ Un *nodo* viene visualizzato come un cerchio. Un nodo può rappresentare un'applicazione, un servizio o qualsiasi altra cosa rilevante dal punto di vista dell'applicazione.
+ Un *bordo* viene visualizzato come una linea che collega due nodi. La connessione potrebbe essere una richiesta, un'esecuzione o qualche altra relazione tra i due nodi.

## Nodi
<a name="node-graph-panel-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.

## Edges
<a name="node-graph-panel-edges"></a>

I bordi possono anche mostrare statistiche quando si passa il mouse sopra lo spigolo. 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).

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.

## Navigazione nel grafico del nodo
<a name="node-graph-panel-navigation"></a>

È possibile eseguire una panoramica all'interno del grafico del nodo scegliendo l'esterno di qualsiasi nodo o bordo e trascinando il mouse.

È possibile eseguire lo zoom utilizzando i pulsanti nell'angolo superiore sinistro del grafico del nodo.

# Pannello grafico a torta
<a name="pie-chart-panel"></a>

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

Il grafico a torta mostra le serie ridotte, o i valori di una serie, di una o più interrogazioni, in relazione tra loro, come fette di torta. La lunghezza dell'arco, l'area e l'angolo centrale di una sezione sono tutti proporzionali al valore delle sezioni, 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.

Le visualizzazioni dei grafici a torta consentono di applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md). 
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md). 
+  [Soglie](thresholds.md).

## Opzioni
<a name="pie-chart-panel-options"></a>

È possibile utilizzare le seguenti opzioni per affinare la visualizzazione.
+  **Mostra**: scegli quante informazioni mostrare. **Calculate** 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, vedere[Elenco dei calcoli](list-of-calculations.md).
+  **Limite**: quando si visualizzano tutti i valori di una singola serie, ciò limita il numero di valori visualizzati.
+  **Campi**: seleziona i campi da visualizzare nella visualizzazione.
  + **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.

## Etichette
<a name="pie-charts-panel-labels"></a>

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. 

Le etichette vengono visualizzate in bianco sul corpo del grafico. Potrebbe essere necessario selezionare colori più scuri del grafico per renderli più visibili. I nomi o i numeri lunghi potrebbero essere tagliati.

## Posizionamento e valori della legenda
<a name="pie-charts-panel-legend"></a>

Scegli dove visualizzare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico. 

È possibile selezionare più di un valore da visualizzare nella legenda. **Percentuale è la percentuale del totale e **Valore è il valore** numerico grezzo.**

# Pannello Plotly
<a name="plotly-panel"></a>

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

Il pannello Plotly esegue il rendering dei grafici utilizzando Plotly, una libreria grafica javascript [open source](https://plotly.com/javascript/).

I campi **Data**, **Layout** e **Config** corrispondono ai parametri comuni descritti nella documentazione di [Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Devono essere in formato JSON.

I dati forniti dall'origine dati possono essere trasformati tramite uno script definito dall'utente prima di essere inseriti nel grafico Plotly. Lo script include 2 argomenti.
+ `data`— Dati restituiti dalla fonte di dati.
+ `variables`— Un oggetto che contiene [le variabili Grafana](templates-and-variables.md) nella dashboard corrente (variabili utente e queste poche variabili globali:`__from`, `__to``__interval`, e`__interval_ms`).

Lo script deve restituire un oggetto con una o più delle seguenti proprietà: `data``layout`, `config` e`frames`. Di seguito è riportato un esempio di :

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

L'oggetto restituito dallo script e il JSON fornito nei campi *Data*, *Layout* e *Config* verranno uniti (unione profonda).

Se non viene fornito alcuno script, il pannello utilizzerà solo *i campi Data*, *Layout* e *Config.*

# Pannello Sankey
<a name="sankey-panel"></a>

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

Il pannello Sankey mostra i diagrammi di Sankey, utili per visualizzare i dati di flusso, con la larghezza del flusso proporzionale alla metrica selezionata. L'immagine seguente mostra un diagramma di Sankey con due gruppi di origine e destinazione.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/sankey-panel.png)


**Come funziona**

Il pannello sankey richiede almeno 2 colonne di dati, un'origine e una destinazione per i flussi. La tua query dovrebbe raggruppare i dati in almeno due gruppi. Il pannello disegnerà i collegamenti dalla prima colonna di punti dati all'ultima nell'ordine della query. Lo spessore dei link sarà proporzionato al valore assegnato dalla metrica della query.

**Personalizzazione**
+ **Collegamenti**: attualmente esistono due opzioni per il colore del collegamento: multiplo o singolo. Per impostazione predefinita, è multicolore. Per scegliere un solo colore per i collegamenti, attiva l'opzione **Solo colore a collegamento singolo e scegli il tuo colore** dal selettore di colori di Grafana.
+ **Nodi****: puoi cambiare il colore dei nodi rettangolari modificando l'opzione Colore del nodo**
+ **Larghezza del nodo**: la larghezza dei nodi può essere regolata con il cursore **Larghezza del nodo** o inserendo un numero nella casella di immissione. Questo numero deve essere un numero intero.
+ **Imbottitura dei nodi**: la spaziatura verticale tra i nodi può essere regolata con il cursore **Node Padding** o inserendo un numero nella casella di immissione. Questo numero deve essere un numero intero. Se i tuoi link sono troppo sottili, prova a modificare questo numero
+ **Intestazioni**: le intestazioni delle colonne possono essere modificate utilizzando l'opzione **Display Name** override nel pannello dell'editor. **Saranno dello stesso colore che hai scelto per il colore del testo**
+ **Layout Sankey**: il layout dei collegamenti Sankey può essere leggermente modificato utilizzando il cursore di **iterazione del layout**. Questo numero deve essere un numero intero ed è il numero di iterazioni di rilassamento utilizzate per generare il layout.

# Pannello Scatter
<a name="scatter-panel"></a>

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

Il pannello a dispersione mostra un X/Y grafico a dispersione per i dati della tabella con un'interfaccia più semplice rispetto ad altri pannelli grafici. A differenza del pannello grafico, il pannello a dispersione non richiede che i dati appartengano a una serie temporale. Il pannello a dispersione richiede un set di dati in formato tabella con due o più colonne numeriche di dati.

Uno di questi può essere assegnato all'asse X. Uno o più valori possono essere assegnati a una serie di valori dell'asse Y e i dati risultanti possono essere tracciati come una serie di punti. Ogni serie può facoltativamente mostrare anche una linea di regressione utilizzando uno dei numerosi migliori adattamenti statistici.

**Creazione di un pannello a dispersione**

La procedura seguente descrive come creare un grafico a dispersione utilizzando il pannello a dispersione. Per questo esempio, supponiamo che esistano dati, come nella tabella seguente, denominati `HEIGHT` con tre colonne di valori numerici, `Age` `Boys``Girls`, e che mostrino l'altezza media di ragazzi e ragazze per età.


| Età | Altezza del ragazzo | Altezza della ragazza | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121,1  |  120,8  | 
|  8  |  126,3  |  126  | 
|  9  |  131,3  |  131,3  | 
|  10  |  136,2  |  137,1  | 
|  11  |  141,2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152,6  | 
|  14  |  159,9  |  155,1  | 
|  15  |  164,4  |  156,7  | 
|  16  |  167,3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Per creare un grafico a dispersione con il pannello a dispersione**

1. Nella dashboard Grafana, scegli **Aggiungi** pannello. Per maggiori dettagli sull'aggiunta di pannelli, consulta[Aggiungere un pannello](add-a-panel-to-a-dashboard.md).

1. Per la Query, scrivi una query che restituisca i dati necessari. In questo caso, dovresti usare una query come`SELECT * FROM HEIGHT`.

1. Seleziona la visualizzazione **Scatter**.

Questo creerà un grafico a dispersione, utilizzando la prima colonna come asse X e le altre colonne numeriche come assi Y.

**Opzioni di configurazione**

Il pannello a dispersione offre le seguenti quattro opzioni di configurazione personalizzate.
+ **Asse X**: è possibile scegliere quale campo utilizzare come asse X, nonché le estensioni, il titolo e le informazioni di visualizzazione per l'asse.
+ **Asse Y**: è possibile scegliere quali campi visualizzare sull'asse Y, incluse le opzioni di visualizzazione per ogni campo e le informazioni sulle estensioni e sul titolo per l'asse. Puoi anche scegliere di visualizzare una linea di regressione per ogni campo. Vedi le seguenti informazioni per maggiori dettagli sulla configurazione della linea di regressione.
+ **Legenda**: puoi attivare o disattivare una legenda per il pannello, nonché scegliere la dimensione del testo nella legenda.
+ **Visualizzazione**: puoi impostare altre opzioni per il grafico, tra cui il colore della griglia e lo stile del bordo.

**Configurazione della linea di regressione**

Ogni set di dati sull'asse Y può visualizzare una linea, oltre ai singoli punti. Sono disponibili cinque opzioni per il tipo di linea.
+ **Nessuno**: non visualizza una linea di regressione.
+ **Semplice**: visualizza una linea di regressione che collega i punti del set di dati.
+ **Lineare**: visualizza una linea retta, utilizzando il metodo best-fit dei minimi quadrati.
+ Esponenziale: visualizza una linea di **regressione esponenziale più** adatta.
+ **Potenza: visualizza la linea di regressione** più adatta alla potenza.

# Pannello Stat
<a name="stat-panel"></a>

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

Il pannello stat mostra un unico grande valore stat con un grafico sparkline opzionale. È possibile controllare lo sfondo o il colore del valore utilizzando delle soglie.

Per impostazione predefinita, il pannello delle statistiche mostra una delle seguenti schermate:
+ Solo il valore per una singola serie o campo.
+ Valore e nome di più serie o campi.

È possibile utilizzare l'opzione **Modalità testo** per controllare se il testo viene visualizzato o meno.

## Opzioni relative ai dati e ai campi
<a name="stat-panel-data-and-field-options"></a>

Le visualizzazioni delle statistiche consentono di applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md).
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md).
+  [Soglie](thresholds.md).

## Regolazione automatica del layout
<a name="stat-panel-automatic-layout-adjustment"></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 visualizzazione
<a name="stat-panel-display-options"></a>

Utilizza le seguenti opzioni per perfezionare la visualizzazione:
+  **Mostra**: scegli come Amazon Managed Grafana visualizza i tuoi dati.
  +  **Calcola**: mostra un valore calcolato in base a tutte le righe.
    +  **Calcolo**: seleziona un calcolo da applicare. Per informazioni sui calcoli disponibili, vedere[Elenco dei calcoli](list-of-calculations.md).
  +  **Tutti i valori**: mostra una statistica separata per ogni riga.
    +  **Limite**: specifica il numero massimo di righe da visualizzare.
+  **Campi**: seleziona un nome di campo o un tipo di campo (inclusi **Tutti i campi o Campi** **numerici**) da includere in questo pannello.
+  **Valore**: seleziona una funzione di riduzione che Amazon Managed Grafana utilizzerà per ridurre molti campi a un unico valore. Scegli la lista dei **valori** per visualizzare le funzioni e le brevi descrizioni. 
+  **Orientamento**: scegli una direzione di impilamento.
  +  **Auto**: Amazon Managed 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**: puoi utilizzare l'opzione **Modalità testo** per controllare il testo visualizzato dal pannello. Se solo il nome e il colore sono importanti e il valore non lo è, cambiate la **modalità Testo** in **Nome**. Il valore viene ancora utilizzato per determinare il colore e viene 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 visualizzato nella descrizione comandi.
  +  **Valore e nome**: mostra sempre il valore e il nome.
  +  **Nome**: mostra il nome anziché il valore. Il valore viene visualizzato nel tooltip.
  +  **Nessuno**: non mostra nulla (vuoto). Il nome e il valore vengono visualizzati nel tooltip.
+  **Modalità colore**: scegli una modalità di colore.
  +  **Valore**: colora solo il valore e l'area del grafico.
  +  **Sfondo**: colora anche lo sfondo.
+  **Modalità grafico**: scegli una modalità grafico.
  +  **Nessuno**: nasconde il grafico e mostra solo il valore.
  +  **Area**: mostra il grafico dell'area al di sotto del valore. Questa opzione richiede che la query restituisca una colonna temporale.
+  Modalità di **allineamento: 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.

# Pannello della cronologia dello stato
<a name="state-timeline-panel"></a>

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

La visualizzazione del pannello della timeline dello stato mostra cambiamenti di stato discreti nel tempo. Ogni campo o serie viene visualizzato come una banda orizzontale unica. Le regioni statali possono essere renderizzate con o senza valori. Questo pannello funziona bene con stringhe o stati booleani, ma può essere utilizzato anche con serie temporali. Se utilizzate con serie temporali, le soglie vengono utilizzate per trasformare i valori numerici in regioni statali discrete.

## Opzioni della cronologia dello stato
<a name="state-timeline-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Unisci valori consecutivi uguali**

Controlla se Grafana unisce valori identici se sono uno accanto all'altro.

**Mostra valori**

Controlla se i valori vengono visualizzati all'interno delle regioni statali. Auto renderizzerà i valori se c'è spazio sufficiente.

**Allinea i valori**

Controlla l'allineamento dei valori all'interno delle regioni statali.

**Altezza delle righe**

Controlla lo spazio tra le righe. 1 = nessuno spazio = 0,5 = 50% spazio.

**Larghezza della linea**

Controlla la larghezza delle linee delle regioni statali.

**Riempi l'opacità**

Controlla l'opacità delle regioni statali.

## Mappature dei valori
<a name="state-timeline-valuemap"></a>

Per assegnare colori a valori booleani o stringhe, usa. [Mappatura dei valori](field-options-overrides.md#value-mapping)

## Dati di serie temporali con soglie
<a name="state-timeline-threshold"></a>

Il pannello può essere utilizzato anche con i dati delle serie temporali. In questo caso, le soglie vengono utilizzate per trasformare le serie temporali in regioni statali a colori discreti.

## Opzioni relative alla legenda
<a name="state-timeline-legend"></a>

Quando l'opzione legenda è abilitata, può mostrare le mappature dei valori o le parentesi di soglia. Per mostrare le mappature dei valori nella legenda, è importante che l'opzione Combinazione di colori nelle opzioni Standard sia impostata su Colore singolo o Palette classica. Per visualizzare le parentesi di soglia nella legenda, impostate lo schema di colori su Dalle soglie.

**Modalità Legenda** Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Questa è una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda** Scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

# Pannello della cronologia dello stato
<a name="status-history-panel"></a>

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

La visualizzazione della cronologia dello stato mostra gli stati periodici nel tempo. Ogni campo o serie viene visualizzato come una riga orizzontale. I riquadri vengono renderizzati e centrati attorno a ciascun valore.

La visualizzazione della cronologia dello stato funziona con campi stringhe, booleani e numerici o serie temporali. È richiesto un campo orario. È possibile utilizzare le mappature dei valori per colorare le stringhe o assegnare valori di testo a intervalli numerici.

## Opzioni di visualizzazione
<a name="status-timeline-options"></a>

Usa queste opzioni per perfezionare le tue visualizzazioni:

**Mostra valori**

Controlla se i valori vengono visualizzati all'interno delle caselle dei valori. Auto renderizzerà i valori se c'è spazio sufficiente.

La **larghezza della colonna** controlla la larghezza dei riquadri. 1=larghezza massima e 0=larghezza minima.

**La larghezza della linea controlla la larghezza** della linea delle regioni statali.

**L'opacità di riempimento controlla l'opacità** di riempimento delle regioni statali.

## Mappature dei valori
<a name="status-history-valuemap"></a>

Per assegnare colori a valori booleani o stringhe, usa. [Mappatura dei valori](field-options-overrides.md#value-mapping)

## Dati di serie temporali con soglie
<a name="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="status-history-legend"></a>

Quando l'opzione legenda è abilitata, può mostrare le mappature dei valori o le parentesi di soglia. Per mostrare le mappature dei valori nella legenda, è importante che l'opzione Combinazione di colori nelle opzioni Standard sia impostata su Colore singolo o Palette classica. Per visualizzare le parentesi di soglia nella legenda, imposta lo schema di colori su Dalle soglie.

**Modalità Legenda** Utilizza queste impostazioni per rifinire l'aspetto della legenda nella visualizzazione.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Si tratta di una modalità di visualizzazione predefinita della legenda.
+  **Tabella**: visualizza la legenda come tabella.
+  **Nascosto**: nasconde la legenda.

**Posizionamento della legenda** Scegli dove posizionare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico.

# Pannello da tavolo
<a name="table-panel"></a>

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

Il pannello delle tabelle supporta diverse modalità per le serie temporali e per le tabelle, le annotazioni e i dati JSON non elaborati. Questo pannello fornisce anche opzioni di formattazione della data, formattazione dei valori e colorazione.

## Opzioni relative ai dati e ai campi
<a name="data-and-field-options"></a>

Con le visualizzazioni delle tabelle puoi applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md).
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md).
+  [Soglie](thresholds.md).

## Opzioni di visualizzazione
<a name="display-options"></a>
+  **Mostra intestazione**: mostra o nasconde i nomi delle colonne importati dalla tua fonte di dati.
+  **Ordinamento crescente/decrescente**: scegli il titolo di una colonna per modificare l'ordinamento da predefinito a decrescente a crescente. Ogni volta che scegliete, l'ordinamento passa all'opzione successiva del ciclo. Puoi eseguire l'ordinamento in base a una colonna alla volta.
+  [Opzioni dei campi della tabella](#table-field-options)— Modifica le opzioni dei campi come la larghezza delle colonne, l'allineamento e la modalità di visualizzazione delle celle.
+  [Filtra le colonne della tabella](#filter-table-columns)— Modifica temporanea della modalità di visualizzazione dei dati delle colonne. Ad esempio, è possibile ordinare i valori dal più alto al più basso o nascondere valori specifici.

## Supporto per le annotazioni
<a name="annotation-support"></a>

Le annotazioni non sono attualmente supportate nel nuovo pannello della tabella.

## Opzioni dei campi della tabella
<a name="table-field-options"></a>

Questa sezione spiega tutte le opzioni disponibili per i campi della tabella. Le opzioni sono elencate nello stesso ordine di Amazon Managed Grafana. Le opzioni elencate in questo argomento si applicano solo alle visualizzazioni dei pannelli tabellari.

La maggior parte delle opzioni di campo non influirà sulla visualizzazione finché non scegliete un campo diverso dalla casella delle opzioni di campo che state modificando o premete Invio.

Per ulteriori informazioni sull'applicazione di queste opzioni, consulta [Configura tutti i campi](field-options-overrides.md#configure-all-fields) e[Configura campi specifici](field-options-overrides.md#configure-specific-fields).

### Allineamento delle colonne
<a name="column-alignment"></a>

Scegli in che modo Amazon Managed Grafana deve allineare il contenuto delle celle:
+ Auto (impostazione predefinita)
+ Sinistra
+ center
+ Right

### Larghezza della colonna
<a name="column-width"></a>

Per impostazione predefinita, Amazon Managed Grafana calcola automaticamente la larghezza delle colonne in base al contenuto delle celle. In questa opzione di campo, puoi sovrascrivere l'impostazione e definire la larghezza di tutte le colonne in pixel.

Ad esempio, se si immette `100` nel campo, tutte le colonne verranno impostate su una larghezza di 100 pixel quando si sceglie all'esterno del campo.

### Modalità di visualizzazione delle celle
<a name="cell-display-mode"></a>

Per impostazione predefinita, Amazon Managed Grafana sceglie automaticamente le impostazioni di visualizzazione. Puoi sovrascrivere le impostazioni scegliendo una delle seguenti opzioni per modificare tutti i campi.

**Nota**  
Se le imposti nella scheda **Campo**, le modalità di visualizzazione si applicano a tutti i campi, incluso il campo dell'ora. Molte opzioni funzionano meglio se le imposti nella scheda **Ignora**.

#### Testo a colori
<a name="color-text"></a>

Se sono impostate delle soglie, il testo del campo viene visualizzato con il colore di soglia appropriato.

#### Colore dello sfondo
<a name="color-background"></a>

Se sono impostate delle soglie, lo sfondo del campo viene visualizzato con il colore di soglia appropriato.

#### Indicatore del gradiente
<a name="gradient-gauge"></a>

I livelli di soglia definiscono un gradiente.

#### Indicatore LCD
<a name="lcd-gauge"></a>

L'indicatore è suddiviso in piccole celle accese o spente.

#### Visualizzazione JSON
<a name="json-view"></a>

Il valore viene visualizzato in formato codice. Se un valore è un oggetto, la vista JSON che consente di sfogliare l'oggetto JSON viene visualizzata quando si fa una pausa sul valore.

### Filtro a colonna
<a name="column-filter"></a>

## Filtra le colonne della tabella
<a name="filter-table-columns"></a>

Se attivi il **filtro a colonne** nelle opzioni della tabella, puoi filtrare le opzioni della tabella. Per ulteriori informazioni, consulta [Opzioni dei campi della tabella](#table-field-options).

### Attiva il filtraggio delle colonne
<a name="turn-on-column-filtering"></a>

1. In Amazon Managed Grafana, scegli la dashboard che mostra la tabella con le colonne che desideri filtrare.

1. Nel pannello della tabella che desideri filtrare,[Apertura dell'editor dei pannelli](AMG-panel-editor.md#open-the-panel-editor).

1. Scegli la scheda **Campo**.

1. Nelle opzioni della **tabella**, attiva l'opzione **Filtro a colonne**.

Accanto al titolo di ogni colonna viene visualizzata un'icona di filtro.

### Filtra i valori delle colonne
<a name="filter-column-values"></a>

Per filtrare i valori delle colonne, scegli l'icona del filtro (imbuto) accanto al titolo di una colonna. L'area di lavoro Grafana mostra le opzioni di filtro per quella colonna.

Seleziona le caselle di controllo accanto ai valori che desideri visualizzare. Inserisci il testo nel campo di ricerca in alto per mostrare quei valori sul display in modo da poterli selezionare anziché scorrere per trovarli.

### Cancella i filtri delle colonne
<a name="clear-column-filters"></a>

Le colonne con filtri applicati hanno un imbuto blu visualizzato accanto al titolo.

Per rimuovere il filtro, scegliete l'icona blu dell'imbuto, quindi scegliete **Cancella** filtro.

# Pannello di testo
<a name="text-panel"></a>

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

Puoi utilizzare il pannello di testo per creare pannelli informativi e descrittivi per le tue dashboard.

In **Modalità**, seleziona se desideri utilizzare markdown o HTML per lo stile del testo, quindi inserisci il contenuto nella casella sottostante. L'area di lavoro Grafana include un titolo e un paragrafo per aiutarti a iniziare, oppure puoi incollare il contenuto da un altro editor.

# Pannello delle serie temporali
<a name="time-series-panel"></a>

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

Il pannello delle serie temporali può renderizzare una serie temporale come una linea, un percorso di punti o una serie di barre. Questo tipo di grafico è abbastanza versatile da visualizzare quasi tutti i dati di serie temporali.

**Nota**  
È possibile migrare le visualizzazioni del pannello Graph alle visualizzazioni delle serie temporali. **Per migrare, nella scheda **Pannello, scegliete Visualizzazione delle serie temporali**.** Grafana trasferisce tutte le impostazioni applicabili.

Le visualizzazioni delle serie temporali consentono di applicare le seguenti opzioni:
+  [Trasformazioni](panel-transformations.md) 
+  [Opzioni e sostituzioni dei campi](field-options-overrides.md) 
+  [Soglie](thresholds.md) 

È inoltre possibile utilizzare le opzioni di campo per creare diversi tipi di grafici o regolare gli assi.

Usa queste impostazioni per affinare la visualizzazione.

## modalità Tooltip
<a name="time-series-panel-tooltip"></a>

Quando si posiziona il cursore sul grafico, Grafana può visualizzare i tooltip. Scegli come si comportano i tooltip:
+  **Singola**: il tooltip al passaggio del mouse mostra solo la serie su cui stai passando il mouse.
+  **Tutte**: il tooltip posizionato al passaggio del mouse mostra tutte le serie presenti nel grafico. Grafana evidenzia la serie su cui stai passando il mouse in grassetto nell'elenco delle serie nel tooltip.
+  **Nascosto**: non visualizza il tooltip. 

## Modalità e posizionamento della legenda
<a name="time-series-panel-legend"></a>

Scegli come appare la legenda.
+  **Elenco**: visualizza la legenda sotto forma di elenco. Questa è l’impostazione predefinita.
+  **Tabella**: visualizza la legenda come tabella. 
+  **Nascosto**: nasconde la legenda.

Scegli dove visualizzare la legenda.
+  **In basso**: sotto il grafico.
+  A **destra**: a destra del grafico. 

## Calcoli della legenda
<a name="time-series-panel-legend-calculations"></a>

Scegli quali calcoli mostrare nella legenda. Per ulteriori informazioni, consulta [Elenco dei calcoli](list-of-calculations.md).

# Grafica le serie temporali come linee
<a name="time-series-graph-lines"></a>

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

Questa sezione spiega come utilizzare le opzioni dei campi delle serie temporali per visualizzare i dati delle serie temporali come linee e illustra a cosa servono le opzioni.

**Crea il pannello**

1. Crea un pannello, selezionando la visualizzazione delle **serie temporali**. Per ulteriori informazioni, consulta [Aggiungere un pannello](add-a-panel-to-a-dashboard.md).

1. Nell'**editor del pannello**, scegli **Campo**.

1. In **Stile**, scegliete **Linee**.

## Definisci lo stile delle linee
<a name="time-series-graph-lines-style"></a>

Esistono diverse opzioni per lo styling delle linee.
+ **Interpolazione lineare**: scegli come Grafana interpola la linea della serie. **Le scelte sono **Linear**, **Smooth**, **Step before e Step after**.**
+ **Spessore della linea**: imposta lo spessore della linea tra 0 e 10 pixel.
+ **Opacità di riempimento**: imposta l'opacità del riempimento della serie, da 0 a 100 percento.
+ Modalità **gradiente: imposta la modalità di riempimento** del gradiente. Il gradiente di riempimento si basa sul colore della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard.

  L'aspetto del gradiente è influenzato dall'impostazione dell'opacità di **riempimento**.

  ****Le scelte per il riempimento a gradiente sono **Nessuno**, Opacità e Tonalità.**** Con **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. Con **Hue**, il colore del gradiente viene generato in base alla tonalità del colore della linea.
+ **Stile della linea**: imposta lo stile della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard.

  L'aspetto dello stile della linea è influenzato dalle impostazioni per **Spessore della linea** e **Opacità di riempimento**.

  **Le scelte per lo stile della linea sono **Solid**, **Dash e Dots**.**
+ **Valori nulli**: scegli come vengono visualizzate le lacune nei dati. I valori nulli possono essere collegati per formare una linea continua o, facoltativamente, impostare una soglia oltre la quale gli spazi vuoti nei dati non devono più essere collegati. Puoi scegliere di **Non connettere mai** i punti dati con gli spazi vuoti, Connetti **sempre** i punti dati con gli spazi vuoti o impostare una **soglia** alla quale le lacune nei dati non devono più essere collegate.
+ **Mostra punti**: scegli quando mostrare i punti sul grafico. Le scelte sono **Auto**, **Sempre** e **Mai**.

## Compila i campi sottostanti
<a name="time-series-panel-legend-fillbelow"></a>

Questa opzione è disponibile solo nella scheda Sostituzioni.

**Per riempire l'area tra due serie**

1. Seleziona i campi da compilare di seguito.

1. In **Aggiungi proprietà sostitutiva**, scegli **Compila di seguito per**.

1. Seleziona la serie in cui desideri che il riempimento si fermi.

# Grafica le serie temporali come barre
<a name="time-series-graph-bars"></a>

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

Questa sezione spiega come utilizzare le opzioni dei campi delle serie temporali per visualizzare i dati delle serie temporali come barre e illustra a cosa servono le opzioni.

**Crea il pannello**

1. Crea un pannello, selezionando la visualizzazione delle **serie temporali**. Per ulteriori informazioni, consulta [Aggiungere un pannello](add-a-panel-to-a-dashboard.md).

1. Nell'**editor del pannello**, scegli **Campo**.

1. In **Stile**, scegli **Barre**.

## Definisci lo stile delle barre
<a name="time-series-graph-bars-style"></a>

Esistono diverse opzioni per lo styling delle barre.
+ **Allineamento della barra**: imposta la posizione della barra rispetto a un punto dati. **Le scelte sono **Prima**, **Centro** e Dopo.**
+ **Spessore della linea**: imposta lo spessore dei contorni delle barre tra 0 e 10 pixel.
+ **Opacità di riempimento**: imposta l'opacità del riempimento della barra, da 0 a 100 percento.
+ Modalità **gradiente: imposta la modalità di riempimento** del gradiente. Il gradiente di riempimento si basa sul colore della linea. Per cambiare il colore, usa l'opzione del campo Schema di colori standard.

  L'aspetto del gradiente è influenzato dall'impostazione dell'opacità di **riempimento**.

  ****Le scelte per il riempimento a gradiente sono **Nessuno**, Opacità e Tonalità.**** Con **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. Con **Hue**, il colore del gradiente viene generato in base alla tonalità del colore della linea.
+ **Mostra punti**: scegli quando mostrare i punti sul grafico. Le scelte sono **Auto**, **Sempre** e **Mai**.

# Grafica le serie temporali come punti
<a name="time-series-graph-points"></a>

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

Questa sezione spiega come utilizzare le opzioni dei campi delle serie temporali per visualizzare i dati delle serie temporali come punti e illustra a cosa servono le opzioni.

**Crea il pannello**

1. Crea un pannello, selezionando la visualizzazione delle **serie temporali**. Per ulteriori informazioni, consulta [Aggiungere un pannello](add-a-panel-to-a-dashboard.md).

1. Nell'**editor del pannello**, scegli **Campo**.

1. In **Stile**, scegli **Punti**.

## Definisci lo stile dei punti
<a name="time-series-graph-points-style"></a>

Quando rappresentate graficamente come punti, potete scegliere la dimensione in punti.
+ **Dimensione in punti**: scegli la dimensione in punti, tra 1 e 40 pixel di diametro.

# Modifica la visualizzazione degli assi
<a name="time-series-change-axis"></a>

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

Questa sezione spiega come utilizzare le opzioni del campo Time series per controllare la visualizzazione degli assi nella visualizzazione e illustra cosa fanno le opzioni degli assi.

Esistono diverse opzioni per gli assi.
+ **Posizionamento dell'asse Y**: imposta il posizionamento dell'asse y. **Le scelte sono **Sinistra**, **Destra** e Nascosta.**
+ **Etichetta dell'asse Y**: imposta un'etichetta di testo per l'asse y. Se hai più di un asse y, puoi utilizzare la scheda **Ignora** per assegnare loro etichette diverse.
+ **Larghezza**: imposta la larghezza fissa dell'asse. Per impostazione predefinita, l'area di lavoro Grafana calcola dinamicamente la larghezza dell'asse. Impostando la larghezza dell'asse, i dati con tipi di assi diversi 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**: imposta **Soft min o Soft** **max** per un migliore controllo dei limiti dell'asse y. Per impostazione predefinita, l'area di lavoro Grafana imposta automaticamente l'intervallo per l'asse y in base ai dati.

  Le impostazioni **Soft min** o **Soft max** possono impedire che i blip appaiano come 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.
+ Scala: **imposta la scala da utilizzare** per i valori dell'asse y. Le scelte sono **lineari** e **logaritmiche**.

# Grafico delle serie temporali impilate
<a name="time-series-stacked"></a>

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

Questa sezione spiega come utilizzare le opzioni dei campi del pannello Serie temporali per controllare l'impilamento delle serie e illustra a cosa servono le opzioni di impilamento. 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. [Puoi leggere di più sul motivo per cui lo stacking potrebbe non essere l'approccio migliore qui: The Issue with Stacking.](https://www.data-to-viz.com/caveat/stacking.html)

# Serie impilate in gruppi
<a name="time-series-stacked-groups"></a>

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

L'opzione Stacking Group è disponibile solo come alternativa.

**Per impilare le serie nello stesso gruppo**

1. **Nella sezione Sostituzioni, crea un campo Override per l'opzione Stack series.**

1. **Scegli la modalità di impilamento 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 si crea un override.

# Soglie
<a name="thresholds"></a>

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

Le soglie impostano il colore del testo del valore o dello sfondo a seconda delle condizioni definite.

È possibile definire le soglie in due modi:
+ Le soglie **assolute** sono definite in base a un numero, ad esempio 80 su una scala da 1 a 150.
+ Le soglie **percentuali** sono definite in relazione al minimo o al massimo, ad esempio l'80%.

È possibile applicare soglie alle seguenti visualizzazioni:
+ [Pannello calibro a barra](alert-panel-bar-gauge-panel.md) 
+  [Pannello del calibro](gauge-panel.md) 
+  [Pannello grafico](graph-panel.md)
+  [Pannello Stat](stat-panel.md)
+  [Pannello da tavolo](table-panel.md)

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

Nelle visualizzazioni che lo supportano, Amazon Managed Grafana imposta il seguente valore di soglia predefinito: 80 = rosso; Base = verde; Mode = Absolute.

Il valore **Base** rappresenta l'infinito negativo. In genere è il colore *giusto*.

## Aggiungere una soglia
<a name="add-a-threshold"></a>

Puoi aggiungere tutte le soglie che desideri a un pannello. L'area di lavoro Grafana ordina automaticamente le soglie dal valore più alto al più basso.

**Nota**  
Queste istruzioni si applicano solo alle visualizzazioni di statistiche, indicatori, indicatori a barre e tabelle.

1. Scegli il pannello a cui vuoi aggiungere una soglia.

1. Scegli la scheda **Campo**.

1. Scegli **Aggiungi soglia**.

   Amazon Managed Grafana aggiunge una soglia con valori numerici e cromatici suggeriti. 

1. Accetta i consigli o modifica la nuova soglia.
   +  **Modifica colore**: scegli il punto di colore che desideri modificare, quindi seleziona un nuovo colore.
   +  **Modifica numero**: scegli il numero che desideri modificare, quindi inserisci un nuovo numero.
   +  Modalità **soglie: scegli la modalità** per modificarla per tutte le soglie di questo pannello.

1. Scegli **Salva** per salvare le modifiche nella dashboard.

## Aggiungere una soglia a un pannello grafico
<a name="add-a-threshold-to-a-graph-panel"></a>

Nella visualizzazione del pannello grafico, è possibile utilizzare le soglie per aggiungere linee o sezioni arbitrarie al grafico in modo da visualizzare più facilmente quando il grafico supera una determinata soglia.

1. Scegliete il pannello grafico a cui desiderate aggiungere una soglia.

1. Nella scheda **Pannello**, scegliete **Soglie**.

1. Scegli **Aggiungi soglia**.

1. Compila tutti i campi che desideri. Sono obbligatori solo i campi **T1**.
   +  **T1** — Entrambi i valori sono necessari per visualizzare una soglia.
     +  **lt** o **gt**: seleziona **lt** per meno di o **gt** per maggiore di per indicare a cosa si applica la soglia.
     +  **Valore**: immettere un valore di soglia. L'area di lavoro Grafana traccia una linea di soglia lungo l'asse y in corrispondenza di quel valore.
   +  **Colore**: scegli una condizione che corrisponda a un colore o definisci il tuo colore.
     +  **personalizzato**: definisci il colore di riempimento e il colore della linea.
     +  **critico**: il colore del riempimento e della linea è rosso.
     +  **avviso**: i colori di riempimento e linea sono gialli.
     +  **ok** — I colori di riempimento e linea sono verdi.
   +  **Riempimento**: consente di scegliere se visualizzare il riempimento della soglia.
   +  **Linea**: consente di scegliere se visualizzare la linea di soglia.
   +  **Asse Y**: scegli **sinistra** o **destra**.

1. Scegli **Salva** per salvare le modifiche nella dashboard. 

## Eliminazione di una soglia
<a name="delete-a-threshold"></a>

1. Scegliete il pannello da cui desiderate rimuovere una soglia.

1. Scegli la scheda **Campo**. (Oppure, per un pannello grafico, scegliete la scheda **Pannello**).

1. Scegliete l'icona del cestino accanto alla soglia che desiderate rimuovere. 

1. Scegli **Salva** per salvare le modifiche nella dashboard. 

# WindRose
<a name="windrose"></a>

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

Il WindRose pannello riceve i dati non elaborati delle serie temporali, li converte e li mappa in un grafico. WindRose 

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/images/windrose.png)


## Opzioni
<a name="windrose-options"></a>

Il WindRose pannello supporta le seguenti opzioni:
+ Frequenza dell'asse
+ Stile dell'asse (gradi o bussola)
+ Scala (lineare, quadrata, logaritmica)

# Ispeziona un pannello
<a name="inspect-a-panel"></a>

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

Il panel inspector ti aiuta a comprendere e risolvere i problemi dei tuoi pannelli. Puoi ispezionare i dati grezzi di qualsiasi pannello dell'area di lavoro Grafana, esportare tali dati in un file con valori separati da virgole (CSV), visualizzare le richieste di query ed esportare pannelli e dati JSON. 

## Interfaccia utente di Panel Inspector
<a name="panel-inspector-ui"></a>

L'ispettore del pannello visualizza **Inspect: < NameOfPanelBeingInspected >** nella parte superiore del riquadro. Scegliete la freccia nell'angolo in alto a destra per espandere o ridurre il riquadro.

L'ispettore del pannello è composto da quattro schede:
+  **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 stai effettuando il provisioning o l'amministrazione di Amazon Managed Grafana.
+  **Scheda Query**: mostra le richieste al server inviate quando Amazon Managed Grafana interroga l'origine dati.

**Nota**  
Non tutti i tipi di pannello includono tutte e quattro 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.

## Attività di Panel Inspector
<a name="panel-inspector-tasks"></a>

Nel panel inspector, puoi ispezionare i pannelli, ispezionare e scaricare i risultati delle query non elaborati, ispezionare le prestazioni delle query, visualizzare i modelli JSON dei pannelli e visualizzare la richiesta e la risposta non elaborate alla fonte di dati.

### Apri l'ispettore del pannello
<a name="open-the-panel-inspector"></a>

Puoi ispezionare qualsiasi pannello che puoi visualizzare.

1. Nella console dell'area di lavoro Grafana, scegli la dashboard che contiene il pannello che desideri ispezionare.

1. **Scegliete il titolo del pannello che desiderate ispezionare, quindi scegliete Ispeziona.** **Oppure fate una pausa sul titolo del pannello, quindi premete i.**

Il riquadro di ispezione del pannello si apre sul lato destro dello schermo.

### Esamina i risultati grezzi delle interrogazioni
<a name="inspect-raw-query-results"></a>

Visualizza i risultati non elaborati delle query in una tabella. Questi sono i dati restituiti dall'interrogazione con le trasformazioni applicate e prima che il pannello applichi le opzioni di campo o le sostituzioni delle opzioni di campo.

1. **Aprite l'ispettore del pannello, quindi scegliete la scheda Dati.** **Oppure, nel menu del pannello, scegliete **Ispeziona, Dati**.**

1. Se il pannello contiene più interrogazioni o interroga più nodi, 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, con un set di risultati per colonna. Scegli un'intestazione di colonna per riordinare i dati.

  Visualizza i risultati grezzi delle query in una tabella con le opzioni di campo e le sostituzioni delle opzioni applicate.

  1. Apri la scheda **Dati** nell'ispettore del pannello.

  1. Sopra la tabella, scegliete le **opzioni di visualizzazione dei dati**.

  1. Scegli il pulsante di attivazione/disattivazione **della configurazione del campo Applica**.

### Scarica i risultati non elaborati delle query come file CSV
<a name="download-raw-query-results-as-csv"></a>

Amazon Managed Grafana genera un file CSV nella posizione di download predefinita del browser. Puoi aprirlo nel visualizzatore che preferisci.

1. Apri l'ispettore del pannello.

1. Esamina i risultati grezzi dell'interrogazione come descritto sopra. Modifica le impostazioni fino a visualizzare i dati grezzi che desideri esportare.

1. Scegli **Download CSV** (Scarica CSV).

Per scaricare un file CSV formattato per Excel, espandi il pannello **Opzioni dati** e attiva l'opzione **Scarica per Excel** prima di scegliere **Scarica** CSV. 

### Ispeziona le prestazioni delle query
<a name="inspect-query-performance"></a>

La scheda **Statistiche** mostra le statistiche che indicano la durata della query, il numero di query inviate e il numero di righe restituite. Queste informazioni possono aiutarti a risolvere i problemi delle tue query, soprattutto se uno qualsiasi dei numeri è inaspettatamente alto o basso.

1. Apri l'ispettore del pannello.

1. Scegli la scheda **Statistiche**.

Le statistiche vengono visualizzate in formato di sola lettura.

### Visualizza i modelli JSON del pannello
<a name="view-panel-json-model"></a>

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

1. Apri l'ispettore del pannello, quindi scegli la scheda **JSON**. **Oppure, nel menu del pannello, scegliete **Inspect**, Panel JSON.** 

1. In **Seleziona fonte**, 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 il set di risultati non elaborato con le trasformazioni, la configurazione dei campi e le sostituzioni applicate.

1. Puoi espandere o comprimere parti del JSON per esplorarlo oppure puoi scegliere **Copia negli appunti e incollare** il JSON in un'altra applicazione.

### Visualizza la richiesta e la risposta non elaborate alla fonte di dati
<a name="view-raw-request-and-response-to-data-source"></a>

1. Apri l'ispettore del pannello, quindi scegli la scheda **Query**. **Oppure, nel menu del pannello, scegliete **Ispeziona**, Interroga.**

1. Scegliere **Refresh (Aggiorna)**.

Amazon Managed Grafana invia una query al server per raccogliere informazioni, quindi visualizza il risultato. Puoi approfondire parti specifiche della query, espanderla o comprimerla interamente o copiare i dati negli appunti per utilizzarli in altre applicazioni.

# Elenco dei calcoli
<a name="list-of-calculations"></a>

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

Questo argomento elenca e definisce i calcoli utilizzati in Amazon Managed Grafana.

Questi calcoli vengono utilizzati, tra l'altro, nella scheda **Trasforma** e nelle visualizzazioni degli indicatori a barre, degli indicatori e delle statistiche.


|  Calcolo  |  Description  | 
| --- | --- | 
|  Tutti i valori nulli  |  Vero quando tutti i valori sono nulli  | 
|  Tutti gli zeri  |  Vero quando tutti i valori sono 0  | 
|  Numero di modifiche  |  Numero di volte in cui il valore del campo cambia  | 
|  Conteggio  |  Numero di valori in un campo  | 
|  Delta  |  Modifica cumulativa del valore  | 
|  Differenza  |  Differenza tra il primo e l'ultimo valore di un campo  | 
|  Conteggio distinto  |  Numero di valori univoci in un campo  | 
|  Primo (non nullo)  |  Innanzitutto, non è un valore nullo in un campo  | 
|  Max  |  Valore massimo di un campo  | 
|  Media  |  Valore medio di tutti i valori in un campo  | 
|  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  | 

# Pannelli di controllo
<a name="dashboard-overview"></a>

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

 Una *dashboard* è un insieme di uno o più pannelli organizzati e disposti in una o più righe. Amazon Managed Grafana viene fornito con una varietà di pannelli. Amazon Managed Grafana semplifica la creazione delle query giuste e la personalizzazione delle proprietà di visualizzazione in modo da poter creare la dashboard di cui hai bisogno. Ogni pannello può interagire con i dati provenienti da qualsiasi fonte di dati configurata. 

## Gestisci i pannelli di controllo
<a name="manage-dashboards"></a>

 Per controllare il periodo di tempo della dashboard, puoi utilizzare il pannello [Controlli dell'intervallo di tempo](dashboard-time-range-controls.md) in alto a destra della dashboard. 

 Le dashboard possono utilizzare modelli e variabili per renderle più dinamiche e interattive. Per ulteriori informazioni, consulta [Modelli e variabili](templates-and-variables.md). 

 Le dashboard possono essere utilizzate [Annotazioni](dashboard-annotations.md) per visualizzare i dati degli eventi su più pannelli. Questo può aiutare a correlare i dati delle serie temporali nel pannello con altri eventi. 

 Le dashboard possono essere condivise facilmente in diversi modi. Per ulteriori informazioni, consulta [Condivisione di un pannello di controllo](share-a-dashboard.md). 

 Le dashboard possono essere etichettate e lo strumento di selezione delle dashboard fornisce un accesso rapido e ricercabile a tutte le dashboard di una particolare organizzazione. 

## Righe
<a name="dashboard-rows"></a>

 Una *riga* è un divisore logico all'interno di un pannello di controllo. Viene utilizzato per raggruppare i pannelli. 

 Le file sono sempre larghe 12 *unità*. Queste unità vengono ridimensionate automaticamente in base alla risoluzione orizzontale del browser. È possibile controllare la larghezza relativa dei pannelli all'interno di una riga impostandone la larghezza specifica. 

 Amazon Managed Grafana utilizza un'astrazione di unità per ottimizzare l'aspetto su schermi di tutte le dimensioni. 

**Nota**  
 Grazie MaxDataPoint alla funzionalità, Amazon Managed Grafana può visualizzare il numero richiesto di punti dati, indipendentemente dalla risoluzione o dall'intervallo di tempo. 

 Per comprimere una riga, scegli il titolo della riga. Se salvi un pannello di controllo con una riga compressa, il pannello di controllo viene salvato in quello stato e i grafici non vengono caricati finché non espandi la riga. 

 Utilizza la funzionalità delle righe ripetute per creare o rimuovere dinamicamente intere righe di pannelli, in base alle variabili del modello selezionate. 

# Annotazioni
<a name="dashboard-annotations"></a>

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

 Le annotazioni forniscono un modo per contrassegnare punti sul grafico con eventi complessi. Quando fai una pausa su un'annotazione, puoi visualizzare la descrizione e i tag dell'evento. Il campo di testo può includere collegamenti ad altri sistemi per ulteriori dettagli. 

## Annotazioni native
<a name="native-annotations"></a>

 Amazon Managed Grafana è dotato di un archivio di annotazioni nativo e della possibilità di aggiungere eventi di annotazione direttamente dal pannello grafico. 

## Aggiungere annotazioni
<a name="adding-annotations"></a>

 Per aggiungere un'annotazione, premi **Ctrl** o **Cmd** e scegli dove vuoi aggiungere l'annotazione. Per rendere l'annotazione ricercabile da altre dashboard, aggiungi dei tag. 

### Aggiungere annotazioni regionali
<a name="adding-regions-events"></a>

 Per creare un'annotazione per una regione, premete **Ctrl** o **Cmd** mentre scegliete la regione. 

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

 Dopo aver aggiunto un'annotazione, questa rimane visibile. Questo perché esiste una query di annotazione integrata in tutti i dashboard. Questa query di annotazione recupera tutti gli eventi di annotazione che provengono dalla dashboard corrente e li visualizza nel pannello in cui sono stati creati. Ciò include le annotazioni della cronologia dello stato di avviso. È possibile impedire che le annotazioni vengano recuperate e visualizzate scegliendo l'icona **delle impostazioni della dashboard** (a forma di ingranaggio), scegliendo **Annotazioni** e quindi modificando la query denominata. `Annotations & Alerts (Built-in)` 

 Quando copi una dashboard utilizzando la funzione **Salva** con nome, la nuova dashboard ha un nuovo ID di dashboard, quindi le annotazioni create sulla dashboard di origine non sono visibili nella copia. Se le annotazioni della dashboard di origine hanno tag in base ai quali filtrare, puoi mostrare le annotazioni sulla copia aggiungendo una nuova **Annotation Query** e filtrando in base ai tag. 

### Interrogazione per tag
<a name="annotation-query-by-tag"></a>

 ****È possibile creare nuove query di annotazione che recuperano le annotazioni dall'archivio di annotazioni nativo utilizzando l'origine `-- Grafana --` dati e impostando Filter by to Tags.**** Specificate almeno un tag. Ad esempio, create una query di annotazione denominata `outages` e specificate un tag denominato`outage`. Questa query mostrerà tutte le annotazioni che crei (da qualsiasi dashboard o tramite API) con il `outage` tag.

Per impostazione predefinita, se aggiungi più tag nella query di annotazione, Amazon Managed Grafana mostrerà solo le annotazioni con tutti i tag che hai fornito. **Per mostrare le annotazioni che contengono almeno uno dei tag che hai fornito, attiva Match any.** 

 In Amazon Managed Grafana, è possibile utilizzare variabili modello nella query di tag. Ad esempio, se disponi di una dashboard che mostra le statistiche per diversi servizi e di una variabile modello che controlla quali servizi mostrare, puoi utilizzare la stessa variabile modello nella tua query di annotazione per mostrare le annotazioni solo per quei servizi. 

## Interrogazione di altre fonti di dati
<a name="querying-other-data-sources"></a>

 Gli eventi di annotazione vengono recuperati utilizzando query di annotazione. **Per aggiungere una nuova query di annotazione a una dashboard, scegli l'icona **delle impostazioni della dashboard** (a forma di ingranaggio)`Annotations`, scegli e quindi scegli Nuovo.** 

 Specificate un nome per la query di annotazione. Questo nome viene visualizzato dalla casella di controllo per mostrare o nascondere gli eventi di annotazione per questa query. Ad esempio, potreste avere due query di annotazione denominate and. `Deploys` `Outages` È possibile selezionare o deselezionare le caselle di controllo per specificare quali annotazioni mostrare. 

### Dettagli della richiesta di annotazione
<a name="annotation-query-details"></a>

 Le opzioni di interrogazione delle annotazioni sono diverse per ogni fonte di dati. 
+ [Annotazioni utilizzando l'editor di query Graphite](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [Annotazioni che utilizzano una fonte di dati OpenSearch ](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Annotazioni con Prometheus](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [Annotazioni con MySQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [Annotazioni con PostgreSQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# Cartelle del dashboard
<a name="dashboard-folders"></a>

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

 Le cartelle sono un modo per organizzare e raggruppare le dashboard. Ciò è utile se disponi di molte dashboard o se più team utilizzano lo stesso spazio di lavoro Grafana. 

## Creazione di una cartella
<a name="how-to-create-a-folder"></a>

Per creare una cartella, esegui una delle seguenti operazioni:
+  Nel menu laterale, sotto l'icona \$1, scegli il link **Crea cartella**. 
+  Nella pagina **Gestisci dashboard**, scegli il pulsante **Crea cartella**. 

 Nella pagina **Crea cartella**, inserisci un nome univoco per la cartella, quindi scegli **Crea**. 

Quando si salva una dashboard, è possibile scegliere una cartella esistente o creare una nuova cartella.

## Gestisci i pannelli di controllo
<a name="folders-manage-dashboards"></a>

 Nella pagina **Gestisci dashboard**, puoi eseguire diverse attività: 
+  Creare una cartella. 
+  Crea un pannello di controllo. 
+  Sposta i pannelli di controllo in cartelle. 
+  Elimina più dashboard. 
+  Accedi alla pagina di una cartella (dove puoi impostare le autorizzazioni per una cartella o i relativi dashboard). 

## Pagina della cartella Dashboard
<a name="dashboard-folder-page"></a>

 Per aprire una pagina della cartella Dashboard, scegli l'icona a forma di ingranaggio che appare quando ti fermi su una cartella nell'elenco dei dashboard nei risultati di ricerca o nella pagina Gestisci dashboard. 

 La pagina Dashboard Folder è simile alla pagina Gestisci dashboard. Nella pagina Dashboard Folder, è possibile eseguire le seguenti attività: 
+  Sposta o elimina i dashboard in una cartella. 
+  Rinomina una cartella (nella scheda **Impostazioni**). 
+  Imposta le autorizzazioni per la cartella (ereditate dai dashboard presenti nella cartella). 

## Permissions
<a name="folder-permissions"></a>

 Le autorizzazioni possono essere assegnate a una cartella ed ereditate dai dashboard in essa contenuti. Viene utilizzata una lista di controllo degli accessi (ACL) in cui è possibile assegnare le autorizzazioni al **ruolo dell'organizzazione**, al **team** e al singolo **utente**. Per ulteriori informazioni, consulta [Autorizzazioni per dashboard e cartelle](dashboard-and-folder-permissions.md). 

# Playlist
<a name="dashboard-playlist"></a>

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

 Una playlist è un elenco di dashboard che vengono visualizzate in sequenza. Puoi utilizzare una playlist per aumentare la consapevolezza della situazione o per presentare le tue metriche al tuo team o ai visitatori. 

 Amazon Managed Grafana ridimensiona automaticamente le dashboard a qualsiasi risoluzione, compresi i grandi schermi. 

 **Puoi accedere alla funzione **Playlist** dal menu laterale, nel sottomenu Dashboards.** 

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

 Una playlist presenta le dashboard in sequenza, con un ordine prestabilito e un intervallo di tempo tra le dashboard. 

1.  Per accedere alla funzione **Playlist, fai una** pausa nel menu laterale. 

1.  Scegli **Playlist**. 

1.  Scegli **Nuova playlist**. 

1.  Nella casella di testo **Nome**, inserisci un nome per la tua playlist. 

1.  Nella casella di testo **Intervallo**, inserisci un intervallo di tempo. 

   L'intervallo di tempo è il periodo di tempo impiegato da Amazon Managed Grafana per rimanere su una determinata dashboard prima di passare a quella successiva nella playlist. 

1.  Accanto a ogni dashboard che desideri aggiungere alla playlist, scegli **Aggiungi** alla playlist. 

1.  Scegli **Create** (Crea). 

## Modificare una playlist
<a name="edit-a-playlist"></a>

 Puoi modificare le playlist durante la creazione o dopo averle salvate. 

1.  Per accedere alla funzione Playlist, fai una pausa nel menu laterale. 

1.  Scegli **Playlist**. 

1.  Scegli la playlist che desideri modificare. 

### Modifica del nome di una playlist
<a name="edit-the-name-of-a-playlist"></a>

1. Scegli la casella di testo **Nome**.

1.  Modifica il nome. 

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

### Modifica dell'intervallo di una playlist
<a name="edit-the-interval-of-a-playlist"></a>

1.  Scegliete la casella di testo **Intervallo**. 

1.  Modifica l'intervallo. 

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

### Aggiungere una dashboard a una playlist
<a name="add-a-dashboard-to-a-playlist"></a>

1.  Accanto alla dashboard che desideri aggiungere, scegli **Aggiungi alla playlist**. 

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

### Stai cercando una dashboard da aggiungere
<a name="search-for-a-dashboard-to-add"></a>

1. In **Aggiungi dashboard**, scegli la casella di testo **Cerca dashboard per nome**. 

1.  Inserisci un nome o un'espressione regolare. 

1. Se necessario, filtra i risultati in base allo stato o ai tag contrassegnati con una stella. Per impostazione predefinita, le dashboard contrassegnate dai preferiti vengono visualizzate come opzioni da aggiungere alla playlist.

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

### Riorganizzazione dell'ordine della dashboard
<a name="rearrange-dashboard-order"></a>

1.  Accanto alla dashboard che desideri spostare, scegli la freccia su o giù. 

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

### Rimuovere una dashboard
<a name="remove-a-dashboard"></a>

1.  Scegli l'icona x per rimuovere una dashboard dalla playlist. 

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

### Eliminazione di una playlist
<a name="delete-a-playlist"></a>

1.  Scegli **playlist**. 

1.  Accanto alla playlist che desideri eliminare, scegli l'icona x. 

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

 Puoi salvare una playlist per aggiungerla alla tua pagina **Playlist**, dove puoi avviarla. Assicurati di aggiungere tutte le dashboard che desideri vengano visualizzate nella playlist prima di salvarla. 

1.  Per accedere alla funzione **Playlist**, fai una pausa nel menu laterale. 

1.  Scegli **Playlist**. 

1.  Scegli la playlist. 

1.  Modifica la playlist. 

   Assicurati che alla playlist siano aggiunti un **nome**, un **intervallo** e almeno una **dashboard**. 

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

## Avvio di una playlist
<a name="start-a-playlist"></a>

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

 Per impostazione predefinita, ogni dashboard viene visualizzata per il periodo di tempo immesso nel campo **Intervallo**, che può essere impostato durante la creazione o la modifica di una playlist. Dopo aver avviato una playlist, puoi controllarla utilizzando la barra di navigazione nella parte superiore dello schermo. 

1.  **Nel menu **Dashboard**, scegli Playlist.** 

1.  Accanto alla playlist che desideri avviare, scegli **Avvia** playlist. 

1.  Nell'elenco a discesa, scegli una delle seguenti modalità di visualizzazione: 
   +  **modalità normale** 
     +  Il menu laterale rimane visibile. 
     +  I controlli della barra di navigazione, delle righe e del pannello vengono visualizzati nella parte superiore dello schermo. 
   +  **modalità TV** 
     +  Il menu laterale è nascosto o rimosso. 
     +  I controlli della barra di navigazione, delle righe e del pannello vengono visualizzati nella parte superiore dello schermo. 
     +  La modalità TV si attiva automaticamente dopo 1 minuto di inattività dell'utente. 
     +  È possibile attivare la modalità TV manualmente utilizzando la scorciatoia della sequenza **d v** o aggiungendo il parametro `?inactive` all'URL della dashboard. 
     +  È possibile disattivare la modalità TV con qualsiasi movimento del mouse o azione della tastiera. 
   +  **modalità TV (con pannelli ad adattamento automatico)** 
     +  Il menu laterale è nascosto o rimosso. 
     +  I controlli della barra di navigazione, delle righe e del pannello vengono visualizzati nella parte superiore dello schermo. 
     +  I pannelli del pannello di controllo si regolano automaticamente per ottimizzare lo spazio sullo schermo. 
   +  **modalità Kiosk** 
     +  I controlli del menu laterale, della barra di navigazione, delle righe e del pannello sono completamente nascosti o rimossi dalla vista. 
     +  Puoi attivare la modalità Kiosk manualmente utilizzando la scorciatoia della sequenza **d v** dopo l'avvio della playlist. 
     +  È possibile disattivare la modalità Kiosk manualmente utilizzando la stessa scorciatoia. 
   +  **Modalità Kiosk (con pannelli ad adattamento automatico):** 
     +  I controlli del menu laterale, della barra di navigazione, delle righe e dei pannelli sono completamente nascosti o rimossi dalla vista. 
     +  I pannelli del pannello di controllo si regolano automaticamente per ottimizzare lo spazio sullo schermo. 

## Controllo di una playlist
<a name="control-a-playlist"></a>

 È possibile controllare una playlist in modalità **Normale** o **TV** dopo l'avvio utilizzando la barra di navigazione nella parte superiore dello schermo. 


|  Button  |  Risultato  | 
| --- | --- | 
|  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)  |  Cambia 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 a discesa.  | 
|  Aggiorna (freccia circolare)  |  Ricarica la dashboard per visualizzare i dati correnti. Può essere impostato per ricaricarsi automaticamente, da ogni 5 secondi a 1 giorno, utilizzando la freccia a discesa.  | 

 **Per interrompere la riproduzione della playlist dalla tastiera, premi Esc.**

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

Puoi condividere una playlist copiando l'URL nella modalità di visualizzazione desiderata e incollando l'URL nella destinazione.

1.  **Dal menu **Dashboard**, scegli Playlist.** 

1.  Accanto alla playlist che desideri condividere, scegli **Avvia playlist**, quindi scegli la modalità di visualizzazione desiderata. 

1.  Per copiare l'URL negli appunti, scegli **Copia l'indirizzo del link**. 

    Ad esempio, l'URL di una playlist sul sito Grafana Play in modalità Kiosk potrebbe essere `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk` 

1.  Incolla l'URL nella tua destinazione. 

# Ricerca nel pannello di controllo
<a name="dashboard-search"></a>

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

 Le dashboard possono essere ricercate in base al nome della dashboard, filtrate in base a uno (o più) tag o filtrate in base allo stato contrassegnato con asterisco. È possibile accedere alla ricerca nella dashboard tramite il selettore della dashboard, disponibile nella barra di navigazione superiore della dashboard. **La ricerca nella dashboard può essere aperta anche utilizzando la scorciatoia F.** 

Quando si utilizza solo una tastiera, è possibile utilizzare i tasti freccia della tastiera per navigare tra i risultati e premere **Invio** per aprire la dashboard desiderata. 

## Ricerca per nome della dashboard
<a name="find-by-dashboard-name"></a>

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

La ricerca nella dashboard è la seguente:
+ In tempo reale
+ Non sensibile alle maiuscole
+  Funzionale su dashboard archiviati e basati su file

## Applicazione di filtri per tag
<a name="filter-by-tags"></a>

 I tag sono un modo utile per organizzare le dashboard, soprattutto con l'aumentare del numero di dashboard. **I tag possono essere aggiunti e gestiti nelle Impostazioni della dashboard.** 

 Per filtrare l'elenco della dashboard per tag, scegli qualsiasi tag visualizzato nella colonna di destra. Puoi filtrare ulteriormente l'elenco scegliendo tag aggiuntivi. 

Per visualizzare un elenco di tutti i tag disponibili, scegli il menu a discesa **Filtra per tag**. Quando selezioni un tag, la ricerca nella dashboard viene immediatamente filtrata. 

Se usi solo una tastiera, premi **Tab** per concentrarti sul link dei tag, premi il tasto freccia giù per trovare un tag e premi **Invio** per selezionare il tag. 

**Nota**  
 Quando vengono selezionati più tag, Amazon Managed Grafana mostra dashboard che includono tutti i tag. 

# Condivisione di un pannello di controllo
<a name="share-a-dashboard"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.md)  
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 condividere una dashboard, scegli **Condividi dashboard** (l'icona di condivisione) nella barra di navigazione in alto. Si apre la finestra di dialogo **Condividi**, dove puoi ottenere un link alla dashboard corrente con l'intervallo di tempo attualmente selezionato e le variabili del modello. Se hai apportato modifiche alla dashboard, assicurati di salvarle prima di copiare il link. 

## Istantanea della dashboard
<a name="dashboard-snapshot"></a>

 Un'istantanea della dashboard è un modo istantaneo per condividere pubblicamente una dashboard interattiva. Durante la creazione dello snapshot, Amazon Managed Grafana elimina i dati sensibili come le query (metriche, modelli 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 e possa raggiungere l'URL. 

## Pubblica istantanee
<a name="publish-snapshots"></a>

 È possibile pubblicare istantanee sulla propria istanza locale. 

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

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

 Scegliete un titolo per aprire il menu del pannello, quindi scegliete **Condividi** dal menu del pannello per aprire la finestra di dialogo **Condividi** pannello. Puoi copiare il link, che ti porterà esattamente a questo pannello con l'intervallo di tempo corrente e le variabili del modello selezionate. 

# Controlli dell'intervallo di tempo
<a name="dashboard-time-range-controls"></a>

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

 Amazon Managed Grafana offre diversi modi per gestire gli intervalli di tempo dei dati visualizzati, sia a livello di dashboard che a livello di pannello. 

 Questo argomento 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. 

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

## Unità di tempo e intervalli relativi
<a name="time-units-and-relative-ranges"></a>

 Sono supportate le seguenti unità di tempo: 
+ `s`(secondi)
+ `m`(minuti)
+ `h`(ore),
+ `d`(giorni)
+ `w`(settimane)
+ `M`(mesi)
+ `y`(anni)

 Usa l'operatore meno per tornare indietro nel tempo, rispetto a adesso. Per visualizzare il periodo completo dell'unità (ad esempio giorno, settimana o mese), aggiungi`/<time unit>`. 

 Utilizzate l'operatore più per avanzare nel tempo rispetto a adesso. Puoi utilizzare questa funzione per esaminare i dati previsti per il futuro. 

 Ecco alcuni esempi: 


|  Esempio di intervallo relativo  |  Da  |  Per  | 
| --- | --- | --- | 
|  Ultimi 5 minuti  |  now-5m  |  now  | 
|  Il giorno finora  |  now/d  |  now  | 
|  Questa settimana  |  now/w  |  now/w  | 
|  Da una settimana all'altra  |  now/w  |  now  | 
|  Mese precedente  |  now-1M/M  |  now-1M/M  | 

## Controlli comuni dell'intervallo di tempo
<a name="common-time-range-controls"></a>

 I controlli temporali della dashboard e del pannello hanno un'interfaccia utente comune, con le seguenti opzioni. 

### Intervallo di tempo attuale
<a name="current-time-range"></a>

 L'intervallo di tempo corrente, chiamato anche *selettore temporale*, mostra l'intervallo di tempo attualmente visualizzato nella dashboard o nel pannello che stai visualizzando. 

 Fai una pausa su un campo per vedere i timestamp esatti dell'intervallo e la loro origine, ad esempio il browser locale. 

 Per modificare l'intervallo di tempo, scegli l'intervallo di tempo corrente. Puoi 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`. 

### Intervallo di tempo relativo
<a name="relative-time-range"></a>

 Seleziona l'intervallo di tempo relativo dall'elenco **Intervalli temporali relativi**. Ecco alcuni esempi di intervalli di tempo relativi: 
+  Ultimi 30 minuti 
+  Ultime 12 ore 
+  Ultimi 7 giorni 
+  Ultimi 2 anni 
+  Ieri 
+  L'altro ieri 
+  Questo giorno della settimana scorsa 
+  Oggi finora 
+  Finora questa settimana 
+  Finora questo mese 

### Intervallo di tempo assoluto
<a name="absolute-time-range"></a>

 Imposta un intervallo di tempo assoluto in due modi: 
+  Immettete i valori nei campi **Da** e **A**. È possibile inserire valori temporali esatti o valori relativi, ad esempio`now-24h`, e quindi scegliere **Applica intervallo di tempo**. 
+  Scegli il campo **Da** o **A**. Amazon Managed Grafana visualizza un calendario. Scegli il giorno o i giorni che desideri utilizzare come intervallo di tempo corrente, quindi scegli **Applica intervallo di tempo**. 

 Amazon Managed Grafana mostra anche gli intervalli assoluti utilizzati di recente. 

### Riduci lo zoom (Cmd\$1Z o Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 **Per visualizzare un intervallo di tempo più ampio nella visualizzazione della dashboard o del pannello, scegli l'icona di zoom indietro dell'intervallo di tempo.** 

### Ingrandisci (solo per visualizzazioni grafiche)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 Nella visualizzazione del grafico, trascinate per selezionare l'intervallo di tempo che desiderate visualizzare. 

### Aggiorna il pannello di controllo
<a name="refresh-dashboard"></a>

 Scegli l'icona **Aggiorna dashboard** per eseguire immediatamente ogni query sulla dashboard e aggiornare le visualizzazioni. Amazon Managed Grafana annulla tutte le richieste in sospeso quando viene avviato un nuovo aggiornamento. 

 Per impostazione predefinita, Amazon Managed Grafana non aggiorna automaticamente la dashboard. Le query vengono eseguite secondo una pianificazione diversa in base alle impostazioni del pannello. Tuttavia, se desideri aggiornare regolarmente la dashboard, scegli la freccia rivolta verso il basso accanto all'icona **Aggiorna dashboard**, quindi seleziona un intervallo di aggiornamento. 

## Impostazioni dell'ora della dashboard
<a name="dashboard-time-settings"></a>

 Le impostazioni dell'ora vengono salvate in base al pannello di controllo. 

 Per accedere alle impostazioni dell'ora della dashboard, scegli l'icona **Impostazioni dashboard** (ingranaggio) nella parte superiore dello schermo. Le impostazioni si trovano nella sezione **Opzioni temporali** della scheda **Generale**. 
+  Fuso **orario**: 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**: 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, Amazon Managed Grafana utilizza l'ora locale del browser. 
  +  **Ora del browser** Il fuso orario configurato per il browser che viene utilizzato. Si tratta in genere del fuso orario impostato sul computer. 
  +  **Tempo universale coordinato**: fusi orari standard ISO 8601, incluso UTC. Per ulteriori informazioni, consulta un [elenco di fusi orari.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) 
+  **Aggiornamento automatico**: opzioni personalizzabili, tempo relativo e impostazioni di aggiornamento automatico. Le voci sono separate da virgole e possono corrispondere a qualsiasi unità di tempo valida. 
+  **Now delay now-** — Valore del ritardo temporale che sostituisce il valore. `now` Più comunemente, questa funzionalità viene utilizzata per evitare valori nulli adattando ritardi noti nell'aggregazione dei dati. 
+  **Nascondi selettore orario**: opzione per non visualizzare il selettore orario. 

## Sovrascrizioni temporali e time shift del pannello
<a name="panel-time-overrides-and-timeshift"></a>

 In[Opzioni di interrogazione](panel-queries.md#query-options), puoi sovrascrivere l'intervallo di tempo relativo per i singoli pannelli, rendendoli diversi da quello selezionato nel selettore orario della dashboard nella barra di navigazione in alto. Puoi mostrare contemporaneamente le metriche relative a periodi di tempo o giorni diversi. 

## Controllo dell'intervallo di tempo tramite un URL
<a name="control-the-time-range-using-a-url"></a>

 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. Per ulteriori informazioni, consulta [Intervallo di tempo relativo](#relative-time-range). 
+  `to`— Definisce il limite superiore dell'intervallo di tempo, specificato in ms epoch o tempo relativo. Per ulteriori informazioni, consulta [Intervallo di tempo relativo](#relative-time-range). 
+  `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 millisecondi. Ad esempio, `?time=1500000000000&time.window=10000` restituisce un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000 

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

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

 Le dashboard di Amazon Managed Grafana possono essere facilmente esportate e importate, dall'interfaccia utente o dalla [API HTTP] 

## Esportazione di un pannello di controllo
<a name="exporting-a-dashboard"></a>

 Le dashboard vengono esportate in formato Amazon Managed Grafana JSON e contengono tutto ciò di cui hai bisogno, inclusi layout, variabili, stili, fonti di dati e query, per importare la dashboard in un secondo momento. 

 La funzionalità di esportazione è accessibile nella finestra di condivisione, che si apre scegliendo il pulsante di condivisione nel menu della dashboard.

### Rendere portatile una dashboard
<a name="making-a-dashboard-portable"></a>

 Quando esporti una dashboard per farla usare ad altri, è consigliabile aggiungere variabili modello per valori come un prefisso metrico (usa una variabile costante) e il nome di un server. 

 Una variabile modello di questo tipo `Constant` viene automaticamente nascosta nella dashboard. Viene inoltre aggiunta come input obbligatorio quando viene importata la dashboard. Per ulteriori informazioni sui modelli e sulle variabili dei modelli, consulta. [Modelli e variabili](templates-and-variables.md) 

## Importazione di un pannello di controllo
<a name="importing-a-dashboard"></a>

 Per importare una dashboard, scegli l'icona \$1 nel menu laterale, quindi scegli **Importa**. 

 Puoi caricare un file JSON della dashboard, incollare un URL della dashboard o incollare il testo JSON della dashboard direttamente nell'area di testo. 

 Nella fase 2 del processo di importazione, puoi modificare il nome della dashboard, specificare l'origine dati che desideri venga utilizzata dalla dashboard e specificare eventuali prefissi delle metriche (se la dashboard ne utilizza uno). 

## Scopri le dashboard su Grafana.com
<a name="discover-dashboards-on-grafana.com"></a>

 [Trova i dashboard per le applicazioni server più comuni su Grafana.com/dashboards.](https://grafana.com/dashboards) 

# Cronologia delle versioni del dashboard
<a name="dashboard-version-history"></a>

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

 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 scegliendo **Impostazioni della dashboard** e quindi selezionando **Versioni** nel menu a sinistra. 

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

## Confronto di due versioni della dashboard
<a name="comparing-two-dashboard-versions"></a>

 Per confrontare due versioni della dashboard, seleziona le due versioni dall'elenco che desideri confrontare. Dopo aver selezionato due versioni, scegli **Confronta versioni** per aprire la visualizzazione delle differenze. Per impostazione predefinita, vedrai un riepilogo testuale delle modifiche, come nell'immagine seguente.

 Per visualizzare la differenza del codice JSON non elaborato che rappresenta la dashboard, scegli **Visualizza JSON** Diff. 

 <x>Per ripristinare la versione precedente con cui stai confrontando, scegli **Ripristina alla** versione.

## Ripristino a una versione del dashboard salvata in precedenza
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 Se devi ripristinare una versione della dashboard salvata in precedenza, puoi farlo scegliendo il pulsante «Ripristina» a destra di una riga nell'elenco delle versioni della dashboard o scegliendo **Ripristina alla versione** che <x>appare nella vista delle differenze. Dopo aver scelto di eseguire il ripristino, una finestra pop-up ti chiederà di confermare il ripristino. 

 Dopo il ripristino a una versione precedente, verrà creata una nuova versione contenente gli stessi dati esatti della versione precedente, ma con un numero di versione diverso. Questo è indicato nella colonna **Note**. Questo aiuta a garantire che le versioni precedenti della dashboard non siano influenzate dalla modifica. 

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

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

 Amazon Managed Grafana offre diverse scorciatoie da tastiera. Per visualizzare tutte le scorciatoie da tastiera disponibili nella tua versione di Amazon Managed Grafana, **premi** Shift \$1? sulla tastiera. 

 **Amazon Managed Grafana include le seguenti scorciatoie da tastiera popolari:** 
+  **Ctrl\$1S** salva la dashboard corrente. 
+  **Ctrl\$1F** apre il finder/cerca nella dashboard. 
+  **Ctrl\$1H** nasconde tutti i controlli (nascondere i controlli funziona bene per gli schermi TV). 
+  **Escape** esce da un grafico quando è in modalità a schermo intero o di modifica. 

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

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

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

**Per visualizzare il codice JSON di una dashboard**

1.  Aprire un pannello di controllo. 

1.  Nella barra di navigazione in alto, scegli **Gestisci dashboard**. 

1.  Seleziona **Visualizza JSON** dal menu a discesa. 

## Campi JSON
<a name="dashboard-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 mostrato come`null`, che è il valore predefinito assegnato ad esso fino al salvataggio di un dashboard. Dopo aver salvato un pannello di controllo, al campo viene assegnato un valore intero. `id` 

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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": []
}
```

 La tabella seguente fornisce i dettagli di utilizzo per ogni campo nel dashboard JSON. 


|  Name  |  Utilizzo  | 
| --- | --- | 
|  id  |  L'identificatore numerico univoco per il dashboard (generato dal database).  | 
|  uid  |  L'identificatore univoco del dashboard che può essere generato da chiunque. uidÈ una stringa di 8-40 caratteri.  | 
|  titolo  |  Il titolo corrente del pannello di controllo.  | 
|  tags  |  I tag associati alla dashboard. In JSON, i tag sono una matrice di stringhe.  | 
|  style  |  Il tema della dashboard (ad esempio, dark olight).  | 
|  timezone  |  Il fuso orario della dashboard (utcobrowser).  | 
|  editable  |  Se una dashboard può essere modificata.  | 
|  graphTooltip  |  Lo stile del tooltip. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  L'intervallo di tempo per la dashboard (ad esempio, ultime 6 ore, ultimi 7 giorni).  | 
|  timepicker  |  I metadati del timepicker. Per ulteriori informazioni, consulta [Selettore orario](#dashboard-json-timepicker).  | 
|  templating  |  I metadati dei modelli. Per ulteriori informazioni, consulta [Modelli e variabili](templates-and-variables.md).  | 
|  annotations  |  I metadati delle annotazioni. Per ulteriori informazioni, consulta [Annotazioni](dashboard-annotations.md).  | 
|  refresh  |  L'intervallo di aggiornamento automatico.  | 
|  schemaVersion  |  La versione dello schema JSON (numero intero), che viene incrementata ogni volta che un aggiornamento di Amazon Managed Grafana modifica lo schema.  | 
|  version  |  La versione della dashboard (numero intero), che viene incrementata ogni volta che la dashboard viene aggiornata.  | 
|  panels  |  La matrice dei pannelli. Per ulteriori informazioni, consulta [Riquadri](#dashboard-JSON-panels).  | 

## Riquadri
<a name="dashboard-JSON-panels"></a>

 I pannelli sono gli elementi costitutivi di una dashboard. Consiste in interrogazioni sull'origine dei dati, tipi di grafici, alias e altri dati. 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. L'esempio seguente mostra il 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
<a name="panel-size-and-position"></a>

 La `gridPos` proprietà descrive le dimensioni e la posizione del pannello nelle coordinate della griglia: 
+  `w`— 1-24. La larghezza del cruscotto è suddivisa in 24 colonne. 
+  `h`— In unità di altezza della griglia. Ogni unità di altezza della griglia rappresenta 30 pixel. 
+  `x`— La posizione x. La posizione x utilizza l'unità nella stessa colonna di`w`. 
+  `y`— La posizione y. La posizione y utilizza la stessa unità di altezza della griglia di`h`. 

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

### Selettore orario
<a name="dashboard-json-timepicker"></a>

L'esempio seguente mostra le `timepicker` opzioni.

```
"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"
  }
```

 La tabella seguente fornisce i dettagli di utilizzo per`timepicker`. 


|  Name  |  Utilizzo  | 
| --- | --- | 
|  collapse  |  Se timepicker è compresso  | 
|  enable  |  Se timepicker è attivato  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

### Modellazione
<a name="json-templating"></a>

 Il `templating` campo contiene una serie di variabili modello con i relativi valori salvati e altri metadati. L'esempio seguente mostra i `templating` 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 fornisce i dettagli sull'utilizzo della sezione relativa ai modelli. 


|  Name  |  Utilizzo  | 
| --- | --- | 
|  abilitare  |  Se la creazione di modelli è attivata.  | 
|  elenco  |  Una matrice di oggetti, ognuno dei quali rappresenta una variabile del modello  | 
|  AllFormat  |  Il formato da utilizzare durante il recupero di tutti i valori dall'origine dati (ad esempio, wildcard globregex, epipe).  | 
|  attuale  |  Mostra il testo o il valore della variabile attualmente selezionata sulla dashboard  | 
|  origine dati  |  Mostra la fonte di dati per le variabili  | 
|  Includi tutto  |  Se l'opzione all value è disponibile  | 
|  multi  |  Se è possibile selezionare più valori dalla lista di valori variabili  | 
|  Multiformato  |  Il formato da utilizzare durante il recupero delle serie temporali dalla fonte di dati  | 
|  name  |  Il nome di una variabile  | 
|  options  |  L'array di text/value coppie di variabili disponibili per la selezione sulla dashboard  | 
|  query  |  La query dell'origine dati utilizzata per recuperare i valori per una variabile  | 
|  aggiorna  |  TODO  | 
|  espressione regolare  |  TODO  | 
|  tipo  |  Il tipo di variabile (customquery, ointerval)  | 

# Dashboard con script
<a name="scripted-dashboards"></a>

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

**avvertimento**  
 Questa funzionalità è obsoleta e verrà rimossa nelle prossime release. 

 Se hai molti nomi di metriche che cambiano (ad esempio, nuovi server) secondo uno schema definito, creare costantemente nuovi dashboard può richiedere molto tempo. 

 Con i dashboard con script, puoi creare dinamicamente i tuoi dashboard utilizzando. JavaScript Nella cartella di installazione di Grafana, sotto`public/dashboards/`, c'è un file denominato. `scripted.js` Questo file contiene un esempio di dashboard con script. Puoi accedervi utilizzando l'URL: `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` 

 Quando lo apri`scripted.js`, puoi vedere come legge i parametri URL dalla `ARGS` variabile e quindi aggiunge righe e pannelli. 

## Esempio: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## Altri esempi
<a name="more-examples"></a>

 Puoi trovare altri esempi nella `public/dashboards/` directory della tua installazione di Grafana. 

# Esplora
<a name="explore"></a>

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

 In un'area di lavoro Grafana, l'interfaccia utente della dashboard fornisce strumenti per la creazione di dashboard per la visualizzazione. *Explore* elimina tutte le opzioni della dashboard e del pannello in modo che tu possa concentrarti sulla query. Iterate fino a ottenere una query funzionante, quindi pianificate e create una dashboard. 

 Per il monitoraggio dell'infrastruttura e la risposta agli incidenti, non è più necessario passare ad altri strumenti per eseguire il debug di ciò che è andato storto. Puoi usare Explore per approfondire le tue metriche e i tuoi log e trovare la causa.

 Explore semplifica la visualizzazione dei dati senza creare una dashboard. Se la tua fonte di dati supporta dati grafici e tabellari, Explore mostra i risultati sia come grafico che come tabella. Questo ti aiuta a vedere le tendenze dei dati e maggiori dettagli allo stesso tempo. 

## Inizia a esplorare
<a name="start-exploring"></a>

**Nota**  
 Per impostazione predefinita, gli utenti con il ruolo Viewer non possono modificare e non hanno accesso a Explore. 

 L'icona **Esplora** nel menu a sinistra apre una scheda Esplora vuota. 

 Per iniziare con un'interrogazione esistente in un pannello, scegliete l'opzione **Esplora** dal menu del **pannello**. Si apre una scheda Esplora che contiene l'interrogazione del pannello. Puoi quindi modificare o iterare la query all'esterno della dashboard. 

 Scegli la tua fonte di dati dall'elenco a discesa in alto a sinistra. Prometheus ha un'implementazione Explore personalizzata. Le altre fonti di dati utilizzano il loro editor di query standard. 

 Nel campo delle interrogazioni, puoi scrivere la tua query ed esplorare i tuoi dati. Ci sono tre pulsanti accanto al campo di interrogazione, un pulsante di cancellazione (X), un pulsante di aggiunta di query (\$1) e il pulsante di rimozione della query (-). Come nell'editor di interrogazioni del pannello, puoi aggiungere e rimuovere più interrogazioni. 

## Dividere e confrontare
<a name="split-and-compare"></a>

 La funzione di visualizzazione divisa è un modo per confrontare grafici e tabelle side-by-side o per esaminare i dati correlati insieme su un'unica pagina. Scegliete **Dividi** per duplicare la query corrente e dividere la pagina in due side-by-side interrogazioni. Hai la possibilità di selezionare una fonte di dati diversa per la nuova query. In questo modo è possibile confrontare la stessa query per due server diversi o confrontare l'ambiente di staging con l'ambiente di produzione. 

 Nella visualizzazione divisa, è possibile collegare i selettori temporali per entrambi i pannelli (se si modifica uno, viene modificato anche l'altro) scegliendo uno dei pulsanti di sincronizzazione temporale collegati ai selettori temporali. Il collegamento dei selettori temporali aiuta a mantenere sincronizzati gli orari di inizio e di fine delle interrogazioni con visualizzazione divisa, in modo da visualizzare lo stesso intervallo di tempo in entrambi i pannelli divisi. 

 **È possibile chiudere l'interrogazione appena creata scegliendo Chiudi Dividi.**

## Condivisione di un link abbreviato
<a name="share-shortened-link"></a>

 Utilizza la funzionalità **Condividi link abbreviati** per creare formati più piccoli e semplici `/goto/:uid` invece URLs di condividere file più lunghi URLs che contengono parametri di interrogazione complessi. Puoi creare un link abbreviato scegliendo l'opzione **Condividi** nella barra degli strumenti Esplora. Tutti i link abbreviati che non vengono mai utilizzati vengono eliminati automaticamente dopo 7 giorni. 

## Cronologia delle query
<a name="query-history"></a>

 La cronologia delle query è un elenco di query utilizzate in Explore. La cronologia è locale del browser e non è condivisa. Per aprire e interagire con la cronologia, scegli **Cronologia delle interrogazioni** in Esplora. 

### Visualizzazione della cronologia delle interrogazioni
<a name="view-query-history"></a>

 FIn la cronologia delle interrogazioni, puoi fare quanto segue: 
+  Eseguire una query. 
+  Crea o modifica un commento. 
+  Copia un'interrogazione negli appunti. 
+  Copia negli appunti un link abbreviato con la query. 
+  Inizia un'interrogazione. 

### Gestione delle interrogazioni preferite
<a name="manage-favorite-queries"></a>

 Tutte le interrogazioni che sono state contrassegnate come speciali nella scheda Cronologia delle interrogazioni vengono visualizzate nella scheda Speciali. Puoi accedere più rapidamente alle tue query preferite e riutilizzarle senza doverle digitare nuovamente. 

### Ordina la cronologia delle query
<a name="sort-query-history"></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. 

Sul lato destro della cronologia delle interrogazioni, nell'elenco a discesa, scegli una delle seguenti opzioni: campo.
+  Prima il più recente 
+  Prima il più vecchio 
+  Fonte dati A-Z 
+  Fonte dati Z-A 

**Nota**  
 Se è attiva la visualizzazione divisa, la modalità di ordinamento si applica solo al pannello attivo. 

### Filtra la cronologia delle interrogazioni
<a name="filter-query-history"></a>

 Nelle schede **Cronologia delle interrogazioni** **e Speciali**, puoi filtrare la cronologia delle query in base al nome dell'origine dati. 

1. Scegli **Filtra le interrogazioni per fonti di dati specifiche**.

1. Seleziona la fonte di dati che desideri utilizzare per filtrare la cronologia. Puoi selezionare più fonti di dati.

Nella scheda **Cronologia delle interrogazioni**, puoi utilizzare il cursore verticale per filtrare le query per data:
+ Trascina la maniglia inferiore per modificare la data di inizio.
+ Trascina la maniglia superiore per modificare la data di fine. 

**Nota**  
Se la visualizzazione è divisa, i filtri vengono applicati solo al pannello attivo. 

### Ricerca nella cronologia delle interrogazioni
<a name="search-in-query-history"></a>

 Puoi cercare nella cronologia tra le domande e i commenti. La ricerca è possibile nelle schede **Cronologia delle interrogazioni e Speciali****.** 

1.  Scegli il campo Interrogazioni **di ricerca**. 

1.  Nel campo di ricerca, inserisci il termine di ricerca. 

### Impostazioni della cronologia delle interrogazioni
<a name="query-history-settings"></a>

 È possibile personalizzare la cronologia delle **interrogazioni nella scheda Impostazioni**. La tabella seguente elenca le opzioni disponibili. 


|  Impostazione  |  Valore predefinito  | 
| --- | --- | 
|  Specificate per quanto tempo Grafana salverà la cronologia delle vostre interrogazioni.  |  1 settimana  | 
|  Cambia la scheda attiva predefinita. |  Scheda della cronologia delle interrogazioni  | 
|  Mostra le interrogazioni solo per la fonte di dati attualmente attiva in Explore.  |  True  | 
|  Cancella la cronologia delle interrogazioni.  |  (Scegli Cancella cronologia delle interrogazioni per eliminare definitivamente tutte le query memorizzate.)  | 

**Nota**  
Le impostazioni della cronologia delle interrogazioni sono globali e vengono applicate a entrambi i pannelli in modalità split.

## Funzionalità specifiche di Prometheus
<a name="prometheus-specific-features"></a>

 La prima versione di Explore offre un'esperienza di interrogazione personalizzata per Prometheus. Quando si esegue una query, Grafana esegue in realtà due query: una normale query Prometheus per il grafico e una Instant Query per la tabella. Una Instant Query restituisce l'ultimo valore per ogni serie temporale, che mostra un buon riepilogo dei dati mostrati nel grafico. 

### Esploratore di metriche
<a name="metrics-explorer"></a>

 Sul lato sinistro del campo di interrogazione, scegli **Metriche per aprire Metric** Explorer. Questo mostra un menu gerarchico con le metriche raggruppate in base al loro prefisso. Ad esempio, tutte le metriche di Alertmanager sono raggruppate sotto il prefisso. `alertmanager` Questo è un buon punto di partenza per esplorare quali metriche sono disponibili. 

### Campo di interrogazione
<a name="query-field"></a>

 Il campo Query supporta il completamento automatico dei nomi delle metriche, delle funzioni e funziona più o meno allo stesso modo dell'editor di query standard di Prometheus. Premi **Invio per eseguire** una query. 

 È possibile accedere al menu di completamento automatico premendo **Ctrl\$1Spazio**. Il menu di completamento automatico contiene una nuova sezione Cronologia con un elenco di interrogazioni eseguite di recente. 

 I suggerimenti possono essere visualizzati nel campo Query. Scegli un suggerimento per aggiornare la tua query con la modifica suggerita. 
+  Per i contatori (metriche che aumentano in modo monotono), è consigliata una funzione di frequenza. 
+  Per i bucket, è consigliata una funzione istogramma. 
+  Per le regole di registrazione, è possibile espandere le regole.

### Filtri da tabella
<a name="table-filters"></a>

 Scegliete il pulsante **Filtro** nella colonna dell'**etichetta** di un pannello di tabella per aggiungere filtri all'espressione di interrogazione. È possibile aggiungere filtri anche per più interrogazioni. Il filtro viene aggiunto per tutte le query. 

## Integrazione dei log
<a name="logs-integration"></a>

 Puoi anche utilizzare Explore per esaminare i tuoi log con le seguenti fonti di dati: 
+  InfluxDB 
+  Elasticsearch 

### Visualizzazione dei log
<a name="logs-visualization"></a>

 I risultati delle interrogazioni di log vengono mostrati come istogrammi nel grafico, mentre i singoli log vengono visualizzati di seguito. Se l'origine dati non invia i dati dell'istogramma per l'intervallo di tempo richiesto, il modello di log calcola una serie temporale basata sul numero di righe di registro raggruppato in intervalli di tempo calcolati automaticamente. L'inizio dell'istogramma viene quindi ancorato al timestamp della prima riga di registro relativo al risultato. **La fine della serie temporale è ancorata all'intervallo To del selettore orario.** 

#### Livello di log
<a name="log-level"></a>

 Per i log in cui è specificata un'etichetta di **livello**, Grafana utilizza il valore dell'etichetta per determinare il livello di registro e aggiornare il colore di conseguenza. Se nel registro non è specificata un'etichetta di livello, Grafana analizza il registro per scoprire se il suo contenuto corrisponde a una delle espressioni supportate. Il livello di registro è sempre determinato dalla prima corrispondenza. Se Grafana non è in grado di determinare un livello di registro, verrà visualizzato con il livello di registro **sconosciuto**. La tabella seguente elenca i livelli di registro e la mappatura delle abbreviazioni e delle espressioni a livello di registro. 


|  Espressioni supportate  |  Livello di log  |  Colore  | 
| --- | --- | --- | 
|  emerg  |  critico  |  viola  | 
|  fatali  |  critico  |  viola  | 
|  avviso  |  critico  |  viola  | 
|  critica  |  critico  |  viola  | 
|  critico  |  critico  |  viola  | 
|  errare  |  error  |  rosso  | 
|  errore  |  error  |  rosso  | 
|  error  |  error  |  rosso  | 
|  avviso  |  attenzione  |  giallo  | 
|  attenzione  |  attenzione  |  giallo  | 
|  Info  |  Info  |  verde  | 
|  Informazioni  |  Info  |  verde  | 
|  avviso  |  Info  |  verde  | 
|  debug  |  debug  |  blu  | 
|  debug  |  debug  |  blu  | 
|  trace  |  trace  |  blu chiaro  | 
|  \$1  |  sconosciuto  |  grigio  | 

### opzioni di visualizzazione
<a name="visualization-options"></a>

 È possibile personalizzare la modalità di visualizzazione dei registri e selezionare le colonne da visualizzare. 

#### Orario
<a name="visualization-options-time"></a>

 Questa opzione mostra o nasconde la colonna temporale. Questo è il timestamp associato alla riga di registro riportata dalla fonte di dati. 

#### Etichette uniche
<a name="visualization-options-unique-labels"></a>

 Questa opzione mostra o nasconde la colonna delle etichette univoche, che include solo etichette non comuni. Tutte le etichette comuni sono visualizzate sopra.

#### Avvolgi le linee
<a name="visualization-options-wrap-lines"></a>

 Per utilizzare l'avvolgimento delle linee nel display, impostalo su **True**. L'impostazione di questa opzione su **False** comporta lo scorrimento orizzontale. 

#### Deduppare
<a name="visualization-options-deduping"></a>

 I dati di registro possono essere molto ripetitivi. Explore può aiutarti nascondendo le righe di registro duplicate. È possibile scegliere tra diversi algoritmi di deduplicazione: 
+  **Esatto**: le corrispondenze esatte vengono eseguite sull'intera riga ad eccezione dei campi data. 
+  **Numeri**: le corrispondenze vengono eseguite sulla riga dopo aver eliminato numeri come durate, indirizzi IP e così via. 
+  **Firma**: la deduplicazione più aggressiva, elimina tutte le lettere e i numeri. Le corrispondenze vengono eseguite sullo spazio bianco e sulla punteggiatura rimanenti. 

#### Inverti l'ordine dei risultati
<a name="visualization-options-flip-results-order"></a>

 È possibile modificare l'ordine dei log ricevuti dall'ordine decrescente predefinito (prima il più recente) all'ordine crescente (prima il più vecchio). 

### Etichette e campi rilevati
<a name="labels-and-detected-fields"></a>

 Ogni riga di registro ha un'area estensibile con le relative etichette e i campi rilevati, per un'interazione più solida. Per tutte le etichette, puoi filtrare per (filtro positivo) e filtrare (filtro negativo) le etichette selezionate. Ogni campo o etichetta ha anche un'icona delle statistiche per visualizzare statistiche una tantum relative a tutti i log visualizzati. 

### Attiva/disattiva i campi rilevati
<a name="toggle-detected-fields"></a>

 Se i log sono strutturati in JSON o logfmt, puoi mostrare o nascondere i campi rilevati. Espandi una riga di registro, quindi scegli l'icona a forma di occhio per mostrare o nascondere i campi. 

 \$1\$1< docs-imagebox img=»/img/docs/explore/parsed-fields-7-2.gif "max-width="800px» caption="Attivazione dei campi rilevati in Explore» >\$1\$1 

## Tracciamento dell'integrazione
<a name="tracing-integration"></a>

 Puoi visualizzare le tracce provenienti da fonti di dati di tracciamento in Explore. Fonti di dati attualmente supportate: 
+ [Connect a una fonte di dati Jaeger](jaeger-data-source.md) 
+ [Connect a una sorgente dati Tempo](tempo-data-source.md) 
+ [Connect a un'origine AWS X-Ray dati](x-ray-data-source.md) 
+ [Connect a una fonte di dati Zipkin](zipkin-data-source.md) 

 Per informazioni sull'utilizzo dell'editor di query, consulta la documentazione relativa alla fonte di dati specifica. 

### Header
<a name="explore-header"></a>

L'intestazione include i seguenti elementi:
+  Titolo dell'intestazione, che mostra il nome del root span e dell'ID di traccia 
+  Ricerca, che evidenzia gli intervalli che contengono il testo cercato 
+  Metadati relativi alla traccia 

### Minimappa
<a name="explore-minimap"></a>

 La minimappa mostra una vista condensata della sequenza temporale della traccia. Trascina il mouse sulla minimappa per ingrandire un intervallo di tempo più piccolo. Lo zoom aggiornerà anche la sequenza temporale principale, quindi sarà facile vedere intervalli più brevi. Se fai una pausa sulla minimappa, quando viene ingrandita, puoi vedere il **pulsante Reimposta selezione, che reimposta** lo zoom. 

### Sequenza temporale
<a name="explore-timeline"></a>

 La timeline mostra un elenco di intervalli all'interno della traccia. Ogni riga di estensione è composta dai seguenti componenti: 
+ Pulsante **Espandi figli**: espande o comprime tutti gli intervalli secondari dell'intervallo selezionato 
+ Nome servizio: nome del servizio che ha registrato l'intervallo
+ Nome dell'operazione: nome dell'operazione rappresentata da questo intervallo
+ Barra della durata dell'intervallo: rappresentazione visiva della durata dell'operazione all'interno della traccia

Scegliendo un punto qualsiasi della riga di span vengono visualizzati i dettagli dell'intervallo. 

### I dettagli dell'intervallo
<a name="explore-span-details"></a>

I dettagli dell'intervallo includono i seguenti elementi:
+  Nome operazione 
+  Metadati Span 
+  Tag (qualsiasi tag associato a questo intervallo) 
+  Metadati del processo (metadati relativi al processo che ha registrato questo intervallo) 
+  Registri: elenco dei log registrati da questo intervallo e dei valori chiave associati. Nel caso dei registri Zipkin, la sezione mostra le annotazioni Zipkin. 

## Navigazione tra Explore e una dashboard
<a name="navigating-between-explore-and-a-dashboard"></a>

 Per accelerare i flussi di lavoro che prevedono il passaggio regolare da Esplora a una dashboard e viceversa, abbiamo aggiunto la possibilità di tornare alla dashboard di origine dopo aver navigato su Esplora dal menu a discesa del pannello. 

 Dopo aver navigato su Esplora, dovresti notare un pulsante «Indietro» nella barra degli strumenti Esplora. 

 Basta scegliere il pulsante per tornare alla dashboard di origine oppure, se desideri riportare le modifiche apportate in Esplora nella dashboard, scegli semplicemente la freccia accanto al pulsante per visualizzare la voce di menu «Torna al pannello con le modifiche». 

## Interroga l'ispettore
<a name="query-inspector"></a>

 Per facilitare il debug delle query, Explore consente di esaminare le richieste e le risposte alle query, nonché le statistiche sulle query, tramite Query inspector. ****Questa funzionalità è simile alla scheda Statistiche dell'ispettore del pannello e alla scheda Query.**** Per ulteriori informazioni, consultare [Ispeziona le prestazioni delle query](inspect-a-panel.md#inspect-query-performance) e [Visualizza la richiesta e la risposta non elaborate alla fonte di dati](inspect-a-panel.md#view-raw-request-and-response-to-data-source). 

# Collegamento
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

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

 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. 

 Amazon Managed Grafana supporta link a dashboard, link a pannelli e link dati. I link al pannello di controllo vengono visualizzati nella parte superiore della dashboard. I link dei pannelli sono accessibili scegliendo un'icona nell'angolo superiore sinistro del pannello. 

## Quale link dovresti usare?
<a name="which-link-should-you-use"></a>

 Inizia esaminando 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. Sebbene tutti i tipi di link in Grafana vengano utilizzati per creare collegamenti ad altre dashboard o siti Web esterni, funzionano in contesti diversi. 
+  Per aggiungere link che si riferiscono alla maggior parte o a tutti i pannelli della dashboard, usa. [Collegamenti alla dashboard](dashboard-links.md) 
+  Per approfondire pannelli specifici, usa[Collegamenti al pannello](panel-links.md).
+  Per creare collegamenti a siti esterni, puoi utilizzare un collegamento alla dashboard o un collegamento al pannello. 
+  Per approfondire una serie specifica, o anche una singola misurazione, usa[Collegamenti dati](data-links.md). 

## Controllo dell'intervallo di tempo tramite l'URL
<a name="controlling-time-range-using-the-url"></a>

 Puoi controllare l'intervallo di tempo di un pannello o di un pannello di controllo fornendo i seguenti 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 millisecondi. Ad esempio, `?time=1500000000000&time.window=10000` risulterà in un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000 

# Collegamenti alla dashboard
<a name="dashboard-links"></a>

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

 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. Questo aiuta a garantire che la persona a cui invii il link stia visualizzando i dati corretti. Per altri tipi di link, vedi[Variabili di collegamento dati](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

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

## Aggiungere link ai pannelli di controllo
<a name="add-links-to-dashboards"></a>

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

1.  Durante la visualizzazione della dashboard a cui desideri aggiungere un link, scegli l'icona a forma di ingranaggio nella parte superiore dello schermo per aprire **le impostazioni della dashboard**. 

1.  Scegli **Collegamenti**, quindi scegli **Aggiungi link alla dashboard** o **Nuovo**. 

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

1.  Seleziona le opzioni di collegamento: 
   +  **Con tag**: inserisci i tag per limitare i dashboard collegati solo a quelli con i tag che inserisci. Altrimenti, l'area di lavoro Grafana include collegamenti a tutte le altre dashboard. 
   +  **Come menu a discesa**: seleziona questa opzione se ti colleghi a molte dashboard e aggiungi un titolo opzionale all'elenco a discesa. Se questa opzione non è selezionata, l'area di lavoro Grafana visualizza i link del dashboard uno accanto all'altro nella parte superiore della dashboard. 
   +  **Intervallo di tempo**: seleziona questa opzione per includere l'intervallo di tempo della dashboard nel link. Quando l'utente sceglie il link, la dashboard collegata si apre 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 sceglie il link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori del link.
   +  **Apri in una nuova scheda**: seleziona questa opzione per aprire il link alla dashboard in una nuova scheda o finestra. 

1.  Scegliere **Aggiungi**. 

## Aggiungere un link URL a una dashboard
<a name="add-a-url-link-to-a-dashboard"></a>

 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 anche controllare l'intervallo di tempo per assicurarti che l'utente veda i dati specifici nell'area di lavoro Grafana. 

1.  Durante la visualizzazione della dashboard a cui desideri collegarti, scegli l'icona a forma di ingranaggio nella parte superiore dello schermo per aprire le impostazioni della **dashboard**. 

1.  Scegli **Collegamenti**, quindi scegli **Aggiungi link alla dashboard** o **Nuovo**. 

1.  In **Tipo**, seleziona **link**. 

1.  Seleziona le opzioni di collegamento: 
   +  **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 dal link. 
   +  **Suggerimento**: inserisci il tooltip che desideri venga visualizzato dal link quando l'utente fa una pausa su di esso. 
   +  **Icona**: scegli l'icona che desideri visualizzare con il link. 
   +  **Intervallo di tempo**: seleziona questa opzione per includere l'intervallo di tempo della dashboard nel link. Quando l'utente sceglie il link, la dashboard collegata si apre con l'intervallo di tempo indicato già 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` definisci un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in millisecondi. Ad esempio, `?time=1500000000000&time.window=10000` restituisce 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 sceglie il link, tutti i modelli corrispondenti nella dashboard collegata vengono impostati sui valori del link, ad esempio https://play.grafana. org/d/000000074/alerting? var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval=1 ora 
   +  **Apri in una nuova scheda: seleziona questa opzione per aprire il link alla dashboard in una nuova scheda o finestra.** 

1.  Scegliere **Aggiungi**. 

## Aggiornamento di un link alla dashboard
<a name="update-a-dashboard-link"></a>

 Per modificare o aggiornare un collegamento alla dashboard esistente, utilizza la procedura seguente. 

1.  In **Impostazioni della dashboard**, nella scheda **Collegamenti**, scegli il link esistente che desideri modificare. 

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

## Duplicazione di un link alla dashboard
<a name="duplicate-a-dashboard-link"></a>

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

## Eliminazione di un link alla dashboard
<a name="delete-a-dashboard-link"></a>

 Per eliminare un link esistente alla dashboard, scegli l'icona del cestino corrispondente al link che desideri eliminare. 

# Collegamenti al pannello
<a name="panel-links"></a>

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

 Ogni pannello può avere il proprio set di link che vengono visualizzati nell'angolo superiore sinistro del pannello. Puoi collegarti a qualsiasi sito disponibile URLs, tra cui dashboard, pannelli o siti esterni. Puoi persino controllare l'intervallo di tempo per assicurarti che l'utente veda i dati specifici nell'area di lavoro Grafana. 

Scegliete l'icona nell'angolo in alto a sinistra di un pannello per visualizzare i collegamenti del pannello disponibili. 

## Aggiungere un link al pannello
<a name="add-a-panel-link"></a>

1.  Fate una pausa sul pannello a cui desiderate aggiungere un collegamento, quindi premete **e.** **Oppure scegli la freccia a discesa accanto al titolo del pannello, quindi scegli Modifica.** 

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

1.  Espandi **Collegamenti**, quindi scegli **Aggiungi collegamento**. 

1.  Inserisci un **titolo** per il link. Il titolo verrà visualizzato nell'interfaccia utente. 

1.  Inserisci l'**URL** a cui desideri collegarti. Puoi includere una delle variabili del modello definite nella dashboard. Premi **Ctrl\$1Spazio** o **Cmd\$1Spazio**, quindi scegli il campo **URL per visualizzare le variabili disponibili**. Quando aggiungete 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` definisci un intervallo di tempo da `time-time.window/2` a. `time+time.window/2` Entrambi i parametri devono essere specificati in millisecondi. Ad esempio, `?time=1500000000000&time.window=10000` restituisce un intervallo di tempo di 10 secondi compreso tra 1499999995000 e 1500000005000. 

1.  **Per aprire in una nuova scheda, seleziona Apri in una nuova scheda.** 

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

1.  Scegli **Salva** in alto a destra per salvare le modifiche nella dashboard. 

## Aggiornamento di un collegamento al pannello
<a name="update-a-panel-link"></a>

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

1.  Scegli l'icona **Modifica** (matita) per aprire la finestra **Modifica link**. 

1.  Apporta le modifiche necessarie: 

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

1.  Scegli **Salva** in alto a destra per salvare le modifiche nella dashboard. 

## Eliminazione di un collegamento al pannello
<a name="delete-a-panel-link"></a>

1.  Nella scheda **Pannello**, individuate il link che desiderate eliminare. 

1.  Scegli l'icona **X** accanto al link che desideri eliminare. 

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

# Collegamenti dati
<a name="data-links"></a>

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

 I link dati forniscono un contesto più granulare ai link. È possibile creare collegamenti che includono il nome della serie o anche il valore. Ad esempio, se la visualizzazione mostra quattro server, è possibile aggiungere un collegamento dati a uno o due di essi. 

 Il link stesso è accessibile in diversi modi, a seconda della visualizzazione. Per il pannello grafico, devi scegliere un punto dati o una linea. Per un pannello come stat, gauge o bar gauge, puoi scegliere un punto qualsiasi della visualizzazione per aprire il menu contestuale. 

 Puoi utilizzare le variabili nei link dati per indirizzare le persone a una dashboard dettagliata con filtri di dati conservati. Ad esempio, puoi utilizzare le variabili per specificare un intervallo di tempo, una serie e una selezione di variabili. Per ulteriori informazioni, consulta [Variabili di collegamento dati](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

## Suggerimenti Typeahead
<a name="typeahead-suggestions"></a>

 Quando crei o aggiorni un collegamento dati, premi **Ctrl\$1Space o Cmd\$1Space** **Cmd\$1Space** sulla tastiera per aprire i suggerimenti di digitazione e aggiungere più facilmente variabili all'URL. 

## Aggiungere un collegamento dati
<a name="add-a-data-link"></a>

1.  Fate una pausa sul pannello a cui desiderate aggiungere un collegamento, quindi premete **e.** **Oppure scegli la freccia a discesa accanto al titolo del pannello, quindi scegli Modifica.** 

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

1.  Espandi **Collegamenti dati**, quindi scegli **Aggiungi collegamento**. 

1.  Inserisci un **titolo** per il link. Il titolo verrà visualizzato nell'interfaccia utente. 

1.  Inserisci l'**URL** a cui desideri collegarti. 

    Puoi aggiungere una delle variabili del modello definite nella dashboard. Scegli il campo **URL**, quindi digita **\$1** oppure premi **** Ctrl\$1Spazio o **Cmd\$1Spazio** per visualizzare un elenco di variabili disponibili. Quando aggiungete variabili modello al link del pannello, il link rimanda l'utente al contesto giusto, con le variabili pertinenti già impostate. Per ulteriori informazioni, consulta [Variabili di collegamento dati](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

1.  Per aprirlo in una nuova scheda, selezionate **Apri in una nuova scheda**. 

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

1.  Scegli **Salva** in alto a destra per salvare le modifiche nella dashboard. 

## Aggiornamento di un collegamento dati
<a name="update-a-data-link"></a>

1.  Nella scheda **Campo**, individua il link a cui desideri apportare modifiche. 

1.  Scegli l'icona **Modifica** (matita) per aprire la finestra **Modifica link**. 

1.  Apporta le modifiche necessarie: 

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

1.  Scegli **Salva** in alto a destra per salvare le modifiche nella dashboard. 

## Eliminazione di un collegamento dati
<a name="delete-a-data-link"></a>

1.  Nella scheda **Campo**, individua il link che desideri eliminare. 

1.  Scegli l'icona **X** accanto al link che desideri eliminare. 

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

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

 È possibile utilizzare le variabili nei collegamenti dati per visualizzare campi, etichette e valori delle serie. Per ulteriori informazioni sui collegamenti dati, consulta[Collegamenti dati](data-links.md). 

 Per visualizzare un elenco di variabili disponibili, inserisci **\$1** nel campo **URL** del collegamento dati. 

 Puoi anche utilizzare variabili modello nei tuoi link dati URLs. Per ulteriori informazioni, consulta [Modelli e variabili](templates-and-variables.md). 

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

 È possibile utilizzare le seguenti variabili per includere l'intervallo di tempo corrente nell'URL del collegamento dati: 
+  `__url_time_range`— L'intervallo di tempo della dashboard corrente, ad esempio `?from=now-6h&to=now` 
+  `$__from and $__to`— Per ulteriori informazioni, vedere [Variabili globali] (\$1\$1< relref «.. /variables/variable-types/global-variables.md \$1\$1\$1from -and-\$1\$1to» >\$1\$1). 

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

 Le variabili specifiche della serie sono disponibili nel namespace: `__series` 
+  `__series.name`— Aggiunge il nome della serie all'URL 
+  `__series.labels.<LABEL>`— Aggiunge il valore dell'etichetta all'URL. Se l'etichetta contiene punti, usa la `__series.labels["<LABEL>"]` sintassi. 

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

 Le variabili specifiche del campo sono disponibili nel namespace: `__field` 
+  `__field.name`— Il nome del campo 

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

 Le variabili con valori specifici sono disponibili nel namespace: `__value` 
+  `__value.time`— Il timestamp del valore (Unix ms epoch) relativo all'URL; ad esempio, `?time=1560268814105` 
+  `__value.raw`— Il valore grezzo 
+  `__value.numeric`— La rappresentazione numerica di un valore 
+  `__value.text`— La rappresentazione testuale di un valore 
+  `__value.calc`— Il nome del calcolo se il valore è il risultato del calcolo 

### Variabili del modello
<a name="template-variables"></a>

 Quando ti colleghi a un'altra dashboard che utilizza variabili modello, seleziona i valori delle variabili per chi sceglie il link. 

 Usa`var-myvar=${myvar}`, where `myvar` è un nome della variabile modello che corrisponde a quella della dashboard corrente che desideri utilizzare. 

 Per aggiungere tutte le variabili della dashboard corrente all'URL, usa`__all_variables`. 

# Modelli e variabili
<a name="templates-and-variables"></a>

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

Una variabile è un segnaposto per un valore. È possibile utilizzare le variabili nelle query metriche e nei titoli dei pannelli. Le variabili ti danno la possibilità di creare dashboard più interattive e dinamiche. Invece di inserire elementi come 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. Quando modifichi il valore utilizzando l'elenco a discesa nella parte superiore della dashboard, le query metriche del pannello riflettono il nuovo valore. 

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

Utilizzando variabili e modelli, puoi creare dashboard da un'unica fonte. 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. Questo semplifica la manutenzione e la manutenzione. 

Per un elenco dei tipi di variabili supportati e le istruzioni per aggiungere ogni tipo di variabile, vedere [Tipi di variabili](variables-types.md)

## Modelli
<a name="templates"></a>

 Un *modello* è qualsiasi interrogazione che contiene una variabile. 

Ad esempio, se stavi amministrando una dashboard per monitorare diversi server, potresti creare una dashboard per ogni server. In alternativa, è possibile creare una dashboard e utilizzare pannelli con query basate su modelli, come illustrato nell'esempio seguente. 

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

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

## Procedure ottimali variabili
<a name="variable-best-practices"></a>

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 della dashboard.

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

 I titoli dei pannelli e le query metriche possono visualizzare le variabili utilizzando due diverse sintassi: 
+  `$varname`Questa sintassi è più facile da leggere, come nell'esempio seguente:. `apps.frontend.$server.requests.count` Tuttavia, non è possibile utilizzare una variabile al centro di una parola. 
+  `${var_name}`Utilizzate questa sintassi quando desiderate interpolare una variabile al centro di un'espressione. 
+  `${var_name:<format>}`Questo formato offre un maggiore controllo sul modo in cui Grafana interpola i valori. Per ulteriori informazioni, consulta [Opzioni avanzate di formato variabile](#advanced-variable-format-options). 

 Prima che le query vengano inviate alla fonte di dati, la query viene *interpolata*, il che significa che la variabile viene sostituita con il suo valore corrente. Durante l'interpolazione, è possibile che il valore della variabile venga *ignorato per renderlo* conforme 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 Prometheus verrà escapata da regex. Leggi l'argomento della documentazione specifico sulla fonte di dati per i dettagli sulla fuga di valore durante l'interpolazione. 

 Per informazioni sulla sintassi avanzata per sovrascrivere la formattazione predefinita dell'origine dati, consulta. [Opzioni avanzate di formato variabile](#advanced-variable-format-options) 

# Tipi di variabili
<a name="variables-types"></a>

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

 Grafana utilizza diversi tipi di variabili. 


|  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. Per ulteriori informazioni, consulta [Aggiungere una variabile di query](#add-a-query-variable).  | 
|  Personalizzato  |  Definite manualmente le opzioni delle variabili utilizzando un elenco separato da virgole. Per ulteriori informazioni, consulta [Aggiungere una variabile personalizzata](#add-a-custom-variable).  | 
|  Text box (Casella di testo)  |  Visualizza un campo di immissione di testo con un valore predefinito opzionale. Per ulteriori informazioni, consulta [Aggiungere una variabile alla casella di testo](#add-a-text-box-variable).  | 
|  Costante  |  Definire una costante nascosta. Per ulteriori informazioni, consulta [Aggiungere una variabile costante](#add-a-constant-variable).  | 
|  Origine dati  |  Cambia rapidamente la fonte di dati per un intero pannello di controllo. Per ulteriori informazioni, consulta [Aggiungere una variabile di origine dati](#add-a-data-source-variable).  | 
|  Interval  |  Le variabili di intervallo rappresentano intervalli di tempo. Per ulteriori informazioni, consulta [Aggiungere una variabile di intervallo](#add-an-interval-variable).  | 
|  Filtri ad hoc  |  Key/value filtri che vengono aggiunti automaticamente a tutte le query metriche per un'origine dati (InfluxDB, Prometheus e solo). OpenSearch Per ulteriori informazioni, consulta [Aggiungere filtri ad hoc](#add-ad-hoc-filters).  | 
|  Variabili globali  |  Variabili integrate che possono essere utilizzate nelle espressioni dell'editor di query. Per ulteriori informazioni, consulta [Variabili globali](#global-variables).  | 
|  Variabili concatenate  |  Le interrogazioni variabili possono contenere altre variabili. Per ulteriori informazioni, consulta [Variabili concatenate](#chained-variables).  | 

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

 Utilizzando le variabili di query, puoi scrivere una query sull'origine dati che restituisce 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 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. 

### Espressioni di interrogazione
<a name="query-expressions"></a>

Le espressioni di query sono diverse per ogni fonte di dati. Per ulteriori informazioni, consulta la documentazione relativa alla tua fonte di dati all'indirizzo[Connessione alle origini dati](AMG-data-sources.md).

### Inserimento di opzioni generali
<a name="enter-general-options"></a>

**Per inserire opzioni generali per una variabile di interrogazione**

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

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

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

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

1. (Facoltativo) Per **Label**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

1.  Scegli un'opzione **Nascondi**: 
   +  **Nessuna selezione (vuoto)**: l'elenco a discesa delle variabili mostra il **nome** o il valore dell'**etichetta** della variabile. Questa è l’impostazione predefinita. 
   +  **Etichetta**: l'elenco a discesa delle variabili 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. 

### Inserimento delle opzioni di interrogazione
<a name="enter-query-options"></a>

**Per inserire le opzioni di interrogazione per una variabile di interrogazione**

1. Nell'elenco **Origine dati**, selezionare l'origine dati di destinazione per la query. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md).

1.  Nell'elenco **Aggiorna**, selezionate quando la variabile deve aggiornare le opzioni. 
   +  **Mai**: memorizza nella cache le interrogazioni relative alle variabili e i valori non vengono aggiornati. Ciò va bene se i valori non cambiano mai, ma è problematico se sono dinamici e cambiano molto. 
   +  **On Dashboard Load**: interroga l'origine dati ogni volta che viene caricata la 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 query sulle opzioni variabili contiene un filtro per intervallo di tempo o dipende dall'intervallo di tempo del dashboard. 

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

1. (Facoltativo) Nel campo **Regex**, digita un'espressione regex per filtrare o acquisire parti specifiche dei nomi restituiti dalla query sull'origine dati. Per alcuni esempi, consulta [Filtrare le variabili con regex](templates-and-variables.md#filter-variables-with-regex). 

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**. Per ulteriori informazioni, consulta [Inserimento delle opzioni di selezione delle variabili](templates-and-variables.md#enter-variable-selection-options). 

1.  In **Anteprima dei valori**, l'area di lavoro Grafana visualizza un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti. 

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

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

 Usa una variabile *personalizzata* per valori che non cambiano. Potrebbero essere numeri, stringhe o anche altre variabili. 

Ad esempio, se hai nomi di server o nomi di aree che non cambiano, puoi crearli come variabili personalizzate anziché variabili di query. Poiché non cambiano, è possibile utilizzarle in variabili concatenate anziché in altre variabili di query. Ciò ridurrebbe il numero di query che Grafana deve inviare quando le variabili concatenate vengono aggiornate. Per ulteriori informazioni sulle variabili concatenate, vedere. [Variabili concatenate](#chained-variables) 

### Inserimento di opzioni generali
<a name="variables-enter-general-options"></a>

**Per inserire le opzioni di interrogazione per una variabile personalizzata**

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

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

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

1.  Nell'elenco **Tipo**, scegli **Personalizzato**. 

1. (Facoltativo) Per **Etichetta**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

1.  Scegli un'opzione **Nascondi**: 
   +  **Nessuna selezione (vuoto)**: l'elenco a discesa delle variabili mostra il **nome** o il valore dell'**etichetta** della variabile. Questa è l’impostazione predefinita. 
   +  **Etichetta** ‐ Il menu a discesa dell'elenco delle variabili 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. 

### Inserimento di opzioni personalizzate
<a name="enter-custom-options"></a>

**Per inserire opzioni personalizzate per una variabile personalizzata**

1. Nell'elenco **Valori separati da virgole**, immettete i valori di questa variabile in un elenco separato da virgole. È possibile includere numeri, stringhe, altre variabili o coppie chiave-valore separate da due punti. 

1.  **(Facoltativo) Inserite le opzioni di selezione.** Per ulteriori informazioni, consulta [Inserimento delle opzioni di selezione delle variabili](templates-and-variables.md#enter-variable-selection-options). 

1.  In **Anteprima dei valori**, l'area di lavoro Grafana visualizza un elenco dei valori delle variabili correnti. Controllali per assicurarti che corrispondano a ciò che ti aspetti. 

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

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

 Le variabili delle *caselle* di testo visualizzano un campo di immissione di testo 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. 

### Inserimento di opzioni generali
<a name="text-box-enter-general-options"></a>

**Per inserire opzioni generali per una variabile di casella di testo**

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

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

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

1.  Nell'elenco **Tipo**, seleziona la **casella Testo**. 

1. (Facoltativo) Per **Label**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

1.  Scegli un'opzione **Nascondi**: 
   +  **Nessuna selezione (vuoto)**: l'elenco a discesa delle variabili mostra il **nome** o il valore dell'**etichetta** della variabile. Questa è l’impostazione predefinita. 
   +  **Etichetta**: l'elenco a discesa delle variabili 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. 

### Inserimento delle opzioni di testo
<a name="enter-text-options"></a>

**Per inserire le opzioni di testo per una variabile di casella di testo**

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 è possibile 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. Scegli **Aggiungi** per aggiungere la variabile alla dashboard. 

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

Per definire una costante nascosta, utilizzate variabili *costanti*. Le variabili costanti sono utili 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 un solo valore. Per aggiornarla, è necessario aggiornare le impostazioni della variabile. 

Le variabili costanti sono utili quando si dispone di valori complessi che è necessario includere nelle query ma non si desidera riscrivere in ogni singola query. Ad esempio, se hai chiamato un percorso del server`i-0b6a61efe2ab843gg`, puoi sostituirlo con una variabile chiamata. `$path_gg` 

### Inserimento di opzioni generali
<a name="constant-variable-enter-general-options"></a>

**Per inserire opzioni generali per una variabile costante**

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

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

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

1.  Nell'elenco **Tipo**, selezionate **Costante**. 

1. (Facoltativo) Per **Label**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

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

### Inserimento di opzioni costanti
<a name="enter-constant-options"></a>

**Per inserire opzioni costanti per una variabile costante**

1. Nel campo **Valore**, immettere il valore della variabile. È possibile inserire lettere, numeri e simboli. Se utilizzi opzioni avanzate di formato variabile, puoi persino usare le wild card. Per ulteriori informazioni, consulta [Opzioni avanzate di formato variabile](templates-and-variables.md#advanced-variable-format-options). 

1. In **Anteprima dei valori**, l'area di lavoro Grafana visualizza il valore della variabile corrente. Controllalo per assicurarti che corrisponda a quello che ti aspetti. 

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

## Aggiungere una variabile di origine dati
<a name="add-a-data-source-variable"></a>

Per modificare rapidamente l'origine dati per un'intera dashboard, puoi utilizzare le variabili dell'*origine dati*. Sono utili se hai più istanze di un'origine dati, magari in ambienti diversi. 

### Inserimento di opzioni generali
<a name="data-source-enter-general-options"></a>

**Per inserire opzioni generali per una variabile di origine dati**

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

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

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

1.  Nell'elenco **Tipo**, seleziona **Datasource**. 

1. (Facoltativo) Per **Label**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

1.  Scegli un'opzione **Nascondi**: 
   +  **Nessuna selezione (vuoto)**: l'elenco a discesa delle variabili mostra il **nome** o il valore dell'**etichetta** della variabile. Questa è l’impostazione predefinita. 
   +  **Etichetta**: l'elenco a discesa delle variabili 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. 

### Inserimento delle opzioni relative all'origine dei dati
<a name="enter-data-source-options"></a>

**Per inserire le opzioni relative all'origine dati per una variabile dell'origine dati**

1.  Nell'elenco **Tipo**, selezionate l'origine dati di destinazione per la variabile. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md). 

1. (Facoltativo) Per **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. Mantieni vuoto questo campo per visualizzare tutte le istanze. 

1.  (Facoltativo) Inserite **le opzioni di selezione**. Per ulteriori informazioni, consulta [Inserimento delle opzioni di selezione delle variabili](templates-and-variables.md#enter-variable-selection-options). 

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. Scegli **Aggiungi** per aggiungere la variabile alla dashboard. 

## Aggiungere una variabile di intervallo
<a name="add-an-interval-variable"></a>

Usa una variabile di *intervallo* per rappresentare intervalli di tempo come`1m`,,. `1h` `1d` Puoi considerarli come un comando a livello di dashboard group-by-time. 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) o come parametro della funzione di riepilogo (per Graphite OpenSearch). 

### Inserimento di opzioni generali
<a name="interval-variable-enter-general-options"></a>

**Per inserire opzioni generali per una variabile di intervallo**

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

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

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

1.  Nell'elenco **Tipo**, selezionate **Intervallo.** 

1. (Facoltativo) Per **Label**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

1.  Scegli un'opzione **Nascondi**: 
   +  **Nessuna selezione (vuoto)**: l'elenco a discesa delle variabili mostra il **nome** o il valore dell'**etichetta** della variabile. Questa è l’impostazione predefinita. 
   +  **Etichetta**: l'elenco a discesa delle variabili 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. 

### Inserimento delle opzioni relative agli intervalli
<a name="enter-interval-options"></a>

**Per inserire le opzioni di intervallo per una variabile di intervallo**

1.  Nel campo **Valori**, inserisci gli intervalli di intervallo 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 automatica** se desideri aggiungere l'`auto`opzione all'elenco. Utilizzate questa opzione per specificare quante volte deve essere diviso l'intervallo di tempo corrente per calcolare l'intervallo di `auto` tempo corrente. Se lo attivi, 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, `2m` Grafana raggruppa i dati in 15 incrementi da 2 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. Scegli **Aggiungi** per aggiungere la variabile alla dashboard. 

### Esempi di variabili a intervallo
<a name="interval-variable-examples"></a>

 Esempio di utilizzo della variabile template `myinterval` in una funzione Graphite: 

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

 Un esempio di grafite più complesso: 

```
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
```

## Aggiungere filtri ad hoc
<a name="add-ad-hoc-filters"></a>

Puoi utilizzare filtri monouso o *ad hoc* per 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 monouso nelle query. Li utilizzate invece per scrivere filtri per le interrogazioni esistenti. 

**Nota**  
**Nota:** le variabili di filtro una tantum o ad hoc funzionano solo con InfluxDB, Prometheus e fonti di dati. OpenSearch 

### Inserimento di opzioni generali
<a name="ad-hoc-filters-enter-general-options"></a>

**Per inserire opzioni generali per un filtro ad hoc**

1. Vai alla dashboard per cui desideri creare una variabile, quindi scegli l'icona **delle impostazioni della dashboard** (ingranaggio) nella parte superiore della pagina. 

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

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

1.  Nell'elenco **Tipo**, selezionate **Filtri ad hoc**. 

1. (Facoltativo) Per **Etichetta**, inserite il nome visualizzato dell'elenco a discesa delle variabili. Se non inserisci un nome visualizzato, l'etichetta del menu a discesa sarà il nome della variabile. 

1.  Scegli un'opzione **Nascondi**: 
   +  **Nessuna selezione (vuoto)**: l'elenco a discesa delle variabili mostra il **nome** o il valore dell'**etichetta** della variabile. Questa è l’impostazione predefinita. 
   +  **Etichetta**: l'elenco a discesa delle variabili 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. 

### Inserimento delle opzioni
<a name="ad-hoc-enter-options"></a>

**Per inserire le opzioni per un filtro ad hoc**

1.  Nell'elenco **Origine dati**, seleziona l'origine dati di destinazione. Per ulteriori informazioni sulle fonti di dati, consulta[Connessione alle origini dati](AMG-data-sources.md). 

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

### Creazione di filtri ad hoc
<a name="create-ad-hoc-filters"></a>

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 la creazione di una query ad hoc a livello di dashboard. I filtri applicati in questo modo vengono applicati a tutti i pannelli della dashboard. 

## Variabili concatenate
<a name="chained-variables"></a>

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

Le interrogazioni 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 supporti. 

Puoi creare dashboard complesse, collegate e basate su modelli, con una profondità di 5 o 10 livelli. Tecnicamente, non ci sono limiti alla profondità o alla complessità che puoi raggiungere, ma più link hai, maggiore è il carico delle query. 

### Buone pratiche e suggerimenti
<a name="variables-best-practices-and-tips"></a>

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

#### Creazione di nuove variabili concatenate
<a name="creating-new-linked-variables"></a>
+  Il concatenamento di variabili crea dipendenze padre-figlio. Puoi immaginarle come una scala o un albero. 
+ Il modo più rapido per creare una nuova variabile concatenata è copiare la variabile su cui si desidera basare quella nuova. Nell'elenco delle variabili, scegli l'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 concatenate create in questo modo vengono visualizzate in fondo all'elenco. Per assegnare un ordine logico all'elenco, trascinate la variabile in una posizione diversa nell'elenco. 

#### Ordine delle variabili
<a name="variable-order"></a>

Per modificare l'ordine delle variabili nell'elenco delle variabili del dashboard, scegli le frecce su e giù sul lato destro di ogni voce. L'area di lavoro Grafana elenca gli elenchi a discesa delle variabili da sinistra a destra in base a questo elenco, visualizzando la variabile nella parte superiore dell'elenco all'estrema sinistra. 
+  Elenca le variabili che non hanno dipendenze in alto, prima delle relative variabili secondarie. 
+  Ogni variabile deve seguire quella da cui dipende. 
+ L'interfaccia utente non indica quali variabili hanno relazioni di dipendenza. Elenca le variabili in ordine logico per renderle più chiare agli utenti finali (e a te stesso). 

#### Considerazione della complessità
<a name="complexity-consideration"></a>

Maggiore è il numero di livelli di dipendenza nelle variabili, maggiore è 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), l'area di lavoro Grafana deve eseguire query per tutte le variabili dipendenti prima di aggiornare le visualizzazioni nella dashboard. 

## Variabili globali
<a name="global-variables"></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
<a name="global-variable-dashboard"></a>

Questa variabile è il nome della dashboard corrente. 

### \$1\$1\$1from e \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

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


|  Sintassi  |  Risultato dell’esempio  |  Description  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Epoca Unix in millisecondi  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T 20:19:09.254 Z  |  Nessun args, il valore predefinito è ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Epoca dei secondi di Unix  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  Qualsiasi formato di dati personalizzato. Per ulteriori informazioni, consulta [Display](https://momentjs.com/docs/#/displaying/).  | 

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

Puoi usare questa variabile anche URLs in. Ad esempio, per inviare un utente finale a una dashboard che mostra un intervallo di tempo compreso tra sei ore fa e ora, utilizza il seguente URL: https://play.grafana. org/d/000000012/grafana-giocare a casa? viewpanel=2&orgid=1? da=ora-6h&a=adesso 

### \$1\$1\$1intervallo
<a name="global-variable-interval"></a>

*È possibile utilizzare la `$__interval` variabile come parametro per raggruppare in base all'ora (per InfluxDB, Myself, Postgres, MSSQL), all'intervallo dell'istogramma di data (per) o come parametro della funzione di riepilogo (per Graphite OpenSearch).* 

L'area di lavoro 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, è più efficiente raggruppare per 1 giorno che per 10 secondi quando si esaminano 3 mesi di dati. Il grafico avrà lo stesso aspetto e la query sarà più veloce. `$__interval`Viene calcolato utilizzando l'intervallo di tempo e la larghezza del grafico (il numero di pixel). 

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

Ad esempio, quando l'intervallo di tempo è di 1 ora e il grafico è a schermo intero, l'intervallo può 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 sono raggruppati per giorno. 

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

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

### \$1\$1\$1interval\$1ms
<a name="global-variable-interval_ms"></a>

 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\$1name
<a name="global-variable-name"></a>

 **Questa variabile è disponibile solo nel pannello Singlestat e può essere utilizzata nei campi del prefisso o del suffisso della scheda Opzioni.** La variabile verrà sostituita con il nome o l'alias della serie. 

### \$1\$1\$1org
<a name="global-variable-org"></a>

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

### \$1\$1\$1user
<a name="global-variable-user"></a>

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

### \$1\$1\$1range
<a name="global-variable-range"></a>

Questa variabile è attualmente supportata solo per le fonti di dati Prometheus. Questa variabile rappresenta l'intervallo per la dashboard corrente. Viene calcolata da`to - from`. Ha rappresentazioni in millisecondi e secondi chiamate e. `$__range_ms` `$__range_s` 

### \$1timeFilter o \$1\$1\$1timeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

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

 Questa variabile viene utilizzata in diversi punti, 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. 

## Altre opzioni variabili
<a name="other-variable-options"></a>

Questa sezione spiega le altre opzioni variabili disponibili.

### Inserimento delle opzioni di selezione delle variabili
<a name="enter-variable-selection-options"></a>

È possibile utilizzare **le opzioni di selezione** per gestire le selezioni di opzioni variabili. Tutte le opzioni di selezione sono opzionali e sono disattivate per impostazione predefinita. 

#### Valore multiplo
<a name="multi-value"></a>

Se attivi questa opzione, l'elenco a discesa delle variabili supporta la selezione di più opzioni contemporaneamente. Per ulteriori informazioni, consulta [Formattazione di variabili multivalore](#formatting-multi-value-variables). 

#### Opzione Includi tutto
<a name="include-all-option"></a>

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

#### Personalizza tutti i valori
<a name="custom-all-value"></a>

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

Per definire il valore dell'`All`opzione, inserisci la sintassi regex, glob o Lucene nel campo **Custom** all value. 

Per impostazione predefinita, il `All` valore include tutte le opzioni nell'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 di tipo wild card. 

Quando utilizzi la sintassi personalizzata regex, glob o Lucene nell'opzione **Custom all value**, non viene mai ignorata, quindi devi considerare quale sia un valore valido per la tua origine dati. 

### Opzioni avanzate di formato variabile
<a name="advanced-variable-format-options"></a>

 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` Per fare ciò, usa le seguenti opzioni avanzate di formattazione delle variabili. 

#### Sintassi generale
<a name="general-syntax"></a>

 Sintassi: `${var_name:option}` 

Se viene specificata un'opzione di formattazione non valida, `glob` è l'opzione predefinita o di riserva. 

#### CSV
<a name="variables-csv"></a>

 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
<a name="distributed---opentsdb"></a>

 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
<a name="doublequote"></a>

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

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

#### Glob - Grafite
<a name="glob---graphite"></a>

 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
<a name="json"></a>

 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 - OpenSearch
<a name="lucene---opensearch"></a>

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

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

#### Codice percentuale
<a name="percentencode"></a>

 Formatta le variabili a valore singolo e multivalore da utilizzare nei parametri URL. 

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

#### Pipeline
<a name="pipe"></a>

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

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

#### Raw
<a name="raw"></a>

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

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

#### Espressione regolare
<a name="regex"></a>

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

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

#### Citazione singola
<a name="singlequote"></a>

 Formatta le variabili a valore singolo e multiplo 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
<a name="sqlstring"></a>

 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'"
```

#### Testo
<a name="text"></a>

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

### Formattazione di variabili multivalore
<a name="formatting-multi-value-variables"></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 abilitando ogni plug-in di origine dati a 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 lo lasci vuoto, la Grafana concatena (somma) tutti i valori della query. `value1,value2,value3`Qualcosa del genere. Se viene utilizzato un `all` valore personalizzato, il valore sarà invece qualcosa come `*` o`all`. 

#### Variabili multivalore con una fonte di dati Graphite
<a name="multi-value-variables-with-a-graphite-data-source"></a>

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

#### Variabili multivalore con un'origine dati Prometheus o InfluxDB
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

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

#### Variabili multivalore con un'origine dati elastica
<a name="multi-value-variables-with-an-elastic-data-source"></a>

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

#### Risoluzione dei problemi di formattazione
<a name="formatting-troubles"></a>

 L'escape e la formattazione automatici possono causare problemi. Può essere difficile comprendere la logica alla base di un problema, specialmente 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 questa operazione di escape e formattazione automatica delle espressioni regolari, devi eseguire una delle seguenti operazioni:
+ **Disattiva le opzioni dell'opzione **Multivalore Includi** tutto.**
+ Usa il [formato variabile non elaborato] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1).

### Filtrare le variabili con regex
<a name="filter-variables-with-regex"></a>

 Utilizzando l'opzione Regex Query, è possibile filtrare l'elenco di opzioni restituite dalla variabile query o modificare le opzioni restituite. 

Questa sezione mostra come utilizzare regex per filtrare e modificare i valori nell'elenco 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, vedete [Espressioni regolari](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). 

 Esempi di filtraggio nel seguente elenco di opzioni: 

```
backend_01
backend_02
backend_03
backend_04
```

#### Filtraggio in modo che vengano restituite solo le opzioni che terminano con `01` o `02`
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 Regex: 

```
/.*[01|02]/
```

 Risultato: 

```
backend_01
backend_02
```

#### Filtraggio e modifica delle opzioni utilizzando un gruppo di acquisizione regex per restituire parte del testo
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 Regex: 

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

 Risultato: 

```
01
02
```

#### Filtraggio e modifica - Esempio di Prometheus
<a name="filter-and-modify---prometheus-example"></a>

 Elenco di opzioni: 

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

 Regex: 

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

 Risultato: 

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

#### Filtraggio e modifica utilizzando testo denominato e gruppi di acquisizione di valori
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

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

 Ad esempio, quando si esegue una query sulla metrica `node_hwmon_chip_names` Prometheus, è più intuitivo del valore. `chip_name` `chip` Inizia con 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
```

 Passalo attraverso la seguente Regex. 

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

 Viene prodotto 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
```

 **Nota:** sono supportati solo `text` i nomi dei gruppi di `value` acquisizione. 

### Pannelli o righe ripetuti
<a name="repeat-panels-or-rows"></a>

 Puoi creare dashboard dinamici utilizzando variabili *modello*. Tutte le variabili delle query si espandono fino al valore corrente della variabile prima che la query venga inviata al database. Con le variabili, puoi riutilizzare un'unica dashboard per tutti i tuoi servizi. 

 Le variabili del modello possono essere molto utili per modificare dinamicamente le query su un'intera dashboard. *Se vuoi che Grafana crei dinamicamente nuovi pannelli o righe in base ai valori che hai selezionato, puoi usare la funzione Ripeti.* 

#### Pannelli ripetuti
<a name="repeating-panels"></a>

 Se hai una variabile con `Multi-value` o `Include all value` opzioni attivate, puoi scegliere un pannello e fare in modo che Grafana ripeta quel pannello per ogni valore selezionato. Puoi trovare la funzione *Ripeti* nella *scheda Generale* in modalità di modifica del pannello. 

 `direction`Controlla come sono disposti i pannelli. 

Se si sceglie`horizontal`, i pannelli vengono disposti side-by-side. Grafana regola automaticamente la larghezza di ogni pannello ripetuto in modo da riempire l'intera riga. Attualmente, non è possibile mescolare altri pannelli su una riga con un pannello ripetuto. 

 Imposta `Max per row` per indicare a Grafana quanti pannelli per riga desideri al massimo. *Il valore predefinito è 4.* 

Se si sceglie`vertical`, i pannelli sono disposti dall'alto verso il basso in una colonna. La larghezza dei pannelli ripetuti è la stessa del primo pannello (il modello originale) che viene ripetuto. 

Apportate modifiche solo al primo pannello (il modello originale). Affinché le modifiche abbiano effetto su tutti i pannelli, devi avviare una ricostruzione dinamica della dashboard. Puoi farlo modificando il valore della variabile (ovvero la base per la ripetizione) o ricaricando la dashboard. 

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

#### Righe ripetute
<a name="repeating-rows"></a>

 Come visto sopra, con i pannelli, puoi anche ripetere le righe se hai delle variabili impostate con `Multi-value` o un'opzione di `Include all value` selezione. 

 Per attivare questa funzione, devi prima aggiungere una nuova *riga* utilizzando il menu *Aggiungi pannello*. Quindi fai una pausa sul titolo della riga e scegli il pulsante a forma di ingranaggio per accedere al pannello di `Row Options` configurazione. È quindi possibile selezionare la variabile per la quale si desidera ripetere la riga. 

 È consigliabile utilizzare una variabile anche nel titolo della riga. 

# Avvisi Grafana
<a name="alerts-overview"></a>

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

Gli avvisi Grafana ti forniscono avvisi affidabili e utilizzabili che ti aiutano a conoscere i problemi nei sistemi subito dopo che si sono verificati, riducendo al minimo l'interruzione dei tuoi servizi.

Amazon Managed Grafana include l'accesso a un sistema di avvisi aggiornato, *Grafana alerting, che centralizza le informazioni sugli avvisi* in un'unica visualizzazione ricercabile. Include le seguenti funzionalità:
+ Crea e gestisci avvisi Grafana in una vista centralizzata.
+ Crea e gestisci avvisi gestiti da Cortex e Loki tramite un'unica interfaccia. Per ulteriori informazioni, consulta [Gestisci le tue regole di avviso](v9-alerting-managerules.md).
+ Visualizza le informazioni sugli avvisi da Prometheus, Amazon Managed Service for Prometheus e altre fonti di dati compatibili con Alertmanager.
+ Crea più istanze di avviso da un'unica regola di avviso. Per ulteriori informazioni, consulta [Regole singole e multidimensionali](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Gestisci le tue risorse di avviso con terraform o provisioning. APIs Per ulteriori informazioni, consulta [Fornitura di risorse Grafana Alerting](v9-alerting-setup-provision.md).

Per l'area di lavoro Amazon Managed Grafana esistente, l'impostazione predefinita è. [Avvisi classici del pannello di controllo](old-alerts-overview.md) Per migrare agli avvisi Grafana, è necessario [migrare](alert-opt-in.md) agli avvisi Grafana.

Per ulteriori informazioni sugli avvisi Grafana, consulta. [Cosa c'è di nuovo negli avvisi Grafana](alerts-whats-new.md)

Gli avvisi Grafana hanno quattro componenti chiave:
+ [Regola di avviso](alert-rules.md): criteri di valutazione che determinano se viene avviato un avviso. Consiste in una o più interrogazioni ed espressioni, una condizione, la frequenza di valutazione e, facoltativamente, la durata durante la quale la condizione viene soddisfatta.
+ [Punto di contatto](alert-contact-points.md): canale per l'invio di notifiche quando vengono soddisfatte le condizioni di una regola di avviso. 
+ [Politica di notifica](alert-notifications.md): set di criteri di abbinamento e raggruppamento utilizzati per determinare la frequenza delle notifiche.
+ [Silenzi](alert-silences.md): data e criteri di corrispondenza utilizzati per silenziare le notifiche.

Quando gli avvisi Grafana sono abilitati, puoi:
+ [Crea regole di avviso gestite Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Crea regole di avviso gestite da Cortex o Loki](alert-rules.md#create-alert-rule)
+ [Visualizza le regole di avviso esistenti e gestisci il loro stato attuale](alert-rules.md#manage-alert-rules)
+ [Visualizza lo stato e lo stato delle regole di avviso](alert-fundamentals.md#alerts-state)
+ [Aggiungere o modificare un punto di contatto per gli avvisi](alert-contact-points.md#alert-working-contact-points)
+ [Aggiungere o modificare le politiche di notifica](alert-notifications.md#alert-notifications-working)
+ [Aggiungi o modifica silenzi](alert-silences.md)

## Limitazioni
<a name="alert-limitations"></a>
+ Il sistema di avvisi Grafana può recuperare le regole da tutte le fonti di dati Amazon Managed Service per Prometheus, Prometheus, Loki e Alertmanager disponibili. Potrebbe non essere in grado di recuperare le regole da altre fonti di dati supportate.
+ Le regole di avviso definite in Grafana, anziché in Prometheus, inviano più notifiche al tuo punto di contatto. Se utilizzi avvisi Grafana nativi, ti consigliamo di continuare con gli avvisi Grafana classici e di non abilitare la nuova funzionalità di avviso Grafana. Se desideri visualizzare gli avvisi definiti nella tua fonte di dati Prometheus, ti consigliamo di abilitare Grafana Alerting, che invia una sola notifica per gli avvisi creati in Prometheus Alertmanager.
**Nota**  
Questa limitazione non è più una limitazione nelle aree di lavoro Amazon Managed Grafana che supportano Grafana v10.4 e versioni successive.

**Topics**
+ [Limitazioni](#alert-limitations)
+ [Cosa c'è di nuovo negli avvisi Grafana](alerts-whats-new.md)
+ [Migrazione degli avvisi della dashboard classica agli avvisi Grafana](alert-opt-in.md)
+ [Nozioni fondamentali sugli avvisi](alert-fundamentals.md)
+ [Crea e gestisci le regole di avviso Grafana](alert-rules.md)
+ [Gruppi di avvisi](alert-groups.md)
+ [Silenziamento delle notifiche di avviso per le fonti di dati Prometheus](alert-silences.md)
+ [Lavorare con i punti di contatto](alert-contact-points.md)
+ [Utilizzo di modelli di messaggistica](alert-message-templates.md)
+ [Utilizzo delle politiche di notifica](alert-notifications.md)

# Cosa c'è di nuovo negli avvisi Grafana
<a name="alerts-whats-new"></a>

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

Gli avvisi Grafana presentano diversi miglioramenti rispetto agli avvisi classici del dashboard.

## Crea avvisi multidimensionali
<a name="alerts-new-dimensional"></a>

Ora puoi creare un'unica regola di avviso che ti offre visibilità a livello di sistema, generando 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.

**Nota**  
Ogni istanza di avviso viene conteggiata ai fini della quota di avvisi. Le regole multidimensionali che creano più istanze di quelle che possono essere inserite all'interno della quota di avvisi non vengono valutate e restituiscono un errore di quota. Per ulteriori informazioni, consulta [Errori relativi alla quota raggiunta](alert-rules.md#rule-quota-reached).

## Crea avvisi al di fuori delle dashboard
<a name="alerts-new-not-dashboard"></a>

A differenza dei classici avvisi del dashboard, con gli avvisi Grafana puoi 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 Cortex
<a name="alerts-new-loki-cortex"></a>

Negli avvisi Grafana, puoi gestire le regole di avviso di Loki e Cortex utilizzando la stessa interfaccia utente e API degli avvisi gestiti Grafana.

## Visualizza e cerca avvisi da Amazon Managed Service for Prometheus e altre fonti di dati compatibili con Prometheus
<a name="alerts-new-prometheus"></a>

Gli avvisi per Amazon Managed Service for Prometheus e le fonti di dati compatibili con Prometheus sono ora elencati nell'interfaccia Alerting. 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="alerts-new-error"></a>

Gli avvisi Grafana generano avvisi speciali con le seguenti etichette, quando la valutazione di una regola di avviso produce uno stato o: `NoData` `Error`
+ `alertname`con valore `DatasourceNoData` o in `DatasourceError` base allo stato.
+ `rulename`con il nome della regola di avviso a cui appartiene l'avviso speciale.
+ `datasource_uid`ha l'UID della fonte di dati che ha causato lo stato.
+ Tutte le etichette e le annotazioni della regola originale.

È possibile gestire questi avvisi allo stesso modo degli avvisi normali, ad esempio aggiungendo un silenzio o indirizzando verso un punto di contatto.

**Nota**  
Se la regola utilizza più fonti di dati e una o più non restituiscono dati, viene creato l'avviso speciale per ogni fonte di dati che ha causato lo stato di avviso.

# Migrazione degli avvisi della dashboard classica agli avvisi Grafana
<a name="alert-opt-in"></a>

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

Le aree di lavoro esistenti, o le aree di lavoro che scelgono di non utilizzare gli avvisi Grafana, utilizzano il classico avviso della dashboard. Per migrare al nuovo sistema di avvisi Grafana, devi attivare la funzionalità.

Puoi configurare la tua istanza Amazon Managed Grafana per utilizzare gli avvisi Grafana utilizzando l'API Console di gestione AWS Amazon Managed Grafana. AWS CLI Per dettagli su come configurare Amazon Managed Grafana, inclusa l'attivazione o la disattivazione degli avvisi Grafana, consulta. [Configura uno spazio di lavoro Amazon Managed Grafana](AMG-configure-workspace.md)

**Nota**  
Quando usi gli avvisi Grafana, le regole di avviso definite in Grafana, anziché in Prometheus, inviano più notifiche al tuo punto di contatto. Se utilizzi avvisi Grafana nativi, ti consigliamo di continuare con gli avvisi Grafana classici e di non abilitare la nuova funzionalità di avviso Grafana. Se desideri visualizzare gli avvisi definiti nella tua fonte di dati Prometheus, ti consigliamo di abilitare Grafana Alerting, che invia una sola notifica per gli avvisi creati in Prometheus Alertmanager.  
Questa limitazione viene rimossa nelle aree di lavoro Amazon Managed Grafana che supportano Grafana v10.4 e versioni successive.

## Migrazione al sistema di avvisi Grafana
<a name="alert-opt-in-migrating"></a>

Quando gli avvisi Grafana sono attivati, gli avvisi della dashboard classica esistenti migrano in un formato compatibile con gli avvisi Grafana. Nella pagina Avvisi dell'istanza Grafana, puoi visualizzare gli avvisi migrati insieme ai nuovi avvisi. Con gli avvisi Grafana, le regole di avviso gestite da Grafana inviano più notifiche anziché un singolo avviso quando vengono abbinate.

L'accesso in lettura e scrittura ai classici avvisi della dashboard e agli avvisi Grafana è regolato dalle autorizzazioni delle cartelle che li memorizzano. Durante la migrazione, le autorizzazioni classiche per gli avvisi della dashboard vengono abbinate alle autorizzazioni delle nuove regole come segue:
+ Se la dashboard dell'avviso originale dispone di autorizzazioni, la migrazione crea una cartella denominata con questo formato in modo che `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` corrisponda alle autorizzazioni della dashboard originale (incluse le autorizzazioni ereditate dalla cartella).
+ Se non ci sono autorizzazioni della dashboard e la dashboard si trova in una cartella, la regola viene collegata a questa cartella e ne eredita le autorizzazioni.
+ Se non ci sono autorizzazioni per la dashboard e la dashboard si trova nella cartella Generale, la regola viene collegata alla cartella Avvisi generali e la regola eredita le autorizzazioni predefinite.

**Nota**  
Poiché non è `Keep Last State` disponibile alcuna opzione per gli avvisi `NoData` in Grafana, questa opzione diventa disponibile `NoData` durante la classica migrazione delle regole. L'opzione `Keep Last State` di `Error` gestione viene migrata a una nuova opzione. `Error` Per corrispondere al comportamento di`Keep Last State`, in entrambi i casi, durante la migrazione Amazon Managed Grafana crea automaticamente un silenzio per ogni regola di avviso della durata di un anno.

I canali di notifica vengono migrati a una configurazione Alertmanager con i percorsi e i ricevitori appropriati. I canali di notifica predefiniti vengono aggiunti come punti di contatto al percorso predefinito. I canali di notifica non associati ad alcun avviso della Dashboard vanno al `autogen-unlinked-channel-recv` percorso.

### Limitazioni
<a name="alert-migration-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.

# Nozioni fondamentali sugli avvisi
<a name="alert-fundamentals"></a>

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

Questa sezione fornisce informazioni sui concetti fondamentali degli avvisi Grafana.

## Concetti relativi agli avvisi
<a name="alert-fundamentals-terms"></a>

La tabella seguente descrive i concetti chiave degli avvisi Grafana.


| Concetto o funzionalità chiave | Definizione | 
| --- | --- | 
|  Fonti di dati per gli avvisi  |  Seleziona le fonti di dati da cui desideri interrogare e visualizzare metriche, log e tracce.  | 
|  Pianificatore  |  Valuta le regole di avviso, il componente che esegue periodicamente interrogazioni su fonti di dati. È applicabile solo alle regole gestite da Grafana.  | 
|  Gestore degli avvisi  |  Gestisce il routing e il raggruppamento delle istanze di avviso.  | 
|  Regola di avviso  |  Una serie di criteri di valutazione per stabilire quando una regola di avviso deve essere attivata. Una regola di avviso è costituita da una o più interrogazioni ed espressioni, da una condizione, dalla frequenza di valutazione e dalla durata della soddisfazione della condizione. Una regola di avviso può generare più istanze di avviso.  | 
|  Istanza di avviso  |  Un'istanza di avviso è un'istanza di una regola di avviso. Una regola di avviso monodimensionale ha un'istanza di avviso. Una regola di avviso multidimensionale ha una o più istanze di avviso. Una singola regola di avviso che corrisponde a più risultati, ad esempio CPU contro 10 VMs, viene contata come istanze di avviso multiple (in questo caso 10). Questo numero può variare nel tempo. Ad esempio, una regola di avviso che monitora l'utilizzo della CPU per tutti gli utenti VMs di un sistema include più istanze di avviso man mano che VMs vengono aggiunte. Per ulteriori informazioni sulle quote di istanze di avviso, vedere. [Errori relativi alla quota raggiunta](alert-rules.md#rule-quota-reached)  | 
|  Gruppo di avvisi  |  Alertmanager raggruppa le istanze di avviso per impostazione predefinita utilizzando le etichette per la politica di notifica principale. Questo controlla la deduplicazione e i gruppi di istanze di avviso che vengono inviate ai punti di contatto.  | 
|  Punto di contatto  |  Definisci in che modo i tuoi contatti vengono avvisati quando viene attivata una regola di avviso.  | 
|  Modello di messaggio  |  Crea modelli personalizzati riutilizzabili e usali nei punti di contatto.  | 
|  Politica di notifica  |  Set di regole per dove, quando e come gli avvisi vengono raggruppati e indirizzati ai punti di contatto.  | 
|  Etichette e abbinatori di etichette  |  Le etichette identificano in modo univoco le regole di avviso. Collegano le regole di avviso alle politiche e ai silenzi di notifica, determinando quale politica deve gestirle e quali regole di avviso devono essere silenziate.  | 
|  Silenzi  |  Blocca le notifiche provenienti da una o più istanze di avviso. La differenza tra un intervallo di silenzio e uno di silenziamento è che il silenzio dura per un periodo di tempo specificato, in cui il tempo di silenziamento avviene in base a una pianificazione ricorrente. Utilizza gli abbinatori di etichette per silenziare le istanze di avviso.  | 
|  Tempi di silenziamento  |  Specificate un intervallo di tempo in cui non desiderate che vengano generate o inviate nuove notifiche. È possibile bloccare le notifiche di avviso per periodi di tempo ricorrenti, ad esempio durante un periodo di manutenzione. Deve essere collegato a una politica di notifica esistente.  | 

## Avvisa le fonti di dati
<a name="alert-sources"></a>

Gli avvisi gestiti di Grafana interrogano le seguenti fonti di dati di backend con avvisi abilitati.
+ Fonti di dati integrate o sviluppate e gestite da Grafana:`Alertmanager`,`Graphite`, `Prometheus` (incluso Amazon Managed Service for Prometheus),,,,,,,`Loki`,`InfluxDB`,`Amazon OpenSearch Service`, `Google Cloud Monitoring``Amazon CloudWatch`, `Azure Monitor` e. `MySQL` `PostgreSQL` `MSSQL` `OpenTSDB` `Oracle` `Azure Monitor`

## Avvisi su dati numerici
<a name="alert-numeric"></a>

I dati numerici che non sono in un formato di serie temporale possono essere avvisati direttamente o passati a Server Side Expressions. 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="alert-tabular-data"></a>

Questa funzionalità è supportata con sorgenti dati di backend che interrogano dati tabulari, incluse sorgenti dati SQL, come MySQL, Postgres, MSSQL e Oracle.

Una query con avvisi gestiti da Grafana o Server Side Expressions è considerata numerica con le seguenti fonti di dati:
+ Se l'`Format AS`opzione è impostata su `Table` nella query sull'origine dei dati.
+ Se la risposta della tabella restituita a Grafana dalla query include solo una colonna numerica (ad esempio, int, double o float) e facoltativamente colonne di stringa aggiuntive.

Se sono presenti colonne di stringhe, tali colonne diventano etichette. Il nome della colonna diventa il nome dell'etichetta e il valore di ogni riga diventa il valore dell'etichetta corrispondente. Se vengono restituite più righe, ogni riga deve essere identificata in modo univoco dalle relative etichette.

### Esempio
<a name="alert-tabular-example"></a>

Se hai una tabella MySQL chiamata Diskspace, come segue.


| 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 verrebbe avviato per host, disco quando c'è meno del 5% di spazio libero potrebbe avere l'aspetto seguente.

```
SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
  SELECT
      Host,
      Disk,
      Avg(PercentFree)
  FROM DiskSpace
  Group By
    Host,
    Disk
  Where __timeFilter(Time)
```

Questa query restituisce la seguente risposta della tabella a Grafana.


| Host | Disk | PercentFree | 
| --- | --- | --- | 
|  web1  |  /ecc  |  3  | 
|  web2  |  /var  |  4  | 
|  web 3  |  /var  |  0  | 

Quando questa query viene utilizzata come **condizione** in una regola di avviso, i casi in cui il valore è diverso da zero avvisano. Di conseguenza, vengono prodotte tre istanze di avviso, come illustrato nella tabella seguente.


| Etichette | Status | 
| --- | --- | 
|  \$1host=WEB1, disk=/etc\$1  |  Avviso  | 
|  \$1host=Web2, disco=/var\$1  |  Avviso  | 
|  \$1host=WEB3, disco=/var\$1  |  Normale  | 

## Gestore degli avvisi
<a name="alert-alertmanager"></a>

Grafana include il supporto integrato per Prometheus Alertmanager. Alertmanager aiuta sia a raggruppare che a gestire le regole di avviso, aggiungendo un livello di orchestrazione oltre ai motori di avviso. Per impostazione predefinita, le notifiche per gli avvisi gestiti da Grafana vengono gestite dall'Alertmanager integrato che fa parte del core Grafana. Puoi configurare i punti di contatto, le politiche di notifica e i modelli di Alertmanager dall'interfaccia utente di avvisi Grafana selezionando l'opzione Grafana dal menu a discesa Alertmanager.

Gli avvisi Grafana supportano la configurazione esterna di Alertmanager (per ulteriori informazioni su Alertmanager come origine dati esterna, vedere). [Connect a un'origine dati Alertmanager](data-source-alertmanager.md) Quando aggiungi un Alertmanager esterno, il menu a discesa Alertmanager mostra un elenco di fonti di dati Alertmanager esterne disponibili. Seleziona un'origine dati per creare e gestire avvisi per sorgenti dati autonome Cortex o Loki.

## Stato e integrità delle regole di avviso
<a name="alerts-state"></a>

Lo stato e lo stato di integrità delle regole di avviso consentono di comprendere diversi indicatori di stato chiave relativi agli avvisi. Esistono tre componenti chiave: stato di avviso, stato delle regole di avviso e integrità delle regole di avviso. Sebbene correlati, ogni componente trasmette informazioni leggermente diverse.

**Stato della regola di avviso**
+ **Normale**: nessuna delle serie temporali restituite dal motore di valutazione è in uno `Firing` stato `Pending` or.
+ **In sospeso**: almeno una delle serie temporali restituite dal motore di valutazione è`Pending`.
+ **Attivazione**: almeno una delle serie temporali restituite dal motore di valutazione è. `Firing`

**Stato di allerta**
+ **Normale**: la condizione per la regola di avviso è **falsa** per ogni serie temporale restituita dal motore di valutazione.
+ **Avviso**: la condizione della regola di avviso è **vera** per almeno una serie temporale restituita dal motore di valutazione. La durata per la quale la condizione deve essere vera prima che venga avviato un avviso, se impostata, viene soddisfatta o è stata superata.
+ **In sospeso**: la condizione della regola di avviso è **vera** per almeno una serie temporale restituita dal motore di valutazione. La durata per la quale la condizione deve essere vera prima che venga avviato un avviso, se impostata, non è stata soddisfatta.
+ **NoData**— La regola di avviso non ha restituito una serie temporale, tutti i valori per le serie temporali sono nulli o tutti i valori per le serie temporali sono zero.
+ **Errore**: errore durante il tentativo di valutare una regola di avviso.

**Integrità della regola di avviso**
+ **Ok**: nessun errore durante la valutazione di una regola di avviso.
+ **Errore: errore** durante la valutazione di una regola di avviso.
+ **NoData**— Assenza di dati in almeno una serie temporale restituita durante la valutazione di una regola.

# Crea e gestisci le regole di avviso Grafana
<a name="alert-rules"></a>

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

Una regola di avviso è un insieme di criteri di valutazione che determina se viene avviato un avviso. La regola è costituita da una o più interrogazioni ed espressioni, una condizione, la frequenza di valutazione e, facoltativamente, la durata durante la quale la condizione viene soddisfatta.

Mentre le interrogazioni e le espressioni selezionano il set di dati da valutare, una condizione imposta la soglia che un avviso deve soddisfare o superare per creare un avviso. Un intervallo specifica la frequenza con cui viene valutata una regola di avviso. La durata, se configurata, indica per quanto tempo deve essere soddisfatta una condizione. Le regole possono anche definire il comportamento di avviso in assenza di dati.

Le sezioni seguenti descrivono la creazione e la gestione di diversi tipi di regole di avviso Grafana.

**Topics**
+ [Creazione di regole di avviso gestite da Cortex o Loki](#create-alert-rule)
+ [Creazione di regole di registrazione gestite da Cortex o Loki](#create-alert-recording-rule)
+ [Creazione di regole di avviso gestite da Grafana](#create-grafana-alert-rule)
+ [Annotazioni ed etichette per le regole di avviso](#alert-rule-labels)
+ [Gestione delle regole di avviso](#manage-alert-rules)
+ [Gruppi di regole e namespace Cortex o Loki](#alert-rule-groups)

## Creazione di regole di avviso gestite da Cortex o Loki
<a name="create-alert-rule"></a>

Utilizzando Grafana, puoi creare regole di avviso per un'istanza esterna di Cortex o Loki.

**Nota**  
Cortex è il database di serie temporali utilizzato da Amazon Managed Service per le fonti di dati Prometheus e Prometheus.

**Prerequisiti**
+ Verifica di disporre delle autorizzazioni di scrittura per l'origine dati Prometheus. Altrimenti, non sarai in grado di creare o aggiornare le regole di avviso gestite da Cortex.
+ Per le fonti di dati Cortex 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.
  + **Cortex**: usa il `/api/prom` prefisso legacy, non. `/prometheus` L'origine dati Prometheus supporta sia Cortex che Prometheus e Grafana prevede che sia l'API Query che l'API Ruler siano sotto lo stesso URL. Non è possibile fornire un URL separato per l'API Ruler.

**Nota**  
**Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.**

**Per aggiungere una regola di avviso gestita da Cortex o Loki**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona **Avvisi (campanella) per aprire la pagina** Avvisi che elenca **gli avvisi** esistenti.

1. **Scegli Nuova regola di avviso.**

1. Nel **passaggio 1**, aggiungi il nome, il tipo e la posizione di archiviazione della regola, come segue:
   + In **Nome regola**, aggiungi un nome descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.
   + Dal menu a discesa **Tipo di regola**, seleziona Avviso gestito da **Cortex/Loki**.
   + Dal menu a discesa **Seleziona l'origine dati**, seleziona un'origine dati Prometheus o Loki.
   + Dal menu a discesa **Namespace**, seleziona uno spazio dei nomi di regole esistente. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo. Per ulteriori informazioni, consulta [Gruppi di regole e namespace Cortex o Loki](#alert-rule-groups).
   + Dal menu a discesa **Gruppo**, seleziona un gruppo esistente all'interno del namespace selezionato. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. Le regole appena create vengono aggiunte alla fine del gruppo. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, con lo stesso tempo di valutazione.

1. Nel **passaggio 2**, aggiungi la query da valutare.

   Il valore può essere un'espressione PromQL o LogQL. La regola avvia un avviso se il risultato della valutazione presenta almeno una serie con un valore maggiore di 0. Viene creato un avviso per ogni serie.

1. Nel **passaggio 3**, aggiungi le condizioni.

   Nella casella di testo Per della condizione, specifica la durata per la quale la condizione deve essere vera prima che venga avviato l'avviso. Se si specifica`5m`, le condizioni devono essere vere per cinque minuti prima che l'avviso venga avviato.
**Nota**  
Quando viene soddisfatta una condizione, l'avviso entra in `Pending` stato. Se la condizione rimane attiva per la durata specificata, l'avviso passa allo `Firing` stato. Se non viene più soddisfatto, viene ripristinato lo stato. `Normal`

1. Nel **passaggio 4**, aggiungi ulteriori metadati associati alla regola.
   + Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida in[Annotazioni ed etichette per le regole di avviso](#alert-rule-labels).
   + Aggiungi l'URL, il pannello, la dashboard e l'avviso IDs del Runbook.
   + Aggiungi etichette personalizzate.

1. Scegli **Anteprima avvisi** per valutare la regola e vedere quali avvisi produrrebbe. Visualizza un elenco di avvisi con lo stato e il valore di ciascuno.

1. Scegli **Salva** per salvare la regola o **Salva ed esci** per salvare la regola e tornare alla pagina **Avvisi.**

## Creazione di regole di registrazione gestite da Cortex o Loki
<a name="create-alert-recording-rule"></a>

È possibile creare e gestire regole di registrazione per un'istanza Cortex 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 un nuovo set di serie temporali. 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.

**Prerequisiti**

Per le fonti di dati Cortex 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.
+ **Cortex**: quando configuri un'origine dati Grafana Prometheus in modo che punti a Cortex, usa il prefisso legacy, non. `/api/prom` `/prometheus` L'origine dati Prometheus supporta sia Cortex che Prometheus e Grafana prevede che sia l'API Query che l'API Ruler siano sotto lo stesso URL. Non è possibile fornire un URL separato per l'API Ruler.

**Nota**  
**Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.**

**Per aggiungere una regola di registrazione gestita da Cortex o Loki**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona **Avvisi (campanella) per aprire la pagina** Avvisi che elenca **gli avvisi** esistenti.

1. **Scegli Nuova regola di avviso.**

1. Nel **passaggio 1**, aggiungi il nome, il tipo e la posizione di archiviazione della regola, come segue.
   + In **Nome regola**, aggiungi un nome descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.
   + Dal menu a discesa **Tipo di regola**, seleziona Avviso gestito da **Cortex/Loki**.
   + Dal menu a discesa **Seleziona l'origine dati**, seleziona un'origine dati Prometheus o Loki.
   + Dal menu a discesa **Namespace**, seleziona uno spazio dei nomi di regole esistente. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo. Per ulteriori informazioni, consulta [Gruppi di regole e namespace Cortex o Loki](#alert-rule-groups).
   + Dal menu a discesa **Gruppo**, seleziona un gruppo esistente all'interno del namespace selezionato. Altrimenti, scegli **Aggiungi nuovo** e inserisci un nome per crearne uno. Le regole appena create vengono aggiunte alla fine del gruppo. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, con lo stesso tempo di valutazione.

1. Nel **passaggio 2**, aggiungi la query da valutare.

   Il valore può essere un'espressione PromQL o LogQL. La regola avvia un avviso se il risultato della valutazione presenta almeno una serie con un valore maggiore di 0. Viene creato un avviso per ogni serie.

1. Nel **passaggio 3**, aggiungi ulteriori metadati associati alla regola.
   + Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida in[Annotazioni ed etichette per le regole di avviso](#alert-rule-labels).
   + Aggiungi l'URL, il pannello, la dashboard e l'avviso IDs del Runbook.
   + Aggiungi etichette personalizzate.

1. Scegli **Salva** per salvare la regola o **Salva ed esci** per salvare la regola e tornare alla pagina **Avvisi**.

## Creazione di regole di avviso gestite da Grafana
<a name="create-grafana-alert-rule"></a>

Grafana consente di creare regole di avviso che interrogano una o più fonti di dati, riducono o trasformano i risultati e li confrontano tra loro o per fissare soglie. Quando questi vengono elaborati, Grafana invia notifiche al punto di contatto.

**Nota**  
La creazione di regole di avviso gestite Grafana durante l'utilizzo degli avvisi Grafana comporta l'invio di più notifiche quando la regola viene soddisfatta. Alcuni fornitori di punti di contatto potrebbero disporre di opzioni configurabili per deduplicare le notifiche.

**Per aggiungere una regola gestita Grafana**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona **Avvisi (campanella) per aprire la pagina** Avvisi che elenca **gli avvisi** esistenti.

1. **Scegli Nuova regola di avviso.**

1. Nel **passaggio 1**, aggiungi il nome, il tipo e la posizione di archiviazione della regola, come segue:
   + In **Nome regola**, aggiungi un nome descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.
   + Dal menu a discesa **Tipo di regola**, seleziona **Avviso gestito Grafana**.
   + Dal menu a discesa **Cartella**, seleziona la cartella in cui desideri archiviare la regola. Se non si seleziona una cartella, la regola viene memorizzata nella `General` cartella. Per creare una cartella, seleziona il menu a discesa e inserisci un nuovo nome per la cartella.

1. Nel **passaggio 2**, aggiungi le interrogazioni e le espressioni da valutare.
   + Mantieni il nome predefinito o passa il mouse sopra e scegli l'icona di modifica per modificare il nome.
   + Per le query, seleziona una fonte di dati dal menu a discesa.
   + Aggiungi una o più [query](panel-queries.md) o espressioni (per i dettagli sulle espressioni, consulta [Espressioni](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) nella documentazione di *Grafana*).
   + Per ogni espressione, seleziona la **condizione Classic** per creare una singola regola di avviso oppure scegli tra le opzioni **Math**, **Reduce**, **Resample** per generare avvisi separati per ogni serie. Per i dettagli su queste opzioni, consulta. [Regole singole e multidimensionali](#single-multi-rule)
   + Scegli **Esegui interrogazioni** per verificare che l'interrogazione abbia esito positivo.

1. Nel **passaggio 3**, aggiungi le condizioni.
   + Dal menu a discesa **Condizione**, seleziona la query o l'espressione per avviare la regola di avviso.
   + Per **Evaluate every**, specificate la frequenza di valutazione. Deve essere un multiplo di 10 secondi. Ad esempio, `1m`, `30s`.
   + Per **Evaluate for**, specifica la durata per la quale la condizione deve essere vera prima che venga avviato un avviso.
**Nota**  
Dopo che una condizione viene violata, l'avviso entra in `Pending` stato. Se la condizione rimane violata per la durata specificata, l'avviso passa allo stato. `Firing` Se non viene più soddisfatto, viene ripristinato lo stato. `Normal`
   + In **Configura assenza di dati e gestione degli errori**, configura il comportamento di avviso in assenza di dati. Utilizza le linee guida contenute in. [Nessuna gestione di dati o casi di errore](#rule-no-data-error)
   + Scegli **Anteprima avvisi** per verificare il risultato dell'esecuzione della query in questo momento. L'anteprima non esclude dati e condizioni di gestione degli errori.

1. Nel **passaggio 4**, aggiungi ulteriori metadati associati alla regola.
   + Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida in[Annotazioni ed etichette per le regole di avviso](#alert-rule-labels).
   + Aggiungi l'URL, il pannello, la dashboard e l'avviso IDs del Runbook.
   + Aggiungi etichette personalizzate.

1. Scegli **Salva** per salvare la regola o **Salva ed esci** per salvare la regola e tornare alla pagina **Avvisi**.

### Regole singole e multidimensionali
<a name="single-multi-rule"></a>

Per le regole di avviso gestite da Grafana, puoi creare una regola con una condizione classica oppure puoi creare una regola multidimensionale.

**Regola monodimensionale (condizione classica)**

Utilizza un'espressione di condizione classica per creare una regola che avvia un singolo avviso quando viene soddisfatta la relativa condizione. Per una query che restituisce più serie, Grafana non tiene traccia dello stato di avviso di ciascuna serie. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie.

Per ulteriori informazioni su come formattare le espressioni, consulta [Espressioni](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) nella documentazione di *Grafana*.

**Regola multidimensionale**

Per generare un'istanza di avviso separata per ogni serie restituita nella query, create una regola multidimensionale.

**Nota**  
Ogni istanza di avviso generata da una regola multidimensionale viene conteggiata ai fini della quota totale di avvisi. Le regole non vengono valutate quando si raggiunge la quota di avvisi. Per ulteriori informazioni sulle quote per le regole multidimensionali, vedere. [Errori relativi alla quota raggiunta](#rule-quota-reached)

Per creare più istanze da una singola regola `Math``Reduce`, usa o `Resample` espressioni per creare una regola multidimensionale. Ad esempio, puoi:
+ Aggiungi un'`Reduce`espressione per ogni query per aggregare i valori nell'intervallo di tempo selezionato in un unico valore. (Non necessario per [le regole che utilizzano dati numerici)](alert-fundamentals.md#alert-numeric).
+ Aggiungi un'`Math`espressione con la condizione per la regola. Ciò non è necessario nel caso in cui una query o un'espressione di riduzione restituisca già 0 se la regola non deve avviare un avviso o un numero positivo se deve avviare un avviso. 

  Alcuni esempi: 
  + `$B > 70`se deve avviare un avviso nel caso in cui il valore di B query/expression sia superiore a 70. 
  + `$B < $C * 100`nel caso in cui debba avviare un allarme se il valore di B è inferiore al valore di C moltiplicato per 100. Se le query confrontate contengono più serie nei risultati, le serie di query diverse vengono abbinate se hanno le stesse etichette o una è un sottoinsieme dell'altra.

**Nota**  
Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili nella pagina della community Le [variabili di modello non sono supportate nelle query di avviso durante la configurazione](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) di Alert.



**Considerazioni sulle prestazioni per le regole multidimensionali**

Ogni istanza di avviso viene conteggiata ai fini della quota di avvisi. Le regole multidimensionali che creano più istanze di quelle che possono essere inserite all'interno della quota di avvisi non vengono valutate e restituiscono un errore di quota. Per ulteriori informazioni, consulta [Errori relativi alla quota raggiunta](#rule-quota-reached).

Gli avvisi multidimensionali possono avere un forte impatto sulle prestazioni del tuo spazio di lavoro Grafana, nonché sulle prestazioni delle tue fonti di dati, poiché Grafana le interroga per valutare le tue regole di avviso. Le seguenti considerazioni possono essere utili per ottimizzare le prestazioni del sistema di monitoraggio.
+ **Frequenza di valutazione delle regole**: la proprietà **Evaluate Every** di una regola di avviso controlla la frequenza di valutazione delle regole. Si consiglia di utilizzare la frequenza di valutazione più bassa accettabile. 
+ **Cardinalità del set di risultati**: il numero di istanze di avviso create con una regola ne influisce sulle prestazioni. Supponiamo che stiate monitorando gli errori di risposta delle API per ogni percorso API, su ogni macchina virtuale del vostro parco macchine. Questo set ha una cardinalità del numero di percorsi moltiplicato per il numero di. VMs È possibile ridurre la cardinalità del set di risultati, ad esempio, monitorando gli errori totali per macchina virtuale anziché per percorso per macchina virtuale.
+ **Complessità della query**: le interrogazioni che le fonti di dati possono elaborare e a cui rispondere rapidamente consumano meno risorse. Sebbene questa considerazione sia meno importante delle altre considerazioni sopra elencate, se le hai ridotte il più possibile, l'analisi delle prestazioni delle singole query potrebbe fare la differenza. È inoltre necessario essere consapevoli dell'impatto sulle prestazioni che la valutazione di queste regole ha sulle fonti di dati. Le query di avviso sono spesso la maggior parte delle query gestite dai database di monitoraggio, quindi anche gli stessi fattori di carico che influiscono sull'istanza Grafana influiscono anche su di esse.

### Errori relativi alla quota raggiunta
<a name="rule-quota-reached"></a>

Esiste una quota per il numero di istanze di avviso che è possibile avere all'interno di un singolo spazio di lavoro. Quando raggiungi quel numero, non puoi più creare nuove regole di avviso in quell'area di lavoro. Con gli avvisi multidimensionali, il numero di istanze di avviso può variare nel tempo.

Quando si lavora con le istanze di avviso, è importante ricordare quanto segue.
+ Se si creano solo regole monodimensionali, ogni regola è una singola istanza di avviso. È possibile creare lo stesso numero di regole in un unico spazio di lavoro pari alla quota dell'istanza di avviso e non di più.
+ Le regole multidimensionali creano più istanze di avviso, tuttavia il numero non è noto finché non vengono valutate. Ad esempio, se crei una regola di avviso che tiene traccia dell'utilizzo della CPU delle tue istanze Amazon EC2, potrebbero esserci 50 istanze EC2 al momento della creazione (e quindi 50 istanze di avviso), ma se aggiungi altre 10 istanze EC2 una settimana dopo, la valutazione successiva ha 60 istanze di avviso.

  Il numero di istanze di avviso viene valutato quando si crea un avviso multidimensionale e non è possibile crearne uno che superi immediatamente la quota di istanze di avviso. Poiché il numero di istanze di avviso può cambiare, la quota viene verificata ogni volta che vengono valutate le regole.
+ Al momento della valutazione della regola, se una regola comporta il superamento della quota prevista per le istanze di avviso, tale regola non viene valutata finché non viene effettuato un aggiornamento della regola di avviso che porta il numero totale di istanze di avviso al di sotto della quota di servizio. Quando ciò accade, si riceve una notifica di avviso che informa che la quota è stata raggiunta (la notifica utilizza la politica di notifica per la regola in fase di valutazione). La notifica include un'`Error`annotazione con il valore. `QuotaReachedError`
+ Una regola che causa un `QuotaReachedError` arresto nella valutazione. La valutazione viene ripresa solo quando viene effettuato un aggiornamento e la valutazione successiva all'aggiornamento non causa di per sé un. `QuotaReachedError` Una regola che non viene valutata mostra l'errore **Quota raggiunta** nella console Grafana.
+ È possibile ridurre il numero di istanze di avviso rimuovendo le regole di avviso o modificando gli avvisi multidimensionali per avere meno istanze di avviso (ad esempio, inserendo un avviso sugli errori per macchina virtuale anziché un avviso di errore per API in una macchina virtuale).
+ Per riprendere le valutazioni, aggiorna l'avviso e salvalo. È possibile aggiornarlo per ridurre il numero di istanze di avviso oppure, se sono state apportate altre modifiche per ridurre il numero di istanze di avviso, è possibile salvarlo senza modifiche. Se può essere ripreso, lo è. Se ne causa un altro`QuotaReachedError`, non puoi salvarlo.
+ Quando un avviso viene salvato e riprende la valutazione senza superare la quota di avvisi, l'errore Quota **raggiunta** può continuare a essere visualizzato nella console Grafana per qualche tempo (fino all'intervallo di valutazione), tuttavia, la valutazione della regola di avviso inizia e gli avvisi vengono inviati se viene raggiunta la soglia della regola.
+ Per i dettagli sulla quota di avvisi e su altre quote, vedi. [Quote del servizio Amazon Managed Grafana](AMG_quotas.md)

### Nessuna gestione di dati o casi di errore
<a name="rule-no-data-error"></a>

Scegliete le opzioni su come gestire il comportamento di avviso in assenza di dati o in caso di errori.

Le opzioni per la gestione dell'assenza di dati sono elencate nella tabella seguente.


| Opzione No Data | Comportamento | 
| --- | --- | 
|  Nessun dato  |  Crea un avviso `DatasourceNoData` con il nome e l'UID della regola di avviso e l'UID dell'origine dati che non ha restituito dati come etichette.  | 
|  Avviso  |  Imposta lo stato della regola di avviso su. `Alerting`  | 
|  OK  |  Imposta lo stato della regola di avviso su`Normal`.  | 

Le opzioni per la gestione dei casi di errore sono elencate nella tabella seguente.


| Opzione di errore o timeout | Comportamento | 
| --- | --- | 
|  Avviso  |  Imposta lo stato della regola di avviso su `Alerting`  | 
|  OK  |  Imposta lo stato della regola di avviso su `Normal`  | 
|  Errore  |  Crea un avviso `DatasourceError` con il nome e l'UID della regola di avviso e l'UID dell'origine dati che non ha restituito dati come etichette.  | 

## Annotazioni ed etichette per le regole di avviso
<a name="alert-rule-labels"></a>

Le annotazioni e le etichette sono coppie chiave-valore associate agli avvisi provenienti dalla regola di avviso, dalla risposta dell'origine dati e come risultato della valutazione delle regole di avviso. [Possono essere utilizzate direttamente nelle notifiche di avviso o nei modelli e nelle funzioni dei [modelli](alert-message-templates.md) per creare contatti di notifica in modo dinamico.](alert-message-templates.md#alert-template-functions)

**Annotazioni**

Le annotazioni sono coppie chiave-valore che forniscono informazioni aggiuntive su un avviso. È possibile utilizzare le seguenti annotazioni:`description`,,, `summary``runbook_url`, `alertId` e. `dashboardUid` `panelId` Queste vengono visualizzate nei dettagli delle regole e degli avvisi nell'interfaccia utente e possono essere utilizzate nei modelli di messaggi dei punti di contatto.

**Etichette**

Le etichette sono coppie chiave-valore che contengono informazioni su un avviso. Il set di etichette per un avviso viene generato e aggiunto durante il processo di valutazione e notifica degli avvisi. Vengono utilizzati nei seguenti modi.
+ Il set completo di etichette per un avviso identifica in modo univoco quell'avviso all'interno di Grafana Alerts.
+ [[L'Alertmanager utilizza le etichette per abbinare gli avvisi ai [silenzi](alert-silences.md) e ai gruppi di avvisi nelle politiche di notifica.](alert-notifications.md)](alert-groups.md)
+ L'interfaccia utente di avviso mostra le etichette per ogni istanza di avviso generata dalla 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.](#alert-rules) Queste etichette configurate manualmente sono in grado di utilizzare le funzioni dei modelli e fare riferimento ad altre etichette. Le etichette aggiunte a una regola di avviso qui hanno la precedenza in caso di collisione tra etichette.

Le seguenti variabili di modello sono disponibili quando si espandono annotazioni ed etichette.


| Nome | Description | 
| --- | --- | 
|  `$labels`  |  Le etichette della query o della condizione. Ad esempio `{{ $labels.instance }}` e `{{ $labels.job }}`. Non è disponibile quando la regola utilizza una condizione classica.  | 
|  `$values`  |  I valori di tutte le espressioni di riduzione e matematiche che sono state valutate per questa regola di avviso. Ad esempio`{{ $values.A }}`, `{{ $values.A.Labels }}` e `{{ $values.A.Value }}` `A` dov'è l'`refID`espressione. Non è disponibile quando la regola utilizza una condizione classica  | 
|  `$value`  |  La stringa di valori dell'istanza di avviso. Ad esempio, `[ var='A' labels={instance=foo} value=10 ]`.  | 

## Gestione delle regole di avviso
<a name="manage-alert-rules"></a>



La pagina **Avvisi elenca** le regole di avviso. Per impostazione predefinita, le regole sono raggruppate per tipi di origini dati. La sezione **Grafana** elenca le regole gestite da Grafana e la sezione **Cortex/Loki elenca le regole per le fonti** di dati compatibili con Prometheus. È possibile visualizzare le regole di avviso per le fonti di dati compatibili con Prometheus, ma non è possibile modificarle.

### Visualizza le regole di avviso
<a name="manage-alerts-view"></a>

Utilizzando gli avvisi Grafana, puoi visualizzare tutti i tuoi avvisi in un'unica pagina.

**Per visualizzare i dettagli degli avvisi**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.** Per impostazione predefinita, le regole vengono visualizzate in gruppi per tipo di origine dati. È inoltre possibile visualizzare in base allo stato corrente di ogni avviso (questi sono descritti più dettagliatamente nel testo seguente).

1. In **Visualizza come**, puoi passare dalla visualizzazione di gruppo a quella dello stato scegliendo l'opzione che preferisci.

1. Scegli la freccia accanto a una riga per visualizzare ulteriori dettagli per quella riga. I dettagli di una regola includono le etichette delle regole, le annotazioni, le fonti di dati e le interrogazioni, nonché un elenco di istanze di avviso risultanti dalla regola.

**Visualizzazione di gruppo**

La visualizzazione di gruppo mostra le regole di avviso Grafana raggruppate per cartella e le regole di avviso Loki o Prometheus raggruppate per \$1. `namespace` `group` Questa è la visualizzazione predefinita dell'elenco delle regole, destinata alla gestione delle regole. È possibile espandere ogni gruppo per visualizzare un elenco delle regole in esso contenute. Espandi ulteriormente una regola per visualizzarne i dettagli. Puoi anche espandere i pulsanti di azione e gli avvisi risultanti dalla regola per visualizzarne i dettagli.

**Visualizzazione dello stato**

La visualizzazione dello stato mostra le regole di avviso raggruppate per stato. Utilizzate questa visualizzazione per avere una panoramica delle regole in quale stato si trovano. Ogni regola può essere espansa per visualizzarne i dettagli. I pulsanti di azione e tutti gli avvisi generati da questa regola; ogni avviso può essere ulteriormente espanso per visualizzarne i dettagli.

**Filtra le regole di avviso**

È possibile filtrare le regole di avviso visualizzate nella pagina **Avvisi in diversi** modi.
+ Puoi filtrare per visualizzare le regole che interrogano una fonte di dati specifica scegliendo **Seleziona origini dati**, quindi selezionando un'origine dati in base alla quale filtrare.
+ Puoi filtrare per etichette scegliendo i criteri di ricerca in **Cerca per etichetta**. Alcuni criteri di esempio includono `environment=production``region=~US|EU`,`severity!=warning`.
+ È possibile filtrare per visualizzare le regole in uno stato specifico scegliendo **Filtra gli avvisi per stato** e quindi selezionando lo stato che si desidera visualizzare.

### Modifica o elimina le regole di avviso
<a name="manage-alerts-edit"></a>

Le regole di avviso gestite da Grafana possono essere modificate o eliminate solo dagli utenti con autorizzazioni di modifica per la cartella in cui sono archiviate le regole. Le regole di avviso per un'istanza esterna di Cortex o Loki possono essere modificate o eliminate dagli utenti con ruoli di Editor o Amministratore.

**Per modificare o eliminare una regola**

1. Espandi una regola fino a visualizzare i controlli delle regole per **Visualizza**, **Modifica** ed **Elimina**.

1. Scegli **Modifica** per aprire la pagina di creazione della regola. Effettua gli aggiornamenti nello stesso modo in cui crei una regola. Per i dettagli, consulta le istruzioni in [Creazione di regole di avviso gestite da Grafana](#create-grafana-alert-rule) o[Creazione di regole di avviso gestite da Cortex o Loki](#create-alert-rule).

1. Facoltativamente, scegli **Elimina** per eliminare una regola.

## Gruppi di regole e namespace Cortex o Loki
<a name="alert-rule-groups"></a>

Puoi organizzare le tue regole. Le regole vengono create all'interno di gruppi di regole e i gruppi di regole sono organizzati in namespace. Le regole all'interno di un gruppo di regole vengono eseguite in sequenza a intervalli regolari. L'intervallo predefinito è di un minuto. È possibile rinominare gli spazi dei nomi e i gruppi di regole di Cortex o Loki e modificare gli intervalli di valutazione dei gruppi di regole.

**Per modificare un gruppo di regole o uno spazio dei nomi**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. Passa a una regola all'interno del gruppo di regole o dello spazio dei nomi che desideri modificare.

1. Scegliete l'**icona Modifica** (penna).

1. Apportate modifiche al gruppo di regole o al namespace.
**Nota**  
Per i namespace, puoi solo modificare il nome. Per i gruppi di regole, è possibile modificare il nome o l'intervallo di valutazione per le regole del gruppo. Ad esempio, è possibile scegliere di `1m` fare in modo che le regole vengano valutate una volta al minuto o `30s` una volta ogni 30 secondi.

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

# Gruppi di avvisi
<a name="alert-groups"></a>

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

I gruppi di avvisi mostrano avvisi raggruppati provenienti da un'istanza di Alertmanager. Per impostazione predefinita, gli avvisi sono raggruppati in base alle chiavi di etichetta per la politica principale in. [Utilizzo delle politiche di notifica](alert-notifications.md) Il raggruppamento degli avvisi comuni in un unico gruppo di avvisi impedisce l'avvio di avvisi duplicati.

**Per visualizzare i raggruppamenti di avvisi**

1. Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella), quindi la voce **Raggruppamento avvisi** **per aprire la pagina** che elenca i gruppi esistenti.

1. Dal menu a discesa **Alertmanager**, seleziona un Alertmanager esterno come fonte di dati. Per impostazione predefinita, è selezionato Alertmanager. `Grafana`

1. Dal menu a discesa **personalizzato raggruppa per**, seleziona una combinazione di etichette per visualizzare un raggruppamento diverso da quello predefinito. È possibile utilizzare questa visualizzazione per eseguire il debug o verificare il raggruppamento delle politiche di notifica.

Gli avvisi senza etichette specificate nel raggruppamento della politica principale o nel raggruppamento personalizzato vengono aggiunti a un gruppo con un'intestazione di. `No grouping`

**Filtra gli avvisi**

Puoi utilizzare i seguenti filtri per visualizzare gli avvisi che corrispondono a criteri specifici:
+ **Ricerca per etichetta**: in **Cerca**, inserisci un'etichetta esistente per visualizzare gli avvisi corrispondenti all'etichetta. Ad esempio, `environment=production``region=~US|EU`,`severity!=warning`.
+ **Filtra gli avvisi per stato**: negli **Stati**, seleziona uno o più `Unprocessed` stati per visualizzare gli avvisi in quello stato. `Active` `Suppressed`

# Silenziamento delle notifiche di avviso per le fonti di dati Prometheus
<a name="alert-silences"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 8.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. [Funzionamento nella versione 10 di Grafana](using-grafana-v10.md)  
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 fonti di dati esterne di Alertmanager (incluso Amazon Managed Service for Prometheus), puoi sopprimere le notifiche di avviso con un silenzio.* Un silenzio impedisce solo la creazione di notifiche: i silenzi non impediscono la valutazione delle regole di avviso e non impediscono la visualizzazione delle istanze di avviso nell'interfaccia utente. Quando si silenzia un avviso, si specifica un intervallo di tempo entro il quale tale avviso deve essere soppresso.

È possibile configurare i silenzi per un'origine dati esterna di Alertmanager.

**Nota**  
Per sopprimere le notifiche di avviso a intervalli di tempo regolari (ad esempio, durante i normali periodi di manutenzione), utilizza anziché i silenzi. [Tempi di silenziamento](alert-notifications.md#alert-notification-muting)

**Per aggiungere un silenzio**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. [Scegli **Silences** per aprire una pagina che elenca i punti di contatto esistenti.](alert-contact-points.md)

1. **Scegli il gestore di avvisi esterno dal menu a discesa Alertmanager.**

1. **Seleziona** Nuovo silenzio.

1. Seleziona le date di inizio e fine in **Inizio e fine del silenzio** per indicare quando il silenzio deve entrare in vigore e quando dovrebbe terminare.

   In alternativa all'impostazione di un'ora di fine, in **Durata**, specifica per quanto tempo viene applicato il silenzio. Questo aggiorna automaticamente l'ora di fine nel campo di **inizio e fine del silenzio**.

1. Nei campi **Nome** e **Valore**, inserisci una o più *etichette corrispondenti*. Gli abbinatori determinano a quali regole si applica il silenzio. La corrispondenza delle etichette viene discussa più dettagliatamente seguendo questa procedura.

1. Facoltativamente, aggiungi un **commento** o modifica il **Creatore** per impostare il proprietario del silenzio.

**Corrispondenza delle etichette per la soppressione degli avvisi**

Quando si crea un silenzio, si crea una serie di *etichette corrispondenti* come parte del silenzio. Si tratta di un insieme di regole sulle etichette che devono corrispondere affinché l'avviso venga soppresso. Le etichette corrispondenti sono costituite da tre parti:
+ **Etichetta**: il nome dell'etichetta da abbinare. Deve corrispondere esattamente al nome dell'etichetta dell'avviso.
+ **Operatore**: l'operatore utilizzato per confrontare il valore dell'etichetta con il valore dell'etichetta corrispondente. Gli operatori disponibili sono:
  + `=`Seleziona le etichette il cui valore corrisponde esattamente alla stringa fornita.
  + `!=`Seleziona le etichette il cui valore non corrisponde alla stringa fornita.
  + `=~`Seleziona le etichette il cui valore corrisponde al valore interpretato dall'espressione regolare della stringa fornita (la stringa fornita viene interpretata come un'espressione regolare).
  + `!=`Seleziona le etichette che non corrispondono all'espressione regolare fornita.
+ **Valore**: il valore a cui abbinare il valore dell'etichetta. Può corrispondere come stringa o come espressione regolare, a seconda dell'operatore scelto.

Un silenzio termina alla data di fine indicata, ma è possibile terminare manualmente la soppressione in qualsiasi momento.

**Per terminare un silenzio manualmente**

1. Nella pagina **Avvisi**, scegli **Silenzi** per visualizzare l'elenco dei silenzi esistenti.

1. **Seleziona il silenzio che vuoi terminare e scegli Annulla silenzio.** Questo termina la soppressione degli avvisi.
**Nota**  
La disattivazione del silenzio interrompe la soppressione degli avvisi, come se l'ora di fine fosse impostata per l'ora corrente. I silenzi terminati (automaticamente o manualmente) vengono conservati ed elencati per cinque giorni. Non è possibile rimuovere manualmente un silenzio dall'elenco.

**Creazione di un collegamento al modulo per la creazione del silenzio**

È possibile creare un URL per il modulo di creazione del silenzio con i dettagli già compilati. Gli operatori possono utilizzarlo per sopprimere rapidamente un allarme durante un evento operativo.

Quando create un collegamento a un modulo di silenzio, utilizzate un parametro di `matchers` query per specificare le etichette corrispondenti e un parametro di `comment` query per specificare un commento. Il `matchers` parametro richiede uno o più valori nel modulo`[label][operator][value]`, separati da virgole.

**URL di esempio**

Per creare un collegamento a un modulo silenzioso, con etichette corrispondenti `severity=critical` e`cluster!~europe-.*`, con un commento che dice`Silencing critical EU alerts`, usa un URL come il seguente. Sostituisci *mygrafana* con il nome host dell'istanza Grafana.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Per creare un collegamento a una nuova pagina silenziosa per un Alertmanager esterno, aggiungi un parametro di `alertmanager` query con il nome dell'origine dati Alertmanage, ad esempio. `alertmanager=myAlertmanagerdatasource`

# Lavorare con i punti di contatto
<a name="alert-contact-points"></a>

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

Utilizza i punti di contatto per definire in che modo i tuoi contatti vengono avvisati quando viene avviato un avviso. Un punto di contatto può avere uno o più tipi di punti di contatto, ad esempio Amazon Simple Notification Service o Slack. Quando viene avviato un avviso, viene inviata una notifica a tutti i tipi di punti di contatto elencati per un punto di contatto. Facoltativamente, può [Utilizzo di modelli di messaggistica](alert-message-templates.md) essere utilizzato per personalizzare i messaggi di notifica per i tipi di punti di contatto.

**Nota**  
Puoi creare e modificare punti di contatto per gli avvisi gestiti da Grafana. I punti di contatto per gli avvisi di Alertmanager sono di sola lettura.

## Lavorare con i punti di contatto
<a name="alert-working-contact-points"></a>

Le seguenti procedure descrivono in dettaglio come aggiungere, modificare, testare ed eliminare i punti di contatto.

**Per aggiungere un punto di contatto**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli **Punti di contatto**, quindi Nuovo punto di contatto.**

1. Dal menu a discesa **Alertmanager**, seleziona un Alertmanager. Il Grafana Alertmanager è selezionato per impostazione predefinita.

1. Inserite un **nome per il punto** di contatto.

1. In **Tipo di punto di contatto**, scegli un tipo e i campi obbligatori in base a quel tipo. Ad esempio, se scegli Slack, inserisci i canali Slack e gli utenti che devono essere contattati.

1. Se disponibile per il punto di contatto selezionato, scegli facoltativamente **le Impostazioni opzionali per specificare impostazioni** aggiuntive.

1. In **Impostazioni di notifica**, seleziona facoltativamente **Disabilita messaggio risolto** se non desideri ricevere una notifica quando si risolve un avviso.

1. Se il tuo punto di contatto necessita di più tipi di punti di contatto, puoi scegliere **Nuovo tipo di punto di contatto e ripetere i passaggi per ogni tipo di punto** di contatto necessario.

1. Scegli **Salva punto di contatto** per salvare le modifiche.

**Per modificare un punto di contatto**

1. Scegli **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti.

1. Seleziona il punto di contatto da modificare, quindi scegli l'icona **Modifica** (penna).

1. Apporta le modifiche necessarie, quindi scegli **Salva punto di contatto** per salvare le modifiche.

Dopo aver creato il punto di contatto, puoi inviare una notifica di prova per verificare che sia configurato correttamente.

**Per inviare una notifica di prova**

1. Scegli **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. Seleziona il punto di contatto da testare, quindi scegli l'icona **Modifica** (penna).

1. Seleziona l'icona **Test** (aeroplano di carta).

1. Scegli se inviare una notifica di test predefinita o scegli **Personalizzata** per aggiungere annotazioni ed etichette personalizzate nella notifica di test.

1. Scegli **Invia notifica di test** per testare l'avviso con i punti di contatto indicati.

È possibile eliminare i punti di contatto che non sono utilizzati in base a una politica di notifica.

**Per eliminare un punto di contatto**

1. Scegliete **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. Seleziona il punto di contatto da eliminare, quindi scegli l'icona **Elimina** (cestino).

1. Nella finestra di dialogo di conferma, scegli **Sì, elimina**.

**Nota**  
Se il punto di contatto è utilizzato in base a una politica di notifica, è necessario eliminare la politica di notifica o modificarla per utilizzare un punto di contatto diverso prima di eliminare il punto di contatto.

## Elenco dei notificanti supportati
<a name="alert-supported-notifiers"></a>


|  Name  |  Tipo  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Pager Duty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Utilizzo di modelli di messaggistica
<a name="alert-message-templates"></a>

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

*Le notifiche inviate tramite [Lavorare con i punti di contatto](alert-contact-points.md) vengono create utilizzando modelli di messaggistica.* 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).

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. L'[Dati del modello](#alert-template-data)argomento elenca le variabili disponibili per la creazione di modelli.

**Utilizzo dei modelli**

I modelli vengono utilizzati per creare un messaggio. Ad esempio, con un messaggio di avviso Slack, puoi impostare il titolo e il corpo del punto di contatto. L'esempio seguente mostra come utilizzare i modelli predefiniti per creare un titolo che contenga un conteggio degli avvisi attivati e risolti e un corpo che elenchi gli avvisi e i relativi stati.
+ **Titolo:**

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **Corpo del testo**: 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

È possibile creare modelli personalizzati, come nell'esempio seguente.
+ **Titolo**:

  ```
  {{ template "slack.default.title" .}}
  ```
+ **Corpo del testo**: 

  ```
  {{ template "mymessage" .}}
  ```

Di seguito è riportato un modello di esempio.

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Le procedure seguenti mostrano come creare, modificare ed eliminare modelli di messaggio personalizzati.

**Per creare un modello di messaggio**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Punti di contatto.**

1. Dal menu a discesa **Alertmanager**, seleziona l'istanza Alertmanager per cui desideri creare un modello di messaggio. L'impostazione predefinita è Grafana Alertmanager.

1. **Scegli Aggiungi modello.**

1. Aggiungi un **nome** descrittivo.

1. Aggiungi il **contenuto** per il modello, ad esempio:

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   Il `define` tag nella sezione Contenuto assegna il nome del modello. Questo tag è facoltativo e, se omesso, il nome del modello deriva dal campo **Nome**. Quando vengono specificati entrambi, è consigliabile mantenerli uguali.

1. Scegli **Salva modello**.

**Nota**  
L'HTML nei modelli di messaggi di avviso viene visualizzato come testo, senza caratteri di controllo. Il rendering del codice HTML nella notifica risultante non è supportato da Grafana.

**Per modificare un modello di messaggio**

1. Nella pagina **Avvisi**, scegli **Punti di contatto** per aprire l'elenco dei punti di contatto.

1. Nella **tabella Modello**, trova il modello che desideri modificare, quindi scegli l'icona **Modifica** (penna).

1. Apporta le modifiche, quindi scegli **Salva modello**.

**Per eliminare un modello di messaggio**

1. Nella pagina **Avvisi**, scegli **Punti di contatto** per aprire l'elenco dei punti di contatto.

1. Nella **tabella Modello**, trova il modello che desideri rimuovere, quindi scegli l'icona **Elimina** (cestino).

1. Scegli **Sì, elimina** per eliminare il modello.

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

**Esempi di modelli personalizzati**

Ecco alcuni esempi di come utilizzare i modelli personalizzati.

Modello per il rendering di un singolo avviso:

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Modello per visualizzare l'intero messaggio di notifica:

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## Dati del modello
<a name="alert-template-data"></a>

I seguenti dati vengono passati ai modelli di messaggio.


| Name | Tipo | Note | 
| --- | --- | --- | 
|  `Receiver`  |  stringa  |  Nome del punto di contatto a cui viene inviata la notifica.  | 
|  `Status`  |  stringa  |  attivazione se viene attivato almeno un avviso, altrimenti risolto.  | 
|  `Alerts`  |  Alert  |  Elenco degli oggetti di avviso inclusi in questa notifica (vedi sotto).  | 
|  `GroupLabels`  |  KeyValue  |  Etichette in base alle quali questi avvisi sono stati raggruppati.  | 
|  `CommonLabels`  |  KeyValue  |  Etichette comuni a tutti gli avvisi inclusi in questa notifica.  | 
|  `CommonAnnotations`  |  KeyValue  |  Annotazioni comuni a tutti gli avvisi inclusi in questa notifica.  | 
|  `ExternalURL`  |  stringa  |  Link di ritorno al Grafana che ha inviato la notifica. Se si utilizza un Alertmanager esterno, ricollega a questo Alertmanager.  | 

Il `Alerts` tipo espone due funzioni per filtrare gli avvisi restituiti.
+ `Alerts.Firing`— Restituisce un elenco di avvisi di attivazione.
+ `Alerts.Resolved`— Restituisce un elenco di avvisi risolti.

**Avviso (tipo)**

Il tipo di avviso contiene i seguenti dati.


| Name | Tipo | Note | 
| --- | --- | --- | 
|  Status  |  stringa  |  `firing` o `resolved`.  | 
|  Etichette  |  KeyValue  |  Un set di etichette allegate all'avviso.  | 
|  Annotazioni  |  KeyValue  |  Un insieme di annotazioni allegate all'avviso.  | 
|  StartsAt  |  Time.time  |  L'ora in cui l'allarme ha iniziato a scattare.  | 
|  EndsAt  |  Tempo. Tempo  |  Impostato solo se è nota l'ora di fine di un avviso. Altrimenti impostato su un periodo di timeout configurabile dal momento in cui è stato ricevuto l'ultimo avviso.  | 
|  URL del generatore  |  stringa  |  Un link a Grafana o Alertmanager esterno.  | 
|  URL silenzioso  |  stringa  |  Link a grafana silence for con le etichette per questo avviso precompilate. Solo per gli avvisi gestiti da Grafana.  | 
|  URL del pannello di controllo  |  stringa  |  Collegamento alla dashboard di Grafana, se la regola di avviso appartiene a una di esse. Solo per gli avvisi gestiti da Grafana.  | 
|  URL del pannello  |  stringa  |  Collegamento al pannello di dashboard di Grafana, se la regola di avviso appartiene a uno. Solo per gli avvisi gestiti da Grafana.  | 
|  Impronta digitale  |  stringa  |  Impronta digitale che può essere utilizzata per identificare l'avviso.  | 
|  ValueString  |  stringa  |  Una stringa che contiene le etichette e il valore di ogni espressione ridotta nell'avviso.  | 

**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 | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  Elenco ordinato di coppie di stringhe di chiavi e valori  |    | 
|  Rimuovi  |  [] stringa  |  KeyValue  |  Restituisce una copia della Key/Value mappa senza le chiavi fornite.  | 
|  Nomi  |    |  [] stringa  |  Elenco dei nomi delle etichette  | 
|  Valori  |    |  [] stringa  |  Elenco dei valori delle etichette  | 



## Funzioni del modello
<a name="alert-template-functions"></a>

Utilizzando le funzioni del modello è possibile elaborare etichette e annotazioni per generare notifiche dinamiche. Sono disponibili le seguenti funzioni.


| Name | Tipo di argomento | Tipo restituito | Description | 
| --- | --- | --- | --- | 
|  `humanize`  |  numero o stringa  |  stringa  |  Converte un numero in un formato più leggibile, utilizzando prefissi metrici.  | 
|  `humanize1024`  |  numero o stringa  |  stringa  |  Come humanize, ma usa 1024 come base anziché 1000.  | 
|  `humanizeDuration`  |  numero o stringa  |  stringa  |  Converte una durata in secondi in un formato più leggibile.  | 
|  `humanizePercentage`  |  numero o stringa  |  stringa  |  Converte un valore del rapporto in una frazione di 100.  | 
|  `humanizeTimestamp`  |  numero o stringa  |  stringa  |  Converte un timestamp Unix in pochi secondi in un formato più leggibile.  | 
|  `title`  |  stringa  |  stringa  |  Strings.title, mette in maiuscolo il primo carattere di ogni parola.  | 
|  `toUpper`  |  stringa  |  stringa  |  stringhe. ToUpper, converte tutti i caratteri in lettere maiuscole.  | 
|  `toLower`  |  stringa  |  stringa  |  stringhe. ToLower, converte tutti i caratteri in minuscolo.  | 
|  `match`  |  motivo, testo  |  booleano  |  espressione regolare. MatchString Verifica una corrispondenza regexp non ancorata.  | 
|  `reReplaceAll`  |  modello, sostituzione, testo  |  stringa  |  Regexp. ReplaceAllString Sostituzione Regexp, non ancorata.  | 
|  `graphLink`  |  string - Oggetto JSON con e campi `expr` `datasource`  |  stringa  |  Restituisce il percorso della visualizzazione grafica in Explore per l'espressione e l'origine dati specificate.  | 
|  `tableLink`  |  string - Oggetto JSON con `expr` e campi `datasource`  |  stringa  |  Restituisce il percorso della vista tabulare in Explore per l'espressione e l'origine dati specificate.  | 
|  `args`  |  [] interfaccia \$1\$1  |  mappa [stringa] interfaccia \$1\$1  |  Converte un elenco di oggetti in una mappa con chiavi, ad esempio arg0, arg1. Utilizzate questa funzione per passare più argomenti ai modelli.  | 
|  `externalURL`  |  nulla  |  stringa  |  Restituisce una stringa che rappresenta l'URL esterno.  | 
|  `pathPrefix`  |  nulla  |  stringa  |  Restituisce il percorso dell'URL esterno.  | 

La tabella seguente mostra esempi di utilizzo di ciascuna funzione.


| Funzione | TemplateString | Input | Expected (Atteso) | 
| --- | --- | --- | --- | 
|  umanizzare  |  \$1umanizza \$1value\$1  |  1234567,0  |  1,235 M  | 
|  umanizza 1024  |  \$1humanize1024 \$1value\$1  |  1048576,0  |  1 Mi  | 
|  Durata umanizzata  |  \$1UmanizeDuration \$1value\$1  |  899,99  |  14 m 59 s  | 
|  Umanizza la percentuale  |  \$1humanizePercentage \$1value\$1  |  0,1234567  |  12,35%  | 
|  Umanizza il timestamp  |  \$1humanizeTimestamp \$1value\$1  |  1435065584,128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  titolo  |  \$1\$1valore \$1 titolo\$1  |  un B C  |  Aa Bb Cc  | 
|  toUpper  |  \$1\$1valore \$1 toUpper\$1  |  un dB C  |  A B C  | 
|  toLower  |  \$1\$1valore \$1 toLower\$1  |  un B C  |  a b c  | 
|  match  |  \$1match «a\$1» \$1labels.instance\$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll «localhost :( .\$1)» «my.domain: \$11" \$1labels.instance\$1\$1  |  host locale: 3000  |  mio.domain:3000  | 
|  GraphLink  |  \$1\$1graphLink «\$1\$1" expr\$1»:\$1 "up\$1»,\$1 "fonte dati\$1»:\$1 "gdev-prometheus\$1"\$1»\$1\$1  |    |  /esplorare? left= ["ora-1h», "adesso», "gdev-prometheus», \$1"datasource» :"gdev-prometheus», "expr» :"up», "instant» :false, "range» :true\$1]  | 
|  TableLink  |  \$1\$1tableLink «\$1\$1" expr\$1»:\$1 "up\$1»,\$1 "fonte dati\$1»:\$1 "gdev-prometheus\$1"\$1»\$1\$1  |    |  /esplorare? left= ["ora-1h», "adesso», "gdev-prometheus», \$1"datasource» :"gdev-prometheus», "expr» :"up», "instant» :true, "range» :false\$1]  | 
|  args  |  \$1\$1define «x"\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1template «x» (args 1 «2")\$1\$1  |    |  1 2  | 
|  URL esterno  |  \$1URL esterno\$1  |    |  http://localhost/path/prefix  | 
|  Prefisso del percorso  |  \$1PathPrefix\$1  |    |  /percorso/prefisso  | 

# Utilizzo delle politiche di notifica
<a name="alert-notifications"></a>

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

Le politiche di notifica determinano il modo in cui gli avvisi vengono indirizzati ai punti di contatto. Le politiche hanno una struttura ad albero, in cui ciascuna politica può avere una o più politiche secondarie. Ogni politica, ad eccezione della politica principale, può anche corrispondere a etichette di avviso specifiche. Ogni avviso viene valutato in base alla politica principale e quindi a ciascuna politica secondaria. Se si abilita l'`Continue matching subsequent sibling nodes`opzione per una politica specifica, la valutazione continua anche dopo una o più corrispondenze. Le impostazioni di configurazione e le informazioni sui punti di contatto di una politica principale regolano il comportamento di un avviso che non corrisponde a nessuna delle politiche secondarie. Una politica principale regola qualsiasi avviso che non corrisponde a una politica specifica.

**Nota**  
È possibile creare e modificare politiche di notifica per gli avvisi gestiti da Grafana. Le politiche di notifica per gli avvisi di Alertmanager sono di sola lettura.

**Raggruppamento delle notifiche**

Il raggruppamento classifica le notifiche di avviso di natura simile in un'unica canalizzazione. Ciò consente di controllare le notifiche di avviso durante interruzioni più ampie, quando più parti di un sistema si guastano contemporaneamente, provocando l'avvio simultaneo di un numero elevato di avvisi.

**Esempio di raggruppamento**

Supponiamo di avere 100 servizi connessi a un database in ambienti diversi. Questi servizi sono differenziati dall'etichetta. `env=environmentname` È in vigore una regola di avviso per monitorare se i servizi possono raggiungere il database. La regola di avviso crea avvisi `alertname=DatabaseUnreachable` denominati.

Se si verifica una partizione di rete in cui metà dei servizi non riesce più a raggiungere il database, vengono avviati 50 avvisi diversi. In questa situazione, si desidera ricevere una notifica a pagina singola (anziché 50) con un elenco degli ambienti interessati.

È possibile configurare il raggruppamento in modo che sia `group_by: [alertname]` (senza utilizzare l'`env`etichetta, che è diversa per ogni servizio). Con questa configurazione, Grafana invia un'unica notifica compatta che contiene tutti gli ambienti interessati da questa regola di avviso.

**Gruppi speciali**

Grafana ha due gruppi speciali. Il gruppo predefinito, `group_by: null` raggruppa *tutti gli* avvisi in un unico gruppo. È inoltre possibile utilizzare un'etichetta speciale denominata `...` per raggruppare gli avvisi in base a tutte le etichette, disabilitando efficacemente il raggruppamento e inviando ogni avviso nel proprio gruppo.

## Utilizzo delle notifiche
<a name="alert-notifications-working"></a>

Le procedure seguenti mostrano come creare e gestire le politiche di notifica.

**Per modificare la politica di notifica principale**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. Nella sezione **Root policy**, scegli l'icona **Modifica** (penna).

1. Nel **Punto di contatto predefinito**, aggiorna il punto di contatto a cui devono essere inviate le notifiche relative alle regole quando le regole di avviso non corrispondono a nessuna politica specifica.

1. In **Raggruppa per**, scegli le etichette (o i gruppi speciali) in base ai quali raggruppare gli avvisi.

1. Nelle **opzioni di temporizzazione**, seleziona una delle seguenti opzioni.
   + **Attesa di gruppo**: tempo necessario per memorizzare nel buffer gli avvisi dello stesso gruppo prima di inviare una notifica iniziale. Il valore predefinito è 30 secondi.
   + Intervallo di **gruppo: intervallo** di tempo minimo tra due notifiche per un gruppo. Il valore predefinito è 5 minuti.
   + Intervallo di **ripetizione: intervallo** di tempo minimo prima di inviare nuovamente una notifica se non sono stati aggiunti nuovi avvisi al gruppo. L'impostazione predefinita è 4 ore.

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

**Per aggiungere una nuova politica specifica di primo livello**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Nella sezione **Routing specifico**, scegli Nuova politica specifica.**

1. Nella sezione **Etichette corrispondenti**, aggiungi una o più etichette di avviso corrispondenti. Ulteriori informazioni sulla corrispondenza delle etichette sono disponibili più avanti in questo argomento.

1. In **Punto di contatto**, aggiungi il punto di contatto a cui inviare notifiche se l'avviso corrisponde a questa politica specifica. Le politiche annidate hanno la precedenza su questo punto di contatto.

1. Facoltativamente, seleziona **Ignora raggruppamento** per specificare un raggruppamento diverso dalla politica principale.

1. Facoltativamente, seleziona Ignora gli **orari generali per sovrascrivere le opzioni di temporizzazione** nella politica di notifica di gruppo.

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

**Per aggiungere una politica annidata**

1. Espandi la politica specifica in base alla quale desideri creare una politica annidata.

1. Scegli **Aggiungi politica annidata**, quindi aggiungi i dettagli (come quando aggiungi una politica specifica di primo livello).

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

**Per modificare una politica specifica**

1. Dalla pagina **Avvisi**, scegli **Criteri di notifica** per aprire la pagina che elenca le politiche esistenti.

1. Seleziona la politica che desideri modificare, quindi scegli l'icona **Modifica** (penna).

1. Apporta eventuali modifiche (come quando aggiungi una politica specifica di primo livello).

1. Scegli **Salva policy**.

**Come funziona la corrispondenza delle etichette**

Una politica corrisponde a un avviso se le etichette dell'avviso corrispondono a tutte le *etichette corrispondenti* specificate nella politica.
+ **Etichetta**: il nome dell'etichetta da abbinare. Deve corrispondere esattamente al nome dell'etichetta dell'avviso.
+ **Operatore**: l'operatore utilizzato per confrontare il valore dell'etichetta con il valore dell'etichetta corrispondente. Gli operatori disponibili sono:
  + `=`Seleziona le etichette il cui valore corrisponde esattamente alla stringa fornita.
  + `!=`Seleziona le etichette il cui valore non corrisponde alla stringa fornita.
  + `=~`Seleziona le etichette il cui valore corrisponde al valore interpretato dall'espressione regolare della stringa fornita (la stringa fornita viene interpretata come un'espressione regolare).
  + `!=`Seleziona le etichette che non corrispondono all'espressione regolare fornita.
+ **Valore**: il valore a cui abbinare il valore dell'etichetta. Può corrispondere come stringa o come espressione regolare, a seconda dell'operatore scelto.

## Tempi di silenziamento
<a name="alert-notification-muting"></a>

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.

È possibile configurare i tempi di silenziamento gestiti da Grafana e i tempi di silenziamento per un'origine dati Alertmanager esterna.

**Tempi di silenziamento rispetto ai silenzi**

La tabella seguente evidenzia le differenze tra i tempi di silenziamento e i silenzi.


| Tempistica del silenziamento | Silenzio | 
| --- | --- | 
|  Utilizza definizioni di intervalli di tempo che possono ripetersi  |  Ha un'ora di inizio e di fine fissa  | 
|  Viene creato e quindi aggiunto alle politiche di notifica  |  Utilizza le etichette da confrontare con un avviso per determinare se silenziarlo o meno  | 

**Per creare una tempistica di silenziamento**

1. **Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per **aprire la pagina Avvisi**.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Nella sezione Tempi di **silenziamento, scegli il pulsante Aggiungi tempi di** silenziamento.**

1. Scegli l'intervallo di tempo a cui desideri applicare la temporizzazione del silenziamento.

1. Scegli **Invia per creare la tempistica** di silenziamento.

**Per aggiungere una tempistica di silenziamento a una politica di notifica**

1. **Seleziona la politica di notifica a cui desideri aggiungere la tempistica di silenziamento e scegli il pulsante Modifica.**

1. Dal menu a discesa **Tempi di silenziamento, seleziona gli** orari di silenziamento che desideri aggiungere alla politica.

   **Scegli il pulsante Salva politica.**

**Intervalli di tempo**

Un intervallo di tempo è una definizione per un intervallo di tempo. Se un avviso viene avviato durante questo intervallo, viene soppresso. Gli intervalli sono supportati utilizzando `:` (ad esempio,). `monday:thursday` Una temporizzazione di silenziamento può contenere più intervalli di tempo. Un intervallo di tempo è costituito da più campi (dettagli nell'elenco seguente), che devono corrispondere tutti per eliminare gli avvisi. Ad esempio, se si specificano i giorni della settimana `monday:friday` e l'intervallo di orario dalle 8:00 alle 9:00, gli avvisi vengono eliminati dalle 8:00 alle 9:00, dal lunedì al venerdì, ma non, ad esempio, dalle 8-9 il sabato.
+ **Intervallo di tempo**: l'ora del giorno in cui sopprimere le notifiche. È composto da due sottocampi, Ora di **inizio e Ora** di **fine**. Un esempio di ora è`14:30`. L'ora è espressa nella notazione di 24 ore, in UTC.
+ **Giorni della settimana**: i giorni della settimana. Può essere un singolo giorno, ad esempio un intervallo`monday`, ad esempio`monday:friday`, o un elenco di giorni separati da virgole, ad esempio. `monday, tuesday, wednesday`
+ **Mesi**: i mesi da selezionare. È possibile specificare i mesi con designazioni numeriche o con il nome completo del mese, ad esempio, `1` oppure `january` entrambi specificano gennaio. È possibile specificare un solo mese, un intervallo di mesi o un elenco di mesi separati da virgole.
+ **Giorni del mese**: le date entro un mese. I valori possono variare da `1` -`31`. I valori negativi specificano i giorni del mese in ordine inverso, quindi `-1` rappresentano l'ultimo giorno del mese. I giorni del mese possono essere specificati come un singolo giorno, un intervallo di giorni o un elenco di giorni separato da virgole.