Tu app Next.js está en producción. Los usuarios están usando tus API routes. Pero, ¿cómo sabes si /api/users responde en 200ms o 2000ms? ¿Cómo sabes si tu webhook de pagos está devolviendo errores 500 a las 3 AM?

La mayoría de los developers hacen deploy y esperan lo mejor. En esta guía vas a aprender cómo configurar monitoreo real para tus API routes de Next.js — con health checks automáticos, tracking de latencia y alertas instantáneas — en menos de 5 minutos.

¿Por qué monitorear API Routes de Next.js?

Las API routes de Next.js son funciones serverless (en Vercel) o handlers tipo Express (en Node). En ambos casos, pueden fallar silenciosamente:

  • Cold starts pueden disparar la latencia de 50ms a 2000ms+
  • Conexiones a base de datos pueden hacer timeout sin errores visibles
  • APIs de terceros (Stripe, Auth0, etc.) pueden degradarse y causar fallos en cascada
  • Certificados SSL pueden expirar y romper todo el tráfico HTTPS
  • Cambios de DNS pueden propagarse incorrectamente entre regiones

Sin monitoreo, solo te enteras cuando los usuarios se quejan — o cuando bajan los ingresos.

Paso 1: Instalar el SDK

npm install @nurbak/watch

Paquete liviano (< 10KB) con cero dependencias. No afecta tu bundle ni el cold start.

Paso 2: Agregar el archivo de instrumentación

Crea instrumentation.ts en la raíz de tu proyecto:

import { initWatch } from '@nurbak/watch'

export function register() {
  initWatch({
    apiKey: process.env.NURBAK_WATCH_KEY,
  })
}

5 líneas de código. Sin archivos YAML, sin agentes, sin configuración de dashboard.

Paso 3: Configurar alertas

En el dashboard de Nurbak, configura cuándo quieres ser notificado: API caída, alta latencia, tasa de errores o expiración SSL. Las alertas van por Slack, email, WhatsApp o SMS.

Paso 4: Deploy y verificar

Haz deploy normalmente. En 5 minutos, el primer health check se ejecutará. Verás tus endpoints en el dashboard con métricas en tiempo real: tiempos de respuesta, uptime, incidentes activos y estado SSL.

Monitoreo Multi-Región

Nurbak ejecuta health checks desde 4 regiones: Virginia (US), São Paulo (BR), París (FR) y Tokio (JP). Esto te permite detectar caídas regionales — como cuando tu deploy en Vercel funciona en US pero hace timeout desde Europa.

Plan Gratuito

El plan gratis incluye 1 proyecto, 3 endpoints, checks cada 5 minutos, alertas por email y 30 días de historial. Para checks cada minuto, multi-región y alertas por Slack/WhatsApp, el plan Pro cuesta $29/mes.

Resumen

Monitorear tus API routes de Next.js toma 5 minutos y 5 líneas de código. Health checks automáticos desde 4 regiones, tracking de latencia P95 y alertas instantáneas. No esperes a que los usuarios reporten problemas — sé el primero en saberlo.