Gérer les règles d'alerte

Ce document explique comment modifier, répertorier et afficher vos règles d'alerte à l'aide de la console Google Cloud. Il explique également comment afficher la représentation JSON d'une règle et comment ajouter des règles d'alerte à un tableau de bord personnalisé. Lorsque vous ajoutez des règles à un tableau de bord personnalisé, vous pouvez les afficher dans le même contexte que vos données de métriques.

Ce document n'explique pas comment modifier, répertorier ni afficher vos règles d'alerte à l'aide de l'API Cloud Monitoring. Pour en savoir plus, consultez la page Gérer les règles d'alerte à l'aide de l'API.

Avant de commencer

1. Pour obtenir les autorisations dont vous avez besoin pour créer et modifier des règles d'alerte à l'aide de la console Google Cloud, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

   Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

   Pour en savoir plus sur les rôles Cloud Monitoring, consultez la page Contrôler les accès avec Identity and Access Management.

2. Assurez-vous de bien connaître les concepts généraux liés aux règles d'alerte. Pour en savoir plus, consultez la page Présentation des alertes.

Modifier, répertorier ou supprimer des règles d'alerte

1. Dans la console Google Cloud, accédez à la page  Alertes:

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

   La page Alertes affiche des volets contenant une liste d'informations récapitulatives, d'incidents et de règles d'alerte.

2. Cliquez sur Afficher toutes les règles dans le volet Règles.

   La page Règles répertorie toutes les règles, inclut une barre de filtre et propose pour chaque règle des options permettant de la modifier, de la copier ou de la supprimer:

   • Pour filtrer la liste des règles d'alerte, effectuez l'une des opérations suivantes:

     • Saisissez un nom dans la barre de filtre. Par exemple, pour n'afficher que les règles dont le nom contient Example, saisissez Example. Une comparaison sensible à la casse permet de vérifier si une règle est répertoriée.
     • Cliquez sur Filtrer les règles, sélectionnez la propriété de filtre, puis saisissez une valeur pour le filtre ou sélectionnez-en une dans le menu.

     Lorsque vous ajoutez plusieurs filtres, un AND logique les joint.

3. Facultatif: Pour afficher les détails d'une règle, cliquez sur son nom. Pour en savoir plus sur la page Détails des règles, consultez Afficher une règle d'alerte.

4. Facultatif: Pour modifier ou copier une règle, cliquez sur Autres options, puis sélectionnez l'option correspondante. La modification et la copie d'une règle sont similaires à la création d'une règle d'alerte basée sur les métriques. Cependant, tous les champs ne peuvent pas être modifiés. Lorsque vous avez terminé, cliquez sur Save policy (Enregistrer la règle).

5. Facultatif: Pour supprimer une règle, cliquez sur Autres options, puis sélectionnez Supprimer. Dans la boîte de dialogue de confirmation, sélectionnez Delete (Supprimer).

   Si vous supprimez la règle d'alerte associée à un graphique d'alerte, celui-ci n'affiche plus de données. Pour en savoir plus, consultez Le graphique d'alerte n'affiche aucune donnée.

Afficher une règle d'alerte

1. Dans la console Google Cloud, accédez à la page  Alertes:

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Pour répertorier toutes les règles, cliquez sur Afficher toutes les règles dans le volet Règles.

3. Recherchez la règle que vous souhaitez afficher, puis sélectionnez-la.

Par exemple, la capture d'écran suivante illustre les détails de la règle d'alerte nommée Test staging:

Comme le montre l'image précédente, la page d'informations fournit des informations sur la règle d'alerte:

• Pour afficher les incidents créés par la règle, consultez la section Incidents.

• Pour afficher les canaux de notification configurés, consultez la section Canaux de notification.

• Pour afficher les informations supplémentaires à inclure dans une notification, consultez la section Documentation.

• Pour afficher les libellés définis par l'utilisateur, consultez la section Étiquettes. Pour consulter des exemples illustrant comment utiliser des libellés pour ajouter des informations à vos incidents, consultez la page Annoter les incidents avec des libellés.

• Pour modifier, copier, supprimer ou télécharger la représentation JSON, ou pour modifier l'état d'activation de la règle, utilisez les options de la barre d'outils. Par exemple, pour désactiver une règle d'alerte activée, cliquez sur Activé, puis sélectionnez Désactiver dans la boîte de dialogue de confirmation.

Remarque :Une règle réactivée peut se déclencher immédiatement. Pour en savoir plus, consultez la section Notifications pour les règles d'alerte désactivées.

Afficher la représentation JSON d'une règle d'alerte

Lorsque vous créez ou modifiez une règle d'alerte à l'aide de l'API Cloud Monitoring, vous fournissez une représentation JSON de cette règle à la méthode API. Vous pouvez créer le fichier JSON vous-même en vous servant de la documentation de l'API pour guider le contenu. Vous pouvez également créer une règle à l'aide de la console Google Cloud, puis la télécharger sur votre système local. Le fichier JSON que vous avez téléchargé peut être modifié et utilisé comme modèle pour d'autres règles. Pour obtenir des exemples de règles décrites par JSON, consultez la page Exemples de règles.

Pour télécharger la représentation JSON d'une règle d'alerte, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Alertes:

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Recherchez la règle que vous souhaitez afficher, puis cliquez sur son nom pour ouvrir la page Détails des règles.
3. Cliquez sur JSON.

Pour afficher la représentation JSON d'une règle d'alerte lorsque vous la modifiez, cliquez sur  Afficher le code.

Ajouter une règle d'alerte au tableau de bord

Pour afficher vos règles d'alerte dans le même contexte que vos données de métriques, ajoutez-les à un tableau de bord personnalisé. Ce tableau de bord affiche un graphique pour chaque règle d'alerte que vous avez ajoutée. Ces graphiques affichent la métrique surveillée, le seuil et le nombre d'incidents ouverts pour la règle. Ces graphiques contiennent également des liens qui vous permettent d'afficher ou de modifier les règles.

Vous pouvez ajouter des règles à une condition aux tableaux de bord personnalisés. Les règles contenant plusieurs conditions ne peuvent être visualisées que dans le contexte d'alerte.

Pour afficher le résumé d'une règle d'alerte sur un tableau de bord personnalisé, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Tableaux de bord.

   Accédez à Tableaux de bord.

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Sélectionnez un tableau de bord ou cliquez sur Créer un tableau de bord.
3. Dans la barre d'outils, cliquez sur  Ajouter un widget.
4. Dans la boîte de dialogue Add widget (Ajouter un widget), sélectionnez Alert Policy (Règle d'alerte).
5. Cliquez sur Règle d'alerte, puis sélectionnez une règle d'alerte. Vous ne pouvez sélectionner que des règles d'alerte à condition unique dans le menu Règle d'alerte.
6. Pour appliquer vos modifications au tableau de bord, cliquez sur Apply (Appliquer) dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

La capture d'écran suivante illustre un graphique d'alerte:

Dans cet exemple, la règle d'alerte surveille l'utilisation du processeur de deux machines virtuelles différentes. La ligne en pointillé affiche le seuil de condition, qui est défini sur 50%. L'icône verte portant le libellé No incidents indique qu'aucun incident n'est ouvert pour la règle d'alerte. Si vous placez votre pointeur sur la puce qui indique le nombre d'incidents ouverts, une boîte de dialogue s'ouvre et renvoie vers la règle d'alerte sous-jacente.

Pour en savoir plus, consultez Afficher des graphiques d'alerte et des incidents dans un tableau de bord.