nightowl-agent
NightOwl Agent es un agente de monitorización Laravel autocontenido que captura telemetría del SDK Nightwatch y la inyecta en una base de datos PostgreSQL local.
Ficha actualizada 22 sept 2026, 23:24 · upstream 22 sept 2026, 22:58 · release sin release detectada
Qué es nightowl-agent
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
NightOwl Agent es un paquete de PHP (MIT) que actúa como agente de observabilidad para Laravel. Se instala sobre el SDK oficial de observabilidad de Laravel, `laravel/nightwatch`, capturando todos sus 12 tipos de registros: peticiones, consultas, jobs, excepciones, comandos, eventos de caché, correo electrónico, notificaciones, HTTP en tránsito, tareas programadas y logs. El agente recibe estos datos a través de un socket TCP local (portas 2407-2409) y los inyecta en una base de datos PostgreSQL mediante el protocolo COPY. Todo el flujo ocurre dentro del servidor; no hay datos que salgan de la infraestructura del usuario.
- Monitorización de rendimiento en producción con observabilidad completa
- Auditoría de errores y excepciones para análisis post-mortem
- Seguridad: detección de inyecciones SQL, XSS o ataques de inyección de comandos
- Optimización de consultas mediante alertas basadas en P95/N+1
- Detección de cuellos de botella en tareas programadas y jobs
- Auditoría de uso de recursos (CPU, memoria) por usuario o entorno
- Captura completa del SDK Nightwatch: peticiones, consultas, jobs, excepciones, comandos, caché, mail, notificaciones, HTTP en tránsito, tareas programadas y logs
- Inyección de datos directamente a PostgreSQL mediante protocolo COPY sin salida de red
- Alertas por nuevas incidencias (new-issue alerts) enviadas desde el servidor al SMTP o webhook del usuario
- Detección de P95/N+1, consultas lentas y cuellos de botella en tiempo real
- Health diagnosis con ring buffers, EWMA y reglas de alerta basadas en métricas
- Soporte para múltiples entornos (local, staging, production) compartiendo una base de datos
- El agente no puede acceder a datos sensibles del servidor (logs, cookies, sesiones) sin permisos explícitos
- La inyección en PostgreSQL requiere que la conexión sea estable y el protocolo COPY funcione; fallos pueden causar pérdida de datos
- No hay persistencia de estado entre reinicios: si se reinicia el agente, las migraciones pendientes no se aplican automáticamente
- El rendimiento depende del buffer de SQLite WAL (máximo ~13.400 payloads/s en un solo nodo)
- Las alertas por nuevas incidencias dependen de que el canal SMTP o webhook esté activo y configurado
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instala con `composer require nightowl/agent` e inicia con `php artisan nightowl:install`. Configura la conexión PostgreSQL en `.env` (host, puerto, base de datos, usuario, contraseña). El agente se ejecuta como un daemon que escucha TCP/UDP en portas 2407-2409. Para migraciones, usa `nightowl:migrate` durante el deploy. Desactiva con `NIGHTOWL_ENABLED=false`. Usa `NIGHTOWL_AUTO_MIGRATE=true` para aplicar migraciones al inicio del servidor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.