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.
# Alerte Grafana
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Les alertes Grafana vous fournissent des alertes robustes et exploitables qui vous aident à détecter les problèmes dans les systèmes quelques instants après leur survenue, minimisant ainsi les perturbations de vos services.
Amazon Managed Grafana inclut l'accès à un système d'alerte mis à jour, *Grafana alerting*, qui centralise les informations d'alerte dans une vue unique consultable. Il inclut les fonctionnalités suivantes :
+ Créez et gérez les alertes Grafana dans une vue centralisée.
+ Créez et gérez les alertes gérées par Cortex et Loki via une interface unique. Pour de plus amples informations, veuillez consulter [Gérez vos règles d'alerte](v9-alerting-managerules.md).
+ Consultez les informations d'alerte provenant de Prometheus, d'Amazon Managed Service for Prometheus et d'autres sources de données compatibles avec Alertmanager.
+ Créez plusieurs instances d'alerte à partir d'une seule règle d'alerte. Pour de plus amples informations, veuillez consulter [Règles uniques et multidimensionnelles](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Gérez vos ressources d'alerte avec Terraform ou Provisioning. APIs Pour de plus amples informations, veuillez consulter [Approvisionnement des ressources d'alerte Grafana](v9-alerting-setup-provision.md).
Pour l'espace de travail Amazon Managed Grafana existant, la valeur par défaut est. [Alertes classiques sur le tableau](old-alerts-overview.md) Pour migrer vers les alertes Grafana, vous devez migrer [vers les alertes Grafana](alert-opt-in.md).
Pour en savoir plus sur les alertes Grafana, consultez. [Nouveautés en matière d'alertes Grafana](alerts-whats-new.md)
Les alertes Grafana comportent quatre éléments clés :
+ [Règle d'alerte](alert-rules.md) : critères d'évaluation qui déterminent si une alerte est déclenchée. Il comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et, éventuellement, la durée pendant laquelle la condition est remplie.
+ [Point de contact](alert-contact-points.md) : canal d'envoi de notifications lorsque les conditions d'une règle d'alerte sont remplies.
+ [Politique de notification](alert-notifications.md) - Ensemble de critères de correspondance et de regroupement utilisés pour déterminer la fréquence des notifications.
+ [Silences](alert-silences.md) : date et critères de correspondance utilisés pour désactiver les notifications.
Lorsque les alertes Grafana sont activées, vous pouvez :
+ [Créez des règles d'alerte gérées par Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Créez des règles d'alerte gérées par Cortex ou Loki](alert-rules.md#create-alert-rule)
+ [Afficher les règles d'alerte existantes et gérer leur état actuel](alert-rules.md#manage-alert-rules)
+ [Afficher l'état et l'état de santé des règles d'alerte](alert-fundamentals.md#alerts-state)
+ [Ajouter ou modifier un point de contact d'alerte](alert-contact-points.md#alert-working-contact-points)
+ [Ajouter ou modifier des politiques de notification](alert-notifications.md#alert-notifications-working)
+ [Ajouter ou modifier des silences](alert-silences.md)
## Limitations
+ Le système d'alerte Grafana peut récupérer les règles de toutes les sources de données Amazon Managed Service pour Prometheus, Prometheus, Loki et Alertmanager disponibles. Il se peut qu'il ne soit pas en mesure d'extraire les règles d'autres sources de données prises en charge.
+ Les règles d'alerte définies dans Grafana, plutôt que dans Prometheus, envoient plusieurs notifications à votre point de contact. Si vous utilisez les alertes Grafana natives, nous vous recommandons de rester sur les alertes classiques du tableau de bord et de ne pas activer la nouvelle fonctionnalité d'alerte Grafana. Si vous souhaitez consulter les alertes définies dans votre source de données Prometheus, nous vous recommandons d'activer Grafana Alerting, qui n'envoie qu'une seule notification pour les alertes créées dans Prometheus Alertmanager.
**Note**
Cette limitation n'est plus une limitation dans les espaces de travail Amazon Managed Grafana compatibles avec Grafana v10.4 et versions ultérieures.
**Topics**
+ [Limitations](#alert-limitations)
+ [Nouveautés en matière d'alertes Grafana](alerts-whats-new.md)
+ [Migration des alertes classiques du tableau de bord vers les alertes Grafana](alert-opt-in.md)
+ [Principes fondamentaux des alertes](alert-fundamentals.md)
+ [Création et gestion des règles d'alerte Grafana](alert-rules.md)
+ [Groupes d'alertes](alert-groups.md)
+ [Désactiver les notifications d'alerte pour les sources de données Prometheus](alert-silences.md)
+ [Travailler avec les points de contact](alert-contact-points.md)
+ [Utilisation de modèles de messagerie](alert-message-templates.md)
+ [Utilisation des politiques de notification](alert-notifications.md)
# Nouveautés en matière d'alertes Grafana
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Les alertes Grafana présentent plusieurs améliorations par rapport aux alertes classiques du tableau de bord.
## Créez des alertes multidimensionnelles
Vous pouvez désormais créer une règle d'alerte unique qui vous donne une visibilité à l'échelle du système, en générant plusieurs instances d'alerte à partir d'une seule règle d'alerte. Par exemple, vous pouvez créer une règle pour surveiller l'utilisation du disque de plusieurs points de montage sur un même hôte. Le moteur d'évaluation renvoie plusieurs séries chronologiques à partir d'une seule requête, chaque série chronologique étant identifiée par son jeu d'étiquettes.
**Note**
Chaque instance d'alerte est prise en compte dans le quota d'alertes. Les règles multidimensionnelles qui créent un nombre d'instances supérieur au quota d'alerte ne sont pas évaluées et renvoient une erreur de quota. Pour de plus amples informations, veuillez consulter [Erreurs liées au quota atteint](alert-rules.md#rule-quota-reached).
## Créez des alertes en dehors des tableaux de bord
Contrairement aux alertes classiques du tableau de bord, les alertes Grafana vous permettent de créer des requêtes et des expressions qui combinent des données provenant de plusieurs sources de manière unique. Vous pouvez toujours associer les tableaux de bord et les panneaux aux règles d'alerte à l'aide de leur identifiant et dépanner rapidement le système observé.
Comme les alertes unifiées ne sont plus directement liées aux requêtes du panel, elles n'incluent pas d'images ni de valeurs de requête dans l'e-mail de notification. Vous pouvez utiliser des modèles de notification personnalisés pour afficher les valeurs des requêtes.
## Création de règles d'alerte Loki et Cortex
Dans les alertes Grafana, vous pouvez gérer les règles d'alerte Loki et Cortex à l'aide de la même interface utilisateur et de la même API que vos alertes gérées par Grafana.
## Afficher et rechercher des alertes provenant d'Amazon Managed Service pour Prometheus et d'autres sources de données compatibles avec Prometheus
Les alertes pour Amazon Managed Service for Prometheus et les sources de données compatibles avec Prometheus sont désormais répertoriées dans l'interface d'alerte. Vous pouvez rechercher des étiquettes dans plusieurs sources de données pour trouver rapidement les alertes pertinentes.
## Alertes spéciales concernant l'état de l'alerte NoData et l'erreur
Les alertes Grafana génèrent des alertes spéciales portant les étiquettes suivantes, lorsque l'évaluation d'une règle d'alerte produit un état ou : `NoData` `Error`
+ `alertname`avec une valeur `DatasourceNoData` ou `DatasourceError` en fonction de l'état.
+ `rulename`avec le nom de la règle d'alerte à laquelle appartient l'alerte spéciale.
+ `datasource_uid`possède l'UID de la source de données à l'origine de l'état.
+ Toutes les étiquettes et annotations de la règle d'origine.
Vous pouvez gérer ces alertes de la même manière que les alertes ordinaires, par exemple en ajoutant un silence ou en les acheminant vers un point de contact.
**Note**
Si la règle utilise plusieurs sources de données et qu'une ou plusieurs ne renvoient aucune donnée, l'alerte spéciale est créée pour chaque source de données à l'origine de l'état d'alerte.
# Migration des alertes classiques du tableau de bord vers les alertes Grafana
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Les espaces de travail existants, ou les espaces de travail qui choisissent de ne pas utiliser les alertes Grafana, utilisent les alertes classiques du tableau de bord. Pour migrer vers la nouvelle alerte Grafana, vous devez activer cette fonctionnalité.
Vous pouvez configurer votre instance Amazon Managed Grafana pour utiliser les alertes Grafana à l'aide de l'API Amazon Managed Grafana AWS CLI ou de l' AWS Management Console API Amazon Managed Grafana. Pour plus d'informations sur la configuration d'Amazon Managed Grafana, notamment sur l'activation ou la désactivation des alertes Grafana, consultez. [Configuration d'un espace de travail Grafana géré par Amazon](AMG-configure-workspace.md)
**Note**
Lorsque vous utilisez les alertes Grafana, les règles d'alerte définies dans Grafana, plutôt que dans Prometheus, envoient plusieurs notifications à votre point de contact. Si vous utilisez les alertes Grafana natives, nous vous recommandons de rester sur les alertes classiques du tableau de bord et de ne pas activer la nouvelle fonctionnalité d'alerte Grafana. Si vous souhaitez consulter les alertes définies dans votre source de données Prometheus, nous vous recommandons d'activer Grafana Alerting, qui n'envoie qu'une seule notification pour les alertes créées dans Prometheus Alertmanager.
Cette limitation est supprimée dans les espaces de travail Amazon Managed Grafana compatibles avec Grafana v10.4 et versions ultérieures.
## Migration vers le système d'alerte Grafana
Lorsque les alertes Grafana sont activées, les alertes de tableau de bord classiques existantes migrent dans un format compatible avec les alertes Grafana. Sur la page d'alerte de votre instance Grafana, vous pouvez consulter les alertes migrées ainsi que les nouvelles alertes. Avec les alertes Grafana, vos règles d'alerte gérées par Grafana envoient plusieurs notifications plutôt qu'une seule alerte lorsqu'elles correspondent.
L'accès en lecture et en écriture aux alertes classiques du tableau de bord et aux alertes Grafana est régi par les autorisations des dossiers qui les stockent. Lors de la migration, les autorisations d'alerte classiques du tableau de bord sont associées aux nouvelles règles, comme suit :
+ Si le tableau de bord de l'alerte d'origine comporte des autorisations, la migration crée un dossier nommé dans ce format `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` afin de correspondre aux autorisations du tableau de bord d'origine (y compris les autorisations héritées du dossier).
+ S'il n'existe aucune autorisation de tableau de bord et que le tableau de bord se trouve sous un dossier, la règle est liée à ce dossier et hérite de ses autorisations.
+ S'il n'existe aucune autorisation de tableau de bord et que le tableau de bord se trouve dans le dossier Général, la règle est liée au dossier Alertes générales et la règle hérite des autorisations par défaut.
**Note**
Comme il n'existe aucune `Keep Last State` option d'alerte `NoData` dans Grafana, cette option est utilisée `NoData` lors de la migration classique des règles. L'option `Keep Last State` de `Error` gestion est migrée vers une nouvelle option`Error`. Pour correspondre au comportement du`Keep Last State`, dans les deux cas, pendant la migration, Amazon Managed Grafana crée automatiquement un silence d'une durée d'un an pour chaque règle d'alerte.
Les canaux de notification sont migrés vers une configuration Alertmanager avec les itinéraires et les récepteurs appropriés. Les canaux de notification par défaut sont ajoutés en tant que points de contact à l'itinéraire par défaut. Les canaux de notification qui ne sont associés à aucune alerte du tableau de bord sont affectés à l'`autogen-unlinked-channel-recv`itinéraire.
### Limitations
+ Le système d'alerte Grafana peut récupérer les règles de toutes les sources de données Prometheus, Loki et Alertmanager disponibles. Il se peut qu'il ne soit pas en mesure de récupérer les règles d'alerte à partir d'autres sources de données prises en charge.
+ La migration entre les alertes Grafana et les alertes classiques du tableau de bord peut entraîner une perte de données pour les fonctionnalités prises en charge dans un système, mais pas dans l'autre.
**Note**
Si vous revenez aux alertes classiques du tableau de bord, vous perdez toutes les modifications apportées à la configuration des alertes alors que les alertes Grafana étaient activées, y compris les nouvelles règles d'alerte créées.
# Principes fondamentaux des alertes
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Cette section fournit des informations sur les concepts fondamentaux des alertes Grafana.
## Concepts d'alerte
Le tableau suivant décrit les concepts clés des alertes Grafana.
| Concept ou fonctionnalité clé | Définition |
| --- | --- |
| Sources de données pour les alertes | Sélectionnez les sources de données à partir desquelles vous souhaitez interroger et visualiser les métriques, les journaux et les traces. |
| Planificateur | Évalue vos règles d'alerte ; il s'agit du composant qui exécute régulièrement des requêtes sur des sources de données. Elle ne s'applique qu'aux règles gérées par Grafana. |
| Gestionnaire d'alertes | Gère le routage et le regroupement des instances d'alerte. |
| Règle d'alerte | Ensemble de critères d'évaluation indiquant à quel moment une règle d'alerte doit être déclenchée. Une règle d'alerte comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et la durée pendant laquelle la condition est remplie. Une règle d'alerte peut produire plusieurs instances d'alerte. |
| Instance d'alerte | Une instance d'alerte est une instance d'une règle d'alerte. Une règle d'alerte unidimensionnelle possède une instance d'alerte. Une règle d'alerte multidimensionnelle comporte une ou plusieurs instances d'alerte. Une seule règle d'alerte qui correspond à plusieurs résultats, tels que le nombre de processeurs par rapport à 10 VMs, est comptée comme plusieurs instances d'alerte (dans ce cas, 10). Ce nombre peut varier au fil du temps. Par exemple, une règle d'alerte qui surveille l'utilisation du processeur pour tous les VMs membres d'un système comporte davantage d'instances d'alerte au fur et à mesure qu' VMs elles sont ajoutées. Pour plus d'informations sur les quotas d'instance d'alerte, consultez. [Erreurs liées au quota atteint](alert-rules.md#rule-quota-reached) |
| Groupe d'alertes | L'Alertmanager regroupe les instances d'alerte par défaut en utilisant les étiquettes de la politique de notification racine. Cela permet de contrôler la déduplication et les groupes d'instances d'alerte envoyés aux points de contact. |
| Point de contact | Définissez la manière dont vos contacts sont avertis lorsqu'une règle d'alerte est déclenchée. |
| Modélisation de messages | Créez des modèles personnalisés réutilisables et utilisez-les dans les points de contact. |
| Politique de notification | Ensemble de règles indiquant où, quand et comment les alertes sont regroupées et acheminées vers les points de contact. |
| Étiquettes et dispositifs d'appariement | Les étiquettes identifient de manière unique les règles d'alerte. Ils relient les règles d'alerte aux politiques de notification et aux silences, afin de déterminer quelle politique doit les gérer et quelles règles d'alerte doivent être réduites au silence. |
| Silences | Arrêtez les notifications provenant d'une ou de plusieurs instances d'alerte. La différence entre un temps de silence et un temps de sourdine réside dans le fait qu'un silence dure pendant une période spécifiée, pendant laquelle un temps de silence se produit selon un calendrier récurrent. Utilise des analyseurs d'étiquettes pour désactiver les instances d'alerte. |
| Horaire du mode muet | Spécifiez un intervalle de temps pendant lequel vous ne souhaitez pas que de nouvelles notifications soient générées ou envoyées. Vous pouvez geler les notifications d'alerte pendant des périodes récurrentes, par exemple pendant une période de maintenance. Doit être lié à une politique de notification existante. |
## Sources de données d'alerte
Les alertes gérées par Grafana interrogent les sources de données principales suivantes pour lesquelles les alertes sont activées.
+ Sources de données intégrées, ou développées et gérées par Grafana :`Alertmanager`,`Graphite`, `Prometheus` (y compris Amazon Managed Service for Prometheus),,,,,`Loki`,`InfluxDB`,`Amazon OpenSearch Service`,`Google Cloud Monitoring`,, `Amazon CloudWatch` `Azure Monitor``MySQL`, `PostgreSQL` et. `MSSQL` `OpenTSDB` `Oracle` `Azure Monitor`
## Alertes sur les données numériques
Les données numériques qui ne sont pas au format de série chronologique peuvent être directement alertées ou transmises aux expressions côté serveur. Cela permet d'améliorer le traitement et l'efficacité qui en résulte au sein de la source de données, tout en simplifiant les règles d'alerte. Lorsque vous lancez une alerte sur des données numériques plutôt que sur des données de séries chronologiques, il n'est pas nécessaire de réduire chaque série chronologique étiquetée en un seul chiffre. Au lieu de cela, les numéros étiquetés sont renvoyés à Grafana.
### Données tabulaires
Cette fonctionnalité est prise en charge par les sources de données principales qui interrogent des données tabulaires, notamment les sources de données SQL, telles que MySQL, Postgres, MSSQL et Oracle.
Une requête contenant des alertes gérées par Grafana ou des expressions côté serveur est considérée comme numérique avec les sources de données suivantes :
+ Si l'`Format AS`option est définie sur `Table` dans la requête de source de données.
+ Si la réponse de table renvoyée à Grafana par la requête ne comprend qu'une seule colonne numérique (par exemple, int, double ou float) et éventuellement des colonnes de chaîne supplémentaires.
S'il existe des colonnes de chaînes, ces colonnes deviennent des étiquettes. Le nom de la colonne devient le nom de l'étiquette, et la valeur de chaque ligne devient la valeur de l'étiquette correspondante. Si plusieurs lignes sont renvoyées, chaque ligne doit être identifiée de manière unique par son étiquette.
### Exemple
Si vous avez une table MySQL appelée Diskspace, comme suit.
| Heure | Host (Hôte) | Disk | PercentFree |
| --- | --- | --- | --- |
| 7 juin 2021 | web1 | /etc | 3 |
| 7 juin 2021 | web2 | /var | 4 |
| 7 juin 2021 | web3 | /var | 8 |
| … | … | … | … |
Vous pouvez interroger le filtrage des données à temps, mais sans renvoyer les séries chronologiques à Grafana. Par exemple, une alerte lancée par hôte ou disque lorsqu'il y a moins de 5 % d'espace libre peut ressembler à ce qui suit.
```
SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
SELECT
Host,
Disk,
Avg(PercentFree)
FROM DiskSpace
Group By
Host,
Disk
Where __timeFilter(Time)
```
Cette requête renvoie la réponse du tableau suivant à Grafana.
| Host (Hôte) | Disk | PercentFree |
| --- | --- | --- |
| web1 | /etc | 3 |
| web2 | /var | 4 |
| web3 | /var | 0 |
Lorsque cette requête est utilisée comme **condition** dans une règle d'alerte, les cas où la valeur est différente de zéro sont une alerte. Par conséquent, trois instances d'alerte sont produites, comme indiqué dans le tableau suivant.
| Étiquettes | Statut |
| --- | --- |
| \$1Host=Web1, disk=/etc\$1 | Alerte |
| \$1Host=Web2, disk=/var\$1 | Alerte |
| \$1Host=Web3, disk=/var\$1 | Normal |
## Gestionnaire d'alertes
Grafana inclut un support intégré pour Prometheus Alertmanager. L'Alertmanager permet à la fois de regrouper et de gérer les règles d'alerte, en ajoutant une couche d'orchestration au-dessus des moteurs d'alerte. Par défaut, les notifications relatives aux alertes gérées par Grafana sont gérées par le gestionnaire d'alertes intégré qui fait partie du noyau de Grafana. Vous pouvez configurer les points de contact, les politiques de notification et les modèles du gestionnaire d'alertes à partir de l'interface utilisateur d'alerte Grafana en sélectionnant l'option Grafana dans la liste déroulante du gestionnaire d'alertes.
Les alertes Grafana prennent en charge la configuration externe d'Alertmanager (pour plus d'informations sur Alertmanager en tant que source de données externe, voir). [Se connecter à une source de données Alertmanager](data-source-alertmanager.md) Lorsque vous ajoutez un Alertmanager externe, le menu déroulant Alertmanager affiche une liste des sources de données Alertmanager externes disponibles. Sélectionnez une source de données pour créer et gérer des alertes pour les sources de données Cortex ou Loki autonomes.
## État et état des règles d'alerte
L'état et l'état des règles d'alerte vous aident à comprendre plusieurs indicateurs clés relatifs à l'état de vos alertes. Il existe trois éléments clés : l'état de l'alerte, l'état de la règle d'alerte et l'état de la règle d'alerte. Bien que lié, chaque composant transmet des informations légèrement différentes.
**État de la règle d'alerte**
+ **Normal** — Aucune des séries chronologiques renvoyées par le moteur d'évaluation n'est à `Firing` l'état `Pending` or.
+ **En attente** — Au moins l'une des séries chronologiques renvoyées par le moteur d'évaluation est`Pending`.
+ Mise à **feu** — Au moins l'une des séries chronologiques renvoyées par le moteur d'évaluation est`Firing`.
**État de l'alerte**
+ **Normal** — La condition de la règle d'alerte est **fausse** pour chaque série chronologique renvoyée par le moteur d'évaluation.
+ **Alerte** : la condition de la règle d'alerte est **vraie** pour au moins une série chronologique renvoyée par le moteur d'évaluation. Durée pendant laquelle la condition doit être vraie avant qu'une alerte ne soit déclenchée, si elle est définie, si elle est remplie ou si elle est dépassée.
+ **En attente** : la condition de la règle d'alerte est **vraie** pour au moins une série chronologique renvoyée par le moteur d'évaluation. La durée pendant laquelle la condition doit être vraie avant qu'une alerte ne soit déclenchée, si elle est définie, n'est pas remplie.
+ **NoData**— La règle d'alerte n'a renvoyé aucune série chronologique, toutes les valeurs de la série chronologique sont nulles ou toutes les valeurs de la série chronologique sont nulles.
+ **Erreur** : erreur lors de la tentative d'évaluation d'une règle d'alerte.
**État des règles d'alerte**
+ **Ok** — Aucune erreur lors de l'évaluation d'une règle d'alerte.
+ **Erreur** : erreur lors de l'évaluation d'une règle d'alerte.
+ **NoData**— L'absence de données dans au moins une série chronologique renvoyée lors de l'évaluation d'une règle.
# Création et gestion des règles d'alerte Grafana
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Une règle d'alerte est un ensemble de critères d'évaluation qui déterminent si une alerte est déclenchée. La règle comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et éventuellement la durée pendant laquelle la condition est remplie.
Alors que les requêtes et les expressions sélectionnent l'ensemble de données à évaluer, une condition définit le seuil qu'une alerte doit atteindre ou dépasser pour créer une alerte. Un intervalle indique la fréquence à laquelle une règle d'alerte est évaluée. La durée, lorsqu'elle est configurée, indique la durée pendant laquelle une condition doit être remplie. Les règles peuvent également définir le comportement d'alerte en l'absence de données.
Les sections suivantes décrivent la création et la gestion de différents types de règles d'alerte Grafana.
**Topics**
+ [Création de règles d'alerte gérées par Cortex ou Loki](#create-alert-rule)
+ [Création de règles d'enregistrement gérées par Cortex ou Loki](#create-alert-recording-rule)
+ [Création de règles d'alerte gérées par Grafana](#create-grafana-alert-rule)
+ [Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels)
+ [Gestion des règles d'alerte](#manage-alert-rules)
+ [Groupes de règles et espaces de noms Cortex ou Loki](#alert-rule-groups)
## Création de règles d'alerte gérées par Cortex ou Loki
Grafana vous permet de créer des règles d'alerte pour une instance externe de Cortex ou Loki.
**Note**
Cortex est la base de données de séries chronologiques utilisée par Amazon Managed Service pour les sources de données Prometheus et Prometheus.
**Conditions préalables**
+ Vérifiez que vous disposez des autorisations d'écriture sur la source de données Prometheus. Dans le cas contraire, vous ne pourrez pas créer ou mettre à jour les règles d'alerte gérées par Cortex.
+ Pour les sources de données Cortex 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.
+ **Cortex** — N'utilisez pas `/prometheus` l'ancien `/api/prom` préfixe. La source de données Prometheus prend en charge Cortex 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 ajouter une règle d'alerte gérée par Cortex ou Loki**
1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte (cloche) pour ouvrir la page d'alerte répertoriant** les **alertes** existantes.
1. Choisissez **Nouvelle règle d'alerte**.
1. À **l'étape 1**, ajoutez le nom, le type et l'emplacement de stockage de la règle, comme suit :
+ Dans **Nom de la règle**, ajoutez un nom descriptif. 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.
+ Dans le menu déroulant **Type de règle**, sélectionnez Alerte gérée par **Cortex/Loki**.
+ **Dans le menu déroulant Sélectionner une source de données**, sélectionnez une source de données Prometheus ou Loki.
+ Dans le menu déroulant **Namespace**, sélectionnez un espace de noms de règles existant. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel. Pour de plus amples informations, veuillez consulter [Groupes de règles et espaces de noms Cortex ou Loki](#alert-rule-groups).
+ Dans le menu déroulant **Groupe**, sélectionnez un groupe existant dans l'espace de noms sélectionné. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe s'exécutent séquentiellement à intervalles réguliers, avec le même temps d'évaluation.
1. À **l'étape 2**, ajoutez la requête à évaluer.
La valeur peut être une expression ProMQL ou LogQL. La règle déclenche une alerte si le résultat de l'évaluation comporte au moins une série dont la valeur est supérieure à 0. Une alerte est créée pour chaque série.
1. À **l'étape 3**, ajoutez des conditions.
Dans la zone de texte Pour de la condition, spécifiez la durée pendant laquelle la condition doit être vraie avant que l'alerte ne soit déclenchée. Si vous le spécifiez`5m`, les conditions doivent être vraies pendant cinq minutes avant que l'alerte ne soit déclenchée.
**Note**
Une fois qu'une condition est remplie, l'alerte passe à `Pending` l'état. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'`Firing`état. S'il n'est plus atteint, il revient à l'`Normal`état.
1. À **l'étape 4**, ajoutez des métadonnées supplémentaires associées à la règle.
+ Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dans[Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels).
+ Ajoutez l'URL, le panneau, le tableau de bord et l'alerte IDs Runbook.
+ Ajoutez des étiquettes personnalisées.
1. Choisissez **Prévisualiser les alertes** pour évaluer la règle et voir quelles alertes elle produirait. Il affiche une liste d'alertes avec l'état et la valeur de chacune d'entre elles.
1. Choisissez **Enregistrer** pour enregistrer la règle ou **Enregistrer et quitter** pour enregistrer la règle et revenir à la page **d'alerte**.
## Création de règles d'enregistrement gérées par Cortex ou Loki
Vous pouvez créer et gérer des règles d'enregistrement pour une instance externe de Cortex ou de 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.
**Conditions préalables**
Pour les sources de données Cortex 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.
+ **Cortex** — Lorsque vous configurez une source de données Grafana Prometheus pour qu'elle pointe vers Cortex, utilisez l'ancien préfixe et non. `/api/prom` `/prometheus` La source de données Prometheus prend en charge Cortex 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 ajouter une règle d'enregistrement géré par Cortex ou Loki**
1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte (cloche) pour ouvrir la page d'alerte répertoriant** les **alertes** existantes.
1. Choisissez **Nouvelle règle d'alerte**.
1. À **l'étape 1**, ajoutez le nom, le type et l'emplacement de stockage de la règle, comme suit.
+ Dans **Nom de la règle**, ajoutez un nom descriptif. 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.
+ Dans le menu déroulant **Type de règle**, sélectionnez Alerte gérée par **Cortex/Loki**.
+ **Dans le menu déroulant Sélectionner une source de données**, sélectionnez une source de données Prometheus ou Loki.
+ Dans le menu déroulant **Namespace**, sélectionnez un espace de noms de règles existant. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel. Pour de plus amples informations, veuillez consulter [Groupes de règles et espaces de noms Cortex ou Loki](#alert-rule-groups).
+ Dans le menu déroulant **Groupe**, sélectionnez un groupe existant dans l'espace de noms sélectionné. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe s'exécutent séquentiellement à intervalles réguliers, avec le même temps d'évaluation.
1. À **l'étape 2**, ajoutez la requête à évaluer.
La valeur peut être une expression ProMQL ou LogQL. La règle déclenche une alerte si le résultat de l'évaluation comporte au moins une série dont la valeur est supérieure à 0. Une alerte est créée pour chaque série.
1. À **l'étape 3**, ajoutez des métadonnées supplémentaires associées à la règle.
+ Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dans[Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels).
+ Ajoutez l'URL, le panneau, le tableau de bord et l'alerte IDs Runbook.
+ Ajoutez des étiquettes personnalisées.
1. Choisissez **Enregistrer** pour enregistrer la règle ou **Enregistrer et quitter** pour enregistrer la règle et revenir à la page **d'alerte**.
## Création de règles d'alerte gérées par Grafana
Grafana vous permet de créer des règles d'alerte qui interrogent une ou plusieurs sources de données, réduisent ou transforment les résultats et les comparent entre eux ou fixent des seuils. Lorsque celles-ci sont traitées, Grafana envoie des notifications au point de contact.
**Note**
La création de règles d'alerte gérées par Grafana lors de l'utilisation des alertes Grafana entraîne l'envoi de plusieurs notifications lorsque la règle correspond. Certains fournisseurs de points de contact peuvent disposer d'options configurables pour dédupliquer les notifications.
**Pour ajouter une règle gérée par Grafana**
1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte (cloche) pour ouvrir la page d'alerte répertoriant** les **alertes** existantes.
1. Choisissez **Nouvelle règle d'alerte**.
1. À **l'étape 1**, ajoutez le nom, le type et l'emplacement de stockage de la règle, comme suit :
+ Dans **Nom de la règle**, ajoutez un nom descriptif. 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.
+ Dans la liste déroulante **Type de règle**, sélectionnez Alerte gérée par **Grafana**.
+ Dans le menu déroulant **Dossier**, sélectionnez le dossier dans lequel vous souhaitez stocker la règle. Si vous ne sélectionnez aucun dossier, la règle est enregistrée dans le `General` dossier. Pour créer un dossier, sélectionnez le menu déroulant et entrez un nouveau nom de dossier.
1. À **l'étape 2**, ajoutez les requêtes et les expressions à évaluer.
+ Conservez le nom par défaut ou passez la souris dessus et cliquez sur l'icône d'édition pour modifier le nom.
+ Pour les requêtes, sélectionnez une source de données dans le menu déroulant.
+ Ajoutez une ou plusieurs [requêtes](panel-queries.md) ou expressions (pour plus de détails sur les expressions, voir [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dans la *documentation de Grafana*).
+ 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** ou **Rééchantillonner** pour générer des alertes distinctes pour chaque série. Pour plus de détails sur ces options, consultez[Règles uniques et multidimensionnelles](#single-multi-rule).
+ Choisissez **Exécuter les requêtes** pour vérifier que la requête est réussie.
1. À **l'étape 3**, ajoutez des conditions.
+ Dans le menu déroulant **Condition**, sélectionnez la requête ou l'expression pour lancer la règle d'alerte.
+ Pour **Evaluer chaque**, spécifiez la fréquence d'évaluation. Ce doit être un multiple de 10 secondes. Par exemple, `1m`, `30s`.
+ Pour **Evaluer pour**, spécifiez la durée pendant laquelle la condition doit être vraie avant qu'une alerte ne soit déclenchée.
**Note**
Lorsqu'une condition est violée, l'alerte passe à `Pending` l'état. Si la condition reste violée pendant la durée spécifiée, l'alerte passe à l'`Firing`état. S'il n'est plus atteint, il revient à l'`Normal`état.
+ 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 instructions contenues dans. [Gestion de l'absence de données ou des cas d'erreur](#rule-no-data-error)
+ Choisissez **Prévisualiser les alertes** pour vérifier le résultat de l'exécution de la requête en ce moment. L'aperçu exclut l'absence de données et les conditions de gestion des erreurs.
1. À **l'étape 4**, ajoutez des métadonnées supplémentaires associées à la règle.
+ Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dans[Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels).
+ Ajoutez l'URL, le panneau, le tableau de bord et l'alerte IDs Runbook.
+ Ajoutez des étiquettes personnalisées.
1. Choisissez **Enregistrer** pour enregistrer la règle ou **Enregistrer et quitter** pour enregistrer la règle et revenir à la page **d'alerte**.
### Règles uniques et multidimensionnelles
Pour les règles d'alerte 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 unidimensionnelle (condition classique)**
Utilisez une 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.
Pour plus d'informations sur le formatage des expressions, voir [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dans la documentation de *Grafana*.
**Règle multidimensionnelle**
Pour générer une instance d'alerte distincte pour chaque série renvoyée dans la requête, créez une règle multidimensionnelle.
**Note**
Chaque instance d'alerte générée par une règle multidimensionnelle est prise en compte dans votre quota total d'alertes. Les règles ne sont pas évaluées lorsque vous atteignez votre quota d'alertes. Pour plus d'informations sur les quotas pour les règles multidimensionnelles, consultez[Erreurs liées au quota atteint](#rule-quota-reached).
Pour créer plusieurs instances à partir d'une seule règle `Math``Reduce`, utilisez ou `Resample` expressions pour créer une règle multidimensionnelle. Par exemple, vous pouvez effectuer les actions suivantes :
+ 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. (Non nécessaire pour les [règles utilisant des données numériques](alert-fundamentals.md#alert-numeric)).
+ Ajoutez une `Math` expression avec la condition de la règle. Cela n'est pas nécessaire si une requête ou une expression de réduction renvoie déjà 0 si la règle ne doit pas déclencher d'alerte, ou un nombre positif si elle doit lancer une alerte.
Voici quelques exemples :
+ `$B > 70`s'il doit lancer une alerte si la valeur de B query/expression est supérieure à 70.
+ `$B < $C * 100`au cas où il devrait déclencher une alerte 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. Plus d'informations sont disponibles sur la page de communauté Les [variables de modèle ne sont pas prises en charge dans les requêtes d'alerte lors de la configuration d'Alert](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).
**Considérations relatives aux performances pour les règles multidimensionnelles**
Chaque instance d'alerte est prise en compte dans le quota d'alertes. Les règles multidimensionnelles qui créent un nombre d'instances supérieur au quota d'alerte ne sont pas évaluées et renvoient une erreur de quota. Pour de plus amples informations, veuillez consulter [Erreurs liées au quota atteint](#rule-quota-reached).
Les alertes multidimensionnelles peuvent avoir un impact important sur les performances de votre espace de travail Grafana, ainsi que sur les performances de vos sources de données lorsque Grafana les interroge pour évaluer vos règles d'alerte. Les considérations suivantes peuvent être utiles lorsque vous essayez d'optimiser les performances de votre système de surveillance.
+ **Fréquence d'évaluation des règles** — La propriété **Evaluer chaque** règle d'alerte contrôle la fréquence d'évaluation des règles. Nous recommandons d'utiliser la fréquence d'évaluation la plus basse acceptable.
+ **Cardinalité de l'ensemble de résultats** : le nombre d'instances d'alerte que vous créez avec une règle influe sur ses performances. Supposons que vous surveillez les erreurs de réponse d'API pour chaque chemin d'API, sur chaque machine virtuelle de votre parc. Cet ensemble a pour cardinalité le nombre de chemins multiplié par le nombre de VMs. Vous pouvez réduire la cardinalité du jeu de résultats, par exemple en surveillant le nombre total d'erreurs par machine virtuelle plutôt que par chemin par machine virtuelle.
+ **Complexité de la requête** : les requêtes que les sources de données peuvent traiter et auxquelles elles peuvent répondre rapidement consomment moins de ressources. Bien que cette considération soit moins importante que les autres considérations répertoriées ci-dessus, si vous les réduisez autant que possible, l'examen des performances de chaque requête peut faire la différence. Vous devez également être conscient de l'impact de l'évaluation de ces règles sur les performances de vos sources de données. Les requêtes d'alerte constituent souvent la grande majorité des requêtes traitées par les bases de données de surveillance, de sorte que les mêmes facteurs de charge qui affectent l'instance de Grafana les affectent également.
### Erreurs liées au quota atteint
Il existe un quota pour le nombre d'instances d'alerte que vous pouvez avoir dans un même espace de travail. Lorsque vous atteignez ce nombre, vous ne pouvez plus créer de nouvelles règles d'alerte dans cet espace de travail. Avec les alertes multidimensionnelles, le nombre d'instances d'alerte peut varier dans le temps.
Il est important de garder à l'esprit les points suivants lorsque vous travaillez avec des instances d'alerte.
+ Si vous créez uniquement des règles unidimensionnelles, chaque règle est une instance d'alerte unique. Vous pouvez créer le même nombre de règles dans un même espace de travail que votre quota d'instance d'alerte, mais pas plus.
+ Les règles multidimensionnelles créent plusieurs instances d'alerte, mais leur nombre n'est pas connu tant qu'elles ne sont pas évaluées. Par exemple, si vous créez une règle d'alerte qui suit l'utilisation du processeur de vos instances Amazon EC2, il se peut qu'il y ait 50 instances EC2 lorsque vous la créez (et donc 50 instances d'alerte), mais si vous ajoutez 10 instances EC2 supplémentaires une semaine plus tard, l'évaluation suivante comportera 60 instances d'alerte.
Le nombre d'instances d'alerte est évalué lorsque vous créez une alerte multidimensionnelle, et vous ne pouvez pas en créer une qui vous fasse immédiatement dépasser votre quota d'instances d'alerte. Le nombre d'instances d'alerte pouvant changer, votre quota est vérifié chaque fois que vos règles sont évaluées.
+ Au moment de l'évaluation d'une règle, si une règle vous oblige à dépasser votre quota d'instances d'alerte, cette règle n'est pas évaluée tant qu'une mise à jour n'est pas apportée à la règle d'alerte qui ramène le nombre total d'instances d'alerte en dessous du quota de service. Dans ce cas, vous recevez une notification d'alerte vous informant que votre quota a été atteint (la notification utilise la politique de notification de la règle en cours d'évaluation). La notification inclut une `Error` annotation avec la valeur`QuotaReachedError`.
+ Règle qui entraîne l'évaluation d'un `QuotaReachedError` arrêt. L'évaluation ne reprend que lorsqu'une mise à jour est effectuée et l'évaluation après la mise à jour ne provoque pas elle-même de`QuotaReachedError`. Une règle qui n'est pas en cours d'évaluation indique l'erreur **Quota atteint** dans la console Grafana.
+ Vous pouvez réduire le nombre d'instances d'alerte en supprimant les règles d'alerte ou en modifiant les alertes multidimensionnelles afin de réduire le nombre d'instances d'alerte (par exemple, en ayant une alerte sur les erreurs par machine virtuelle, plutôt qu'une alerte sur les erreurs par API dans une machine virtuelle).
+ Pour reprendre les évaluations, mettez à jour l'alerte et enregistrez-la. Vous pouvez le mettre à jour pour réduire le nombre d'instances d'alerte, ou si vous avez apporté d'autres modifications pour réduire le nombre d'instances d'alerte, vous pouvez l'enregistrer sans le modifier. Si elle peut être reprise, elle l'est. Si cela en cause un autre`QuotaReachedError`, vous ne pouvez pas l'enregistrer.
+ Lorsqu'une alerte est enregistrée et reprend son évaluation sans dépasser le quota d'alertes, l'erreur **Quota atteint** peut continuer à s'afficher dans la console Grafana pendant un certain temps (jusqu'à son intervalle d'évaluation). Cependant, l'évaluation des règles d'alerte démarre et des alertes sont envoyées si le seuil de la règle est atteint.
+ Pour plus de détails sur le quota d'alertes, ainsi que sur les autres quotas, consultez[Quotas de service Amazon Managed Grafana](AMG_quotas.md).
### Gestion de l'absence de données ou des cas d'erreur
Choisissez des options pour gérer le comportement des alertes en l'absence de données ou en cas d'erreur.
Les options permettant de ne traiter aucune donnée sont répertoriées dans le tableau suivant.
| Option « Aucune donnée » | Comportement |
| --- | --- |
| Aucune donnée | Créez une 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éfinissez l'état de la règle d'alerte sur`Alerting`. |
| OK | Définissez l'état de la règle d'alerte sur`Normal`. |
Les options de gestion des cas d'erreur sont répertoriées dans le tableau suivant.
| Option d'erreur ou de délai d'expiration | Comportement |
| --- | --- |
| Alerte | Définissez l'état de la règle d'alerte sur `Alerting` |
| OK | Définissez l'état de la règle d'alerte sur `Normal` |
| Erreur | Créez une 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. |
## Annotations et étiquettes pour les règles d'alerte
Les annotations et les étiquettes sont des paires clé-valeur associées aux alertes provenant de la règle d'alerte, de la réponse de la source de données et de l'évaluation de la règle d'alerte. Ils peuvent être utilisés directement dans les notifications d'alerte ou dans les [modèles](alert-message-templates.md) et les [fonctions des modèles](alert-message-templates.md#alert-template-functions) pour créer un contact de notification de manière dynamique.
**Annotations**
Les annotations sont des paires clé-valeur qui fournissent des informations supplémentaires sur une alerte. Vous pouvez utiliser les annotations suivantes :`description`,`summary`,`runbook_url`, `alertId``dashboardUid`, et`panelId`. Ils sont affichés dans les détails des règles et des alertes dans l'interface utilisateur et peuvent être utilisés dans les modèles de messages des points de contact.
**Etiquettes**
Les étiquettes sont des paires clé-valeur qui contiennent des informations sur une alerte. L'étiquette définie pour une alerte est générée et complétée tout au long du processus d'évaluation et de notification des alertes. Ils sont utilisés de la manière suivante.
+ L'ensemble complet d'étiquettes d'une alerte identifie de manière unique cette alerte dans Grafana Alerts.
+ [Le gestionnaire d'alertes utilise des étiquettes pour faire correspondre les alertes relatives aux [silences](alert-silences.md) et aux [groupes d'alertes](alert-groups.md) dans les politiques de notification.](alert-notifications.md)
+ L'interface utilisateur d'alerte affiche des étiquettes pour chaque instance d'alerte générée par l'évaluation de cette règle.
+ Les points de contact peuvent accéder aux étiquettes pour générer dynamiquement des notifications contenant des informations spécifiques à l'alerte qui entraîne une notification.
+ Des étiquettes peuvent être ajoutées à une [règle d'alerte](#alert-rules). Ces étiquettes configurées manuellement peuvent utiliser des fonctions de modèle et faire référence à d'autres étiquettes. Les étiquettes ajoutées à une règle d'alerte ici sont prioritaires en cas de collision entre étiquettes.
Les variables de modèle suivantes sont disponibles lorsque vous développez des annotations et des étiquettes.
| Nom | Description |
| --- | --- |
| `$labels` | Les libellés de la requête ou de la condition. Par exemple : `{{ $labels.instance }}` et `{{ $labels.job }}`. Cette option n'est pas disponible lorsque la règle utilise une condition classique. |
| `$values` | Les valeurs de toutes les expressions mathématiques et de réduction évaluées pour cette règle d'alerte. Par exemple`{{ $values.A }}`, `{{ $values.A.Labels }}` et `{{ $values.A.Value }}` où `A` est le `refID` de l'expression. Ceci n'est pas disponible lorsque la règle utilise une condition classique |
| `$value` | Chaîne de valeur de l'instance d'alerte. Par exemple, `[ var='A' labels={instance=foo} value=10 ]`. |
## Gestion des règles d'alerte
La page **Alertes** répertorie les règles d'alerte. Par défaut, les règles sont regroupées par type de source de données. La section **Grafana** répertorie les règles gérées par Grafana, et la section **Cortex/Loki** répertorie les règles relatives aux sources de données compatibles avec Prometheus. Vous pouvez consulter les règles d'alerte pour les sources de données compatibles avec Prometheus, mais vous ne pouvez pas les modifier.
### Afficher les règles d'alerte
Grâce aux alertes Grafana, vous pouvez consulter toutes vos alertes sur une seule page.
**Pour afficher les détails des alertes**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.** Par défaut, les règles sont affichées par groupes par type de source de données. Vous pouvez également consulter l'état actuel de chaque alerte (ces informations sont décrites plus en détail dans le texte suivant).
1. Dans **Afficher sous**, vous pouvez basculer entre les vues de groupe et d'état en choisissant l'option que vous préférez.
1. Cliquez sur la flèche à côté d'une ligne pour afficher plus de détails sur cette ligne. Les détails d'une règle incluent les étiquettes des règles, les annotations, les sources de données et les requêtes, ainsi qu'une liste des instances d'alerte résultant de la règle.
**Vue de groupe**
La vue de groupe montre les règles d'alerte Grafana regroupées par dossier et les règles d'alerte Loki ou Prometheus groupées par \$1. `namespace` `group` Il s'agit de la vue de liste de règles par défaut, destinée à la gestion des règles. Vous pouvez développer chaque groupe pour afficher la liste des règles de ce groupe. Développez davantage une règle pour en afficher les détails. Vous pouvez également développer les boutons d'action et les alertes résultant de la règle pour en afficher les détails.
**Vue de l'État**
La vue État affiche les règles d'alerte regroupées par état. Utilisez cette vue pour avoir une vue d'ensemble des règles dans quel état. Chaque règle peut être étendue pour afficher ses détails. Boutons d'action et toutes les alertes générées par cette règle, et chaque alerte peut être étendue pour afficher ses détails.
**Règles d'alerte de filtrage**
Vous pouvez filtrer les règles d'alerte qui apparaissent sur la page **Alertes de** plusieurs manières.
+ Vous pouvez filtrer pour afficher les règles qui interrogent une source de données spécifique en choisissant **Sélectionner les sources de données**, puis en sélectionnant une source de données sur laquelle filtrer.
+ Vous pouvez filtrer par étiquette en choisissant des critères de recherche dans **Rechercher par étiquette**. Certains exemples de critères incluent`environment=production`,`region=~US|EU`,`severity!=warning`.
+ Vous pouvez filtrer pour afficher les règles dans un état spécifique en choisissant **Filtrer les alertes par état**, puis en sélectionnant l'état que vous souhaitez afficher.
### Modifier ou supprimer des règles d'alerte
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. Les règles d'alerte pour une instance externe de Cortex ou Loki peuvent être modifiées ou supprimées par les utilisateurs ayant des rôles d'éditeur ou d'administrateur.
**Pour modifier ou supprimer une règle**
1. Développez une règle jusqu'à ce que vous puissiez voir les commandes de règle pour **Afficher**, **Modifier** et **Supprimer**.
1. Choisissez **Modifier** pour ouvrir la page de création de règles. Effectuez les mises à jour de la même manière que vous créez une règle. Pour plus de détails, consultez les instructions figurant dans [Création de règles d'alerte gérées par Grafana](#create-grafana-alert-rule) ou[Création de règles d'alerte gérées par Cortex ou Loki](#create-alert-rule).
1. Choisissez éventuellement **Supprimer** pour supprimer une règle.
## Groupes de règles et espaces de noms Cortex ou Loki
Vous pouvez organiser vos règles. Les règles sont créées au sein de groupes de règles, et les groupes de règles sont organisés en espaces de noms. Les règles d'un groupe de règles sont exécutées séquentiellement à intervalles réguliers. L'intervalle par défaut est d'une minute. Vous pouvez renommer les espaces de noms et les groupes de règles Cortex ou Loki, et modifier les intervalles d'évaluation des groupes de règles.
**Pour modifier un groupe de règles ou un espace de noms**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Accédez à une règle au sein du groupe de règles ou de l'espace de noms que vous souhaitez modifier.
1. Choisissez l'icône **Modifier** (stylo).
1. Apportez des modifications au groupe de règles ou à l'espace de noms.
**Note**
Pour les espaces de noms, vous ne pouvez modifier que le nom. Pour les groupes de règles, vous modifiez le nom ou l'intervalle d'évaluation des règles du groupe. Par exemple, vous pouvez `1m` choisir d'évaluer les règles une fois par minute ou `30s` toutes les 30 secondes.
1. Sélectionnez **Enregistrer les modifications**.
# Groupes d'alertes
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Les groupes d'alertes affichent les alertes groupées provenant d'une instance d'Alertmanager. Par défaut, les alertes sont regroupées selon les clés d'étiquette de la politique racine dans[Utilisation des politiques de notification](alert-notifications.md). Le regroupement des alertes communes dans un seul groupe d'alertes empêche le lancement d'alertes dupliquées.
**Pour afficher les groupes d'alertes**
1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche), puis l'élément de **regroupement d'alertes** pour ouvrir la page répertoriant les groupes existants.
1. Dans le menu déroulant **Alertmanager**, sélectionnez un Alertmanager externe comme source de données. Par défaut, le `Grafana` gestionnaire d'alertes est sélectionné.
1. Dans le menu déroulant **personnalisé**, sélectionnez une combinaison d'étiquettes pour afficher un regroupement autre que celui par défaut. Vous pouvez utiliser cette vue pour déboguer ou vérifier votre regroupement de politiques de notification.
Les alertes sans étiquette spécifiée dans le regroupement de la politique racine ou dans le regroupement personnalisé sont ajoutées à un groupe avec un en-tête de`No grouping`.
**Filtrer les alertes**
Vous pouvez utiliser les filtres suivants pour afficher les alertes correspondant à des critères spécifiques :
+ **Recherche par étiquette** : dans **Rechercher**, entrez une étiquette existante pour afficher les alertes correspondant à cette étiquette. Par exemple, `environment=production`, `region=~US|EU`, `severity!=warning`.
+ **Filtrer les alertes par état** : dans **États**, sélectionnez parmi `Active``Suppressed`, ou `Unprocessed` états pour afficher les alertes correspondant à cet état.
# Désactiver les notifications d'alerte pour les sources de données Prometheus
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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 sources de données Alertmanager externes (y compris Amazon Managed Service for Prometheus), vous pouvez supprimer les notifications d'alerte en les taisant.* Un silence empêche uniquement la création de notifications : les silences n'empêchent pas l'évaluation des règles d'alerte et n'empêchent pas l'affichage des instances d'alerte dans l'interface utilisateur. Lorsque vous désactivez une alerte, vous spécifiez une période pendant laquelle elle doit être supprimée.
Vous pouvez configurer des silences pour une source de données externe d'Alertmanager.
**Note**
Pour supprimer les notifications d'alerte à intervalles réguliers (par exemple, pendant les périodes de maintenance régulières), utilisez-les [Horaire du mode muet](alert-notifications.md#alert-notification-muting) plutôt que des silences.
**Pour ajouter un silence**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Choisissez **Silences** pour ouvrir une page répertoriant les [points de contact](alert-contact-points.md) existants.
1. Choisissez le gestionnaire d'alertes externe dans la liste déroulante du gestionnaire d'**alertes**.
1. Sélectionnez **Nouveau silence**.
1. Sélectionnez les dates de début et de fin dans **Début et fin du silence** pour indiquer quand le silence doit entrer en vigueur et quand il doit prendre fin.
Au lieu de définir une heure de fin, dans **Durée**, spécifiez la durée pendant laquelle le silence est appliqué. Cela met automatiquement à jour l'heure de fin dans les champs de **début et de fin du silence**.
1. Dans les champs **Nom** et **Valeur**, entrez une ou plusieurs *étiquettes correspondantes*. Les matchers déterminent les règles auxquelles le silence s'applique. La correspondance des étiquettes est abordée plus en détail à la suite de cette procédure.
1. Ajoutez éventuellement un **commentaire** ou modifiez le **créateur** pour définir le propriétaire du silence.
**Correspondance des étiquettes pour la suppression des alertes**
Lorsque vous créez un silence, vous créez un ensemble d'*étiquettes correspondantes* dans le cadre du silence. Il s'agit d'un ensemble de règles concernant les libellés qui doivent correspondre pour que l'alerte soit supprimée. Les étiquettes correspondantes se composent de trois parties :
+ **Étiquette** : nom de l'étiquette à associer. Il doit correspondre exactement au nom de l'étiquette de l'alerte.
+ **Opérateur** : opérateur utilisé pour comparer la valeur de l'étiquette avec la valeur d'étiquette correspondante. Les opérateurs disponibles sont les suivants :
+ `=`Sélectionnez les libellés dont la valeur correspond exactement à la chaîne fournie.
+ `!=`Sélectionnez les libellés dont la valeur ne correspond pas à la chaîne fournie.
+ `=~`Sélectionnez les étiquettes dont la valeur correspond à la valeur interprétée par regex de la chaîne fournie (la chaîne fournie est interprétée comme une expression régulière).
+ `!=`Sélectionnez les libellés qui ne correspondent pas à l'expression régulière fournie.
+ **Valeur** : valeur à laquelle doit correspondre la valeur de l'étiquette. Il peut correspondre sous forme de chaîne ou d'expression régulière, selon l'opérateur choisi.
Le silence prend fin à la date de fin indiquée, mais vous pouvez mettre fin à la suppression manuellement à tout moment.
**Pour mettre fin à un silence manuellement**
1. Sur la page **Alertes**, choisissez **Silences** pour afficher la liste des silences existants.
1. Sélectionnez le silence auquel vous souhaitez mettre fin, puis choisissez Annuler **le silence**. Cela met fin à la suppression de l'alerte.
**Note**
La désactivation met fin à la suppression de l'alerte, comme si l'heure de fin était définie pour l'heure actuelle. Les silences qui ont pris fin (automatiquement ou manuellement) sont conservés et répertoriés pendant cinq jours. Vous ne pouvez pas supprimer un silence de la liste manuellement.
**Création d'un lien vers le formulaire de création de silence**
Vous pouvez créer une URL vers le formulaire de création de silence avec les informations déjà renseignées. Les opérateurs peuvent l'utiliser pour supprimer rapidement une alarme lors d'un événement opérationnel.
Lorsque vous créez un lien vers un formulaire de silence, utilisez un paramètre de `matchers` requête pour spécifier les libellés correspondants et un paramètre de `comment` requête pour spécifier un commentaire. Le `matchers` paramètre nécessite une ou plusieurs valeurs dans le formulaire`[label][operator][value]`, séparées par des virgules.
**Exemple d'URL**
Pour créer un lien vers un formulaire de silence, avec les libellés correspondants `severity=critical` et`cluster!~europe-.*`, avec un commentaire indiquant`Silencing critical EU alerts`, utilisez une URL comme celle-ci. *mygrafana*Remplacez-le par le nom d'hôte de votre instance Grafana.
```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```
Pour créer un lien vers une nouvelle page de silence pour un Alertmanager externe, ajoutez un paramètre de `alertmanager` requête portant le nom de la source de données Alertmanage, tel que. `alertmanager=myAlertmanagerdatasource`
# Travailler avec les points de contact
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Utilisez les points de contact pour définir la manière dont vos contacts sont avertis lorsqu'une alerte est déclenchée. Un point de contact peut avoir un ou plusieurs types de points de contact, par exemple Amazon Simple Notification Service ou Slack. Lorsqu'une alerte est lancée, une notification est envoyée à tous les types de points de contact répertoriés pour un point de contact. Utilisez-le éventuellement [Utilisation de modèles de messagerie](alert-message-templates.md) pour personnaliser les messages de notification pour les types de points de contact.
**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 Alertmanager sont en lecture seule.
## Travailler avec les points de contact
Les procédures suivantes expliquent comment ajouter, modifier, tester et supprimer des points de contact.
**Pour ajouter un point de contact**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Choisissez **Points de contact**, puis **Nouveau point de contact**.
1. Dans le menu déroulant **Alertmanager**, sélectionnez un Alertmanager. Le Grafana Alertmanager est sélectionné par défaut.
1. Entrez un **nom** pour le point de contact.
1. Dans **Type de point de contact**, choisissez un type et 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 éventuellement les **paramètres facultatifs** 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. Si votre point de contact a besoin de plusieurs types de points de contact, vous pouvez choisir **Nouveau type de point de contact** et répéter les étapes pour chaque type de point de contact requis.
1. Choisissez **Enregistrer le point de contact** pour enregistrer vos modifications.
**Pour modifier un point de contact**
1. Choisissez **Points de contact** pour voir la liste des points de contact existants.
1. Sélectionnez le point de contact à modifier, puis cliquez sur l'icône **Modifier** (stylo).
1. Apportez les modifications nécessaires, puis choisissez **Enregistrer le point de contact** pour enregistrer vos modifications.
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. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.
1. Sélectionnez le point de contact à tester, puis cliquez sur l'icône **Modifier** (stylo).
1. Sélectionnez l'icône **Test** (avion en papier).
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.
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. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.
1. Sélectionnez le point de contact à supprimer, puis cliquez sur l'icône **Supprimer** (corbeille).
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.
## Liste des notificateurs pris en charge
| Name | Type |
| --- | --- |
| Amazon SNS | sns |
| OpsGenie | opsgenie |
| Devoir de téléavertisseur | pagerduty |
| Slack | slack |
| VictorOps | victorops |
# Utilisation de modèles de messagerie
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
Les notifications envoyées via [Travailler avec les points de contact](alert-contact-points.md) sont créées à l'aide *de modèles de messagerie*. Les modèles par défaut de Grafana sont basés sur le [système de modèles Go dans](https://golang.org/pkg/text/template) lequel certains champs sont évalués sous forme de texte, tandis que d'autres sont évalués sous forme de HTML (ce qui peut affecter l'évasion).
Comme la plupart des champs des points de contact peuvent être modélisés, vous pouvez créer des modèles personnalisés réutilisables et les utiliser dans plusieurs points de contact. La [Données du modèle](#alert-template-data) rubrique répertorie les variables disponibles pour la création de modèles.
**Utilisation de modèles**
Les modèles sont utilisés pour créer un message. Par exemple, avec un message d'alerte Slack, vous pouvez définir le titre et le corps du point de contact. L'exemple suivant montre comment utiliser des modèles par défaut pour créer un titre contenant le nombre d'alertes déclenchées et résolues, ainsi qu'un corps répertoriant les alertes et leur statut.
+ **Titre** :
```
{{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
```
+ **Corps du texte** :
```
{{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
{{end }}
```
Vous pouvez créer vos propres modèles personnalisés, comme dans l'exemple suivant.
+ **Titre** :
```
{{ template "slack.default.title" .}}
```
+ **Corps du texte** :
```
{{ template "mymessage" .}}
```
Voici un exemple de modèle.
```
{{ define "myalert" }}
[{{.Status}}] {{ .Labels.alertname }}
Labels:
{{ range .Labels.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ if gt (len .Annotations) 0 }}
Annotations:
{{ range .Annotations.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ end }}
{{ if gt (len .SilenceURL ) 0 }}
Silence alert: {{ .SilenceURL }}
{{ end }}
{{ if gt (len .DashboardURL ) 0 }}
Go to dashboard: {{ .DashboardURL }}
{{ end }}
{{ end }}
```
Les procédures suivantes indiquent comment créer, modifier et supprimer des modèles de messages personnalisés.
**Pour créer un modèle de message**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Choisissez **Points de contact**.
1. Dans la liste déroulante **Alertmanager**, sélectionnez l'instance Alertmanager pour laquelle vous souhaitez créer un modèle de message. La valeur par défaut est le Grafana Alertmanager.
1. Choisissez **Ajouter un modèle**.
1. Ajoutez un **nom** descriptif.
1. Ajoutez le **contenu** du modèle, par exemple :
```
{{ define "mymessage" }}
{{ range .Alerts }}
[{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
{{ end }}
{{ end }}
```
La `define` balise de la section Contenu attribue le nom du modèle. Cette balise est facultative, et lorsqu'elle est omise, le nom du modèle est dérivé du champ **Nom**. Lorsque les deux sont spécifiés, il est recommandé de les conserver identiques.
1. Choisissez **Enregistrer le modèle**.
**Note**
Dans les modèles de messages d'alerte, le code HTML est affiché sous forme de texte, les caractères de contrôle étant ignorés. Le rendu du code HTML dans la notification résultante n'est pas pris en charge par Grafana.
**Pour modifier un modèle de message**
1. Sur la page **Alertes**, choisissez **Points de contact** pour ouvrir la liste des points de contact.
1. Dans le **tableau Modèle**, recherchez le modèle que vous souhaitez modifier, puis cliquez sur l'icône **Modifier** (stylo).
1. Apportez vos modifications, puis choisissez **Enregistrer le modèle**.
**Pour supprimer un modèle de message**
1. Sur la page **Alertes**, choisissez **Points de contact** pour ouvrir la liste des points de contact.
1. Dans le **tableau Modèle**, recherchez le modèle que vous souhaitez supprimer, puis cliquez sur l'icône **Supprimer** (corbeille).
1. Choisissez **Oui, supprimer** pour supprimer le modèle.
**Modèles imbriqués**
Vous pouvez intégrer des modèles dans d'autres modèles.
Par exemple, vous pouvez définir un fragment de modèle à l'aide du `define` mot clé :
```
{{ define "mytemplate" }}
{{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```
Vous pouvez ensuite intégrer des modèles personnalisés dans ce fragment à l'aide du `template` mot clé. Par exemple :
```
Alert summary:
{{ template "mytemplate" . }}
```
Vous pouvez utiliser les options de modèle intégrées suivantes pour intégrer des modèles personnalisés.
| Name | Remarques |
| --- | --- |
| `default.title` | Affiche des informations d'état de haut niveau. |
| `default.message` | Fournit un résumé formaté des alertes déclenchées et résolues. |
**Exemples de modèles personnalisés**
Voici des exemples d'utilisation de modèles personnalisés.
Modèle pour afficher une seule alerte :
```
{{ define "myalert" }}
[{{.Status}}] {{ .Labels.alertname }}
Labels:
{{ range .Labels.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ if gt (len .Annotations) 0 }}
Annotations:
{{ range .Annotations.SortedPairs }}
{{ .Name }}: {{ .Value }}
{{ end }}
{{ end }}
{{ if gt (len .SilenceURL ) 0 }}
Silence alert: {{ .SilenceURL }}
{{ end }}
{{ if gt (len .DashboardURL ) 0 }}
Go to dashboard: {{ .DashboardURL }}
{{ end }}
{{ end }}
```
Modèle pour afficher l'intégralité du message de notification :
```
{{ define "mymessage" }}
{{ if gt (len .Alerts.Firing) 0 }}
{{ len .Alerts.Firing }} firing:
{{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
{{ end }}
{{ if gt (len .Alerts.Resolved) 0 }}
{{ len .Alerts.Resolved }} resolved:
{{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
{{ end }}
{{ end }}
```
## Données du modèle
Les données suivantes sont transmises aux modèles de messages.
| Name | Type | Remarques |
| --- | --- | --- |
| `Receiver` | chaîne | Nom du point de contact auquel la notification est envoyée. |
| `Status` | chaîne | déclenchement si au moins une alerte est déclenchée, sinon résolu. |
| `Alerts` | Alerte | Liste des objets d'alerte inclus dans cette notification (voir ci-dessous). |
| `GroupLabels` | KeyValue | Étiquettes selon lesquelles ces alertes ont été regroupées. |
| `CommonLabels` | KeyValue | Libellés communs à toutes les alertes incluses dans cette notification. |
| `CommonAnnotations` | KeyValue | Annotations communes à toutes les alertes incluses dans cette notification. |
| `ExternalURL` | chaîne | Lien de retour vers le Grafana qui a envoyé la notification. Si vous utilisez un Alertmanager externe, renvoyez le lien vers ce Alertmanager. |
Le `Alerts` type expose deux fonctions permettant de filtrer les alertes renvoyées.
+ `Alerts.Firing`— Renvoie la liste des alertes de déclenchement.
+ `Alerts.Resolved`— Renvoie la liste des alertes résolues.
**Alerte (type)**
Le type d'alerte contient les données suivantes.
| Name | Type | Remarques |
| --- | --- | --- |
| Statut | chaîne | `firing` ou `resolved`. |
| Étiquettes | KeyValue | Ensemble d'étiquettes associées à l'alerte. |
| Annotations | KeyValue | Ensemble d'annotations associées à l'alerte. |
| StartsAt | Heure. Heure | Heure à laquelle l'alerte a commencé à se déclencher. |
| EndsAt | Heure. Heure | Paramétré uniquement si l'heure de fin d'une alerte est connue. Sinon, définissez un délai d'expiration configurable à compter de la date de réception de la dernière alerte. |
| URL du générateur | chaîne | Un lien de retour vers Grafana ou un Alertmanager externe. |
| URL de silence | chaîne | Lien vers le formulaire Grafana Silence avec des étiquettes préremplies pour cette alerte. Uniquement pour les alertes gérées par Grafana. |
| URL du tableau de bord | chaîne | Lien vers le tableau de bord de Grafana, si la règle d'alerte en appartient à une. Uniquement pour les alertes gérées par Grafana. |
| URL du panneau | chaîne | Lien vers le panneau du tableau de bord de Grafana, si la règle d'alerte appartient à l'une d'entre elles. Uniquement pour les alertes gérées par Grafana. |
| Empreinte | chaîne | Empreinte digitale qui peut être utilisée pour identifier l'alerte. |
| ValueString | chaîne | Chaîne contenant les libellés et la valeur de chaque expression réduite de l'alerte. |
**KeyValue type**
Le `KeyValue` type est un ensemble de paires de key/value chaînes qui représentent des étiquettes et des annotations.
Outre l'accès direct aux données stockées sous forme de fichier`KeyValue`, il existe également des méthodes de tri, de suppression et de transformation des données.
| Name | Arguments | Renvoie | Remarques |
| --- | --- | --- | --- |
| SortedPairs | | Liste triée des paires de chaînes de clés et de valeurs | |
| Supprimer | [] chaîne | KeyValue | Renvoie une copie de la Key/Value carte sans les clés données. |
| Noms | | [] chaîne | Liste des noms d'étiquettes |
| Valeurs | | [] chaîne | Liste des valeurs d'étiquette |
## Fonctions du modèle
À l'aide des fonctions du modèle, vous pouvez traiter les étiquettes et les annotations pour générer des notifications dynamiques. Les fonctions suivantes sont disponibles.
| Name | Type d’argument | Type de retour | Description |
| --- | --- | --- | --- |
| `humanize` | nombre ou chaîne | chaîne | Convertit un nombre dans un format plus lisible à l'aide de préfixes métriques. |
| `humanize1024` | nombre ou chaîne | chaîne | Comme humanize, mais utilise 1024 comme base au lieu de 1000. |
| `humanizeDuration` | nombre ou chaîne | chaîne | Convertit une durée en secondes dans un format plus lisible. |
| `humanizePercentage` | nombre ou chaîne | chaîne | Convertit une valeur de ratio en une fraction de 100. |
| `humanizeTimestamp` | nombre ou chaîne | chaîne | Convertit un horodatage Unix en secondes dans un format plus lisible. |
| `title` | chaîne | chaîne | Strings.title, met en majuscule le premier caractère de chaque mot. |
| `toUpper` | chaîne | chaîne | cordes. ToUpper, convertit tous les caractères en majuscules. |
| `toLower` | chaîne | chaîne | cordes. ToLower, convertit tous les caractères en minuscules. |
| `match` | motif, texte | boolean | expression régulière. MatchString Teste une correspondance regexp non ancrée. |
| `reReplaceAll` | modèle, remplacement, texte | chaîne | Expression régulière. ReplaceAllString Substitution de Regexp, non ancrée. |
| `graphLink` | string - Objet JSON avec `datasource` champs `expr` et | chaîne | Renvoie le chemin d'accès à la vue graphique dans Explore pour l'expression et la source de données données. |
| `tableLink` | string - Objet JSON avec `datasource` champs `expr` et | chaîne | Renvoie le chemin d'accès à la vue tabulaire dans Explore pour l'expression et la source de données données. |
| `args` | [] interface \$1\$1 | carte [chaîne] interface \$1\$1 | Convertit une liste d'objets en carte avec des clés, par exemple arg0, arg1. Utilisez cette fonction pour transmettre plusieurs arguments aux modèles. |
| `externalURL` | rien | chaîne | Renvoie une chaîne représentant l'URL externe. |
| `pathPrefix` | rien | chaîne | Renvoie le chemin de l'URL externe. |
Le tableau suivant présente des exemples d'utilisation de chaque fonction.
| Fonction | TemplateString | Input | Expected |
| --- | --- | --- | --- |
| humaniser | \$1humaniser \$1value\$1 | 1234567,0 | 1,235 M |
| humaniser 1024 | \$1humaniser 1024\$1 de valeur\$1 | 1048576,0 | 1 mi |
| Humaniser la durée | \$1HumanizeDuration \$1value\$1 | 899,99 | 14 m 59 s |
| Pourcentage d'humanisation | \$1humanizePercentage \$1value\$1 | 0,1234567 | 12,35 % |
| Humaniser l'horodatage | \$1humanizeTimestamp \$1value\$1 | 1435065584,128 | 23/06/2015 13:19:44,128 \$10000 UTC |
| title | \$1\$1value \$1 titre\$1 | un B C | Aa Bb CC |
| toUpper | \$1\$1value \$1 toUpper\$1 | un B C | AA BB CC |
| toLower | \$1\$1value \$1 toLower\$1 | un B C | AA BB CC |
| match | \$1correspond à « a\$1 » \$1labels.instance\$1 | aa | true |
| reReplaceAll | \$1\$1 reReplaceAll « localhost :( .\$1) » « my.domain : \$11 » \$1labels.instance\$1\$1 | hôte local : 3000 | mon domaine .domain : 3000 |
| GraphLink | \$1\$1GraphLink « \$1\$1" expr \$1 » : \$1 "up \$1 », \$1 "source de données \$1 » : \$1 "gdev-prometheus \$1"\$1 »\$1 | | /explorer ? left= ["now-1h », « now », « gdev-prometheus », \$1"source de données » « gdev-prometheus », « expr » « up », « instant » :false, "range » :true\$1] |
| Tableau Link | \$1\$1TableLink « \$1\$1" expr \$1 » : \$1 "up \$1 », \$1 "source de données \$1 » : \$1 "gdev-prometheus \$1"\$1 »\$1 | | /explorer ? left= ["now-1h », « now », « gdev-prometheus », \$1"source de données » « gdev-prometheus », « expr » « up », « instant » :true, "range » :false\$1] |
| args | \$1\$1define « x »\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1modèle « x » (args 1 « 2 »)\$1\$1 | | 1 2 |
| URL externe | \$1URL externe\$1 | | http ://localhost/path/prefix |
| Préfixe de chemin | \$1PathPrefix\$1 | | /chemin/préfixe |
# Utilisation des politiques de notification
****
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)
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)
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 comporter une ou plusieurs politiques relatives aux enfants. Chaque politique, à l'exception de la stratégie racine, peut également correspondre à des étiquettes d'alerte spécifiques. Chaque alerte est évaluée par la politique racine, puis par chaque politique enfant. Si vous activez l'`Continue matching subsequent sibling nodes`option pour une politique spécifique, 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 racine régit toute alerte qui ne correspond pas à une politique spécifique.
**Note**
Vous pouvez créer et modifier des politiques de notification pour les alertes gérées par Grafana. Les politiques de notification pour les alertes Alertmanager sont en lecture seule.
**Notifications de regroupement**
Le regroupement permet de classer les notifications d'alerte de nature similaire dans un entonnoir unique. Cela vous permet de contrôler les notifications d'alerte lors de pannes importantes lorsque de nombreuses parties d'un système tombent en panne simultanément, ce qui entraîne le déclenchement simultané d'un grand nombre d'alertes.
**Exemple de regroupement**
Supposons que 100 services soient connectés à une base de données dans différents environnements. Ces services sont différenciés par le label`env=environmentname`. Une règle d'alerte est en place pour vérifier si vos services peuvent accéder à la base de données. La règle d'alerte crée des alertes nommées`alertname=DatabaseUnreachable`.
En cas de partition réseau empêchant la moitié de vos services d'accéder à la base de données, 50 alertes différentes sont déclenchées. Dans ce cas, vous souhaitez recevoir une notification d'une seule page (au lieu de 50) contenant la liste des environnements concernés.
Vous pouvez configurer le regroupement de manière à ce qu'il soit `group_by: [alertname]` (sans utiliser l'`env`étiquette, qui est différente pour chaque service). Une fois cette configuration en place, Grafana envoie une seule notification compacte répertoriant tous les environnements concernés par cette règle d'alerte.
**Groupes spéciaux**
Grafana compte deux groupes spéciaux. Le groupe par défaut `group_by: null` regroupe *toutes les* alertes en un seul groupe. Vous pouvez également utiliser une étiquette spéciale nommée `...` pour regrouper les alertes par toutes les étiquettes, désactiver efficacement le regroupement et envoyer chaque alerte dans son propre groupe.
## Utilisation des notifications
Les procédures suivantes vous montrent comment créer et gérer des politiques de notification.
**Pour modifier la politique de notification root**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Choisissez **Politiques de notification**.
1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.
1. Dans la section **Politique racine**, choisissez l'icône **Modifier** (stylo).
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 (ou les groupes spéciaux) selon lesquels regrouper les alertes.
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 ajouter une nouvelle politique spécifique de haut niveau**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Choisissez **Politiques de notification**.
1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.
1. Dans la section **Routage spécifique**, choisissez **Nouvelle politique spécifique**.
1. Dans la section **Étiquettes correspondantes**, ajoutez une ou plusieurs étiquettes d'alerte correspondantes. Vous trouverez plus d'informations sur la correspondance des étiquettes plus loin dans cette rubrique.
1. Dans **Point de contact**, ajoutez le point de contact auquel envoyer des notifications si l'alerte correspond à cette politique spécifique. Les politiques imbriquées remplacent ce point de contact.
1. Sélectionnez éventuellement **Remplacer le regroupement** pour spécifier un regroupement différent de la politique racine.
1. Sélectionnez éventuellement Annuler les **horaires généraux** pour annuler les options de synchronisation de la politique de notification de groupe.
1. Choisissez **Enregistrer la politique** pour enregistrer les changements.
**Pour ajouter une politique imbriquée**
1. Développez la stratégie spécifique sous laquelle vous souhaitez créer une politique imbriquée.
1. Choisissez **Ajouter une politique imbriquée**, puis ajoutez les détails (comme lors de l'ajout d'une politique spécifique de haut niveau).
1. Choisissez **Enregistrer la politique** pour enregistrer les changements.
**Pour modifier une politique spécifique**
1. Sur la page **Alertes**, choisissez **Politiques de notification** pour ouvrir la page répertoriant les politiques existantes.
1. Sélectionnez la politique que vous souhaitez modifier, puis cliquez sur l'icône **Modifier** (stylo).
1. Apportez des modifications (comme lors de l'ajout d'une politique spécifique de haut niveau).
1. Choisissez **Enregistrer la stratégie**.
**Comment fonctionne la correspondance des étiquettes**
Une politique correspond à une alerte si les libellés de l'alerte correspondent à tous les *libellés correspondants* spécifiés dans la stratégie.
+ **Étiquette** : nom de l'étiquette à associer. Il doit correspondre exactement au nom de l'étiquette de l'alerte.
+ **Opérateur** : opérateur utilisé pour comparer la valeur de l'étiquette avec la valeur d'étiquette correspondante. Les opérateurs disponibles sont les suivants :
+ `=`Sélectionnez les libellés dont la valeur correspond exactement à la chaîne fournie.
+ `!=`Sélectionnez les libellés dont la valeur ne correspond pas à la chaîne fournie.
+ `=~`Sélectionnez les étiquettes dont la valeur correspond à la valeur interprétée par regex de la chaîne fournie (la chaîne fournie est interprétée comme une expression régulière).
+ `!=`Sélectionnez les libellés qui ne correspondent pas à l'expression régulière fournie.
+ **Valeur** — La valeur à laquelle doit correspondre la valeur de l'étiquette. Il peut correspondre sous forme de chaîne ou d'expression régulière, selon l'opérateur choisi.
## Horaire du mode muet
Un temps de sourdine est un intervalle de temps récurrent pendant lequel aucune nouvelle notification relative à une politique n'est générée ou envoyée. Utilisez-les pour empêcher les alertes de se déclencher pendant une période spécifique et récurrente, par exemple une période de maintenance régulière.
À l'instar des silences, le temps de mise en sourdine n'empêche pas l'évaluation des règles d'alerte, ni l'affichage des instances d'alerte dans l'interface utilisateur. Ils empêchent uniquement la création de notifications.
Vous pouvez configurer les durées de sourdine gérées par Grafana ainsi que les durées de sourdine pour une source de données Alertmanager externe.
**Timings muets comparés aux silences**
Le tableau suivant met en évidence les différences entre les temps de sourdine et les silences.
| Synchronisation en mode muet | Silence |
| --- | --- |
| Utilise des définitions d'intervalles de temps qui peuvent se reproduire | A une heure de début et de fin fixes |
| Est créé puis ajouté aux politiques de notification | Utilise des étiquettes pour établir une correspondance avec une alerte afin de déterminer s'il convient de désactiver ou non |
**Pour créer un chronométrage muet**
1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**
1. Choisissez **Politiques de notification**.
1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.
1. Dans la section Durée de mise en **sourdine, cliquez sur le bouton Ajouter une temporisation** **de mise en sourdine.**
1. Choisissez l'intervalle de temps auquel vous souhaitez appliquer la temporisation du mode muet.
1. Choisissez **Soumettre** pour créer la temporisation du mode muet.
**Pour ajouter une temporisation muette à une politique de notification**
1. Sélectionnez la politique de notification à laquelle vous souhaitez ajouter le temps de sourdine, puis cliquez sur le bouton **Modifier**.
1. Dans le menu déroulant Durée de **mise en sourdine**, sélectionnez la durée de mise en sourdine que vous souhaitez ajouter à la politique.
Cliquez sur le bouton **Enregistrer la politique**.
**Intervalles de temps**
Un intervalle de temps est la définition d'une plage de temps. Si une alerte est déclenchée pendant cet intervalle, elle est supprimée. Les plages sont prises en charge à l'aide de `:` (par exemple,`monday:thursday`). Une temporisation muette peut contenir plusieurs intervalles de temps. Un intervalle de temps se compose de plusieurs champs (détails dans la liste suivante), qui doivent tous correspondre pour supprimer les alertes. Par exemple, si vous spécifiez des jours de la semaine `monday:friday` et une plage horaire comprise entre 8 h et 9 h, les alertes sont supprimées du 8 au 9, du lundi au vendredi, mais pas, par exemple, de 8 h à 9 h le samedi.
+ **Plage horaire** : heure à laquelle les notifications doivent être supprimées. Composé de deux sous-champs, Heure de **début et Heure** de **fin.** Un exemple de temps est`14:30`. L'heure est exprimée en notation de 24 heures, en UTC.
+ **Jours de la semaine** — Les jours de la semaine. Il peut s'agir d'un jour unique`monday`, tel qu'une plage`monday:friday`, ou d'une liste de jours séparés par des virgules, telle que. `monday, tuesday, wednesday`
+ **Mois** — Les mois à sélectionner. Vous pouvez spécifier les mois avec des désignations numériques ou avec le nom complet du mois, par exemple, `1` ou les `january` deux spécifier janvier. Vous pouvez spécifier un mois unique, une plage de mois ou une liste de mois séparés par des virgules.
+ **Jours du mois** : dates comprises dans un délai d'un mois. Les valeurs peuvent être comprises entre `1` -`31`. Les valeurs négatives indiquent les jours du mois dans l'ordre inverse, ce `-1` qui représente le dernier jour du mois. Les jours du mois peuvent être spécifiés sous la forme d'un jour unique, d'une plage de jours ou d'une liste de jours séparés par des virgules.