Configurer des notifications pour les métriques basées sur les journaux
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce document explique comment configurer les notifications lorsqu'une métrique basée sur les journaux correspond aux critères que vous spécifiez. Ces instructions, qui vous guident dans la création d'une règle d'alerte et la configuration des canaux de notification, concernent 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.
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
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, et pour créer des règles d'alerte.
Pour en savoir plus, consultez Autorisations de métriques basées sur les journaux.
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 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 et les détails de l'incident concernés :
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 :
Dans la console Google Cloud , accédez à 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.
Recherchez la métrique que vous souhaitez surveiller, cliquez sur more_vertPlus, puis sélectionnez Créer une alerte à partir de la métrique.
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"
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 s'assurer que plusieurs entrées de journal correspondant à votre filtre sont comptabilisées.
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 N minutes, définissez la valeur du menu Période mobile sur 2N minutes ou 10 minutes, selon la valeur la plus élevée.
Cliquez sur Suivant, puis sélectionnez Seuil.
Saisissez une valeur de seuil, puis configurez éventuellement les champs Déclencheur d'alerte et Position du seuil.
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 règle générale, le paramètre par défaut convient.
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.
Facultatif : Dans la section Documentation, saisissez les informations à inclure dans les notifications. En général, le contenu indique comment répondre à la notification.
N'incluez pas l'extraction d'étiquettes à 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 à partir des entrées de journal.
Dans le champ Nom de la règle d'alerte, saisissez un nom pour la règle d'alerte.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[],[],null,["# Configure notifications for log-based metrics\n\nThis document explains how to configure notifications when a\nlog-based metric matches criteria that you specify. These instructions,\nwhich guide you through creating an alerting policy and configuring\nnotification channels, are for the Google Cloud console. You can also create\nalerting policies by using the\n[Cloud Monitoring API](/monitoring/alerts/using-alerting-api)\nand by using the Google Cloud CLI command\n[`gcloud alpha monitoring policies`](/sdk/gcloud/reference/alpha/monitoring/policies).\n\nAlerting policies that monitor log-based metrics can't extract data from\nlog entries. If you want a notification to extract data from a log entry,\nthen [create a log-based alert](/logging/docs/alerting/log-based-alerts).\n\nBefore you begin\n----------------\n\n1. Verify that your Identity and Access Management role includes the permissions required to\n create and view log-based metrics, and to create alerting policies.\n For details, see\n [Log-based metric permissions](/logging/docs/access-control#metrics-permissions).\n\n2. Verify that you are familiar with log-based metrics. For more information,\n see [Overview of log-based metrics](/logging/docs/logs-based-metrics).\n\n3. Configure the notification channels that you want to use to receive any\n notifications. For information about these steps, see\n [Create and manage notification channels](/monitoring/support/notification-options).\n\nCreate an alerting policy on a counter metric\n---------------------------------------------\n\nAn alerting policy describes a set of conditions that you want to monitor.\nWhen you create an alerting policy, you must also specify its conditions: what\nis monitored and when to send notifications. Notifications\ninclude information about the incident, and they include buttons that let\nyou view relevant logs and incident details:\n\nTo create an alerting policy that compares the value of a\nlog-based counter metric to a threshold, do the following:\n\n1. In the Google Cloud console, go to the **Log-based Metrics** page:\n\n [Go to **Log-based Metrics**](https://console.cloud.google.com/logs/metrics)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Logging**.\n2. Find the metric that you want to monitor,\n click *more_vert* **More** ,\n and then select **Create alert from metric**.\n\n3. Verify that the **Select a metric** field lists a\n `metric.type` and a `resource.type`. If necessary,\n add a `resource.type` clause.\n\n For example, the following filter specifics a metric and a resource: \n\n metric.type=\"logging.googleapis.com/byte_count\"\n AND resource.type=\"gce_instance\"\n\n4. In the **Rolling window** menu, we recommend that you select a value that\n is at least 10 minutes. In particular, this value should\n be large enough to make sure that multiple log entries that match your\n filter are counted.\n\n For example, if a log-based metric counts \"heartbeat\" log entries,\n which are expected every `N` minutes, then set the value of the\n **Rolling window** menu to `2N` minutes or 10 minutes,\n whichever is larger.\n | **Note:** Log-based metric data can have gaps and those gaps can result in false notifications. Increasing the value of the **Rolling window** menu can reduce the risk of false notifications. For more information, see [Troubleshoot: Metric is missing logs data](/logging/docs/logs-based-metrics/troubleshooting#slow-startup).\n5. Click **Next** , select **Threshold**.\n\n6. Enter a **Threshold value** , and optionally, configure the\n **Alert trigger** and **Threshold position** fields.\n\n7. Optional: Update the **Retest window** and use the\n **Advanced Options** fields to configure how the alerting policy\n handles missing data. Typically, the default setting is appropriate.\n\n8. Click **Next** , click **Notification channels**, and then select the\n notification channels that you want to use for the alerting policy.\n\n9. Optional: In the **Documentation** section, enter any information that\n you want included in notifications. Typically, the information includes\n information about how to respond to the notification.\n\n Don't include label extraction from log entries in your documentation.\n Alerting policies that monitor a log-based metric can't extract data from\n log entries.\n10. In the **Name the alert policy** field,\n enter a name for the alerting policy.\n\n11. Click **Create policy**.\n\nTroubleshooting\n---------------\n\nIf you encounter issues, then see\n[Troubleshoot log-based metrics](/logging/docs/logs-based-metrics/troubleshooting).\n\nWhat's next\n-----------\n\n- For more information about alerting policies, see the following documents:\n\n - [Introduction to alerting](/monitoring/alerts)\n - [Managing alerting policies](/monitoring/alerts/using-alerting-api)\n- To chart your log-based metric, see\n [View your log-based metrics](/logging/docs/logs-based-metrics/view_your_log_based_metrics).\n\n- For information about how to monitor Cloud Logging and Cloud Monitoring\n usage and receive notifications you when you approach the threshold for\n billing, see [Monitor and optimize Google Cloud Observability costs](/stackdriver/docs/observability/pricing-optimize-and-monitor)."]]
