InfoGrab DocsInfoGrab Docs

스케줄러 환경 변수

요약

이 환경 변수는 각 인스턴스의 메모리 대신 데이터베이스 기반 큐에서 시간 기반 워크플로를 실행하는 durable scheduler를 구성합니다. N8N_METRICS_INCLUDE_SCHEDULER_METRICS와 N8N_METRICS_SCHEDULER_INTERVAL로 durable scheduler의 Prometheus 메트릭을 켤 수 있습니다.

이 환경 변수는 각 인스턴스의 메모리 대신 데이터베이스 기반 큐에서 시간 기반 워크플로를 실행하는 durable scheduler를 구성합니다. n8n 2.45.0부터 기본으로 켜져 있습니다. durable scheduler가 무엇을 변경하는지, 작동 방식, 인메모리 스케줄러를 사용하는 방법에 대해서는 Durable scheduler를 참고하세요.

N8N_METRICS_INCLUDE_SCHEDULER_METRICS와 N8N_METRICS_SCHEDULER_INTERVAL로 durable scheduler의 Prometheus 메트릭을 켤 수 있습니다. 이 변수들은 다른 메트릭 변수와 함께 Endpoints 페이지에 있습니다. 각 메트릭의 의미는 Durable scheduler 관찰성을 참고하세요.

Note

기능 사용 가능 여부

durable scheduler는 n8n 2.36.0부터 사용할 수 있습니다. n8n 2.32.0까지의 이전 버전에는 Preview 기능으로 포함되어 있습니다.

스케줄러 활성화#

변수 유형 기본값 설명
N8N_SCHEDULER_ENABLED Boolean true durable scheduler를 사용할지 여부입니다. n8n 2.45.0부터 기본값은 true입니다(이전 버전에서는 false). 인메모리 스케줄러를 사용하려면 false로 설정하세요. Schedule Trigger 노드를 인계받으려면 마찬가지로 기본으로 켜져 있는 N8N_USE_WORKFLOW_PUBLICATION_SERVICE가 필요합니다. n8n 2.45.0부터 더 이상 사용되지 않습니다(deprecated). 향후 버전에서 이 변수와 인메모리 스케줄러가 제거될 예정입니다.
N8N_SCHEDULER_POLL_TRIGGERS_ENABLED Boolean false durable scheduler가 폴링 트리거(Poll Times 파라미터가 있는 트리거 노드)도 인계받을지 여부입니다. N8N_SCHEDULER_ENABLED와 N8N_USE_WORKFLOW_PUBLICATION_SERVICE가 필요합니다. n8n 2.33.0부터 사용할 수 있습니다.
N8N_SCHEDULER_SYSTEM_TASKS_ENABLED Boolean false durable scheduler가 리더 main의 프로세스 내 타이머 대신 n8n의 내부 유지 관리 작업을 실행할지 여부입니다. N8N_SCHEDULER_ENABLED가 필요합니다. 두 변수 모두 모든 main에 같은 값을 지정하고, 모든 main에서 같은 n8n 버전을 실행하세요. 두 플래그 중 하나라도 꺼져 있는 main은 시작할 때 이러한 작업의 durable 스케줄을 제거합니다. 모든 시스템 작업을 durable scheduler에서 실행하는 첫 버전인 n8n 2.45.0부터 사용하세요. 시스템 작업을 참고하세요.

n8n 2.45.0에서는 N8N_ENV_FEAT_SKIP_DURABLE_SCHEDULER와 Skip Durable Scheduler 노드 설정이 제거되었습니다. 모든 Schedule Trigger 노드에 인메모리 스케줄러를 사용하려면 N8N_SCHEDULER_ENABLED=false로 설정하고 n8n을 재시작하세요. 인메모리 스케줄러 사용하기를 참고하세요.

Warning

폴링 트리거 지원은 아직 100% 안정적이지 않습니다. 폴링 워크플로를 면밀히 관찰할 준비가 되어 있지 않다면 프로덕션에서는 N8N_SCHEDULER_POLL_TRIGGERS_ENABLED를 꺼 두세요. 실행 목록에서 누락되거나 중복된 실행이 없는지 확인하고, 스케줄러 메트릭을 켜서 스케줄링 지연, 재시도, 데드레터를 관찰하세요(Durable scheduler 관찰성 참고). 이는 안정적인 Schedule Trigger 지원에는 영향을 주지 않습니다.

Poll triggers#

