Übersicht über logbasierte Messwerte

Diese Seite bietet eine konzeptionelle Übersicht über logbasierte Messwerte.

Logbasierte Messwerte sind Cloud Monitoring-Messwerte, die auf dem Inhalt von Logeinträgen basieren. Sie können mithilfe der Messwerte beispielsweise die Anzahl der Logeinträge mit bestimmten Nachrichten aufzeichnen oder in Logeinträgen enthaltene Angaben zu Latenzen extrahieren. Logbasierte Messwerte eignen sich zur Verwendung in Cloud Monitoring-Diagrammen und Benachrichtigungsrichtlinien.

(Logbasierte) Systemmesswerte sind von Logging vordefiniert. Mithilfe dieser Messwerte wird die Anzahl der Logging-Ereignisse aufgezeichnet, die innerhalb eines bestimmten Zeitraums aufgetreten sind.

Benutzerdefinierte (logbasierte) Messwerte werden von einem Nutzer in einem Projekt erstellt. Mithilfe dieser Messwerte wird die Anzahl der Logeinträge gezählt, die mit einer bestimmten Abfrage übereinstimmen, oder es lassen sich bestimmte Werte in den übereinstimmenden Logeinträgen aufzeichnen. Beim Filtern nach den Logeinträgen, die Sie in Ihrem Messwert zählen möchten, können Sie reguläre Ausdrücke verwenden.

Logging sammelt jedes Mal Informationen für logbasierte Messwerte, wenn es einen passenden Logeintrag erhält. Logging schreibt mit einer Rate von 1 Datenpunkt pro Minute einen neuen Datenpunkt in die Zeitachse des Messwerts, um die Daten Cloud Monitoring zur Verfügung zu stellen.

Die Daten für logbasierte Messwerte stammen aus Logeinträgen, die nach der Erstellung der Messwerte empfangen wurden. Die Messwerte werden nicht mit Daten aus Logeinträgen gefüllt, die bereits vor der Messwerterstellung in Logging vorhanden waren.

Erste Schritte

  1. Gehen Sie in der Cloud Console zur Seite Logging > Logbasierte Messwerte der Operations-Suite von Google Cloud:

    Weiter zur Seite "logbasierte Messwerte"

  2. Wählen Sie oben auf der Seite ein vorhandenes Google Cloud-Projekt aus. Die Listen der logbasierten Messwerte in Ihrem Google Cloud-Projekt werden angezeigt:

Auf der Benutzeroberfläche werden die logbasierten Messwertlisten angezeigt.

Zugriffsteuerung

Der Zugriff auf Google Cloud-Daten wird durch Rollen und Berechtigungen der Identitäts- und Zugriffsverwaltung gesteuert. Es folgt eine Zusammenfassung der allgemeinen Rollen und Berechtigungen, die ein Google Cloud-Projektmitglied benötigt, um auf logbasierte Messwerte zuzugreifen:

  • Mit Logging/Autor von Logkonfigurationen (roles/logging.configWriter) können Sie logbasierte Messwerte auflisten, erstellen, abrufen, aktualisieren und löschen.

  • Mit Logging/Loganzeige (roles/logging.viewer) können Sie vorhandene Messwerte einsehen. Sie können auch die Berechtigungen logging.logMetrics.get und logging.logMetrics.list zu einer benutzerdefinierten Rolle hinzufügen.

  • Mit Monitoring-Betrachter (roles/monitoring.viewer) können Sie die Zeitachsen lesen, die der logbasierte Messwert enthält. Sie können einer benutzerdefinierten Rolle auch die Berechtigung monitoring.timeSeries.list hinzufügen.

  • Logging-Administrator (roles/logging.admin), -Bearbeiter (roles/editor) und -Inhaber (roles/owner) sind Rollen auf breiter Ebene, die die Berechtigung zum Erstellen von logbasierten Messwerten (logging.logMetrics.create) enthalten.

Weitere Informationen finden Sie unter Logging: Zugriffssteuerung.

Oberfläche für logbasierte Messwerte

Die Oberfläche für logbasierte Messwerte ist in zwei Bereiche nach Messwerttyp unterteilt: Systemmesswerte und benutzerdefinierte Messwerte.

Beide Bereiche enthalten eine tabellarische Zusammenfassung der Messwerte. In jeder Tabellenzeile befindet sich ein Menü  mit folgenden Optionen:

