Auf dieser Seite wird erläutert, wie Sie logbasierte Zählermesswerte mit der Konsole, der Logging API und der Google Cloud CLI erstellen.
Weitere Informationen finden Sie unter Übersicht über logbasierte Messwerte.
Zählermesswert erstellen
Wenn Sie einen Filter für die Logeinträge erstellen, die Sie in Ihrem Messwert zählen möchten, können Sie reguläre Ausdrücke verwenden. Beachten Sie, dass ein Filter nicht länger als 20.000 Zeichen sein darf.
Console
Führe die folgenden Schritte aus, um in der Konsole deines Google Cloud-Projekts einen Zählermesswert zu erstellen:
Gehen Sie zur Seite Logging > Logbasierte Messwerte:
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 logbasierten Messwerten Ihres Cloud-Projekts einmalig ist. 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.
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.
Klicken Sie auf Vorschau von Logs, um ein Steuerfeld zu öffnen, das die Logeinträge anzeigt, die 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
Die Google Cloud-Befehlszeile unterstützt logbasierte Zählermesswerte ohne Labels. Der Befehl zur Erstellung eines logbasierten Messwerts lautet:
gcloud logging metrics create METRIC_NAME \ --description "METRIC_DESCRIPTION" \ --log-filter "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 neuen Messwertnamen, der unter den logbasierten Messwerten in Ihrem Cloud-Projekt noch nicht vorhanden ist. Für die Benennung gelten einige Einschränkungen. Weitere Informationen finden Sie unter Fehlerbehebung bei logbasierten Messwerten.
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:
Geben Sie für das Feld parent das Projekt an, in dem der Messwert erstellt werden soll:
projects/PROJECT_ID
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
undbucketOptions
nicht relevant und werden ausgelassen.Wenn Ihr Messwert keine Labels enthält, können Sie die Felder
metricDescriptor
undlabelExtractors
auslassen. Wenn Ihr Messwert über Labels verfügt, finden Sie unter Labels von logbasierten Messwerten eine Einführung zu Labels sowie Einzelheiten zu ihrer Erstellung in der API.
Weitere Informationen finden Sie unter LogMetric-Typ.
Latenz für neue Messwerte
Der neue Messwert wird sofort in der Log-Explorer-Liste der Messwerte und in den entsprechenden Monitoring-Menüs angezeigt. Die Daten sind in der Regel in weniger als einer Minute verfügbar.
Zählermesswerte überprüfen
So listen Sie die benutzerdefinierten logbasierten Messwerte in Ihrem Google Cloud-Projekt auf oder prüfen einen bestimmten Messwert in Ihrem Cloud-Projekt:
Console
Rufen Sie die Seite Logbasierte Messwerte auf:
Weiter zu logbasierten Messwerten
Im Bereich Benutzerdefinierte Messwerte werden die benutzerdefinierten logbasierten Messwerte im aktuellen Cloud-Projekt angezeigt:
Klicken Sie in der Zeile des Messwerts auf das Menü more_vert und wählen Sie In Metrics Explorer ansehen aus, um die Daten eines logbasierten Messwerts anzuzeigen.
gcloud
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 Cloud-Projekt anzuzeigen:
gcloud logging metrics describe METRIC_NAME
Rufen Sie mit dem folgenden Befehl die Hilfe auf:
gcloud logging metrics --help
Sie können keine Zeitachsendaten aus der Google Cloud-Befehlszeile aufrufen.
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 Seitentoken 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 die Methode projects.timeseries.list in der Cloud Monitoring API. Weitere Informationen zu Zeitachsendaten finden Sie unter Zeitachsen lesen.
Wenn Sie einen einzelnen benutzerdefinierten logbasierten Messwert lesen möchten, geben Sie in die Parameter der Methode diesen Messwerttyp und diese Kennung ein:
logging.googleapis.com/user/METRIC_ID
Zählermesswerte aktualisieren
Sie können einen benutzerdefinierten logbasierten Messwert bearbeiten, um dessen Beschreibung, Filter und die Namen der im Messwert angegebenen Felder 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 dessen Labels extrahiert werden.
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 löschen Sie einen logbasierten Messwert:
Console
Rufen Sie die Seite Logbasierte Messwerte auf:
Klicken Sie im Menü more_vert für den logbasierten Messwert, den Sie ändern möchten, auf Messwert bearbeiten.
Ändern Sie nur die zulässigen Elemente des Messwerts.
Klicken Sie auf Messwert aktualisieren.
gcloud
Sie können die Beschreibung und die Abfrage für einen vorhandenen Messwert nur über die Google Cloud-Befehlszeile ä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
API
Verwenden Sie zum Bearbeiten 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.
Zählermesswerte löschen
So löschen Sie einen benutzerdefinierten logbasierten Messwert:
Console
Rufen Sie die Seite Logbasierte Messwerte auf:
Wählen Sie den zu löschenden Messwert aus und klicken Sie auf Löschen.
Alternativ können Sie im Menü more_vert des logbasierten Messwerts, den Sie löschen möchten, auf Messwert löschen klicken.
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
API
Verwenden Sie in der API die Methode projects.metrics.delete, um einen benutzerdefinierten logbasierten Messwert zu löschen.
Auf der Seite Logbasierter Messwert in der Google Cloud Console finden Sie auf der Seite Benutzerdefinierte Messwerte weitere Funktionen, mit denen Sie benutzerdefinierte Messwerte in Ihrem Cloud-Projekt verwalten können. Weitere Informationen finden Sie im Bereich "Benutzerdefinierte Messwerte".