Portainer/n8n-observability

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/ops-report: motor Python unificado para summary, logs, health y all
• scripts/server-summary.sh: wrapper compatible para estado de host + docker + certs + errores top
• scripts/log-digest.sh: wrapper compatible para digest de logs (journal + docker) para alertas/informes
• scripts/health-results.sh: wrapper compatible para 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/ops-report
./n8n-observability/scripts/server-summary.sh
SINCE="24 hours ago" ./n8n-observability/scripts/log-digest.sh
./n8n-observability/scripts/health-results.sh | jq
./n8n-observability/scripts/ops-report all

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.