Übersicht über logbasierte Messwerte

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

Logbasierte Messwerte basieren auf dem Inhalt von Logeinträgen. 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.

Es gibt zwei Arten von logbasierten Messwerten:

  • Systemdefinierte logbasierte Messwerte von Cloud Logging für die Verwendung in allen Google Cloud-Projekten verwenden.
  • Benutzerdefinierte logbasierte Messwerte, die von Ihnen erstellt werden, um Dinge in Ihrem Google Cloud-Projekt zu verfolgen, die für Sie von Interesse sind. Sie können beispielsweise einen logbasierten Messwert erstellen, um die Anzahl der Logeinträge zu zählen, die einem bestimmten Filter entsprechen.

Logbasierte Messwerte gelten nur für ein einzelnes Google Cloud-Projekt. Sie können sie nicht für Log-Buckets oder für andere Google Cloud-Ressourcen wie Cloud-Rechnungskonten oder Organisationen erstellen.

Erste Schritte

Informationen zum Prüfen der erforderlichen Berechtigungen für die Verwendung logbasierter Messwerte in einem Cloud-Projekt finden Sie auf dieser Seite unter Zugriffssteuerung.

Logbasierte Messwerte ansehen

Auf der Seite Logbasierte Messwerte der Google Cloud Console können Sie einen logbasierten Messwert erstellen. Dieser enthält Listen mit allen logbasierten Messwerten für Ihr Cloud-Projekt.

So rufen Sie eine Liste der logbasierten Messwerte für Ihr Google Cloud-Projekt auf:

  1. pageffnen Sie in der Cloud Console die Seite Logbasierte Messwerte:

    Weiter zu logbasierten Messwerten

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

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

Jeder Bereich enthält eine tabellarische Zusammenfassung der Messwerte. In der Zeile jedes Messwerts befindet sich ein Menü mit folgenden Optionen:

  • View in Metrics Explorer (Im Messwert-Explorer ansehen) öffnet den Messwert-Explorer in Cloud Monitoring, um die Daten für einen logbasierten Systemmesswert anzuzeigen.

    Über den Metrics 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 dem 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 zum Erstellen von Benachrichtigungsrichtlinien für logbasierte Messwerte finden Sie unter Benachrichtigungsrichtlinie erstellen.

Bereich "Benutzerdefinierte Messwerte"

Auf der Seite "Logbasierte Messwerte" enthält der Bereich Benutzerdefinierte Messwerte mehrere Features, mit denen Sie die benutzerdefinierten Messwerte in Ihrem Cloud-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 Benutzerdefinierte Messwerte filtern können Sie Ihre Messwertliste nach Textsuche oder den Messwerten Name, Beschreibung und Filter:

  • Die Tabelle der benutzerdefinierten Messwerte enthält die Spalten Nutzung im vorherigen Monat und Nutzung bis zum aktuellen Monat. Diese Nutzungsdaten sind beispielsweise nützlich, wenn Sie ermitteln möchten, welche Messwerte die meisten Daten aufnehmen oder um Ihre Rechnungen zu schätzen.

Durch einen Klick auf einen der Spaltennamen können Sie Daten in aufsteigender oder absteigender Reihenfolge sortieren. Am unteren Ende der Tabelle können Sie außerdem die Anzahl der Zeilen auswählen, die angezeigt werden sollen.

Das Menü für jeden Messwert in Ihrem benutzerdefinierten Messwertbereich enthält zusätzliche Funktionen zum Verwalten Ihrer Messwerte:

Menüoptionen für benutzerdefinierte logbasierte Messwerte.

  • View metric details (Messwertdetails aufrufen): Zeigt den Namen, Typ, Beschreibung und Filter{ des Messwerts an. /1}, Einheiten und Labels, falls definiert.
  • Messwert bearbeiten: Mit dieser Option können Sie bestimmte Felder für den Messwert bearbeiten.
  • Messwert deaktivieren: Hiermit können Sie verhindern, dass der Messwert berechnet wird. Deaktivierte Messwerte können über dasselbe Menü wieder aktiviert werden.
  • Messwert löschen: Hiermit können Sie den Messwert löschen.
  • View logs for metric (Logs für Messwert ansehen): Der Log-Explorer wird geöffnet und der Filter des Messwerts wird im Query Builder ausgefüllt und die Abfrage ausgeführt.

