Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

PromQL 查询

您通过 OpenTelemetry Protocol（OTLP）将 OpenTelemetry 指标摄取到 CloudWatch 时，分层 OTLP 数据模型会扁平化为兼容 PromQL 的标签。本节介绍标签结构、用于查询这些标签的 PromQL 语法以及 PromQL 中对 UTF-8 的支持。

在 CloudWatch 中使用 PromQL 时，@ 前缀惯例会将 OTLP 范围的标签与标准 Prometheus 标签区分开来。每个作用域内的字段使用双 @ 前缀（例如 @resource.@schema_url），而属性使用单 @ 作用域前缀，例如 @resource.service.name。数据点属性还支持裸露（无前缀）访问，以向后兼容标准 PromQL 查询，例如 {"http.server.active_requests"} 和 {"@datapoint.@name"="http.server.active_requests"} 等效。

PromQL 表达式用花括号括起来，用于指定指标名称和一组可选的标签匹配器。以下示例选择了 http.server.active_requests 指标的所有时间序列：

{"http.server.active_requests"}

以下示例选择了 http.server.active_requests 指标的所有时间序列，其中 OpenTelemetry 资源属性 service.name 等于 myservice：

{"http.server.active_requests", "@resource.service.name"="myservice"}

您可以在单个查询中组合多个标签匹配器。以下示例选择了 http.server.active_requests 指标的所有时间序列，其中在所有美国区域，OpenTelemetry 资源属性 service.name 等于 myservice：

{"http.server.active_requests",
 "@resource.service.name"="myservice",
 "@aws.region"=~"us-.*"}

以下示例显示了范围查询。该示例计算每个时间序列在指定时间范围内所有数据点的平均值：

avg_over_time(
  {"http.server.active_requests",
   "@resource.service.name"="myservice"}[5m]
)

下表总结了每个 OTLP 范围的前缀惯例：

使用 PromQL 查询 Amazon 已出售指标

为了能够在 PromQL 中查询 Amazon 已出售指标，您首先需要启用已出售指标的 OTel 补充功能。请参阅：在 PromQL 中启用已出售指标。

启用 OTel 补充功能后，可通过 PromQL 使用其他标签查询 Amazon 已出售指标。指标名称与原始 CloudWatch 指标名称相同，原始 CloudWatch 维度可作为数据点属性提供。以下标签可用（以下示例适用于 EC2 实例）：

以下示例为特定的 Lambda 函数选择了 Invocations：

histogram_sum({Invocations, FunctionName="my-api-handler"})

以下示例为具有特定团队标签的所有函数选择了 Errors Lambda：

histogram_sum(
  {Errors, "@instrumentation.@name"="cloudwatch.aws/lambda", "@aws.tag.Team"="backend"}
)

以下示例计算按团队分组的 Invocations Lambda 总数：

sum by ("@aws.tag.Team")(
    {Invocations, "@instrumentation.@name"="cloudwatch.aws/lambda"}
)

以下示例选择了 EC2 CPUUtilization 指标的所有时间序列。"@instrumentation.@name"="cloudwatch.aws/ec2" 的用法是为了专门匹配来自 EC2 的 CPUUtilization，而不是来自其他 Amazon 服务（例如 Amazon Relational Database Service）的 CPUUtilization：

histogram_avg({CPUUtilization, "@instrumentation.@name"="cloudwatch.aws/ec2"})