AWS Builder Center

Service Events en Amazon CloudWatch Application Signals: el detalle ya estaba capturado

Amazon CloudWatch Application Signals presento Service Events. La funcion captura, sin cambios de codigo, metricas de error, datos de rendimiento a nivel de funcion, instantaneas de incidente cuando una peticion supera el umbral de latencia o lanza una excepcion, y eventos de despliegue. El detalle forense queda registrado en el instante del fallo, no reconstruido despues, y la correlacion con el despliegue reciente acorta el camino del sintoma a la hipotesis durante la guardia.

Cuando una petición se cae a las tres de la madrugada, el problema rara vez es la falta de datos. El problema es que el dato que importa vivía en un intervalo de muestreo que ya pasó, en un log que rotó, o en una traza que nadie guardó porque en ese momento todo parecía normal. Esta serie gira alrededor de tres decisiones que se toman antes de la guardia y no durante ella: qué señal observar, qué umbral la convierte en alerta, y qué pasos sigue quien responde. Service Events, la función que Amazon CloudWatch Application Signals presentó el 6 de julio de 2026, se mete de lleno en la primera de esas decisiones desde un ángulo poco habitual. En lugar de pedirte que reconstruyas lo que pasó, guarda el detalle de alta fidelidad en el instante exacto en que algo se rompe.
La diferencia parece sutil hasta que la vives. Un incidente clásico se investiga hacia atrás: alguien recibe la alerta, abre el panel, encuentra un pico de latencia, salta a los logs, intenta correlacionar la hora con un despliegue reciente y arma una hipótesis con las piezas que sobrevivieron. Service Events invierte ese orden. El detalle forense se captura en el momento del fallo, no se reconstruye después.

Qué agrega Service Events

Amazon CloudWatch Application Signals ya recopila de forma automática las señales de oro de cada servicio: latencia, throughput, errores y fallos, y disponibilidad. Lo hace mediante instrumentación automática basada en OpenTelemetry, sin que el equipo tenga que escribir código de telemetría a mano. Sobre esa base, Service Events suma una capa de observabilidad profunda que se activa sin cambios de código adicionales. Captura cuatro cosas:
  1. Métricas de error, con el recuento por tipo de excepción en cada operación.
  1. Datos de rendimiento a nivel de función, para ver dónde se fue el tiempo dentro de la ejecución. Esta parte es opcional: la instrumentación de funciones no produce métricas hasta que defines qué paquetes instrumentar con la variable  OTEL_AWS_SERVICE_EVENTS_PACKAGES_INCLUDE .
  1. Instantáneas de incidente (incident snapshots), capturadas cuando una petición supera los umbrales de latencia definidos o lanza una excepción.
  1. Eventos de despliegue, marcadores que la aplicación emite al arrancar y cada 24 horas. Si defines metadatos como  OTEL_AWS_SERVICE_EVENTS_GIT_COMMIT_SHA  u  OTEL_AWS_SERVICE_EVENTS_DEPLOYMENT_ID , el evento queda vinculado al commit o al despliegue concreto.
La instantánea de incidente es la pieza central. Es el detalle de alta fidelidad (traza de pila, árbol de llamadas, datos de quien hizo la llamada y contexto de la operación) que queda registrado justo cuando se cruza un umbral o salta una excepción. No es una muestra periódica ni una reconstrucción posterior. Es el estado real del servicio en el segundo en que las cosas dejaron de ir bien.

De reconstruir a tener capturado

Vale la pena detenerse en el cambio de mentalidad, porque es el corazón de esta entrega de la serie. Durante años, la observabilidad de aplicaciones se apoyó en muestreo. Se guarda un porcentaje de las trazas, se agregan métricas cada minuto, se retienen logs unos días. El muestreo es razonable para el estado normal, pero tiene un defecto conocido: los eventos raros, que son precisamente los que causan incidentes, tienen alta probabilidad de caer fuera de la muestra. Cuando llega la guardia y busca la traza del fallo, con frecuencia esa traza específica no se guardó.
La instantánea de incidente rompe esa dinámica porque su disparador no es el azar del muestreo sino la condición de fallo. Si una petición supera el umbral de latencia, se captura. Si lanza una excepción, se captura. El evento raro que antes se escapaba ahora es exactamente el criterio de captura. La señal correcta deja de ser algo que se persigue después del incidente y pasa a ser algo que ya está esperando cuando quien responde abre la consola.
Este es el hilo que conecta con el resto de la serie. La señal correcta no sirve de nada si llega tarde o incompleta. Service Events la deja lista antes de que se necesite.

