View a markdown version of this page

在 PromQL 中启用已出售指标 - Amazon CloudWatch
为已出售指标启用 OpenTelemetry 补充功能
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

在 PromQL 中启用已出售指标

提示

要了解有关 CloudWatch 上的 OpenTelemetry 的更多信息，请参阅 Cloud Operations Enablement workshop and event series。

您可以启用 OTel 补充功能，使支持的 Amazon 资源的已出售指标可通过 PromQL 进行查询。启用后，包含资源标识符维度的指标（例如，具有 InstanceId 维度的 EC2 CPUUtilization）将补充资源 ARN 和资源标注标签，并且可以使用 PromQL 进行查询。

补充指标保留了原始指标名称和 CloudWatch 维度，并添加了：

  • 资源属性 – 资源 ARN (cloud.resource_id)、云提供商、区域和账户 ID。

  • 埋点范围 – 标识源服务并将该指标标记为“OTel 已补充”。

  • 资源标签 – 与资源关联的任何 Amazon 资源标签，可作为 PromQL 标签进行查询。

原始的经典 CloudWatch 指标未经修改，仍可通过现有的 CloudWatch API 使用。

为已出售指标启用 OpenTelemetry 补充功能

在开始 OTel 补充之前，您必须为账户针对遥测启用资源标签。

您可以使用 CloudWatch 控制台、Amazon CLI、Amazon CloudFormation、Terraform 或 Amazon SDK，为特定区域的账户启用 OTel 补充功能。

您需要以下操作的权限：cloudwatch:StartOTelEnrichment

为 Amazon 指标启用 OTel 补充功能（CloudWatch 控制台）

  1. 通过 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

  2. 在导航面板中选择 CloudWatch，再选择设置。

  3. 在为 Amazon 指标启用 OTel 补充”窗格中，将功能开关切换为“开启”状态。

Amazon CLI

aws cloudwatch start-otel-enrichment

Amazon CloudFormation

Resources:
  OTelEnrichment:
    Type: AWS::CloudWatch::OTelEnrichment

Terraform

注意

aws_cloudwatch_otel_enrichment Terraform 资源需要先配置 aws_observabilityadmin_telemetry_enrichment 资源。

resource "aws_observabilityadmin_telemetry_enrichment" "example" {
}

resource "aws_cloudwatch_otel_enrichment" "example" {
  depends_on = [aws_observabilityadmin_telemetry_enrichment.example]
}

有关更多信息，请参阅 Terraform Registry 中的 aws_cloudwatch_otel_enrichment。

要跨多个区域启用，请在每个区域堆栈中创建相同的资源或在每个感兴趣区域中调用 API。

启用补充功能后，便可开始通过 PromQL 查询已出售指标。请参阅：使用 PromQL 查询 Amazon 已出售指标。