Share
Embed
自動計装なしでECSサービスをApplication Signalsに載せるまで
JAWS-UGコンテナ支部 #31 ゆるLT大会のLT登壇資料です。
https://jawsug-container.connpass.com/event/400814/
Itaru Ota
November 16, 2026
Transcript
22 slides
-
自動計装なしでECSサービスを Application Signalsに載せるまで 2026/11/16 JAWS-UG コンテナ支部 #31 太田 暢 @iorandd
Copyright © 3-shake, Inc. All Rights Reserved. -
自己紹介 太田 暢 株式会社スリーシェイク Sreake事業部 アプリケーション開発支援チーム バックエンド・CI/CD 2026 Japan AWS
Jr. Champions 𝕏 @iorandd 2 -
と Amazon ECS AWS Fargate Amazon ECS コンテナの起動・停止・台数の維持を管理するサービス AWS Fargate
サーバを用意せずにコンテナを動かすECSの実行環境 AmazonECS サービス タスクの台数を維持 タスク 起動・停⽌ ⼀緒に動かすコンテナ タスク ⼀緒に動かすコンテナ AWSFargate タスクを動かす実⾏環境 What is Amazon Elastic Container Service? https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html 4 -
今回の想定 ECS Fargate で動くRust製の架空の商品カタログ公開API ECSFargateタスク 利⽤者 PublishCatalog catalog-api ①AmazonS3 CopyObject下書き→公開領域
Rust製のgRPCAPI ②AmazonSQS SendMessage索引更新を通知 5 -
上のAPIについて知りたいこと ECS 知りたいこと 取得元 足りない点 CPU・メモリの使用率 ECSの標準メトリクス リクエスト単位の情報がない リクエスト数・応答時間・エラー数 ECS
Service Connect Service Connect経由の通信だけが対象 サービス間の通信を仲介するECSの機能 1リクエストの合計時間 アプリケーションのログ 外部呼び出しごとの時間と失敗がない Amazon ECS CloudWatch metrics https://docs.aws.amazon.com/AmazonECS/latest/developerguide/available-metrics.html 6 -
CloudWatch Application Signals Application Signals Amazon CloudWatch 調査単位 Services Operations
Dependencies のAPM(アプリケーション性能監視)機能 対象 アプリケーション全体 API操作 外部の呼び出し先 調査できること どのサービスで障害が発生しているか どのAPI操作が遅いか どの依存先が遅延と障害の原因か カタログ公開APIの場合 catalog-api PublishCatalog Amazon S3 CopyObject Amazon SQS SendMessage 各単位にLatency・Error・Faultの指標が付く ・ ・ Services Operations Dependencies https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ServiceDetail.html 7 -
Application Signals 構成 ADOT の統合構成 の三つの導入方法 計測データを作る仕組みを入れる方法(計装) ADOTのエージェントによる自動計装 標準OpenTelemetryの構成 ゼロコード計装または手動計装
X-Ray SDK の構成 X-Ray SDK による計装 Supported instrumentation setups https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Getting-Started-App-Signals.html 今回の採否 見送り ADOTがRustに対応していない 採用 ADOTが対応していない言語でも使える 見送り 2026年2月からメンテナンスモード 8 -
( ) AWS Distro for OpenTelemetry ADOT ADOT AWS が検証して配布しサポートするOpenTelemetryの実装
含まれるもの ADOT SDKと自動計装エージェント 役割 アプリケーションのコードを変えずに計測データを作る ADOT Collector 計測データを受け取りAWSへ送る AWS Distro for OpenTelemetry https://aws-otel.github.io/ 9 -
Application Signals 言語 /.NET/Python/Node.js PHP/Ruby/Go Java Rust Rust 2026 の言語ごとの計装方法
のドキュメントに記載された計装方法 ADOTによる自動計装 標準OpenTelemetryによるゼロコード計装 対応言語の一覧になし 標準OpenTelemetryの構成を使う言語の例に記載 AWS では標準OpenTelemetry SDKを呼ぶコードを書く手動計装を採用 年11月15日現在 Supported systems https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-supportmatrix.html 10 -
Application Signals とOpenTelemetry ECSFargateタスク 利⽤者 PublishCatalog ①AmazonS3 catalog-api CopyObject下書き→公開領域 OpenTelemetrySDK
②AmazonSQS Rust製のgRPCAPI 計測データを作る OTLP SendMessage索引更新を通知 計測データを送る ApplicationSignals 表⽰と指標に使う What is OpenTelemetry? https://opentelemetry.io/docs/what-is-opentelemetry/ 11 -
の自動計装と今回のタスク構成 ADOT ADOTの⾃動計装のタスク(Javaの例) 標準OpenTelemetrySDKのタスク(今回) initコンテナ 先に起動しADOTのエージェントをボリュームへ置く 起動時のファイル配置 アプリケーション 環境変数でエージェントを読み込む spanと指標の送信
アプリケーション OpenTelemetrySDKを組み込みspanを作る spanの送信 CloudWatchagent CloudWatchagent サイドカー サイドカー Application Signals on Amazon ECS https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-ECS-Sidecar.html 12 -
リクエストを構成するtraceとspan 1 trace=1リクエスト分のspanのまとまり リクエストの受信 PublishCatalog 準備処理 S3の呼び出し SQSの呼び出し 箱の⼀つ⼀つがspan ⽮印は親⼦関係を表す
Traces https://opentelemetry.io/docs/concepts/signals/traces/ 13 -
CloudWatch Transaction Search Transaction Search AWS X-Ray span へ送った 項目
span をCloudWatch Logsへ保存し検索できるようにする機能 内容 の保存先 CloudWatch Logs 保存するspanの割合 100% 検索用の索引を作るspanの割合 既定値1% Application Signals との関係 CloudWatch のロググループ aws/spans が保存したspanからApplication Signalsの表示を作る Transaction Search https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html 14 -
タスクからX-Rayへspanを送る方法の比較 方法 アプリケーションからX-Rayへ直接送信 追加実装 のサイドカー なし Collector のサイドカー なし agent
ADOT Collector CloudWatch agent OTLP/HTTP の送信と認証 OTLP Endpoints https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html 運用するコンテナ なし 送信先と認証を設定 受信の設定1項目 今回の採否 見送り 署名の実装を持たない方針 見送り agentで同じ送信ができる 採用 15 -
の送信経路とApplication Signalsでの利用 span 通信経路 ECSFargateタスク RustgRPCAPI OTelSDK OTLP/gRPC localhost:4317 CloudWatchagent
サイドカー OTLP/HTTP SigV4署名 TransactionSearch有効化後の利⽤ CloudWatchLogsaws/spans 取り込んだspanの保存・検索 Transaction Search https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html AWSX-Ray spanを受け取るサービス 取り込み ApplicationSignals 表⽰と指標に利⽤ 16 -
依存先の表示を決めるspanのkind 外部サービスの呼び出しをCLIENTのspanとして記録する ライブラリが作るspanのkindが期待どおりかを確かめる kindにはメッセージの送受信を表すPRODUCERとCONSUMERもある PublishCatalogの受信 SERVER 準備処理 INTERNAL Span Kind
https://opentelemetry.io/docs/concepts/signals/traces/#span-kind S3CopyObject CLIENT SQSSendMessage CLIENT 19 -
可用性を決めるspanのstatus Application Signals の指標 数える対象 Error HTTP 4xx Fault HTTP
5xx とstatusがERRORのspan は (1 − Fault ÷ 指標へ集計されたリクエスト数) × 100 で求められる 入力誤りまでERRORにするとサーバが正常でもAvailabilityが下がる ERRORにする応答をサーバ側の失敗に限る Availability Metrics collected by Application Signals https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-MetricsCollected.html 20 -
全リクエストの集計を決めるサンプリング 標準OpenTelemetryの構成ではサンプリング率100%で送る 送らなかったリクエストは指標に入らない 構成 ADOT SDK + CloudWatch Agent 全リクエストの集計
トレースを間引いても全件のメトリクスを取得できる 標準OTel SDK + Collector 全件を集計するには100%サンプリングが必要 Supported instrumentation setups https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Getting-Started-App-Signals.html 21 -
まとめ 自動計装のないRust製APIも標準OpenTelemetry SDKとCloudWatch agentで監視できる gRPCの操作ごとの指標と外部の呼び出し先がApplication Signalsに表示される 手動計装ではspanの中身を計装の前に決める ECSFargateタスク Rust製API OpenTelemetrySDK
CloudWatch agent X-Ray Application Signals 22