OpenTelemetry 환경 변수
n8n v2.29요약
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. n8n은 워크플로 및 노드 실행 추적을 OTLP를 통해 OpenTelemetry 컬렉터로 내보낼 수 있습니다.
참고
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
n8n은 워크플로 및 노드 실행 추적을 OTLP를 통해 OpenTelemetry 컬렉터로 내보낼 수 있습니다. 자세한 내용은 OpenTelemetry 추적을 참고하세요.
| 변수 | 유형 | 기본값 | 설명 | 지원 시작 버전 |
|---|---|---|---|---|
N8N_OTEL_ENABLED |
Boolean | false |
OpenTelemetry 추적을 활성화할지 여부입니다. false로 설정하면 n8n은 OpenTelemetry SDK를 로드하지 않습니다. |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_ENDPOINT |
String | http://localhost:4318 |
추적을 내보낼 OTLP HTTP 엔드포인트의 기본 URL입니다. n8n은 이 URL에 N8N_OTEL_EXPORTER_OTLP_TRACING_PATH 값을 덧붙입니다. |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_TRACING_PATH |
String | /v1/traces |
추적을 내보낼 때 N8N_OTEL_EXPORTER_OTLP_ENDPOINT에 덧붙이는 경로입니다. |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_HEADERS |
String | - | 각 OTLP 요청에 HTTP 헤더로 전송할 쉼표로 구분된 key=value 쌍 목록입니다. 인증 토큰이나 테넌트 헤더에 사용합니다. 예: authorization=Bearer <token>,x-tenant=acme. |
2.19.0 |
N8N_OTEL_EXPORTER_SERVICE_NAME |
String | n8n |
내보낸 span의 service.name 리소스 속성 값입니다. |
2.19.0 |
N8N_OTEL_TRACES_SAMPLE_RATE |
Number | 1.0 |
내보낼 추적의 비율로, 0과 1 사이의 값입니다. n8n은 트레이스 ID 비율 샘플러를 사용하므로, 한 추적 내의 모든 span은 함께 샘플링되거나 함께 제외됩니다. |
2.19.0 |
N8N_OTEL_TRACES_INCLUDE_NODE_SPANS |
Boolean | true |
각 노드 실행에 대해 node.execute span을 발행할지 여부입니다. 워크플로 수준의 span만 내보내려면 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 |
Number | 2000 |
OTLP 엔드포인트에 대한 시작 시 연결 확인 시간 제한(밀리초)입니다. 이 시간 내에 엔드포인트에 연결할 수 없으면 n8n이 경고를 기록합니다. | 2.19.0 |