Diese Seite wurde von der Cloud Translation API übersetzt.

Zählermesswerte konfigurieren

In diesem Dokument wird erläutert, wie Sie mithilfe von der Google Cloud Console, der Logging API und der Google Cloud CLI.

Mit Zählermesswerten wird gezählt, Anzahl der Logeinträge, die einem bestimmten Filter entsprechen. Sie können beispielsweise einen logbasierten Messwert erstellen, mit dem die Anzahl der Logeinträge gezählt wird, die eine bestimmte Fehlermeldung enthalten. Logbasierte Messwerte können auf ein einzelnes Google Cloud-Projekt angewendet werden oder in einem Log-Bucket.

Eine Übersicht über logbasierte Messwerte finden Sie unter Übersicht über logbasierte Messwerte.

Hinweise

Wenn Sie logbasierte Messwerte verwenden möchten, benötigen Sie ein Google Cloud-Projekt mit Abrechnung aktiviert:
Achten Sie darauf, dass Ihre Rolle für Identity and Access Management die Berechtigungen enthält, die für Folgendes erforderlich sind: Logbasierte Messwerte erstellen und anzeigen sowie Benachrichtigungsrichtlinien erstellen. Weitere Informationen finden Sie unter Berechtigungen für logbasierte Messwerte

Logbasierten Zählermesswert erstellen

Der Messwert zählt die Logeinträge, die durch einen von Ihnen angegebenen Filter identifiziert werden. Sie können reguläre Ausdrücke verwenden Filter verwenden. Wir empfehlen, einen Ressourcentyp anzugeben. Die Die Länge eines Filters darf 20.000 Zeichen nicht überschreiten.

Geben Sie keine vertraulichen Informationen in den Filter ein. Filter werden wie Dienstdaten behandelt.

Console

So erstellen Sie einen Zählermesswert in der Google Cloud Console in Ihrem Google Cloud-Projekt:

Rufen Sie in der Google Cloud Console die Seite Logbasierte Messwerte auf:
Zu Logbasierte Messwerte

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Klicken Sie auf Messwert erstellen. Der Bereich Logmesswert erstellen wird angezeigt.
Legen Sie den Messwerttyp fest: Wählen Sie Zähler aus.
Legen Sie im Abschnitt Details die folgenden Felder fest:
- Name des Logmesswerts: Wählen Sie einen Namen aus, der unter den Logbasierte Messwerte in Ihrem Google Cloud-Projekt erstellen. Für die Benennung gelten einige Einschränkungen. Weitere Informationen dazu finden Sie unter Fehlerbehebung.
- Beschreibung: Geben Sie eine Beschreibung für den Messwert ein.
- Einheiten: Lassen Sie dieses Feld leer oder geben Sie die Zahl 1 ein.
Definieren Sie den Messwertfilter im Abschnitt Filterauswahl.
1. Wählen Sie im Menü Projekt oder Log-Bucket auswählen aus, ob das Messwert zählt die Logeinträge in Ihrem Google Cloud-Projekt oder in einem bestimmten Log-Bucket.
2. Erstellen Sie einen Filter, der nur die Logeinträge erfasst, die Sie in Ihrem Messwert mit der Logging-Abfragesprache zählen möchten. Sie können auch reguläre Ausdrücke verwenden, um Filter des Messwerts zu erstellen.
3. Klicken Sie auf Logsvorschau, um zu sehen, welche Logeinträge Ihrem Filter entsprechen.
(Optional) Fügen Sie im Abschnitt Labels ein Label hinzu. Eine Anleitung zum Erstellen von Labels finden Sie unter Label erstellen.
Klicken Sie auf Messwert erstellen, um den Messwert zu erstellen.

gcloud

Sie können einen logbasierten Messwert ohne benutzerdefinierte Labels erstellen, indem Sie die Methode folgenden Befehl:

gcloud logging metrics create METRIC_NAME \
  --description="METRIC_DESCRIPTION" \
  --log-filter="FILTER" \
  [--bucket-name="BUCKET_NAME"]

Mit dem folgenden Befehl wird beispielsweise ein projektbezogener logbasierter Messwert erstellt. namens error_count.

gcloud logging metrics create error_count \
     --description "Errors in syslog." \
     --log-filter "resource.type=gce_instance AND log_id(\"syslog\") AND severity>=ERROR"

Wenn Sie stattdessen einen logbasierten Messwert auf Bucketebene erstellen möchten, geben Sie das Flag --bucket_name an:

gcloud logging metrics create error_count \
    --description "Errors in syslog." \
    --log-filter "resource.type=gce_instance AND log_id(\"syslog\") AND severity>=ERROR" \
    --bucket-name projects/my-project/locations/global/buckets/my-test-bucket

Anweisungen zur Informationen zum Erstellen von Labels finden Sie unter Labels 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:

Legen Sie für das Feld parent das Projekt oder den Bucket fest, in dem sich der Messwert befindet. noch zu erstellen:
- Geben Sie für einen projektbezogenen logbasierten Messwert das Projekt an:
```
projects/PROJECT_ID
```
- Geben Sie für einen auf Bucket-bezogenen logbasierten Messwert den Bucket an:
```
projects/PROJECT_ID/locations/LOCATION/bucket/BUCKET_ID
```

Legen Sie den Anfragetext auf ein LogMetric-Objekt fest. Mitlesen bei eine Stichprobe -Objekt für einen Zählermesswert:

{
  name:        "my-metric"
  description: "This is my metric."
  filter:      "resource.type=gce_instance AND log_id(\"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 aus, der unter den logbasierten Messwerten 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. Wenn Ihr Messwert Labels hat, Eine Einführung zu Labels finden Sie unter Labels von logbasierten Messwerten. sowie Details zu ihrer Erstellung in der API.

Weitere Informationen finden Sie unter LogMetric-Typ.

Latenz neuer Messwerte

Ihr neuer Messwert erscheint unmittelbar in der Messwertliste des Log-Explorers und in den relevanten Menüs von Monitoring. Die Daten sind in der Regel in weniger als einer Minute verfügbar.

Logbasierte Messwerte prüfen

So listen Sie die benutzerdefinierten logbasierten Messwerte in Ihrem Google Cloud-Projekt auf oder prüfen einen bestimmten Messwert in Ihrem Google Cloud-Projekt:

Console

Rufen Sie in der Google Cloud Console die Seite Logbasierte Messwerte auf:
Zu Logbasierte Messwerte

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Im Bereich Benutzerdefinierte Messwerte werden die benutzerdefinierten logbasierten Messwerte im aktuellen Google Cloud-Projekt angezeigt:
Um die Daten in einem logbasierten Messwert anzusehen, klicken Sie auf den Menü in der Messwertzeile aus und wählen Sie Im Metrics Explorer ansehen aus.

gcloud

So listen Sie die benutzerdefinierten logbasierten Messwerte in Ihrem Google Cloud-Projekt auf: verwenden Sie den folgenden Befehl:

gcloud logging metrics list

So rufen Sie einen benutzerdefinierten logbasierten Messwert in Ihrem Google Cloud-Projekt auf: verwenden Sie den folgenden Befehl:

gcloud logging metrics describe METRIC_NAME

Rufen Sie mit dem folgenden Befehl die Hilfe auf:

gcloud logging metrics --help

Sie können die Zeitachsendaten eines Messwerts nicht aus der Google Cloud CLI lesen.

API

Messwerte auflisten

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

parent: Der Ressourcenname des Google Cloud-Projekts: projects/PROJECT_ID
pageSize: Die maximale Anzahl der Ergebnisse.
pageToken: Ruft die nächste Seite mit Ergebnissen auf. Informationen zur Verwendung von Seitentoken finden Sie unter projects.metrics.list.

Messwertdefinitionen abrufen

Um einen einzelnen benutzerdefinierten logbasierten Messwert abzurufen, verwenden Sie die Methode projects.metrics.get-Objekts. Geben Sie die Parameter der Methode so an:

metricName: Der Ressourcenname des Messwerts:
```
projects/PROJECT_ID/metrics/METRIC_ID
```

Messwertdaten lesen

Zum Lesen der Zeitachsendaten in einem logbasierten Messwert verwenden Sie projects.timeseries.list in der Cloud Monitoring API Weitere Informationen zu Zeitachsendaten finden Sie unter Zeitachsen lesen.

Um einen einzelnen benutzerdefinierten logbasierten Messwert zu lesen, füllen Sie das Feld Parameter mit diesem Messwerttyp und dieser ID:

logging.googleapis.com/user/METRIC_ID

Logbasierte Messwerte aktualisieren

Sie können einen benutzerdefinierten logbasierten Messwert bearbeiten, um seine Beschreibung, und die Namen der Felder, auf die im Messwert verwiesen wird. Sie können dem Messwert neue Labels hinzufügen und die regulären Ausdrücke ändern, mit denen Werte für den Messwert und dessen Labels extrahiert werden. Wenn Sie einen Bucket-bezogenen Messwert verwenden, Aktualisieren Sie den Bucket des Messwerts.

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

So bearbeiten Sie einen logbasierten Messwert:

Console

Rufen Sie in der Google Cloud Console die Seite Logbasierte Messwerte auf:
Zu Logbasierte Messwerte

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Klicken Sie im Drop-down-Menü auf Messwert bearbeiten Speisekarte für den logbasierten Messwert, den Sie ändern möchten.
Ändern Sie nur die zulässigen Elemente des Messwerts.
Klicken Sie auf Messwert aktualisieren.

gcloud

Verwenden Sie die Google Cloud CLI, um die Beschreibung, die Filterabfrage und den Bucket eines Zählermesswerts zu ändern. Sie können einzelne oder alle Felder gleichzeitig aktualisieren.

gcloud logging update METRIC_NAME \
  --description="METRIC_DESCRIPTION" \
  --log-filter="FILTER" \
  --bucket-name=BUCKET_NAME

Wenn Sie den Bucket ändern, der mit einem Bucket-bezogenen Messwert verknüpft ist, gilt Folgendes: Messwertdaten, die vor der Änderung erhoben wurden, entsprechen nicht mehr den aktuelle Konfiguration. Die für den vorherigen Bucket erfassten Messwertdaten nicht entfernt.

Wenn Sie Verteilungsmesswerte oder andere Zählermesswerte (mit Ausnahme von METRIC_NAME) aktualisieren möchten, erstellen Sie eine Datei mit der überarbeiteten Spezifikation Ihrer LogMetric im JSON- oder YAML-Format. Aktualisieren Sie dann die durch Aufrufen des Befehls update mit dem Feld „--config-from-file“ Ersetzen Sie FILENAME durch den Namen Ihrer JSON- oder YAML-Datei:

gcloud logging update METRIC_NAME --config-from-file FILENAME

Rufen Sie mit folgendem Befehl weitere Details ab:

gcloud logging metrics update --help

API

Verwenden Sie zum Bearbeiten eines logbasierten Messwerts die Methode Methode projects.metrics.update in der API verwenden. 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.

Logbasierte Messwerte löschen

So löschen Sie einen benutzerdefinierten logbasierten Messwert:

Console

Rufen Sie in der Google Cloud Console die Seite Logbasierte Messwerte auf:
Zu Logbasierte Messwerte

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Wählen Sie den zu löschenden Messwert aus und klicken Sie auf Löschen.

Alternativ können Sie im Menü Messwert löschen Speisekarte des logbasierten Messwerts, den Sie löschen möchten.

gcloud

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

gcloud logging metrics delete METRIC_NAME

Rufen Sie mit folgendem Befehl weitere Details ab:

gcloud logging metrics delete --help

API

Um einen benutzerdefinierten logbasierten Messwert zu löschen, verwenden Sie den Methode projects.metrics.delete in der API.

Außerdem wird auf der Seite Logbasierter Messwert der Google Cloud Console der Wert Im Bereich Benutzerdefinierte Messwerte der Oberfläche für logbasierte Messwerte finden Sie mehr Funktionen zur Verwaltung der benutzerdefinierten Messwerte auf Ihrer Google Cloud-Projekt Weitere Informationen finden Sie im Bereich "Benutzerdefinierte Messwerte".