Logbasierte Messwerte – Übersicht

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

Mit logbasierten Messwerten können Sie Trends und Muster in einer großen Anzahl von Logeinträgen beobachten. Diese Messwerte werden aus den Logeinträgen abgeleitet, die in Ihrem Google Cloud-Projekt stammen oder über einen Datensammler in einem anderen Projekt an Ihr Google Cloud-Projekt weitergeleitet werden. Sie können beispielsweise einen logbasierten Messwert verwenden, um die Anzahl der Logeinträge zu zählen, die eine bestimmte Nachricht enthalten, oder um in Logeinträgen aufgezeichnete Latenzinformationen zu extrahieren. Sie können logbasierte Messwerte in Cloud Monitoring-Diagrammen anzeigen und diese Messwerte mit Benachrichtigungsrichtlinien überwachen.

Wenn Sie eine Benachrichtigungsrichtlinie zum Überwachen eines logbasierten Messwerts erstellen möchten, sollten Sie sich mit den Einschränkungen dieses Ansatzes vertraut machen. Sehen Sie sich insbesondere den Hilfeartikel Fehlerbehebung: Im Messwert fehlen Logdaten an.

Quellen für logbasierte Messwerte

Sie können die von Cloud Logging definierten Messwerte verwenden, um allgemeine Nutzungsinformationen zu erfassen. Außerdem können Sie eigene logbasierte Messwerte definieren, um Informationen zu erfassen, die für Ihre Anwendung oder Ihr Unternehmen spezifisch sind.

Logbasierte Messwerte können innerhalb eines einzelnen Google Cloud-Projekts oder innerhalb eines Log-Buckets angewendet werden. Sie können keine logbasierten Messwerte für andere Google Cloud-Ressourcen wie Cloud Billing-Konten oder Organisationen erstellen.

Informationen zu den Unterschieden zwischen projektbasierten und bucketbasierten logbasierten Messwerten finden Sie unter Logbasierte Messwerte auf Bucketebene.

Systemdefinierte Messwerte

Logging bietet eine Reihe von Messwerten für Nutzungswerte, z. B. die Anzahl der Logeinträge, die in Log-Buckets in Ihrem Projekt gespeichert sind, oder die Anzahl der von Ihnen exportierten Byte. Eine vollständige Liste der systemdefinierten Messwerte finden Sie unter Google Cloud-Messwerte: Logging.

Benutzerdefinierte Messwerte

Sie können benutzerdefinierte logbasierte Messwerte erstellen, um andere Messwerte zu erfassen, die für Ihr Projekt wichtig sind. Beispiel: Sie können einen logbasierten Messwert erstellen, um die einem bestimmten Filter entsprechenden Logeinträge zu zählen.

Standardmäßig werden benutzerdefinierte logbasierte Messwerte aus allen Logs berechnet, die von der Logging API für das Google Cloud-Projekt empfangen werden, unabhängig von Einschlussfiltern oder Ausschlussfiltern, die für das Google Cloud-Projekt gelten können.

Sie können auch benutzerdefinierte logbasierte Messwerte für einen bestimmten Log-Bucket in einem Google Cloud-Projekt erstellen. Logbasierte Messwerte auf Bucket-Ebene werden aus allen Logs berechnet, die für den Bucket bestimmt sind, unabhängig von ihrem Ursprung. Weitere Informationen finden Sie unter Logbasierte Messwerte für Log-Buckets.

Datentypen für logbasierte Messwerte

Mit logbasierten Messwerten können Daten aus Protokollen extrahiert werden, um Messwerte der folgenden Typen zu erstellen:

  • Zähler: Diese Messwerte zählen die Anzahl der Logeinträge, die innerhalb eines bestimmten Zeitraums mit einem bestimmten Filter übereinstimmen. Verwenden Sie Zähler, wenn Sie verfolgen möchten, wie oft ein Wert oder String in Ihren Protokollen vorkommt.
  • Verteilung: Bei diesen Messwerten werden auch Werte gezählt, die Ergebnisse werden jedoch in Wertebereiche (Histogramm-Buckets) zusammengefasst. Verwenden Sie Verteilungen, wenn Sie Werte wie Latenzen extrahieren möchten.
  • Boolescher Wert: Diese Messwerte erfassen, ob ein Logeintrag mit einem bestimmten Filter übereinstimmt.

