Configurer des notifications pour les métriques basées sur les journaux

Ce document explique comment configurer les notifications lorsqu'un la métrique basée sur les journaux correspond au critère que vous spécifiez. Ces instructions, qui vous expliquent comment créer une règle d'alerte et configurer des canaux de notification, sont destinées à la console Google Cloud. Vous pouvez également créer des règles d'alerte à l'aide API Cloud Monitoring et à l'aide de la commande Google Cloud CLI gcloud alpha monitoring policies

Avant de commencer

  1. Assurez-vous que votre rôle Identity and Access Management inclut les autorisations requises pour créer et afficher des métriques basées sur les journaux, et créer des règles d'alerte. Pour en savoir plus, consultez la page Autorisations de métriques basées sur les journaux.

  2. Assurez-vous de bien connaître les métriques basées sur les journaux. Pour plus d'informations, consultez la page Présentation des métriques basées sur les journaux.

  3. Configurez les canaux de notification que vous souhaitez utiliser pour recevoir des notifications. Pour en savoir plus sur ces étapes, consultez Créer et gérer des canaux de notification

Créer une règle d'alerte sur une statistique de compteur

Une règle d'alerte décrit un ensemble de conditions que vous souhaitez surveiller. Lorsque vous créez une règle d'alerte, vous devez également spécifier ses conditions : quels éléments surveiller et quand envoyer des notifications. Les notifications incluent des informations sur l'incident et des boutons qui vous permettent d'afficher les journaux pertinents et les détails de l'incident :

Affichage du bouton "View logs" (Afficher les journaux) sur une notification.

Pour créer une règle d'alerte qui compare la valeur d'une de compteur basée sur les journaux à un seuil, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Métriques basées sur les journaux.

    Accéder à la page Métriques basées sur les journaux

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

  2. Recherchez la métrique que vous souhaitez surveiller, cliquez sur Plus, puis sélectionnez Créer une alerte à partir de la métrique.

  3. Assurez-vous que le champ Saisissez un filtre Monitoring indique metric.type et resource.type. Si nécessaire, ajoutez une clause resource.type.

    Par exemple, le filtre suivant spécifie une métrique et une ressource :

    metric.type="logging.googleapis.com/byte_count"
AND resource.type="gce_instance"

  4. Dans le menu Fenêtre glissante, nous vous recommandons de sélectionner une valeur d'au moins 10 minutes. En particulier, cette valeur doit être suffisamment grande pour garantir que plusieurs entrées de journal correspondent à votre filtre sont comptabilisés.

    Par exemple, si une métrique basée sur les journaux compte les entrées de journal "heartbeat", qui sont attendues toutes les N minutes, définissez la valeur du menu Période glissante sur 2N minutes ou 10 minutes, la valeur la plus élevée.

  5. Cliquez sur Suivant, puis sélectionnez Seuil.

  6. Saisissez une valeur de seuil et, si vous le souhaitez, configurez le paramètre Champs Déclencheur d'alerte et Position du seuil.

  7. Facultatif : Mettez à jour la fenêtre de nouvelle analyse et utilisez les champs Options avancées pour configurer la façon dont la stratégie d'alerte gère les données manquantes. En règle générale, le paramètre par défaut est approprié.

  8. Cliquez sur Suivant, sur Canaux de notification, puis sélectionnez les canaux de notification que vous souhaitez utiliser pour la règle d'alerte.

  9. Facultatif: dans la section Documentation, saisissez les informations que vous souhaitez inclure dans les notifications. En général, ces informations indiquent comment répondre à la notification.

  10. Dans le champ Nom de la règle d'alerte, saisissez un nom pour la règle d'alerte.

  11. Cliquez sur Créer une règle.

Dépannage

Si vous rencontrez des problèmes, consultez la page Résoudre les problèmes liés aux métriques basées sur les journaux.

Étape suivante