OpenTelemetry 트레이싱

Warning 이 기능은 아직 개발 중입니다 2.19.0부터 최초로 제공됩니다 OpenTelemetry 형식의 메트릭은 곧 제공될 예정입니다 n8n은 워크플로 및 노드 실행에 대해 OpenTelemetry 트레이스를 내보낼 수 있습니다. 이 트레이스를 사용하여 실행 지연 시간을 모니터링하고, 실패를 디버깅하고, 관찰 가능성(observability) 스택 전반에서 서비스 간 요청을 추적할 수 있습니다. n8n에서 OpenTelemetry 트레이싱에 대한 개요 영상을 시청해 보세요. 얻을 수 있는 것 # 트레이싱을 켜면, n8n은 각 실행마다 두 종류의 스팬을 내보냅니다. workflow.execute : 워크플로 실행당 하나의 스팬입니다. 워크플로 ID, 이름, 버전, 노드 수, 실행 모드, 상태, 오류 유형(있는 경우)을 기록합니다. node.execute : 노드 실행당 하나의 스팬으로, 해당 워크플로 스팬 안에 중첩됩니다. 노드 ID, 이름, 유형, 버전, 입력 및 출력 아이템 수를 기록합니다. 각 스팬에는 n8n 인스턴스를 식별하는 리소스 속성이 포함됩니다. service.name (기본값 n8n ) service.version (n8n 버전) n8n.instance.id n8n.instance.role (예: main , worker , webhook ) n8n은 트레이스 컨텍스트 전파도 처리합니다. 인바운드 : 웹훅 요청에 W3C traceparent 헤더 가 포함되어 있으면, n8n은 이를 워크플로 스팬의 부모로 사용합니다. 이렇게 하면 n8n 워크플로 트레이스가 상위 호출자와 연결됩니다. 아웃바운드 : HTTP Request node(및 n8n HTTP 헬퍼를 사용하는 다른 노드)는 아웃바운드 요청에 traceparent 헤더를 주입할 수 있습니다. 따라서 W3C 트레이스 컨텍스트를 지원하는 다운스트림 서비스는 트레이스를 이어갈 수 있습니다. 서브 워크플로 : 서브 워크플로의 스팬은 상위 워크플로의 스팬을 부모로 사용합니다. 재개된 워크플로 : 대기 후 워크플로가 재개되면, 새 스팬은 스팬 링크를 사용하여 이전 스팬으로 다시 연결됩니다. UI에서 트레이싱 활성화 # Note n8n v2.27.0부터 제공됩니다 UI에서 OpenTelemetry를 구성하려면 인스턴스 소유자 또는 관리자 권한이 있어야 합니다. 환경 변수를 설정하는 대신, Settings > OpenTelemetry 에서 트레이싱을 구성할 수 있습니다. n8n은 재시작 없이 변경 사항을 적용하며, 큐 모드 에서 워커와 웹훅 프로세서 전반에 걸쳐 이를 다시 로드합니다. 트레이싱을 구성하려면 다음을 수행하세요. Settings > OpenTelemetry 를 선택합니다. Enable OpenTelemetry 를 켭니다. Collector connection 아래에서 OTLP endpoint 와 기타 연결 세부 정보를 입력합니다. Tracing 아래에서 샘플링 및 스팬 옵션을 설정합니다. Save settings 를 선택합니다. n8n이 컬렉터에 연결할 수 있는지 확