Benachrichtigungen für logbasierte Messwerte konfigurieren
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument wird beschrieben, wie Sie Benachrichtigungen konfigurieren, wenn ein logbasierter Messwert mit von Ihnen angegebenen Kriterien übereinstimmt. Diese Anleitung, in der Sie durch das Erstellen einer Benachrichtigungsrichtlinie und das Konfigurieren von Benachrichtigungskanälen geführt werden, bezieht sich auf die Google Cloud -Konsole. Sie können Benachrichtigungsrichtlinien auch mit der Cloud Monitoring API und mit dem Google Cloud CLI-Befehl gcloud alpha monitoring policies erstellen.
Benachrichtigungsrichtlinien, die logbasierte Messwerte beobachten, können keine Daten aus Logeinträgen extrahieren. Wenn Sie möchten, dass eine Benachrichtigung Daten aus einem Logeintrag extrahiert, erstellen Sie eine logbasierte Benachrichtigung.
Hinweise
Prüfen Sie, ob Ihre IAM-Rolle (Identity and Access Management) die Berechtigungen enthält, die zum Erstellen und Aufrufen von logbasierten Messwerten und zum Erstellen von Benachrichtigungsrichtlinien erforderlich sind.
Weitere Informationen finden Sie unter Berechtigungen für logbasierte Messwerte.
Konfigurieren Sie die Benachrichtigungskanäle, die Sie für Benachrichtigungen verwenden möchten. Informationen zu diesen Schritten finden Sie unter Benachrichtigungskanäle erstellen und verwalten.
Benachrichtigungsrichtlinie für einen Zählermesswert erstellen
Eine Benachrichtigungsrichtlinie beschreibt eine Reihe von Bedingungen, die Sie überwachen möchten.
Bei der Erstellung einer Benachrichtigungsrichtlinie müssen Sie auch deren Bedingungen angeben, d. h. was überwacht und wann eine Benachrichtigung gesendet werden soll. Benachrichtigungen enthalten Informationen zum Vorfall und Schaltflächen, mit denen Sie relevante Logs und Vorfalldetails aufrufen können:
So erstellen Sie eine Benachrichtigungsrichtlinie, die den Wert eines logbasierten Zählermesswerts mit einem Schwellenwert vergleicht:
Rufen Sie in der Google Cloud Console die Seite Logbasierte Messwerte auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Logging ist.
Suchen Sie den Messwert, den Sie im Blick behalten möchten, klicken Sie auf more_vertMehr und wählen Sie dann Benachrichtigung mit dem Messwert erstellen aus.
Prüfen Sie, ob im Feld Messwert auswählen ein metric.type und ein resource.type aufgeführt sind. Fügen Sie bei Bedarf eine resource.type-Klausel hinzu.
Im folgenden Beispiel wird ein Messwert und eine Ressource angegeben:
metric.type="logging.googleapis.com/byte_count"
AND resource.type="gce_instance"
Wir empfehlen, im Menü Rollierendes Fenster einen Wert von mindestens 10 Minuten auszuwählen. Dieser Wert sollte insbesondere groß genug sein, damit mehrere Logeinträge, die Ihrem Filter entsprechen, gezählt werden.
Wenn ein logbasierter Messwert beispielsweise „Heartbeat“-Logeinträge zählt, die alle N Minuten erwartet werden, legen Sie den Wert des Menüs Gleitendes Fenster auf 2N Minuten oder 10 Minuten fest, je nachdem, welcher Wert größer ist.
Klicken Sie auf Weiter und wählen Sie Grenzwert aus.
Geben Sie einen Schwellenwert ein und konfigurieren Sie optional die Felder Benachrichtigungstrigger und Schwellenwertposition.
Optional: Aktualisieren Sie das Retest window (Zeitraum für erneuten Test) und konfigurieren Sie mit den Feldern unter Advanced Options (Erweiterte Optionen), wie die Benachrichtigungsrichtlinie mit fehlenden Daten umgeht. In der Regel ist die Standardeinstellung angemessen.
Klicken Sie auf Weiter, dann auf Benachrichtigungskanäle und wählen Sie die Benachrichtigungskanäle aus, die Sie für die Benachrichtigungsrichtlinie verwenden möchten.
Optional: Geben Sie im Abschnitt Dokumentation alle Informationen ein, die in Benachrichtigungen angezeigt werden sollen. In der Regel enthält der Inhalt Informationen zur Reaktion auf die Benachrichtigung.
Nehmen Sie die Label-Extraktion aus Logeinträgen nicht in Ihre Dokumentation auf.
Benachrichtigungsrichtlinien, die einen logbasierten Messwert überwachen, können keine Daten aus Logeinträgen extrahieren.
Geben Sie im Feld Benachrichtigungsrichtlinie benennen einen Namen für die Benachrichtigungsrichtlinie ein.
Informationen zum Erstellen eines Diagramms für Ihren logbasierten Messwert finden Sie unter Logbasierte Messwerte ansehen.
Informationen dazu, wie Sie die Nutzung von Cloud Logging und Cloud Monitoring überwachen und Benachrichtigungen erhalten, wenn Sie sich dem Grenzwert für die Abrechnung nähern, finden Sie unter Google Cloud Observability-Kosten überwachen und optimieren.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-11 (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)."]]
