Classic メトリクスから OTel メトリクスへの移行

現在 PutMetricData または EMF を介してカスタムメトリクスを発行しているお客様は、OTel パスに増分移行できます。フラグデーはありません。移行はワークロードごとにご自身のペース進めていただけます。

移行アプローチ

移行には次の 4 つのフェーズがあります。

ステップ 1: OTel SDK を使用して計測する (デュアル書き込み)

既存の PutMetricData 呼び出しを残したまま OTel SDK を追加します。両方のパスを同時に発行できるため、データが失われることはありません。

# Existing Classic publishing (keep running during migration)
cloudwatch.put_metric_data(
    Namespace='MyApp',
    MetricData=[{'MetricName': 'RequestLatency', 'Value': 42.5, 'Unit': 'Milliseconds'}]
)

# New OTel publishing (add this)
from opentelemetry import metrics
meter = metrics.get_meter("my-app")
histogram = meter.create_histogram("http_request_duration_seconds")
histogram.record(0.0425, {"method": "GET", "path": "/api/users"})

ステップ 2: Query Studio で検証する

OTel メトリクスが到着していることを確認するには、CloudWatch コンソールを開き、Query Studio に移動します。メトリクスを検索します。

http_request_duration_seconds

データが、期待するラベルが付いた状態で表示されることを確認します。

ステップ 3: OTel メトリクスでアラームを再作成する

PromQL 式を使用して、OTel メトリクスにクエリを実行する新しいアラームを作成します。次の例は、Classic アラームとそれに対応する OTel アラームを示しています。

Classic アラーム:

aws cloudwatch put-metric-alarm \
  --alarm-name "high-latency" \
  --namespace "MyApp" \
  --metric-name "RequestLatency" \
  --statistic Average --threshold 100 ...

OTel 相当機能 (PromQL アラーム):

aws cloudwatch put-metric-alarm \
  --alarm-name "high-latency-otel" \
  --metrics '[{"Id":"q1","Expression":"avg(http_request_duration_seconds{path=\"/api/users\"}) * 1000","Period":300,"ReturnData":true}]' \
  --threshold 100 ...

OTel バージョンが正しく作動することを確認できるまで、両方のアラームを並行して実行してください。

ステップ 4: Classic の公開を停止する

OTel アラームとダッシュボードを検証したら、アプリケーションコードから PutMetricData 呼び出しを削除します。Classic メトリクスに対する課金は直ちに停止されます。

メトリクス名のマッピング

次の表は、一般的な Classic メトリクス名と、それに対応する推奨される OTel メトリクス名を示しています。

AWS 提供のメトリクスについてはどうですか?

AWS 提供のメトリクス (Amazon EC2 CPU、Amazon RDS 接続など) を手動で移行する必要はありません。OTel Vended Metric Enrichment を有効にすると、PromQL を介してそれらのメトリクスを自動的にクエリできるようになります。詳細については、「OpenTelemetry 形式の AWS 提供のメトリクス」を参照してください。