1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Amazon ECS がデプロイの内部処理を可視化するための Action Logs に対応

1
Posted at

はじめに

2026 年 7 月 21 日、AWS は Amazon ECS に対して Action Logs を発表しました。サービスデプロイメントや ECS Managed Daemon のアップデート時に ECS が内部で実行している操作を、タイムスタンプ付きのログとして可視化する新しいオブザーバビリティ機能です。

ECS でサービスを運用している方の中には、デプロイが失敗した際に何が起きたのか分からず、原因調査に時間がかかった経験がある方もいるのではないでしょうか。Action Logs は、そうした「ECS の中で何が起きているか分からない」という課題に直接応えるアップデートです。

本記事では、何が変わったのか、どのような場面で役立つのか、そしてどのように有効化・運用すればよいのかを中心に解説します。ECS でサービスを運用しているインフラ・SRE・DevOps エンジニアの方を主な対象読者としています。


何が変わったのか

ECS がサービスデプロイメントや Managed Daemon のアップデート中に行っている内部操作について、これまで意識したことがない方も多いかもしれません。実は、リソースの開始状態と終了状態はこれまでも確認できていましたが、その間に ECS がどのような操作を行っているかは見えませんでした。コンテナイメージのダウンロードや、ロードバランサーへの登録、セキュリティグループの設定といった中間ステップは、ユーザーからは不可視の領域だったのです。

項目 従来(Action Logs 導入前) Action Logs 導入後
内部操作の可視性 開始・終了状態のみ観測可能(中間ステップは不可視) 中間ステップも含めタイムスタンプ付きログとして可視化
問題発生時の調査方法 AWS サポートへの問い合わせや、複数ログソースの手動照合 Action Logs を確認することで直接追跡可能
有効化の単位 ー クラスター単位でのオプトイン
対象となる操作 ー サービスデプロイメントの状態遷移・ロールバック、Managed Daemon のライフサイクル操作

従来の課題

デプロイに失敗した際、ユーザーが確認できるのはタスクが最終的にどのような状態になったかまでで、ECS が内部でどのような操作を経てその結果に至ったのかまでは追えませんでした。原因を突き止めるには AWS サポートへ問い合わせるか、複数のログソースを自分で突き合わせる必要があり、特に本番環境での障害対応では、この調査に要する時間が復旧の遅れにつながっていました。

Action Logs による解決

Action Logs は、クラスター単位でオプトインするだけで、これまで内部処理として隠れていた ECS の判断プロセスをそのままログとして取得できるようにする機能です。何が・いつ・なぜ実行されたのかが時系列で追えるようになるため、障害調査のたびに複数のログソースを突き合わせる作業が不要になります。
なお、Action Logs は AWS GovCloud(US)リージョンを含む全 AWS リージョンで利用可能です。


Action Logs で記録される内容

Action Logs が記録する対象は、大きく分けて「サービスデプロイメント」と「Managed Daemon のライフサイクル」の 2 つです。

対象 記録される内容
サービスデプロイメント 状態遷移、ロールバック、ライフサイクルフックの実行
Managed Daemon のライフサイクル 作成・更新・削除、インスタンスドレインといった操作

各ログエントリには、以下のフィールドが含まれます。

フィールド 内容
timestamp イベントが発生した Unix ミリ秒
logLevel ログの重要度(INFO / WARN / ERROR)
account AWS アカウント ID
region イベントが発生した AWS リージョン
resourceArn オプトインの範囲を表すクラスターの ARN
actionSourceId サービス ARN やデーモン ARN など、サブリソースを識別する ID
eventName アクションを識別する名前(例:DAEMON_DEPLOYMENT_IN_PROGRESS)
detail アクションに関する追加情報を含む、イベント固有の JSON ペイロード

resourceArn はクラスター全体を表す ARN であり、どのサービスやデーモンで発生したイベントかは actionSourceId 側で判別する、という役割分担になっている点は覚えておくとログを読み解く際に役立ちます。


仕組み

Action Logs は、クラスター単位でオプトインすることで有効になります。有効化は Amazon ECS コンソールから行うほか、Amazon CloudWatch の API(PutDeliverySource、PutDeliveryDestination、CreateDelivery)を使って設定することもできます。

有効化すると、ECS は CloudWatch Ingestion Hub を通じて構造化された JSON 形式のログを出力し、ユーザーが選択した配信先へ届けます。この配信は fire-and-forget 方式で行われるため、ログの発行が ECS 本体のリソース操作をブロックしたり遅延させたりすることはありません。一時的な配信エラーが発生した場合でも、ECS はワークロードの処理を中断せずに継続します。

