🔍aws-observability
- プラグイン
- aws-core
- ソース
- GitHub で見る ↗
説明
AWSのobservability（CloudWatch Log Insights、Metrics、Alarms、Dashboards、EMF）、X-Ray、CloudTrail、ADOT（AWS Distro for OpenTelemetry）を使用した構築、設定、デバッグ、最適化を行い、さらにADOT auto-instrumentation SDKsを使用してApplication Signalsへのサービス有効化・オンボーディングを実現します。 Log Insightsクエリ、アラーム（メトリクス、複合、異常検知）、ダッシュボード、カスタムメトリクス/EMF、X-Rayトレーシングとサンプリング、ADOTコレクタ設定、CloudTrail監査、EC2・ECS・EKS・Lambda上のPython・Node.js・Java・.NETを対象としたADOT SDKsによるエンドツーエンドのApplication Signals有効化（CloudWatch Observability EKS add-on、CloudWatch Agent IAM、OTLPエンドポイント、ServiceEvents、Dynamic Instrumentation）をカバーしています。 次のような場合に使用: CloudWatch、アラーム、ダッシュボード、EMF、X-Ray、traces、CloudTrail、ADOT、monitoring、synthetics/canariesの操作、または ADOT、ServiceEvents、auto-instrumentation を使用したサービスのApplication Signals有効化・オンボーディング・計測、あるいはサービスを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) on EC2, ECS, EKS, and Lambda in Python, Node.js, Java, and .NET. Applies to CloudWatch, alarms, dashboards, EMF, X-Ray, traces, CloudTrail, ADOT, monitoring, synthetics/canaries, OR enabling/onboarding/instrumenting a service for Application Signals using ADOT, ServiceEvents, auto-instrumentation, or making a service show up in Application Signals. Not for app logging or security threat detection.
ユースケース
- ✓CloudWatchのログ、メトリクス、アラームを構築・設定するとき
- ✓X-Rayでトレーシングとサンプリングを設定するとき
- ✓ADOTでアプリケーション計測を有効化するとき
- ✓Application Signalsへサービスをオンボーディングするとき
- ✓CloudTrailで監査ログを確認するとき
本文（日本語訳）
AWS Observability
概要
メトリクス、ログ、トレースにわたるAWSオブザーバビリティの領域専門知識を提供します。ライフサイクル全体をカバーしており、ADOT（AWS Distro for OpenTelemetry）オートインストルメンテーションSDKを使用したApplication Signalsの有効化・オンボーディングから、CloudWatch アラーム、ダッシュボード、Log Insights、カスタムメトリクス、EMF、X-Ray トレース分析、CloudTrail 監査、ADOT コレクター設定による運用まで対応しています。
最適な組み合わせ: AWS MCP serverと連携することで、CLIコマンドの実行、CloudWatchのクエリ、設定の直接検証が可能になります。すべてのガイダンスは標準的なAWS CLI アクセスでも利用できます。
注意: リファレンスファイルには、特定のランタイムバージョン、クォータ値、機能マトリックスが含まれていますが、これらは変更される可能性があります。精度が重要な場合（本番環境へのデプロイ、ランタイムの選択、クォータの確認など）は、これらのファイルの値のみに依存せず、最新のAWSドキュメントで値を確認してください。
ルーティング
| ユーザーのニーズ | アクション |
|---|---|
| サービスのApplication Signals対応（オートインストルメンテーション） | application-signals-onboarding.mdを参照 |
| CI/CDを通じたServiceEventsのgit/デプロイメントメタデータの伝播 | application-signals-cicd-metadata.mdを参照 |
| プラットフォーム・言語別の有効化ステップ | 対応するreferences/appsignals-guides/<platform>-<language>.mdを参照（例：eks-python.md） |
| Log Insightsクエリの作成 | log-insights.mdを参照 |
| アラームの設定（メトリクス、複合、異常検知） | alarms.mdを参照 |
| カスタムメトリクスの公開またはEMFの使用 | metrics.mdを参照 |
| X-Ray トレーシングまたはADOTのセットアップ | tracing.mdを参照 |
| ダッシュボードの構築 | dashboards.mdを参照 |
| オブザーバビリティの問題のデバッグ | troubleshooting.mdを参照。最も一般的な5つの修正から開始 |
| キャナリア障害のデバッグ | synthetics.mdを参照。一般的な障害テーブルを確認 |
| CloudTrail運用監査 | cloudtrail.mdを参照 |
| CDKでLambdaモニタリングをセットアップ | alarm-template.tsをスタートポイントとして使用 |
| 合成キャナリアの作成 | synthetics.mdを参照 |
| ADOTコレクターの設定 | otel-config.yamlをスタートポイントとして使用 |
| 複数の領域にまたがる場合 | 最も具体的なリファレンスを読み、必要に応じて他も参照 |
ファイル一覧
| ファイル | 内容 |
|---|---|
| application-signals-onboarding.md | Application Signalsオートインストルメンテーションの有効化：EKS add-on、CloudWatch Agent IAM、OTLPエンドポイント、ServiceEvents環境変数、Dynamic Instrumentation — プラットフォーム・言語別の2階層スコープ |
| application-signals-cicd-metadata.md | CI/CDを通じたServiceEventsのgit・デプロイメントメタデータ伝播（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 メタデータ、コレクター設定 |
| dashboards.md | ウィジェットタイプ、クロスアカウント・リージョン、動的ラベル、共有 |
| troubleshooting.md | すべてのオブザーバビリティサービスの エラー → 原因 → 修正マッピング |
| cloudtrail.md | 運用監査、イベント種別、S3+Athenaクエリ |
| synthetics.md | キャナリアランタイム・ブループリント制約、VPCネットワーキング、一般的な障害 |
| alarm-template.ts | ベストプラクティスのCDK Lambda監視（アラーム＋ダッシュボード） |
| otel-config.yaml | X-Ray トレース＋CloudWatch EMF メトリクス用のADOTコレクター設定 |
原文（English）を表示
AWS Observability
Overview
Domain expertise for AWS observability across metrics, logs, and traces, covering the full lifecycle: enabling/onboarding Application Signals on a service using ADOT (AWS Distro for OpenTelemetry) auto-instrumentation SDKs through operating it (CloudWatch alarms, dashboards, Log Insights, custom metrics, EMF, X-Ray trace analysis, CloudTrail auditing, ADOT collector config).
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 |
| 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 |
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。