Namenskonventionen

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

  • Eine Kennzeichnung für ein bestimmtes Projekt
  • Eine Markierung, die angibt, 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/antho/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 1.googleapis.com/PATH 2 Messwerte aus Google Cloud-Produkten und -Diensten. Eine vollständige Liste dieser Messwerte finden Sie unter Google Cloud-Messwerte.
agent.googleapis.com/SERVICE 1/PATH 2 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 2 Messwerte aus Anthos, 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 1/PATH 2 Messwerte aus Amazon Web Services Eine vollständige Liste dieser Messwerte finden Sie unter AWS-Messwerte.
istio.io/PATH 2 Messwerte aus Istio für Google Cloud Eine vollständige Liste dieser Messwerte finden Sie unter Istio-Messwerte.
kubernetes.io/PATH 2 Messwerte aus Google Kubernetes Engine Eine vollständige Liste dieser Messwerte finden Sie unter Kubernetes-Messwerte.
knative.dev/PATH 2 Messwerte aus Knative. Eine vollständige Liste dieser Messwerte finden Sie unter Knative-Messwerte.
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2
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 2 Benutzerdefinierte Messwerte. Sie können diese Messwerttypen nur in Projekten verwenden, in denen Sie sie definieren.
logging.googleapis.com/PATH 2 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.

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

Benennen Sie Messwerttypen und Labels

Wenn Sie benutzerdefinierte Messwerttypen erstellen, müssen Sie die folgenden Regeln für die Benennung Ihrer Messwerttypen und Labels einhalten. Beim Definieren eines Messwerttyps werden Labels als Schlüssel/Wert-Paare des Typs LabelDescriptor angegeben. Der Schlüssel fungiert als Name des Labels.

  • Messwerttypen
    • Sie können Groß- und Kleinbuchstaben (A-Z, a-z), Ziffern (0-9) und Unterstriche (_) im String verwenden.
    • Punkte (.) können nur im Domain-Teil des Strings verwendet werden, z. B. custom.googleapis.com.
    • Sie können Pfadelemente mit Schrägstrichen (/) 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
    • In einem Labelschlüssel können Sie Kleinbuchstaben (a-z), Ziffern (0-9) und Unterstriche (_) verwenden.
    • Labelschlüssel müssen mit einem Buchstaben oder Unterstrich 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.