Logbasierte Messwerttypen

Logbasierte Systemmesswerte werden nur aus enthaltenen Logs berechnet. Benutzerdefinierte logbasierte Messwerte werden sowohl aus eingeschlossenen als auch ausgeschlossenen Logs berechnet.

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

Logging sammelt jedes Mal Informationen für einen logbasierten Messwert, wenn er einen passenden Logeintrag erhält. Logging schreibt mit einer Rate von einem 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).

Benutzerdefinierte logbasierte Messwerte können für Zähler- oder Verteilungsmesswerte verwendet werden. Die meisten systemdefinierten logbasierten Messwerte sind Zähler, aber einige davon sind der boolesche Typ.

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

Zählermesswerte

Zählermesswerte zählen die Anzahl der Logeinträge, die einem bestimmten Filter entsprechen. Sie haben zum Beispiel folgende Möglichkeiten:

  • Zählen Sie die Logeinträge, die eine bestimmte Fehlermeldung enthalten.
  • Zählen Sie, wie oft jeder Nutzer einen Vorgang aufruft, indem Sie nach Lognachrichten suchen, die diesem Muster entsprechen:

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

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

Weitere Informationen finden Sie unter Zählermesswerte erstellen.

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 Distributionen, einschließlich ihres Formats innerhalb einer Zeitachse, und ihrer Darstellung finden Sie unter Verteilungsmesswerte darstellen.

Weitere Informationen zum Erstellen logbasierter Verteilungsmesswerte finden Sie unter Verteilungsmesswerte erstellen.

Label

Logbasierte Messwerte können Labels haben, wodurch 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.

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

Benutzerdefinierte logbasierte Messwerte

Benutzerdefinierte logbasierte Messwerte werden von einem Nutzer in einem Google Cloud-Projekt erstellt. Diese Messwerte zählen die Anzahl der Logeinträge, die einem bestimmten Filter entsprechen, oder erfassen bestimmte Werte in den übereinstimmenden Logeinträgen.

Informationen zum Erstellen und Verwalten benutzerdefinierter Messwerte mit der Cloud Console finden Sie unter Zählermesswerte erstellen und Verteilungsmesswerte erstellen. auf.

Logbasierte Systemmesswerte

Logging bietet eine Reihe von Messwerten, die Zähler enthalten. Die Zählermesswerte zeichnen die Anzahl der Logging-Ereignisse auf, die innerhalb eines bestimmten Zeitraums aufgetreten sind. Die Messwerte haben Labels, mit denen die jeweilige Anzahl nach Logname und Wichtigkeitsstufe aufgezeichnet wird.

Eine Liste dieser Messwerte finden Sie unter Google Cloud-Messwerte: Logging.

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 Diagramme und Benachrichtigungen erstellen.

In Cloud Monitoring verwenden logbasierte Messwerte die folgenden Benennungsmuster:

  • System: logging.googleapis.com/<var>SYSTEM_METRIC_NAME</var>
  • Benutzerdefiniert: logging.googleapis.com/user/<var>...</var>

Benutzerdefinierte Messwerte enthalten den String user.

Zugriffssteuerung

Prüfen Sie zum Anzeigen der logbasierten Messwerte Ihres Cloud-Projekts die richtige Rolle und die richtigen Berechtigungen.

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

  • Loggingadministrator (roles/logging.admin ),Projekt-Editor (roles/editor ) undProjektinhaber (roles/owner ) sind allgemeine Rollen, die die Berechtigung zum Erstellen logbasierter Messwerte enthalten (logging.logMetrics.create ).

Weitere Informationen zu Berechtigungen und Rollen finden Sie unter Anleitung zur Zugriffssteuerung.

Preise

Benutzerdefinierte logbasierte Messwerte sind eine Klasse benutzerdefinierter Cloud Monitoring-Messwerte und sind kostenpflichtig.

Preisinformationen finden Sie unter Cloud Logging-Preise: logbasierte Messwerte.

Fehlerbehebung

Wenn bei der Verwendung logbasierter Messwerte Probleme auftreten, finden Sie unter Fehlerbehebung weitere Informationen.