Laravel Nightwatch Cambia las Reglas: Monitoreo y Logs sin Dolor

¿Qué es Laravel Nightwatch?
Laravel Nightwatch es el servicio de observabilidad y monitoreo en tiempo real de Laravel, presentado en Laracon AU en noviembre de 2024 y lanzado en junio de 2025. Está diseñado exclusivamente para aplicaciones Laravel, a diferencia de herramientas genéricas como Sentry, Bugsnag o Datadog.
En este artículo se cubre qué ofrece Nightwatch, cómo se instala y cuándo tiene sentido usarlo sobre otras alternativas.
Características y objetivo
Qué hace Nightwatch
Laravel Nightwatch es un servicio SaaS que permite monitorear el rendimiento, errores, procesos en segundo plano (jobs) y mucho más de tu aplicación Laravel en tiempo real. Como está hecho solo para Laravel, se integra de forma nativa con el framework.
Lanzamiento oficial y novedades
Lanzado oficialmente el 16 de junio de 2025, Nightwatch llega con estas características:
- Dashboard limpio y en tiempo real.
- Historial de errores con contexto completo.
- Logs estructurados que se buscan y se cruzan con requests, jobs y el resto de eventos.
- Timeline detallado de cada request y job.
¿Para quién es Laravel Nightwatch?
Casos de uso típicos
Laravel Nightwatch es ideal para:
- Aplicaciones SaaS hechas completamente en Laravel.
- Proyectos en producción que necesiten trazabilidad.
- Equipos que usen Laravel Forge o Vapor.
Cuándo usar Nightwatch sobre otras herramientas
Si tu stack es 100% Laravel, usar Nightwatch reduce la complejidad de integración y te ofrece datos más relevantes que otras herramientas más genéricas como Sentry o LogRocket.
Principales características de Laravel Nightwatch
Panel centralizado con datos de rendimiento
Desde el dashboard puedes ver:
- Rutas más utilizadas.
- Jobs en segundo plano.
- Memoria consumida por petición.
- Promedios de respuesta HTTP.
Registro y contexto de errores
Nightwatch te muestra los errores agrupados por tipo, URL, usuario y clase. Así puedes ver cuándo y por qué se produce cada excepción.
Monitoreo de recursos por ejecución
Nightwatch mide la aplicación, no la máquina: registra la duración y el pico de memoria de cada request, job, comando y tarea programada, pero sus tipos de eventos no incluyen CPU ni disco del servidor. Para eso sigues necesitando algo como Prometheus o Datadog.
Cómo instalar Laravel Nightwatch paso a paso
Requisitos previos y token de configuración
Antes de comenzar, debes:
- Crear una cuenta en nightwatch.laravel.com.
- Crear una aplicación y obtener tu token.
- Tener Laravel 10 o superior instalado.
Comandos esenciales para activación
composer require laravel/nightwatch
php artisan nightwatch:agentConfigura las variables en tu .env (el sample rate va de 0.0 a 1.0, según la referencia de variables de entorno):
NIGHTWATCH_TOKEN=tu_token
NIGHTWATCH_REQUEST_SAMPLE_RATE=1.0
LOG_CHANNEL=stack
LOG_STACK=single,nightwatch
El agente tiene que quedar corriendo en segundo plano, así que en producción conviene levantarlo con un process monitor, como recomienda la guía de inicio.
Qué lo diferencia de otras herramientas
Integración profunda con el núcleo Laravel
El paquete de Nightwatch escucha eventos internos del framework como QueryExecuted o CommandStarting y sigue cada intento de job, por lo que ofrece información específica que otras plataformas no pueden ver sin configuración adicional.
Alertas por Slack y webhooks
Con la integración de Slack recibes avisos de excepciones nuevas, umbrales de rendimiento superados, regresiones de issues ya resueltos y cambios de estado, según su changelog. También puedes mandar esos eventos a tu propio sistema con webhooks.
Limitaciones y puntos a mejorar
- No ofrece soporte para otros lenguajes como Node.js o Ruby.
- Requiere que ejecutes un agente con
php artisan. - Solo se puede usar con Laravel 10 o superior.
¿Nightwatch o Sentry para tu proyecto?
Si estás construyendo con Laravel, la elección lógica es Laravel Nightwatch, porque te ahorras configurar herramientas externas. Si trabajas con múltiples stacks o necesitas integraciones más amplias, entonces Sentry sigue siendo una gran elección.
Monitorizar es el último paso de una lista más larga, y esa lista está en Laravel en producción.
Preguntas frecuentes
¿Nightwatch funciona con Laravel Forge o Vapor?
Sí, pero de forma distinta. Forge tiene integración propia: desde el sitio haces clic en Connect Nightwatch, pegas el token y listo (guía de Forge). En Vapor el agente no puede correr dentro de Lambda, así que necesitas una instancia de larga duración en la misma red que lo ejecute, por ejemplo una instancia EC2 en la red de Vapor (guía de Vapor).
¿Requiere mucha configuración inicial?
No. Solo necesitas instalar el paquete, configurar el token y ejecutar el agente.
¿Qué tan seguro es enviar mis logs a un servidor externo?
Al crear la aplicación eliges la región de los datos (US, EU o Australia), y por defecto Nightwatch redacta headers como Authorization y Cookie y campos como password, y no captura el payload de las requests salvo que lo actives, según su referencia de variables de entorno.
¿Qué pasa si mi app no es Laravel puro?
Nightwatch está diseñado exclusivamente para Laravel, por lo que no funcionará en otros entornos.
¿Nightwatch consume muchos recursos?
El agente es liviano y corre en un proceso separado de tu aplicación; según las FAQ de Nightwatch, suele añadir menos de 3 ms por request.
¿Puede reemplazar por completo a herramientas como Sentry?
Para apps Laravel, sí. Para stacks mixtos, Sentry sigue teniendo ventajas.
Fuentes
- Announcing Laravel Nightwatch (anuncio oficial de Laravel)
- Laracon AU 2024: Nightwatch Unveiled (blog oficial de Laravel)
- Start Guide (documentación oficial de Nightwatch)
- Environment Variables (documentación oficial de Nightwatch)
- Events Overview (documentación oficial de Nightwatch)
- FAQs (documentación oficial de Nightwatch)
- Laravel Forge (documentación oficial de Nightwatch)
- Laravel Vapor (documentación oficial de Nightwatch)
- Webhooks (documentación oficial de Nightwatch)
- Changelog (changelog oficial de Nightwatch)
- laravel/nightwatch (repositorio oficial)
¿Tienes un proyecto en mente?
Trabajo con Laravel, WordPress, SEO técnico y servidores MCP. El primer paso es una llamada de descubrimiento, sin costo ni compromiso, donde me cuentas qué necesitas y te digo con honestidad si puedo ayudarte.