Docs

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.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Qué crea una alerta
  2. Qué tan rápido
  3. Qué contiene una alerta
  4. Cómo te llega una alerta
  5. En un motor en alojamiento propio
  6. En Sypnia Cloud
  7. El resumen diario
  8. ¿Y en un motor en alojamiento propio?
  9. Ejemplo: la tienda
  10. Referencia

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.

AlertaSe crea cuandoNúmeros que puedes ajustar (por defecto)
Problema nuevoUn problema se ve por primera vez.Ninguno
Problema que volvióUn problema resuelto pasa otra vez y se reabre.Ninguno
Problema creciendoUn 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ídaUna comprobación de disponibilidad falla dos veces seguidas.El número de fallas (2)
App recuperadaUna comprobación que estaba caída vuelve a responder.Ninguno
Página más lentaEl 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 fallandoUna 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 usoEl proyecto llega a una parte de un límite de uso.Los porcentajes (80 % y 100 %)
Motor fallandoEl 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:

ParteContenido
TipoUno de los nueve de arriba.
DóndeEl proyecto y el entorno.
CuándoLa hora en que se creó.
TítuloPara 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.
EnlaceAl 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ónQuié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

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
RegistradaSí. Toda alerta se guarda y se puede listar por la API, la CLI y MCP.Sí. Lo mismo.
MostradaEn la Consola.Dentro de la app, marcada hasta que alguien la confirma.
CorreoNo. 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.
WebhookSí. 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, SlackNo.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.

Tus opciones

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íaTodos los días a las 08:00, en la zona horaria del proyecto.
CubreEl día calendario anterior en esa zona horaria, en el entorno production.
A quiénA 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 tranquiloSe envía igual, y dice que no pasó nada nuevo.

En este orden:

  1. 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».
  2. Siguen abiertos. Una línea con el número de problemas abiertos más viejos que afectaron a alguien ese día.
  3. 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.
  4. 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.
  5. 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.
  6. Personas. Cuántas personas usaron la app, y en cuántas sesiones.
  7. 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):

Text
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ón

Para 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:

Text
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.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar