Saltar al contenido principal

Monitoreo sintético

Frihet ejecuta un sistema de monitoreo sintético propio que verifica de forma proactiva la disponibilidad de la API, los servicios de cumplimiento (VeriFactu, TicketBAI, Facturae, FACe) y los flujos críticos del producto. Las métricas resultantes alimentan la página de estado y los alertas internos.

Cómo funciona

Una Cloud Function tipo heartbeat se ejecuta en intervalos regulares y golpea los endpoints clave de Frihet — API REST, servicios fiscales, login, dashboard — registrando latencia, código de respuesta y cualquier desviación del comportamiento esperado. Cada ejecución produce un evento que se persiste en un log append-only inmutable.

El log es la fuente de verdad para los indicadores de fiabilidad. A partir de él se calculan métricas de uptime mensual, tiempo medio de respuesta y porcentaje de errores por servicio. Los datos agregados son los que se publican en status.frihet.io para que clientes, partners y crawlers puedan verificarlos sin acceso interno.

Si una verificación falla — endpoint caído, latencia fuera de umbral, error 5xx — el sistema activa una alerta interna para que el equipo de ingeniería actúe. Los incidentes confirmados se publican también en la página de estado con su línea de tiempo: detección, mitigación, resolución y postmortem cuando aplica.

El monitoreo sintético complementa el monitoreo reactivo basado en logs de producción. Mientras los logs reaccionan a errores que ya ocurrieron a usuarios reales, el sintético detecta problemas antes de que afecten a tráfico real, especialmente útil para servicios fiscales que se usan con menor frecuencia que la app principal.

Configuración

El monitoreo está activo internamente en todas las cuentas y no requiere configuración por parte del usuario. Para consultar el estado actual de los servicios, visita status.frihet.io.

Si construyes una integración crítica sobre la API de Frihet y necesitas tu propio canal de alertas, suscríbete al RSS de la página de estado o consulta los endpoints de healthcheck documentados en API REST.

Ver también