aws-observability
aws/agent-toolkit-for-aws
Desarrolla, configura, depura y optimiza la observabilidad de AWS utilizando CloudWatch (Logs Insights, Metrics, Alarms, Dashboards, EMF), X-Ray, CloudTrail y ADOT. Abarca la sintaxis de consulta de Log Insights (campos, filtros, estadísticas, análisis, patrones, uniones, subconsultas), la configuración de alarmas (métricas, compuestas, detección de anomalías, tratamiento de datos faltantes), el diseño de paneles de control, las métricas personalizadas (PutMetricData, EMF, filtros de métricas), el rastreo con X-Ray (ADOT, reglas de muestreo, anotaciones frente a metadatos), la configuración del colector ADOT y CloudT
...Expandir todoAcerca de aws-observability
AWS Observability ofrece conocimientos especializados para crear, configurar, depurar y optimizar la observabilidad en AWS en lo que respecta a métricas, registros y trazas. Abarca las capacidades de la plataforma CloudWatch —Logs Insights, Métricas, Alarmas, Paneles de control y EMF—, junto con el rastreo de X-Ray, la auditoría operativa de CloudTrail y el colector de AWS Distro for OpenTelemetry (ADOT). Entre las áreas específicas se incluyen la sintaxis de consulta de Log Insights (campos, filtros, estadísticas, análisis, patrones, uniones y subconsultas), la configuración de alarmas (métricas, compuestas, detección de anomalías, tratamiento de datos faltantes), el diseño de paneles, las métricas personalizadas mediante PutMetricData, EMF y los filtros de métricas, además de las reglas de muestreo de X-Ray y la distinción entre anotaciones y metadatos.
Utiliza esta habilidad cuando una tarea mencione CloudWatch, Log Insights, alarmas, INSUFFICIENT_DATA, paneles de control, métricas personalizadas, EMF, X-Ray, trazas, muestreo, CloudTrail, «quién borró», ADOT, OpenTelemetry, observabilidad, supervisión, pruebas sintéticas, canarios o resolución de problemas relacionados con el comportamiento de las alarmas. No abarca, de forma explícita, la configuración del registro de aplicaciones, los controladores de registros de contenedores ni la detección de amenazas de seguridad. Funciona mejor junto con el servidor AWS MCP, que permite al agente ejecutar comandos de la CLI, consultar CloudWatch y validar configuraciones directamente, aunque todas las instrucciones también son aplicables con el acceso estándar a la CLI de AWS.
La skill está organizada como una tabla de enrutamiento que asocia cada necesidad del usuario a un archivo de referencia específico: log-insights.md para consultas, alarms.md para la configuración y los valores predeterminados de las alarmas, metrics.md para métricas personalizadas y EMF, tracing.md para X-Ray y ADOT, dashboards.md para el diseño de widgets y el uso compartido entre cuentas y regiones, troubleshooting.md (que se abre con las cinco soluciones más habituales), synthetics.md para restricciones de canario y fallos comunes, y cloudtrail.md para la auditoría operativa con S3 y Athena. Se incluyen dos recursos listos para usar: alarm-template.ts, una plantilla CDK basada en las mejores prácticas para la supervisión de Lambda con alarmas y un panel de control, y otel-config.yaml, una configuración del colector ADOT para rastros de X-Ray y métricas EMF de CloudWatch. Dado que los archivos de referencia contienen versiones de tiempo de ejecución, valores de cuota y matrices de características que cambian, la skill recomienda contrastar los valores que requieren precisión con la documentación actual de AWS antes de utilizarlos en producción.
Preguntas frecuentes
¿Qué servicios de AWS cubre esta skill?
Cubre CloudWatch (Logs Insights, Métricas, Alarmas, Paneles de control, EMF), el rastreo de X-Ray, la auditoría operativa de CloudTrail y el colector ADOT (OpenTelemetry) en métricas, registros y trazas.
¿Cuándo no debo utilizar esta skill?
No la utilices para la configuración de registros de aplicaciones, controladores de registros de contenedores ni detección de amenazas de seguridad. Esas áreas quedan expresamente fuera de su ámbito de aplicación.
¿Necesito el servidor AWS MCP para utilizarla?
No. Funciona mejor con el servidor AWS MCP, que permite ejecutar comandos de la CLI y validar configuraciones directamente, pero todas las instrucciones también funcionan con el acceso estándar a la CLI de AWS.
¿Dónde debo buscar para depurar una alarma atascada en INSUFFICIENT_DATA?
Empieza por el archivo troubleshooting.md, que comienza con las cinco soluciones más habituales, y consulta el archivo alarms.md para obtener detalles de configuración, incluido el tratamiento de datos faltantes para alarmas de métricas, compuestas y de detección de anomalías.
¿Se incluyen plantillas ya preparadas?
Sí. Se proporciona alarm-template.ts, una plantilla CDK basada en las mejores prácticas para la monitorización de Lambda con alarmas y un panel de control, y otel-config.yaml, una configuración del colector ADOT para trazas de X-Ray y métricas EMF de CloudWatch.
Todos los archivos
11archivosreferences/alarms.md 10,9KB Ver references/log-insights.md 6,9KB Ver references/tracing.md 8,9KB Ver assets/alarm-template.ts 3,9KB Ver references/cloudtrail.md 3,9KB Ver references/metrics.md 7,4KB Ver referencias/troubleshooting.md 6,7KB Ver activos/otel-config.yaml 1,4KB Ver referencias/dashboards.md 5,8KB Ver referencias/synthetics.md 6,5KB Ver SKILL.md 4,1 KB VerOverview
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. |
Todos los archivos
0 archivosInstalar aws-observability
Descarga y descomprime los archivos de habilidades en tu directorio .claude/skills/.
Descargar ZIPClona el repositorio y copia los archivos de la habilidad a tu proyecto.
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
Copiar





Hogar
