Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configuration des alertes
<a name="v10-alerting-configure"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Configurez les fonctionnalités et les intégrations dont vous avez besoin pour créer et gérer vos alertes.

**Topics**
+ [Configurer les règles d'alerte gérées par Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Configuration des règles d'alerte gérées par les sources de données](v10-alerting-configure-datasourcemanaged.md)
+ [Configuration des règles d'enregistrement](v10-alerting-configure-recordingrules.md)
+ [Configuration des points de contact](v10-alerting-configure-contactpoints.md)
+ [Configuration des politiques de notification](v10-alerting-configure-notification-policies.md)

# Configurer les règles d'alerte gérées par Grafana
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Les règles gérées par Grafana constituent le type de règle d'alerte le plus flexible. Ils vous permettent de créer des alertes qui peuvent agir sur les données provenant de l'une de nos sources de données prises en charge. Outre la prise en charge de plusieurs sources de données, vous pouvez également ajouter des expressions pour transformer vos données et définir des conditions d'alerte. L'utilisation d'images dans les notifications d'alerte est également prise en charge. Il s'agit du seul type de règle qui permet d'émettre des alertes à partir de plusieurs sources de données dans une seule définition de règle.

Plusieurs instances d'alerte peuvent être créées à la suite d'une seule règle d'alerte (également appelée alerte multidimensionnelle).

Les règles d'alerte gérées par Grafana ne peuvent être modifiées ou supprimées que par les utilisateurs disposant d'autorisations de modification pour le dossier contenant les règles.

Si vous supprimez une ressource d'alerte créée dans l'interface utilisateur, vous ne pouvez plus la récupérer. Pour effectuer une sauvegarde de votre configuration et pouvoir restaurer les ressources d'alerte supprimées, créez vos ressources d'alerte à l'aide de Terraform ou de l'API d'alerte.

Dans les procédures suivantes, nous allons passer en revue le processus de création de vos règles d'alerte gérées par Grafana.

Pour créer une règle d'alerte gérée par Grafana, utilisez le flux de création d'alertes intégré à l'espace de travail et suivez ces étapes pour vous aider.

**Définir le nom de la règle d'alerte**

1. Choisissez **Alerte** -> **Règles d'alerte** -> **\$1 Nouvelle règle d'alerte**.

1. Entrez un nom pour identifier votre règle d'alerte.

   Ce nom est affiché dans la liste des règles d'alerte. Il s'agit également de l'`alertname`étiquette de chaque instance d'alerte créée à partir de cette règle.

Définissez ensuite une requête pour obtenir les données que vous souhaitez mesurer et une condition qui doit être remplie avant qu'une règle d'alerte ne soit déclenchée.

**Pour définir la requête et la condition**

1. Sélectionnez une source de données.

1. Dans le menu déroulant **Options**, spécifiez une [plage de temps](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**Note**  
Grafana Alerting ne prend en charge que des plages de temps relatives fixes, par exemple. `now-24hr: now`  
Il ne prend pas en charge les plages de temps absolues : `2021-12-02 00:00:00 to 2021-12-05 23:59:592` ou les plages de temps semi-relatives :`now/d to: now`.

1. Ajoutez une requête.

   Pour ajouter plusieurs [requêtes](v10-panels-query-xform.md#v10-panels-query-xform-add), choisissez **Ajouter une requête**.

   Toutes les règles d'alerte sont gérées par Grafana par défaut. Si vous souhaitez passer à une règle d'alerte gérée par source de données, cliquez sur **Basculer vers une règle d'alerte gérée par source de données.**

1. Ajoutez une ou plusieurs [expressions](v10-panels-query-xform-expressions.md).

   1. Pour chaque expression, sélectionnez soit la **condition classique** pour créer une règle d'alerte unique, soit les options **Mathématiques**, **Réduire** et **Rééchantillonner** pour générer une alerte distincte pour chaque série.
**Note**  
Lorsque vous utilisez Prometheus, vous pouvez utiliser un vecteur instantané et des fonctions intégrées, vous n'avez donc pas besoin d'ajouter d'expressions supplémentaires.

   1. Choisissez **Aperçu** pour vérifier que l'expression est réussie.

1. [Facultatif] Pour ajouter un seuil de récupération, activez l'option **Seuil de récupération personnalisé** et saisissez une valeur indiquant à quel moment votre règle d'alerte doit cesser de se déclencher.

   Vous ne pouvez ajouter qu'un seul seuil de récupération dans une requête et il doit s'agir de la condition d'alerte.

1. Choisissez **Définir comme condition d'alerte** sur la requête ou l'expression que vous souhaitez définir comme condition d'alerte.

Utilisez l'évaluation des règles d'alerte pour déterminer à quelle fréquence une règle d'alerte doit être évaluée et à quelle vitesse elle doit changer d'état.

Pour ce faire, vous devez vous assurer que votre règle d'alerte se trouve dans le bon groupe d'évaluation et définir une période d'attente adaptée à votre cas d'utilisation.

**Pour définir le comportement d'évaluation des alertes**

1. Sélectionnez un dossier ou choisissez **\$1 Nouveau dossier**.

1. Sélectionnez un groupe d'évaluation ou cliquez sur **\$1 Nouveau groupe d'évaluation**.

   Si vous créez un nouveau groupe d'évaluation, spécifiez l'intervalle pour le groupe.

   Toutes les règles d'un même groupe sont évaluées simultanément sur le même intervalle de temps.

1. Entrez une période d'attente.

   La période d'attente est la période pendant laquelle une règle d'alerte peut enfreindre la condition jusqu'à ce qu'elle se déclenche.

   Une fois qu'une condition est remplie, l'alerte passe à l'état **En attente**. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'état de **déclenchement**, sinon elle revient à l'état **normal**.

1. Activez les notifications d'alerte de pause, si nécessaire.
**Note**  
Suspendez l'évaluation des règles d'alerte pour éviter les alertes bruyantes lors du réglage de vos alertes. La pause arrête l'évaluation des règles d'alerte et ne crée aucune instance d'alerte. Cela est différent des délais de mise en sourdine, qui interrompent l'envoi des notifications, tout en permettant l'évaluation des règles d'alerte et la création d'instances d'alerte.  
Vous pouvez suspendre l'évaluation des règles d'alerte pour éviter les alertes bruyantes lors du réglage de vos alertes. La pause arrête l'évaluation des règles d'alerte et ne crée aucune instance d'alerte. Cela est différent des délais de mise en sourdine, qui interrompent l'envoi des notifications, tout en permettant l'évaluation des règles d'alerte et la création d'instances d'alerte.

1. Dans **Configurer l'absence de données et la gestion des erreurs**, configurez le comportement des alertes en l'absence de données.

   Utilisez les directives présentées plus loin dans cette section.

Ajoutez des libellés à vos règles d'alerte pour définir la politique de notification qui doit gérer vos instances d'alerte de déclenchement.

Toutes les règles et instances d'alerte, quel que soit leur libellé, correspondent à la politique de notification par défaut. S'il n'existe aucune politique imbriquée ou si aucune politique imbriquée ne correspond aux libellés de la règle d'alerte ou de l'instance d'alerte, la stratégie de notification par défaut est la stratégie correspondante.

**Pour configurer des notifications**

1. Ajoutez des libellés si vous souhaitez modifier le mode d'acheminement de vos notifications.

   Ajoutez des étiquettes personnalisées en sélectionnant des paires clé-valeur existantes dans le menu déroulant, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

1. Prévisualisez la configuration du routage de votre instance d'alerte.

   Sur la base des étiquettes ajoutées, les instances d'alerte sont acheminées vers les politiques de notification affichées.

   Développez chaque politique de notification pour afficher plus de détails.

1. Choisissez **Voir les détails** pour afficher les détails du routage des alertes et un aperçu.

Ajoutez [des annotations](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) pour fournir plus de contexte sur l'alerte dans votre message de notification d'alerte.

Les annotations ajoutent des métadonnées pour fournir plus d'informations sur l'alerte dans votre message de notification d'alerte. Par exemple, ajoutez une annotation **récapitulative** pour vous indiquer la valeur à l'origine du déclenchement de l'alerte ou le serveur sur lequel elle s'est produite.

**Pour ajouter des annotations**

1. [Facultatif] Ajoutez un résumé.

   Bref résumé de ce qui s'est passé et pourquoi.

1. [Facultatif] Ajoutez une description.

   Description de l'action de la règle d'alerte.

1. [Facultatif] Ajoutez une URL Runbook.

   Page Web où vous conservez votre runbook pour l'alerte

1. [Facultatif] Ajouter une annotation personnalisée

1. [Facultatif] Ajoutez un tableau de bord et un lien vers un panneau.

   Lie les alertes aux panneaux d'un tableau de bord.

1. Choisissez **Enregistrer la règle**.

**Règle unique et multidimensionnelle**

Pour les alertes gérées par Grafana, vous pouvez créer une règle avec une condition classique ou vous pouvez créer une règle multidimensionnelle.
+ **Règle avec condition classique**

  Utilisez l'expression de condition classique pour créer une règle qui déclenche une seule alerte lorsque sa condition est remplie. Pour une requête qui renvoie plusieurs séries, Grafana ne suit pas l'état d'alerte de chaque série. Grafana n'envoie donc qu'une seule alerte, même lorsque les conditions d'alerte sont remplies pour plusieurs séries.
+ **Règle multidimensionnelle**

  Pour générer une alerte distincte pour chaque série, créez une règle multidimensionnelle. Utilisez `Math``Reduce`, ou `Resample` expressions pour créer une règle multidimensionnelle. Par exemple :
  + Ajoutez une `Reduce` expression pour chaque requête afin d'agréger les valeurs de la plage de temps sélectionnée en une seule valeur (inutile pour les [règles utilisant des données numériques](v10-alerting-overview-numeric.md)).
  + Ajoutez une `Math` expression avec la condition de la règle. Inutile dans le cas où une requête ou une expression de réduction renvoie déjà `0` si la règle ne doit pas être déclenchée, ou un nombre positif si elle doit se déclencher. Quelques exemples : `$B > 70` s'il doit se déclencher si la valeur de B query/expression est supérieure à 70. `$B < $C * 100`au cas où il devrait se déclencher si la valeur de B est inférieure à la valeur de C multipliée par 100. Si les requêtes comparées contiennent plusieurs séries dans leurs résultats, les séries issues de différentes requêtes sont mises en correspondance si elles ont les mêmes étiquettes ou si l'une est un sous-ensemble de l'autre.

**Note**  
Grafana ne prend pas en charge les requêtes d'alerte avec des variables de modèle. De plus amples informations sont disponibles sur [https://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert

**Configuration de l'absence de données et de la gestion des erreurs**

Configurez le comportement des alertes lorsque l'évaluation de vos règles d'alerte ne renvoie aucune donnée ou une erreur.

**Note**  
Les règles d'alerte configurées pour se déclencher lorsqu'une évaluation ne renvoie aucune donnée ou qu'une erreur ne s'affichent que lorsque toute la durée de la période d'évaluation est terminée. Cela signifie qu'au lieu de se déclencher immédiatement lorsque la condition de la règle d'alerte est violée, la règle d'alerte attend que l'heure définie pour le champ **Pour** soit terminée, puis se déclenche, ce qui réduit le bruit des alertes et permet de résoudre des problèmes temporaires de disponibilité des données.

Si l'évaluation de votre règle d'alerte ne renvoie aucune donnée, vous pouvez définir l'état de votre règle d'alerte pour qu'il apparaisse comme suit :


| Aucune donnée | Description | 
| --- | --- | 
| Aucune donnée | Crée une nouvelle alerte DatasourceNoData avec le nom et l'UID de la règle d'alerte, ainsi que l'UID de la source de données qui n'a renvoyé aucune donnée sous forme d'étiquette. | 
| Alerte | Définit l'état de la règle d'alerte surAlerting. La règle d'alerte attend la fin de l'heure définie dans le champ Pour avant de tirer. | 
| Ok | Définit l'état de la règle d'alerte surNormal. | 

Si votre évaluation renvoie une erreur, vous pouvez définir l'état de votre règle d'alerte pour qu'il apparaisse comme suit :


| Erreur | Description | 
| --- | --- | 
| Erreur | Crée une instance d'alerte DatasourceError avec le nom et l'UID de la règle d'alerte, ainsi que l'UID de la source de données qui n'a renvoyé aucune donnée sous forme d'étiquette. | 
| Alerte | Définit l'état de la règle d'alerte surAlerting. La règle d'alerte attend la fin de l'heure définie dans le champ Pour avant de tirer. | 
| Ok | Définit l'état de la règle d'alerte surNormal. | 

**Résoudre les instances d'alerte obsolètes**

Une instance d'alerte est considérée comme obsolète si sa dimension ou sa série a complètement disparu des résultats de la requête pendant deux intervalles d'évaluation.

Les instances d'alerte périmées qui sont dans l'`Error`état `Alerting``NoData`//sont automatiquement marquées comme `Resolved` et l'`grafana_state_reason`annotation est ajoutée à l'instance d'alerte avec le motif`MissingSeries`.

**Créez des alertes à partir de panneaux**

Créez des alertes à partir de n'importe quel type de panneau. Cela signifie que vous pouvez réutiliser les requêtes du panneau et créer des alertes en fonction de celles-ci.

1. Accédez à un tableau de bord dans la section **Tableaux de bord**.

1. Dans le coin supérieur droit du panneau, choisissez les trois points (ellipses).

1. Dans le menu déroulant, sélectionnez **Plus...** puis choisissez **Nouvelle règle d'alerte**.

Cela ouvrira le formulaire des règles d'alerte, vous permettant de configurer et de créer votre alerte en fonction de la requête du panneau actuel.

# Configuration des règles d'alerte gérées par les sources de données
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Créez des règles d'alerte pour une instance externe de Grafana Mimir ou Loki sur laquelle l'API Ruler est activée ; ces règles sont appelées règles d'alerte gérées par source de données.

**Note**  
Les règles d'alerte pour une instance externe de Grafana Mimir ou Loki peuvent être modifiées ou supprimées par les utilisateurs ayant des rôles d'éditeur ou d'administrateur.  
Si vous supprimez une ressource d'alerte créée dans l'interface utilisateur, vous ne pouvez plus la récupérer. Pour effectuer une sauvegarde de votre configuration et pouvoir restaurer les ressources d'alerte supprimées, créez vos ressources d'alerte à l'aide de Terraform ou de l'API d'alerte.

**Conditions préalables**
+ Vérifiez que vous disposez d'une autorisation d'écriture sur la source de données Prometheus ou Loki. Sinon, vous ne pourrez pas créer ou mettre à jour les règles d'alerte gérées par Grafana Mimir.
+ Pour les sources de données Grafana Mimir et Loki, activez l'API Ruler en configurant leurs services respectifs.
  + **Loki** - Le type de stockage des `local` règles, par défaut pour la source de données Loki, prend uniquement en charge l'affichage des règles. Pour modifier les règles, configurez l'un des autres types de stockage de règles.
  + **Grafana Mimir** - utilise le préfixe. `/prometheus` [https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) Vous ne pouvez pas fournir d'URL distincte pour l'API Ruler.

**Note**  
Si vous ne souhaitez pas gérer les règles d'alerte pour une source de données Loki ou Prometheus en particulier, accédez à ses paramètres et décochez la case **Gérer les alertes via l'interface utilisateur** d'alerte.

Dans les procédures suivantes, nous vous guiderons tout au long du processus de création de vos règles d'alerte gérées par les sources de données.

Pour créer une règle d'alerte gérée par une source de données, utilisez le flux de création d'alertes intégré à l'espace de travail et suivez ces étapes pour vous aider.

**Pour définir le nom de la règle d'alerte**

1. Choisissez **Alerte** -> **Règles d'alerte** -> **\$1 Nouvelle règle d'alerte**.

1. Entrez un nom pour identifier votre règle d'alerte.

   Ce nom est affiché dans la liste des règles d'alerte. Il s'agit également de l'`alertname`étiquette de chaque instance d'alerte créée à partir de cette règle.

Définissez une requête pour obtenir les données que vous souhaitez mesurer et une condition qui doit être remplie avant qu'une règle d'alerte ne soit déclenchée.

**Pour définir la requête et la condition**

1. Toutes les règles d'alerte sont gérées par Grafana par défaut. Pour passer à une règle d'alerte gérée par source de données, choisissez **Basculer vers une règle d'alerte gérée par source de données**.

1. Sélectionnez une source de données dans la liste déroulante.

   Vous pouvez également choisir **Ouvrir le sélecteur de source de données avancé** pour voir d'autres options, notamment l'ajout d'une source de données (administrateurs uniquement).

1. Entrez une requête ProMQL ou LogQL.

1. Choisissez **Aperçu des alertes**.

Utilisez l'évaluation des règles d'alerte pour déterminer à quelle fréquence une règle d'alerte doit être évaluée et à quelle vitesse elle doit changer d'état.

**Pour définir le comportement d'évaluation des alertes**

1. Sélectionnez un espace de noms ou choisissez **\$1 Nouvel espace de noms**.

1. Sélectionnez un groupe d'évaluation ou choisissez **\$1 Nouveau groupe d'évaluation**.

   Si vous créez un nouveau groupe d'évaluation, spécifiez l'intervalle pour le groupe.

   Toutes les règles d'un même groupe sont évaluées séquentiellement sur le même intervalle de temps.

1. Entrez une période d'attente.

   La période d'attente est la période pendant laquelle une règle d'alerte peut enfreindre la condition jusqu'à ce qu'elle se déclenche.

   Une fois qu'une condition est remplie, l'alerte passe à l'`Pending`état. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'`Firing`état, sinon elle revient à l'`Normal`état.

Ajoutez des libellés à vos règles d'alerte pour définir la politique de notification qui doit gérer vos instances d'alerte de déclenchement.

Toutes les règles et instances d'alerte, quel que soit leur libellé, correspondent à la politique de notification par défaut. S'il n'existe aucune politique imbriquée ou si aucune politique imbriquée ne correspond aux libellés de la règle d'alerte ou de l'instance d'alerte, la stratégie de notification par défaut est la stratégie correspondante.

**Configuration des notifications**
+ Ajoutez des libellés si vous souhaitez modifier le mode d'acheminement de vos notifications.

  Ajoutez des étiquettes personnalisées en sélectionnant des paires clé-valeur existantes dans le menu déroulant, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

Ajoutez [des annotations](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) pour fournir plus de contexte sur l'alerte dans vos notifications d'alerte.

Les annotations ajoutent des métadonnées pour fournir plus d'informations sur l'alerte dans vos notifications d'alerte. Par exemple, ajoutez une `Summary` annotation pour vous indiquer quelle valeur a provoqué le déclenchement de l'alerte ou sur quel serveur elle s'est produite.

**Pour ajouter des annotations**

1. [Facultatif] Ajoutez un résumé.

   Bref résumé de ce qui s'est passé et pourquoi.

1. [Facultatif] Ajoutez une description.

   Description de l'action de la règle d'alerte.

1. [Facultatif] Ajoutez une URL Runbook.

   Page Web où vous conservez votre runbook pour l'alerte

1. [Facultatif] Ajouter une annotation personnalisée

1. [Facultatif] Ajoutez un tableau de bord et un lien vers un panneau.

   Lie les alertes aux panneaux d'un tableau de bord.

1. Choisissez **Enregistrer la règle**.

# Configuration des règles d'enregistrement
<a name="v10-alerting-configure-recordingrules"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous pouvez créer et gérer des règles d'enregistrement pour une instance externe de Grafana Mimir ou Loki. Les règles d'enregistrement calculent à l'avance les expressions fréquemment nécessaires ou les expressions coûteuses en termes de calcul et enregistrent le résultat sous la forme d'un nouvel ensemble de séries chronologiques. L'interrogation de cette nouvelle série chronologique est plus rapide, en particulier pour les tableaux de bord, car ils demandent la même expression à chaque actualisation des tableaux de bord.

**Note**  
Les règles d'enregistrement sont exécutées en tant que règles d'instance et exécutées toutes les 10 secondes.

**Conditions préalables**
+ Vérifiez que vous disposez des autorisations d'écriture sur la source de données Prometheus ou Loki. Vous allez créer ou mettre à jour des règles d'alerte dans votre source de données.
+ Pour les sources de données Grafana Mimir et Loki, activez l'API Ruler en configurant leurs services respectifs.
  + **Loki** — Le type de stockage des `local` règles, par défaut pour la source de données Loki, prend uniquement en charge l'affichage des règles. Pour modifier les règles, configurez l'un des autres types de stockage.
  + **Grafana Mimir** — Utilisez le préfixe. `/prometheus` La source de données Prometheus prend en charge Grafana Mimir et Prometheus, et Grafana s'attend à ce que l'API Query et l'API Ruler se trouvent sous la même URL. Vous ne pouvez pas fournir d'URL distincte pour l'API Ruler.

**Note**  
Si vous ne souhaitez pas gérer les règles d'alerte pour une source de données Loki ou Prometheus en particulier, accédez à ses paramètres et décochez la case **Gérer les alertes** via l'interface utilisateur d'alerte.

**Pour créer des règles d'enregistrement**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez **Alerting, Alert** rules.**

1. Choisissez **Nouvelle règle d'enregistrement**.

1. Définissez le nom de la règle.

   Le nom de la règle d'enregistrement doit être un nom de métrique Prometheus et ne contenir aucun espace.

1. Définir la requête
   + Sélectionnez votre source de données Loki ou Prometheus.
   + Saisissez une requête.

1. Ajoutez un espace de noms et un groupe.
   + Dans le menu déroulant **Namespace**, sélectionnez un espace de noms de règles existant ou ajoutez-en un nouveau. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel.
   + Dans le menu déroulant **Groupe**, sélectionnez un groupe existant dans l'espace de noms sélectionné ou ajoutez-en un nouveau. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe sont exécutées séquentiellement à intervalles réguliers, avec le même temps d'évaluation.

1. Ajoutez des étiquettes.
   + Ajoutez des étiquettes personnalisées en sélectionnant les paires clé-valeur existantes dans la liste déroulante, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

1. Choisissez **Enregistrer la règle** pour enregistrer la règle, ou **Enregistrer la règle et quitter** pour enregistrer la règle et revenir à la page d'alerte.

# Configuration des points de contact
<a name="v10-alerting-configure-contactpoints"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Utilisez les points de contact pour définir la manière dont vos contacts sont avertis lorsqu'une règle d'alerte est déclenchée.

**Note**  
Vous pouvez créer et modifier des points de contact pour les alertes gérées par Grafana. Les points de contact pour les alertes gérées par les sources de données sont en lecture seule.

## Travailler avec les points de contact
<a name="v10-alerting-configure-contactpoints-working"></a>

Les procédures suivantes indiquent comment ajouter, modifier, supprimer et tester un point de contact.

**Pour ajouter un point de contact**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact**.

1. Dans le menu déroulant **Choisir un gestionnaire d'alertes**, sélectionnez un gestionnaire d'alertes. Le Grafana Alertmanager est sélectionné par défaut.

1. Dans l'onglet **Points de contact**, choisissez **\$1 Ajouter un point de contact**.

1. Entrez un **nom** pour le point de contact.

1. Dans **Intégration**, choisissez un type et remplissez les champs obligatoires en fonction de ce type. Par exemple, si vous choisissez Slack, entrez les chaînes Slack et les utilisateurs à contacter.

1. Si disponible pour le point de contact que vous avez sélectionné, choisissez **les paramètres facultatifs** souhaités pour définir des paramètres supplémentaires.

1. Dans **Paramètres de notification**, sélectionnez éventuellement **Désactiver le message résolu** si vous ne souhaitez pas être averti lorsqu'une alerte est résolue.

1. Pour ajouter une autre intégration de point de contact, choisissez **Ajouter une intégration de point de contact** et répétez les étapes pour chaque type de point de contact requis.

1. Enregistrez vos modifications.

**Pour modifier un point de contact**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact** pour voir la liste des points de contact existants.

1. Sélectionnez le point de contact à modifier, puis choisissez **Modifier**.

1. Mettez à jour le point de contact, puis enregistrez vos modifications.

Vous pouvez supprimer les points de contact qui ne sont pas utilisés par une politique de notification.

**Pour supprimer un point de contact**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.

1. Dans les **points de contact**, sélectionnez le point de contact à supprimer, puis choisissez **Plus**, **Supprimer**.

1. Dans la boîte de dialogue de confirmation, choisissez **Oui, supprimer**.

**Note**  
Si le point de contact est utilisé par une politique de notification, vous devez supprimer la politique de notification ou la modifier pour utiliser un autre point de contact avant de supprimer le point de contact.

Une fois votre point de contact créé, vous pouvez envoyer une notification de test pour vérifier qu'il est correctement configuré.

**Pour envoyer une notification de test**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.

1. Sur les **points de contact**, sélectionnez le point de contact à tester, puis choisissez **Modifier**. Vous pouvez également créer un nouveau point de contact si nécessaire.

1. Choisissez **Test** pour ouvrir la boîte de dialogue de test du point de contact.

1. Choisissez d'envoyer une notification de test prédéfinie ou de choisir **Personnalisé** pour ajouter vos propres annotations et étiquettes personnalisées dans la notification de test.

1. Choisissez **Envoyer une notification** de test pour tester l'alerte auprès des points de contact indiqués.

## Configurer les intégrations de points de contact
<a name="v10-alerting-configure-contactpoints-integration"></a>

Configurez les intégrations de points de contact dans Grafana pour sélectionner votre canal de communication préféré pour recevoir des notifications lorsque vos règles d'alerte se déclenchent. Chaque intégration possède ses propres options de configuration et processus de configuration. Dans la plupart des cas, cela implique de fournir une clé d'API ou une URL de webhook.

Une fois configurée, vous pouvez utiliser les intégrations dans le cadre de vos points de contact pour recevoir des notifications chaque fois que l'état de votre alerte change. Dans cette section, nous aborderons les étapes de base pour configurer une intégration, en prenant PagerDuty comme exemple le fait que vous puissiez commencer à recevoir des alertes en temps réel et rester au courant de vos données de surveillance.

**Liste des intégrations prises en charge**

Le tableau suivant répertorie les types de points de contact pris en charge par Grafana.


| Nom | Type | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Devoir de téléavertisseur | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**Configuration PagerDuty des alertes**

Pour le configurer PagerDuty, vous devez fournir une clé d'intégration. Fournissez les informations suivantes.


| 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. | 
| Détails personnalisés | Informations supplémentaires sur l'événement | 

Le `CustomDetails` champ est un objet contenant des paires clé-valeur arbitraires. Les détails définis par l'utilisateur sont fusionnés avec ceux utilisés par défaut.

Les valeurs par défaut pour `CustomDetails` sont les suivantes :

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

En cas de double clé, les informations définies par l'utilisateur remplacent celles définies par défaut.

# Configuration des politiques de notification
<a name="v10-alerting-configure-notification-policies"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Les politiques de notification déterminent la manière dont les alertes sont acheminées vers les points de contact.

Les politiques ont une structure arborescente, dans laquelle chaque politique peut avoir une ou plusieurs politiques imbriquées. Chaque politique, à l'exception de la stratégie par défaut, peut également correspondre à des étiquettes d'alerte spécifiques.

Chaque alerte est évaluée par la stratégie par défaut, puis par chaque stratégie imbriquée.

Si vous activez l'`Continue matching subsequent sibling nodes`option pour une politique imbriquée, l'évaluation se poursuit même après une ou plusieurs correspondances. Les paramètres de configuration et les informations du point de contact d'une politique parent régissent le comportement d'une alerte qui ne correspond à aucune des politiques enfant. Une politique par défaut régit toute alerte qui ne correspond pas à une politique imbriquée.

Pour plus d'informations sur les politiques de notification, consultez[Notifications](v10-alerting-explore-notifications.md).

Les procédures suivantes vous montrent comment créer et gérer des politiques de notification.

**Pour modifier la politique de notification par défaut**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Choisir le gestionnaire d'alertes**, sélectionnez le gestionnaire d'alertes que vous souhaitez modifier.

1. Dans la section **Politique par défaut**, choisissez**...** , **Modifier**.

1. Dans **Point de contact par défaut**, mettez à jour le point de contact auquel les notifications doivent être envoyées pour les règles lorsque les règles d'alerte ne correspondent à aucune politique spécifique.

1. Dans **Regrouper par**, choisissez les libellés selon lesquels regrouper les alertes. Si plusieurs alertes correspondent à cette politique, elles sont regroupées selon ces étiquettes. Une notification est envoyée par groupe. Si le champ est vide (valeur par défaut), toutes les notifications sont envoyées dans un seul groupe. Utilisez une étiquette spéciale `...` pour regrouper les alertes en fonction de toutes les étiquettes (ce qui désactive efficacement le regroupement).

1. Dans **Options de chronométrage**, sélectionnez l'une des options suivantes.
   + **Patience de groupe** : temps d'attente nécessaire pour mettre en mémoire tampon les alertes d'un même groupe avant d'envoyer une notification initiale. Le durée par défaut est 30 secondes.
   + **Intervalle de groupe** : intervalle de temps minimum entre deux notifications pour un groupe. La valeur par défaut est de 5 minutes.
   + **Intervalle de répétition** : intervalle de temps minimal avant le renvoi d'une notification si aucune nouvelle alerte n'a été ajoutée au groupe. La valeur par défaut est de 4 heures.

1. Choisissez **Save** pour enregistrer les changements.

Pour créer une nouvelle politique de notification, vous devez suivre son arborescence. Les nouvelles politiques créées sur le tronc de l'arbre (la politique par défaut) sont les branches de l'arbre. Chaque branche peut avoir ses propres politiques imbriquées. C'est pourquoi vous ajouterez toujours une nouvelle politique **imbriquée**, soit dans le cadre de la stratégie par défaut, soit dans le cadre d'une politique déjà imbriquée.

**Pour ajouter une nouvelle politique imbriquée**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Choisir le gestionnaire d'alertes**, sélectionnez le gestionnaire d'alertes que vous souhaitez modifier.

1. Pour ajouter une politique spécifique de haut niveau, rendez-vous dans la section Routage spécifique (soit vers la politique par défaut, soit vers une autre politique existante dans laquelle vous souhaitez ajouter une nouvelle politique imbriquée) et choisissez **\$1** Nouvelle politique imbriquée.

1. Dans la section des étiquettes correspondantes, ajoutez une ou plusieurs règles pour faire correspondre les étiquettes d'alerte.

1. Dans la liste déroulante **Point de contact**, sélectionnez le point de contact auquel envoyer des notifications si une alerte correspond uniquement à cette politique spécifique et à aucune des politiques imbriquées.

1. Activez éventuellement l'option **Continuer à faire correspondre les nœuds frères suivants** pour continuer à faire correspondre les politiques sœurs même après que l'alerte corresponde à la politique actuelle. Lorsque cette option est activée, vous pouvez recevoir plusieurs notifications pour une alerte.

1. Activez éventuellement le **regroupement Override** pour spécifier le même regroupement que la politique par défaut. Si l'option n'est pas activée, le regroupement de politiques par défaut est utilisé.

1. Activez éventuellement l'option **Ignorer les horaires généraux** pour annuler les options de chronométrage configurées dans la politique de notification de groupe.

1. Choisissez **Enregistrer la politique** pour enregistrer les changements.

**Pour modifier une politique imbriquée**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Politiques de notification**.

1. Sélectionnez la politique que vous souhaitez modifier, puis choisissez**...** , **Modifier**.

1. Apportez des modifications (comme lors de l'ajout d'une politique imbriquée).

1. Enregistrez vos modifications.

**Recherche de politiques**

Vous pouvez effectuer une recherche dans l'arborescence des politiques par *Label Matchers* ou *points de contact*.
+ Pour effectuer une recherche par point de contact, entrez le nom partiel ou complet d'un point de contact dans le champ **Rechercher par point de contact**. Les politiques qui utilisent ce point de contact seront mises en évidence dans l'interface utilisateur.
+ Pour effectuer une recherche par étiquette, entrez une étiquette valide dans le champ **de saisie Recherche par étiquette**. Plusieurs correspondances peuvent être saisies, séparées par une virgule. Par exemple, une entrée de correspondance valide pourrait être. `severity=high, region=~EMEA|NA`
**Note**  
Lorsque vous effectuez une recherche par étiquette, toutes les politiques correspondantes correspondront exactement. Les correspondances partielles et les correspondances de style regex ne sont pas prises en charge.