Self-hosted 동시성 제어#

self-hosted n8n 전용

이 문서는 self-hosted 동시성 제어를 위한 것입니다. n8n Cloud 계정에서 동시성이 어떻게 작동하는지 알아보려면 Cloud concurrency를 읽어보세요.

정상 모드에서 n8n은 동시에 실행될 수 있는 프로덕션 실행의 수를 제한하지 않습니다. 이로 인해 너무 많은 동시 실행이 이벤트 루프를 과도하게 사용하여 성능 저하 및 반응 없음을 초래할 수 있습니다.

이를 방지하기 위해 정상 모드에서 프로덕션 실행에 대한 동시성 제한을 설정할 수 있습니다. 이 기능을 사용하여 얼마나 많은 프로덕션 실행이 동시에 실행되는지를 제어하고, 제한을 초과하는 동시 프로덕션 실행을 대기열에 추가합니다. 이러한 실행은 동시성 용량이 해제될 때까지 대기열에 남아 있으며, 그 후 FIFO 순서로 처리됩니다.

동시성 제어는 기본값으로 비활성화되어 있습니다. 활성화하려면:

export N8N_CONCURRENCY_PRODUCTION_LIMIT=20

유의사항:

동시성 제어는 오직 프로덕션 실행에만 적용됩니다: 웹훅 또는 trigger 노드에서 시작된 실행. 수동 실행, 하위 워크플로우 실행, 오류 실행 또는 CLI에서 시작된 실행에는 적용되지 않습니다.
대기열에 있는 실행을 재시도할 수 없습니다. 대기열에서 실행을 취소하거나 삭제하면 해당 실행도 대기열에서 제거됩니다.
인스턴스 시작 시, n8n은 동시성 제한까지 대기 중인 실행을 재개하고 나머지는 다시 대기열에 추가합니다.

동시성 제어를 모니터링하려면 로그에서 대기열에 추가되고 해제되는 실행을 감시하십시오. 향후 버전에서 n8n은 UI에서 동시성 제어를 표시할 것입니다.

동시성 제어를 활성화하면 프로젝트 또는 워크플로의 실행 탭 상단에서 활성 실행의 수와 설정된 제한을 볼 수 있습니다.

대기열 모드와의 비교#

대기열 모드에서는 --concurrency 플래그를 사용하여 워커가 동시에 실행할 수 있는 작업 수를 제어할 수 있습니다.

대기열 모드의 동시성 제어는 정상 모드의 동시성 제어와 별개의 메커니즘이지만, 환경 변수 N8N_CONCURRENCY_PRODUCTION_LIMIT는 두 가지 모두를 제어합니다. 대기열 모드에서 n8n은 이 변수가 -1이 아닌 값으로 설정된 경우 이 변수에서 제한을 가져오며, 그렇지 않으면 --concurrency 플래그 또는 기본값으로 되돌아갑니다.