Logbasierte Messwerte mit Dreipunkt-Menü.

  • Im Messwert-Explorer ansehen öffnet den Messwert-Explorer von Cloud Monitoring, um die Daten für einen logbasierten Systemmesswert anzusehen.

    Über den Messwert-Explorer können Sie einen Zielmesswert für eine Benachrichtigungsrichtlinie angeben. Im Diagramm neben der Zielregion sehen Sie, welche Daten vom Zielmesswert erfasst werden.

  • Mit der Option Create alert from metric (Benachrichtigung aus Messwert erstellen) können Sie basierend auf Ihrem logbasierten Messwert eine Benachrichtigungsrichtlinie erstellen.

    Wenn Sie diese Option auswählen, wird die Cloud Monitoring-Konsole geöffnet, in der Sie Benachrichtigungsrichtlinien erstellen, bearbeiten und verwalten können. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinie erstellen.

Oberfläche für benutzerdefinierte Messwerte

Auf der Seite "Logbasierte Messwerte" enthält der Bereich Benutzerdefinierte Messwerte mehrere zusätzliche Funktionen, mit denen Sie die benutzerdefinierten Messwerte in einem Projekt verwalten können:

  • Die Tabelle mit den benutzerdefinierten Messwerten enthält die Spalten Name, Beschreibung, Typ und Filter. Diese werden beim Erstellen des Messwerts angegeben.

  • Mithilfe des Feldes Filter Metrics (Messwerte filtern) können Sie Ihre Messwertliste nach Textsuche oder den Messwerten Name, Description (Beschreibung) und Filter filtern:

Die logbasierten Messwertlisten listen die Filteroptionen auf.

  • Die Tabelle der benutzerdefinierten Messwerte enthält die Spalten Nutzung im vorherigen Monat und Nutzung (akt. Monat). Diese Nutzungsmesswerte sind interessant, wenn Sie beispielsweise ermitteln möchten, welche Messwerte die meisten Daten aufnehmen, oder wenn Sie Ihre Rechnungen schätzen lassen möchten.

  • Sie können den Messwert bearbeiten und den Messwert löschen. Verwenden Sie dazu das Menü am Ende einer Tabellenzeile.

Die Daten können zusätzlich in ab- oder aufsteigender Reihenfolge sortiert werden. Klicken Sie dazu auf den jeweiligen Spaltennamen. Am unteren Ende der Tabelle können Sie außerdem die Anzahl der Zeilen auswählen, die angezeigt werden sollen.

Weitere Informationen zum Verwalten benutzerdefinierter Messwerte mit der Cloud Console erhalten Sie unter Zählermesswerte erstellen und Verteilungsmesswerte erstellen.

Übersicht über logbasierte Messwerttypen

Logbasierte Logging-Messwerte können zu einem von zwei Messwerttypen gehören: Zähler oder Verteilung. Alle logbasierten Systemmesswerte gehören zum Zählertyp. Benutzerdefinierte logbasierte Messwerte können entweder zum Zählertyp oder zum Verteilungstyp gehören.

Jeder Datenpunkt auf der Zeitachse des Messwerts repräsentiert nur die seit dem vorherigen Datenpunkt empfangenen zusätzlichen Informationen (das Delta).

In den folgenden Abschnitten werden die Merkmale von Zähler- und Verteilungsmesswerten beschrieben.

Zählermesswerte

Mit Zählermesswerten wird die Anzahl der Logeinträge angegeben, die mit einer erweiterten Logabfrage übereinstimmen. Sie haben zum Beispiel folgende Möglichkeiten:

  • Sie können einen Messwert erstellen, mit dem Logeinträge gezählt werden, die eine bestimmte Fehlermeldung enthalten.
  • Zählen Sie, wie oft jeder Nutzer einen Vorgang aufruft, indem Sie nach folgenden Lognachrichten suchen:

    ... user [USERNAME] called  [OPERATION] ...
    

    Wenn Sie [USERNAME] und [OPERATION] extrahieren und als Werte für zwei Labels verwenden, können Sie später z. B. fragen: "Wie oft hat sally den Vorgang UPDATE aufgerufen?", "Wie viele Personen haben den Vorgang READ aufgerufen?", "Wie oft hat george einen Vorgang aufgerufen?".

Weitere Informationen finden Sie unter Zählermesswerte erstellen.

Verteilungsmesswerte

