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:
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:
Wählen Sie oben auf der Seite im Drop-down-Menü das gewünschte Projekt aus.
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:
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.
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
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:
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. 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ü more_vert 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
Rufen Sie die Seite Logbasierte Messwerte auf:
Klicken Sie aufMesswert bearbeiten in den Speisekarte more_vert für den logbasierten Messwert, den Sie ändern möchten.
Ändern Sie nur die zulässigen Elemente des Messwerts.
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
Rufen Sie die Seite Logbasierte Messwerte auf:
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ü more_vert 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