首頁
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 可觀測性提供領域專業知識，協助您在 AWS 上建置、設定、除錯及優化涵蓋指標、日誌與追蹤的可觀測性。 其涵蓋 CloudWatch 平台的功能——Log Insights、Metrics、Alarms、Dashboards 及 EMF——以及 X-Ray 追蹤、CloudTrail 運維稽核，以及 AWS Distro for OpenTelemetry (ADOT) 收集器。 具體涵蓋的領域包括 Log Insights 查詢語法（欄位、篩選器、統計、解析、模式、聯結、子查詢）、 警報設定（指標、複合型、異常偵測、缺失資料處理）、儀表板設計、透過 PutMetricData 建立自訂指標、EMF 及指標篩選器，以及 X-Ray 採樣規則，並能區分註解與元資料的差異。
當任務提及 CloudWatch、Log Insights、警報、INSUFFICIENT_DATA、儀表板、自訂指標、EMF、X-Ray、追蹤、採樣、CloudTrail、「誰刪除了」、 ADOT、OpenTelemetry、可觀察性、監控、合成監控、金絲雀測試，或警報行為的疑難排解時，可運用此技能。本技能明確不涵蓋應用程式日誌設定、容器日誌驅動程式，或安全威脅偵測。 若搭配 AWS MCP 伺服器使用效果最佳，該伺服器可讓代理程式執行 CLI 指令、查詢 CloudWatch 並直接驗證設定；不過，所有指引同樣適用於標準 AWS CLI 存取方式。
此技能以路由表形式組織，將每項使用者需求對應至特定的參考檔案：log-insights.md 用於查詢、alarms.md 用於警報配置與預設值、metrics.md 用於自訂指標與 EMF、tracing.md 用於 X-Ray 和 ADOT；dashboards.md 用於小工具設計及跨帳戶／區域共享；troubleshooting.md（開頭列出五項最常見的解決方案）；synthetics.md 用於金絲雀測試限制與常見故障；cloudtrail.md 則用於透過 S3 和 Athena 進行運維稽核。 內含兩項可直接使用的資源：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」狀態，該從何處著手除錯？
請先參閱 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.9 KB 檢視 references/metrics.md 7.4KB 檢視 references/troubleshooting.md 6.7KB 檢視 assets/otel-config.yaml 1.4KB 檢視 references/dashboards.md 5.8KB 檢視 references/synthetics.md 6.5 KB 檢視 SKILL.md 4.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
複製
