Visualize metrics with Grafana

Enable the Prometheus metrics endpoint in n8n, then connect Grafana through a Prometheus instance to visualize your n8n data. Refer to Enable Prometheus metrics before following this guide.

Reusable dashboard templates

Once you enable Prometheus metrics for your n8n instance, you'll want to build dashboards to observe them.

n8n publishes reusable grafana dashboards for several of the supported prometheus metrics in this GitHub project: n8n-observability

Configure Prometheus to scrape n8n

Prometheus scrapes n8n's /metrics endpoint on a schedule and stores the data. Grafana then queries Prometheus to display it.

Add a scrape job targeting your n8n instance in your prometheus.yml:

scrape_configs:
  - job_name: n8n
    static_configs:
      - targets:
          - <n8n-host>:<n8n-port>
    metrics_path: /metrics

Replace <n8n-host> and <n8n-port> with your n8n instance address. The default n8n port is 5678.

After editing, reload or restart Prometheus to apply the change.

Add Prometheus as a Grafana data source

1. In Grafana, go to Connections > Data sources.
2. Select Add new data source.
3. Select Prometheus.
4. Set Prometheus server URL to your Prometheus instance address, for example http://prometheus:9090.
5. Select Save & test.

Grafana confirms the connection with a success message.

Webhook observability

Available from n8n version 2.28.0.

n8n exposes a n8n_webhook_request_duration_seconds histogram for every webhook call. Enable these environment variables to collect it:

You can find a ready-to-use dashboard for this histogram in our n8n-observability project.

What the metric tracks

n8n_webhook_request_duration_seconds is a Prometheus histogram. For each webhook call, n8n records how long the request took (time of "request received" -> "response sent"). The metric exposes three series per label combination:

Each series carries these labels:

Dashboard ideas

Form submission observability

Available from n8n version 2.28.0.

n8n exposes a n8n_form_submission_duration_seconds histogram for every form submission. Enable these environment variables to collect it:

You can find a ready-to-use dashboard for this histogram in our n8n-observability project.

What the metric tracks

n8n_form_submission_duration_seconds is a Prometheus histogram. For each form submission, n8n records how long it took from the "user pressing submit" to "user getting feedback on form submission". The metric exposes three series per label combination:

Each series carries these labels:

Dashboard ideas

Workflow name lookup

Available from n8n version 2.28.0.

When you enable N8N_METRICS_INCLUDE_WORKFLOW_INFO, n8n exposes one gauge per workflow:

n8n_workflow_info{workflow_id="VaQPuPmx9tPpo6BX",workflow_name="My workflow"} 1

Join it onto any other n8n metric via workflow_id to replace opaque IDs with human-readable names in Grafana panels. For example, to show webhook request rate by workflow name:

sum by (workflow_name) (
  rate(n8n_webhook_request_duration_seconds_count[5m])
  * on(workflow_id) group_left(workflow_name)
  n8n_workflow_info
)