로그 스트리밍

n8n에서 발생하는 이벤트를 로깅 도구로 스트리밍합니다.

Note 기능 제공 범위 로그 스트리밍은 모든 Enterprise 플랜에서 사용할 수 있습니다. 로그 스트리밍을 사용하면 n8n에서 발생하는 이벤트를 자체 로깅 도구로 전송할 수 있습니다. 이를 통해 자체 알림 및 로깅 프로세스에서 n8n 모니터링을 관리할 수 있습니다. 로그 스트리밍 설정하기 # 로그 스트리밍을 사용하려면 스트리밍 대상을 추가해야 합니다. Settings > Log Streaming 으로 이동합니다. Add new destination 을 선택합니다. 대상 유형을 선택합니다. n8n이 New Event Destination 모달을 엽니다. New Event Destination 모달에서 이벤트 대상에 대한 구성 정보를 입력합니다. 이 정보는 사용 중인 대상 유형에 따라 달라집니다. 스트리밍할 이벤트를 선택하려면 Events 를 선택합니다. Save 를 선택합니다. Note 셀프 호스팅 사용자 n8n을 셀프 호스팅하는 경우 환경 변수 를 사용하여 추가적인 로그 스트리밍 동작을 구성할 수 있습니다. 또한 환경 변수로 대상을 관리할 수도 있습니다. 자세한 내용은 환경 변수를 사용하여 로그 스트리밍 대상 구성하기 를 참고하세요. 프로세스별 이벤트 로그 파일 # n8n은 각 이벤트를 스트리밍 대상으로 전달하기 전에 로컬 로그 파일에 저장합니다. 이 파일은 재시작 후에도 유지되며, 아직 전달되지 않은 이벤트를 n8n이 다시 전송할 수 있게 해줍니다. 기본적으로 n8n은 이벤트 로그를 <n8n-user-folder>/n8nEventLog.log 에 기록하며, 해당 프로세스에는 -worker 또는 -webhook-processor 접미사가 붙습니다. 단일 n8n 프로세스가 파일을 소유하는 경우, 이 기본값은 예상대로 작동합니다. Warning 공유 쓰기 가능 파일 시스템 여러 n8n 프로세스가 하나의 쓰기 가능한 볼륨을 공유하는 경우(예: NFS 또는 EFS의 공유 영구 볼륨을 사용하는 큐 모드 워커), 동일한 이벤트 로그 파일에 기록해서는 안 됩니다. 여러 프로세스에서 동시에 추가 기록(append)하면 파일이 뒤섞이거나 손상되어 복구 실패 및 이벤트 손실로 이어질 수 있습니다. 이를 방지하려면 각 프로세스에서 N8N_EVENTBUS_LOGWRITER_LOGFULLPATH 를 .log 로 끝나는 고유한 절대 경로로 설정하세요. n8n은 구성된 경로를 그대로 사용하며 프로세스 유형 접미사를 추가하지 않으므로, 프로세스 간 고유성을 보장하는 것은 오케스트레이터의 책임입니다. 함께 사용되는 변수인 N8N_EVENTBUS_LOGWRITER_MAXTOTALMESSAGESPERFILE 은 복구 과정에서 n8n이 단일 이벤트 로그 파일에서 파싱하는 줄 수를 제한하여, 손상된 파일이 프로세스 메모리를 고갈시키지 않도록 합니다. 참고 사항: N8N_EVENTBUS_LOGWRITER_LOGFULLPATH 가 설정되지 않은 경우 기본 동작은 변경되지 않습니다. 이 변수가 설정되면 n8n은 경로에 자동으로 접미사를 붙이지 않습니다. 각 프로세스