Notifiche di avviso

In questo argomento della documentazione vengono descritti gli avvisi preesistenti in Grafana. Questa funzionalità non sarà supportata nelle versioni future di Amazon Managed Grafana. Puoi migrare agli avvisi Grafana per utilizzare le funzionalità di avviso più recenti. Per ulteriori informazioni, consulta uno dei seguenti argomenti.

Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. Avvisi nella versione 10 di Grafana

Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. Avvisi nella versione 9 di Grafana

Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Avvisi Grafana

Quando un avviso cambia stato, invia notifiche. Ogni regola di avviso può avere più notifiche. Per aggiungere una notifica a una regola di avviso, devi prima aggiungere e configurare un notification canale.

Questa operazione viene eseguita dalla pagina Canali di notifica.

Aggiungere un canale di notifica

1. Nella barra laterale, fai una pausa sull'icona Avvisi (campanello), quindi scegli Canali di notifica.

2. Scegli Add channel (Aggiungi canale).

3. Compila i campi o seleziona le opzioni descritte nelle sezioni seguenti.

Nuovi campi del canale di notifica

Impostazione predefinita (invio di tutti gli avvisi)

• Nome: inserisci un nome per questo canale. Verrà visualizzato quando gli utenti aggiungono notifiche alle regole di avviso.

• Tipo: seleziona il tipo di canale. Per ulteriori informazioni, consulta Elenco dei notificanti supportati.

• Predefinito (invia tutti gli avvisi): se selezionata, questa opzione invia una notifica su questo canale per tutte le regole di avviso.

• Disabilita messaggio di risoluzione: se selezionata, questa opzione disattiva il messaggio di risoluzione [OK] che viene inviato quando lo stato di avviso torna a false.

• Invia promemoria: quando questa opzione è selezionata, verranno inviate notifiche aggiuntive (promemoria) come avvisi. È possibile specificare la frequenza con cui inviare i promemoria utilizzando il numero di secondi (s), minuti (m) o ore (h); ad esempio,, 30s o. 3m 5m 1h

Importante

I promemoria di avviso vengono inviati dopo la valutazione delle regole. Pertanto, un promemoria non può essere inviato più frequentemente di un intervallo di valutazione delle regole di avviso configurato.

Gli esempi seguenti mostrano con quale frequenza e quando vengono inviati i promemoria per un avviso attivato.

