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

Pour détecter les problèmes de manière précoce et surveiller les tendances opérationnelles, vous pouvez configurer des règles d'alerte qui vous avertissent lorsqu'une métrique basée sur les journaux dépasse un seuil spécifié. Ces instructions vous guident dans la création d'une règle d'alerte et la configuration de canaux de notification à l'aide de la Google Cloud console. 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 monitoring policies.

Les règles d'alerte qui surveillent les métriques basées sur les journaux ne peuvent pas extraire de données à partir des entrées de journal. Si vous souhaitez qu'une notification extrait des données d'une entrée de journal, alors créez une alerte basée sur les journaux.

Avant de commencer

  1. Vérifiez 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, ainsi que 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 page Présentation des métriques basées sur les journaux.

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

Créer une règle d'alerte sur une métrique 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 : ce qui est surveillé 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 Google Cloud console, 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. Vérifiez que le champ Sélectionner une métrique affiche 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 suffisamment élevée pour comptabiliser plusieurs entrées de journal correspondant à votre filtre et tenir compte du délai d'ingestion, qui peut atteindre 10 minutes.

    Par exemple, si une métrique basée sur les journaux comptabilise les entrées de journal "heartbeat" attendues toutes les sept minutes, définissez la valeur du menu Fenêtre glissante sur au moins 24 minutes. Cette valeur tient compte du délai d'ingestion et de deux échantillons.

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

  6. Saisissez une Valeur de seuil, puis configurez éventuellement les Déclencheur d'alerte et Position du seuil champs.

  7. Facultatif : Mettez à jour la Fenêtre de nouveau test et utilisez les champs Options avancées pour configurer la manière dont la règle 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, puis sur Canaux de notification, et 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 règle générale, cette section inclut des instructions sur la manière de répondre à la notification.

    N'incluez pas l'extraction de libellés à partir des entrées de journal dans votre documentation. Les règles d'alerte qui surveillent une métrique basée sur les journaux ne peuvent pas extraire de données à partir des entrées de journal.

  10. Dans le champ Nommer 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