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à. # Informazioni sulle regole di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Una regola di avviso è un insieme di criteri di valutazione che determina se un'istanza di avviso verrà attivata. La regola è costituita da una o più interrogazioni ed espressioni, una condizione, la frequenza di valutazione e la durata entro la quale la condizione deve essere soddisfatta per iniziare a funzionare. Mentre le interrogazioni e le espressioni selezionano il set di dati da valutare, una *condizione* imposta la soglia che i dati devono soddisfare o superare per creare un avviso. Un *intervallo* specifica la frequenza con cui viene valutata una regola di avviso. *La durata*, se configurata, indica per quanto tempo deve essere soddisfatta una condizione. Le regole di avviso possono anche definire il comportamento di avviso in assenza di dati. **Topics** + [Tipi di regole di avviso](v10-alerting-explore-rules-types.md) + [Regole di registrazione](v10-alerting-explore-rule-recording.md) + [Domande e condizioni](v10-alerting-explore-rules-queries.md) + [Istanze di avviso](v10-alerting-rules-instances.md) + [Namespace, cartelle e gruppi](v10-alerting-rules-grouping.md) + [Valutazione delle regole di avviso](v10-alerting-rules-evaluation.md) + [Stato e integrità delle regole di allarme](v10-alerting-explore-state.md) + [Modello di notifica](v10-alerting-rules-notification-templates.md) # Tipi di regole di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Grafana supporta diversi tipi di regole di avviso. Scopri di più su ciascuno dei tipi di regole di avviso, su come funzionano e decidi qual è la migliore per il tuo caso d'uso. ## Regole gestite da Grafana Le regole gestite Grafana sono il tipo di regola di avviso più flessibile. Ti consentono di creare avvisi che possono agire sui dati provenienti da qualsiasi fonte di dati esistente. Oltre a supportare più fonti di dati, puoi aggiungere [espressioni](v10-panels-query-xform-expressions.md) per trasformare i dati ed esprimere le condizioni di avviso. In Grafana, avvisi gestiti: + Le regole di avviso vengono create all'interno di Grafana, sulla base di una o più fonti di dati. + Le regole di avviso vengono valutate dal motore di valutazione delle regole di avviso all'interno di Grafana. + Gli avvisi vengono inviati utilizzando il Grafana Alertmanager interno. **Nota** Puoi anche configurare gli avvisi da inviare utilizzando un Alertmanager esterno o utilizzare gestori di avvisi interni ed esterni. [Per ulteriori informazioni, consulta Aggiungere un alertmanager esterno.](v10-alerting-setup-alertmanager.md) ## Regole gestite dalle fonti di dati Per creare regole di avviso gestite dall'origine dati, devi disporre di un'origine dati Prometheus o Loki compatibile. Puoi verificare se la tua origine dati supporta la creazione di regole tramite Grafana testando l'origine dati e osservando se l'API Ruler è supportata. Negli avvisi gestiti dalle fonti di dati: + Le regole di avviso vengono create e archiviate all'interno dell'origine dati stessa. + Le regole di avviso possono essere create solo sulla base dei dati di Prometheus. + La valutazione e la distribuzione delle regole di avviso sono distribuite su più nodi per un'elevata disponibilità e tolleranza agli errori. ## Scegli un tipo di regola di avviso Quando scegli il tipo di regola di avviso da utilizzare, considera il seguente confronto tra le regole di avviso gestite da Grafana e le regole di avviso gestite dall'origine dei dati. | Funzionalità | Regola di avviso gestita da Grafana | Regola di avviso gestita da Loki/mimir | | --- | --- | --- | | Crea regole di avviso basate sui dati provenienti da una qualsiasi delle nostre fonti di dati supportate | Sì | No: puoi creare regole di avviso solo basate sui dati di Prometheus. L'origine dati deve avere l'API Ruler abilitata. | | Mescola e abbina le fonti di dati | Sì | No | | Include il supporto per le regole di registrazione | No | Sì | | Aggiungi espressioni per trasformare i dati e impostare le condizioni di avviso | Sì | No | | Usa immagini nelle notifiche di avviso | Sì | No | | Dimensionamento | Richiedono più risorse, dipendono dal database e sono suscettibili di errori temporanei. Scalano solo verticalmente. | Memorizza le regole di avviso all'interno della fonte di dati stessa e consenti una scalabilità «infinita». Genera e invia notifiche di avviso dalla posizione dei tuoi dati. | | Valutazione e distribuzione delle regole di avviso | La valutazione e la distribuzione delle regole di avviso vengono eseguite dall'interno di Grafana, utilizzando un Alertmanager esterno o entrambi. | La valutazione delle regole di avviso e l'invio degli avvisi sono distribuiti, il che significa che non esiste un unico punto di errore. | # Regole di registrazione **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) *Le regole di registrazione sono disponibili solo per le fonti di dati Prometheus o Loki compatibili.* Una regola di registrazione consente di precalcolare le espressioni più necessarie o computazionalmente costose e di salvarne il risultato in un nuovo set di serie temporali. Ciò è utile se si desidera eseguire avvisi su dati aggregati o se si dispone di dashboard che eseguono ripetutamente query su espressioni computazionalmente costose. L'interrogazione di questa nuova serie temporale è più veloce, soprattutto per i dashboard, poiché interrogano la stessa espressione ogni volta che i dashboard si aggiornano. Scopri di più sulle [regole di registrazione](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) in Prometheus. # Domande e condizioni **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) In Grafana, le query svolgono un ruolo fondamentale nel recupero e nella trasformazione dei dati da fonti di dati supportate, che includono database come MySQL e PostgreSQL, database di serie temporali come Prometheus, InfluxDB e Graphite e servizi come Amazon, Azure Monitor e Google Cloud Monitoring. OpenSearch CloudWatch Per ulteriori informazioni sulle fonti di dati supportate, consulta. [Fonti di dati e avvisi Grafana](v10-alerting-overview-datasources.md) Il processo di esecuzione di una query prevede la definizione dell'origine dati, la specificazione dei dati desiderati da recuperare e l'applicazione di filtri o trasformazioni pertinenti. Per costruire queste query vengono utilizzati linguaggi di query o sintassi specifici dell'origine dati scelta. In Alerting, si definisce una query per ottenere i dati da misurare e una condizione che deve essere soddisfatta prima che venga attivata una regola di avviso. Una regola di avviso è costituita da una o più interrogazioni ed espressioni che selezionano i dati da misurare. Per ulteriori informazioni su interrogazioni ed espressioni, vedere. [Interroga e trasforma i dati](v10-panels-query-xform.md) ## Interrogazioni relative alle fonti di dati Le interrogazioni in Grafana possono essere applicate in vari modi, a seconda della fonte di dati e del linguaggio di interrogazione utilizzati. L'editor di query di ogni fonte di dati fornisce un'interfaccia utente personalizzata che consente di scrivere query che sfruttano le sue funzionalità uniche. A causa delle differenze tra i linguaggi di interrogazione, ogni editor di query di sorgenti di dati ha un aspetto e un funzionamento diversi. A seconda della fonte di dati, l'editor di query potrebbe fornire funzionalità di completamento automatico, nomi di metriche, suggerimenti di variabili o un'interfaccia visiva per la creazione di query. Alcuni tipi comuni di componenti di interrogazione includono: **Metriche o campi dati**: specifica le metriche o i campi dati specifici che desideri recuperare, come l'utilizzo della CPU, il traffico di rete o le letture dei sensori. **Intervallo** di tempo: definisci l'intervallo di tempo per il quale desideri recuperare i dati, ad esempio l'ultima ora, un giorno specifico o un intervallo di tempo personalizzato. **Filtri**: applica filtri per restringere i dati in base a criteri specifici, ad esempio filtrando i dati in base a un tag, un host o un'applicazione specifici. **Aggregazioni**: esegui aggregazioni sui dati per calcolare metriche come medie, somme o conteggi in un determinato periodo di tempo. **Raggruppamento**: raggruppa i dati in base a dimensioni o tag specifici per creare viste o suddivisioni aggregate. **Nota** Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili [qui](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) nei forum di Grafana Labs. ## Interrogazioni sulle espressioni In Grafana, un'espressione viene utilizzata per eseguire calcoli, trasformazioni o aggregazioni sui dati interrogati dall'origine dati. Consente di creare metriche personalizzate o modificare metriche esistenti in base a operazioni matematiche, funzioni o espressioni logiche. Sfruttando le query di espressione, gli utenti possono eseguire attività come il calcolo della variazione percentuale tra due valori, applicare funzioni come funzioni logaritmiche o trigonometriche, aggregare dati su intervalli di tempo o dimensioni specifici e implementare la logica condizionale per gestire diversi scenari. In Alerting, puoi usare solo espressioni per le regole di avviso gestite da Grafana. Per ogni espressione, puoi scegliere tra le espressioni matematiche, di riduzione e di ricampionamento. Queste sono chiamate regole multidimensionali, perché generano un avviso separato per ogni serie. Puoi anche utilizzare una condizione classica, che crea una regola di avviso che attiva un singolo avviso quando viene soddisfatta la relativa condizione. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie. **Nota** Le condizioni classiche esistono principalmente per motivi di compatibilità e dovrebbero essere evitate se possibile. **Ridurre** Aggrega i valori delle serie temporali nell'intervallo temporale selezionato in un unico valore. **Math** (Matematica) Esegue calcoli matematici in formato libero functions/operations su serie temporali e dati numerici. Può essere utilizzato per preelaborare i dati delle serie temporali o per definire una condizione di avviso per i dati numerici. **Ricampionare** Riallinea un intervallo di tempo a un nuovo set di timestamp, utile quando si confrontano dati di serie temporali provenienti da diverse fonti di dati in cui i timestamp altrimenti non si allineerebbero. **Threshold** Verifica se alcuni dati delle serie temporali corrispondono alla condizione di soglia. L'espressione di soglia consente di confrontare due valori singoli. Viene restituita `0` quando la condizione è falsa e `1` se la condizione è vera. Sono disponibili le seguenti funzioni di soglia: + È superiore a (x > y) + È inferiore a (x < y) + È inferiore a (x y1 E x < y2) + < y1 AND x >È al di fuori dell'intervallo (x y2) **Condizione classica** Verifica se alcuni dati delle serie temporali corrispondono alla condizione di avviso. **Nota** Le classiche interrogazioni con espressioni di condizione producono sempre una sola istanza di avviso, indipendentemente dal numero di serie temporali che soddisfano la condizione. Le condizioni classiche esistono principalmente per motivi di compatibilità e dovrebbero essere evitate se possibile. ## Aggregazioni Grafana Alerting offre le seguenti funzioni di aggregazione per consentirti di affinare ulteriormente la tua query. Queste funzioni sono disponibili solo per le espressioni condizionali **Reduce** e **Classic**. | Funzione | Expression | Cosa fa | | --- | --- | --- | | avg | Riduci/Classico | Visualizza la media dei valori | | min | Riduci/Classic | Visualizza il valore più basso | | max | Riduci/Classic | Visualizza il valore più alto | | sum | Riduci/Classic | Visualizza la somma di tutti i valori | | count | Riduci/Classic | Conta il numero di valori nel risultato | | last | Riduci/Classic | Visualizza l'ultimo valore | | median | Riduci/Classic | Visualizza il valore mediano | | diff | Classic | Visualizza la differenza tra il valore più recente e quello più vecchio | | diff\$1abs | Classic | Visualizza il valore assoluto di diff | | percent\$1diff | Classic | Visualizza il valore percentuale della differenza tra il valore più recente e quello più vecchio | | percent\$1diff\$1abs | Classic | Visualizza il valore assoluto di percent\$1diff | | count\$1non\$1null | Classic | Visualizza un conteggio di valori nel set di risultati che non lo sono null | ## Condizione di avviso Una condizione di avviso è l'interrogazione o l'espressione che determina se l'avviso verrà attivato o meno a seconda del valore che produce. Può esserci una sola condizione che determinerà l'attivazione dell'avviso. Dopo aver definito le and/or espressioni delle interrogazioni, scegline una come condizione della regola di avviso. Quando i dati richiesti soddisfano la condizione definita, Grafana attiva l'avviso associato, che può essere configurato per inviare notifiche attraverso vari canali come e-mail, Slack o. PagerDuty Le notifiche ti informano sulla condizione soddisfatta, consentendoti di intraprendere le azioni appropriate o di indagare sul problema sottostante. Per impostazione predefinita, l'ultima espressione aggiunta viene utilizzata come condizione di avviso. ## Soglia di ripristino Per ridurre il rumore generato dagli avvisi che lampeggiano, è possibile impostare una soglia di ripristino diversa dalla soglia di avviso. Gli avvisi flapping si verificano quando una metrica si aggira intorno alla soglia di avviso e possono portare a frequenti cambiamenti di stato, con conseguente generazione di troppe notifiche. Le regole di avviso gestite da Grafana vengono valutate per un intervallo di tempo specifico. Durante ogni valutazione, il risultato della query viene confrontato con la soglia impostata nella regola di avviso. Se il valore di una metrica è superiore alla soglia, viene attivata una regola di avviso e viene inviata una notifica. Quando il valore scende al di sotto della soglia ed è presente un avviso attivo per questa metrica, l'avviso viene risolto e viene inviata un'altra notifica. Può essere difficile creare una regola di avviso per una metrica rumorosa. Cioè, quando il valore di una metrica supera e scende continuamente al di sopra e al di sotto di una soglia. Questa operazione si chiama flapping e genera una serie di notifiche di attivazione (risolte) e una cronologia dello stato di allarme rumoroso. Ad esempio, se hai un avviso di latenza con una soglia di 1000 ms e il numero oscilla intorno a 1000 (ad esempio 980 ->1010 -> 990 -> 1020 e così via), ognuna di queste attiverà una notifica. Per risolvere questo problema, puoi impostare una soglia di ripristino (personalizzata), che in pratica significa avere due soglie anziché una. Un avviso viene attivato quando viene superata la prima soglia e viene risolto solo quando viene superata la seconda soglia. Ad esempio, è possibile impostare una soglia di 1000 ms e una soglia di ripristino di 900 ms. In questo modo, una regola di avviso smetterà di attivarsi solo quando scende al di sotto di 900 ms e il flapping viene ridotto. # Istanze di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Gli avvisi gestiti Grafana supportano gli avvisi multidimensionali. Ogni regola di avviso può creare più istanze di avviso. Ciò è utile se si osservano più serie in una singola espressione. Considerate la seguente espressione PromQL: ``` sum by(cpu) ( rate(node_cpu_seconds_total{mode!="idle"}[1m]) ) ``` Una regola che utilizza questa espressione creerà tante istanze di avviso quante ne CPUs osserviamo dopo la prima valutazione, permettendo a una singola regola di riportare lo stato di ogni CPU. # Namespace, cartelle e gruppi **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Gli avvisi possono essere organizzati utilizzando cartelle per le regole gestite da Grafana e i namespace per le regole e i nomi dei gruppi di Mimir, Loki o Prometheus. **Namespace e cartelle** Quando si creano regole gestite da Grafana, la cartella può essere utilizzata per eseguire il controllo degli accessi e concedere o negare l'accesso a tutte le regole all'interno di una cartella specifica. Un namespace contiene uno o più gruppi. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari. L'intervallo predefinito è di un minuto. È possibile rinominare i namespace e i gruppi delle regole Grafana Mimi o Loki e modificare gli intervalli di valutazione dei gruppi. **Groups (Gruppi)** Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, il che significa che nessuna regola verrà valutata contemporaneamente e in ordine di apparizione. L'intervallo predefinito è di un minuto. È possibile rinominare gli spazi dei nomi delle regole Grafana Mimir o Loki o gli spazi dei nomi e i gruppi delle regole Loki e modificare gli intervalli di valutazione dei gruppi. **Suggerimento** Se desideri che le regole vengano valutate contemporaneamente e con intervalli diversi, valuta la possibilità di archiviarle in gruppi diversi. **Nota** Le regole di avviso gestite da Grafana vengono valutate contemporaneamente anziché in sequenza. # Valutazione delle regole di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Utilizzate la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e con quale rapidità deve cambiare il suo stato. A tale scopo, è necessario assicurarsi che la regola di avviso rientri nel gruppo di valutazione corretto e impostare un periodo di attesa più adatto al caso d'uso. ## Gruppo di valutazione Ogni regola di avviso fa parte di un gruppo di valutazione. Ogni gruppo di valutazione contiene un intervallo di valutazione che determina la frequenza con cui viene controllata la regola di avviso. Le regole di avviso **gestite da fonti di dati** all'interno dello stesso gruppo vengono valutate una dopo l'altra, mentre le regole di avviso in gruppi diversi possono essere valutate contemporaneamente. Questa funzionalità è particolarmente utile quando si desidera garantire che le regole di registrazione vengano valutate prima di qualsiasi regola di avviso. Le regole di avviso **gestite da Grafana** vengono valutate contemporaneamente, indipendentemente dal gruppo di regole di avviso. L'intervallo di valutazione predefinito è impostato su 10 secondi, il che significa che le regole di avviso gestite da Grafana vengono valutate ogni 10 secondi rispetto alla finestra di 10 secondi più vicina sull'orologio, ad esempio 10:00:00, 10:00:10, 10:00:20 e così via. Puoi anche configurare il tuo intervallo di valutazione, se necessario. **Nota** I gruppi di valutazione e il raggruppamento degli avvisi nelle politiche di notifica sono due cose distinte. Il raggruppamento in criteri di notifica consente di inviare più avvisi che condividono le stesse etichette nello stesso messaggio temporale. ## Periodo in sospeso Impostando un periodo di attesa, è possibile evitare avvisi non necessari per problemi temporanei. Nel periodo in sospeso, si seleziona il periodo in cui una regola di avviso può violare la condizione finché non viene attivata. **Esempio** Immagina di avere un intervallo di valutazione delle regole di avviso impostato ogni 30 secondi e il periodo in sospeso su 90 secondi. La valutazione avverrà nel modo seguente: [00:30] Prima valutazione: condizione non soddisfatta. [01:00] Seconda valutazione: condizione violata. Il contatore in sospeso inizia. **L'avviso inizia a essere sospeso.** [01:30] Terza valutazione: condizione violata. Contatore in sospeso = 30 secondi. **Stato in sospeso.** [02:00] Quarta valutazione: condizione violata. **Contatore in sospeso = 60. Stato in sospeso.** [02:30] Quinta valutazione: condizione violata. Contatore pendente = 90. **L'avviso inizia a sparare** Se la regola di avviso presenta una condizione che deve essere violata per un determinato periodo di tempo prima di agire, il suo stato cambia come segue: + Quando la condizione viene violata per la prima volta, la regola passa allo stato «in sospeso». + La regola rimane nello stato «in sospeso» fino a quando la condizione non viene violata per il periodo di tempo richiesto (periodo in sospeso). + Una volta trascorso il tempo richiesto, la regola passa allo stato di «attivazione». + Se la condizione non viene più violata durante il periodo in sospeso, la regola torna allo stato normale. **Nota** Se desideri ignorare lo stato in sospeso, puoi semplicemente impostare il periodo in sospeso su 0. In questo modo si salta effettivamente il periodo di attesa e la regola di avviso inizierà a funzionare non appena la condizione viene violata. Quando viene attivata una regola di avviso, vengono generate istanze di avviso, che vengono quindi inviate all'Alertmanager. # Stato e integrità delle regole di allarme **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Lo stato e lo stato di integrità delle regole di avviso consentono di comprendere diversi indicatori chiave di stato relativi agli avvisi. Esistono tre componenti chiave: stato della *regola di avviso, stato* dell'*istanza di avviso e stato* della *regola di avviso*. Sebbene correlati, ogni componente trasmette informazioni leggermente diverse. **Stato della regola di avviso** Una regola di avviso può trovarsi in uno dei seguenti stati: | Stato | Description | | --- | --- | | Normale | Nessuna delle serie temporali restituite dal motore di valutazione è in `Firing` stato `Pending` or. | | Pending (In attesa) | Almeno una serie temporale restituita dal motore di valutazione è`Pending`. | | Sparare | Almeno una serie temporale restituita dal motore di valutazione è`Firing`. | **Nota** Gli avvisi passeranno prima a `pending` e poi`firing`, quindi occorreranno almeno due cicli di valutazione prima che venga attivato un avviso. **Stato dell'istanza di avviso** Un'istanza di avviso può trovarsi in uno dei seguenti stati: | Stato | Description | | --- | --- | | Normale | Lo stato di un avviso che non è né attivo né in sospeso, tutto funziona correttamente. | | Pending (In attesa) | Lo stato di un avviso che è stato attivo per un periodo inferiore alla durata della soglia configurata. | | Avviso | Lo stato di un avviso che è stato attivo per un periodo superiore alla durata della soglia configurata. | | NoData | Non è stato ricevuto alcun dato per la finestra temporale configurata. | | Errore | L'errore che si è verificato durante il tentativo di valutare una regola di avviso. | **Mantieni l'ultimo stato** È possibile configurare una regola di avviso per mantenere l'ultimo stato quando viene rilevato `Error` lo stato `NoData` o. In questo modo si eviterà che gli avvisi vengano attivati e che si risolvano e si riattivino. Proprio come la normale valutazione, la regola di avviso passerà da una `Pending` a una `Firing` volta trascorso il periodo di attesa. **Stato della regola di avviso** Una regola di avviso può avere uno dei seguenti stati di integrità: | Stato | Description | | --- | --- | | Ok | Nessun errore durante la valutazione di una regola di avviso. | | Errore | Si è verificato un errore durante la valutazione di una regola di avviso. | | NoData | L'assenza di dati in almeno una serie temporale restituita durante la valutazione di una regola. | **Avvisi speciali per `NoData` e `Error`** Quando la valutazione di una regola di avviso produce lo stato `NoData` o`Error`, Grafana Alerting genererà istanze di avviso con le seguenti etichette aggiuntive: | Etichetta | Description | | --- | --- | | nome dell'avviso | In uno `DatasourceNoData` o `DatasourceError` in base allo stato. | | datasource\$1uid | L'UID della fonte di dati che ha causato lo stato. | È possibile gestire questi avvisi allo stesso modo degli avvisi normali aggiungendo un silenzio, un indirizzamento verso un punto di contatto e così via. # Modello di notifica **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Le notifiche inviate tramite punti di contatto vengono create utilizzando modelli di notifica. I modelli predefiniti di Grafana si basano sul [sistema di template Go, in cui alcuni campi vengono valutati come testo, mentre altri vengono valutati come HTML (il che può influire](https://golang.org/pkg/text/template) sull'escape). Il modello predefinito [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) è un utile riferimento per i modelli personalizzati. Poiché la maggior parte dei campi dei punti di contatto può essere modellata, è possibile creare modelli personalizzati riutilizzabili e utilizzarli in più punti di contatto. Per maggiori informazioni sulle notifiche personalizzate tramite modelli, consulta. [Personalizza le notifiche](v10-alerting-manage-notifications.md) **Modelli annidati** È possibile incorporare modelli all'interno di altri modelli. Ad esempio, è possibile definire un frammento di modello utilizzando la `define` parola chiave. ``` {{ define "mytemplate" }} {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved. {{ end }} ``` È quindi possibile incorporare modelli personalizzati all'interno di questo frammento utilizzando la parola chiave. `template` Esempio: ``` Alert summary: {{ template "mytemplate" . }} ``` È possibile utilizzare una delle seguenti opzioni di modello integrate per incorporare modelli personalizzati. | Name | Note | | --- | --- | | `default.title` | Visualizza informazioni sullo stato di alto livello. | | `default.message` | Fornisce un riepilogo formattato degli allarmi attivati e risolti. | | `teams.default.message` | Simile a`default.messsage`, formattato per Microsoft Teams. | **HTML nei modelli di notifica** Il codice HTML nei modelli di notifica di avviso non è disponibile. Non supportiamo il rendering del codice HTML nella notifica risultante. Alcuni notificanti supportano metodi alternativi per modificare l'aspetto della notifica risultante. Ad esempio, Grafana installa il modello base per avvisare le e-mail di. `/public/emails/ng_alert_notification.html` È possibile modificare questo file per cambiare l'aspetto di tutte le e-mail di avviso.