サービスイベントのモニタリング

サービスイベントでは、CloudWatch Application Signals でモニタリングされるサービスの自動ディープオブザーバビリティが可能です。エラーメトリクス、関数レベルのパフォーマンスデータ、インシデントスナップショット (リクエストがレイテンシーしきい値を超えた場合、または例外をスローする場合)、デプロイイベントが、追加のコード変更なしでキャプチャされます。

サービスイベントの仕組み

サービスイベントでは、計測されたサービスから次のタイプのシグナルが収集されます。

サービスイベントは、サービスの CloudWatch Application Signals を有効にすると自動的に有効になります。エラーメトリクスと例外の追跡はすぐにアクティブになります。関数呼び出しメトリクスには追加の設定が必要です。関数呼び出しデータが収集される前に、計測するパッケージを設定する必要があります (関数計装の有効化 を参照)。サービスイベントは、OTEL_AWS_SERVICE_EVENTS_ENABLED=false を設定することで無効にできます。データは ADOT SDK から CloudWatch エージェントに流れます。エージェントは、CloudWatch Logs (/aws/service-events/service-name ロググループ) と CloudWatch Metrics にイベントを発行します。

サポートされている言語: Java、Python、Node.js

データストレージ

サービスイベントは CloudWatch Logs にデータを保存します。CloudWatch は、プレフィックス /aws/application-signals/service-name があるロググループにサービスイベントデータを発行します。ここで、service-name は環境変数 OTEL_SERVICE_NAME の値です。サービスごとに 1 つのロググループが作成されます。

ログの取り込みと保存には、標準の CloudWatch Logs 料金が請求されます。

コンソールにおけるエラー表示

CloudWatch コンソールで、[Application Signals] に移動し、該当するサービスを選択し、[エラー] タブを選択します。このタブはサービスの例外メトリクスを示すものです。

タブには以下が表示されます。

例外を選択して、スタックトレース、例外メッセージ、関連するトレースへのリンクなどの詳細をドリルダウンします。

エラーは、オペレーション別、例外タイプ別、上位スタックフレーム別にグループ化されます。各グループの最新の代表のみが表示されます。

ログにおけるサービスイベントの表示

サービスイベントデータは、CloudWatch Logs で、/aws/service-events/service-name というプレフィックスが付いたロググループに保存されます。CloudWatch Logs Insights を使用してこのデータを直接クエリすることで、カスタムビューの構築、ダッシュボードの作成、特定のインシデントの調査を行うことができます。

サービスイベントをクエリするには:

CloudWatch Application Signals MCP (モデルコンテキストプロトコル) サーバーのサービスイベント

サービスイベントデータには CloudWatch Application Signals MCP (モデルコンテキストプロトコル) サーバーを介してアクセスでき、AI コーディングアシスタントとエージェントはサービスのランタイム動作を直接クエリできます。

トラブルシューティング

パフォーマンスの改善

セットアップと使用手順については、GitHub ウェブサイトの「Application Signals MCP サーバー」を参照してください。

サービスイベントの設定

前提条件

サービスイベントを使用するには、以下のコンポーネントについて必要最小限のバージョンであることを確認してください。

Amazon EKS を使用する場合は、アドオンのセットアップ手順については「Amazon EKS クラスターでアプリケーションを有効にする」を参照してください。

デフォルトで有効になっている機能

CloudWatch Application Signals を使用する場合、次のサービスイベント信号はデフォルトで有効になっており、追加の設定は必要ありません。

次の機能はオプトインであり、データを生成するには環境変数を設定する必要があります。

全般設定

関数計装の有効化

関数計装はデフォルトで有効になっていますが、計装するパッケージを設定するまでメトリクスを生成しません。関数ごとのテレメトリ収集を開始するには、パッケージ許可リストを指定します。

エンドポイントフィルタリング

エンドポイントフィルタリングは、エンドポイントエラーメトリクスとインシデントスナップショットを生成するエンドポイントを制御します。これらの設定は、関数の計装には影響しません。

レイテンシーしきい値

次の環境変数を使用して、インシデントスナップショットトリガーのレイテンシーしきい値を設定します。

レート制限

以下の環境変数を使用して、サービスイベントデータが収集されて報告される際のレートを制御します。

デプロイイベントの設定

デプロイイベントはアプリケーションの起動時と 24 時間ごとに必ず出力されます。デプロイメタデータを指定すると、これらのイベントが強化されるため、インシデントとパフォーマンスの変化を特定のコードデプロイに関連付けることができます。

デプロイメタデータを提供するために、アプリケーションコンテナまたはプロセスに次の環境変数を設定します。

GitHub Actions を使用したデプロイイベントの設定

GitHub Actions ワークフローで、組み込みの環境変数を使用してデプロイメタデータを入力します。デプロイステップまたはコンテナ環境に以下を追加します。

env:
  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: ${{ github.sha }}
  OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: ${{ github.server_url }}/${{ github.repository }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: ${{ github.run_id }}
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

コンテナイメージをデプロイする場合は、これらの値をタスク定義またはポッド仕様の環境変数として渡します。ビルド時にイメージにベイクすることも、デプロイ設定を通じてデプロイ時に挿入することもできます。

GitLab CI/CD を使用したデプロイイベントの設定

GitLab CI/CD パイプラインで、事前定義された CI/CD 変数を使用してデプロイメタデータを入力します。デプロイジョブに以下を追加します。

deploy:
  variables:
    OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA: $CI_COMMIT_SHA
    OTEL_AWS_SERVICE_EVENTS_GIT_REPO_URL: $CI_PROJECT_URL
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID: $CI_PIPELINE_ID
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_TIMESTAMP: $(date -u +%Y-%m-%dT%H:%M:%SZ)
    OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_URL: $CI_PIPELINE_URL

これらの変数をデプロイ時にコンテナオーケストレーションプラットフォームを介してアプリケーションコンテナに渡します (Amazon ECS タスク定義または Kubernetes デプロイマニフェストの環境変数などとして)。