Monitoreo de APIs Next.js: La Guía Completa (3 Capas Que Necesitás)

Next.js hace fácil shippear API routes a producción. Es significativamente más difícil saber si esas rutas están sanas una vez que usuarios reales empiezan a pegarles. Esta guía cubre todo lo que necesitás para monitorear API routes de Next.js en producción — vendor-neutral, enfocada en lo que realmente atrapa incidentes.

Por qué el monitoreo de Next.js es diferente

Las apps Next.js combinan múltiples workloads en un solo deploy: API routes, server actions, server components, middleware. Mucho de eso corre en infraestructura serverless (Vercel, Lambda, Netlify, Cloudflare Workers). Eso rompe los supuestos de las herramientas tradicionales: no podés instalar un agent en el host, las funciones son cortas, los cold starts importan, y el costo escala con invocaciones.

Next.js shippeó un hook llamado instrumentation.ts específicamente para resolver esto. Corre una vez por boot del servidor y permite que SDKs de monitoreo se enganchen al runtime sin agent.

Las 3 capas del monitoreo Next.js

Capa 1: Checks de uptime externos

Responde "¿es mi API alcanzable desde internet?" Atrapa fallas que no tienen nada que ver con tu código: DNS mal configurado, SSL expirado, outage del CDN, outage regional de Vercel/AWS, deploy que brickea la función. Nada de eso se atrapa con instrumentación de código porque tu código nunca corre.

Opciones: UptimeRobot, Pingdom, Better Stack, Nurbak Watch (4 regiones incluidas).

Capa 2: Monitoreo de ejecución interna

Responde "¿qué pasa dentro de mi servidor cuando maneja un request real?" Atrapa: queries lentas a la base que no tiran excepción, degradación de latencia post-deploy, picos de P95 que se promedian a "bien" pero arruinan el peor 5%, delays de cold start, middleware que agrega 200ms a cada request.

Opciones: Datadog APM (enterprise), New Relic, Sentry Performance (sampling), Nurbak Watch (sin agents).

Capa 3: Error tracking

Responde "¿qué excepciones tira mi código?" Atrapa fallas a nivel de código: excepciones no manejadas, TypeError, errores de SDKs de terceros, errores de JavaScript del frontend.

Opciones: Sentry (mejor en su clase), Bugsnag, Rollbar.

Por qué necesitás las tres

Cada capa atrapa fallas que las otras se pierden. Tres modos de falla en /api/checkout: (1) Stripe tira excepción → Sentry gana, (2) la base hace una query de 5 segundos sin error → solo monitoreo interno la atrapa, (3) Vercel deploya el commit equivocado y la función no levanta → solo pings externos lo detectan en 60s. Si te falta una capa, te enterás por un ticket de soporte — horas después.

El setup de 30 minutos

Paso 1: Instalá Sentry para errores (10 min)

npm install --save @sentry/nextjs
npx @sentry/wizard@latest -i nextjs

Paso 2: Instalá Nurbak Watch para uptime + latencia (5 min)

// instrumentation.ts
import * as Sentry from '@sentry/nextjs'
import { initWatch } from '@nurbak/watch'

export function register() {
  Sentry.init({ dsn: process.env.SENTRY_DSN })
  initWatch({ apiKey: process.env.NURBAK_WATCH_KEY })
}

Paso 3: Configurá canales de alerta (10 min)

Sentry: Slack para errores nuevos. Nurbak Watch: Slack para alertas normales, WhatsApp/SMS para downtime sostenido.

Paso 4: Validá con una falla de prueba (5 min)

Disparalo en una ruta de test. Confirmá que recibís alertas de la herramienta correcta antes de que sea un incidente real.

Costo total

Comparado con $400-1,200/mes de un setup equivalente en Datadog.

Errores comunes

• Instalar solo una capa. Sentry solo se pierde uptime. UptimeRobot solo se pierde latencia real.
• Alertar en cada error. Configurá thresholds de tasa, no eventos individuales.
• No testear el routing de alertas. Disparalo manualmente después de cada cambio de config.
• Solo monitorear producción. Agregá monitoreo a staging con canal separado.

Dónde encaja Nurbak Watch

Esta guía es vendor-neutral. El patrón funciona con cualquier combinación que cubra las tres capas. Dicho eso: Nurbak Watch se construyó específicamente porque queríamos las capas 1 y 2 en una sola herramienta optimizada para Next.js, con precio plano de $29/mes y setup de 5 líneas. Probalo gratis — 3 endpoints, sin tarjeta.

Artículos relacionados

• Nurbak vs Sentry
• Nurbak vs Datadog
• Monitoreo de APIs sin agentes