Namenskonventionen für Messwerte

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

Messwert-Ressourcenname

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 anzugeben, 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 Sie beim Erstellen benutzerdefinierter Messwerttypen beachten müssen. 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

    • Sie können Groß- und Kleinbuchstaben (A-Z, a-z), Ziffern (0-9), Punkte (.), Unterstriche (_), Doppelpunkte (:) und Bindestriche (-) im String verwenden.
    • 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), Unterstriche (_) und Punkte (.) verwenden.
    • 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.