Gérer les règles d'alerte

La Google Cloud console vous permet d'afficher, de répertorier, de modifier, de copier et de supprimer vos règles d'alerte dans Cloud Monitoring. Vous pouvez également associer une règle d'alerte à une application App Hub, et afficher ou télécharger la représentation JSON d'une règle d'alerte. Pour afficher vos règles d'alerte dans le même contexte que vos données de métriques, vous pouvez les ajouter à un tableau de bord personnalisé.

Pour gérer vos règles d'alerte à l'aide de l'API Cloud Monitoring, consultez Gérer les règles d'alerte par API.

Cette fonctionnalité n'est disponible que pour les Google Cloud projets. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

Avant de commencer

Effectuez les opérations suivantes dans le Google Cloud projet qui stocke vos règles d'alerte :

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

   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 Contrôler l'accès avec Identity and Access Management.

2. Assurez-vous de bien maîtriser les concepts généraux des règles d'alerte. Pour en savoir plus, consultez Aperçu des alertes.

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

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

   Accéder à la page Alertes

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

   La page Alertes affiche des volets répertoriant les informations récapitulatives, les alertes et les règles d'alerte.

2. Dans la barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

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

   La page Règles inclut une liste de toutes les règles, une barre de filtres et des options permettant de modifier, de copier ou de supprimer chaque règle :

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

     • Saisissez un nom dans la barre de filtres. 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 une valeur dans le menu.

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

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

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

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

   Si un tableau de bord contient un graphique qui affiche des données pour une règle d'alerte, ce graphique cesse d'afficher des données lorsque la règle d'alerte est supprimée. Pour en savoir plus, consultez Le widget de règle d'alerte n'affiche aucune donnée.

Afficher une règle d'alerte

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

   Accéder à la page Alertes

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

2. Dans la barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

3. Pour afficher la liste de toutes les règles, cliquez sur Afficher toutes les règles dans le volet Règles.

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

   La page d'informations de la règle d'alerte s'ouvre. Vous pouvez y surveiller ou modifier votre règle, et afficher les données associées, telles que les alertes et les notifications. Vous pouvez également effectuer les opérations suivantes :

   • Modifier la période des données affichées dans le graphique. Les graphiques ont une résolution limitée et peuvent ne pas afficher toutes les mesures pour certaines périodes.

   • Modifiez votre alerte pour ajouter des étiquettes définies par l'utilisateur, qui seront incluses dans vos alertes et notifications. Pour en savoir plus, consultez Annoter les alertes avec des étiquettes.

   • Modifier l'état activé de la règle. Lorsqu'une règle est désactivée, vous ne recevez pas de notifications.

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 d'API. Vous pouvez créer le JSON vous-même en vous appuyant sur la documentation de l'API pour guider le contenu. Vous pouvez également créer une règle à l'aide de la Google Cloud console, 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 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 Google Cloud console, accédez à la notifications page Alertes :

   Accéder à la page Alertes

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

2. Dans la barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
3. Recherchez la règle que vous souhaitez afficher, puis cliquez sur son nom pour ouvrir la page Détails de la règle.
4. Cliquez sur get_app JSON.

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

Ajouter une règle d'alerte à un 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é. Lorsque vous affichez ce tableau de bord, il présente 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'alertes ouvertes pour la règle. Ils contiennent également des liens qui vous permettent d'afficher ou de modifier la règle.

Vous pouvez ajouter des règles avec une seule condition à des tableaux de bord personnalisés. Les règles qui contiennent plusieurs conditions ne peuvent être affichées que dans le contexte des alertes.

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

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

   Accéder à la page Tableaux de bord

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

2. Dans la barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
3. Sélectionnez un tableau de bord ou cliquez sur Créer un tableau de bord.
4. Dans la barre d'outils, cliquez sur add Ajouter un widget.
5. Dans la boîte de dialogue Ajouter un widget, sélectionnez notifications Règle d'alerte.
6. Cliquez sur arrow_drop_down Règle d'alerte, puis sélectionnez une règle d'alerte. Seules les règles d'alerte à condition unique peuvent être sélectionnées dans le menu Règle d'alerte.
7. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

La capture d'écran suivante illustre un graphique pour une règle 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%. Le chip vert avec le libellé No alerts indique qu'aucune alerte n'est ouverte pour la règle d'alerte. Si vous placez le pointeur sur le chip qui indique le nombre d'alertes ouvertes, une boîte de dialogue s'ouvre et renvoie à la règle d'alerte sous-jacente.

Pour en savoir plus, consultez Afficher des règles d'alerte et des alertes dans un tableau de bord.

Associer une règle d'alerte à une application App Hub

En ajoutant des étiquettes définies par l'utilisateur à une règle d'alerte, vous pouvez l'associer à un service ou à une charge de travail qui fait partie d'une application App Hub. Ces étiquettes sont incluses dans les alertes et les notifications, et la règle d'alerte est également répertoriée dans les tableaux de bord de surveillance des applications. Pour en savoir plus sur les étiquettes, consultez Annoter les alertes avec des étiquettes.

Pour associer une règle d'alerte à une charge de travail ou à un service à l'aide de la Google Cloud console, procédez comme suit :

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

   Accéder à la page Alertes

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

2. Dans la barre d'outils de la Google Cloud console, sélectionnez votre Google Cloud projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.
3. Recherchez la règle d'alerte, cliquez sur more_vert Afficher plus, sélectionnez Modifier, puis accédez à la section Notifications et nom.

4. Dans la section Étiquettes d'application , sélectionnez votre application, puis votre service ou votre charge de travail :

   

5. Cliquez sur Enregistrer la règle.

Une fois ces étapes effectuées, des étiquettes avec les clés suivantes sont associées à votre règle d'alerte. Ces étiquettes identifient votre application et votre service ou votre charge de travail :

• apphub_application_location
• apphub_application_id
• apphub_service_id ou apphub_workload_id

Vous pouvez également ajouter des étiquettes utilisateur à une règle d'alerte à l'aide de Google Cloud CLI, de Terraform ou de l'API Cloud Monitoring. Toutefois, vous devez utiliser les clés d'étiquette affichées dans l'exemple précédent. Pour en savoir plus, consultez les ressources suivantes :

• Gérer les règles d'alerte par API.
• Gérer les règles d'alerte avec Terraform.