Notifications d'alerte

Cette rubrique de documentation traite des anciennes alertes dans Grafana. Cela ne sera pas pris en charge dans les futures versions d'Amazon Managed Grafana. Vous pouvez migrer vers les alertes Grafana pour utiliser les dernières fonctionnalités d'alerte. Pour plus d'informations, consultez l'une des rubriques suivantes :

Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. Alertes dans la version 10 de Grafana

Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Alertes dans la version 9 de Grafana

Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Alerte Grafana

Lorsqu'une alerte change d'état, elle envoie des notifications. Chaque règle d'alerte peut comporter plusieurs notifications. Pour ajouter une notification à une règle d'alerte, vous devez d'abord ajouter et configurer un notification canal.

Cela se fait à partir de la page Canaux de notification.

Ajouter un canal de notification

1. Dans la barre latérale, faites une pause sur l'icône d'alerte (cloche), puis choisissez Canaux de notification.

2. Choisissez Add channel (Ajouter un canal).

3. Remplissez les champs ou sélectionnez les options décrites dans les sections suivantes.

Nouveaux champs de canal de notification

Par défaut (envoyer toutes les alertes)

• Nom — Entrez le nom de cette chaîne. Il sera affiché lorsque les utilisateurs ajouteront des notifications aux règles d'alerte.

• Type — Sélectionnez le type de canal. Pour plus d’informations, consultez Liste des notificateurs pris en charge.

• Par défaut (envoyer toutes les alertes) : lorsqu'elle est sélectionnée, cette option envoie une notification sur ce canal pour toutes les règles d'alerte.

• Désactiver le message de résolution : lorsqu'elle est sélectionnée, cette option désactive le message de résolution [OK] envoyé lorsque l'état d'alerte redevient faux.

• Envoyer des rappels — Lorsque cette option est sélectionnée, des notifications supplémentaires (rappels) seront envoyées pour les alertes. Vous pouvez spécifier la fréquence à laquelle les rappels doivent être envoyés en utilisant le nombre de secondes (s), de minutes (m) ou d'heures (h) ; par exemple 30s3m, 5m ou1h.

Important

Des rappels d'alerte sont envoyés après l'évaluation des règles. Par conséquent, un rappel ne peut pas être envoyé plus fréquemment qu'un intervalle d'évaluation des règles d'alerte configuré.

Les exemples suivants montrent à quelle fréquence et à quel moment des rappels sont envoyés pour une alerte déclenchée.

