OpenTelemetry 환경 변수
n8n v2.25요약
개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. n8n은 OTLP를 통해 워크플로 및 노드 실행 트레이스를 OpenTelemetry 콜렉터로 내보낼 수 있습니다.
파일 기반 구성
개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.
n8n은 OTLP를 통해 워크플로 및 노드 실행 트레이스를 OpenTelemetry 콜렉터로 내보낼 수 있습니다. 자세한 내용은 OpenTelemetry 트레이싱을 참조하세요.
| 변수 | 타입 | 기본값 | 설명 | 적용 버전 |
|---|---|---|---|---|
N8N_OTEL_ENABLED |
부울(boolean) | false |
OpenTelemetry 트레이싱 활성화 여부. false로 설정하면 n8n이 OpenTelemetry SDK를 로드하지 않습니다. |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_ENDPOINT |
문자열 | http://localhost:4318 |
트레이스를 내보낼 OTLP HTTP 엔드포인트의 기본 URL. n8n은 이 URL에 N8N_OTEL_EXPORTER_OTLP_TRACING_PATH 값을 추가합니다. |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_TRACING_PATH |
문자열 | /v1/traces |
트레이스 내보내기를 위해 N8N_OTEL_EXPORTER_OTLP_ENDPOINT에 추가되는 경로. |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_HEADERS |
문자열 | - | 각 OTLP 요청과 함께 HTTP 헤더로 전송할 key=value 쌍의 쉼표로 구분된 목록. 인증 토큰이나 테넌트 헤더에 사용합니다. 예: authorization=Bearer <token>,x-tenant=acme. |
2.19.0 |
N8N_OTEL_EXPORTER_SERVICE_NAME |
문자열 | n8n |
내보낸 스팬의 service.name 리소스 속성 값. |
2.19.0 |
N8N_OTEL_TRACES_SAMPLE_RATE |
숫자 | 1.0 |
내보낼 트레이스의 비율(0~1 사이). n8n은 트레이스 ID 비율 샘플러를 사용하므로 트레이스 내 모든 스팬이 함께 샘플링되거나 제외됩니다. |
2.19.0 |
N8N_OTEL_TRACES_INCLUDE_NODE_SPANS |
부울(boolean) | true |
각 노드 실행에 대해 node.execute 스팬을 내보낼지 여부. 워크플로 수준 스팬만 내보내려면 false로 설정합니다. |
2.19.0 |
N8N_OTEL_TRACES_PRODUCTION_ONLY |
부울(boolean) | true |
프로덕션 실행에 대해서만 트레이스를 내보낼지 여부. 모든 워크플로 실행에 대한 트레이스를 내보내려면 false로 설정합니다. |
2.25.2 |
N8N_OTEL_TRACES_INJECT_OUTBOUND |
부울(boolean) | true |
n8n의 HTTP 헬퍼를 사용하는 노드가 만드는 아웃바운드 HTTP 요청에 W3C traceparent/tracesstate 헤더를 주입할지 여부. |
2.19.0 |
N8N_OTEL_STARTUP_CONNECTIVITY_TIMEOUT_MS |
숫자 | 2000 |
OTLP 엔드포인트에 대한 시작 시 연결 확인의 타임아웃(밀리초). 이 기간 내에 엔드포인트에 도달할 수 없으면 n8n이 경고를 기록합니다. | 2.19.0 |