In diesem Dokument wird beschrieben, wie Sie benutzerdefinierte Messwerte erstellen und mithilfe der Cloud Monitoring API. Benutzerdefinierte Messwerte verwenden dieselben Elemente wie das integrierte Cloud Monitoring werden folgende Messwerte verwendet:
- Eine Reihe von Datenpunkten.
- Informationen zum Messwerttyp, die Aufschluss darüber geben, für was die Datenpunkte stehen.
- Informationen zu überwachten Ressourcen, die Aufschluss darüber geben, wo die Datenpunkte entstand.
Benutzerdefinierte Messwerte, auch benutzerdefinierte Messwerte genannt, wie integrierte Messwerte verwendet werden können. Das heißt: können Sie Diagramme und Benachrichtigungen für diese Messwertdaten erstellen.
Logbasierte Messwerte sind eine Klasse benutzerdefinierter Messwerte, mit der Cloud Monitoring API erstellen. Logbasierte Messwerte leiten sich ab Messwertdaten aus Logeinträgen, aber die Monitoring API bietet keine Möglichkeit, anzugeben, wie Messwertdaten aus Logeinträgen extrahiert werden. Verwenden Sie stattdessen Cloud Logging, um logbasierte Messwerte zu erstellen. Wenn Sie Log-basierten Messwerts erstellt Logging die und sendet die Messwertdaten für Sie an Cloud Monitoring. Informationen zum Erstellen logbasierter Messwerte finden Sie in den folgenden Dokumenten:
Zur Instrumentierung Ihrer Anwendung empfehlen wir die Verwendung einer anbieterneutrales, quelloffenes Instrumentierungsframework wie OpenTelemetry und nicht anbieter- und produktspezifischen APIs oder Clientbibliotheken. Informationen zur Instrumentierung Ihrer Anwendung finden Sie unter <ph type="x-smartling-placeholder"></ph> Instrumentierung und Beobachtbarkeit.
Hinweise
Um mehr über die Strukturen zu erfahren, die allen Metriken zugrunde liegen, Siehe Messwerte, Zeitreihen und Ressourcen.
Um Cloud Monitoring verwenden zu können, muss ein Google Cloud-Projekt mit aktivierter Abrechnungsfunktion vorhanden sein. Gehen Sie bei Bedarf so vor:
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
- Achten Sie darauf, dass die Monitoring API aktiviert ist. Weitere Informationen finden Sie unter Monitoring-API aktivieren.
Bei Anwendungen, die außerhalb von Google Cloud ausgeführt werden, Das Google Cloud-Projekt muss Ihre Anwendung authentifizieren. Normalerweise konfigurieren Sie die Authentifizierung, indem Sie ein Dienstkonto für Ihr Projekt und durch Konfigurieren einer Umgebung .
Für Anwendungen, die auf einem Amazon Elastic Compute Cloud-Instanz (Amazon EC2) das Dienstkonto für die Instanz AWS-Verbindungsprojekt
Informationen zum Erstellen eines Dienstkontos finden Sie unter Erste Schritte bei der Authentifizierung
Benutzerdefinierten Messwerttyp erstellen
Um einen benutzerdefinierten Messwert zu erstellen, definieren Sie entweder einen
Objekt MetricDescriptor
der verschiedene Informationen
zur Metrik angibt,
oder Sie schreiben metrische Daten. Wenn Sie Messwertdaten schreiben,
Monitoring erstellt den Messwertdeskriptor für Sie basierend auf
die Struktur der von Ihnen bereitgestellten Daten.
Informationen zum Erstellen eines Messwertdeskriptors finden Sie unter
Messwertdeskriptoren für benutzerdefinierte Messwerte
Messwertdeskriptoren automatisch erstellen
Sie schreiben Messwertdaten, wenn ein Messwertdeskriptor für diesen benutzerdefinierten Messwert existiert, wird automatisch ein Messwertdeskriptor erstellt. Dieser neue Messwertdeskriptor entspricht jedoch vielleicht nicht Ihren Vorstellungen, da die automatische Erstellung von Messwertdeskriptoren auf verschiedenen Annahmen und Standardwerten basiert.
Cloud Monitoring erstellt eine neue MetricDescriptor
, wenn
TimeSeries
-Objekt, das in einem Aufruf von
timeSeries.create
verweist auf einen
Metric
-Objekts, das eine nicht existierende
Name des Messwerttyps.
Cloud Monitoring verwendet die folgenden Regeln, um den Parameter
MetricDescriptor
:
type
: Der Typ wird aus dem ObjektMetric
kopiert.type
.name
: Der Name wird aus der Projekt-ID im Methodenaufruf und aus dem Wert vontype
im ObjektMetric
erstellt.labels
: Die Labels, die im ObjektMetric
angezeigt werden. Jeder Labeldeskriptor im neuen Messwertdeskriptor enthält folgende Felder:key
: Der Labelschlüssel im ObjektMetric
.valueType
:STRING
description
: Nicht definiert
metricKind
: Die Messwertart ist aufGAUGE
festgelegt, sofern Sie nichts angeben. DermetricKind
-Parameter desTimeSeries
-Objekts. Wenn SiemetricKind
angeben, geschieht Folgendes: der neue Messwert diesen Typ hat. Sie können nur angeben,GAUGE
- undCUMULATIVE
-Typen.valueType
: Der Werttyp wird aus dem typisierten Wert desPoint
wird gerade geschrieben. Der Werttyp mussBOOL
sein,INT64
,DOUBLE
oderDISTRIBUTION
. Wenn Sie einen Werttyp in dervalueType
desTimeSeries
Dieser Typ muss mit dem Typ vonPoint
übereinstimmen.unit
: Nicht definiertdescription
:"Auto created custom metric."
.displayName
: Nicht definiert
In einem einzigen timeSeries.create
-Aufruf können Sie mehrere TimeSeries
-Objekte einschließen, die auf denselben nicht vorhandenen Messwerttyp verweisen. In diesem Fall
Die Labels im neuen Messwertdeskriptor bestehen aus der Kombination aller Labels
in den Metric
-Objekten in allen Zeitreihen in diesem Aufruf von
create
.
Nächster Schritt: Siehe Benutzerdefinierte Messwerte schreiben.
Messwertdeskriptoren manuell erstellen
So erstellen Sie einen Messwertdeskriptor:
Ermitteln Sie die Struktur des Messwertdeskriptors. Hilfe bei der Erstellung können Sie die integrierten Messwerte durchsuchen und sehen sich die Zeitreihendaten an:
Wählen Sie einen Messwertnamen für den benutzerdefinierten Messwerts.
Wählen Sie einen Anzeigenamen und eine Beschreibung für den Messwert aus. Der Anzeigename wird in der Google Cloud Console verwendet.
Wählen Sie ein oder mehrere Projekte aus, in denen der benutzerdefinierte Messwert definiert werden soll und schreiben ihre Zeitreihendaten. Wenn Sie denselben Messwert in mehreren Projekten benötigen, sollten Sie identische Messwerte verwenden. die Definitionen der Metrik in jedem Projekt.
So schreiben Sie benutzerdefinierte Messwerte aus Ressourcen, die von einem AWS-Konto verwaltet werden: Erstellen Sie den Messwertdeskriptor in der AWS-Verbindungsprojekt für dieses Konto.
Bestimmen Sie die Art, den Werttyp und (optional) die Einheiten des Messwerts. Nicht alle Wert- und Messwerttypen werden unterstützt für benutzerdefinierten Messwerten. Weitere Informationen zu diesen Feldern finden Sie unter Werttypen und Messwertarten:
Wählen Sie die Labels für den Messwert aus – den Namen, den Werttyp und die Beschreibung.
Überwachte Ressourcen bestimmen, für die die Messwertdaten verwendet werden geschrieben. Wählen Sie eine der folgenden Optionen aus:
aws_ec2_instance
: Amazon EC2-Instanz.dataflow_job
: Dataflow-Job.gae_instance
: App Engine-Instanz.gce_instance
: Compute Engine-Instanz.generic_node
: Vom Nutzer angegebener Rechenknoten.generic_task
: Benutzerdefinierte Aufgabe.gke_container
: GKE-Containerinstanz.global
: Verwenden Sie diese Ressource, wenn kein anderer Ressourcentyp geeignet sind. Für die meisten Anwendungsfälle sindgeneric_node
odergeneric_task
bessere Entscheidungen alsglobal
.k8s_cluster
: Kubernetes-Cluster.k8s_container
: Kubernetes-Container.k8s_node
: Kubernetes-Knoten.k8s_pod
: Kubernetes-Pod.
Erstellen Sie ein
MetricDescriptor
-Objekt und übergeben Sie es als ein Argument zu einem Aufruf dermetricDescriptors.create
-Methode.
Beim Aufrufen von
metricDescriptors.create
mit demselben Typ
als vorhandenen Messwertdeskriptor verwenden. Wenn jedoch alle Felder des neuen MetricDescriptor
-Objekts mit den Feldern des vorhandenen Deskriptors exakt identisch sind, entsteht kein Fehler, aber der Vorgang ist wirkungslos.
Im folgenden Beispiel erstellen Sie einen Messwert vom Typ „Tachometer“.
Protokoll
Verwenden Sie zum Erstellen eines Messwertdeskriptors die Methode metricDescriptors.create
.
Sie können diese Methode mit dem APIs Explorer-Widget auf der
Referenzseite der Methode. Siehe APIs Explorer für
erhalten Sie weitere Informationen.
Im Folgenden finden Sie die Beispielparameter für metricDescriptors.create
:
- Name (URL):
projects/[PROJECT_ID]
Anfragetext: Geben Sie ein
MetricDescriptor
-Objekt an. Beispiel:{ "name": "", "description": "Daily sales records from all branch stores.", "displayName": "Sales", "type": "custom.googleapis.com/stores/sales", "metricKind": "GAUGE", "valueType": "DOUBLE", "unit": "{USD}", "labels": [ { "key": "store_id", "valueType": "STRING", "description": "The ID of the store." }, ], }
Geben Sie diese Werte in die Felder des Widgets ein. Ersetzen Sie dabei [PROJECT_ID
durch Ihre Projekt-ID:
Klicken Sie auf die Schaltfläche Ausführen, um die Methode auszuführen.
Wenn Sie einen neuen Messwert erstellen, wird das Feld name
im
MetricDescriptor
wird ignoriert und kann weggelassen werden. Die Methode create
gibt den neuen Messwertdeskriptor mit einem Eintrag im Feld name
zurück. Dieser würde im gegebenen Beispiel so lauten:
"name": "projects/[PROJECT_ID]/metricDescriptors/custom.googleapis.com/stores/daily_sales"
Wenn Sie zum Beispiel einen Messwertdeskriptor abrufen, verwenden Sie diesen Namen.
C#
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Lesen Sie den Abschnitt Fehlerbehebung bei API-Aufrufen, wenn Sie Schwierigkeitsgrad.
Nächster Schritt: Siehe Benutzerdefinierte Messwerte schreiben.
Benutzerdefinierte Messwerte schreiben
Sie können Daten nur in Messwerttypen für benutzerdefinierte Messwerte schreiben. Verwenden Sie zum Schreiben von Daten die Methode timeSeries.create
.
Wenn die Zeitreihe vorhanden ist,
hängt einen neuen Datenpunkt an die vorhandene Zeitachse an. Wenn der Parameter
nicht vorhanden ist, wird sie mit dieser Methode erstellt und die Daten werden angehängt.
Zum Schreiben von Datenpunkten übergeben Sie eine Liste mit Objekten vom Typ TimeSeries
an die Methode timeSeries.create
.
Die maximale Listengröße beträgt 200
und jedes Objekt in der Liste muss eine andere Zeitreihe angeben:
- Die Werte der Felder
metric
undresource
geben einen bestimmtenTimeSeries
-Objekt. Diese Felder stellen den Messwerttyp der Daten und die überwachte Ressource dar, aus der die Daten erfasst wurden. - Lassen Sie die Felder
metricKind
undvalueType
weg. Sie werden beim Schreiben von Datenpunkten ignoriert. Jedes
TimeSeries
-Objekt darf nur ein einzigesPoint
-Objekt enthalten:- Der Wert und das Zeitintervall des Punkts müssen mit der Definition des Messwerttyps übereinstimmen. Informationen zu Zeitintervallen für unterschiedliche Messwertarten finden Sie unter
TimeInterval
. - Das Zeitintervall des Punkts muss nach jedem Punkt liegen, der bereits in der Zeitreihe.
- Das Ende des Intervalls darf maximal 25 Stunden in der Vergangenheit oder fünf Minuten in der Zukunft liegen.
- Der Wert und das Zeitintervall des Punkts müssen mit der Definition des Messwerttyps übereinstimmen. Informationen zu Zeitintervallen für unterschiedliche Messwertarten finden Sie unter
Um mehr als einen Punkt in dieselbe Zeitachse zu schreiben, verwenden Sie einen separater Aufruf von
timeSeries.create
für jeden Punkt. Schreiben Sie Daten nicht schneller als 1 Punkt alle 5 Sekunden. Wenn Sie Daten hinzufügen auf verschiedene Zeitreihen verweist, gibt es keine Ratenbegrenzung.
Protokoll
Verwenden Sie zum Schreiben von Messwertdaten die Methode timeSeries.create
.
Sie können diese Methode mit dem APIs Explorer-Widget auf der
Referenzseite der Methode. Siehe APIs Explorer
.
Um einen Punkt in den Messwert stores/daily_sales
zu schreiben, der im
Messwertdeskriptoren manuell erstellen:
- Rufen Sie die Referenzseite für
timeSeries.create
auf. - Geben Sie im APIs Explorer-Widget die unten aufgeführten Parameter an.
- Klicken Sie auf die Schaltfläche Ausführen.
Verwenden Sie folgende Beispielparameter:
- Name:
projects/[PROJECT_ID]
Anfragetext: Fügen Sie eine Liste mit
TimeSeries
-Objekten hinzu. Im folgenden Beispiel ist nur eine Zeitachse in der Liste enthalten.{ "timeSeries": [ { "metric": { "type": "custom.googleapis.com/my_metric", "labels": { "my_label": "my_value" } }, "resource": { "type": "gce_instance", "labels": { "project_id": "[PROJECT_ID]", "instance_id": "1234567890123456789", "zone": "us-central1-f" } }, "points": [ { "interval": { "endTime": "2018-06-01T10:00:00-04:00" }, "value": { "doubleValue": 123.45 } } ] } ] }
C#
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Lesen Sie den Abschnitt Fehlerbehebung bei API-Aufrufen, wenn Sie Schwierigkeitsgrad.
Benutzerdefinierte Messwerte löschen
Wenn Sie einen benutzerdefinierten Messwert löschen möchten, löschen Sie seinen Messwertdeskriptor. Sie können die in Ihrem Google Cloud-Projekt gespeicherten Zeitreihendaten nicht löschen. Allerdings Das Löschen des Messwertdeskriptors macht die Daten unzugänglich. Die Daten laufen ab und werden gemäß der Datenaufbewahrungsrichtlinie gelöscht.
Sie können den Messwertdeskriptor für einen integrierten Messwert nicht löschen.
Rufen Sie zum Löschen des Messwertdeskriptors die Methode
metricDescriptors.delete
-Methode.
Protokoll
Verwenden Sie zum Löschen eines Messwertdeskriptors die Methode metricDescriptors.delete
.
Sie können diese Methode mit dem APIs Explorer-Widget auf der
Referenzseite der Methode. Siehe APIs Explorer
.
So löschen Sie den Messwert stores/daily_sales
, der in folgendem Ordner erstellt wurde:
Messwertdeskriptoren manuell erstellen:
- Rufen Sie die Referenzseite für
metricDescriptors.delete
auf: Geben Sie im APIs Explorer-Widget den Namen des Messwertdeskriptors an:
Name:
projects/[PROJECT_ID]/metricDescriptors/custom.googleapis.com/stores/daily_sales
Klicken Sie auf die Schaltfläche Ausführen.
C#
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Richten Sie zur Authentifizierung bei Monitoring Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Lesen Sie den Abschnitt Fehlerbehebung bei API-Aufrufen, wenn Sie Schwierigkeitsgrad.
Benutzerdefinierten Messwert ändern
Um einen benutzerdefinierten Messwert zu ändern, müssen Sie den
MetricDescriptor
-Objekt, das den Messwert definiert.
Die einzige unterstützte Änderung besteht im Hinzufügen von Labels.
Um einem vorhandenen benutzerdefinierten Messwert Labels hinzuzufügen, verwenden Sie die Methode
timeSeries.create
-Methode und schließen Sie das neue
mit den Zeitreihendaten. Die Labels werden dem Messwert hinzugefügt.
wenn die Labels, die Sie schreiben möchten, gültig sind, und die Gesamtzahl
der Labels sind kleiner als 30.
Die Zeitachsendaten werden dann so geschrieben, als wäre das Label von Anfang an vorhanden gewesen.
Wenn Sie nicht nur neue Labels hinzufügen möchten, müssen Sie Labels löschen und neu erstellen den Messwertdeskriptor. In diesem Fall gehen alle Zeitachsendaten verloren, die zuvor für den alten Messwertdeskriptor erfasst wurden. Weitere Informationen finden Sie unter Löschen Sie benutzerdefinierte Messwerte, um weitere Informationen zu erhalten.
Messwerte können nicht umbenannt werden.
Nächste Schritte
- Messwertnutzung ansehen und verwalten
- Liste der integrierten Messwerte
- Liste der überwachten Ressourcen