aws-observability
aws/agent-toolkit-for-aws
CloudWatch(Logs Insights、Metrics、Alarms、Dashboards、EMF)、X-Ray、CloudTrail、および ADOT を使用して、AWS の可観測性を構築、設定、デバッグ、および最適化します。 Log Insightsのクエリ構文(フィールド、フィルター、統計、解析、パターン、結合、サブクエリ)、アラーム設定(メトリクス、複合アラーム、異常検知、データ欠損の処理)、ダッシュボード設計、カスタムメトリクス(PutMetricData、EMF、メトリクスフィルター)、 X-Rayトレース(ADOT、サンプリングルール、アノテーションとメタデータの比較)、ADOTコレクターの設定、およびCloudT
...すべて拡張します概要aws-observability
AWS Observability は、メトリクス、ログ、トレースにわたり、AWS 上のオブザーバビリティを構築、設定、デバッグ、最適化するためのドメイン専門知識を提供します。 CloudWatchプラットフォームの機能(Logs Insights、Metrics、Alarms、Dashboards、EMF)に加え、X-Rayトレース、CloudTrailによる運用監査、AWS Distro for OpenTelemetry(ADOT)コレクターについても網羅しています。 具体的な分野としては、Logs Insights のクエリ構文(フィールド、フィルター、統計、解析、パターン、結合、サブクエリ)、 アラームの設定(メトリクス、複合アラーム、異常検出、データ欠損の処理)、ダッシュボードの設計、PutMetricDataによるカスタムメトリクス、EMF、メトリクスフィルターに加え、X-Rayのサンプリングルール、およびアノテーションとメタデータの区別が含まれます。
このスキルは、タスクでCloudWatch、Log Insights、アラーム、INSUFFICIENT_DATA、ダッシュボード、カスタムメトリクス、EMF、X-Ray、トレース、サンプリング、CloudTrail、「誰が削除したか」、 ADOT、OpenTelemetry、オブザーバビリティ、モニタリング、シンセティック、カナリア、またはアラーム動作のトラブルシューティングといった用語が記載されているタスクで活用してください。なお、アプリケーションのロギング設定、コンテナログドライバー、セキュリティ脅威の検出については、明示的に対象外としています。 このスキルは、AWS MCPサーバーと併用すると最も効果的です。AWS MCPサーバーを使用すると、エージェントがCLIコマンドを実行したり、CloudWatchをクエリしたり、設定を直接検証したりできますが、すべてのガイダンスは標準のAWS CLIアクセスでも適用されます。
このスキルは、各ユーザーのニーズを特定の参照ファイルにマッピングするルーティングテーブルとして構成されています。クエリについては log-insights.md、アラームの設定とデフォルトについては alarms.md、カスタムメトリクスとEMFについては metrics.md、X-RayおよびADOTのトレースについては tracing.md(X-RayおよびADOT用)、dashboards.md(ウィジェットのデザインおよびアカウント/リージョン間の共有用)、troubleshooting.md(最も一般的な5つの解決策から始まる)、synthetics.md(カナリア制約および一般的な障害用)、cloudtrail.md(S3およびAthenaを使用した運用監査用)などです。 すぐに使用できる2つのアセットが含まれています。「alarm-template.ts」は、アラームとダッシュボードを備えたLambdaモニタリングのためのベストプラクティスCDKテンプレートであり、「otel-config.yaml」は、X-RayトレースおよびCloudWatch EMFメトリクス用のADOTコレクター設定です。 参照ファイルには、変更される可能性のあるランタイムのバージョン、クォータ値、機能マトリックスが含まれているため、本番環境でこれらを信頼する前に、精度が重要な値については最新のAWSドキュメントと照らし合わせて確認することをお勧めします。
よくある質問
このスキルはどのAWSサービスを対象としていますか?
CloudWatch(Logs Insights、Metrics、Alarms、Dashboards、EMF)、X-Ray トレース、CloudTrail 運用監査、およびメトリクス、ログ、トレースにわたる ADOT(OpenTelemetry)コレクターに対応しています。
このスキルを使用すべきでない場合は?
アプリケーションのロギング設定、コンテナログドライバー、またはセキュリティ脅威の検出には使用しないでください。これらの領域は明示的に対象外となっています。
このスキルを使用するには、AWS MCPサーバーが必要ですか?
いいえ。AWS MCP サーバーと併用すると、CLI コマンドの実行や構成の直接検証が可能になるため、最も効果的に機能しますが、すべてのガイダンスは標準の AWS CLI アクセスでも同様に機能します。
INSUFFICIENT_DATA 状態で停止したアラームをデバッグするにはどこを確認すればよいですか?
まず、最も一般的な 5 つの解決策から始まる troubleshooting.md を確認し、メトリック、コンポジット、および異常検知アラームにおけるデータ欠落の処理を含む設定の詳細については alarms.md を参照してください。
既製のテンプレートは含まれていますか?
はい。「alarm-template.ts」という、アラームとダッシュボードを備えたLambdaモニタリング用のベストプラクティスCDKテンプレートと、「otel-config.yaml」という、X-RayトレースおよびCloudWatch EMFメトリクス用のADOTコレクター設定ファイルが提供されています。
すべてのファイル
11ファイル references/alarms.md10.9KB 表示 references/log-insights.md 6.9KB 表示 references/tracing.md 8.9 KB 表示 assets/alarm-template.ts 3.9KB 表示 references/cloudtrail.md 3.9KB 表示 references/metrics.md7.4KB 表示references/troubleshooting.md6.7KB 表示 assets/otel-config.yaml1.4KB 表示 references/dashboards.md5.8KB 表示 references/synthetics.md6.5KB 表示 SKILL.md4.1 KB 表示Overview
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.
Routing
| 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 |
Files
| 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. |
すべてのファイル
0件のファイルaws-observabilityをインストール
スキルファイルをダウンロードし、.claude/skills/ ディレクトリに解凍してください。
ZIPをダウンロードリポジトリをクローンし、スキルファイルをプロジェクトにコピーしてください。
git clone https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/core-skills/aws-observability/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
コピー





家
