Namenskonventionen für Messwerte

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

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 und 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/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 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_NAME 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 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 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
external.googleapis.com/user/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_NAME 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.

Regeln für Messwerttypen und Labels

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

  • Messwerttypen

    • Verwenden Sie Groß- und Kleinbuchstaben (A-Z, a-z), Ziffern (0-9), Punkte (.) und Unterstriche (_) im String.
    • Trennen Sie Pfadelemente mit Schrägstrichen (/).
    • 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 in einem Labelschlüssel Kleinbuchstaben (a-z), Ziffern (0-9) und Unterstriche (_).
    • 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.