Poll Times 파라미터가 있는 트리거 노드(예: Google Sheets Trigger, Airtable Trigger)를 제어합니다. 노드가 커서(노드가 이미 어디까지 읽었는지에 대한 기록)를 저장하는 방식과 단일 폴링이 실행될 수 있는 시간을 설정합니다. 이러한 노드를 durable scheduler를 통해 실행하려면 N8N_SCHEDULER_POLL_TRIGGERS_ENABLED(스케줄러 활성화 표에 있음)를 켜세요. Poll triggers를 참고하세요.

변수 유형 기본값 설명
N8N_POLLER_DURABLE_CURSORS_ENABLED Boolean false n8n이 폴링 트리거 노드의 커서를 전용 데이터베이스 테이블에 저장하고, 해당 폴링이 만든 실행과 같은 트랜잭션에서 커밋할지 여부입니다. 이렇게 하면 폴링 도중 크래시가 발생해도 데이터가 유실되거나 중복되지 않습니다. n8n 2.36.0부터 사용할 수 있습니다. n8n 2.37.0부터는 N8N_SCHEDULER_ENABLED, N8N_SCHEDULER_POLL_TRIGGERS_ENABLED, N8N_USE_WORKFLOW_PUBLICATION_SERVICE가 필요합니다. Durable poll cursors를 참고하세요.
N8N_SCHEDULER_POLL_TIMEOUT Number 45 단일 폴링이 n8n에 의해 포기되기까지 실행될 수 있는 최대 시간(초)입니다. 포기된 폴링은 아무것도 기록하지 않습니다. 커서는 그대로 유지되고 다음 폴링이 같은 범위를 다시 다루므로 누락되는 데이터가 없습니다. 계속 타임아웃되는 폴링은 실패로 간주되어, n8n이 점점 늘어나는 간격으로 다시 폴링합니다. 타임아웃은 N8N_SCHEDULER_LEASE_DURATION보다 작게 유지하세요. 타임아웃 시계는 폴링 자체가 시작된 뒤에야 작동하기 때문에, 임대 시간 전체를 허용받은 폴링은 다른 인스턴스가 해당 실행을 인계받은 뒤에도 계속 실행 중일 수 있습니다. 타임아웃이 임대 기간에 도달하면 n8n은 시작할 때 경고를 표시합니다. 0보다 커야 합니다. n8n 2.37.0부터 사용할 수 있습니다.

구체화(Materialization)#

