

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

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

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

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

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

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

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

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

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

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

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

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

**AWS CLI**

```
aws cloudwatch start-o-tel-enrichment
```

要跨多个区域启用，请在每个感兴趣区域中调用 API。

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