El snapshot como señal, el umbral como objetivo

Traducido al lenguaje de las tres decisiones, el reparto queda claro.
La señal es la instantánea de incidente: el detalle de alta fidelidad capturado en el momento del fallo, con la traza de pila, el árbol de llamadas y el contexto de la operación.
El objetivo es el umbral que dispara la captura. Por defecto, una petición que supera 5000 milisegundos genera una instantánea; ese valor global se cambia con  OTEL_AWS_SERVICE_EVENTS_INCIDENT_SNAPSHOT_DURATION_THRESHOLD_MS , y  OTEL_AWS_SERVICE_EVENTS_LATENCY_THRESHOLDS  permite fijar umbrales por endpoint, por ejemplo POST /checkout:8000. La captura tiene límites: por defecto, hasta 100 instantáneas por minuto y una por cada error repetido en la misma ventana. Aquí conviene ser deliberado. El umbral de latencia no es un número decorativo; define qué se considera un fallo digno de una instantánea. Si se fija demasiado alto, se pierden degradaciones reales. Si se fija demasiado bajo, se llena de ruido y la señal pierde valor. Fijar ese umbral con criterio es la misma disciplina que fijar un objetivo de nivel de servicio: hay que conocer el comportamiento normal del servicio para saber dónde empieza lo anómalo.
El runbook arranca desde la instantánea más el evento de despliegue correlacionado. Quien responde no empieza con una pantalla en blanco. Empieza con el detalle del fallo y con el cambio más reciente que pudo causarlo. El primer paso del runbook deja de ser "reunir contexto" y pasa a ser "leer el contexto que ya está ahí".

La correlación con despliegues

El segundo elemento que aporta valor inmediato es el evento de despliegue. Una regresión de rendimiento casi siempre tiene una causa reciente, y muy a menudo esa causa es un cambio que entró en producción. El patrón mental de cualquier persona con años de guardia es el mismo: cuando algo empeora, la primera pregunta es qué cambió.
Service Events responde esa pregunta sin que haya que ir a buscarla a otro sistema. Los eventos de despliegue se registran junto al resto de los datos de Service Events del servicio, y en la pestaña Errors del servicio, dentro de Application Signals, se puede ver si un despliegue introdujo excepciones nuevas. No garantiza causalidad (un despliegue coincidente en el tiempo no siempre es el culpable), pero acorta de forma real el camino entre el síntoma y la hipótesis.

Cómo se ve en la práctica

Imagina un servicio de procesamiento de pedidos instrumentado con Amazon CloudWatch Application Signals. Se define un umbral de latencia para la operación de confirmación de pedido. Cuando una petición cruza ese umbral, Service Events captura la instantánea con la traza de pila y el árbol de llamadas.
Un flujo de investigación con la interfaz de línea de comandos podría empezar por listar los servicios monitorizados y luego revisar los estados de cambio recientes, como los despliegues, dentro de la ventana del incidente. Los dos comandos exigen el inicio y el fin de la ventana:
aws application-signals list-services --start-time 2026-07-10T02:00:00Z --end-time 2026-07-10T03:00:00Z --region us-east-1
aws application-signals list-service-states --start-time 2026-07-10T02:00:00Z --end-time 2026-07-10T03:00:00Z --region us-east-1
La instantánea se consulta en la consola, en la pestaña Errors del servicio dentro de Application Signals, o con CloudWatch Logs Insights sobre el grupo /aws/service-events/nombre-del-servicio.
Con la instantánea a la vista, la traza de pila y el árbol de llamadas suelen mostrar dónde se concentró el problema: una llamada a base de datos que se disparó, una dependencia externa que empezó a responder lento, un bloqueo en una sección del código. Ese detalle estaba disponible desde el segundo del fallo, no reconstruido a partir de logs dispersos.
El evento de despliegue correlacionado completa la foto. Si media hora antes entró una versión nueva del servicio, el evento de despliegue lo registra, y con los metadatos de despliegue se puede llegar al commit concreto. La hipótesis de trabajo se forma con menos pasos, porque el detalle del fallo y el despliegue cercano ya están en el mismo lugar.

