本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 PromQL 中啟用付費指標
<a name="CloudWatch-OTelEnrichment"></a>

**提示**  
若要進一步了解 CloudWatch 上的 OpenTelemetry，請參閱 [Cloud Operations Enablement 研討會和事件系列](https://aws-experience.com/amer/smb/events/series/Cloud-Operations-Enablement)。

您可以啟用 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 APIs使用。

## 啟用已佈建指標的 OpenTelemetry 擴充功能
<a name="CloudWatch-OTelEnrichment-Enable"></a>

開始 OTel 擴充之前，您必須在帳戶的[遙測上啟用資源標籤](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/EnableResourceTagsOnTelemetry.html)。

您可以使用 CloudWatch 主控台、 AWS CLI、 CloudFormation Terraform 或 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-otel-enrichment
```

**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 登錄檔中的 [aws\_cloudwatch\_otel\_enrichment](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_otel_enrichment)。

若要跨多個區域啟用 ，請在每個區域堆疊中建立相同的資源，或在每個感興趣的區域中叫用 API。

啟用擴充功能後，您就可以開始透過 PromQL 查詢付費指標。請參閱：[使用 PromQL 查詢已結束的 AWS 指標](CloudWatch-PromQL-Querying.md#CloudWatch-PromQL-Querying-Vended)。