CloudWatch Application Signals + X-Ray APM ハンズオン

AWS マネジメントコンソールで 「CloudWatch」 を検索して開きます。左メニューを下にスクロールし、「Application Signals」 セクションを展開して 「サービス」 をクリックします。

初めて開く場合は「Application Signals を開始する」ボタンが表示されます。「Application Signals を開始する」 をクリックします。

AWS マネジメントコンソールで 「IAM」 を検索して開きます。左メニューから 「ロール」 をクリックします。

ECS タスク実行ロール（例: ecsTaskExecutionRole）を検索して選択します。「許可を追加」→「ポリシーをアタッチ」 をクリックし、以下のポリシーを追加します。

「許可を追加」 をクリックして保存します。

ECS タスクロール（例: ecsTaskRole）も同様に選択し、以下のポリシーをアタッチします。

AWS マネジメントコンソールで 「Systems Manager」 を検索して開きます。左メニューから 「パラメータストア」 をクリックします。

「パラメータを作成」 をクリックし、以下の設定を入力します。

「値」欄に以下の YAML を貼り付けます。

extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch/traces:
    timeout: 1s
    send_batch_size: 50
  batch/metrics:
    timeout: 60s

exporters:
  awsxray:
    region: ap-northeast-1
  awsemf:
    region: ap-northeast-1
    namespace: ApplicationSignals
    log_group_name: /aws/application-signals/data
    dimension_rollup_option: NoDimensionRollup

service:
  extensions: [health_check]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch/traces]
      exporters: [awsxray]
    metrics:
      receivers: [otlp]
      processors: [batch/metrics]
      exporters: [awsemf]

「パラメータを作成」 をクリックします。

AWS マネジメントコンソールで 「Elastic Container Service」 を検索して開きます。左メニューから 「タスク定義」 をクリックします。

アプリケーションのタスク定義を選択し、最新のリビジョンをクリックします。「新しいリビジョンを作成」→「新しいリビジョンを作成」 をクリックします。

画面を下にスクロールして 「コンテナを追加」 をクリックし、ADOT コレクターコンテナを設定します。

コンテナ設定の 「ポートマッピング」 で以下を追加します。

「環境変数」 セクションで以下を追加します。

「ログ設定」 セクションで以下を設定します。

「コンテナを追加」 をクリックしてサイドカーを保存します。

既存のアプリコンテナを選択して編集します。OpenTelemetry SDK にエンドポイントを教えるための環境変数を追加します。

画面一番下の 「作成」 をクリックして新しいタスク定義リビジョンを保存します。

ECS コンソール左メニューから 「クラスター」 をクリックし、使用しているクラスターを選択します。

「サービス」 タブでアプリケーションのサービスを選択し、「更新」 をクリックします。

「更新」 をクリックします。デプロイが開始され、ADOT サイドカーを含む新しいタスクが起動します。

サービスの 「デプロイ」 タブでステータスを確認します。「PRIMARY」 ステータスのデプロイが完了するまで待ちます（通常 3〜5 分）。

デプロイ完了後、ALB の DNS 名にブラウザでアクセスし、アプリケーションが正常に動作することを確認します。数回アクセスしてトレースデータを生成します。

CloudWatch コンソール左メニューの 「Application Signals」→「サービス」 をクリックします。デプロイから 5〜10 分後に myapp（設定した service.name）が表示されます。

サービス名をクリックして詳細画面を開きます。以下の指標を確認します。

左メニューから 「Application Signals」→「サービスマップ」 をクリックします。アプリケーションが呼び出すサービス（RDS、S3 など）がグラフで表示されます。各ノードをクリックするとレイテンシやエラー率の詳細が確認できます。

CloudWatch コンソール左メニューの 「Application Signals」→「SLO」 をクリックします。「SLO を作成」 をクリックします。

最初に可用性（Availability）の SLO を作成します。

「SLO を作成」 をクリックします。

再度 「SLO を作成」 をクリックして、レイテンシの SLO を作成します。

「SLO を作成」 をクリックします。

