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à. # Gestisci i tuoi avvisi **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Dopo aver impostato le regole di avviso, i punti di contatto e le politiche di notifica, puoi utilizzare gli avvisi Grafana per gestire gli avvisi nella pratica. **Topics** + [Personalizza le notifiche](v10-alerting-manage-notifications.md) + [Gestisci i punti di contatto](v10-alerting-manage-contactpoints.md) + [Silenziamento delle notifiche di avviso](v10-alerting-silences.md) + [Visualizza e filtra le regole di avviso](v10-alerting-manage-rules-viewfilter.md) + [Tempi di silenziamento](v10-alerting-manage-muting.md) + [Visualizza lo stato e lo stato delle regole di avviso](v10-alerting-manage-rulestate.md) + [Visualizza e filtra per gruppi di avvisi](v10-alerting-manage-viewfiltergroups.md) + [Visualizza gli errori di notifica](v10-alerting-manage-viewnotificationerrors.md) # Personalizza le notifiche **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Personalizza le tue notifiche con i modelli di notifica. Puoi utilizzare i modelli di notifica per modificare il titolo, il messaggio e il formato del messaggio nelle notifiche. I modelli di notifica non sono legati a integrazioni di punti di contatto specifici, come Amazon SNS o Slack. Tuttavia, puoi scegliere di creare modelli di notifica separati per diverse integrazioni di punti di contatto. Puoi utilizzare i modelli di notifica per: + Aggiungere, rimuovere o riordinare le informazioni nella notifica, inclusi il riepilogo, la descrizione, le etichette e le annotazioni, i valori e i collegamenti + Formatta il testo in grassetto e corsivo e aggiungi o rimuovi interruzioni di riga Non è possibile utilizzare i modelli di notifica per: + Modifica il design delle notifiche nei servizi di messaggistica istantanea come Slack e Microsoft Teams **Topics** + [Usare il linguaggio di template di Go](v10-alerting-notifications-go-templating.md) + [Crea modelli di notifica](v10-alerting-create-templates.md) + [Utilizzo di modelli di notifica](#v10-alerting-use-notification-templates) + [Riferimento modello](v10-alerting-template-reference.md) # Usare il linguaggio di template di Go **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) [Scrivi modelli di notifica nel linguaggio di template di Go, text/template.](https://pkg.go.dev/text/template) Questa sezione fornisce una panoramica del linguaggio di template di Go e dei modelli di scrittura in text/template. ## Dot text/template C'è un cursore speciale chiamato punto, ed è scritto come`.`. Puoi pensare a questo cursore come a una variabile il cui valore cambia a seconda del punto del modello in cui viene utilizzato. Ad esempio, all'inizio di un modello di notifica `.` si fa riferimento all'`ExtendedData`oggetto, che contiene una serie di campi tra cui `Alerts``Status`, `GroupLabels``CommonLabels`, `CommonAnnotations` e`ExternalURL`. Tuttavia, dot potrebbe fare riferimento a qualcos'altro quando viene utilizzato in un elenco `range` superiore a un elenco, quando viene utilizzato all'interno di un `with` o quando si scrivono modelli di funzionalità da utilizzare in altri modelli. Puoi vederne alcuni esempi in[Crea modelli di notifica](v10-alerting-create-templates.md), e tutti i dati e le funzioni in[Riferimento modello](v10-alerting-template-reference.md). ## Tag di apertura e chiusura In text/template, i modelli iniziano `{{` e finiscono con `}}` indipendentemente dal fatto che il modello stampi una variabile o esegua strutture di controllo come le istruzioni if. Questo è diverso da altri linguaggi di template come Jinja, dove la stampa di una variabile utilizza `{{` e e le strutture di controllo utilizzano e`}}`. `{%` `%}` ## Print (Stampa) Per stampare il valore di qualcosa usa e. `{{` `}}` È possibile stampare il valore di un punto, un campo di punti, il risultato di una funzione e il valore di una [variabile](#v10-go-variables). Ad esempio, per stampare il `Alerts` campo a cui si riferisce il punto `ExtendedData` devi scrivere quanto segue: ``` {{ .Alerts }} ``` ## Esegui iterazioni sugli avvisi Per stampare solo le etichette di ogni avviso, anziché tutte le informazioni sull'avviso, puoi utilizzare `range` a per ripetere gli avvisi in: `ExtendedData` ``` {{ range .Alerts }} {{ .Labels }} {{ end }} ``` All'interno dell'intervallo il punto non si riferisce più a`ExtendedData`, ma a un. `Alert` È possibile utilizzare `{{ .Labels }}` per stampare le etichette di ogni avviso. Funziona perché `{{ range .Alerts }}` cambia il punto per fare riferimento all'avviso corrente nell'elenco degli avvisi. Quando l'intervallo è terminato, il punto viene ripristinato al valore che aveva prima dell'inizio dell'intervallo, che in questo esempio è`ExtendedData`: ``` {{ range .Alerts }} {{ .Labels }} {{ end }} {{/* does not work, .Labels does not exist here */}} {{ .Labels }} {{/* works, cursor was reset */}} {{ .Status }} ``` ## Esegui iterazioni su annotazioni ed etichette Scriviamo un modello per stampare le etichette di ogni avviso nel formato`The name of the label is $name, and the value is $value`, dove `$name` e `$value` contiene il nome e il valore di ogni etichetta. Come nell'esempio precedente, utilizzate un intervallo per scorrere gli avvisi in `.Alerts` modo che il punto si riferisca all'avviso corrente nell'elenco degli avvisi, quindi utilizzate un secondo intervallo sulle etichette ordinate in modo che dot venga aggiornato una seconda volta per fare riferimento all'etichetta corrente. All'interno del secondo intervallo usa `.Name` e stampa `.Value` il nome e il valore di ogni etichetta: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} The name of the label is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ range .Annotations.SortedPairs }} The name of the annotation is {{ .Name }}, and the value is {{ .Value }} {{ end }} {{ end }} ``` ## Le funzioni dell'indice Per stampare un'annotazione o un'etichetta specifica, usa la `index` funzione. ``` {{ range .Alerts }} The name of the alert is {{ index .Labels "alertname" }} {{ end }} ``` ## Dichiarazioni If È possibile utilizzare le istruzioni if nei modelli. Ad esempio, per stampare `There are no alerts` se non sono presenti avvisi, `.Alerts` è necessario scrivere quanto segue: ``` {{ if .Alerts }} There are alerts {{ else }} There are no alerts {{ end }} ``` ## Con With è simile alle istruzioni if, tuttavia a differenza delle istruzioni if, `with` aggiorna dot per fare riferimento al valore di with: ``` {{ with .Alerts }} There are {{ len . }} alert(s) {{ else }} There are no alerts {{ end }} ``` ## Variabili Le variabili in text/template devono essere create all'interno del modello. Ad esempio, per creare una variabile chiamata `$variable` con il valore corrente di dot devi scrivere quanto segue: ``` {{ $variable := . }} ``` Puoi usare `$variable` all'interno di un intervallo o `with` e farà riferimento al valore di dot nel momento in cui la variabile è stata definita, non al valore corrente di dot. Ad esempio, non puoi scrivere un modello da utilizzare `{{ .Labels }}` nel secondo intervallo perché qui il punto si riferisce all'etichetta corrente, non all'avviso corrente: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* does not work because in the second range . is a label not an alert */}} There are {{ len .Labels }} {{ end }} {{ end }} ``` Puoi risolvere questo problema definendo una variabile chiamata `$alert` nel primo intervallo e prima del secondo intervallo: ``` {{ range .Alerts }} {{ $alert := . }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{/* works because $alert refers to the value of dot inside the first range */}} There are {{ len $alert.Labels }} {{ end }} {{ end }} ``` ## Intervallo con indice È possibile ottenere l'indice di ogni avviso all'interno di un intervallo definendo le variabili di indice e valore all'inizio dell'intervallo: ``` {{ $num_alerts := len .Alerts }} {{ range $index, $alert := .Alerts }} This is alert {{ $index }} out of {{ $num_alerts }} {{ end }} ``` ## Definire i modelli È possibile definire modelli che possono essere utilizzati all'interno di altri modelli, utilizzando `define` e il nome del modello tra virgolette doppie. Non è necessario definire modelli con lo stesso nome di altri modelli, inclusi modelli predefiniti come `__subject``__text_values_list`,`__text_alert_list`, `default.title` e`default.message`. Se è stato creato un modello con lo stesso nome di un modello predefinito o un modello in un altro modello di notifica, Grafana potrebbe utilizzare entrambi i modelli. Grafana non impedisce o mostra un messaggio di errore quando ci sono due o più modelli con lo stesso nome. ``` {{ define "print_labels" }} {{ end }} ``` ## Esegui modelli È possibile eseguire un modello definito all'interno del modello utilizzando `template` il nome del modello tra virgolette doppie e il cursore da passare al modello: ``` {{ template "print_labels" . }} ``` ## Passa i dati ai modelli All'interno di un modello, il punto si riferisce al valore passato al modello. Ad esempio, se a un modello viene passato un elenco di avvisi di attivazione, dot si riferisce a quell'elenco di avvisi di attivazione: ``` {{ template "print_alerts" .Alerts }} ``` Se al modello vengono passate le etichette ordinate per un avviso, dot si riferisce all'elenco di etichette ordinate: ``` {{ template "print_labels" .SortedLabels }} ``` Questo è utile quando si scrivono modelli riutilizzabili. Ad esempio, per stampare tutti gli avvisi potresti scrivere quanto segue: ``` {{ template "print_alerts" .Alerts }} ``` Quindi, per stampare solo gli avvisi di attivazione, puoi scrivere questo: ``` {{ template "print_alerts" .Alerts.Firing }} ``` Funziona perché entrambi `.Alerts` `.Alerts.Firing` sono elenchi di avvisi. ``` {{ define "print_alerts" }} {{ range . }} {{ template "print_labels" .SortedLabels }} {{ end }} {{ end }} ``` ## Commenti Puoi aggiungere commenti con `{{/*` e`*/}}`: ``` {{/* This is a comment */}} ``` Per evitare che i commenti aggiungano interruzioni di riga, usa: ``` {{- /* This is a comment with no leading or trailing line breaks */ -}} ``` ## Indentazione Puoi usare l'indentazione, sia di tabulazioni che di spazi, e le interruzioni di riga, per rendere i modelli più leggibili: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` Tuttavia, l'indentazione nel modello sarà presente anche nel testo. Successivamente vedremo come rimuoverlo. ## Rimuovi spazi e interruzioni di riga In text/template uso `{{-` e `-}}` per rimuovere gli spazi iniziali e finali e le interruzioni di riga. Ad esempio, quando si utilizzano indentazioni e interruzioni di riga per rendere un modello più leggibile: ``` {{ range .Alerts }} {{ range .Labels.SortedPairs }} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` L'indentazione e le interruzioni di riga saranno presenti anche nel testo: ``` alertname = "Test" grafana_folder = "Test alerts" ``` Puoi rimuovere i rientri e le interruzioni di riga dal testo cambiando la posizione `}}` `-}}` all'inizio di ogni intervallo: ``` {{ range .Alerts -}} {{ range .Labels.SortedPairs -}} {{ .Name }} = {{ .Value }} {{ end }} {{ end }} ``` I rientri e le interruzioni di riga nel modello sono ora assenti dal testo: ``` alertname = "Test" grafana_folder = "Test alerts" ``` # Crea modelli di notifica **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Crea modelli di notifica riutilizzabili da inviare ai tuoi punti di contatto. Puoi aggiungere uno o più modelli al tuo modello di notifica. Il nome del modello di notifica deve essere univoco. Non è possibile avere due modelli con lo stesso nome nello stesso modello di notifica o in modelli di notifica diversi. Evita di definire modelli con lo stesso nome dei modelli predefiniti, ad esempio: `__subject``__text_values_list`,`__text_alert_list`, `default.title` e`default.message`. Nella scheda Punti di contatto, puoi visualizzare un elenco dei tuoi modelli di notifica. ## Creazione di modelli di notifica **Per creare un modello di notifica** 1. Scegli **Avvisi**, **Punti di contatto**. 1. Scegli la scheda **Modelli di notifica**, quindi **\$1 Aggiungi modello di notifica**. 1. Scegli un nome per il modello di notifica, ad esempio`email.subject`. 1. Scrivi il contenuto del modello nel campo del contenuto. Esempio: ``` {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Salvare le modifiche. `{{ define "email.subject" }}`(`email.subject`dov'è il nome del modello) e `{{ end }}` viene aggiunto automaticamente all'inizio e alla fine del contenuto. **Per creare un modello di notifica che contenga più di un modello** 1. Scegli **Avvisi**, **Punti di contatto**. 1. Scegli la scheda **Modelli di notifica**, quindi **\$1 Aggiungi modello di notifica**. 1. Inserisci un nome per il modello di notifica generale. Ad esempio, `email`. 1. Scrivi ogni modello nel campo Contenuto, incluso `{{ define "name-of-template" }}` e `{{ end }}` all'inizio e alla fine di ogni modello. È possibile utilizzare nomi descrittivi per ciascuno dei modelli nel modello di notifica, ad esempio, `email.subject` o`email.message`. In questo caso, non riutilizzare il nome del modello di notifica inserito in precedenza. Le sezioni successive mostrano esempi dettagliati di modelli che potresti creare. 1. Fai clic su Salva. ## Visualizza in anteprima i modelli di notifica Visualizza in anteprima l'aspetto dei modelli di notifica prima di utilizzarli nei punti di contatto, aiutandoti a comprendere il risultato del modello che stai creando e dandoti la possibilità di correggere eventuali errori prima di salvare il modello. **Nota** Le anteprime delle notifiche sono disponibili solo per Grafana Alertmanager. **Per visualizzare in anteprima i modelli di notifica** 1. Scegli **Avvisi**, **Punti di contatto**. 1. Scegli la scheda **Modelli di notifica**, quindi **\$1 Aggiungi modello di notifica** o modifica un modello esistente. 1. Aggiungi o aggiorna il contenuto del modello. Vengono forniti dati predefiniti ed è possibile aggiungere o modificare i dati degli avvisi e le istanze di avviso. È possibile aggiungere i dati di avviso direttamente nella finestra dei dati Payload stessa oppure fare clic su **Seleziona istanze di avviso** o **Aggiungi** avvisi personalizzati. 1. [Facoltativo] Per aggiungere dati di avviso da istanze di avviso esistenti: 1. Scegli **Seleziona istanze di avviso**. 1. Passa il mouse sulle istanze di avviso per visualizzare ulteriori informazioni su ciascuna istanza di avviso/ 1. Scegli **Conferma** per aggiungere l'istanza di avviso al payload. 1. [Facoltativo] Per aggiungere dati di avviso utilizzando l'editor di dati di avviso, scegli **Aggiungi dati personalizzati**: 1. Aggiungi annotazioni, etichette personalizzate o imposta una dashboard o un pannello. 1. Attiva o Risolto, a seconda che tu voglia aggiungere avvisi di attivazione o risolti alla notifica. 1. **Scegli Aggiungi dati di avviso.** 1. Scegli **Aggiorna anteprima** per vedere come apparirà il contenuto del modello e i dati del payload corrispondenti. Se ci sono errori nel modello, questi vengono visualizzati nell'anteprima e puoi correggerli prima di salvarli. 1. Salvare le modifiche. ## Creazione di un modello per l'oggetto del messaggio Crea un modello per l'oggetto di un'e-mail che contenga il numero di avvisi di attivazione e risolti, come in questo esempio: ``` 1 firing alerts, 0 resolved alerts ``` **Per creare un modello per l'oggetto di un'e-mail** 1. Crea un modello chiamato `email.subject` con il seguente contenuto: ``` {{ define "email.subject" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Usa il modello quando crei l'integrazione del punto di contatto inserendolo nel campo **Oggetto** con la `template` parola chiave. ``` {{ template "email.subject" . }} ``` ## Creazione di un modello per il messaggio di un'e-mail Crea un modello per il messaggio di un'e-mail che contenga un riepilogo di tutti gli avvisi di attivazione e risolti, come in questo esempio: ``` There are 2 firing alerts, and 1 resolved alerts Firing alerts: - alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1 - alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2 Resolved alerts: - alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0 ``` **Per creare un modello per il messaggio di un'e-mail** 1. Crea un modello di notifica chiamato `email` con due modelli nel contenuto: `email.message_alert` e`email.message`. Il `email.message_alert` modello viene utilizzato per stampare le etichette e i valori per ogni avviso di attivazione e risolto, mentre il `email.message` modello contiene la struttura dell'e-mail. ``` {{- define "email.message_alert" -}} {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s) {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }} {{- end -}} {{ define "email.message" }} There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts {{ if .Alerts.Firing -}} Firing alerts: {{- range .Alerts.Firing }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ if .Alerts.Resolved -}} Resolved alerts: {{- range .Alerts.Resolved }} - {{ template "email.message_alert" . }} {{- end }} {{- end }} {{ end }} ``` 1. Utilizza il modello per creare l'integrazione del punto di contatto inserendolo nel campo **Text Body** con la `template` parola chiave. ``` {{ template "email.message" . }} ``` ## Creazione di un modello per il titolo di un messaggio Slack Crea un modello per il titolo di un messaggio Slack che contenga il numero di avvisi attivati e risolti, come nell'esempio seguente: ``` 1 firing alerts, 0 resolved alerts ``` **Per creare un modello per il titolo di un messaggio Slack** 1. Crea un modello chiamato `slack.title` con il seguente contenuto: ``` {{ define "slack.title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Esegui il modello dal campo del titolo nell'integrazione del tuo punto di contatto. ``` {{ template "slack.title" . }} ``` ## Creazione di un modello per il contenuto di un messaggio Slack Crea un modello per il contenuto di un messaggio Slack che contenga una descrizione di tutti gli avvisi attivati e risolti, comprese le etichette, le annotazioni e l'URL della dashboard. **Nota** Questo modello è solo per gli avvisi gestiti da Grafana. Per utilizzare il modello per gli avvisi gestiti dall'origine dati, elimina i riferimenti a dashboardURL e silenceURL. [Per ulteriori informazioni sulla configurazione delle notifiche di Prometheus, consulta la documentazione di Prometheus sulle notifiche.](https://prometheus.io/docs/alerting/latest/notifications/) ``` 1 firing alerts: [firing] Test1 Labels: - alertname: Test1 - grafana_folder: GrafanaCloud Annotations: - description: This is a test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 1 resolved alerts: [firing] Test2 Labels: - alertname: Test2 - grafana_folder: GrafanaCloud Annotations: - description: This is another test alert Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1 ``` **Per creare un modello per il contenuto di un messaggio Slack** 1. Crea un modello chiamato `slack` con due modelli nel contenuto: `slack.print_alert` e`slack.message`. Il `slack.print_alert` modello viene utilizzato per stampare le etichette, le annotazioni e DashboardURL mentre il `slack.message` modello contiene la struttura della notifica. ``` {{ define "slack.print_alert" -}} [{{.Status}}] {{ .Labels.alertname }} Labels: {{ range .Labels.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ if .Annotations -}} Annotations: {{ range .Annotations.SortedPairs -}} - {{ .Name }}: {{ .Value }} {{ end -}} {{ end -}} {{ if .DashboardURL -}} Go to dashboard: {{ .DashboardURL }} {{- end }} {{- end }} {{ define "slack.message" -}} {{ if .Alerts.Firing -}} {{ len .Alerts.Firing }} firing alerts: {{ range .Alerts.Firing }} {{ template "slack.print_alert" . }} {{ end -}} {{ end }} {{ if .Alerts.Resolved -}} {{ len .Alerts.Resolved }} resolved alerts: {{ range .Alerts.Resolved }} {{ template "slack.print_alert" .}} {{ end -}} {{ end }} {{- end }} ``` 1. Esegui il modello dal campo del corpo del testo nell'integrazione del punto di contatto: ``` {{ template "slack.message" . }} ``` ## Crea modelli sia per email che per Slack con modelli condivisi Invece di creare modelli di notifica separati per ogni punto di contatto, come email e Slack, puoi condividere lo stesso modello. Ad esempio, se desideri inviare un'email con questo oggetto e un messaggio Slack con questo titolo`1 firing alerts, 0 resolved alerts`, puoi creare un modello condiviso. **Per creare un modello condiviso** 1. Crea un modello chiamato `common.subject_title` con il seguente contenuto: ``` {{ define "common.subject_title" }} {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts {{ end }} ``` 1. Per le e-mail, esegui il modello dal campo dell'oggetto nell'integrazione del punto di contatto e-mail: ``` {{ template "common.subject_title" . }} ``` 1. Per Slack, esegui il modello dal campo del titolo nell'integrazione con i punti di contatto Slack: ``` {{ template "common.subject_title" . }} ``` ## Utilizzo di modelli di notifica Utilizza i modelli nei punti di contatto per personalizzare le notifiche. **Per utilizzare un modello durante la creazione di un punto di contatto** 1. Dal menu **Avvisi**, scegli la scheda **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti. 1. Scegli **New (Nuovo)**. In alternativa, puoi modificare un punto di contatto esistente scegliendo l'icona **Modifica**. 1. Inserisci i modelli che desideri utilizzare in un campo, ad esempio **Messaggio** o **Oggetto**. Per inserire un modello, usa il modulo`{{ template "template_name" . }}`, sostituendolo *template\$1name* con il nome del modello che desideri utilizzare. 1. Scegli **Salva punto di contatto**. # Riferimento modello **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Questa sezione fornisce informazioni di riferimento per la creazione dei modelli. **Avviso (tipo)** Il tipo di avviso contiene i seguenti dati. | Name | Tipo | Description | Esempio | | --- | --- | --- | --- | | Status | stringa | `firing` o `resolved`. | \$1\$1 .Status \$1\$1 | | Etichette | KeyValue | Un set di etichette allegate all'avviso. | \$1\$1 .Labels \$1\$1 | | Annotazioni | KeyValue | Un insieme di annotazioni allegate all'avviso. | \$1\$1 .Annotations \$1\$1 | | Valori | KeyValue | I valori di tutte le espressioni, incluse le condizioni classiche | \$1\$1 .Values \$1\$1 | | StartsAt | Time.time | L'ora in cui l'allarme ha iniziato a scattare. | \$1\$1 .StartsAt \$1\$1 | | EndsAt | Tempo. Tempo | Impostato solo se è nota l'ora di fine di un avviso. Altrimenti impostato su un periodo di timeout configurabile dal momento in cui è stato ricevuto l'ultimo avviso. | \$1\$1 .EndsAt \$1\$1 | | URL del generatore | stringa | Un link a Grafana o Alertmanager esterno. | \$1\$1 .GeneratorURL \$1\$1 | | URL silenzioso | stringa | Un link per silenziare l'avviso (con le etichette precompilate per questo avviso). Solo per gli avvisi gestiti da Grafana. | \$1\$1 .SilenceURL\$1\$1 | | URL del pannello di controllo | stringa | Collegamento alla dashboard di Grafana, se la regola di avviso appartiene a una di esse. Solo per gli avvisi gestiti da Grafana. | \$1\$1 .DashboardURL \$1\$1 | | URL del pannello | stringa | Collegamento al pannello di dashboard di Grafana, se la regola di avviso appartiene a uno. Solo per gli avvisi gestiti da Grafana. | \$1\$1 .PanelURL \$1\$1 | | Impronta digitale | stringa | Impronta digitale che può essere utilizzata per identificare l'avviso. | \$1\$1 .Fingerprint \$1\$1 | | ValueString | stringa | Una stringa che contiene le etichette e il valore di ogni espressione ridotta nell'avviso. | \$1\$1 .ValueString \$1\$1 | **ExtendedData** L' ExtendedData oggetto contiene le seguenti proprietà. | Name | Tipo | Description | Esempio | | --- | --- | --- | --- | | Ricevitore | `string` | Il nome del punto di contatto che invia la notifica. | `{{ .Receiver }}` | | Status | `string` | Lo stato è `firing` se viene attivato almeno un avviso, altrimenti`resolved`. | `{{ .Status }}` | | Avvisi | `[]Alert` | Elenco di tutti gli allarmi attivi e risolti in questa notifica. | `There are {{ len .Alerts }} alerts` | | Avvisi di attivazione | `[]Alert` | Elenco di tutti gli allarmi di attivazione contenuti in questa notifica. | `There are {{ len .Alerts.Firing }} firing alerts` | | Avvisi risolti | `[]Alert` | Elenco di tutti gli avvisi risolti in questa notifica. | `There are {{ len .Alerts.Resolved }} resolved alerts` | | GroupLabels | `KeyValue` | Le etichette che raggruppano questi avvisi in questa notifica. | `{{ .GroupLabels }}` | | CommonLabels | `KeyValue` | Le etichette comuni a tutti gli avvisi di questa notifica. | `{{ .CommonLabels }}` | | CommonAnnotations | `KeyValue` | Le annotazioni comuni a tutti gli avvisi di questa notifica. | `{{ .CommonAnnotations }}` | | URL esterno | `string` | Un collegamento all'area di lavoro Grafana o Alertmanager che ha inviato questa notifica. | `{{ .ExternalURL }}` | **KeyValue tipo** Il `KeyValue` tipo è un insieme di coppie di key/value stringhe che rappresentano etichette e annotazioni. Oltre all'accesso diretto ai dati archiviati come file`KeyValue`, esistono anche metodi per ordinare, rimuovere e trasformare i dati. | Name | Arguments (Argomenti) | Valori restituiti | Note | Esempio | | --- | --- | --- | --- | --- | | SortedPairs | | Elenco ordinato di coppie di stringhe di chiavi e valori | | `{{ .Annotations.SortedPairs }}` | | Rimuovi | [] stringa | KeyValue | Restituisce una copia della Key/Value mappa senza le chiavi fornite. | `{{ .Annotations.Remove "summary" }}` | | Nomi | | [] stringa | Elenco di nomi | `{{ .Names }}` | | Valori | | [] stringa | Elenco di valori | `{{ .Values }}` | **Time** (Orario) L'ora proviene dal [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)pacchetto Go. È possibile stampare un orario in diversi formati. Ad esempio, per stampare l'ora di attivazione di un avviso nel formato`Monday, 1st January 2022 at 10:00AM`, scrivi il seguente modello: ``` {{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }} ``` Puoi trovare un riferimento per il formato orario di Go [qui](https://pkg.go.dev/time#pkg-constants). # Gestisci i punti di contatto **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) La visualizzazione a elenco dei **punti di contatto** elenca tutti i punti di contatto e i modelli di notifica esistenti. Nella scheda **Punti di contatto**, puoi: + Cerca nomi e tipi di punti di contatto e integrazioni. + Visualizza tutti i punti di contatto e le integrazioni esistenti. + Visualizza per quante politiche di notifica viene utilizzato ciascun punto di contatto e accedi direttamente alle politiche di notifica collegate. + Visualizza lo stato delle consegne delle notifiche. + Esporta i singoli punti di contatto o tutti i punti di contatto in formato JSON, YAML o Terraform. + Elimina i punti di contatto che non sono utilizzati da una politica di notifica. Nella scheda **Modelli di notifica**, puoi: + Visualizzare, modificare, copiare o eliminare i modelli di notifica esistenti. # Silenziamento delle notifiche di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) *È possibile sopprimere le notifiche di avviso con un silenzio.* Un silenzio impedisce solo la creazione di notifiche: i silenzi non impediscono la valutazione delle regole di avviso e non impediscono la visualizzazione delle istanze di avviso nell'interfaccia utente. Quando si silenzia un avviso, si specifica un intervallo di tempo entro il quale tale avviso deve essere soppresso. **Nota** Per sopprimere le notifiche di avviso a intervalli di tempo regolari, ad esempio durante i normali periodi di manutenzione, utilizzate [Tempi di silenziamento](v10-alerting-manage-muting.md) anziché i silenzi. **Per aggiungere un silenzio** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. **Scegli Silenzi.** 1. **Scegli un Alertmanager dal menu a discesa Alertmanager.** 1. **Scegli Crea silenzio.** 1. Seleziona la data di inizio e di fine in **Silenzio inizio e fine** per indicare quando il silenzio deve entrare in vigore e quando dovrebbe finire. 1. In alternativa all'impostazione di un'ora di fine, in **Durata**, specifica per quanto tempo viene applicato il silenzio. Questo aggiorna automaticamente l'ora di fine nel campo di **inizio e fine del silenzio**. 1. Nei campi **Etichetta** e **Valore**, inserisci una o più *etichette corrispondenti*. Gli abbinatori determinano a quali regole si applica il silenzio. Tutti gli avvisi corrispondenti (in stato di attivazione) verranno visualizzati nel campo Istanze di **avvisi interessati**. 1. **Facoltativamente, aggiungi un commento che descriva il silenzio.** 1. Seleziona **Invia**. **Per modificare un silenzio** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. Scegli **Silenze** per visualizzare l'elenco dei silenzi esistenti. 1. Trova il silenzio che desideri modificare, quindi scegli **Modifica** (icona a forma di penna). 1. Apporta le modifiche desiderate, quindi scegli **Invia** per salvare le modifiche. Puoi modificare un silenzio esistente scegliendo l'icona **Modifica** (penna). **Per creare un collegamento URL a un modulo di silenzio** Quando ti colleghi a un modulo di silenzio, fornisci le etichette corrispondenti predefinite e commenta i parametri tramite `matcher` e `comment` query. Il `matcher` parametro deve avere il seguente formato, in `[label][operator][value]` cui il `operator` parametro può essere uno dei seguenti: `=` (equals, not regex), (not equals, not regex), `!=` (equals, regex), (not equals, regex), `=~` (not equals, regex). `!~` L'URL può contenere molti `matcher` parametri di query con la chiave. Ad esempio, per creare un collegamento a un modulo silenzioso con etichette `severity=critical` & `cluster!~europe-.*` e commenti corrispondenti`Silence critical EU alerts`, crea un URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`. Per creare un collegamento a una nuova pagina di silenzio per un Alertmanager esterno, aggiungi un `alertmanager` parametro di query **Per rimuovere un silenzio** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. Scegli **Silenze** per visualizzare l'elenco dei silenzi esistenti. 1. **Seleziona il silenzio che vuoi terminare e scegli Annulla silenzio.** Questo termina la soppressione degli avvisi. **Nota** La disattivazione del silenzio interrompe la soppressione degli avvisi, come se l'ora di fine fosse impostata per l'ora corrente. I silenzi terminati (automaticamente o manualmente) vengono conservati ed elencati per cinque giorni. Non è possibile rimuovere manualmente un silenzio dall'elenco. # Visualizza e filtra le regole di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) La pagina Avvisi elenca le **regole di avviso.** Per impostazione predefinita, le regole sono raggruppate per tipi di origini dati. La sezione **Grafana** elenca le regole gestite da Grafana. Qui sono elencate anche le regole di avviso per le fonti di dati compatibili con Prometheus. È possibile visualizzare le regole di avviso per le fonti di dati compatibili con Prometheus, ma non è possibile modificarle. La sezione Mimir/Cortex/Loki delle regole elenca tutte le regole per le fonti di dati Mimir, Cortex o Loki. In questa sezione sono elencate anche le regole di avviso cloud. Quando gestisci grandi volumi di avvisi, puoi utilizzare funzionalità estese di ricerca delle regole di avviso per filtrare cartelle, gruppi di valutazione e regole. Inoltre, puoi filtrare le regole di avviso in base alle loro proprietà come etichette, stato, tipo e stato di integrità. ## Visualizza le regole di avviso Utilizzando gli avvisi Grafana, puoi visualizzare tutti i tuoi avvisi in un'unica pagina. **Per visualizzare i dettagli degli avvisi** 1. **Dalla console Grafana, nel menu Grafana, scegli **Avvisi, Regole di avviso**.** Per impostazione predefinita, viene visualizzata la visualizzazione a elenco. 1. In **Visualizza come**, puoi passare dalla visualizzazione Raggruppata a quella Elenco e quella a Stato scegliendo l'opzione che preferisci. 1. Espandi la riga delle regole per visualizzare le etichette delle regole, le annotazioni, le fonti di dati, le domande sulle regole e un elenco di istanze di avviso risultanti dalla regola. Da questa pagina, puoi anche creare copie di una regola di avviso per aiutarti a riutilizzare le regole esistenti. ## Esporta le regole di avviso Puoi esportare le regole in YAML o JSON nell'area di lavoro Grafana. + Scegli l'icona **Esporta gruppo di regole** accanto a ciascun gruppo di regole di avviso da esportare in YAML, JSON o Terraform. + Scegli **Esporta regole** per esportare tutte le regole di avviso gestite da Grafana in YAML, JSON o Terraform. + Scegli **Altro**, **Modifica esportazione** accanto a ogni singola regola di avviso all'interno di un gruppo per modificare le regole di avviso predisposte ed esportare una versione modificata. ## Visualizza le definizioni delle interrogazioni per gli avvisi predisposti Visualizza le definizioni delle query di sola lettura per gli avvisi predisposti. Verifica rapidamente se le tue query sulle regole di avviso sono corrette, senza dover accedere al tuo repository «as-code» per le definizioni delle regole. **Visualizzazione raggruppata** La visualizzazione raggruppata mostra le regole di avviso Grafana raggruppate per cartella e le regole di avviso Loki o Prometheus raggruppate per \$1. `namespace` `group` Questa è la visualizzazione predefinita dell'elenco delle regole, destinata alla gestione delle regole. È possibile espandere ogni gruppo per visualizzare un elenco delle regole in esso contenute. Espandi ulteriormente una regola per visualizzarne i dettagli. Puoi anche espandere i pulsanti di azione e gli avvisi risultanti dalla regola per visualizzarne i dettagli. **Visualizzazione dello stato** La visualizzazione dello stato mostra le regole di avviso raggruppate per stato. Utilizzate questa visualizzazione per avere una panoramica delle regole e dello stato in cui si trovano. Ogni regola può essere espansa per visualizzarne i dettagli. I pulsanti di azione e tutti gli avvisi generati da questa regola; ogni avviso può essere ulteriormente espanso per visualizzarne i dettagli. ## Regole di filtraggio degli avvisi È possibile filtrare le regole di avviso visualizzate nella pagina **Avvisi in diversi** modi. **Per filtrare le regole di avviso** 1. Da **Seleziona fonti di dati**, seleziona una fonte di dati. Puoi visualizzare le regole di avviso che interrogano l'origine dati selezionata. 1. In **Cerca per etichetta**, inserisci i criteri di ricerca utilizzando i selettori di etichette. Ad esempio, `environment=production;region=~US|EU,severity!=warning`. 1. Da **Filtra gli avvisi per stato**, seleziona lo stato di avviso che desideri visualizzare. Puoi visualizzare le regole di avviso che corrispondono a quello stato. Le regole che corrispondono ad altri stati sono nascoste. # Tempi di silenziamento **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Una tempistica di silenziamento è un intervallo di tempo ricorrente in cui non vengono generate o inviate nuove notifiche relative a una policy. Utilizzali per evitare che gli avvisi si attivino in un periodo specifico e ricorrente, ad esempio un periodo di manutenzione regolare. Analogamente ai silenzi, i tempi di disattivazione dell'audio non impediscono la valutazione delle regole di avviso né impediscono la visualizzazione delle istanze di avviso nell'interfaccia utente. Impediscono solo la creazione di notifiche. È possibile configurare i tempi di silenziamento gestiti da Grafana e i tempi di silenziamento per un'origine dati Alertmanager esterna. ## Tempi di silenziamento vs silenzi La tabella seguente evidenzia le differenze tra i tempi di silenziamento e i silenzi. | Tempistica del silenziamento | Silenzio | | --- | --- | | Utilizza definizioni di intervalli di tempo che possono ripetersi. | Ha un'ora di inizio e di fine fisse. | | Viene creato e quindi aggiunto alle politiche di notifica. | Utilizza le etichette per confrontarle con un avviso per determinare se silenziarlo o meno. | ## Aggiunge una tempistica di silenziamento Puoi creare tempi di silenziamento nell'area di lavoro Grafana. **Per aggiungere una tempistica di silenziamento** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. **Scegli **Politiche di notifica**, quindi seleziona la scheda Tempi di disattivazione dell'audio.** 1. Dal menu a discesa **Alertmanager**, seleziona il gestore degli avvisi che desideri modificare. 1. Scegli il pulsante **\$1** Aggiungi temporizzazione del silenziamento. 1. Compila il modulo per creare un [intervallo di tempo in base al quale](#v10-alerting-manage-muting-interval) confrontare i tempi di silenziamento. 1. Salva i tempi di silenziamento. ## Aggiungere una tempistica di silenziamento a una politica di notifica Una volta stabilita una tempistica di silenziamento, è possibile utilizzarla aggiungendola alla politica di notifica che si desidera disattivare a intervalli regolari. **Per aggiungere una tempistica di silenziamento a una politica di notifica** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. Scegli **Criteri di notifica, quindi seleziona la scheda Politiche** di **notifica**. 1. **Seleziona la politica di notifica a cui desideri aggiungere la tempistica di silenziamento e scegli...** **, Modifica.** 1. Dal menu a discesa **Tempi di silenziamento**, seleziona gli orari di silenziamento che desideri aggiungere alla politica. 1. Salvare le modifiche. ## Intervalli di tempo Un intervallo di tempo è una durata specifica durante la quale gli avvisi vengono soppressi. La durata è in genere costituita da un intervallo di tempo specifico e dai giorni della settimana, del mese o dell'anno. Le opzioni relative all'intervallo di tempo di Support sono: + **Intervallo** di tempo: l'orario comprensivo dell'ora di inizio e al netto dell'ora di fine (in UTC), se non è stata selezionata alcuna località, altrimenti l'ora locale. + **Posizione**: imposta la posizione per l'ora: l'intervallo di tempo viene visualizzato nell'ora locale della località. + **Giorni della settimana**: il giorno o l'intervallo di giorni della settimana. Ad esempio, `monday:thursday`. + **Giorni del mese**: le date entro un mese. I valori possono variare da `1` -`31`. I valori negativi specificano i giorni del mese in ordine inverso, quindi `-1` rappresentano l'ultimo giorno del mese. + **Mesi**: i mesi dell'anno in formato numerico o nel nome completo del mese di calendario. Ad esempio, `1, may:august`. + **Anni**: l'anno o gli anni dell'intervallo. Ad esempio, `2023:2024`. Ciascuno di questi elementi può essere un elenco e almeno un elemento nell'elemento deve essere soddisfatto per avere una corrispondenza. I campi supportano anche gli intervalli, utilizzando`:`. Ad esempio, `monday:thursday`. Se un campo viene lasciato vuoto, qualsiasi momento corrisponderà al campo. Affinché un istante o corrisponda a un intervallo di tempo completo, tutti i campi devono corrispondere. Una temporizzazione di silenziamento può contenere più intervalli di tempo. Se desideri specificare una durata esatta, specifica tutte le opzioni necessarie per tale durata. Ad esempio, se desideri creare un intervallo di tempo per il primo lunedì del mese, per marzo, giugno, settembre e dicembre, tra le 12:00 e le 24:00 UTC, la specifica dell'intervallo di tempo potrebbe essere: + Intervallo di tempo: + Ora di inizio: `12:00` + Ora di fine: `24:00` + Giorni della settimana: `monday` + Mesi: `3, 6, 9, 12` + Giorni del mese: `1:7` # Visualizza lo stato e lo stato delle regole di avviso **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Lo stato e lo stato di integrità delle regole di avviso forniscono diversi indicatori chiave di stato relativi agli avvisi. Esistono tre componenti: + [Stato della regola di avviso](#v10-alerting-manage-rulestate-state) + [Stato dell'istanza di avviso](#v10-alerting-manage-rulestate-instance) + [Stato della regola di avviso](#v10-alerting-manage-rulestate-health) Sebbene correlati, ogni componente trasmette informazioni leggermente diverse. **Per visualizzare lo stato e l'integrità delle regole di avviso** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. Scegli **Regole di avviso** per visualizzare l'elenco degli avvisi esistenti. 1. Scegli una regola di avviso per visualizzarne lo stato e lo stato di salute. ## Stato della regola di avviso Una regola di avviso può trovarsi in uno dei seguenti stati: | Stato | Description | | --- | --- | | Normale | Nessuna delle serie temporali restituite dal motore di valutazione è in firing stato pending or. | | Pending (In attesa) | Almeno una serie temporale restituita dal motore di valutazione èpending. | | Sparare | Almeno una serie temporale restituita dal motore di valutazione èfiring. | **Nota** Gli avvisi passano prima a `pending` e poi`firing`, quindi occorrono almeno due cicli di valutazione prima che venga attivato un avviso. ## Stato dell'istanza di avviso Un'istanza di avviso può trovarsi in uno dei seguenti stati: | Stato | Description | | --- | --- | | Normale | Lo stato di un avviso che non è né pending néfiring. Tutto funziona come previsto. | | Pending (In attesa) | Lo stato di un avviso che è stato attivo per un periodo inferiore alla durata della soglia configurata. | | Avviso | Lo stato di un avviso che è stato attivo per un periodo superiore alla durata della soglia configurata. | | Nessun dato | Non sono stati ricevuti dati per la finestra temporale configurata. | | Avviso | Si è verificato un errore durante il tentativo di valutare una regola di avviso. | ## Mantieni l'ultimo stato È possibile configurare una regola di avviso per mantenere l'ultimo stato quando viene rilevato `Error` uno stato `NoData` or. In questo modo si eviterà che gli avvisi vengano attivati e che si risolvano e si riattivino. Proprio come la normale valutazione, la regola di avviso passerà da una `pending` a una `firing` volta trascorso il periodo di attesa. ## Stato della regola di avviso Una regola di avviso può avere uno dei seguenti stati di integrità. | Stato | Description | | --- | --- | | Ok | Nessun errore nella valutazione della regola di avviso. | | Errore | Si è verificato un errore durante la valutazione della regola di avviso. | | NoData | L'assenza di dati in almeno una serie temporale restituita durante la valutazione di una regola. | | \$1stato\$1, KeepLast | La regola avrebbe ricevuto un altro stato, ma è stata configurata per mantenere l'ultimo stato della regola di avviso. | ## Avvisi speciali per un NoData errore Quando la valutazione di una regola di avviso produce lo stato `NoData` o`Error`, l'avviso Grafana genererà istanze di avviso con le seguenti etichette aggiuntive. | Etichetta | Description | | --- | --- | | nome dell'avviso | Uno DatasourceNoData o l'altroDatasourceError, a seconda dello stato. | | datasource\$1uid | L'UID della fonte di dati che ha causato lo stato. | **Nota** Per generare le etichette aggiuntive è necessario impostare la gestione di assenza di dati `NoData` o `Error` errori su o nella regola di avviso, come descritto nell'[Configura le regole di avviso gestite da Grafana](v10-alerting-configure-grafanamanaged.md)argomento. È possibile gestire questi avvisi allo stesso modo degli avvisi normali, ad esempio aggiungendo silenzi, indirizzando verso un punto di contatto e così via. # Visualizza e filtra per gruppi di avvisi **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) I gruppi di avvisi mostrano avvisi raggruppati provenienti da un'istanza di Alertmanager. Per impostazione predefinita, le regole di avviso sono raggruppate in base alle chiavi di etichetta per la politica predefinita nelle politiche di notifica. Il raggruppamento delle regole di avviso comuni in un unico gruppo di avvisi impedisce l'attivazione di regole di avviso duplicate. È possibile visualizzare i gruppi di avvisi e anche filtrare le regole di avviso che corrispondono a criteri specifici. **Per visualizzare i gruppi di avvisi** 1. **Dalla console Grafana, nel menu Grafana, scegli Avvisi.** 1. Scegli **Gruppi per visualizzare i gruppi** esistenti. 1. Dal menu a discesa **Alertmanager**, seleziona un Alertmanager esterno come fonte di dati. 1. Dal menu a discesa **Raggruppa per personalizzato**, seleziona una combinazione di etichette per visualizzare un raggruppamento diverso da quello predefinito. Ciò è utile per eseguire il debug e verificare il raggruppamento delle politiche di notifica. Se un avviso non contiene le etichette specificate nel raggruppamento della policy principale o nel raggruppamento personalizzato, l'avviso viene aggiunto a un gruppo catch all con un'intestazione di. `No grouping` È possibile filtrare gli avvisi per etichetta o stato degli avvisi. **Per filtrare per etichetta** + In **Cerca**, inserisci un'etichetta esistente per visualizzare gli avvisi corrispondenti all'etichetta. Ad esempio, `environment=production,region=~US|EU,severity!=warning`. **Per filtrare per stato** + In **Stati**, seleziona gli stati Attivo, Soppresso o Non elaborato per visualizzare gli avvisi corrispondenti allo stato selezionato. Tutti gli altri avvisi sono nascosti. # Visualizza gli errori di notifica **** **Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.** Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md) Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md) Visualizza gli errori di notifica e scopri perché non sono stati inviati o non sono stati ricevuti. **Nota** Questa funzionalità è supportata solo per Grafana Alertmanager. **Per visualizzare gli errori di notifica** 1. Dal menu a sinistra, scegli **Avvisi, quindi** **Punti di contatto**. Se qualche punto di contatto non funziona, un messaggio nell'angolo destro dell'area di lavoro indica che ci sono errori e quanti sono. 1. Seleziona un punto di contatto per visualizzare i dettagli degli errori relativi a quel punto di contatto. I dettagli dell'errore vengono visualizzati se si posiziona il puntatore del mouse sull'icona Errore. Se un punto di contatto ha più di un'integrazione, vengono visualizzati tutti gli errori per ciascuna delle integrazioni elencate. 1. Nella colonna Health, controlla lo stato della notifica. Può essere OK, Nessun tentativo o Errore.