Namenskonventionen für Messwerte

In diesem Dokument werden die Namenskonventionen beschrieben, die Cloud Monitoring für Messwerte durchsetzt.

Name der Messwertressource

Der Ressourcenname für einen Messwerttyp besteht aus einem String mit drei primären Unterstrukturen:

Eine Kennung für ein bestimmtes Projekt.
Eine Markierung, die immer auf metricDescriptors gesetzt ist, um anzuzeigen, dass der String einen Messwertdeskriptor darstellt.
Der Messwerttyp.

Ressourcennamen für Messwerttypen folgen diesem Muster:

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

Der Teilstring METRIC_TYPE ist eine Kennung für den Messwerttyp. Es gibt verschiedene Formate, zum Beispiel:

agent.googleapis.com/agent/api_request_count
compute.googleapis.com/firewall/dropped_bytes_count
istio.io/service/client/received_bytes_count
kubernetes.io/anthos/APIServiceOpenAPIAggregationControllerQueue1_adds

Im Messwertdeskriptor speichert das Feld name den Ressourcennamen des Messwerttyps und das Feld type den Teilstring METRIC_TYPE.

Die folgende Tabelle zeigt, wie Sie die in einem Ressourcennamen enthaltenen METRIC_TYPE-Teilstrings parsen:

Mögliche Strukturen	Beschreibung
`SERVICE_NAME`¹`.googleapis.com/PATH`²	Messwerte aus Google Cloud-Produkten und -Diensten. Eine vollständige Liste dieser Messwerte finden Sie unter Google Cloud-Messwerte.
`agent.googleapis.com/SERVICE_NAME`¹`/PATH`²	Messwerte aus den Monitoring- und Logging-Agents, die auf VM-Instanzen in Google Cloud oder AWS ausgeführt werden. Eine vollständige Liste dieser Messwerte finden Sie unter Agent-Messwerte.
`kubernetes.io/anthos/PATH`²	Messwerte aus GKE Enterprise, einem Google Cloud-Dienst, mit dem Sie Kubernetes-Cluster sowohl lokal als auch in der Cloud ausführen können. Eine vollständige Liste dieser Messwerte finden Sie unter Anthos-Messwerte.
`aws.googleapis.com/SERVICE_NAME`¹`/PATH`²	Messwerte aus Amazon Web Services Eine vollständige Liste dieser Messwerte finden Sie unter AWS-Messwerte.
`istio.io/PATH`²	Messwerte aus Istio für Google Cloud Eine vollständige Liste dieser Messwerte finden Sie unter Istio-Messwerte.
`kubernetes.io/PATH`²	Messwerte aus Google Kubernetes Engine Eine vollständige Liste dieser Messwerte finden Sie unter Kubernetes-Messwerte.
`knative.dev/PATH`²	Messwerte aus Knative. Eine vollständige Liste dieser Messwerte finden Sie unter Knative-Messwerte.
`external.googleapis.com/EXT_SERVICE/PATH`² `external.googleapis.com/prometheus/PATH`²	Benutzerdefinierte Messwerte von Drittanbietern wie Prometheus Dieses Open-Source-Monitoring-Tool wird häufig mit Kubernetes verwendet. Weitere Informationen zu diesen Messwerten finden Sie unter Externe Messwerte. Sie können diese Messwerttypen nur in Projekten verwenden, die sie definieren.
`custom.googleapis.com/PATH`² `external.googleapis.com/user/PATH`²	Benutzerdefinierte Messwerte: Sie können diese Messwerttypen nur in Projekten verwenden, in denen Sie sie definieren.
`logging.googleapis.com/PATH`²	Logbasierte Messwerte aus Cloud Logging Sie können vordefinierte Messwerte verwenden oder benutzerdefinierte Messwerte erstellen. Benutzerdefinierte Messwerte können nur in Projekten verwendet werden, in denen Sie sie definieren.

¹ SERVICE_NAME gibt ein Google Cloud-Produkt wie compute für Compute Engine an.
² PATH gibt den Messwert im Produkt an, z. B. instance/cpu/utilization.

Regeln für Messwerttypen und -labels

Diese Liste enthält Regeln, die Sie beim Erstellen benutzerdefinierter Messwerttypen beachten müssen. Labels, die einem Messwerttyp zugeordnet sind, werden als Schlüssel/Wert-Paare vom Typ LabelDescriptor angegeben. Der Schlüssel fungiert als Name des Labels.

Messwerttypen
- Verwenden Sie im String Groß- und Kleinbuchstaben (A-Z, a-z), Ziffern (0-9), Punkte (.) und Unterstriche (_).
- Verwenden Sie Schrägstriche (/), um Pfadelemente voneinander zu trennen.
- Sie müssen jedes Pfadelement mit einem Buchstaben oder einer Ziffer beginnen.
- Die maximale Länge eines Messwerttyp-Strings beträgt 200 Zeichen.
Labelschlüssel
- Verwenden Sie Kleinbuchstaben (a-z), Ziffern (0-9) und Unterstriche (_) in einem Labelschlüssel.
- Labelschlüssel müssen mit einem Buchstaben beginnen.
- Die maximale Länge eines Labelschlüssels beträgt 100 Zeichen.
- Jeder Schlüssel muss innerhalb des Messwerttyps eindeutig sein.
- Sie können maximal 30 Labels pro Messwerttyp verwenden.