Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

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

Wenn Sie Cloud Monitoring zum ersten Mal verwenden, lesen Sie den Abschnitt Cloud Monitoring auf dieser Seite.

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:

    Zu "Logbasierte Messwerte"

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

Auf der Benutzeroberfläche werden die logbasierten Messwertlisten angezeigt.

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

  • 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 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 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 im 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 Filter Metrics (Messwerte filtern) können Sie Ihre Messwertliste nach Textsuche oder den Messwerten Name, Description (Beschreibung) und Filter{/ filtern. 1}:

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 nützlich, wenn Sie beispielsweise ermitteln möchten, welche Messwerte die meisten Daten aufnehmen oder um Ihre Rechnungen zu schätzen.

  • Sie können Messwerte mit den Optionen Messwert bearbeiten und Messwert löschen im Menü unter 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.

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.

Konfiguration

So konfigurieren Sie einen Cloud Monitoring-Arbeitsbereich für Ihr Projekt:
  1. Wählen Sie in der Cloud Console Ihr Google Cloud-Projekt aus.
    Zur Cloud Console
  2. Wählen Sie im Navigationsbereich Monitoring aus.

    Wenn Sie Cloud Monitoring noch nie verwendet haben, wird beim ersten Zugriff auf Monitoring in der Google Cloud Console automatisch ein Arbeitsbereich erstellt und Ihr Projekt mit diesem Arbeitsbereich verknüpft. Wenn Ihr Projekt nicht mit einem Arbeitsbereich verknüpft ist, wird ein Dialogfeld angezeigt, in dem Sie entweder einen Arbeitsbereich erstellen oder dieses Projekt zu einem vorhandenen Arbeitsbereich hinzufügen können. Wir empfehlen, einen Arbeitsbereich zu erstellen. Klicken Sie nach der Auswahl auf Hinzufügen.

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.