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

Ce document explique comment configurer des notifications lorsqu'une métrique basée sur les journaux correspond aux critères 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 de l'API Cloud Monitoring et de la commande Google Cloud CLI gcloud alpha monitoring policies.

Avant de commencer

  1. Assurez-vous que votre rôle IAM (Identity and Access Management) inclut les autorisations requises pour créer et afficher des métriques basées sur les journaux, et pour 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 en savoir plus, consultez la 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 la page 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, ainsi que 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 métrique 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 contient un metric.type et un 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 élevée pour que plusieurs entrées de journal correspondant à votre filtre soient comptabilisées.

    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 configurez éventuellement les 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 à 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