---
id: gh-aws-observability
name: "aws-observability"
url: https://skills.yangsir.net/skill/gh-aws-observability
author: aws
domain: ai-system-observability-sre
tags: ["aws", "observability", "cloudwatch", "monitoring", "troubleshooting"]
install_count: 9800
rating: 4.50 (120 reviews)
github: https://github.com/aws/agent-toolkit-for-aws/tree/main/plugins/aws-core/skills/aws-observability
---

# aws-observability

> 此技能专注于构建、配置、调试和优化 AWS 可观测性，涵盖 CloudWatch (日志洞察、指标、告警、仪表盘)、X-Ray、CloudTrail 和 ADOT。它能帮助用户快速解决可观测性问题，优化监控配置，确保系统稳定高效运行，并支持日志查询、告警设置和追踪分析。

**Stats**: 9,800 installs · 4.5/5 (120 reviews)

## Before / After 对比

### AWS 可观测性配置时间

**Before**:

手动配置 AWS CloudWatch、X-Ray 和 CloudTrail 等服务，需要查阅大量文档，编写复杂的查询语句和告警规则，耗时且容易出错，导致监控系统上线缓慢。

**After**:

利用此技能，可以快速生成 Log Insights 查询、告警配置和 ADOT 设置，大幅减少手动操作和调试时间，加速可观测性系统的部署和优化，确保关键业务快速获得全面监控。

| Metric | Before | After | Change |
|---|---|---|---|
| 配置时间 | 120分钟 | 15分钟 | -87% |

## Readme

# AWS Observability

## Overview

Domain expertise for AWS observability across metrics, logs, and traces. Covers CloudWatch platform capabilities (alarms, dashboards, Log Insights, custom metrics, EMF), X-Ray trace analysis, CloudTrail operational auditing, and ADOT collector configuration.

**Works best with** the [AWS MCP server](https://docs.aws.amazon.com/aws-mcp/) — 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 |
|-----------|--------|
| Writing Log Insights queries | Read [log-insights.md](references/log-insights.md) |
| Configuring alarms (metric, composite, anomaly) | Read [alarms.md](references/alarms.md) |
| Publishing custom metrics or using EMF | Read [metrics.md](references/metrics.md) |
| Setting up X-Ray tracing or ADOT | Read [tracing.md](references/tracing.md) |
| Building dashboards | Read [dashboards.md](references/dashboards.md) |
| Debugging observability issues | Read [troubleshooting.md](references/troubleshooting.md) — starts with the 5 most common fixes |
| Debugging canary failures | Read [synthetics.md](references/synthetics.md) — see Common failures table |
| CloudTrail operational auditing | Read [cloudtrail.md](references/cloudtrail.md) |
| Setting up Lambda monitoring with CDK | Use [alarm-template.ts](assets/alarm-template.ts) as a starting point |
| Creating synthetic canaries | Read [synthetics.md](references/synthetics.md) |
| Configuring ADOT collector | Use [otel-config.yaml](assets/otel-config.yaml) as a starting point |
| Spans multiple areas | Read the most specific reference first, then consult others as needed |

## Files

| File | Content |
|------|---------|
| [alarms.md](references/alarms.md) | Metric, composite, anomaly detection alarms — configuration, constraints, recommended defaults |
| [log-insights.md](references/log-insights.md) | Complete query syntax, commands, functions, known issues, reusable query library |
| [metrics.md](references/metrics.md) | Custom metrics, EMF spec, metric filters, high-resolution, retention |
| [tracing.md](references/tracing.md) | X-Ray → ADOT migration, sampling rules, annotations vs metadata, collector config |
| [dashboards.md](references/dashboards.md) | Widget types, cross-account/region, dynamic labels, sharing |
| [troubleshooting.md](references/troubleshooting.md) | Error → cause → fix for all observability services |
| [cloudtrail.md](references/cloudtrail.md) | Operational auditing, event types, S3+Athena queries |
| [synthetics.md](references/synthetics.md) | Canary runtime/blueprint constraints, VPC networking, common failures |
| [alarm-template.ts](assets/alarm-template.ts) | Best-practice CDK Lambda monitoring (alarms + dashboard) |
| [otel-config.yaml](assets/otel-config.yaml) | ADOT collector config for X-Ray traces + CloudWatch EMF metrics |


---
*Source: https://skills.yangsir.net/skill/gh-aws-observability*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-aws-observability/markdown*