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

Zählermesswerte erstellen

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

Weitere Informationen finden Sie unter Übersicht über logbasierte Messwerte.

Zählermesswert erstellen

Wenn Sie einen Filter für Logeinträge erstellen, die Sie im Messwert berücksichtigen möchten, können Sie reguläre Ausdrücke verwenden.

Console

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

  1. Klicken Sie in der Cloud Console in der linken Navigationsliste auf Logging > Logbasierte Messwerte der Operations-Suite von Google Cloud 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 Anzeigefeld einen Filter, durch den nur jene Log-Einträge angezeigt werden, die Sie in Ihrem Messwert berücksichtigen möchten.

    Die einfache Abfrage ist in den Drop-down-Menüs über den Logeinträgen verfügbar. Sie können auch auf die erweiterte Abfrageoberfläche zugreifen, wenn Sie auf das Drop-down-Menü rechts in der Suchleiste klicken und In erweiterten Filter umwandeln auswählen.

    Weitere Informationen finden Sie unter Legacy-Loganzeige.

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

    • Name: Wählen Sie einen unter den logbasierten Messwerten Ihres Projekts einmal vorkommenden Namen aus. Für die Benennung gelten einige Einschränkungen. Weitere Informationen dazu finden Sie unter Fehlerbehebung.
    • Beschreibung: Beschreiben Sie den Messwert.
    • Labels: (optional) Klicken Sie zum Hinzufügen von Labels auf 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.

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 für das 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 unter LogMetric-Typ.

GCLOUD

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 Loganzeige und in den relevanten Menüs von Monitoring. Die Daten sind in der Regel in weniger als einer Minute verfügbar.

Zählermesswerte überprüfen

Gehen Sie so vor, damit die logbasierten Messwerte Ihres Google Cloud-Projekts aufgeführt werden oder um einen bestimmten Messwert Ihres Cloud-Projekts zu prüfen:

Console

Rufen Sie die Seite Logbasierte Messwerte auf. Dort sind alle logbasierten Messwerte im aktuellen Cloud-Projekt aufgeführt:

Logbasierte Messwerte aufrufen

Zum Aufrufen der Daten in einem logbasierten Messwert klicken Sie in der Zeile des Messwerts auf das Menü und wählen Sie Im Metrics Explorer ansehen aus.

API

Messwerte auflisten

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

  • parent: Ressourcenname des Cloud-Projekts: projects/[PROJECT_ID].
  • pageSize: Die maximale Anzahl der Ergebnisse.
  • pageToken: Ruft die nächste Seite mit Ergebnissen auf. Informationen zur Verwendung von Seitentokens finden Sie unter 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 Cloud Monitoring API die Methode provices.timeseries.list. Weitere Informationen zu Zeitachsendaten finden Sie unter Zeitachsen lesen.

Wenn Sie einen einzelnen benutzerdefinierten logbasierten Messwert lesen möchten, geben Sie die Parameter der Methode mit diesem Messwerttyp und dieser Kennung an:

logging.googleapis.com/user/[METRIC_ID]

GCLOUD

Verwenden Sie den folgenden Befehl, um die benutzerdefinierten logbasierten Messwerte in Ihrem Cloud-Projekt aufzulisten:

gcloud logging metrics list

Verwenden Sie den folgenden Befehl, um einen benutzerdefinierten logbasierten Messwert in Ihrem Cloud-Projekt anzuzeigen:

gcloud logging metrics describe [METRIC_NAME]

Hilfe erhalten Sie mit folgendem Befehl:

gcloud logging metrics --help

Die Zeitachsendaten eines Messwerts können Sie nicht aus dem 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.

Namen oder Typen von logbasierten Messwerten und deren Labels können nicht geändert werden. Vorhandene Labels in einem logbasierten Messwert können nicht gelöscht werden.

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

Console

  1. Rufen Sie die Seite Logbasierte Messwerte auf:

    Logbasierte Messwerte aufrufen

  2. Klicken Sie aufMesswert bearbeiten in den Speisekarte für den logbasierten Messwert, den Sie ändern möchten.

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

  4. Klicken Sie auf Fertig.

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.

GCLOUD

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:

Console

  1. Rufen Sie die Seite Logbasierte Messwerte auf:

    Logbasierte Messwerte aufrufen

  2. Wählen Sie den Messwert aus, den Sie löschen möchten, und klicken Sie auf Löschen.

    Alternativ können Sie im Dreipunkt-Menü des zu löschenden logbasierten Messwerts auf Messwert löschen klicken.

API

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

GCLOUD

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

gcloud logging metrics delete [METRIC_NAME]

Rufen Sie mit folgendem Befehl weitere Details ab:

gcloud logging metrics delete --help