View a markdown version of this page

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

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

ヒント

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

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、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 メトリクスのクエリ。