Vue d’ensemble

Les notifications sont un composant clé des monitors qui tiennent votre équipe informée des problèmes et facilitent le dépannage. Lors de la création de votre monitor, configurez votre réponse pour :

• Rédiger un message exploitable.
• Déclencher un workflow ou créer un workflow à partir d’un monitor.
• Créer automatiquement un work item.
• Créer automatiquement un incident.

Construction de titres et de messages efficaces

Cette approche permet de garantir que les titres et les messages de vos monitors sont clairs, exploitables et adaptés aux besoins de votre public.

• Titres uniques : Ajoutez un titre unique à votre monitor (ceci est obligatoire). Pour les monitors à alertes multiples, certaines balises identifiant votre périmètre de déclenchement sont insérées automatiquement. Vous pouvez utiliser des variables de tag pour améliorer la précision.
• Champ de message : Le champ de message prend en charge le formatage Markdown standard et les variables. Utilisez des variables conditionnelles pour moduler le texte de notification envoyé à différents contacts avec @notifications. Utilisez des variables de modèle synthétique pour enrichir le message d’alerte avec le contexte d’échec des tests synthétiques.

{{#is_alert}} <-- conditional variable

Steps to free up disk space on {{host.name}}: <-- tag variable

1. Remove unused packages
2. Clear APT cache
3. Uninstall unnecessary applications
4. Remove duplicate files

@slack-incident-response <-- channel to send notification

{{/is_alert}}

Destinataires de la notification

Datadog recommande d’utiliser les règles de notification de monitor pour gérer les notifications de monitor. Avec les règles de notification, vous pouvez automatiser les destinataires de notification ajoutés à un monitor en fonction d’ensembles de conditions prédéfinis. Créez différentes règles pour acheminer les alertes de monitor en fonction des tags de la notification de monitor afin de ne pas avoir à configurer manuellement les destinataires ni la logique d’acheminement des notifications pour chaque monitor individuel.

Dans les règles de notification comme dans les monitors individuels, vous pouvez utiliser une @notification pour ajouter un membre d’équipe, une intégration, un workflow ou un work item à votre notification. Au fur et à mesure que vous tapez, Datadog recommande automatiquement les options existantes dans un menu déroulant. Cliquez sur une option pour l’ajouter à votre notification. Alternativement, cliquez sur @ Add Mention, Add Workflow ou Add Case.

Une @notification doit comporter un espace entre elle et le dernier caractère de la ligne :

Modification en masse des @-handles de monitor

Datadog prend en charge la modification des destinataires des messages d’alerte sur plusieurs monitors à la fois. Utilisez cette fonctionnalité pour ajouter, supprimer ou remplacer efficacement des @-handles dans le corps du message du monitor. Exemples de cas d’utilisation :

• Échanger un handle : Remplacez un handle par un autre sur plusieurs monitors. Par exemple, remplacez @pagerduty-sre par @oncall-sre. Vous pouvez également remplacer un handle par plusieurs handles, par exemple en remplaçant @pagerduty-sre par @pagerduty-sre et @oncall-sre, pour prendre en charge la pagination double ou une couverture d’alerte étendue.
• Ajouter un handle : Ajoutez un nouveau destinataire sans supprimer ceux existants. Par exemple, ajoutez @slack-infra-leads à tous les monitors sélectionnés.
• Supprimer un handle : Supprimez un handle spécifique des messages du monitor. Par exemple, supprimez @webhook-my-legacy-event-intake.

Workflows

Vous pouvez déclencher un workflow automation ou créer un nouveau workflow à partir d’un monitor.

Avant d’ajouter un workflow à un monitor, ajoutez un déclencheur de monitor au workflow.

Après avoir ajouté le déclencheur de monitor, ajoutez un workflow existant à votre monitor ou créez un nouveau workflow. Pour créer un nouveau workflow à partir de la page des monitors :

1. Cliquez sur Add Workflow.
2. Cliquez sur l’icône
   et sélectionnez un Blueprint, ou sélectionnez Start From Scratch.

Pour plus d’informations sur la création d’un workflow, consultez Build workflows.

Incidents

Les incidents peuvent être créés automatiquement à partir d’un monitor lorsque celui-ci passe à un statut alert, warn ou no data. Cliquez sur Add Incident et sélectionnez une option @incident-. Les administrateurs peuvent créer des options @incident- dans Incident Settings.

Lorsqu’un incident est créé à partir d’un monitor, les valeurs de champ de l’incident sont automatiquement renseignées en fonction des tags du monitor. Par exemple, si votre monitor possède un tag service:payments, le champ de service de l’incident sera défini sur « payments ». Pour recevoir des notifications pour ces incidents, assurez-vous que les tags du monitor correspondent à vos règles de notification d’incident. Remarque : Les règles de notification d’incident sont configurées séparément des règles de notification de monitor et doivent être définies indépendamment. Pour plus d’informations, consultez Notification d’incident.

Afficher le contenu supplémentaire

Les notifications de monitor incluent du contenu tel que la requête du monitor, les @-mentions utilisées, les snapshots de métriques (pour les monitors de métriques) et des liens vers les pages pertinentes dans Datadog. Vous avez la possibilité de choisir le contenu que vous souhaitez inclure ou exclure des notifications pour chaque monitor.

Les options disponibles sont :

• Default : Aucun contenu n’est masqué.
• Hide Query : Supprimer la requête du monitor du message de notification.
• Hide Handles : Supprimer les @-mentions utilisées dans le message de notification.
• Hide All : Le message de notification n’inclut pas la requête, les handles, les snapshots (pour les monitors de métriques) ou les liens supplémentaires dans les pieds de page.

Remarque : Selon l’intégration, certains contenus peuvent ne pas être affichés par défaut.

Renotifier

Activez le renvoi de notifications du monitor (facultatif) pour rappeler à votre équipe qu’un problème n’a pas été résolu.

Configurez l’intervalle de renotification, les états du monitor à partir desquels le monitor renotifie (parmi alert, no data et warn) et définissez éventuellement une limite au nombre de messages de renotification envoyés.

Par exemple, configurez le monitor sur stop renotifying after 1 occurrence pour recevoir un seul message d’escalade après l’alerte principale. Remarque Attribute and tag variables in the renotification are populated with the data available to the monitor during the time period of the renotification.

Si le renvoi de notifications est activé, vous pouvez définir un message de réaffectation. Celui-ci est envoyé lorsque le monitor conserve l’un des états indiqués pendant la période de votre choix.

Le message de réaffectation peut être ajouté de plusieurs façons :

• Dans le bloc {{#is_renotify}} dans le message de notification d’origine (recommandé).
• Dans le champ Renotification message de la section Configure notifications and automations.
• Avec l’attribut escalation_message dans l’API.

Si vous utilisez le bloc {{#is_renotify}}, le message de notification original est également inclus dans la renotification, donc :

1. Incluez uniquement les détails supplémentaires dans le bloc {{#is_renotify}} et ne répétez pas les détails du message original.
2. Envoyez le message d’escalade à un sous-ensemble de groupes.

Apprenez à configurer vos monitors pour ces cas d’utilisation dans la section des exemples.

Métadonnées

Ajoutez des métadonnées (Priorité, Tags, Datadog Team) à votre monitor. La priorité du monitor vous permet de définir l’importance de votre monitor via un niveau P (de P1 à P5). Les tags de monitor, qui sont différents des tags de métrique, sont utilisés dans l’interface utilisateur pour regrouper et rechercher des monitors. Si des politiques de tags sont configurées, les tags et valeurs de tag requis doivent être ajoutés. Pour en savoir plus, consultez Politiques de tags. Les Datadog Teams vous permettent de définir un niveau de responsabilité pour ce monitor et de voir tous les monitors liés à votre équipe. Pour en savoir plus, consultez Datadog Teams.

{{#is_alert}}
{{override_priority 'P1'}}
 ...
{{/is_alert}}
{{#is_warning}}
{{override_priority 'P4'}}
...
{{/is_warning}}

Agrégation

Si la requête du monitor est regroupée, vous pouvez supprimer une ou plusieurs dimensions du regroupement de notifications, ou toutes les supprimer et notifier sous forme d’alerte simple.

Trouvez plus d’informations sur cette fonctionnalité dans Configure Monitors.

Notifications de test

Après avoir défini votre monitor, testez les notifications avec le bouton Test Notifications en bas à droite de la page du monitor.

Les notifications de test sont prises en charge pour les monitor types suivants : host, métrique, anomalie, singularité, prévision, logs, rum, apm, intégration (vérification uniquement), process (vérification uniquement), réseau (vérification uniquement), check personnalisé, événement et composite.

1. Depuis la fenêtre contextuelle des notifications de test, choisissez la transition de monitor à tester et le groupe (disponible uniquement si la requête comporte un grouping). Vous ne pouvez tester que les états disponibles dans la configuration du monitor pour les seuils spécifiés dans les conditions d’alerte. Les Recovery thresholds constituent une exception, car Datadog envoie une notification de rétablissement une fois que le monitor n’est plus en alerte ou qu’il ne présente aucune warn condition.

2. Cliquez sur Run Test pour envoyer des notifications aux personnes et services listés dans le monitor.

Événements

Les notifications de test produisent des événements qui peuvent être recherchés dans Event Explorer. Ces notifications indiquent qui a lancé le test dans le corps du message avec [TEST] dans le titre de la notification.

Les tag variables ne sont renseignées que dans le texte des Datadog child events. L’événement parent affiche uniquement un résumé de l’agrégation.

Variables

Les variables de message se remplissent automatiquement à partir d’un groupe disponible, sélectionné au hasard, en fonction du périmètre de la définition de votre monitor. Exemple :

{{#is_alert}}
{{host.name}} <-- will populate
{{/is_alert}}

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Créer des monitorsDOCUMENTATION Gérer les monitorsDOCUMENTATION Suivez une formation pour apprendre à personnaliser les notifications de vos monitors d'alerte.CENTRE D'APPRENTISSAGE Dirigez vos alertes de monitor avec les règles de notification des monitors DatadogBLOG