Skip to content

n8n-io/n8n-observability

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

n8n observability

Public collection of dashboards and tools to stay in the loop about how your n8n instances are doing.

Currently covers Prometheus + Grafana, with more observability tools planned (e.g. OpenTelemetry).

Dashboards

Dashboard Description Screenshot
n8n Webhook Executions Execution counts, success/failure rates, and latency for webhook workflows n8n Webhook Executions
n8n Form Executions Execution counts and success/failure rates for form workflows n8n Form Executions

Each dashboard folder contains the Grafana JSON file and a README with import instructions and the required n8n environment variables.

Local development

The local-dev/ directory contains a Docker Compose stack that spins up Prometheus and Grafana locally, with the dashboards above auto-loaded and live-reloaded.

Prerequisites

Enable metrics in n8n:

N8N_METRICS=true

See our Prometheus docs page for more info. Verify by visiting http://your-n8n-host.com/metrics.

Start the stack

cd local-dev
docker compose up -d
Service URL Credentials
Grafana http://localhost:3000 admin / admin
Prometheus http://localhost:9090

Open http://localhost:9090/targets to verify the n8n target shows UP.

Slack alerts (optional)

A bundled alert fires a Slack notification when a workflow produces more than 5 failed webhook executions in 30 seconds.

export GRAFANA_SLACK_TOKEN=xoxb-...   # Slack bot token with chat:write scope
export GRAFANA_SLACK_CHANNEL=C0123ABC  # channel ID to post to
docker compose up -d

If either variable is unset, Slack provisioning is skipped and Grafana boots without it.

Stop

docker compose down

Data is persisted in named Docker volumes (n8n_prometheus_data, n8n_grafana_data). To wipe it:

docker compose down -v

License

This project is licensed under the MIT License.

About

Reusable dashboards and tools for n8n metrics

Resources

License

Stars

Watchers

Forks

Contributors

Languages