n8n 자체 호스팅 시 디버깅을 위한 로그 설정 및 에디션별 기능 차이

n8n은 winston 라이브러리를 기반으로 로그를 관리하며, Log streaming을 제외한 대부분의 설정 옵션은 모든 에디션에서 제공되나 Log streaming은 n8n Cloud의 모든 플랜과 자체 호스팅 시 Enterprise 에디션에서만 지원됩니다.

에디션별 로그 기능 지원 범위

운영 환경이 n8n Cloud인지 자체 호스팅(Self-hosted)인지 먼저 확인하십시오.

근거: Set up logging

환경 변수를 통한 로그 구성 방법

디버깅을 위해 N8N_LOG_LEVEL 변수를 사용하여 log level을 설정하십시오.

사용 가능한 옵션은 낮은 단계부터 높은 단계 순으로 error, warn, info, debug이며 기본값은 info입니다.

근거: Set up logging

로그 파일 관리 및 용량 제한 설정

N8N_LOG_OUTPUT 변수를 통해 로그 출력 위치를 console 또는 file로 설정할 수 있으며, 콤마(,)를 사용하여 병행 설정도 가능합니다.

N8N_LOG_FILE_LOCATION 변수로 로그 파일의 저장 경로를 지정할 수 있으며, 기본 경로는 <n8nFolderPath>/logs/n8n.log입니다.

N8N_LOG_FILE_SIZE_MAX를 통해 로그 파일 하나당 최대 크기를 설정하십시오. 기본값은 16MB이며, 자체 호스팅 시 로그 파일의 최대 크기(기본 16MB)와 보관 개수(기본 100개)를 설정하여 관리해야 합니다.

N8N_LOG_FILE_COUNT_MAX 변수를 사용하여 보관할 로그 파일의 최대 개수를 설정하십시오. 이 값은 특히 워커(worker)를 사용하는 환경에서 설정해야 합니다.

근거: Set up logging

적용 조건과 확인 범위

• 공식 문서에 명시된 자체호스팅 운영 범위와 백업에 포함·제외되는 대상을 구분한다.
• 실제 인스턴스 복구·성능·비용을 검증했다고 주장하지 않는다.
• 자체 호스팅 시 로그 파일의 최대 크기(기본 16MB)와 보관 개수(기본 100개)를 설정하여 관리해야 함.
• Log streaming 기능은 Enterprise 에디션에서만 제공됨.
• 실제 인스턴스 복구, 성능, 비용에 대한 검증은 포함되지 않음.

확인일: 2026-09-30T22:51:24.092606+00:00