Zählermesswerte erstellen

Auf dieser Seite wird beschrieben, wie Sie mit der Cloud Console, der Logging API und dem gcloud-Befehlszeilentool logbasierte Zählermesswerte erstellen können.

Eine Gesamtübersicht über logbasierte Messwerte einschließlich Informationen zur Fehlerbehebung finden Sie unter Übersicht über logbasierte Messwerte.

Zählermesswert erstellen

Logging-Konsole

So erstellen Sie in der Cloud Console einen logbasierten Zählermesswert:

  1. Klicken Sie in der Cloud Console in der linken Navigationsliste auf Stackdriver Logging > Logbasierte Messwerte oder klicken Sie auf die folgende Schaltfläche:

    Zu "Logbasierte Messwerte"

  2. Wählen Sie oben auf der Seite im Drop-down-Menü das gewünschte Projekt aus.

  3. Klicken Sie oben auf der Seite auf Messwert erstellen. Rechts auf der Seite sehen Sie den Messwerteditor. Links im Anzeigefenster sind Ihre Logs aufgeführt:

    Zählermesswert erstellen

  4. Erstellen Sie im Anzeigebereich eine Abfrage, mit der Sie nur die Logeinträge abrufen, die Sie mit dem Messwert zählen möchten.

    Die einfache Abfrage ist in den Drop-down-Menüs über den Logeinträgen verfügbar. Alternativ können Sie die Oberfläche für erweiterte Abfragen öffnen. Klicken Sie dazu rechts in der Suchleiste auf das Drop-down-Menü und wählen Sie dort In erweiterten Filter umwandeln aus.

    Weitere Informationen finden Sie auf der Seite zur Loganzeige.

  5. Legen Sie im Bereich Metric Editor (Messwerteditor) Werte für die folgenden Felder fest:

    • Name: Wählen Sie einen unter den logbasierten Messwerten Ihres Projekts eindeutigen Namen aus. Für die Benennung gelten einige Einschränkungen. Weitere Informationen dazu finden Sie unter Fehlerbehebung.
    • Description (Beschreibung): Beschreiben Sie den Messwert.
    • Labels: (optional) Klicken Sie zum Hinzufügen von Labels auf Add Item (Element hinzufügen). Weitere Informationen zum Definieren von Labels finden Sie unter Labels von logbasierten Messwerten.
    • Units (Einheiten): Lassen Sie dieses Feld im Fall von Zählermesswerten frei oder tragen Sie die Ziffer 1 ein.
    • Typ: Zähler

  6. Klicken Sie auf Messwert erstellen, um den Messwert zu erstellen.

Logging API

Verwenden Sie zum Erstellen eines Zählermesswerts die Methode provices.metrics.create der Logging API. Sie können die Methode im APIs Explorer ausprobieren. Bereiten Sie die Argumente für die Methode so vor:

  1. Geben Sie im Feld parent das Projekt an, in dem der Messwert erstellt werden soll:

    projects/[PROJECT_ID]

  2. Legen Sie für den Anfragetext ein LogMetric-Objekt fest. Hier ist ein Beispiel für das Objekt:

    {
  name:        "my-metric"
  description: "This is my metric."
  filter:      "resource.type=gce_instance AND logName:\"logs/syslog\"",
  metricDescriptor: {
      labels: [
        {
          key: "my-label",
          valueType: STRING,
          description: "This is my label.",
        }
      ]
  },
  labelExtractors: {
    "my-label":
      "REGEXP_EXTRACT(jsonPayload.someField, \"before ([0-9]+) after\")",
    ...
  },
}

Hinweise:

  • Wählen Sie einen Messwertnamen, der innerhalb der logbasierten Messwerte in Ihrem Projekt einmalig ist. Für die Benennung gelten einige Einschränkungen. Weitere Informationen dazu finden Sie unter Fehlerbehebung.

  • Bei Zählermesswerten sind die LogMetric-Felder valueExtractor und bucketOptions nicht relevant und werden ausgelassen.

  • Wenn Ihr Messwert keine Labels enthält, können Sie die Felder metricDescriptor und labelExtractors auslassen. Für Messwerte mit Labels finden Sie unter Labels von logbasierten Messwerten eine Einführung zum Thema Labels sowie Einzelheiten zu ihrer Erstellung in der API.

Weitere Informationen finden Sie auf der Seite zum LogMetric-Typ.

Cloud SDK

Das gcloud-Befehlszeilentool unterstützt logbasierte Zählermesswerte ohne Labels. Der Befehl zur Erstellung eines logbasierten Messwerts lautet:

gcloud logging metrics create [METRIC_NAME] [METRIC_DESCRIPTION] [FILTER]

Mit dem folgenden Befehl wird beispielsweise ein logbasierter Zählermesswert namens error_count erstellt.

gcloud logging metrics create error_count \
    --description "Errors in syslog." \
    --log-filter "resource.type=gce_instance AND logName:logs/syslog AND severity>=ERROR"

Wählen Sie einen Messwertnamen, der innerhalb der logbasierten Messwerte in Ihrem Projekt einmalig ist. Für die Benennung gelten einige Einschränkungen. Weitere Informationen dazu finden Sie unter Fehlerbehebung.

Latenz für neue Messwerte

Ihr neuer Messwert erscheint unmittelbar in der Messwertliste der Log-Anzeige und in den relevanten Menüs von Monitoring. Die Daten sollten in weniger als einer Minute zur Verfügung stehen.

Zählermesswerte überprüfen

