View a markdown version of this page

OpenTelemetry 形式の AWS 提供のメトリクス - Amazon CloudWatch
提供されたメトリクスの OpenTelemetry エンリッチメントを有効にする

OpenTelemetry 形式の AWS 提供のメトリクス

ヒント

CloudWatch での OpenTelemetry の詳細については、「Cloud Operations Enablement ワークショップとイベントシリーズ」を参照してください。

OTel エンリッチメントを有効にして、サポートされている AWS リソース の提供済みメトリクスを PromQL を介してクエリ可能にすることができます。OTel エンリッチメントを有効にすると、リソース識別子ディメンションを含むメトリクス (例: InstanceId ディメンションを持つ EC2 CPUUtilization) は、リソース ARN とリソースタグラベルでエンリッチされ、PromQL を使用してクエリ可能になります。

強化されたメトリクスは、元のメトリクス名と CloudWatch ディメンションを保持し、以下を追加します:

  • [リソース属性] – リソース ARN (cloud.resource_id)、クラウドプロバイダー、リージョン、アカウント ID。

  • [計装スコープ] – ソースサービスを識別し、メトリクスを OTel エンリッチドとしてマークします。

  • [リソースタグ] – リソースに関連付けられたすべての AWS リソースタグ。PromQL ラベルとしてクエリできます。

元の従来の CloudWatch メトリクスは変更されず、既存の CloudWatch API を介して引き続き使用できます。

提供されたメトリクスの OpenTelemetry エンリッチメントを有効にする

OTel エンリッチメントを開始する前に、アカウントのテレメトリでリソースタグを有効にする必要があります。

CloudWatch コンソール、AWS CLI、CloudFormation、Terraform、または AWS SDK を使用して、特定のリージョンでアカウントの OTel エンリッチメントを有効にできます。

次のオペレーションにはアクセス許可が必要です: cloudwatch:StartOTelEnrichment

AWS メトリクスの OTel エンリッチメントを有効にするには (CloudWatch コンソール)

  1. CloudWatch コンソールの https://console.aws.amazon.com/cloudwatch/ を開いてください。

  2. ナビゲーションペインで、[CloudWatch] を選択し、次に [設定] を選択します。

  3. [AWS メトリクスの OTel エンリッチメントを有効にする] ペインで、機能をオンに切り替えます。

AWS CLI

aws cloudwatch start-otel-enrichment

CloudFormation

注記

AWS::CloudWatch::OTelEnrichment リソースでは、最初に AWS::ObservabilityAdmin::TelemetryEnrichment リソースを設定する必要があります。詳細については、「テレメトリでリソースタグを有効にする」を参照してください。

Resources:
  TelemetryEnrichmentExample:
    Type: AWS::ObservabilityAdmin::TelemetryEnrichment
  OTelEnrichmentExample:
    Type: AWS::CloudWatch::OTelEnrichment
    DependsOn: TelemetryEnrichmentExample

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」を参照してください。

複数のリージョンで有効にするには、各リージョンスタックに同じリソースを作成するか、対象の各リージョンで API を呼び出します。

エンリッチメントを有効にすると、PromQL を介して提供されたメトリクスのクエリを開始できます。以下を参照してください: PromQL を使用した提供された AWS メトリクスのクエリ。