Docs

Disponibilidad

Qué hace una comprobación de disponibilidad, cuándo tu app cuenta como caída y cuándo como recuperada, cuándo te avisan, y en qué se diferencian el motor y Sypnia Cloud.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Qué hace una comprobación
  2. Caída, y recuperada
  3. Cuándo te avisan
  4. Motor y Cloud
  5. Qué no hace la disponibilidad al lanzar
  6. Ejemplo: la tienda de noche
  7. Referencia

Esta página es para quien quiere que le avisen cuando su app deja de responder. Las comprobaciones de disponibilidad son parte del motor de código abierto. Sypnia Cloud las corre desde más de un lugar y envía la alerta por correo.

Todo lo demás en Sypnia lo reporta tu app. Si tu app está caída, no reporta nada, y el silencio se ve igual que un día tranquilo. Una comprobación de disponibilidad es la respuesta a eso: Sypnia le pregunta a tu app, desde afuera, si está ahí.

Qué hace una comprobación

Una comprobación de disponibilidad es una petición que el motor le hace a una dirección tuya, cada cierto tiempo.

Por defectoLo puedes cambiar a
La peticiónUn GET de HTTP a la dirección que des, como https://yourapp.com/ o https://yourapp.com/api/health.HEAD, y hasta 10 encabezados tuyos. Los encabezados se guardan y se muestran como los envías, así que no pongas secretos ahí.
Cada cuántoCada minuto.Cada 5 o cada 15 minutos.
Tiempo permitido10 segundos.Entre 1 y 30 segundos.
Pasa cuandoLa respuesta llega a tiempo y su estado está entre 200 y 399.Un estado, un rango o una lista. Y, para un GET, un texto que la respuesta debe contener en sus primeros 256 KB.

Una comprobación falla cuando la respuesta llega tarde, tiene otro estado, no trae el texto que pediste, o nunca llega: el nombre no se puede resolver, la conexión se rechaza, o el certificado no es válido.

De cada petición Sypnia guarda la hora, si pasó, el código de estado o el motivo de la falla, y cuánto tardó la respuesta.

Toda comprobación sigue hasta 3 redirecciones, nunca envía cookies y se identifica con el encabezado User-Agent: Sypnia-Uptime/1.0, para que la reconozcas en tus registros. Solo llama a direcciones públicas: una dirección dentro de una red privada se rechaza, salvo que lo permitas en tu propio motor.

Una comprobación pertenece a un proyecto, no a un entorno. Sus peticiones no son eventos y no cuentan para los eventos de un plan.

Caída, y recuperada

Una petición fallida no es una caída. Las redes tienen tropiezos.

  • Una comprobación está caída después de dos fallas seguidas. Ese momento abre una caída.
  • Una comprobación está arriba otra vez después de una respuesta correcta. Eso cierra la caída.

Una caída va desde la primera de las dos fallas hasta la primera respuesta correcta. Su duración es lo que Sypnia reporta como tiempo caído.

La disponibilidad de un periodo es la proporción de las peticiones de la comprobación que pasaron en él. Con una comprobación cada minuto, treinta peticiones fallidas en un día son un 97,9 % de disponibilidad para ese día.

Los resultados sueltos se guardan 7 días. Después Sypnia guarda los números de cada hora, durante 400 días: cuántas peticiones, cuántas fallaron y cuánto tardaron las respuestas.

Cuándo te avisan

Caerse y recuperarse crean cada uno una alerta. Las alertas de disponibilidad no esperan nada más de Sypnia. Con una comprobación cada minuto, la alerta llega unos dos minutos después de que tu app deja de responder. El número de fallas que crea la alerta, dos, se puede cambiar en las reglas de alerta del proyecto.

AlertaDice
CaídaQué comprobación, desde cuándo y por qué: el código de estado, o «sin respuesta en 10 segundos», o el error del certificado o del nombre.
RecuperadaQué comprobación, y cuánto tiempo estuvo caída.

Cómo te llega la alerta está en Alertas y el resumen diario. Una comprobación que sigue caída no crea más alertas hasta que se recupera. Puedes pausar una comprobación, por ejemplo durante un mantenimiento programado; una comprobación pausada no hace peticiones ni crea alertas.

Motor y Cloud

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
Desde dónde corre la comprobaciónDesde donde corre tu motor: un solo lugar.Desde tres regiones.
Cuándo falla una comprobaciónCuando falla la petición desde ese único lugar.Cuando fallan al menos dos de las tres regiones. Una región con un problema de red no cuenta.
Cómo te avisanLa alerta se registra y se envía a tus webhooks. Sin correo en el despliegue por defecto.Por correo y dentro de la app, y a tus webhooks.
Cuántas comprobaciones50 por proyecto, por defecto. El número lo cambias tú.Lo define el plan.

Qué no hace la disponibilidad al lanzar

Una comprobación no puede avisarte antes de que venza un certificado, y Sypnia no tiene una página de estado pública para tu app. Ninguna de las dos cosas está prometida; lo que no entra en la primera versión está en la página Planeado.

Ejemplo: la tienda de noche

La tienda tiene una comprobación en https://yourapp.com/api/health.

HoraComprobaciónEstado
03:11200 en 180 msArriba
03:12Sin respuesta en 10 segundosSigue arriba. Una falla.
03:13503Caída. Dos fallas seguidas. La caída empieza a las 03:12. Sale una alerta: «Tu app dejó de responder a las 03:12: sin respuesta en 10 segundos.»
03:14 a 03:23503Caída. Ninguna alerta nueva.
03:24200 en 240 msArriba. Sale una alerta: «Tu app volvió a responder. Estuvo caída 12 minutos.»

Por la mañana, el resumen diario de Sypnia Cloud dice que la app estuvo caída 12 minutos durante la noche, en vez de «Tu app respondió todo el día».

Referencia

Crear y leer comprobaciones: la referencia de la API. En un motor en alojamiento propio, lo que debe estar corriendo para que las comprobaciones se hagan está en el resumen de 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