Cómo encaja con lo que ya recopila Application Signals

Es importante no confundir las capas. Amazon CloudWatch Application Signals ya ofrece las señales de oro y las trazas mediante instrumentación automática. Eso da la vista continua del estado del servicio: cómo se comporta la latencia a lo largo del día, cuál es la tasa de errores, si la disponibilidad se mantiene dentro del objetivo. Esa capa responde la pregunta "cómo va el servicio".
Service Events añade la capa de detalle bajo demanda del fallo: "qué pasó exactamente en este incidente concreto". Las dos capas se complementan. La primera te dice que hay un problema y a qué escala. La segunda te da el material forense para entenderlo. Sin la capa continua no sabrías que hay que mirar; sin la instantánea tendrías que reconstruir el detalle. Juntas cubren el ciclo desde la detección hasta la causa probable.
Y todo esto sin cambios en el código de la aplicación. Service Events se apoya en la instrumentación de Application Signals, pero pide versiones recientes: la última versión del SDK de ADOT para tu lenguaje, la versión 1.300069.0 o posterior del agente de CloudWatch y, si usas Amazon EKS con el complemento CloudWatch Observability, la última versión de ese complemento. Las métricas por función, los umbrales por endpoint y los metadatos de despliegue se activan con variables de entorno.

Limitaciones

Ninguna función resuelve todo, y ser honesto sobre los bordes ahorra sorpresas.
  • La calidad de la instantánea depende del umbral que se configure. Un umbral mal calibrado captura ruido o deja pasar degradaciones reales. La configuración inicial requiere conocer el comportamiento normal del servicio, y eso lleva tiempo de observación.
  • La correlación con despliegues indica coincidencia temporal, no causalidad. Un despliegue cercano en el tiempo puede ser inocente. La instantánea reduce el trabajo de investigación, no lo elimina.
  • Service Events se apoya en la instrumentación de Application Signals y solo admite Java, Python y Node.js. Un servicio que no esté monitorizado con Application Signals, una aplicación .NET o una función de AWS Lambda no obtiene estas capturas, porque Service Events se desactiva automáticamente en Lambda.
  • La captura de detalle a nivel de función genera datos adicionales, con el coste y la retención que eso implica. Los datos se guardan como logs en grupos /aws/service-events/nombre-del-servicio, uno por servicio, y se cobran con las tarifas estándar de ingesta y almacenamiento de CloudWatch Logs. Conviene revisar la retención y el impacto en la facturación antes de activarlo de forma amplia.
  • Según el anuncio, Service Events está disponible en todas las Regiones comerciales de AWS. Como depende de Application Signals, y la documentación de Application Signals excluye Canadá Oeste (Calgary), conviene comprobarlo si operas en esa Región.
  • La instantánea da el detalle del servicio afectado. Un incidente distribuido que cruza varios servicios sigue necesitando correlación entre las instantáneas de cada uno.

Recursos

  •  Monitor service events  - Configuración, valores por defecto, lenguajes admitidos y almacenamiento de Service Events.
  •  Application Signals  - Documentación de referencia sobre instrumentación automática, lenguajes y Regiones admitidas.
  •  list-service-states  - Referencia de la AWS CLI v2 para consultar despliegues y otros cambios de los servicios.
  •  AWS Samples  - Repositorios de referencia con ejemplos de código para servicios de AWS.
Any opinions in this article are those of the individual author and may not reflect the opinions of AWS.
Enjoyed reading this content? Let the author know!

Your likes, comments, shares, and saves help creators reach more builders.

Loading recommendations

Loading article