Intervalle d'évaluation des règles d'alerte	Envoyez des rappels tous les	Rappel envoyé chaque fois (après la dernière notification d'alerte)
30s	15s	~30 secondes
1m	5m	~5 minutes
5m	15m	~15 minutes
6m	20m	~24 minutes
1h	15m	~1 heure
1h	2h	~2 heures

Liste des notificateurs pris en charge

Nom	Type	Supporte les images	Supporte les balises de règles d'alerte
Amazon Simple Notification Service	sns	Non	Oui
OpsGenie	opsgenie	Non	Oui
PagerDuty	pagerduty	Non	Oui
Slack	slack	Non	Non
VictorOps	victorops	Non	Non

Amazon Simple Notification Service

Si vous avez activé les autorisations gérées par les services et inclus Amazon SNS comme canal de notification pour votre espace de travail, il vous suffit de fournir l'ARN de la rubrique SNS lorsque vous créez votre canal de notification. Dans le champ Nom, saisissez le nom de la rubrique SNS que vous avez créée. Si vous avez créé l'espace de travail à l'aide d'autorisations gérées par le service, le nom de la rubrique SNS doit être préfixé par un préfixe grafana pour que les notifications soient publiées correctement dans la rubrique. Si vous avez sélectionné des autorisations gérées par le client lors de la création de l'espace de travail, il n'est pas nécessaire de préfixer le nom de la rubrique SNS. grafana

Dans le champ Rubrique, copiez et collez l'ARN de la rubrique SNS. Dans le format du corps du message, vous pouvez choisir l'option JSON ou texte.

Dans le champ Paramètres AWS SNS facultatifs, cochez la case Inclure toutes les balises dans le message pour voir toutes les balises Grafana dans le corps du message.

Si vous utilisez des autorisations gérées par le client pour le lieu de travail, le rôle IAM que vous fournissez doit inclure les autorisations de publication SNS pour votre rubrique SNS.

Slack

Pour configurer Slack, vous devez configurer une URL de webhook Slack entrante. Pour plus d'informations, consultez la section Envoi de messages à l'aide de webhooks entrants.

Pour inclure des captures d'écran des alertes déclenchées dans les messages Slack, vous devez configurer soit la destination de l'image externe dans Grafana, soit une intégration de robots via Slack Apps. Pour plus d'informations sur la configuration d'une intégration de bot Slack, consultez le guide de Slack pour configurer une intégration de bot. Utilisez le jeton fourni, qui commence par « xoxb ».

Paramètre	Description
Url	URL du webhook entrant de Slack, ou éventuellement le point de terminaison de l'API Slack Chat.postMessage.
Nom d’utilisateur	Définissez le nom d'utilisateur pour le message du bot.
Destinataire	Utilisez-le pour remplacer le destinataire de Slack. Vous devez fournir un identifiant Slack de chaîne, un identifiant utilisateur Slack, une référence de nom d'utilisateur (@<user>, tout en minuscules, sans espace) ou une référence de chaîne (#, <channel>tout en minuscules, sans espace). Si vous utilisez le point de terminaison de l'API chat.postMessage Slack, cela est obligatoire.
Icône Emoji	Fournissez un emoji à utiliser comme icône pour le message du bot. Par exemple, :smile :
URL de l'icône	Fournissez l'URL d'une image à utiliser comme icône pour le message du bot.
Mentionner les utilisateurs	Mentionnez éventuellement un ou plusieurs utilisateurs dans la notification Slack envoyée par Grafana. Pour voir les utilisateurs, séparés par des virgules, via leur identifiant Slack correspondant, cliquez sur le bouton de dépassement sur le profil Slack de chaque utilisateur.
Mentionner des groupes	Mentionnez éventuellement un ou plusieurs groupes dans la notification Slack envoyée par Grafana. Vous pouvez voir les groupes, séparés par des virgules, via leurs identifiants Slack correspondants (que vous pouvez obtenir à partir de l'URL du profil Slack de chaque groupe).
Mentionner la chaîne	Mentionnez éventuellement tous les membres de la chaîne ou uniquement les membres actifs.
Jeton	Si elle est fournie, Amazon Managed Grafana téléchargera l'image générée via l'opération API Slack file.upload, et non via la destination externe de l'image. Si vous utilisez le point de terminaison de l'API chat.postMessage Slack, cela est obligatoire.

Si vous utilisez le jeton pour un robot Slack, vous devez inviter le bot à rejoindre le canal sur lequel vous souhaitez envoyer des notifications. Ajoutez ensuite la chaîne dans le champ du destinataire.

PagerDuty

Pour configurer PagerDuty, fournissez une clé d'intégration.

Paramètre	Description
Clé d'intégration	Clé d'intégration pour PagerDuty.
Sévérité	Niveau pour les notifications dynamiques ; la valeur par défaut est critical (1).
Résolution automatique des incidents	Résolvez les incidents une PagerDuty fois que l'alerte est revenue à OK.
Message détaillé	Supprime le message d'alerte du champ de résumé du PDF et le place dans les détails personnalisés (2).

Note

Les balisesSeverity,, Class Groupdedup_key, et Component ont une signification particulière dans le format d'événement PagerDuty commun — PD-CEF. Si un panneau d'alerte définit ces clés de balise, elles sont transposées à la racine de l'événement envoyé à PagerDuty. Cela signifie qu'ils seront disponibles dans l' PagerDuty interface utilisateur et les outils de filtrage. Un tag de gravité défini sur une alerte remplace le niveau de gravité global défini sur le canal de notification s'il s'agit d'un niveau valide.

Note

L'utilisation de Message In Details modifiera la structure du custom_details champ dans l' PagerDuty événement. Cela peut enfreindre les règles relatives aux événements personnalisés de vos PagerDuty règles si vous vous fiez aux champs depayload.custom_details. Déplacez toutes les règles existantes utilisées custom_details.myMetric pourcustom_details.queries.myMetric.

Note

L'utilisation d'une dedup_key balise remplacera le Grafana dedup_key généré avec une clé personnalisée.

Configuration du lien de retour vers Grafana à partir des notifications d'alerte

Toutes les notifications d'alerte contiennent un lien vers l'alerte déclenchée dans l'espace de travail Grafana.