Logbasierte Messwerte – Übersicht

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

Logbasierte Messwerte leiten Messwertdaten aus den Logeinträgen ab, die aus Ihrem Google Cloud-Projekt stammen oder an Ihr Google Cloud-Projekt weitergeleitet werden. Mit einem logbasierten Messwert können Sie beispielsweise die Anzahl der Logeinträge zählen, die eine bestimmte Nachricht enthalten, oder Latenzinformationen extrahieren, die in Logeinträgen aufgezeichnet wurden. Sie können logbasierte Messwerte in Cloud Monitoring-Diagrammen und Benachrichtigungsrichtlinien verwenden.

Quellen logbasierter Messwerte

Sie können die von Cloud Logging definierten Messwerte verwenden, um allgemeine Nutzungsinformationen zu erfassen. Sie können auch einen eigenen logbasierten Messwert definieren, um spezifische Informationen für Ihre Anwendung oder Ihr Unternehmen zu erfassen.

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

Informationen zu den Unterschieden zwischen projektbasierten logbasierten und Bucket-basierten logbasierten Messwerten finden Sie unter Logbasierte Messwerte auf Bucket-Ebene.

Systemdefinierte Messwerte

Logging bietet eine Reihe von Messwerten für Nutzungswerte, z. B. die Anzahl der in Log-Buckets in Ihrem Projekt gespeicherten Logeinträge 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 verfolgen, 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.

Benutzerdefinierte logbasierte Messwerte werden standardmäßig aus allen Logs berechnet, die die Logging API für das Google Cloud-Projekt empfangen hat, unabhängig von Einschlussfiltern oder Ausschlussfiltern, die möglicherweise für das Google Cloud-Projekt gelten.

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 für den Bucket bestimmten Logs berechnet, unabhängig davon, woher sie stammen. Weitere Informationen finden Sie unter Logbasierte Messwerte zu Log-Buckets.

Datentypen für logbasierte Messwerte

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

  • Zähler: Mit diesen Messwerten wird die Anzahl der Logeinträge gezählt, die innerhalb eines bestimmten Zeitraums einem bestimmten Filter entsprechen. Verwenden Sie Zähler, wenn Sie verfolgen möchten, wie oft ein Wert oder eine Zeichenfolge in Ihren Logs vorkommt.
  • Verteilung: Mit diesen Messwerten werden auch Werte gezählt, aber die Anzahl wird in Wertebereichen (Histogramm-Buckets) zusammengefasst. Verwenden Sie Verteilungen, wenn Sie Werte wie Latenzen extrahieren möchten.
  • Boolesch: 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 aber auch boolesche Messwerte. Die Eigenschaften 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 sind.

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

Logging sammelt, wenn es einen passenden Logeintrag erhält, Informationen für logbasierte Messwerte. Logging schreibt mit einer Rate von einem Datenpunkt pro Minute einen neuen Datenpunkt in die Zeitachse des Messwerts, um die Daten für Cloud Monitoring verfügbar zu machen.

Jeder Datenpunkt auf der Zeitachse eines logbasierten 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:

  • Anzahl der Logeinträge zählen, 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 Labels verwenden, können Sie später fragen: „Wie oft hat sally den update-Vorgang aufgerufen?“ „Wie viele Personen haben den read-Vorgang aufgerufen?“, „Wie oft hat george einen Vorgang aufgerufen?“ usw.

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 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.

Informationen zu Verteilungen, einschließlich ihres Formats innerhalb einer Zeitachse und ihrer Visualisierung, finden Sie unter Verteilungsmesswerte im Diagramm darstellen.

Informationen zum Erstellen logbasierter Verteilungsmesswerte finden Sie unter Verteilungsmesswerte konfigurieren.

Ressourcentypen

Wir empfehlen, für Ihre logbasierten Messwerte einen einzelnen Ressourcentyp anzugeben. Durch diese Spezifikation wird sichergestellt, dass die für Ihren logbasierten Messwert generierten Zeitreihendaten mit dem von Cloud Monitoring erwarteten Datenmodell übereinstimmen. Außerdem wird das Erstellen von Diagrammen und Benachrichtigungsrichtlinien vereinfacht, da es keine Zweideut darüber gibt, welche Zeitreihendaten grafisch dargestellt oder überwacht werden.

Betrachten Sie einen logbasierten Messwert mit dem folgenden Filter:

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

Cloud Monitoring erkennt, dass diese Daten für eine Compute Engine-VM-Instanz bestimmt sind. Wenn Sie ein Diagramm für eine VM-Instanz erstellen, wird Ihr logbasierter Messwert daher als Option in den Menüs 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 der logbasierte Messwert in Monitoring als Option für mehrere Ressourcentypen aufgeführt, auch wenn Sie keine Einträge für diese Ressourcen 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 von Labelwerten eine separate Zeitachse aufgezeichnet.

Alle logbasierten Messwerte haben ein Standardlabel log. Dieses Label enthält den Wert des Abschnitts 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 aufzuzeichnen, aus dem bzw. der ein Logeintrag stammt, auch wenn logbasierte Messwerte auf Bucket-Ebene nicht für Ordner oder Organisationen erstellt werden können. Weitere Informationen finden Sie unter Logbasierte Messwertlabels.

Diagramme und Benachrichtigungsrichtlinien in Cloud Monitoring

Sie können Diagramme und Benachrichtigungsrichtlinien in Cloud Monitoring sowohl mit system- 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 und die Sichtbarkeit von Messwertdaten für ein Google Cloud-Projekt wird durch einen Messwertbereich bestimmt. Ein Messwertbereich ist eine Liste von Projekten, die von dem Projekt überwacht werden, das den Messwertbereich hostet. Das Hostingprojekt wird als Umfangsprojekt bezeichnet.

Standardmäßig wird in jedem Projekt ein Messwertbereich gehostet, der nur sich selbst umfasst. Ein Projekt legt also den Umfang des Projekts für sich selbst fest. Daher sind Ihre Messwerte, einschließlich logbasierter Messwerte, nur für Ihr Google Cloud-Projekt sichtbar.

Sie können auch einen Messwertbereich mit mehreren Projekten für das den Umfang festlegende Projekt erstellen. Bei einem Messwertbereich mit mehreren Projekten kann das den Umfang festlegende Projekt die Messwerte aller Projekte im Messwertbereich sehen. Was für die einzelnen Projekte in einem Messwertbereich mit mehreren Projekten sichtbar ist, hängt vom jeweiligen Messwertbereich ab, der von jedem dieser Projekte gehostet wird. Die Tatsache, dass sich zwei Projekte in einem Messwertbereich mit mehreren Projekten befinden, bedeutet nicht, dass jedes Projekt Zugriff auf die Messwert- oder Konfigurationsdaten im anderen Projekt hat.

Ein Projekt kann auch in mehreren Messwertbereichen aufgeführt sein. Die Messwerte eines solchen Projekts sind für die Projekte, die den Umfang festlegen, für jeden dieser Messwertbereiche sichtbar.

Metriken, einschließlich logbasierter Messwerte, werden innerhalb eines bestimmten Projekts definiert. Ist das Projekt in mehreren Messwertbereichen aufgeführt, sind die Messwerte für andere Projekte sichtbar als für das, in dem sie definiert sind. Informationen zur Interaktion von Messwertbereichen und logbasierten Messwerten auf Bucket-Ebene 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 benutzerdefinierten Cloud Monitoring-Messwerten und 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.