opción

aws-observability

aws/agent-toolkit-for-aws 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 todo
17
Tiempo actualizado 24 de agosto de 2026

Acerca 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 Ver
Ver en GitHub

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 needAction
Enabling/onboarding a service to Application Signals (auto-instrumentation)Read application-signals-onboarding.md
Propagating ServiceEvents git/deployment metadata through CI/CDRead application-signals-cicd-metadata.md
Per-platform/per-language enablement stepsRead the matching references/appsignals-guides/<platform>-<language>.md (e.g. eks-python.md)
Writing Log Insights queriesRead log-insights.md
Configuring alarms (metric, composite, anomaly)Read alarms.md
Publishing custom metrics or using EMFRead metrics.md
Setting up X-Ray tracing or ADOTRead tracing.md
Building dashboardsRead dashboards.md
Debugging observability issuesRead troubleshooting.md — starts with the 5 most common fixes
Debugging canary failuresRead synthetics.md — see Common failures table
CloudTrail operational auditingRead cloudtrail.md
Setting up Lambda monitoring with CDKUse alarm-template.ts as a starting point
Creating synthetic canariesRead synthetics.md
Configuring ADOT collectorUse 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 areasRead the most specific reference first, then consult others as needed

Files

FileContent
application-signals-onboarding.mdEnable 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.mdServiceEvents 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.mdMetric, composite, anomaly detection alarms — configuration, constraints, recommended defaults
log-insights.mdComplete query syntax, commands, functions, known issues, reusable query library
metrics.mdCustom metrics, EMF spec, metric filters, high-resolution, retention
tracing.mdX-Ray → ADOT migration, sampling rules, annotations vs metadata, collector config
dashboards.mdWidget types, cross-account/region, dynamic labels, sharing
troubleshooting.mdError → cause → fix for all observability services
cloudtrail.mdOperational auditing, event types, S3+Athena queries
synthetics.mdCanary runtime/blueprint constraints, VPC networking, common failures
alarm-template.tsBest-practice CDK Lambda monitoring (alarms + dashboard)
otel-config.yamlADOT collector config for X-Ray traces + CloudWatch EMF metrics
dynamic-instrumentation.mdDynamic 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 archivos

Instalar aws-observability

Descarga y descomprime los archivos de habilidades en tu directorio .claude/skills/.

Descargar ZIP

Clona 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 Copiar
Configuración rápida: Copia la carpeta de la habilidad en .claude/skills/. Claude la detectará automáticamente y la utilizará.

Habilidades relacionadas

Cloudflare Manager
Tiempo actualizado 29 de junio de 2026
pinecone
Tiempo actualizado 29 de junio de 2026
azure-setup-guide
Tiempo actualizado 29 de junio de 2026
sentry-architecture-variants
Tiempo actualizado 29 de junio de 2026
OR