Un endpoint de health check es la forma más simple y efectiva de saber si tu app Next.js funciona correctamente. Es una ruta dedicada que retorna el estado de tu aplicación y sus dependencias — base de datos, cache, APIs externas — en formato legible por máquinas.

Paso 1: Crear el Endpoint Básico

En Next.js App Router, crea app/api/health/route.ts que retorne un JSON con status, timestamp y uptime del proceso. Retorna HTTP 200 para saludable, 503 para no saludable.

Paso 2: Agregar Checks de Dependencias

Agrega verificaciones de base de datos (query simple como SELECT 1), APIs externas (Stripe, Auth0), y uso de memoria. Si cualquier dependencia falla, retorna HTTP 503.

Paso 3: Monitorear Externamente con Nurbak

Un health check que nadie verifica es inútil. Necesitas un servicio externo que llame tu ruta /api/health regularmente desde fuera de tu infraestructura.

Con Nurbak, agrega 5 líneas a tu instrumentation.ts y tu endpoint será chequeado automáticamente desde hasta 4 regiones globales (US, Brasil, Francia, Japón) cada 1-5 minutos. Cada check captura DNS, TLS, TTFB, tamaño de respuesta y más.

Paso 4: Configurar Alertas

Configura reglas de alerta para API caída, alta latencia, tasa de errores y expiración SSL. Envía alertas por Slack, email, WhatsApp o SMS. Anti-spam incluido: una notificación por incidente.

Mejores Prácticas

  • Mantenlo rápido — Los health checks deben responder en menos de 500ms
  • No cachees — Siempre ejecuta fresco con Cache-Control: no-cache
  • Incluye versión — Retorna la versión de tu app o commit hash
  • Usa JSON estructurado — Formato consistente para que las herramientas lo parseen

El plan gratis de Nurbak incluye 3 endpoints, checks cada 5 minutos y alertas por email. Sin tarjeta de crédito.