View a markdown version of this page

CloudWatch 指标（OTel） - Amazon CloudWatch
支持的路径配置使用 PromQL 进行验证要求和限制
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

CloudWatch 指标（OTel）

选择标准确定哪些 OTel 指标进入管线进行处理。每个标准都是形式为 <path> == "<value>" 的表达式，它与传入指标的特定属性相匹配。至少需要一项选择标准。

标准被分组到一个带有 AND 语义的 match_all 块中，指标必须与组中的每个表达式都匹配才能进入管线。

支持的路径

以下 OTTL 路径在选择标准中受支持：

选择标准路径
路径 说明

resource.attributes["key"]

资源级别属性

instrumentation_scope.name

检测范围名称

instrumentation_scope.version

检测范围版本

instrumentation_scope.attributes["key"]

检测范围属性

metric.name

指标名称

datapoint.attributes["key"]

数据点级别属性

attributes["key"]

datapoint.attributes["key"] 的简称

配置

选择标准在管线配置的 source 部分中定义：

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'metric.name == "http.server.request.duration"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "platform-engineering"
  sink:
    - cloudwatch_metrics: {}

下面的示例使用所有支持的路径类型：

pipeline:
  source:
    cloudwatch_metrics:
      format: otlp
      selection_criteria:
        - match_all:
            - 'resource.attributes["service.name"] == "my-service"'
            - 'instrumentation_scope.name == "my-scope"'
            - 'instrumentation_scope.version == "1.0.0"'
            - 'instrumentation_scope.attributes["library"] == "otel-java"'
            - 'metric.name == "http.server.request.duration"'
            - 'datapoint.attributes["status_code"] == "200"'
            - 'attributes["environment"] == "production"'
  processor:
    - add_attributes:
        attributes:
          - key: resource.attributes["team"]
            value: "observability"
  sink:
    - cloudwatch_metrics: {}

使用 PromQL 进行验证

CloudWatch 使用 @ 前缀约定将 OTLP 属性范围映射到 PromQL 标签。使用此映射可在 Query Studio 中验证管线是否按预期处理指标：

OTTL 路径到 PromQL 标签映射
管线 OTTL 路径 PromQL 标签前缀 示例

resource.attributes["key"]

@resource.

@resource.service.name

instrumentation_scope.name

@instrumentation.@name

@instrumentation.@name

instrumentation_scope.attributes["key"]

@instrumentation.

@instrumentation.library

datapoint.attributes["key"] / attributes["key"]

@datapoint. 或裸露

status_code

例如，如果管线添加了值为 "platform-engineering" 的 resource.attributes["team"]，则可以确认它已应用：

{"CPUUtilization", "@resource.team"="platform-engineering"}

要求和限制

单个 match_all 组

每个管线的 selection_criteria 中仅支持一个 match_all 组。不能在单个管线中定义多个 match_all 组。

最低标准

match_all 组中至少需要一个表达式。

最大标准

一个 match_all 组最多可包含 20 个表达式。

AND 语义

match_all 组中的所有表达式都必须匹配，指标才能进入管线。

精确字符串匹配

值必须是静态字符串。不支持通配符、正则表达式和部分匹配。每个表达式都必须使用 == 运算符。

各管线之间不存在重叠的标准

每个指标数据点最多只能匹配一个管线。如果一个数据点与新的和现有的管线标准都匹配，则管线创建会失败。为防止重叠，每个管线的选择标准中至少应包含一条具有不同值的属性路径。

例如，以下两个选择标准发生重叠，因为管线 A 选择 payment-service 中的所有指标，其中包括管线 B 所针对的特定指标：

# Pipeline A — selects ALL metrics from payment-service
selection_criteria:
  - match_all:
      - 'resource.attributes["service.name"] == "payment-service"'

# Pipeline B — FAILS: a datapoint with service.name="payment-service"
# and metric.name="http.server.request.duration" matches both pipelines
selection_criteria:
  - match_all:
      - 'metric.name == "http.server.request.duration"'