Gehen Sie wie folgt vor, damit die logbasierten Messwerte Ihres GCP-Projekts aufgeführt werden oder um einen bestimmten Messwert Ihres Projekts zu überprüfen:

Logging-Konsole

Rufen Sie die Seite Logbasierte Messwerte auf. Dort sind alle logbasierten Messwerte des aktuellen Projekts aufgeführt. Klicken Sie hierfür auf folgende Schaltfläche:

Zu "Logbasierte Messwerte"

Wählen Sie im Menü rechts neben dem Messwert die Option In Messwert-Explorer anzeigen aus, um die Daten eines logbasierten Messwerts anzuzeigen.

Logging API

Messwerte auflisten

Verwenden Sie zum Auflisten der benutzerdefinierten logbasierten Messwerte in einem Projekt die API-Methode projects.metrics.list. Geben Sie die Parameter der Methode so an:

  • parent: Ressourcenname des Projekts: projects/[PROJECT_ID].
  • pageSize: Die maximale Anzahl der Ergebnisse.
  • pageToken: Ruft die nächste Seite mit Ergebnissen auf. Siehe projects.metrics.list.

Messwertdefinitionen abrufen

Verwenden Sie zum Abrufen eines einzelnen benutzerdefinierten logbasierten Messwerts die API-Methode projects.metrics.get. Geben Sie die Parameter der Methode so an:

  • metricName: Der Ressourcenname des Messwerts:

    projects/[PROJECT_ID]/metrics/[METRIC_ID]

Messwertdaten lesen

Verwenden Sie zum Lesen der Zeitachsendaten in einem logbasierten Messwert in der Stackdriver Monitoring API die Methode provices.timeseries.list. Weitere Informationen finden Sie unter Messwertdaten lesen. Hier finden Sie die für logbasierte Messwerte erforderlichen Angaben:

  • Der Messwerttyp ist logging.googleapis.com/user/[METRIC_ID].

Cloud SDK

Verwenden Sie den folgenden Befehl, um die benutzerdefinierten logbasierten Messwerte aus Ihrem Projekt aufzulisten:

gcloud logging metrics list

Verwenden Sie den folgenden Befehl, um einen benutzerdefinierten logbasierten Messwert aus Ihrem Projekt anzuzeigen:

gcloud logging metrics describe [METRIC_NAME]

Rufen Sie mit folgendem Befehl weitere Details ab:

gcloud logging metrics --help

Sie können die Zeitachsendaten eines Messwerts nicht aus der Cloud SDK auslesen.

Zählermesswerte aktualisieren

Sie können einen logbasierten Messwert aktualisieren, um die Beschreibung, Abfragen und die Namen von im Messwert angegebenen Feldern zu ändern. Sie können dem Messwert neue Labels hinzufügen und die regulären Ausdrücke ändern, mit denen Werte für den Messwert und seine Labels extrahiert werden.

Sie können die Namen oder Typen von logbasierten Messwerten oder deren Labels nicht ändern und vorhandene Labels in einem logbasierten Messwert nicht löschen.

Gehen Sie zur Bearbeitung oder Aktualisierung eines logbasierten Messwerts wie folgt vor:

Logging-Konsole

  1. Rufen Sie die Seite Logbasierte Messwerte auf:

    Zu "Logbasierte Messwerte"

  2. Klicken Sie im Menü rechts neben dem zu bearbeitenden Log-basierten Messwert auf Messwert bearbeiten.

  3. Ändern Sie nur die zulässigen Elemente des Messwerts.

  4. Klicken Sie auf Fertig.

Logging API

Verwenden Sie zum Bearbeiten oder Aktualisieren eines logbasierten Messwerts in der API die Methode projects.metrics.update. Legen Sie die Felder so fest:

  • metricName: Der vollständige Ressourcenname des Messwerts:

    projects/[PROJECT_ID]/metrics/[METRIC_ID]

    Beispiel:

    projects/my-gcp-project/metrics/my-error-metric

  • Der Anfragetext muss ein LogMetric-Objekt enthalten, das abgesehen von den gewünschten Änderungen und Ergänzungen genau dem vorhandenen Messwert entspricht.

Cloud SDK

Mit dem Cloud SDK können Sie nur die Beschreibung und die Abfrage für einen vorhandenen Messwert ändern.

Verwenden Sie folgenden Befehl, um einen logbasierten Messwert zu aktualisieren. Sie können ein oder beide Flags angeben:

gcloud logging metrics update [METRIC_NAME] --description=[DESCRIPTION] --log-filter=[FILTER]

Rufen Sie mit folgendem Befehl weitere Details ab:

gcloud logging metrics update --help

Zählermesswerte löschen

So löschen Sie einen Log-basierten Messwert:

Logging-Konsole

  1. Rufen Sie die Seite Logbasierte Messwerte auf:

    Zu "Logbasierte Messwerte"

  2. Wählen Sie die zu löschenden Messwerte aus und klicken Sie oben auf der Seite auf Löschen.

    Alternativ können Sie im Menü rechts neben dem zu löschenden Log-basierten Messwert auf Messwert löschen klicken.

Logging API

Verwenden Sie in der API die Methode projects.metrics.delete.

Cloud SDK

Verwenden Sie den folgenden Befehl, um einen benutzerdefinierten logbasierten Messwert im aktuellen Projekt zu löschen:

gcloud logging metrics delete [METRIC_NAME]

Rufen Sie mit folgendem Befehl weitere Details ab:

gcloud logging metrics delete --help