셀프 호스팅 동시성 제어

셀프 호스팅 n8n에서 프로덕션 실행의 동시성 한도를 설정하여 성능을 관리하는 방법을 설명합니다.

셀프 호스팅 n8n 전용 이 문서는 셀프 호스팅 동시성 제어를 위한 것입니다. n8n Cloud 계정에서 동시성이 어떻게 작동하는지 알아보려면 Cloud 동시성 을 읽어보세요. 일반 모드에서 n8n은 동시에 실행될 수 있는 프로덕션 실행 수를 제한하지 않습니다. 이로 인해 너무 많은 동시 실행이 이벤트 루프를 과부하시켜 성능 저하 및 응답 불능 상태가 발생할 수 있습니다. 이를 방지하기 위해 일반 모드에서 프로덕션 실행에 대한 동시성 한도를 설정할 수 있습니다. 이를 사용하여 동시에 실행되는 프로덕션 실행 수를 제어하고, 한도를 초과하는 동시 프로덕션 실행을 큐에 넣습니다. 이러한 실행은 동시성 용량이 확보될 때까지 큐에 남아 있다가 FIFO 순서로 처리됩니다. 동시성 제어는 기본적으로 비활성화되어 있습니다. 활성화하려면: export N8N_CONCURRENCY_PRODUCTION_LIMIT=20 유의 사항: 동시성 제어는 프로덕션 실행에만 적용됩니다: 웹훅 또는 트리거 노드에서 시작된 실행. 수동 실행, 서브 워크플로 실행, 오류 실행, CLI에서 시작된 실행에는 적용되지 않습니다. 큐에 있는 실행을 재시도할 수 없습니다. 큐에 있는 실행을 취소하거나 삭제하면 큐에서도 제거됩니다. 인스턴스 시작 시 n8n은 동시성 한도까지 큐에 있는 실행을 재개하고 나머지는 다시 큐에 넣습니다. 동시성 제어를 모니터링하려면 실행이 큐에 추가되고 해제되는 로그를 확인합니다. 향후 버전에서 n8n은 UI에서 동시성 제어를 보여줄 것입니다. 동시성 제어를 활성화하면 프로젝트 또는 워크플로의 실행 탭 상단에서 활성 실행 수와 설정된 한도를 확인할 수 있습니다. 큐 모드와 비교 # 큐 모드에서는 --concurrency 플래그 를 사용하여 워커가 동시에 실행할 수 있는 작업 수를 제어할 수 있습니다. 큐 모드의 동시성 제어는 일반 모드의 동시성 제어와 별도의 메커니즘이지만, 환경 변수 N8N_CONCURRENCY_PRODUCTION_LIMIT 가 둘 다 제어합니다. 큐 모드에서 n8n은 이 변수가 -1 이외의 값으로 설정된 경우 이 변수에서 한도를 가져오고, 그렇지 않으면 --concurrency 플래그 또는 해당 기본값으로 폴백합니다.