PromQL で提供されたメトリクスを有効にする
OTel エンリッチメントを有効にして、サポートされている AWS リソースの提供されたメトリクスを PromQL 経由でクエリ可能にすることができます。有効にすると、リソース識別子ディメンションを含むメトリクス (InstanceId ディメンションを使用した EC2 CPUUtilization など) は、リソース ARN とリソースタグラベルで強化され、PromQL を使用してクエリ可能になります。
強化されたメトリクスは、元のメトリクス名と CloudWatch ディメンションを保持し、以下を追加します:
-
[リソース属性] – リソース ARN (
cloud.resource_id)、クラウドプロバイダー、リージョン、アカウント ID。 -
[計装スコープ] – ソースサービスを識別し、メトリクスを OTel エンリッチドとしてマークします。
-
[リソースタグ] – リソースに関連付けられたすべての AWS リソースタグ。PromQL ラベルとしてクエリできます。
元の従来の CloudWatch メトリクスは変更されず、既存の CloudWatch API を介して引き続き使用できます。
提供されたメトリクスの OpenTelemetry エンリッチメントを有効にする
OTel エンリッチメントを開始する前に、アカウントのテレメトリでリソースタグを有効にする必要があります。
CloudWatch コンソール、AWS CLI、または AWS SDK を使用して、特定のリージョンでアカウントの OTel エンリッチメントを有効にできます。
次のオペレーションにはアクセス許可が必要です: cloudwatch:StartOTelEnrichment
AWS メトリクスの OTel エンリッチメントを有効にするには (CloudWatch コンソール)
-
CloudWatch コンソールの https://console.aws.amazon.com/cloudwatch/
を開いてください。 -
ナビゲーションペインで、[CloudWatch] を選択し、次に [設定] を選択します。
-
[AWS メトリクスの OTel エンリッチメントを有効にする] ペインで、機能をオンに切り替えます。
AWS CLI
aws cloudwatch start-o-tel-enrichment
複数のリージョン全体で有効にするには、対象の各リージョンで API を呼び出します。
エンリッチメントを有効にすると、PromQL を介して提供されたメトリクスのクエリを開始できます。以下を参照してください: PromQL を使用した提供された AWS メトリクスのクエリ。
