# 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. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/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)。