AWS の可視化（システムの動作状況の把握）を CloudWatch（ログ検索、メトリクス、アラーム、ダッシュボード、EMF）、X-Ray、CloudTrail、ADOT（AWS Distro for OpenTelemetry）を使って構築・設定・デバッグ・最適化し、さらに ADOT の自動計測 SDK（ソフトウェア開発キット）を用いてサービスを Application Signals に対応させます。 対応内容は、ログ検索クエリ、アラーム（メトリクス・複合・異常検知）、ダッシュボード、カスタムメトリクス/EMF、X-Ray のトレース（通信の追跡）と抽出、ADOT コレクタ（データ収集）の設定、CloudTrail による監査、ADOT SDK を使った Application Signals の全体的な対応（CloudWatch Observability EKS add-on、CloudWatch Agent IAM、OTLP エンドポイント、ServiceEvents、Dynamic Instrumentation）、Dynamic Instrumentation でのブレークポイント（一時停止地点）とスナップショット（状態の記録）、稼働中のサービスからのライブデータ取得、再デプロイ（再配置）なしのデバッグを含みます。 次のような場合に使用: CloudWatch、アラーム、ダッシュボード、EMF、X-Ray、トレース、CloudTrail、ADOT、監視、合成テスト（自動確認）に関すること、またはサービスを Application Signals に対応・設定・計測する場合 対応していない領域: アプリケーションのログ出力、セキュリティ脅威の検出
Builds, configures, debugs, and optimizes AWS observability with CloudWatch (Log Insights, Metrics, Alarms, Dashboards, EMF), X-Ray, CloudTrail, and ADOT (AWS Distro for OpenTelemetry), AND enables/onboards services to Application Signals using ADOT auto-instrumentation SDKs. Covers Log Insights queries, alarms (metric, composite, anomaly), dashboards, custom metrics/EMF, X-Ray tracing and sampling, ADOT collector config, CloudTrail auditing, and end-to-end Application Signals enablement via ADOT SDKs (CloudWatch Observability EKS add-on, CloudWatch Agent IAM, OTLP endpoints, ServiceEvents, Dynamic Instrumentation), breakpoint and snapshot in Dynamic Instrumentation, live data capture in running service, debug without redeploying. Applies to CloudWatch, alarms, dashboards, EMF, X-Ray, traces, CloudTrail, ADOT, monitoring, synthetics/canaries, OR enabling/onboarding/instrumenting a service for Application Signals. Not for app logging or security threat detection.
AWS のメトリクス（数値指標）・ログ・トレース（処理の流れ追跡）にわたるオブザーバビリティ（システムの動作を可視化する機能）の専門知識を提供します。ADOT（AWS Distro for OpenTelemetry。AWS が提供するテレメトリ収集ツール）の自動装備 SDK と ServiceEvents を使って、サービスを Application Signals（AWS のアプリケーション監視機能）に対応させるまでの全プロセスをカバーしています。EC2・ECS・EKS・Lambda 上で、Python・Node.js・Java・.NET 言語に対応しています。
最適な使用環境: AWS MCP サーバーと組み合わせると、CLI コマンドの実行・CloudWatch（クラウド監視サービス）への問い合わせ・設定検証が直接実行できます。標準的な AWS CLI アクセスでも全てのガイダンスが利用できます。
注意: リファレンスファイルは特定のランタイムバージョン・クォータ値・機能一覧を含んでおり、これらは変更される可能性があります。本番環境への導入・ランタイムの選択・クォータ確認など精度が重要な場合は、これらのファイルの情報だけに頼らず、必ず最新の AWS 公式ドキュメントで値を確認してください。
| ご質問の内容 | 参照する資料 |
|---|---|
| サービスを Application Signals に対応させたい（自動装備） | application-signals-onboarding.md をお読みください |
| CI/CD 経由で ServiceEvents のメタデータ（Git・デプロイ情報）を連携したい | application-signals-cicd-metadata.md をお読みください |
| プラットフォーム・言語ごとの対応手順が知りたい | 対応する references/appsignals-guides/<プラットフォーム>-<言語>.md をお読みください（例: eks-python.md） |
| Log Insights（ログ検索言語）でクエリを書きたい | log-insights.md をお読みください |
| アラーム（警告ルール）を設定したい（メトリクス・複合・異常検知） | alarms.md をお読みください |
| カスタムメトリクスを発行したい・EMF を使いたい | metrics.md をお読みください |
| X-Ray トレーシングまたは ADOT を設定したい | tracing.md をお読みください |
| ダッシュボードを作りたい | dashboards.md をお読みください |
| オブザーバビリティの問題をデバッグしたい | troubleshooting.md をお読みください（最も一般的な 5 つの解決法から始まります） |
| Canary（自動テスト）の失敗を調査したい | synthetics.md をお読みください（よくある失敗の表を参照） |
| CloudTrail で操作履歴を監査したい | cloudtrail.md をお読みください |
| CDK で Lambda 監視をセットアップしたい | alarm-template.ts をテンプレートにしてください |
| 合成 Canary を作りたい | synthetics.md をお読みください |
| ADOT Collector（データ収集ツール）を設定したい | otel-config.yaml をテンプレートにしてください |
| 実行中のサービスをブレークポイント・スナップショットでデバッグしたい（Dynamic Instrumentation。実行中のサービスを修正し、リアルタイムデータを取得します） | dynamic-instrumentation.md を全文お読みになった上で実施してください。作成・削除の前に必ずユーザーに確認し、重大な操作の前には観察 → 仮説 → 提案アクション → 想定結果 の流れを説明してください。実行中のサービスの根本原因をソースコード検査から診断します。ソース検査だけでは仮説は立てられますが、根本原因は確定しません。ランタイム証拠で確定するまで、推定原因は暫定的なものとしてください。 |
| 複数の領域にまたがる | 最も具体的なリファレンスから読み始め、必要に応じて他も参照してください |
| ファイル | 内容 |
|---|---|
| application-signals-onboarding.md | Application Signals 自動装備の有効化：EKS アドオン・CloudWatch Agent IAM・OTLP エンドポイント・ServiceEvents 環境変数・Dynamic Instrumentation — プラットフォーム・言語ごとの 2 段階スコープ |
| application-signals-cicd-metadata.md | ServiceEvents の Git・デプロイメタデータを CI/CD 経由で連携（5 つの OTEL_AWS_SERVICE_EVENTS_* 変数） |
references/appsignals-guides/ （例: eks-python.md） |
16 種類のプラットフォーム × 言語別対応ガイド（EC2/ECS/EKS/Lambda × Python/Node.js/Java/.NET） |
| alarms.md | メトリクス・複合・異常検知アラーム — 設定・制約・推奨デフォルト値 |
| log-insights.md | 完全なクエリ構文・コマンド・関数・既知の問題・再利用可能なクエリライブラリ |
| metrics.md | カスタムメトリクス・EMF 仕様・メトリクスフィルター・高精度・保持期間 |
| tracing.md | X-Ray → ADOT への移行・サンプリングルール・アノテーション vs メタデータ・Collector 設定 |
| dashboards.md | ウィジェットタイプ・クロスアカウント/リージョン・動的ラベル・共有 |
| troubleshooting.md | 全オブザーバビリティサービスのエラー → 原因 → 解決策 |
| cloudtrail.md | 操作監査・イベントタイプ・S3+Athena クエリ |
| synthetics.md | Canary ランタイム・ブループリント制約・VPC ネットワーク・よくある失敗 |
| alarm-template.ts | ベストプラクティス CDK Lambda 監視（アラーム + ダッシュボード） |
| otel-config.yaml | ADOT Collector の設定例（X-Ray トレース + CloudWatch EMF メトリクス） |
| dynamic-instrumentation.md | Dynamic Instrumentation デバッグループ — ライブコード上のブレークポイント・プローブ・スナップショット取得と相関分析・作成/削除のゲーティング・スナップショット内の個人情報処理。scripts/di_instrumentation.py + scripts/di_snapshots.py で実行されます。 |
Domain expertise for AWS observability across metrics, logs, and traces, covering the full lifecycle: enabling/onboarding a service to Application Signals using ADOT (AWS Distro for OpenTelemetry) auto-instrumentation SDKs and ServiceEvents — making the service show up in Application Signals — on EC2, ECS, EKS, and Lambda in Python, Node.js, Java, and .NET.
Works best with the AWS MCP server — enables running CLI commands, querying CloudWatch, and validating configurations directly. All guidance also works with standard AWS CLI access.
Note: Reference files contain specific runtime versions, quota values, and feature matrices that may change. When precision matters (e.g., deploying to production, choosing a runtime, or checking a quota), confirm values against current AWS documentation rather than relying solely on the values in these files.
| User need | Action |
|---|---|
| Enabling/onboarding a service to Application Signals (auto-instrumentation) | Read application-signals-onboarding.md |
| Propagating ServiceEvents git/deployment metadata through CI/CD | Read application-signals-cicd-metadata.md |
| Per-platform/per-language enablement steps | Read the matching references/appsignals-guides/<platform>-<language>.md (e.g. eks-python.md) |
| Writing Log Insights queries | Read log-insights.md |
| Configuring alarms (metric, composite, anomaly) | Read alarms.md |
| Publishing custom metrics or using EMF | Read metrics.md |
| Setting up X-Ray tracing or ADOT | Read tracing.md |
| Building dashboards | Read dashboards.md |
| Debugging observability issues | Read troubleshooting.md — starts with the 5 most common fixes |
| Debugging canary failures | Read synthetics.md — see Common failures table |
| CloudTrail operational auditing | Read cloudtrail.md |
| Setting up Lambda monitoring with CDK | Use alarm-template.ts as a starting point |
| Creating synthetic canaries | Read synthetics.md |
| Configuring ADOT collector | Use otel-config.yaml as a starting point |
| Debugging a running service with breakpoints/snapshots — Dynamic Instrumentation (modifies live services and capture live data) | Read dynamic-instrumentation.md in full before acting. Confirm with the user before any create/delete, and narrate before significant actions: observation → hypothesis → proposed action → expected result. Diagnosing running-service root cause from source/code inspection. Source inspection alone identifies hypotheses, not confirmed root causes. Keep suspected causes tentative until runtime evidence confirms them. |
| Spans multiple areas | Read the most specific reference first, then consult others as needed |
| File | Content |
|---|---|
| application-signals-onboarding.md | Enable Application Signals auto-instrumentation: EKS add-on, CloudWatch Agent IAM, OTLP endpoints, ServiceEvents env vars, Dynamic Instrumentation — two-tier scope by platform/language |
| application-signals-cicd-metadata.md | ServiceEvents git & deployment metadata propagation through CI/CD (the 5 OTEL_AWS_SERVICE_EVENTS_* vars) |
references/appsignals-guides/ (e.g. eks-python.md) |
16 per-platform × per-language enablement guides (EC2/ECS/EKS/Lambda × Python/Node.js/Java/.NET) |
| alarms.md | Metric, composite, anomaly detection alarms — configuration, constraints, recommended defaults |
| log-insights.md | Complete query syntax, commands, functions, known issues, reusable query library |
| metrics.md | Custom metrics, EMF spec, metric filters, high-resolution, retention |
| tracing.md | X-Ray → ADOT migration, sampling rules, annotations vs metadata, collector config |
| dashboards.md | Widget types, cross-account/region, dynamic labels, sharing |
| troubleshooting.md | Error → cause → fix for all observability services |
| cloudtrail.md | Operational auditing, event types, S3+Athena queries |
| synthetics.md | Canary runtime/blueprint constraints, VPC networking, common failures |
| alarm-template.ts | Best-practice CDK Lambda monitoring (alarms + dashboard) |
| otel-config.yaml | ADOT collector config for X-Ray traces + CloudWatch EMF metrics |
| dynamic-instrumentation.md | Dynamic Instrumentation debugging loop — breakpoints/probes on live code, snapshot capture + correlation analysis, create/delete gating, snapshot PII handling. Runs via scripts/di_instrumentation.py + scripts/di_snapshots.py. |
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。