Intervallo di valutazione delle regole di avviso	Invia promemoria ogni	Promemoria inviato ogni (dopo l'ultima notifica di avviso)
30s	15s	~30 secondi
1m	5m	~5 minuti
5m	15m	~15 minuti
6m	20m	~24 minuti
1h	15m	~1 ora
1h	2h	~2 ore

Elenco dei notificanti supportati

Nome	Type	Supporta immagini	Supporta i tag delle regole di avviso
Amazon Simple Notification Service	sns	No	Sì
OpsGenie	opsgenie	No	Sì
PagerDuty	pagerduty	No	Sì
Slack	slack	No	No
VictorOps	victorops	No	No

Amazon Simple Notification Service

Se hai abilitato le autorizzazioni gestite dal servizio e incluso Amazon SNS come canale di notifica per il tuo spazio di lavoro, devi fornire l'ARN dell'argomento SNS solo quando crei il canale di notifica. Nel campo Nome, fornisci il nome dell'argomento SNS che hai creato. Se hai creato l'area di lavoro utilizzando le autorizzazioni gestite dal servizio, il nome dell'argomento SNS deve essere preceduto dal prefisso grafana affinché le notifiche vengano pubblicate correttamente sull'argomento. Se hai selezionato le autorizzazioni gestite dal cliente quando hai creato l'area di lavoro, non è necessario che il nome dell'argomento SNS abbia il prefisso. grafana

Nel campo Argomento, copia e incolla l'ARN dell'argomento SNS. Nel formato del corpo del messaggio, puoi scegliere l'opzione JSON o l'opzione di testo.

Nel campo Impostazioni AWS SNS opzionali, seleziona la casella di controllo Includi tutti i tag nel messaggio per visualizzare tutti i tag Grafana nel corpo del messaggio.

Se utilizzi autorizzazioni gestite dal cliente per l'ambiente di lavoro, il ruolo IAM che fornisci dovrebbe includere le autorizzazioni di pubblicazione di SNS per il tuo argomento SNS.

Slack

Per configurare Slack, devi configurare un URL del webhook Slack in entrata. Per ulteriori informazioni, consulta Invio di messaggi tramite webhook in entrata.

Per includere schermate degli avvisi di attivazione nei messaggi Slack, devi configurare la destinazione dell'immagine esterna in Grafana o un'integrazione bot tramite Slack Apps. Per ulteriori informazioni sulla configurazione di un'integrazione con i bot Slack, consulta la guida di Segui Slack per configurare un'integrazione con i bot. Usa il token fornito, che inizia con «xoxb».

Impostazione	Descrizione
Url	L'URL del webhook in entrata di Slack o, infine, l'endpoint dell'API Slack chat.postMessage.
Username	Imposta il nome utente per il messaggio del bot.
Destinatario	Usalo per sovrascrivere il destinatario Slack. Devi fornire un ID Slack del canale, un ID utente Slack, un riferimento al nome utente (@, <user>tutto minuscolo, senza spazi bianchi) o un riferimento al canale (#, tutto minuscolo<channel>, senza spazi bianchi). Se utilizzi l'endpoint dell'API Slack, questo è chat.postMessage obbligatorio.
Icona emoji	Fornisci un'emoji da usare come icona per il messaggio del bot. Ad esempio, :smile:
URL dell'icona	Fornisci un URL a un'immagine da utilizzare come icona per il messaggio del bot.
Menziona gli utenti	Facoltativamente, menziona uno o più utenti nella notifica Slack inviata da Grafana. Per visualizzare gli utenti, separati da virgole, tramite gli ID Slack corrispondenti, scegli il pulsante overflow sul profilo Slack di ciascun utente.
Gruppi di menzione	Facoltativamente, menziona uno o più gruppi nella notifica Slack inviata da Grafana. Puoi vedere i gruppi, separati da virgole, tramite gli ID Slack corrispondenti (che puoi ottenere dall'URL del profilo Slack di ciascun gruppo).
Menziona il canale	Facoltativamente, menziona tutti i membri del canale o solo quelli attivi.
Token	Se fornita, Amazon Managed Grafana caricherà l'immagine generata tramite l'operazione dell'API Slack file.upload, non la destinazione esterna dell'immagine. Se utilizzi l'endpoint dell'API chat.postMessage Slack, questo è obbligatorio.

Se utilizzi il token per un bot slack, devi invitare il bot sul canale a cui desideri inviare le notifiche. Quindi aggiungi il canale al campo del destinatario.

PagerDuty

Per la configurazione PagerDuty, fornisci una chiave di integrazione.

Impostazione	Descrizione
Chiave di integrazione	Chiave di integrazione per PagerDuty.
Gravità	Livello per le notifiche dinamiche; l'impostazione predefinita è critical (1).
Risolvi automaticamente gli incidenti	Risolvi gli incidenti PagerDuty dopo che l'avviso torna a essere ok.
Messaggio in dettaglio	Rimuove il messaggio di avviso dal campo di riepilogo PD e lo inserisce invece in dettagli personalizzati (2).

Nota

I tagSeverity,, Class Groupdedup_key, e Component hanno un significato speciale nel PagerDutyCommon Event Format — PD-CEF. Se un pannello di avviso definisce queste chiavi di tag, queste vengono trasposte nella radice dell'evento a cui è stato inviato. PagerDuty Ciò significa che saranno disponibili nell' PagerDuty interfaccia utente e negli strumenti di filtro. Un tag di severità impostato su un avviso sostituisce il livello di gravità globale impostato nel canale di notifica se è un livello valido.

Nota

L'utilizzo di Message In Details cambierà la struttura del custom_details campo nell' PagerDuty evento. Ciò potrebbe violare le regole degli eventi personalizzate nelle tue PagerDuty regole se ti affidi ai campi dipayload.custom_details. Sposta tutte le regole esistenti che usi custom_details.myMetric incustom_details.queries.myMetric.

Nota

L'uso del dedup_key tag sovrascriverà la Grafana dedup_key generata con una chiave personalizzata.

Configurazione del collegamento di ritorno a Grafana dalle notifiche di avviso

Tutte le notifiche di avviso contengono un collegamento all'avviso attivato nell'area di lavoro Grafana.