命名规则

指标类型的资源名称由一个字符串和三个主要子结构组成:

  • 特定项目的标识符
  • 指示字符串表示指标描述符的标记
  • 指标类型

指标类型的资源名称遵循以下模式:

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

子字符串 METRIC_TYPE 是一个表示指标类型的标识符。它有多种格式,例如:

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

在指标描述符中,name 字段存储指标类型的资源名称,而 type 字段存储 METRIC_TYPE 子字符串。

下表显示了如何解析资源名称中包含的 METRIC_TYPE 子字符串:

可能的结构 说明
SERVICE 1.googleapis.com/PATH 2 来自 Google Cloud 产品和服务的指标。如需查看这些指标的完整列表,请参阅 Google Cloud 指标
agent.googleapis.com/SERVICE 1/PATH 2 来自 Google Cloud 或 AWS 虚拟机实例上运行的 Monitoring 和 Logging 代理的指标。如需查看这些指标的完整列表,请参阅代理指标
kubernetes.io/anthos/PATH 2 来自 Anthos 的指标,这是一种 Google Cloud 服务,可让您在本地和云端运行 Kubernetes 集群。如需查看这些指标的完整列表,请参阅 Anthos 指标
aws.googleapis.com/SERVICE 1/PATH 2 来自 Amazon Web Services 的指标。如需查看这些指标的完整列表,请参阅 AWS 指标
istio.io/PATH 2 来自 Istio for Google Cloud 的指标。如需查看这些指标的完整列表,请参阅 Istio 指标
kubernetes.io/PATH 2 来自 Google Kubernetes Engine 的指标。如需查看这些指标的完整列表,请参阅 Kubernetes 指标
knative.dev/PATH 2 来自 Knative 的指标。如需查看这些指标的完整列表,请参阅 Knative 指标
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2
诸如 Prometheus 之类的第三方自定义指标。此开源监控工具通常与 Kubernetes 一起使用。如需详细了解这些指标,请参阅外部指标。这些指标类型只能在定义这些指标的项目中使用。
custom.googleapis.com/PATH 2 用户定义的自定义指标。这些指标类型只能在定义这些指标的项目中使用。
logging.googleapis.com/PATH 2 来自 Cloud Logging 的基于日志的指标。您可以使用预定义指标,也可以创建自定义指标。自定义指标只能在定义这些指标的项目中使用。

1 SERVICE 标识 Google Cloud 产品,例如 Compute Engine 的 compute
2 PATH 标识产品中的指标,例如 instance/cpu/utilization

命名指标类型和标签

如果要创建自定义指标类型,您必须遵循以下规则来命名指标类型和标签。定义指标类型时,将标签指定为 LabelDescriptor 类型的键值对。键用作标签的名称。

  • 指标类型
    • 您可以在字符串中使用大写和小写字母(A-Za-z)、数字 (0-9) 和下划线 (_)。
    • 您只能在字符串的网域部分使用英文句点 (.),例如 custom.googleapis.com
    • 您可以使用正斜杠 (/) 分隔路径元素。
    • 您可以使用字母或数字作为每个路径元素的开头。
    • 指标类型字符串的长度上限为 200 个字符。
  • 标签键
    • 您可以在标签键中使用小写字母 (a-z)、数字 (0-9)、下划线 (_) 和短划线 (-)。
    • 您可以使用字母作为标签键的开头。
    • 标签键的长度上限为 100 个字符。
    • 每个键在指标类型中必须是唯一的。每个指标类型最多只能有 10 个标签。