配信先

配信先は CloudWatch Logs、Amazon S3、Amazon Data Firehose の 3 つから選択できます。

配信先 特徴
CloudWatch Logs ロググループは /aws/vendedlogs/ecs/action-logs/{resourceId} という命名で作成され、サブリソースごとに actionSourceId を名前とするログストリームが分かれる
Amazon S3 アカウント・リージョン・5 分単位の時間帯でパーティション分割され、gzip 圧縮された状態で保存される
Amazon Data Firehose 改行区切りの JSON レコードとして、ほぼリアルタイムに配信される

リアルタイムな監視やアラート設定を重視するなら CloudWatch Logs、長期保存やコストを重視するなら S3、既存の SIEM やストリーミング基盤に連携させたいなら Data Firehose、というのが基本的な選び分けの目安になります。

Amazon Q との統合

提供開始時点で、Amazon ECS コンソール上の Amazon Q が Action Logs と統合されています。サーキットブレーカーによるロールバックや、不安定なサービスリビジョンといったデプロイ上の問題を自動的に検出し、根本原因分析・リソースレベルの比較・段階的な修復ガイダンスを、コンソールを離れることなく提供します。


活用シーン

ここまでの内容を踏まえて、実際にどのような場面で Action Logs が役立つのか、具体的なシナリオで見ていきます。

デプロイ障害の調査

新しいバージョンのコンテナイメージをデプロイした際にサービスが不安定になった場合、これまではタスクが失敗に終わったという結果しか分かりませんでした。Action Logs を有効にしておけば、ERROR レベルのログエントリを時系列で追うことで、どのタイミングでどのタスクが失敗し、ECS がどのような判断でロールバックを実行したのかを追跡できます。

Managed Daemon 更新の切り分け

FireLens や Datadog Agent といった ECS Managed Daemon をアップデートする際、複数のノードに順次適用されていく中で、特定のノードだけ失敗するケースがあります。Action Logs のログエントリには actionSourceId としてデーモンの ARN が含まれるため、どのデーモンのどの操作が失敗したのかをピンポイントで特定できます。

Amazon Q による自動診断

前章で触れた Amazon Q との統合は、実際の障害対応の場面でも活きてきます。深夜のアラート対応など、担当者がすぐに詳しい人へ相談できない状況でも、根本原因分析や修復手順をコンソール上で確認しながら、一人で初動対応を進めやすくなります。

監査・コンプライアンス対応

Action Logs は Amazon S3 への配信も選択できるため、ECS が実行したデプロイ操作の証跡を長期保存できます。規制業界などコンプライアンス要件の厳しい環境では、監査時にデプロイ履歴を提示する用途に活用できます。


有効化の手順

Action Logs は、Amazon CloudWatch Logs の vended log delivery の仕組みを使って配信されます。有効化には、Amazon ECS コンソールから設定する方法と、CloudWatch Logs の API を直接呼び出す方法の 2 通りがあります。

事前準備

有効化・管理を行う IAM アイデンティティには、以下のアクションを許可しておく必要があります。

{
    "Effect": "Allow",
    "Action": [
        "logs:PutDeliverySource",
        "logs:PutDeliveryDestination",
        "logs:CreateDelivery",
        "logs:GetDelivery",
        "ecs:AllowVendedLogDeliveryForResource"
    ],
    "Resource": "*"
}

配信先を CloudWatch Logs にする場合は、対象のロググループのリソースポリシーで、delivery.logs.amazonaws.com サービスからの書き込みを許可しておく必要があります。

{
    "Effect": "Allow",
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "logs:CreateLogStream",
        "logs:PutLogEvents"
    ],
    "Resource": "arn:aws:logs:<region>:<account-id>:log-group:<log-group-name>:log-stream:*"
}

コンソールでの有効化

  1. Amazon ECS コンソールを開く
  2. クラスター から対象のクラスターを選択する
  3. 設定 タブを開く
  4. アクションログ セクションで ログ配信を追加 を選択する
  5. ログタイプ で ACTION_LOGS を選択し、配信先ログループを指定する。/aws/vendedlogs/ のプレフィックスが付いたロググループを指定する必要があり、デフォルトでは /aws/vendedlogs/ecs/action-logs/<cluster-name> という名前で自動作成される
  6. 必要に応じて記録するフィールドとその順序、出力形式を設定し、追加 を選択する