Benutzerdefinierte logbasierte Messwerte können Zähler- oder Verteilungsmesswerte sein. Die meisten systemdefinierten logbasierten Messwerte sind Zähler, einige sind jedoch auch boolesch. Die Merkmale von Zählern und Verteilungen werden in den folgenden Abschnitten ausführlicher beschrieben.

Die Daten für einen benutzerdefinierten logbasierten Messwert stammen nur aus Logeinträgen, die nach der Erstellung des Messwerts empfangen wurden. Ein Messwert wird nicht rückwirkend mit Daten aus Logeinträgen gefüllt, die bereits in Logging vorhanden waren.

Logbasierte Systemmesswerte werden nur anhand der eingeschlossenen Logs berechnet. Benutzerdefinierte logbasierte Messwerte werden sowohl anhand der eingeschlossenen als auch anhand der ausgeschlossenen Logs berechnet.

Logging sammelt, wenn es einen passenden Logeintrag erhält, Informationen für logbasierte Messwerte. 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.

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

Zählermesswerten erfassen die Anzahl an Logeinträgen, die mit einem bestimmten Filter übereinstimmen. Sie haben zum Beispiel folgende Möglichkeiten:

  • Zählen der Logeinträge, die eine bestimmte Fehlermeldung enthalten

  • Zählen Sie, wie oft einzelne Nutzer einen Vorgang aufrufen. Dazu suchen Sie nach Lognachrichten, die diesem Muster entsprechen:

    ... user USERNAME called OPERATION ...

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

Weitere Informationen finden Sie unter Zählermesswerte konfigurieren.

Verteilungsmesswerte

Verteilungsmesswerte erfassen numerische Daten aus Logeinträgen, die mit einem Filter übereinstimmen. Die Messwerte enthalten eine Zeitachse mit 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.

Informationen zu Verteilungen und zugehörigen Formaten innerhalb einer Zeitachse und ihrer Visualisierung finden Sie unter Verteilungsmesswerte in Diagrammen darstellen.

Informationen zum Erstellen logbasierter Verteilungsmesswerte finden Sie unter Verteilungsmesswerte konfigurieren.

Ressourcentypen

Wir empfehlen, für Ihre protokollbasierten Messwerte einen einzelnen Ressourcentyp anzugeben. Mit dieser Spezifikation wird sichergestellt, dass die für Ihren protokollbasierten Messwert generierten Zeitreihendaten dem von Cloud Monitoring erwarteten Datenmodell entsprechen. Außerdem wird das Erstellen von Diagrammen und Benachrichtigungsrichtlinien vereinfacht, da keine Unklarheiten darüber bestehen, welche Zeitreihendaten in Diagrammen dargestellt oder überwacht werden.

Angenommen, Sie haben einen logbasierten Messwert mit dem folgenden Filter:

severity>="ERROR"
resource.type="gce_instance"

Cloud Monitoring erkennt, dass diese Daten zu einer Compute Engine-VM-Instanz gehören. Wenn Sie also ein Diagramm für eine VM-Instanz erstellen, wird der logbasierte Messwert in den Menüs als Option aufgeführt. Wenn Sie ein Diagramm für einen anderen Ressourcentyp erstellen, wird der logbasierte Messwert nicht als Option aufgeführt.

Wenn Sie einen logbasierten Messwert erstellen, ohne einen Ressourcentyp anzugeben, wird er in der Überwachung als Option für mehrere Ressourcentypen aufgeführt, auch wenn Sie Einträge aus diesen Ressourcen nicht zählen.

Labels

Logbasierte Messwerte können Labels haben, mit denen mehrere Zeitachsen für den Messwert erfasst werden können. Die Werte für die Labels werden aus den Feldern in den übereinstimmenden Logeinträgen extrahiert. In Logging wird für jede Kombination aus Labelwerten eine separate Zeitachse aufgezeichnet.

Alle logbasierten Messwerte haben ein Standardlabel vom Typ log. Dieses Label enthält den Wert des Teils LOG_ID des Felds logName im Logeintrag, z. B. cloudresourcemanager.googleapis.com%2Factivity.

