Files
Portainer/n8n-observability
Eduardo David Paredes Vara 46d7a28210 feat(n8n-observability): añadir stack de observabilidad con agente IA
Stack de scripts y plantillas para generar reportes diarios del homelab
usando n8n como orquestador y un modelo de IA como redactor:

- scripts/server-summary.sh: métricas del sistema (CPU, RAM, disco)
- scripts/log-digest.sh: resumen de logs de Traefik y contenedores
- scripts/health-results.sh: estado de servicios y checks
- scripts/codex-reauth.sh: reautenticación OAuth del proveedor Codex
- templates/ai-daily-report-prompt.md: prompt para el informe diario
- workflows/workflow-design.md: diseño del workflow de n8n
- config/services.example.json: ejemplo de configuración de servicios

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-25 05:48:07 +00:00
..

n8n Observability Toolkit

Carpeta dedicada para automatizar en n8n:

  • Resumen diario de estado del servidor
  • Alertas de caida real de servicios
  • Informes automaticos de logs y errores
  • Resumen IA (texto ejecutivo)

Estructura

  • scripts/server-summary.sh: estado de host + docker + certs + errores top
  • scripts/log-digest.sh: digest de logs (journal + docker) para alertas/informes
  • scripts/health-results.sh: chequeo HTTP de endpoints y salida JSON (up/down, latencia, codigo)
  • templates/ai-daily-report-prompt.md: prompt para convertir datos tecnicos en informe legible
  • config/services.example.json: lista base de endpoints para health checks en n8n
  • workflows/workflow-design.md: diseno de 3 workflows recomendados

Uso rapido (en el host)

chmod +x n8n-observability/scripts/*.sh
./n8n-observability/scripts/server-summary.sh
SINCE="24 hours ago" ./n8n-observability/scripts/log-digest.sh
./n8n-observability/scripts/health-results.sh | jq

Integracion recomendada con n8n

  1. En n8n, crea credencial SSH al host.
  2. Workflow diario: Schedule Trigger -> SSH (log-digest.sh) -> SSH (server-summary.sh) -> SSH (health-results.sh) -> AI -> Email/Telegram.
  3. Workflow de logs: Schedule Trigger -> SSH (log-digest.sh) -> AI -> Email/Telegram.
  4. Workflow de caida real: Schedule Trigger cada 2 min -> HTTP Request por endpoint -> logica de reintentos -> alerta.

Seguridad

  • No envies logs completos a IA; envia solo digest/errores relevantes.
  • Enmascara secretos (tokens, API keys, passwords) antes de mandar datos fuera.
  • Mantener este toolkit separado facilita auditoria y versionado.