Namenskonventionen für Messwerte

Mit standardisierten Ressourcennamen, Domainpräfixen und Labelschlüsseln in Cloud Monitoring können Sie Messwertquellen identifizieren und benutzerdefinierte Messwerte definieren. Sie können diese Formatierungsregeln anwenden, um gültige Messwerttypen und LabelDescriptor-Schlüssel für die Cloud Monitoring API zu erstellen.

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 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, die den Messwerttyp darstellt. Es ist in verschiedenen Formaten verfügbar. 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 wird im Feld name der Ressourcenname des Messwerttyps und im Feld type der Teilstring METRIC_TYPE gespeichert.

In der folgenden Tabelle wird gezeigt, wie die in einem Ressourcennamen enthaltenen METRIC_TYPE-Teilstrings geparst werden:

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 von 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 von GKE Enterprise, einem Dienst von Google Cloud, 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 an, z. B. compute für Compute Engine.
2 PATH identifiziert den Messwert innerhalb des Produkts, 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 (.), Unterstriche (_), Doppelpunkte (:) und Bindestriche (-).
    • Verwenden Sie Schrägstriche (/), um Pfadelemente 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 in einem Labelschlüssel Kleinbuchstaben (a-z), Ziffern (0-9), Unterstriche (_) und Punkte (.).
    • 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.