Benutzerdefinierte Messwerte sind von Nutzern definierte Messwerte. Für benutzerdefinierte Messwerte werden dieselben Elemente verwendet wie für die integrierten Cloud Monitoring-Messwerte:
- Eine Reihe von Datenpunkten.
- Informationen zum Messwerttyp, die Aufschluss darüber geben, für was die Datenpunkte stehen.
- Informationen zu überwachten Ressourcen, die Aufschluss über den Ursprung der Datenpunkte geben.
Benutzerdefinierte Messwerte werden genauso verwendet wie integrierte Messwerte. Das heißt, Sie können Diagramme und Benachrichtigungen für Ihre benutzerdefinierten Messwertdaten erstellen.
Eine Einführung in die Strukturen, die sowohl den integrierten als auch den benutzerdefinierten Messwerten zugrunde liegen, finden Sie unter Messdaten, Zeitachsen und Ressourcen. Informationen zu den integrierten Messwerten finden Sie in der Messwertliste. Informationen zu den verfügbaren überwachten Ressourcen finden Sie in der Ressourcenliste.
Benutzerdefinierte Messwerte verwenden
Zur Verwendung eines benutzerdefinierten Messwerts benötigen Sie einen Messwertdeskriptor für den neuen Messwerttyp. Der Messwertdeskriptor definiert, wie Ihre Daten organisiert sind. Bevor Sie benutzerdefinierte Messwertdaten schreiben, sollten Sie festlegen, wie Sie die erfassten Daten verwenden möchten, und prüfen, ob die Datenorganisation diese Ziele unterstützt.
Messwertdeskriptor erstellen
Sie können den Messwertdeskriptor von Cloud Monitoring automatisch erstellen lassen oder die Methode metricDescriptors.create
in der Monitoring API verwenden, um ihn selbst zu erstellen. Sie können Messwertdeskriptoren nicht mithilfe der Google Cloud Console für Monitoring bearbeiten.
Damit Cloud Monitoring den Messwertdeskriptor automatisch erstellt, müssen Sie einfach Zeitachsendaten für Ihren Messwert schreiben. Cloud Monitoring erstellt dann auf Grundlage der geschriebenen Daten einen Deskriptor. Weitere Informationen finden Sie unter Messwertdeskriptoren automatisch erstellen. Für das automatischen Erstellen gelten gewisse Einschränkungen. Daher ist es hilfreich zu wissen, welche Informationen in eine Messwertdefinition einfließen. Nachdem Sie oder Stackdriver Monitoring einen neuen benutzerdefinierten Messwertdeskriptor erstellt haben, können den Messwertdeskriptor mit den API-Methoden des Messwertdeskriptors und den API-Methoden der Zeitachse verwenden.
Unabhängig davon, ob Sie den Messwertdeskriptor explizit erstellen oder von Monitoring basierend auf Ihren Daten für Sie erstellen lassen, müssen Sie immer sicherstellen, dass die Organisation der Daten den gewünschten Abfragen entspricht.
Daten organisieren
Angenommen, Sie haben ein Programm, das auf einer einzelnen Maschine ausgeführt wird, und das Programm ruft die Hilfsprogramme A
und B
auf. Sie möchten zählen, wie häufig Programme A
und B
aufgerufen werden. Sie möchten auch wissen, wann das Programm A
mehr als zehnmal pro Minute aufgerufen wird und wenn das Programm B
mehr als fünfmal pro Minute aufgerufen wird.
Gehen wir davon aus, dass Sie nur ein Google Cloud-Projekt haben und die überwachte Ressource global
verwenden möchten, um die Diskussion zu vereinfachen. Weitere Informationen zu dieser Auswahl finden Sie unter Überwachte Ressourcen für benutzerdefinierte Messwerte.
Ziehen Sie die folgenden Ansätze in Betracht:
Sie verwenden zwei benutzerdefinierte Messwerttypen:
Metric-type-A
zählt die Aufrufe des ProgrammsA
undMetric-type-B
zählt die Aufrufe für das ProgrammB
. In diesem Fall enthaltenMetric-type-A
undMetric-type-B
jeweils eine Zeitachse.Mit diesem Datenmodell können Sie eine einzelne Benachrichtigungsrichtlinie mit zwei Bedingungen oder zwei Benachrichtigungsrichtlinien mit jeweils einer Bedingung erstellen. Eine Benachrichtigungsrichtlinie kann mehrere Bedingungen unterstützen, hat aber eine einzige Konfiguration für die Benachrichtigungskanäle.
Dieses Modell eignet sich möglicherweise, wenn Sie nicht an den Ähnlichkeiten der Daten zwischen den beobachteten Aktivitäten interessiert sind. In diesem Beispiel sind die Aktivitäten die Rate, nach der die Programme
A
undB
aufgerufen werden.Sie verwenden einen einzelnen benutzerdefinierten Messwerttyp und verwenden ein Label mit dem Wert
A
oderB
. Da Monitoring eine Zeitachse für jede einmalige Kombination von Labels erstellt, gibt es zwei Zeitachsen für diesen einzelnen Messwerttyp.Wie beim vorherigen Modell können Sie eine einzelne Benachrichtigungsrichtlinie oder zwei Benachrichtigungsrichtlinien erstellen. Allerdings sind die Bedingungen für die Benachrichtigungsrichtlinie komplexer. Damit eine Bedingung erstellt wird, die einen Vorfall generiert, wenn die Häufigkeit von Aufrufen für das Programm
A
einen Schwellenwert überschreitet, muss die Bedingung einen Filter mit Datenpunkten enthalten, deren LabelwertA
alle anderen Datenpunkte ausschließt.Ein Vorteil dieses Modells ist, dass die Berechnung von Verhältnissen einfach ist. Beispielsweise können Sie ermitteln, wie viel des Gesamtbetrags durch Aufrufe von
A
verursacht wird.Sie verwenden einen einzelnen benutzerdefinierten Messwerttyp, um die Anzahl der Aufrufe zu zählen, aber Sie nutzen kein Label, um aufzuzeichnen, welches Programm aufgerufen wurde. In diesem Modell gibt es eine einzelne Zeitachse, in der die Daten für die beiden Programme kombiniert werden. Sie können jedoch keine Benachrichtigungsrichtlinie erstellen, die Ihren Zielen entspricht, da die Daten für zwei Programme nicht getrennt werden können.
Benutzerdefinierte Messwertnamen
Beim Erstellen eines benutzerdefinierten Messwerts wird eine String-ID erstellt, die den Messwerttyp darstellt. Dieser String muss unter den benutzerdefinierten Messwerten in Ihrem Google Cloud-Projekt eindeutig sein. Er muss mit einem Präfix beginnen, das ihn als benutzerdefinierten Messwert kennzeichnet. Bei Monitoring werden nur custom.googleapis.com/
und external.googleapis.com/
unterstützt.
Die Verwendung von Präfixen wird nicht unterstützt.
Dem Präfix folgt ein Name, der beschreibt, was Sie erfassen. Weitere Informationen finden Sie unter Namenskonventionen.
Im Folgenden finden Sie Beispiele für die beiden Arten von IDs für Messwerttypen:
custom.googleapis.com/cpu_utilization
custom.googleapis.com/instance/cpu/utilization
Benutzerdefinierte Messwerttypen haben Ressourcennamen, die in allen Projekten bei allen Google Cloud-Ressourcen eindeutig sind. Das Format eines Ressourcennamens für einen Messwerttyp ist:
projects/[PROJECT_ID]/metricDescriptors/[METRIC_TYPE]
Dabei ist METRIC_TYPE
die String-ID des Messwerttyps.
Wenn die benutzerdefinierten Messwertbeispiele im Projekt my-project-id
erstellt wurden, würden ihre Ressourcennamen so lauten:
projects/my-project-id/metricDescriptors/custom.googleapis.com/cpu_utilization
projects/my-project-id/metricDescriptors/custom.googleapis.com/instance/cpu/utilization
Name oder Typ? Im Messwertdeskriptor speichert das Feld name
den Ressourcennamen des Messwerttyps und das Feld type
speichert den String METRIC_TYPE
.
Benutzerdefinierten Messwertdeskriptor definieren
Zum Erfassen benutzerdefinierter Messwertdaten müssen Sie ein MetricDescriptor
-Objekt bereitstellen, mit dem verschiedene Informationen über den Messwert angegeben werden. Cloud Monitoring kann den Deskriptor automatisch für Sie erstellen. Weitere Informationen finden Sie unter Automatische Erstellung von Messwertdeskriptoren.
Wenn Sie den Messwertdeskriptor explizit erstellen möchten, benötigen Sie folgende Informationen:
Wählen Sie wie im vorherigen Abschnitt beschrieben eine ID für den benutzerdefinierten Messwerttyp aus.
Wählen Sie ein Projekt aus, in dem Sie den benutzerdefinierten Messwert festlegen und in das seine Zeitachsendaten geschrieben werden.
Das verwendete Projekt muss außerdem zum Arbeitsbereich gehören, in dem Sie den Messwert beobachten. Wenn Sie denselben Messwert in mehreren Projekten benötigen, geben Sie in jedem Projekt dieselbe Definition dafür an.
Benutzerdefinierte Messwerte für AWS sollten im AWS-Verbindungsprojekt für Ihr AWS-Konto erstellt werden.
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 die Art, den Werttyp und optional Einheiten für den Messwert aus. Nicht alle Werttypen und Messwertarten werden für benutzerdefinierte Messwerte unterstützt. Siehe Werttypen und Messwertarten.
Wählen Sie die Labels für den Messwert aus – den Namen, den Werttyp und die Beschreibung.
Zur Erleichterung der Auswahl können Sie die integrierten Messwerte anzeigen und sich ihre Zeitachsendaten ansehen.
Unter Messwertdeskriptoren manuell erstellen finden Sie auch Codebeispiele zum manuellen Erstellen eines Messwertdeskriptors.
Typ der überwachten Ressource auswählen
Wenn Sie Ihre Daten in eine Zeitachse schreiben, müssen Sie angeben, woher die Daten stammen. Dazu wählen Sie einen Ressourcentyp für die überwachte Ressource aus, der für den Ursprung der Daten steht, und verwenden ihn dann, um den Ursprung genauer zu beschreiben. Die überwachte Ressource ist nicht Teil des Messwerttyps. Die Zeitachsen, in die Sie Daten schreiben, enthalten stattdessen einen Verweis auf den Messwerttyp, der die Daten beschreibt, und einen Verweis auf die überwachte Ressource, der den Ursprung der Daten angibt.
Sehen Sie sich die überwachte Ressource genau an, bevor Sie den Messwertdeskriptor erstellen. Der verwendete Typ der überwachten Ressource wirkt sich darauf aus, welche Labels Sie in den Messwertdeskriptor aufnehmen müssen. Wenn Sie beispielsweise die überwachte Ressource einer VM-Instanz mit Ihren Daten verwenden, benötigen Sie zum Angeben der Instanz kein Messwertlabel. Weitere Informationen finden Sie unter Überwachte Ressourcen für benutzerdefinierte Messwerte.
Jeder Datenpunkt eines Messwerts muss mit dem Objekt einer überwachten Ressource verknüpft sein. Punkte aus verschiedenen überwachten Ressourcenobjekten werden in verschiedenen Zeitachsen gespeichert.
Überwachte Ressourcen für benutzerdefinierte Messwerte
Sie können in Ihren benutzerdefinierten Messwerten nur die folgenden Typen überwachter Ressourcen verwenden:
aws_ec2_instance
: Amazon EC2-Instanzdataflow_job
: Dataflow-Jobgae_instance
: App Engine-Instanzgce_instance
: Compute Engine-Instanz.generic_node
: Benutzerdefinierter Rechenknotengeneric_task
: Benutzerdefinierte Aufgabegke_container
: GKE-Container-Instanz.global
: Verwenden Sie diese Ressource, wenn kein anderer Ressourcentyp geeignet ist. Für die meisten Anwendungsfälle istgeneric_node
odergeneric_task
die bessere Wahl alsglobal
.k8s_cluster
: Kubernetes-Clusterk8s_container
: Kubernetes-Containerk8s_node
: Kubernetes-Knotenk8s_pod
: Kubernetes-Pod
Häufig werden die überwachten Ressourcenobjekte verwendet, die die physischen Ressourcen repräsentieren, auf denen Ihr Anwendungscode ausgeführt wird. Dieser Ansatz bietet verschiedene Vorteile:
- Sie erhalten eine bessere Leistung im Vergleich zur Verwendung eines einzelnen Ressourcentyps.
- Sie vermeiden falsche Dateneinträge, die verursacht werden, wenn mehrere Prozesse in dieselbe Zeitachse schreiben.
- Sie können die Daten Ihres benutzerdefinierten Messwerts mit anderen Messwertdaten aus derselben Ressource gruppieren.
global
im Vergleich zu generischen Ressourcen
Die Ressourcentypen generic_task
und generic_node
sind in Situationen nützlich, in denen keiner der spezifischeren Ressourcentypen geeignet ist.
Der Typ generic_task
eignet sich zum Definieren von aufgabenähnlichen Ressourcen wie Anwendungen. Der Typ generic_node
eignet sich zum Definieren knotenähnlicher Ressourcen wie virtuelle Maschinen.
Beide generic_*
-Typen haben mehrere allgemeine Labels, die Sie zur Definition eindeutiger Ressourcenobjekte verwenden können. Somit lassen sie sich bei Messwertfiltern ganz einfach für Aggregationen und Reduzierungen verwenden.
Im Gegensatz dazu hat der Ressourcentyp global
nur die Labels project_id
und location
. Wenn in einem Projekt viele Quellen für Messwerte vorhanden sind, kann die Verwendung desselben global
-Ressourcenobjekts zu Konflikten und Überschreibungen der Messwertdaten führen.
Messwertdeskriptoren erstellen
Die Daten, die Sie für einen benutzerdefinierten Messwert erfassen, müssen einem Deskriptor für einen benutzerdefinierten Messwerttyp zugeordnet sein. Sie können den Messwertdeskriptor selbst erstellen oder von Monitoring erstellen lassen.
- Unter Messwertdeskriptoren automatisch erstellen wird beschrieben, wie Monitoring Messwertdeskriptoren erstellt.
- Unter Messwertdeskriptoren manuell erstellen finden Sie weitere Informationen und Codebeispiele.
Sie können einen vorhandenen Deskriptor bedingt ändern. Weitere Informationen finden Sie unter Messwertdeskriptoren ändern.
Messwertdeskriptoren automatisch erstellen
Wenn Sie Messwertdaten in einen benutzerdefinierten Messwerttyp schreiben, der noch nicht existiert, wird automatisch ein neuer benutzerdefinierter Messwertdeskriptor erstellt. Dieser neue Messwertdeskriptor entspricht jedoch vielleicht nicht Ihren Vorstellungen, da die automatische Erstellung von Messwertdeskriptoren auf verschiedenen Annahmen und Standardwerten basiert.
Das ist insbesondere während eines Aufrufs von timeSeries.create
der Fall, wenn ein TimeSeries
-Objekt ein Metric
-Objekt enthält, das einen nicht vorhandenen Namen für einen Messwerttyp angibt. Cloud Monitoring erstellt dann einen neuen MetricDescriptor
mit folgenden Feldern:
type
: Der Typ wird aus dem Feldtype
des ObjektsMetric
kopiert.name
: Der Name wird aus der Projekt-ID im Methodenaufruf und aus dem Wert vontype
im ObjektMetric
erstellt.labels
: Die Labels sind die im ObjektMetric
angezeigten Labels. Jeder Labeldeskriptor im neuen Messwertdeskriptor enthält folgende Felder:key
: Der Labelschlüssel im ObjektMetric
.valueType
:STRING
description
: Nicht definiert
metricKind
: Die Standardmesswertart istGAUGE
. Wenn Sie jedoch den ParametermetricKind
desTimeSeries
-Objekts angeben, ist der neue Messwert von dieser Art. Sie können als Art nurGAUGE
oderCUMULATIVE
festlegen.valueType
: Der Werttyp ergibt sich aus dem eingegebenen Wert des zu schreibendenPoint
-Objekts. Dieser mussBOOL
,INT64
,DOUBLE
oderDISTRIBUTION
sein. Wenn Sie im FeldvalueType
desTimeSeries
-Objekts einen Werttyp angeben, muss er mit dem Typ desPoint
-Objekts ü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 benutzerdefinierten Messwerttyp verweisen. In diesem Fall werden die Felder des neuen Typs auf dieselbe Weise festgelegt, mit der Ausnahme, dass die Labels im neuen Messwertdeskriptor die Gesamtheit aller Labels umfassen, die in den Metric
-Objekten sämtlicher Zeitachsen in diesem Aufruf von create
enthalten sind.
Nächster Schritt: Siehe Messwertdaten schreiben.
Messwertdeskriptoren manuell erstellen
Nachdem Sie die Informationen erfasst haben, die Sie zum Erstellen Ihres benutzerdefinierten Messwerttyps benötigen, rufen Sie die Methode metricDescriptors.create
auf und übergeben Sie ein MetricDescriptor
-Objekt.
Weitere Informationen finden Sie unter Messwertdeskriptoren ändern.
Sie erhalten in der Regel einen Fehler, wenn Sie metricDescriptors.create
mit demselben Typnamen wie für einen vorhandenen benutzerdefinierten Messwertdeskriptor aufrufen. Wenn jedoch alle Felder des neuen MetricDescriptor
-Objekts mit den Feldern des vorhandenen Deskriptors identisch sind, wird kein Fehler zurückgegeben, aber der Vorgang ist wirkungslos.
Im folgenden Beispiel erstellen Sie einen benutzerdefinierten Messwert vom Typ "gauge": custom.googleapis.com/stores/daily_sales
. Der Messwert enthält ein einzelnes Dimensionslabel namens store_id
.
Protokoll
Verwenden Sie zum Erstellen eines Messwertdeskriptors die Methode metricDescriptors.create
.
Sie können diese Methode mithilfe des API Explorer-Widgets auf der Referenzseite der Methode ausführen. Weitere Informationen finden Sie unter API Explorer.
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": "CUMULATIVE", "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.
Beim Erstellen eines neuen benutzerdefinierten Messwerts wird das Feld name
in MetricDescriptor
ignoriert und kann ausgelassen 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 beispielsweise den Deskriptor eines Messwerts abrufen möchten, verwenden Sie diesen Namen.
C#
Go
Java
Node.js
PHP
Python
Ruby
Wenn Probleme auftreten, lesen Sie Fehler bei API-Aufrufen beheben.
Nächster Schritt: Siehe Messwertdaten schreiben.
Messwerte löschen
Löschen Sie den Messwertdeskriptor des benutzerdefinierten Messwerts, um diesen zu löschen. Es ist nicht möglich, die Zeitachsendaten aus Ihrem benutzerdefinierten Messwert zu löschen. Durch Löschen des Messwertdeskriptors werden die Daten jedoch unzugänglich. Die Daten laufen ab und werden gemäß der Datenaufbewahrungsrichtlinie gelöscht.
Rufen Sie zum Löschen des benutzerdefinierten Messwertdeskriptors die Methode metricDescriptors.delete
auf.
Protokoll
Verwenden Sie zum Löschen eines Messwertdeskriptors die Methode metricDescriptors.delete
.
Sie können diese Methode mithilfe des API Explorer-Widgets auf der Referenzseite der Methode ausführen. Weitere Informationen finden Sie unter API Explorer.
Sie können nur benutzerdefinierte Messwerttypen löschen.
So löschen Sie den benutzerdefinierten Messwert stores/daily_sales
, den Sie unter Messwertdeskriptor manuell erstellen erstellt haben:
- Rufen Sie die Referenzseite für
metricDescriptors.delete
auf: Geben Sie im API 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#
Go
Java
Node.js
PHP
Python
Ruby
Wenn Probleme auftreten, lesen Sie Fehler bei API-Aufrufen beheben.
Messwertdaten schreiben
Daten können nur in benutzerdefinierte Messwerttypen geschrieben werden. Verwenden Sie zum Schreiben von Daten die Methode timeSeries.create
.
Wenn die Zeitachse bereits vorhanden ist, hängt diese Methode einen neuen Datenpunkt an die vorhandene Zeitachse an. Ist die Zeitachse nicht vorhanden, wird sie durch diese 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 Liste darf maximal 200 Objekte enthalten und jedes Objekt in der Liste muss eine andere Zeitachse angeben:
- Jede Zeitachse wird durch die Felder
metric
undresource
desTimeSeries
-Objekts identifiziert. 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 allen bereits in der Zeitachse enthaltenen Punkten liegen.
- 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
Wenn Sie mehr als einen Punkt in dieselbe Zeitachse schreiben möchten, verwenden Sie für jeden Punkt einen separaten Aufruf der Methode
timeSeries.create
. Schreiben Sie keine Daten in eine einzelne Zeitachse, die nicht schneller als ein Punkt alle 10 Sekunden sind. Wenn Sie Datenpunkte in unterschiedliche Zeitachsen einfügen, besteht keine zeitliche Einschränkung.
Protokoll
Verwenden Sie zum Schreiben von Messwertdaten die Methode timeSeries.create
.
Sie können diese Methode mithilfe des API Explorer-Widgets auf der Referenzseite der Methode ausführen. Weitere Informationen finden Sie unter API Explorer.
So schreiben Sie einen Punkt in den benutzerdefinierten Messwert stores/daily_sales
, der unter Messwertdeskriptoren manuell erstellen erstellt wurde:
- Rufen Sie die Referenzseite für
timeSeries.create
auf. - Geben Sie im API 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 einzige 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#
Go
Java
Node.js
PHP
Python
Ruby
Wenn Probleme auftreten, lesen Sie Fehler bei API-Aufrufen beheben.
Messwertdeskriptoren ändern
Sie können auch timeSeries.create
aufrufen, um neue Labels zu benutzerdefinierten Messwerten hinzuzufügen. Zum Hinzufügen von Labels zum benutzerdefinierten Messwertdeskriptor beziehen Sie diese Labels in die Zeitachsendaten ein.
Wenn das zu schreibende Label gültig ist und nicht dazu führt, dass die Anzahl der Labels im Messwertdeskriptor das Limit von zehn Labels überschreitet, wird das Label hinzugefügt. Die Zeitachsendaten werden dann so geschrieben, als wäre das Label von Anfang an vorhanden gewesen.
Wenn Sie neben dem Hinzufügen neuer Labels noch andere Vorgänge ausführen möchten, müssen Sie den Messwertdeskriptor löschen und neu erstellen. In diesem Fall gehen alle Zeitachsendaten verloren, die zuvor für den alten Messwertdeskriptor erfasst wurden. Weitere Informationen finden Sie unter Messwerte löschen.
Ein Messwert kann nicht umbenannt werden.