스케줄러가 다가오는 실행을 데이터베이스에 얼마나 미리, 얼마나 자주 기록하는지를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_MATERIALIZATION_WINDOW Number 60 스케줄러가 다가오는 실행을 몇 초 앞서 기록할지를 지정합니다. 값이 클수록 실행을 더 미리 커밋합니다(다운타임에 더 강하지만 스토리지 사용량이 다소 늘어남). 0보다 커야 합니다.
N8N_SCHEDULER_MATERIALIZATION_INTERVAL Number 10 스케줄러가 활성 스케줄을 스캔하여 윈도우 내의 실행을 기록하는 주기(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_MATERIALIZATION_TIMEOUT Number 60 단일 스캔이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 느린 데이터베이스로 인해 스캔이 멈추는 상황을 방지합니다. 0보다 커야 합니다.

실행(Execution)#

스케줄러가 예정된 실행을 얼마나 자주 시작하는지, 그리고 하나의 인스턴스만 실행하도록 각 실행을 어떻게 확보(claim)하는지를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_EXECUTOR_INTERVAL Number 5 스케줄러가 도래할 기록된 실행을 확인하는 주기(초)입니다. 확인할 때마다 다음 주기 안에 도래하는 실행을 확보(claim)하고 정밀한 타이머로 보유하므로, 실행은 폴링 주기가 아니라 예정된 시각에 정확히 시작됩니다. 이 주기는 새로 활성화되었거나 편집된 스케줄을 스케줄러가 인식하는 데 걸리는 최대 시간을 결정합니다. 0보다 커야 합니다.
N8N_SCHEDULER_EXECUTOR_TIMEOUT Number 60 예정된 실행을 확인하는 단일 작업이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_LEASE_DURATION Number 60 한 인스턴스가 가져온 실행에 대한 독점 확보(claim) 권한을 유지하는 시간(초)으로, 다른 인스턴스가 동일한 실행을 시작하지 못하게 합니다. 인스턴스가 완료 전에 중단되면 이 시간이 지난 후 확보 권한이 만료되어 다른 인스턴스가 인계받을 수 있습니다. 실행이 시작되는 데 걸리는 시간보다 충분히 길게 설정하세요. 너무 짧으면 중복 실행 위험이 있고, 너무 길면 크래시 이후 복구가 지연됩니다. 0보다 커야 합니다.
N8N_SCHEDULER_CLAIM_BATCH_SIZE Number 100 한 번의 확보(claim) 작업에서 큐로부터 가져오는 최대 실행 수입니다. 배치가 클수록 백로그를 더 빨리 해소하지만, 한 인스턴스가 한 번에 더 많은 작업을 보유하게 됩니다. 0보다 커야 합니다.

복구(Recovery)#

인스턴스가 확보했지만 완료하지 못한 실행을 다른 인스턴스가 인계받을 수 있도록 해제하는 reaper를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_REAPER_INTERVAL Number 30 스케줄러가 인스턴스가 확보했지만 완료하지 못한 실행(예: 크래시나 종료 이후)을 찾아 다시 사용 가능하게 만드는 주기(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_REAPER_BATCH_SIZE Number 100 한 번의 reaper 작업에서 회수하는 만료된 확보(claim)의 최대 개수입니다. 배치가 클수록 백로그를 더 빨리 복구하지만, 한 인스턴스가 한 번에 더 많은 작업을 보유하게 됩니다. 0보다 커야 합니다.
N8N_SCHEDULER_REAPER_TIMEOUT Number 60 단일 복구 작업이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_MAX_ATTEMPTS Number 5 n8n이 예정된 실행을 포기하고 데드레터 처리하기 전까지, 해당 실행을 다시 확보(예: 크래시 이후)하거나 오류 발생 시 재시도할 수 있는 최대 횟수입니다. 인스턴스 재시작이나 일시적 오류가 자주 발생하는 인프라에서는 값을 높이고, 더 빨리 포기하고 넘어가려면 값을 낮추세요. 0보다 커야 합니다.

보존(Retention)#

스케줄러가 완료된 실행을 이력으로 얼마나 오래 보관하는지, 그리고 오래된 실행을 얼마나 자주 삭제하는지를 제어합니다. n8n은 문제를 파악하고 디버깅할 시간을 확보할 수 있도록, 실패하거나 놓친 실행을 정상 완료된 실행보다 더 오래 보관합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_RETENTION Number 86400 스케줄러가 정상적으로 완료된 실행(성공 또는 취소)을 삭제하기 전까지 보관하는 시간(초)입니다. 기본값은 하루입니다. 값을 높이면 더 많은 이력을 보관하고, 낮추면 데이터베이스 공간을 더 빨리 회수합니다. 0보다 커야 합니다.
N8N_SCHEDULER_FAILED_RETENTION Number 604800 스케줄러가 잘못된 실행(실패 또는 놓친 실행)을 삭제하기 전까지 보관하는 시간(초)입니다. 기본값은 7일입니다. 디버깅할 시간을 확보할 수 있도록 N8N_SCHEDULER_RETENTION보다 길게 설정하세요. 더 낮게 설정하면 스케줄러가 경고를 표시합니다. 0보다 커야 합니다.
N8N_SCHEDULER_RETENTION_INTERVAL Number 3600 스케줄러가 보관 기간이 지난 완료된 실행을 삭제하는 주기(초)입니다. 기본값은 1시간입니다. 0보다 커야 합니다.
N8N_SCHEDULER_RETENTION_TIMEOUT Number 300 단일 정리 작업이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 기본값은 5분입니다. 0보다 커야 합니다.

Owner reconciliation#

더 이상 존재하지 않는 소유자의 스케줄(예: 더 이상 게시되지 않은 워크플로)을 정리하는 점검을 제어합니다. 이 점검은 해당 스케줄을 즉시 중지하고 유예 기간이 지난 후 삭제합니다. durable scheduler 작동 방식을 참고하세요.

Note

기능 사용 가능 여부

Owner reconciliation은 n8n 2.39.0부터 사용할 수 있습니다.

변수 유형 기본값 설명
N8N_SCHEDULER_OWNER_RECONCILIATION_ENABLED Boolean true 스케줄러가 모든 스케줄의 소유자가 아직 존재하는지 주기적으로 확인하고, 소유자가 없는 스케줄을 정리할지 여부입니다. 끄면 해당 스케줄이 그대로 남습니다.
N8N_SCHEDULER_OWNER_RECONCILIATION_INTERVAL Number 900 점검이 실행되는 주기(초)입니다. 기본값은 15분입니다. 일반적인 정리 경로가 아니라 안전망이므로 긴 주기도 문제없습니다. 0보다 커야 합니다.
N8N_SCHEDULER_OWNER_RECONCILIATION_TIMEOUT Number 300 단일 점검이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 기본값은 5분입니다. 0보다 커야 합니다.
N8N_SCHEDULER_OWNER_RECONCILIATION_BATCH_SIZE Number 500 점검이 데이터베이스 쿼리 한 번에 확인하는 소유자 수입니다. 배치가 클수록 더 적은 쿼리로 점검을 마치고, 작을수록 각 쿼리가 가벼워집니다. 1에서 1000 사이여야 합니다.
N8N_SCHEDULER_OWNER_QUARANTINE_GRACE Number 86400 점검이 중지한 스케줄을 삭제하기 전까지 보관하는 시간(초)입니다. 기본값은 하루입니다. 스케줄은 점검이 발견하는 즉시 실행이 중지되므로, 이 값은 삭제 시점만 늦춥니다. 0보다 커야 합니다.
N8N_SCHEDULER_OWNER_SETTLE_PERIOD Number 300 점검이 스케줄을 검토 대상으로 삼기 전에 스케줄이 최소한 지나야 하는 경과 시간(초)입니다. 기본값은 5분입니다. n8n은 스케줄을 소유자보다 잠깐 먼저 기록할 수 있으므로, 이 값은 점검이 갓 생성된 스케줄을 버려진 스케줄로 오인하지 않게 합니다. 0보다 커야 합니다.

인스턴스 간 조정#

스케줄러가 백그라운드 작업을 어떻게 중첩시키고 인스턴스 간에 데이터베이스 부하를 분산하는지를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_MAX_CONCURRENT_PASSES Number 10 데이터베이스가 중첩 작업을 지원하는 경우(PostgreSQL), 한 인스턴스에서 동시에 실행할 수 있는 동일 종류의 백그라운드 작업 최대 개수입니다. 한도가 이미 사용 중일 때 작업이 도래하면 n8n은 이를 건너뜁니다. SQLite에서는 작업이 절대 중첩되지 않으므로 이 설정은 영향을 주지 않습니다. 0보다 커야 합니다.
N8N_SCHEDULER_JITTER_RATIO Number 0.1 각 주기 작업의 타이밍에 추가되는, 간격 대비 비율로 표현되는 작은 무작위 변동값입니다. 0.1로 설정하면 10초마다 실행되도록 설정된 작업이 실제로는 9~11초마다 실행됩니다. 이는 롤링 배포처럼 동시에 시작된 인스턴스들의 데이터베이스 쿼리를 분산시킵니다. 정확한 간격을 원하면 0으로 설정하고, 부하를 더 고르게 분산하려면 값을 높이세요. 0 이상 1 미만이어야 합니다.

스케줄 동작#

변수 유형 기본값 설명
N8N_SCHEDULER_TRIGGER_NODE_MODE Enum(legacy, new) new Schedule Trigger 노드의 "매 N초"와 "매 N분" 스케줄이 실행되는 방식을 지정합니다. new는 워크플로 게시 시점부터 일정한 N초 간격으로 실행을 배치하며, n8n 2.45.0부터 기본값입니다. legacy는 인메모리 스케줄러와 동일한 시계 정렬(clock-aligned) 타이밍을 유지하며, 이전 버전의 기본값입니다. 초 단위와 분 단위 간격에만 영향을 줍니다. n8n 2.45.0부터 더 이상 사용되지 않습니다(deprecated). 향후 버전에서 이 변수와 legacy 모드가 제거될 예정입니다. Schedule Trigger 타이밍을 참고하세요.
N8N_SCHEDULER_MISFIRE_GRACE Number 60 실행이 얼마나 늦게(초) 시작되어도 제시간으로 인정되는지를 지정합니다. 이보다 늦은 실행은 놓친 것으로 간주되며, 해당 트리거의 misfire 정책이 그 실행과 뒤따르는 백로그를 어떻게 처리할지 결정합니다. 스케줄이 상속하는 기본값이며, n8n 2.36.0부터는 Schedule Trigger 노드가 자체 유예 시간을 설정할 수 있습니다. N8N_SCHEDULER_EXECUTOR_INTERVAL보다 커야 하고 N8N_SCHEDULER_MATERIALIZATION_WINDOW 이상이어야 하며, 그렇지 않으면 n8n이 시작할 때 경고를 표시합니다. 최대 30일로 제한됩니다. Misfire policy를 참고하세요. n8n 2.34.0부터 사용할 수 있습니다.

관련 리소스#

스케줄러 환경 변수

n8n v2.47
원문 보기

요약

이 환경 변수는 각 인스턴스의 메모리 대신 데이터베이스 기반 큐에서 시간 기반 워크플로를 실행하는 durable scheduler를 구성합니다. N8N_METRICS_INCLUDE_SCHEDULER_METRICS와 N8N_METRICS_SCHEDULER_INTERVAL로 durable scheduler의 Prometheus 메트릭을 켤 수 있습니다.

이 환경 변수는 각 인스턴스의 메모리 대신 데이터베이스 기반 큐에서 시간 기반 워크플로를 실행하는 durable scheduler를 구성합니다. n8n 2.45.0부터 기본으로 켜져 있습니다. durable scheduler가 무엇을 변경하는지, 작동 방식, 인메모리 스케줄러를 사용하는 방법에 대해서는 Durable scheduler를 참고하세요.

N8N_METRICS_INCLUDE_SCHEDULER_METRICS와 N8N_METRICS_SCHEDULER_INTERVAL로 durable scheduler의 Prometheus 메트릭을 켤 수 있습니다. 이 변수들은 다른 메트릭 변수와 함께 Endpoints 페이지에 있습니다. 각 메트릭의 의미는 Durable scheduler 관찰성을 참고하세요.

Note

기능 사용 가능 여부

durable scheduler는 n8n 2.36.0부터 사용할 수 있습니다. n8n 2.32.0까지의 이전 버전에는 Preview 기능으로 포함되어 있습니다.

스케줄러 활성화#

변수 유형 기본값 설명
N8N_SCHEDULER_ENABLED Boolean true durable scheduler를 사용할지 여부입니다. n8n 2.45.0부터 기본값은 true입니다(이전 버전에서는 false). 인메모리 스케줄러를 사용하려면 false로 설정하세요. Schedule Trigger 노드를 인계받으려면 마찬가지로 기본으로 켜져 있는 N8N_USE_WORKFLOW_PUBLICATION_SERVICE가 필요합니다. n8n 2.45.0부터 더 이상 사용되지 않습니다(deprecated). 향후 버전에서 이 변수와 인메모리 스케줄러가 제거될 예정입니다.
N8N_SCHEDULER_POLL_TRIGGERS_ENABLED Boolean false durable scheduler가 폴링 트리거(Poll Times 파라미터가 있는 트리거 노드)도 인계받을지 여부입니다. N8N_SCHEDULER_ENABLED와 N8N_USE_WORKFLOW_PUBLICATION_SERVICE가 필요합니다. n8n 2.33.0부터 사용할 수 있습니다.
N8N_SCHEDULER_SYSTEM_TASKS_ENABLED Boolean false durable scheduler가 리더 main의 프로세스 내 타이머 대신 n8n의 내부 유지 관리 작업을 실행할지 여부입니다. N8N_SCHEDULER_ENABLED가 필요합니다. 두 변수 모두 모든 main에 같은 값을 지정하고, 모든 main에서 같은 n8n 버전을 실행하세요. 두 플래그 중 하나라도 꺼져 있는 main은 시작할 때 이러한 작업의 durable 스케줄을 제거합니다. 모든 시스템 작업을 durable scheduler에서 실행하는 첫 버전인 n8n 2.45.0부터 사용하세요. 시스템 작업을 참고하세요.

n8n 2.45.0에서는 N8N_ENV_FEAT_SKIP_DURABLE_SCHEDULER와 Skip Durable Scheduler 노드 설정이 제거되었습니다. 모든 Schedule Trigger 노드에 인메모리 스케줄러를 사용하려면 N8N_SCHEDULER_ENABLED=false로 설정하고 n8n을 재시작하세요. 인메모리 스케줄러 사용하기를 참고하세요.

Warning

폴링 트리거 지원은 아직 100% 안정적이지 않습니다. 폴링 워크플로를 면밀히 관찰할 준비가 되어 있지 않다면 프로덕션에서는 N8N_SCHEDULER_POLL_TRIGGERS_ENABLED를 꺼 두세요. 실행 목록에서 누락되거나 중복된 실행이 없는지 확인하고, 스케줄러 메트릭을 켜서 스케줄링 지연, 재시도, 데드레터를 관찰하세요(Durable scheduler 관찰성 참고). 이는 안정적인 Schedule Trigger 지원에는 영향을 주지 않습니다.

Poll triggers#

Poll Times 파라미터가 있는 트리거 노드(예: Google Sheets Trigger, Airtable Trigger)를 제어합니다. 노드가 커서(노드가 이미 어디까지 읽었는지에 대한 기록)를 저장하는 방식과 단일 폴링이 실행될 수 있는 시간을 설정합니다. 이러한 노드를 durable scheduler를 통해 실행하려면 N8N_SCHEDULER_POLL_TRIGGERS_ENABLED(스케줄러 활성화 표에 있음)를 켜세요. Poll triggers를 참고하세요.

변수 유형 기본값 설명
N8N_POLLER_DURABLE_CURSORS_ENABLED Boolean false n8n이 폴링 트리거 노드의 커서를 전용 데이터베이스 테이블에 저장하고, 해당 폴링이 만든 실행과 같은 트랜잭션에서 커밋할지 여부입니다. 이렇게 하면 폴링 도중 크래시가 발생해도 데이터가 유실되거나 중복되지 않습니다. n8n 2.36.0부터 사용할 수 있습니다. n8n 2.37.0부터는 N8N_SCHEDULER_ENABLED, N8N_SCHEDULER_POLL_TRIGGERS_ENABLED, N8N_USE_WORKFLOW_PUBLICATION_SERVICE가 필요합니다. Durable poll cursors를 참고하세요.
N8N_SCHEDULER_POLL_TIMEOUT Number 45 단일 폴링이 n8n에 의해 포기되기까지 실행될 수 있는 최대 시간(초)입니다. 포기된 폴링은 아무것도 기록하지 않습니다. 커서는 그대로 유지되고 다음 폴링이 같은 범위를 다시 다루므로 누락되는 데이터가 없습니다. 계속 타임아웃되는 폴링은 실패로 간주되어, n8n이 점점 늘어나는 간격으로 다시 폴링합니다. 타임아웃은 N8N_SCHEDULER_LEASE_DURATION보다 작게 유지하세요. 타임아웃 시계는 폴링 자체가 시작된 뒤에야 작동하기 때문에, 임대 시간 전체를 허용받은 폴링은 다른 인스턴스가 해당 실행을 인계받은 뒤에도 계속 실행 중일 수 있습니다. 타임아웃이 임대 기간에 도달하면 n8n은 시작할 때 경고를 표시합니다. 0보다 커야 합니다. n8n 2.37.0부터 사용할 수 있습니다.

구체화(Materialization)#

스케줄러가 다가오는 실행을 데이터베이스에 얼마나 미리, 얼마나 자주 기록하는지를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_MATERIALIZATION_WINDOW Number 60 스케줄러가 다가오는 실행을 몇 초 앞서 기록할지를 지정합니다. 값이 클수록 실행을 더 미리 커밋합니다(다운타임에 더 강하지만 스토리지 사용량이 다소 늘어남). 0보다 커야 합니다.
N8N_SCHEDULER_MATERIALIZATION_INTERVAL Number 10 스케줄러가 활성 스케줄을 스캔하여 윈도우 내의 실행을 기록하는 주기(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_MATERIALIZATION_TIMEOUT Number 60 단일 스캔이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 느린 데이터베이스로 인해 스캔이 멈추는 상황을 방지합니다. 0보다 커야 합니다.

실행(Execution)#

스케줄러가 예정된 실행을 얼마나 자주 시작하는지, 그리고 하나의 인스턴스만 실행하도록 각 실행을 어떻게 확보(claim)하는지를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_EXECUTOR_INTERVAL Number 5 스케줄러가 도래할 기록된 실행을 확인하는 주기(초)입니다. 확인할 때마다 다음 주기 안에 도래하는 실행을 확보(claim)하고 정밀한 타이머로 보유하므로, 실행은 폴링 주기가 아니라 예정된 시각에 정확히 시작됩니다. 이 주기는 새로 활성화되었거나 편집된 스케줄을 스케줄러가 인식하는 데 걸리는 최대 시간을 결정합니다. 0보다 커야 합니다.
N8N_SCHEDULER_EXECUTOR_TIMEOUT Number 60 예정된 실행을 확인하는 단일 작업이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_LEASE_DURATION Number 60 한 인스턴스가 가져온 실행에 대한 독점 확보(claim) 권한을 유지하는 시간(초)으로, 다른 인스턴스가 동일한 실행을 시작하지 못하게 합니다. 인스턴스가 완료 전에 중단되면 이 시간이 지난 후 확보 권한이 만료되어 다른 인스턴스가 인계받을 수 있습니다. 실행이 시작되는 데 걸리는 시간보다 충분히 길게 설정하세요. 너무 짧으면 중복 실행 위험이 있고, 너무 길면 크래시 이후 복구가 지연됩니다. 0보다 커야 합니다.
N8N_SCHEDULER_CLAIM_BATCH_SIZE Number 100 한 번의 확보(claim) 작업에서 큐로부터 가져오는 최대 실행 수입니다. 배치가 클수록 백로그를 더 빨리 해소하지만, 한 인스턴스가 한 번에 더 많은 작업을 보유하게 됩니다. 0보다 커야 합니다.

복구(Recovery)#

인스턴스가 확보했지만 완료하지 못한 실행을 다른 인스턴스가 인계받을 수 있도록 해제하는 reaper를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_REAPER_INTERVAL Number 30 스케줄러가 인스턴스가 확보했지만 완료하지 못한 실행(예: 크래시나 종료 이후)을 찾아 다시 사용 가능하게 만드는 주기(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_REAPER_BATCH_SIZE Number 100 한 번의 reaper 작업에서 회수하는 만료된 확보(claim)의 최대 개수입니다. 배치가 클수록 백로그를 더 빨리 복구하지만, 한 인스턴스가 한 번에 더 많은 작업을 보유하게 됩니다. 0보다 커야 합니다.
N8N_SCHEDULER_REAPER_TIMEOUT Number 60 단일 복구 작업이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 0보다 커야 합니다.
N8N_SCHEDULER_MAX_ATTEMPTS Number 5 n8n이 예정된 실행을 포기하고 데드레터 처리하기 전까지, 해당 실행을 다시 확보(예: 크래시 이후)하거나 오류 발생 시 재시도할 수 있는 최대 횟수입니다. 인스턴스 재시작이나 일시적 오류가 자주 발생하는 인프라에서는 값을 높이고, 더 빨리 포기하고 넘어가려면 값을 낮추세요. 0보다 커야 합니다.

보존(Retention)#

스케줄러가 완료된 실행을 이력으로 얼마나 오래 보관하는지, 그리고 오래된 실행을 얼마나 자주 삭제하는지를 제어합니다. n8n은 문제를 파악하고 디버깅할 시간을 확보할 수 있도록, 실패하거나 놓친 실행을 정상 완료된 실행보다 더 오래 보관합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_RETENTION Number 86400 스케줄러가 정상적으로 완료된 실행(성공 또는 취소)을 삭제하기 전까지 보관하는 시간(초)입니다. 기본값은 하루입니다. 값을 높이면 더 많은 이력을 보관하고, 낮추면 데이터베이스 공간을 더 빨리 회수합니다. 0보다 커야 합니다.
N8N_SCHEDULER_FAILED_RETENTION Number 604800 스케줄러가 잘못된 실행(실패 또는 놓친 실행)을 삭제하기 전까지 보관하는 시간(초)입니다. 기본값은 7일입니다. 디버깅할 시간을 확보할 수 있도록 N8N_SCHEDULER_RETENTION보다 길게 설정하세요. 더 낮게 설정하면 스케줄러가 경고를 표시합니다. 0보다 커야 합니다.
N8N_SCHEDULER_RETENTION_INTERVAL Number 3600 스케줄러가 보관 기간이 지난 완료된 실행을 삭제하는 주기(초)입니다. 기본값은 1시간입니다. 0보다 커야 합니다.
N8N_SCHEDULER_RETENTION_TIMEOUT Number 300 단일 정리 작업이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 기본값은 5분입니다. 0보다 커야 합니다.

Owner reconciliation#

더 이상 존재하지 않는 소유자의 스케줄(예: 더 이상 게시되지 않은 워크플로)을 정리하는 점검을 제어합니다. 이 점검은 해당 스케줄을 즉시 중지하고 유예 기간이 지난 후 삭제합니다. durable scheduler 작동 방식을 참고하세요.

Note

기능 사용 가능 여부

Owner reconciliation은 n8n 2.39.0부터 사용할 수 있습니다.

변수 유형 기본값 설명
N8N_SCHEDULER_OWNER_RECONCILIATION_ENABLED Boolean true 스케줄러가 모든 스케줄의 소유자가 아직 존재하는지 주기적으로 확인하고, 소유자가 없는 스케줄을 정리할지 여부입니다. 끄면 해당 스케줄이 그대로 남습니다.
N8N_SCHEDULER_OWNER_RECONCILIATION_INTERVAL Number 900 점검이 실행되는 주기(초)입니다. 기본값은 15분입니다. 일반적인 정리 경로가 아니라 안전망이므로 긴 주기도 문제없습니다. 0보다 커야 합니다.
N8N_SCHEDULER_OWNER_RECONCILIATION_TIMEOUT Number 300 단일 점검이 중단되고 다음 주기에 재시도되기까지 실행될 수 있는 최대 시간(초)입니다. 기본값은 5분입니다. 0보다 커야 합니다.
N8N_SCHEDULER_OWNER_RECONCILIATION_BATCH_SIZE Number 500 점검이 데이터베이스 쿼리 한 번에 확인하는 소유자 수입니다. 배치가 클수록 더 적은 쿼리로 점검을 마치고, 작을수록 각 쿼리가 가벼워집니다. 1에서 1000 사이여야 합니다.
N8N_SCHEDULER_OWNER_QUARANTINE_GRACE Number 86400 점검이 중지한 스케줄을 삭제하기 전까지 보관하는 시간(초)입니다. 기본값은 하루입니다. 스케줄은 점검이 발견하는 즉시 실행이 중지되므로, 이 값은 삭제 시점만 늦춥니다. 0보다 커야 합니다.
N8N_SCHEDULER_OWNER_SETTLE_PERIOD Number 300 점검이 스케줄을 검토 대상으로 삼기 전에 스케줄이 최소한 지나야 하는 경과 시간(초)입니다. 기본값은 5분입니다. n8n은 스케줄을 소유자보다 잠깐 먼저 기록할 수 있으므로, 이 값은 점검이 갓 생성된 스케줄을 버려진 스케줄로 오인하지 않게 합니다. 0보다 커야 합니다.

인스턴스 간 조정#

스케줄러가 백그라운드 작업을 어떻게 중첩시키고 인스턴스 간에 데이터베이스 부하를 분산하는지를 제어합니다.

변수 유형 기본값 설명
N8N_SCHEDULER_MAX_CONCURRENT_PASSES Number 10 데이터베이스가 중첩 작업을 지원하는 경우(PostgreSQL), 한 인스턴스에서 동시에 실행할 수 있는 동일 종류의 백그라운드 작업 최대 개수입니다. 한도가 이미 사용 중일 때 작업이 도래하면 n8n은 이를 건너뜁니다. SQLite에서는 작업이 절대 중첩되지 않으므로 이 설정은 영향을 주지 않습니다. 0보다 커야 합니다.
N8N_SCHEDULER_JITTER_RATIO Number 0.1 각 주기 작업의 타이밍에 추가되는, 간격 대비 비율로 표현되는 작은 무작위 변동값입니다. 0.1로 설정하면 10초마다 실행되도록 설정된 작업이 실제로는 9~11초마다 실행됩니다. 이는 롤링 배포처럼 동시에 시작된 인스턴스들의 데이터베이스 쿼리를 분산시킵니다. 정확한 간격을 원하면 0으로 설정하고, 부하를 더 고르게 분산하려면 값을 높이세요. 0 이상 1 미만이어야 합니다.

스케줄 동작#

변수 유형 기본값 설명
N8N_SCHEDULER_TRIGGER_NODE_MODE Enum(legacy, new) new Schedule Trigger 노드의 "매 N초"와 "매 N분" 스케줄이 실행되는 방식을 지정합니다. new는 워크플로 게시 시점부터 일정한 N초 간격으로 실행을 배치하며, n8n 2.45.0부터 기본값입니다. legacy는 인메모리 스케줄러와 동일한 시계 정렬(clock-aligned) 타이밍을 유지하며, 이전 버전의 기본값입니다. 초 단위와 분 단위 간격에만 영향을 줍니다. n8n 2.45.0부터 더 이상 사용되지 않습니다(deprecated). 향후 버전에서 이 변수와 legacy 모드가 제거될 예정입니다. Schedule Trigger 타이밍을 참고하세요.
N8N_SCHEDULER_MISFIRE_GRACE Number 60 실행이 얼마나 늦게(초) 시작되어도 제시간으로 인정되는지를 지정합니다. 이보다 늦은 실행은 놓친 것으로 간주되며, 해당 트리거의 misfire 정책이 그 실행과 뒤따르는 백로그를 어떻게 처리할지 결정합니다. 스케줄이 상속하는 기본값이며, n8n 2.36.0부터는 Schedule Trigger 노드가 자체 유예 시간을 설정할 수 있습니다. N8N_SCHEDULER_EXECUTOR_INTERVAL보다 커야 하고 N8N_SCHEDULER_MATERIALIZATION_WINDOW 이상이어야 하며, 그렇지 않으면 n8n이 시작할 때 경고를 표시합니다. 최대 30일로 제한됩니다. Misfire policy를 참고하세요. n8n 2.34.0부터 사용할 수 있습니다.

관련 리소스#