Logbasierte Systemmesswerte haben vordefinierte Labels, die nicht geändert werden können. Sie können jedoch Labels für benutzerdefinierte Messwerte anpassen. Sie können beispielsweise Labels im logbasierten Messwert verwenden, um den Ordner oder die Organisation zu erfassen, aus dem bzw. der ein Logeintrag stammt, auch wenn logbasierte Messwerte auf Bucketebene nicht für Ordner oder Organisationen erstellt werden können. Weitere Informationen finden Sie unter Labels von logbasierten Messwerten.

Diagramme und Benachrichtigungsrichtlinien in Cloud Monitoring

Sie können Diagramme und Benachrichtigungsrichtlinien in Cloud Monitoring sowohl mit logbasierten Systemmesswerten als auch mit benutzerdefinierten logbasierten Messwerten erstellen. Weitere Informationen finden Sie unter Logbasierte Messwerte auflisten und in Diagrammen darstellen und Benachrichtigungen zu logbasierten Messwerten.

In Cloud Monitoring verwenden logbasierte Messwerte folgende Benennungsmuster:

  • System: logging.googleapis.com/SYSTEM_METRIC_NAME
  • Benutzerdefiniert: logging.googleapis.com/user/USER_METRIC_NAME

Benutzerdefinierte logbasierte Messwerte enthalten den String user.

Sichtbarkeit von Monitoring-Messwertbereichen

Logbasierte Messwerte werden von Cloud Monitoring aufgenommen. Die Sichtbarkeit von Messwertdaten für ein Google Cloud-Projekt wird durch einen Messwertbereich bestimmt. Ein Messwertbereich ist eine Liste von Projekten, die vom Projekt überwacht werden, in dem der Messwertbereich gehostet wird. Das Hostingprojekt wird als Scoping-Projekt bezeichnet.

Standardmäßig beherbergt jedes Projekt einen Messwertbereich, der nur sich selbst umfasst. Ein Projekt ist also ein Scoping-Projekt für sich selbst. Ihre Messwerte, einschließlich logbasierter Messwerte, sind daher nur für Ihr Google Cloud-Projekt sichtbar.

Sie können auch einen Messwertbereich für mehrere Projekte für das Projekt zum Festlegen des Umfangs erstellen. Bei einem Messwertbereich für mehrere Projekte sind die Messwerte aller Projekte im Messwertbereich für das den Bereich festlegende Projekt sichtbar. Was für die einzelnen Projekte in einem Messwertbereich mit mehreren Projekten sichtbar ist, wird durch den Messwertbereich bestimmt, der von jedem dieser Projekte gehostet wird. Wenn sich zwei Projekte in einem Messwertbereich mit mehreren Projekten befinden, bedeutet das nicht, dass jedes Projekt Zugriff auf die Mess- oder Konfigurationsdaten des anderen Projekts hat.

Ein einzelnes Projekt kann auch in mehreren Messwertbereichen erscheinen. Die Messwerte aus einem solchen Projekt sind für die Scoping-Projekte jedes dieser Messwertbereiche sichtbar.

Messwerte, einschließlich logbasierter Messwerte, werden in einem bestimmten Projekt definiert. Wenn dieses Projekt in mehreren Messwertbereichen enthalten ist, sind die Messwerte auch für andere Projekte sichtbar, als das, in dem sie definiert sind. Informationen dazu, wie Messwertbereiche und logbasierte Messwerte auf Bucketebene zusammenwirken, finden Sie unter Projekte und Messwertbereiche.

Weitere Informationen zu Messwertbereichen, einschließlich Messwertbereichen für mehrere Projekte, und zum Projektumfang finden Sie unter:

Preise

Alle benutzerdefinierten logbasierten Messwerte sind eine Klasse von Cloud Monitoring-benutzerdefinierten Messwerten und sind kostenpflichtig. Preisinformationen finden Sie unter Cloud Logging – Preise: Logbasierte Messwerte.

Kontingent

Informationen zu den Kontingenten und Limits für benutzerdefinierte logbasierte Messwerte finden Sie unter Kontingente und Limits.

Fehlerbehebung

Wenn bei der Verwendung logbasierter Messwerte Probleme auftreten, lesen Sie die Informationen unter Fehlerbehebung bei logbasierten Messwerten.