https://github.com/pbrissaud/n8n-opentelemetry
n8n Docker image with advanced logging and OpenTelemetry included
https://github.com/pbrissaud/n8n-opentelemetry
logging monitoring n8n opentelemetry
Last synced: about 2 months ago
JSON representation
n8n Docker image with advanced logging and OpenTelemetry included
- Host: GitHub
- URL: https://github.com/pbrissaud/n8n-opentelemetry
- Owner: pbrissaud
- Created: 2025-06-03T12:45:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-29T03:02:07.000Z (about 2 months ago)
- Last Synced: 2026-04-29T05:07:00.173Z (about 2 months ago)
- Topics: logging, monitoring, n8n, opentelemetry
- Language: JavaScript
- Homepage:
- Size: 139 KB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# n8n + OpenTelemetry
Custom Dockerfile to run n8n with OpenTelemetry tracing and advanced logging.
It's inspired by the work of [Stuart Johnson in the n8n community](https://community.n8n.io/t/n8n-successfully-instrumented-with-opentelemetry/78468) and [simple10/LLemonStack](https://github.com/LLemonStack/llemonstack).
## Features
- Logging of n8n workflows and nodes executions in console (not sent in otlp) with Winston
- Tracing of n8n workflows and nodes executions
> [!WARNING]
> Subnode executions are not traced yet. Open to PRs if you want to add this feature.
## Usage
To activate logging andtracing, you need to set the following environment variables when running the container:
```bash
docker run -it --rm \
-e OTEL_SERVICE_NAME="n8n" \
-e OTEL_SDK_DISABLED="false" \
-e OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318" \
-e OTEL_LOG_LEVEL="info"
ghcr.io/pbrissaud/n8n-opentelemetry:latest
```
If you only want to activate logging, you can set the following environment variables:
```bash
docker run -it --rm \
-e OTEL_SDK_DISABLED="false" \
-e OTEL_LOG_LEVEL="info"
ghcr.io/pbrissaud/n8n-opentelemetry:latest
```
## Full stack
You can use the [compose.yaml](compose.yaml) file to run a full stack with n8n, alloy, loki, tempo and grafana.
```bash
docker compose up
```