Alertas y el resumen diario
Qué crea una alerta, qué contiene, cómo te llega en el motor y en Sypnia Cloud, y qué dice el resumen diario y cuándo.
Esta página es para quien quiere saber cuándo lo va a interrumpir Sypnia, y cuándo va a esperar. Las alertas las crea el motor de código abierto. La forma en que llegan a una persona es donde más se diferencian el motor y Sypnia Cloud, así que esta página muestra los dos lado a lado. El resumen diario es parte de Sypnia Cloud.
La idea es simple: una alerta cuando no puede esperar, y un mensaje corto al día para todo lo demás.
Qué crea una alerta
Una alerta es un registro que dice que algo necesita a una persona. Hay nueve tipos, con una regla cada uno. El conjunto es fijo: puedes encender o apagar una regla, elegir sus entornos y ajustar sus números, pero no agregar tipos.
| Alerta | Se crea cuando | Números que puedes ajustar (por defecto) |
|---|---|---|
| Problema nuevo | Un problema se ve por primera vez. | Ninguno |
| Problema que volvió | Un problema resuelto pasa otra vez y se reabre. | Ninguno |
| Problema creciendo | Un problema abierto llega al doble de las personas que tenía en su última alerta, y al menos a 5 personas. | El factor (2) y el mínimo de personas (5) |
| App caída | Una comprobación de disponibilidad falla dos veces seguidas. | El número de fallas (2) |
| App recuperada | Una comprobación que estaba caída vuelve a responder. | Ninguno |
| Página más lenta | El LCP p75 de una página en las últimas 24 horas creció frente a los 7 días anteriores. | El aumento (30 %) y el mínimo de vistas (50) |
| API fallando | Una ruta de la API responde 500 o más, o nada, con demasiada frecuencia en la última hora. | La proporción de llamadas (2 %) y el mínimo de llamadas (50) |
| Límite de uso | El proyecto llega a una parte de un límite de uso. | Los porcentajes (80 % y 100 %) |
| Motor fallando | El procesamiento lleva 30 minutos sin ponerse al día, o las entregas a un webhook siguen fallando. | Ninguno |
Las nueve están encendidas en un proyecto nuevo, solo para el entorno production. Tus propias pruebas no te despiertan.
Lo que nunca crea una alerta:
- Un problema que ignoraste.
- Más ocurrencias de un problema que ya está abierto y no está creciendo. Un problema es una alerta, no una por cada persona afectada.
- Un clic de rabia, un clic muerto o una falla de formulario. Esperan al resumen diario y a las sugerencias semanales.
- Una comprobación que sigue caída, o una página que sigue lenta. Cada una alerta una vez, cuando cambia.
Cualquiera puede confirmar una alerta. Eso registra quién la vio y cuándo, y no cambia nada más: el problema o la comprobación que hay detrás conserva su estado.
Las reglas, sus campos y cómo cambiarlas están en la referencia de la API.
Qué tan rápido
- Un problema nuevo puede alertar dentro de los 2 minutos siguientes a su primer evento.
- Una caída alerta unos 2 minutos después de que tu app deja de responder.
- La alerta de un problema espera la frase de el agente, pero nunca más allá de esos 2 minutos. Si el análisis no está listo, o el agente está apagado, la alerta sale con el título técnico del problema, y la frase aparece en el problema cuando se escribe.
Qué contiene una alerta
Toda alerta lleva:
| Parte | Contenido |
|---|---|
| Tipo | Uno de los nueve de arriba. |
| Dónde | El proyecto y el entorno. |
| Cuándo | La hora en que se creó. |
| Título | Para un problema, la frase en palabras simples, o el título técnico si el agente no ha escrito una. Para las demás, qué le pasó a qué comprobación, página o ruta. |
| Enlace | Al problema, la comprobación, la página o la ruta: en la app en Sypnia Cloud, en tu Consola en un motor en alojamiento propio. |
| Confirmación | Quién la vio y cuándo, una vez que alguien la confirma. |
Una alerta sobre un problema agrega:
- a quién afectó hasta ahora: las personas y las sesiones en el momento de la alerta,
- desde cuándo: la primera ocurrencia.
El correo de Sypnia Cloud dice además con qué versión llegó, si se sabe, qué hacer cuando el análisis está listo, y enlaza a una sesión con grabación cuando hay una.
Una alerta de disponibilidad agrega la dirección, desde cuándo, el motivo y, para «recuperada», cuánto duró la caída. Una alerta sobre una página o una ruta agrega los dos números que comparó.
Una alerta nunca contiene lo que una persona escribió, el texto completo de un stack, ni nada enmascarado.
Cómo te llega una alerta
| Motor de SypniaCódigo abierto, en tu propia infraestructura | Sypnia CloudServicio pago, con un plan gratis | |
|---|---|---|
| Registrada | Sí. Toda alerta se guarda y se puede listar por la API, la CLI y MCP. | Sí. Lo mismo. |
| Mostrada | En la Consola. | Dentro de la app, marcada hasta que alguien la confirma. |
| Correo | No. El despliegue por defecto no tiene con qué enviar correo. | Sí, a los miembros de la organización. Las alertas de uso van a sus dueños. |
| Webhook | Sí. Cada alerta se envía a los webhooks que registraste, firmada, y se reintenta durante unas 21 horas si tu servidor no responde. | Sí. Lo mismo. |
| WhatsApp, Slack | No. | No. |
En un motor en alojamiento propio Motor
El trabajo del motor termina al registrar la alerta y llamar a tu webhook. Hacer que llegue a una persona es una pieza que eliges tú, y la documentación da las recetas:
Una pieza que eliges tú
Entrega de alertas
Lleva una alerta del motor a una persona.
- Despliegue por defecto
- Ninguna. Las alertas se registran, se muestran en la Consola y se envían a un webhook si pones uno.
- Sypnia Cloud usa
- Correo con Amazon SES y alertas dentro de la app.
Hasta que conectes una, las alertas no se pierden: están en la Consola y en la API, y tu agente de código puede pedirlas por MCP.
En Sypnia Cloud Nube
- Correo. Cada miembro de la organización recibe los correos de alerta de sus proyectos. Cada miembro puede apagarlos para un proyecto en su propia configuración. Las alertas sobre un límite de uso van a los dueños de la organización.
- Dentro de la app. Las alertas se listan para todos en la organización, de la más nueva a la más vieja.
- Webhooks, si registraste alguno.
El resumen diario Nube
El resumen diario es un correo al día que te cuenta cómo le fue a tu app el día anterior, en palabras simples. También se muestra en la app.
| Se envía | Todos los días a las 08:00, en la zona horaria del proyecto. |
| Cubre | El día calendario anterior en esa zona horaria, en el entorno production. |
| A quién | A cada miembro de la organización, un correo por proyecto. Un miembro puede apagarlo para un proyecto en su propia configuración. |
| En un día tranquilo | Se envía igual, y dice que no pasó nada nuevo. |
En este orden:
- Problemas. Los que fueron nuevos, volvieron o crecieron ese día, primero los que afectaron a más personas: la frase, cuántas personas, y si hay un pull request esperando. Como máximo 5, y después «y 2 más».
- Siguen abiertos. Una línea con el número de problemas abiertos más viejos que afectaron a alguien ese día.
- Más lento, o fallando. Las páginas que se volvieron más lentas y las rutas de la API que están fallando, con las mismas reglas de sus alertas. Como máximo 3 de cada una. Las reglas están en Rendimiento.
- Frustración. Los elementos a los que al menos 3 personas les hicieron un clic de rabia o un clic muerto. Como máximo 3.
- Disponibilidad. «Tu app respondió todo el día», o cada caída con su duración. Se omite si el proyecto no tiene ninguna comprobación de disponibilidad.
- Personas. Cuántas personas usaron la app, y en cuántas sesiones.
- Uso. Solo cuando el proyecto está en el 80 % o más de un límite del plan.
Un proyecto sin eventos ese día igual recibe su resumen, con una línea que lo dice.
El resumen se arma con números que el motor ya tiene y con las frases que el agente ya escribió. No contiene nada que no esté también en la app.
¿Y en un motor en alojamiento propio?
El motor no escribe un resumen diario. Los mismos datos están a una petición de distancia: GET /v1/summary responde «¿qué está fallando ahora?» con los problemas abiertos que más importan, las comprobaciones caídas y las páginas que se volvieron más lentas, y tu agente de código recibe la misma respuesta de la herramienta MCP health. Mira la referencia de la API y las herramientas de MCP.
Ejemplo: la tienda
09:14, una alerta por correo (Sypnia Cloud):
Problema nuevo en shop (production)
1 persona intentó pagar y no pudo. El botón Pagar no hace nada
desde el cambio de ayer.
A quién afectó 1 persona, 1 sesión, hasta ahora
Desde cuándo Hoy 09:12. Visto por primera vez en la versión 4f2a91c,
desplegada ayer a las 18:40
Qué hacer El checkout todavía lee el nombre viejo del campo
del carrito. Apúntalo al nuevo.
Abrir el problema · Ver la sesiónPara la tarde ya son tres las personas afectadas. Eso no envía tres alertas: es el mismo problema, ya abierto, y 3 personas todavía no es «creciendo», que empieza en 5.
A la mañana siguiente, a las 08:00, el resumen diario:
shop · Buenos días. Esto fue ayer.
● 1 problema nuevo: 3 personas intentaron pagar y no pudieron,
desde el cambio de ayer. Hay un pull request esperándote.
● La página de búsqueda se volvió más lenta: 3,1 segundos en
cargar, antes eran 1,9.
● Tu app respondió todo el día. La usaron 412 personas.En un motor en alojamiento propio, esa misma mañana: la misma alerta está en la Consola y se envió al webhook. Si una función en ese webhook envía correo, también te llegó el correo.
Referencia
Los campos de una alerta, las reglas de alerta y los webhooks: la referencia de la API. Enviar tú mismo los correos de alerta: Correos de alerta desde un motor con alojamiento propio.