SLO 一覧に戻り、作成した 2 つの SLO のステータスを確認します。

AWS マネジメントコンソールで 「X-Ray」 を検索して開きます。または CloudWatch コンソール左メニューの 「X-Ray トレース」→「トレース」 からも開けます。

右上の時間範囲ピッカーで 「直近 30 分」 を選択します。ALB 経由でアプリにアクセスしたリクエストのトレース一覧が表示されます。

トレース ID をクリックしてトレース詳細を開きます。

フィルター式フィールドに以下を入力してエラーのあるトレースだけを抽出します。

fault OR error

エラーがある場合はトレース詳細でどのセグメントで失敗したかを確認できます。

X-Ray コンソール左メニューの 「サービスマップ」 をクリックします。アプリケーション・データベース・外部 API などがノードとして表示され、矢印で依存関係が示されます。

各ノードには以下の情報が色分けで表示されます。

ノードをクリックすると右側のパネルにトレース一覧が表示されます。「トレースを表示」 をクリックすることでそのサービスを経由したトレースに絞り込めます。ボトルネックや高レイテンシの原因を特定するのに活用します。

X-Ray コンソール左メニューの 「分析」→「応答時間の分布」 でレイテンシのヒストグラムを確認します。外れ値（p99 の遅いリクエスト）のトレースを特定できます。

CloudWatch コンソール左メニューの 「メトリクス」→「すべてのメトリクス」 をクリックします。名前空間一覧に ApplicationSignals が表示されていることを確認します。

ApplicationSignals 名前空間をクリックして、利用可能なメトリクスを確認します。

CloudWatch コンソール左メニューの 「ダッシュボード」→「ダッシュボードの作成」 をクリックします。

「ダッシュボードの作成」 をクリックします。

「ウィジェットの追加」 をクリックして以下のウィジェットを追加します。

• 折れ線グラフ — ApplicationSignals / Latency（p50、p99 の 2 系列）
• 折れ線グラフ — ApplicationSignals / Availability
• 数値 — ApplicationSignals / Fault（合計）
• 折れ線グラフ — ECS の CPUUtilization と MemoryUtilization

各ウィジェットを追加したら 「ダッシュボードを保存」 をクリックします。

CloudWatch コンソール左メニューの 「アラーム」→「すべてのアラーム」→「アラームの作成」 をクリックします。

「メトリクスの選択」 をクリックし、ApplicationSignals → Fault メトリクスを選択して 「メトリクスと条件の指定」 をクリックします。

「次へ」 をクリックします。

「ALARM 状態のアクション」で 「通知の追加」 をクリックします。

「トピックの作成」 をクリックします。確認メールが届くので 「Confirm subscription」 リンクをクリックして購読を確認します。

「アラームの作成」 をクリックします。

同様の手順で ApplicationSignals / Latency メトリクスを使用したアラームを作成します。

CloudWatch コンソール → 「アラーム」→「すべてのアラーム」 で作成したアラームを選択して 「アクション」→「削除」 をクリックします。

• myapp-high-fault-rate
• myapp-high-latency-p99（作成した場合）

CloudWatch コンソール → 「Application Signals」→「SLO」 で作成した SLO を選択して削除します。

• myapp-availability-slo
• myapp-latency-slo

CloudWatch コンソール → 「ダッシュボード」 で APM-Overview を選択して削除します。

SNS コンソール → 「トピック」 で apm-alert-topic を選択して削除します。

ECS コンソール → クラスター → サービスを選択して「更新」し、ADOT サイドカー追加前のリビジョンを指定して更新します。または ECS サービス・クラスターを削除します。

Systems Manager コンソール → 「パラメータストア」 で /otel/config を選択して削除します。

CloudWatch コンソール → 「ロググループ」 で以下を選択して削除します。

• /ecs/otel-collector
• /aws/application-signals/data

このハンズオンで追加したポリシー（CloudWatchAgentServerPolicy、AWSXRayDaemonWriteAccess、AmazonSSMReadOnlyAccess）を ECS タスク実行ロール・タスクロールからデタッチします。