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 des canaux de notification à l'aide de la consoleGoogle 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 monitoring policies.

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

Avant de commencer

  1. Vérifiez 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 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 les 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 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 : quels éléments surveiller et quand envoyer des notifications. Les notifications incluent des informations sur l'alerte et des boutons qui vous permettent d'afficher les journaux et les détails de l'alerte concernés :

Affichage du bouton "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. Vérifiez que le champ Sélectionner une métrique contient 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 suffisamment élevée pour comptabiliser plusieurs entrées de journal correspondant à votre filtre et pour 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 "battement de cœur" qui sont attendues toutes les sept minutes, définissez la valeur du menu Période mobile 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 champs Déclencheur d'alerte et Position du seuil.

  7. Facultatif : Mettez à jour la période de retest et utilisez les champs Options avancées pour configurer la façon dont la règle d'alerte gère les données manquantes. En général, le paramètre par défaut est approprié.

  8. Cliquez sur Suivant, puis sur Canaux de notification. Sélectionnez ensuite 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, la section inclut des instructions sur la façon de répondre à la notification.

    N'incluez pas l'extraction de libellés à partir des entrées de journaux 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 des entrées de journal.

  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 Résoudre les problèmes liés aux métriques basées sur les journaux.

Étapes suivantes