# 在 PromQL 中启用已出售指标
<a name="CloudWatch-OTelEnrichment"></a>

**提示**  
要了解有关 CloudWatch 上的 OpenTelemetry 的更多信息，请参阅 [Cloud Operations Enablement workshop and event series](https://aws-experience.com/amer/smb/events/series/Cloud-Operations-Enablement)。

您可以启用 OTel 补充功能，使[支持的 Amazon 资源](https://docs.amazonaws.cn//AmazonCloudWatch/latest/monitoring/UsingResourceTagsForTelemetry.html)的已出售指标可通过 PromQL 进行查询。启用后，包含资源标识符维度的指标（例如，具有 InstanceId 维度的 EC2 CPUUtilization）将补充资源 ARN 和资源标注标签，并且可以使用 PromQL 进行查询。

补充指标保留了原始指标名称和 CloudWatch 维度，并添加了：
+ **资源属性** – 资源 ARN (`cloud.resource_id`)、云提供商、区域和账户 ID。
+ **埋点范围** – 标识源服务并将该指标标记为“OTel 已补充”。
+ **资源标签** – 与资源关联的任何 Amazon 资源标签，可作为 PromQL 标签进行查询。

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

## 为已出售指标启用 OpenTelemetry 补充功能
<a name="CloudWatch-OTelEnrichment-Enable"></a>

在开始 OTel 补充之前，您必须为账户[针对遥测启用资源标签](https://docs.amazonaws.cn//AmazonCloudWatch/latest/monitoring/EnableResourceTagsOnTelemetry.html)。

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

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

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

1. 通过 [https://console.aws.amazon.com/cloudwatch/](https://console.amazonaws.cn/cloudwatch/) 打开 CloudWatch 控制台。

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

1. 在**为 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](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_otel_enrichment)。

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

启用补充功能后，便可开始通过 PromQL 查询已出售指标。请参阅：[使用 PromQL 查询 Amazon 已出售指标](CloudWatch-PromQL-Querying.md#CloudWatch-PromQL-Querying-Vended)。