CLI での有効化

CLI から有効化する場合は、配信元の登録・配信先の設定・配信の作成という 3 ステップを順に行います。

まず、配信元(delivery source)を登録します。<delivery-source-name> は任意の名前です。

aws logs put-delivery-source \
    --name <delivery-source-name> \
    --resource-arn arn:aws:ecs:<region>:<account-id>:cluster/<cluster-name> \
    --log-type ACTION_LOGS

次に、配信先(delivery destination)を設定します。<delivery-destination-name> も任意の名前です。

aws logs put-delivery-destination \
    --name <delivery-destination-name> \
    --output-format json \
    --delivery-destination-configuration '{"destinationResourceArn": "arn:aws:logs:<region>:<account-id>:log-group:/aws/vendedlogs/ecs/action-logs/<cluster-name>"}'

最後に、配信元と配信先を紐づける配信(delivery)を作成します。

aws logs create-delivery \
    --delivery-source-name <delivery-source-name> \
    --delivery-destination-arn arn:aws:logs:<region>:<account-id>:delivery-destination:<delivery-destination-name>

有効化の確認

設定後、クラスター内でデーモンサービスの作成・更新などのアクションを実行し、CloudWatch コンソールの ロググループ から対象のロググループを開いて、新しいログストリームが作成されているかを確認します。CloudWatch Logs へ配信している場合は、Amazon ECS コンソール上でもログの表示・フィルタリングが可能です。

無効化

Action Logs は、コンソールの 設定 タブから該当のログ配信を選んで 削除 するか、CLI であれば delete-delivery、delete-delivery-source、delete-delivery-destination を順に実行することで無効化できます。この操作には logs:DeleteDelivery、logs:DeleteDeliverySource、logs:DeleteDeliveryDestination の権限が別途必要です。


運用のポイント

コスト設計

Action Logs 自体に個別の追加費用はなく、標準の CloudWatch Logs・Amazon S3・Amazon Data Firehose の料金がログの取り込みと保存に適用されます。コンソールから CloudWatch Logs を配信先として有効化した場合、ロググループの保持期間はデフォルトで 7 日間に設定されますが、配信先側の設定で自由に変更できます。本番環境では障害調査に必要な期間を見込んで長めに、開発環境ではコストを抑えるために短めに設定する、といった環境ごとの調整を検討するとよいでしょう。

また、有効化時の「フィールドの選択」で、各ログレコードに含めるフィールドとその順序を指定できます。すべてのフィールドを記録する必要がない場合は、必要なフィールドに絞ることで、ログの取り込み量そのものを抑えることもできます。

アラート設計

Action Logs を有効にしただけでは、問題が起きたことを能動的に知らせてはくれません。CloudWatch Logs へ配信している場合は、logLevel が ERROR のログエントリを検出する CloudWatch Metric Filter を作成し、CloudWatch Alarm と組み合わせておくと、デプロイ失敗をリアルタイムで検知できます。これは Action Logs 固有の機能ではなく、CloudWatch Logs の一般的な機能を組み合わせた運用上の工夫です。

ログレベルと運用

各ログエントリの logLevel(INFO / WARN / ERROR)は、配信するログの種類を絞り込むための設定項目ではなく、ログエントリ自体に含まれる属性の一つです。つまり、配信を有効にすると全レベルのログがまとめて配信される前提で運用を考える必要があります。平常時のログ量が多いと感じる場合は、前述のフィールド選択で必要な情報に絞ったり、CloudWatch Logs Insights のクエリで logLevel が WARN 以上のものだけを抽出したりする形で対処するのが現実的です。


まとめ

Amazon ECS の Action Logs により、これまで ECS の内部でしか行われていなかったデプロイメントや Managed Daemon の操作を、クラスター単位のオプトインだけでタイムスタンプ付きのログとして可視化できるようになりました。障害発生時に AWS サポートへ問い合わせたり複数のログソースを手動で突き合わせたりする手間が減り、Amazon Q との連携によって典型的な問題は自動診断まで受けられます。

一方で、Action Logs はクラスター単位でのオプトインが必要な機能であり、CloudWatch Logs・S3・Data Firehose いずれの配信先を選んでも標準の利用料金が発生します。導入する際は、保持期間やフィールド選択によるコストのコントロール、ERROR ログをトリガーにしたアラート設計など、運用面の設計もあわせて検討することをおすすめします。


参考リンク

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?