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 aus Ihrem Google Cloud-Projekt stammen oder Google Cloud-Projekt durch eine Senke in einem anderen Projekt. Mit einem logbasierten Messwert können Sie beispielsweise die Anzahl der Logeinträge, die eine bestimmte Nachricht enthalten, die in Logeinträgen erfassten Latenzinformationen extrahieren. Sie können logbasierte Messwerte in Cloud Monitoring-Diagrammen anzeigen und diese Messwerte mit Benachrichtigungsrichtlinien überwachen.

Wenn Sie eine Benachrichtigungsrichtlinie erstellen möchten, um einen logbasierten Messwert zu überwachen, sollten Sie sich mit den Einschränkungen dieses Ansatzes vertraut machen. Insbesondere Rezension Fehlerbehebung: Im Messwert fehlen Logdaten.

Quellen logbasierter Messwerte

Sie können die von Cloud Logging definierten Messwerte verwenden, um die allgemeine Nutzung zu erfassen Informationen und Sie können Ihren eigenen logbasierten Messwert definieren, um Informationen die für Ihre Anwendung oder Ihr Unternehmen relevant sind.

Logbasierte Messwerte können auf ein einzelnes Google Cloud-Projekt oder in einem Log angewendet werden Bucket. Sie können keine logbasierte Messwerte für andere Google Cloud-Ressourcen wie Cloud Billing-Konten oder -Organisationen.

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

Systemdefinierte Messwerte

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

Benutzerdefinierte Messwerte

Sie können benutzerdefinierte logbasierte Messwerte erstellen, andere Metriken 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.

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 den Einschlussfiltern oder Ausschlussfilter, die auf den Google Cloud-Projekt

Sie können auch benutzerdefinierte logbasierte Messwerte erstellen für einen bestimmten Log-Bucket in einem Google Cloud-Projekt. Bucket-bezogen logbasierte Messwerte aus allen für den Bucket bestimmten Logs berechnet werden, unabhängig davon, woher sie stammen. Weitere Informationen finden Sie unter Logbasierte Messwerte zu Log-Buckets

Datentypen für logbasierte Messwerte

Logbasierte Messwerte können Daten aus Logs extrahieren, um Messwerte des folgenden Typen:

  • Zähler: Diese Messwerte zählen die Anzahl der Logeinträge, die mit einem Filter innerhalb eines bestimmten Zeitraums zu filtern. Verwenden Sie Zähler, wenn Sie die Häufigkeit, mit der ein Wert oder ein String in Ihren Protokollen vorkommt.
  • Verteilung: Mit diesen Messwerten werden auch Werte gezählt, Zählungen in Wertebereiche (Histogramm-Buckets) Verwenden Sie Verteilungen, wenn Sie möchten Werte wie Latenzen extrahieren.
  • 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, aber einige sind den booleschen Typ aus. Die Merkmale von Zählern und Verteilungen sind die in den nachfolgenden Abschnitten ausführlicher beschrieben werden.

Die Daten für einen benutzerdefinierten logbasierten Messwert stammen nur aus Logeinträgen empfangen werden, nachdem der Messwert erstellt wurde. 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 einen neuen Datenpunkt mit einer Rate von einem Datenpunkt pro Minute zur Zeitachse des Messwerts hinzufügen. Daten, die für Cloud Monitoring verfügbar sind.

Jeder Datenpunkt auf der Zeitreihe eines logbasierten Messwerts stellt nur den Wert Zusätzliche Informationen (das Delta), die seit dem vorherigen Datenpunkt empfangen wurden.

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 Sie die 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 Zeitreihe von Verteilungsobjekten, die jeweils mit Folgendem:

  • 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 logbasierten Messwerte einen einzelnen Ressourcentyp anzugeben. Diese Spezifikation stellt sicher, dass die für Ihre logbasierten Messwerts mit dem von Cloud Monitoring erwarteten Datenmodell übereinstimmt. 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 für eine Compute Engine VM-Instanz Wenn Sie also ein Diagramm für eine VM-Instanz erstellen, der logbasierte Messwert als Option in den Menüs aufgeführt. Wenn Sie erstellen Sie ein Diagramm für einen anderen Ressourcentyp, 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. Logging zeichnet separate Zeitreihen auf für jede Kombination von Labelwerten.

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

Logbasierte Systemmesswerte haben vordefinierte die nicht geändert werden können. Sie können jedoch Labels für benutzerdefinierten Messwerten. Beispielsweise können Sie Labels im logbasierten Messwert verwenden, um den Ordner oder Organisation, aus der ein Logeintrag stammt, auch wenn sie auf Bucket-bezogen ist Logbasierte Messwerte können nicht für Ordner oder Organisationen erstellt werden. Weitere Informationen Weitere Informationen finden Sie unter Logbasierte Messwertlabels.

Diagramme und Benachrichtigungsrichtlinien in Cloud Monitoring

Sie können sowohl system- als auch benutzerdefinierte log-basierte Messwerte in Cloud Monitoring zum Erstellen von Diagrammen und Benachrichtigungsrichtlinien 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

Beachten Sie, dass benutzerdefinierte logbasierte Messwerte den String user enthalten.

Sichtbarkeit von Monitoring-Messwertbereichen

Logbasierte Messwerte werden von Cloud Monitoring aufgenommen. 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. der den Messwertbereich hostet. wird das Hostingprojekt Projektumfang festlegen.

Standardmäßig hostet jedes Projekt einen Messwertbereich, beinhaltet nur sich selbst, sodass ein Projekt den Umfang des Projekts für sich selbst festlegt. Daher sind Ihre Messwerte, einschließlich logbasierter Messwerte, nur für Ihr Google Cloud-Projekt

Sie können auch einen Messwertbereich für das Projektumfangs definieren. Bei einem Projektmesswertumfang, der mehrere Projekte umfasst, kann die Metriken aus allen Projekten im Messwertbereich. Was für die einzelnen Projekte in einem Der Messwertbereich mehrerer Projekte wird durch den Messwertbereich bestimmt. die von jedem dieser Projekte durchgeführt werden. Die Tatsache, dass sich zwei Projekte projektübergreifender Messwertbereich bedeutet nicht, dass jedes Projekt Zugriff auf die Messwert- oder Konfigurationsdaten im anderen Projekt.

Ein einzelnes Projekt kann auch in mehreren Messwertbereichen angezeigt werden. Die Metriken aus einem solchen Projekt sind für die den Umfang festlegenden Projekte jedes dieser Messwertbereiche.

Messwerte, einschließlich logbasierter Messwerte, werden innerhalb eines bestimmten Projekts definiert. Erscheint das Projekt in mehreren Messwertbereichen, Die Messwerte sind für andere Projekte als das, in dem sie sich befinden, sichtbar. definiert. Weitere Informationen zu Messwertbereichen und logbasierten Bereichen auf Bucket-Ebene Interaktion von Messwerten 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 Benutzerdefinierte Cloud Monitoring-Messwerte sind kostenpflichtig. Preisinformationen Siehe Cloud Logging – Preise: Logbasierte Messwerte.

Kontingent

Informationen zu den Kontingenten und Limits im Zusammenhang mit benutzerdefinierten 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.