Laravel

Laravel Nightwatch Cambia las Reglas: Monitoreo y Logs sin Dolor

Autorangel cruz
Actualizado
Publicado
Lectura5 min de lectura
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:

  1. Crear una cuenta en nightwatch.laravel.com.
  2. Crear una aplicación y obtener tu token.
  3. Tener Laravel 10 o superior instalado.

Comandos esenciales para activación

composer require laravel/nightwatch
php artisan nightwatch:agent

Configura 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

¿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.

Hablemos