Verteilungsmesswerte erfassen numerische Daten aus Logeinträgen, die mit einer Abfrage übereinstimmen. Die Messwerte enthalten eine Zeitachse von Verteilungsobjekten, die jeweils Folgendes umfassen:

  • Die Anzahl der Werte in der Verteilung
  • Den Mittelwert der Werte
  • Die Summe der Abweichungen im Quadrat: Summei=1..n(xi–Mittelwert)2
  • Eine Reihe von Histogramm-Buckets mit der Anzahl der Werte in jedem Bucket. Sie können das Standardlayout für Buckets verwenden oder ein eigenes Layout auswählen.

Verteilungsmesswerte werden oft zum Verfolgen von Latenzen genutzt. Aus jedem empfangenen Logeintrag wird unmittelbar ein Latenzwert extrahiert und der Verteilung hinzugefügt. Die akkumulierte Verteilung wird in regelmäßigen Intervallen in Cloud Monitoring geschrieben.

Weitere Informationen finden Sie unter Verteilungsmesswerte erstellen.

Labels

Logbasierte Messwerte können optional Labels haben, wodurch ein einzelner Messwert mehrere Zeitachsen enthalten kann. Die Werte für die Labels werden aus den Feldern in den übereinstimmenden Logeinträgen extrahiert. In Logging wird für jeden unterschiedlichen Wert des Labels eine separate Zeitachse aufgezeichnet.

Die logbasierten Systemmesswerte haben vordefinierte Labels. Sie können für Ihre benutzerdefinierten Messwerte eigene Labels definieren. Weitere Informationen finden Sie unter Logbasierte Messwertlabels.

Logbasierte Systemmesswerte

Logging bietet vordefinierte Zählermesswerte, um die Anzahl und das Volumen der empfangenen Logeinträge zu verfolgen. Die Messwerte haben Labels, mit denen die jeweilige Anzahl nach Logname und Wichtigkeitsstufe aufgezeichnet wird. Eine Auflistung der Messwerte finden Sie in der folgenden Tabelle:

Name und Beschreibung des Messwerts Typ Wert Labels
logging.googleapis.com/log_entry_count

Gesamtzahl empfangener Logeinträge

delta int64 log: Der Name des Logs. Beispiel: "appengine.googleapis.com/request_log".

severity: Die Wichtigkeitsstufe der Logeinträge. Beispiel: "ERROR".

logging.googleapis.com/byte_count

Gesamtzahl der in Logeinträgen empfangenen Byte

delta int64 log: Der Name des Logs. Beispiel: "appengine.googleapis.com/request_log".
logging.googleapis.com/excluded_log_entry_count

Gesamtzahl ausgeschlossener Logeinträge

delta int64
logging.googleapis.com/excluded_byte_count

Gesamtzahl der Byte in ausgeschlossenen Logeinträgen

delta int64
logging.googleapis.com/exports/log_entry_count

Gesamtzahl der Logeinträge, die mithilfe von Senken exportiert wurden

delta int64
logging.googleapis.com/exports/byte_count

Gesamtzahl der Byte in Logeinträgen, die mithilfe von Senken exportiert wurden

delta int64
logging.googleapis.com/exports/error_count

Gesamtzahl der Logeinträge, die aufgrund von Exportkonfigurationsfehlern nicht exportiert wurden

delta int64
logging.googleapis.com/logs_based_metrics_error_count

Die Anzahl der spät ankommenden Logeinträge. 1

delta int64 log: Der Name des Logs. Beispiel: "appengine.googleapis.com/request_log".

1 Logeinträge, die später als 24 Stunden oder früher als 10 Minuten eingehen, werden nicht in die Messwerte log_entry_count oder byte_count einbezogen.

Eine vollständige Liste der logbasierten Systemmesswerte finden Sie unter Logging-Messwerte.

Cloud Monitoring

Sie können Diagramme und Benachrichtigungsrichtlinien in Cloud Monitoring sowohl mit logbasierten Systemmesswerten als auch mit benutzerdefinierten logbasierten Messwerten erstellen. Den Namen Ihrer benutzerdefinierten logbasierten Messwerte wird das Präfix user/ vorangestellt. Bei logbasierten Systemmesswerten ist dies nicht der Fall.

Wenn Sie die Cloud Monitoring API verwenden, lauten die Namen der logbasierten Messwerte so:

logging.googleapis.com/user/[USER_METRIC_NAME]
logging.googleapis.com/[SYSTEM_METRIC_NAME]

Weitere Informationen erhalten Sie unter Diagramme und Benachrichtigungen erstellen.

Fehlerbehebung

Wenn bei der Verwendung logbasierter Messwerte Probleme auftreten, lesen Sie den Abschnitt Fehlerbehebung.