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 compatibles avec la version 10.x de Grafana.

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

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

Les espaces de travail qui choisissent de ne pas utiliser les alertes Grafana utilisent le. Alertes classiques sur le tableau Pour passer à la nouvelle alerte Grafana, vous devez activer cette fonctionnalité. Pour en savoir plus sur les différences entre les alertes classiques du tableau de bord et les alertes Grafana, voir. Alertes Grafana et alertes du tableau de bord traditionnel

Lorsque vous utilisez les alertes de tableau de bord classiques, Amazon Managed Grafana vous montre un aperçu des alertes Grafana, dans lequel vous pouvez consulter et modifier vos alertes mises à niveau avant de finaliser la mise à niveau.

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.

Prévisualisation des alertes Grafana

Vous pouvez prévisualiser vos alertes dans les alertes Grafana avant de procéder à la migration. Dans l'aperçu, vous pouvez apporter des modifications aux alertes qui modifieront la migration.

Pour prévisualiser votre migration vers les alertes Grafana

1. Connectez-vous à votre espace de travail Grafana.

2. Dans le menu de gauche, choisissez Alerting (legacy) pour afficher vos alertes actuelles.

3. Dans le menu de gauche, choisissez Mise à niveau des alertes pour afficher vos alertes dans Grafana Alerting.

   Dans cette vue, vous pouvez voir à quoi ressembleront vos alertes après la migration.

Note

Dans cette vue, vous pouvez également apporter des modifications qui affecteront votre migration. Pour annuler les modifications que vous apportez, choisissez Réinitialiser la mise à niveau en haut à droite de la page de mise à niveau.

Lorsque vous êtes prêt à mettre à jour vos alertes, consultez la section suivante.

Migration vers le système d'alerte Grafana

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

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 optionError. Pour correspondre au comportement duKeep 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-recvitinéraire.

Limites

• 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.

Alertes Grafana et alertes du tableau de bord traditionnel

Introduite dans Grafana 8, l'alerte Grafana présente plusieurs améliorations par rapport aux anciennes alertes du tableau de bord.

Alertes multidimensionnelles

Vous pouvez désormais créer des alertes qui vous offrent une visibilité à l'échelle du système à l'aide d'une seule règle d'alerte. Générez 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.

Créez des alertes en dehors des tableaux de bord

Contrairement aux anciennes alertes de 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 pour Loki et Grafana Mimir

Dans Grafana Alerting, vous pouvez gérer les règles d'alerte de Loki et de Grafana Mimir en utilisant la même interface utilisateur et la même API que vos alertes gérées par Grafana.

Afficher et rechercher des alertes provenant de sources de données compatibles avec Prometheus

Les alertes pour les sources de données compatibles avec Prometheus sont désormais répertoriées dans la section Alertes Grafana. 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

Grafana Alerting a introduit un nouveau concept des états d'alerte. Lorsque l'évaluation d'une règle d'alerte produit un état NoData ou une erreur, Grafana Alerting génère des alertes spéciales portant les étiquettes suivantes :

• alertnameavec une valeur DatasourceNoData ou DatasourceError en fonction de l'état.

• rulenamenom de la règle d'alerte à laquelle appartient l'alerte spéciale.

• datasource_uidaura l'UID de la source de données à l'origine de l'état.

• Toutes les étiquettes et annotations de la règle d'alerte d'origine

Vous pouvez gérer ces alertes de la même manière que les alertes classiques en ajoutant un silence, un itinéraire vers un point de contact, etc.

Note

Si la règle utilise de nombreuses sources de données et qu'une ou plusieurs ne renvoient aucune donnée, l'alerte spéciale sera créée pour chaque source de données à l'origine de l'état d'alerte.