kianiadee/dozzle_n8n_logging
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
n8n Docker-log alerting (ntfy + WhatsApp) for the Coolify host
1 commit 1 branch 0 tags 40 KiB
Python 90%
Dockerfile 10%
Find a file
kianiadee 1bc6e57374 Initial: plan, log-proxy app, README, gitignore
2026-05-17 23:29:55 +03:00
log-proxy Initial: plan, log-proxy app, README, gitignore 2026-05-17 23:29:55 +03:00
.gitignore Initial: plan, log-proxy app, README, gitignore 2026-05-17 23:29:55 +03:00
260517_docker_n8n_logging.md Initial: plan, log-proxy app, README, gitignore 2026-05-17 23:29:55 +03:00
README.md Initial: plan, log-proxy app, README, gitignore 2026-05-17 23:29:55 +03:00

README.md

dozzle_n8n_logging

n8n-driven Docker log alerting for the Coolify host at twala.rahamafresh.com. Critical errors fan out to ntfy (self-hosted) and WhatsApp (via Evolution API); lower-severity events go to ntfy only.

Dozzle stays as the human-facing log viewer. This project does not integrate with Dozzle — it reads Docker logs independently via a small read-only proxy.

Layout

log-proxy/    FastAPI app, only thing with docker.sock access. /services + /logs/<group> + /healthz.
coolify/      Coolify Docker Compose file for log-proxy.
ntfy/         Deploy notes for self-hosted ntfy.
n8n/          Exported workflow JSON (poll-<group>.json + notify.json).

Architecture

Docker Engine     log-proxy (RO sock)     n8n queue-mode
   socket  ────►  HTTP /logs/<group> ────►  poll → match → threshold → notify
                                                                  │
                                              ┌───────────────────┴───────────────────┐
                                              ▼                                       ▼
                                         ntfy.rahamafresh.com           Evolution API (WhatsApp)

Service groups are auto-derived from each container's COOLIFY_RESOURCE_UUID. The allow-list (and friendly names) live in log-proxy/groups.yml.

Severity defaults:

Severity Threshold Cooldown Channels
critical 1 match (immediate) 30 min ntfy + WhatsApp
error 10 / 5 min 15 min ntfy
warn 50 / 15 min 30 min ntfy (low prio)

See 260517_docker_n8n_logging.md for the full design rationale.

Adding a new service group

  1. Append a line to log-proxy/groups.yml: <coolify-uuid>: <friendly-name>
  2. Restart the log-proxy Coolify service
  3. In n8n: duplicate poll-tracksolid workflow, retarget its group Variable, tune severity patterns/thresholds, activate

Operating

  • Tune thresholds: edit the severity Variables block at the top of each poll-<group> workflow.
  • Silence during maintenance: deactivate the workflow in n8n (or set a global silenced=true flag in the Notify workflow's Variables).
  • Rotate ntfy publisher credential: update the credential in n8n; restart workflows.

Status

Bootstrap (2026-05-17): log-proxy code complete; n8n workflows, ntfy deploy, and Coolify deploy still pending.