로그 환경 변수
n8n v2.29이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 이 페이지는 디버깅을 위한 로깅을 설정하는 데 사용하는 환경 변수를 나열합니다. 이 기능에 대한 자세한 내용은 로그 스트리밍을 참고하세요. N8N_LOG_STREAMING_MANAGED_BY_ENV를 true로 설정하면 환경 변수로 로그 스트리밍 대상을 관리할 수 있습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 페이지는 디버깅을 위한 로깅을 설정하는 데 사용하는 환경 변수를 나열합니다. 자세한 내용은 n8n에서 로깅을 참고하세요.
n8n 로그#
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_LOG_LEVEL |
Enum string: info, warn, error, debug |
info |
로그 출력 레벨입니다. 자세한 내용은 로그 레벨을 참고하세요. |
N8N_LOG_OUTPUT |
Enum string: console, file |
console |
로그를 출력할 위치입니다. 여러 값을 쉼표로 구분한 목록으로 지정할 수 있습니다. |
N8N_LOG_FORMAT |
Enum string: text, json |
text |
사용할 로그 형식입니다. text는 사람이 읽기 쉬운 메시지를 출력합니다. json은 메시지, 레벨, 타임스탬프 및 모든 메타데이터를 담은 JSON 객체를 한 줄에 하나씩 출력합니다. 이는 프로덕션 모니터링뿐만 아니라 디버깅에도 유용합니다. |
N8N_LOG_CRON_ACTIVE_INTERVAL |
Number | 0 |
현재 활성화된 cron 작업을 로그로 남기는 간격(분)입니다. 비활성화하려면 0으로 설정하세요. |
N8N_LOG_FILE_COUNT_MAX |
Number | 100 |
보관할 로그 파일의 최대 개수입니다. |
N8N_LOG_FILE_SIZE_MAX |
Number | 16 |
각 로그 파일의 최대 크기(MB)입니다. |
N8N_LOG_FILE_LOCATION |
String | <n8n-directory-path>/logs/n8n.log |
로그 파일 위치입니다. N8N_LOG_OUTPUT을 file로 설정해야 합니다. |
DB_LOGGING_ENABLED |
Boolean | false |
데이터베이스 관련 로깅을 활성화할지 여부입니다. |
DB_LOGGING_OPTIONS |
Enum string: query, error, schema, warn, info, log |
error |
데이터베이스 로그 출력 레벨입니다. 모든 로깅을 활성화하려면 all을 지정하세요. 자세한 내용은 TypeORM 로깅 옵션을 참고하세요. |
DB_LOGGING_MAX_EXECUTION_TIME |
Number | 1000 |
n8n이 경고를 로그로 남기기 전까지의 최대 실행 시간(밀리초)입니다. 장기 실행 쿼리 경고를 비활성화하려면 0으로 설정하세요. |
CODE_ENABLE_STDOUT |
Boolean | false |
true로 설정하면 console.log 또는 print로부터의 Code node 로그를 프로덕션 실행에 한해 프로세스의 stdout으로 전송합니다. |
NO_COLOR |
any | undefined |
ANSI 색상 없이 로그를 출력하려면 아무 값이나 설정하세요. 자세한 내용은 no-color.org 웹사이트를 참고하세요. |
로그 스트리밍#
이 기능에 대한 자세한 내용은 로그 스트리밍을 참고하세요.
| 변수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
N8N_EVENTBUS_CHECKUNSENTINTERVAL |
Number | 0 |
전송되지 않은 이벤트 메시지를 확인하는 간격(밀리초)입니다. 드물게 메시지가 두 번 전송될 수 있습니다. 비활성화하려면 0으로 설정하세요. |
N8N_EVENTBUS_LOGWRITER_SYNCFILEACCESS |
Boolean | false |
모든 파일 접근이 스레드 내에서 동기적으로(true) 이루어지는지, 아니면 그렇지 않은지(false) 여부입니다. |
N8N_EVENTBUS_LOGWRITER_KEEPLOGCOUNT |
Number | 3 |
보관할 이벤트 로그 파일의 개수입니다. |
N8N_EVENTBUS_LOGWRITER_MAXFILESIZEINKB |
Number | 10240 |
새 이벤트 로그 파일이 시작되기 전까지 파일의 최대 크기(킬로바이트)입니다. |
N8N_EVENTBUS_LOGWRITER_LOGBASENAME |
String | n8nEventLog |
이벤트 로그 파일의 기본 이름입니다. N8N_EVENTBUS_LOGWRITER_LOGFULLPATH가 설정된 경우 무시됩니다. |
N8N_EVENTBUS_LOGWRITER_LOGFULLPATH |
String | '' |
이벤트 로그 파일의 절대 경로입니다. .log로 끝나야 합니다. 설정하면 이 경로가 그대로 사용되며 N8N_EVENTBUS_LOGWRITER_LOGBASENAME과 기본 프로세스별 접미사를 재정의합니다. 여러 프로세스가 쓰기 가능한 파일 시스템을 공유할 때 각 n8n 프로세스에 고유한 이벤트 로그 경로를 부여하는 데 사용하세요. 자세한 내용은 프로세스별 이벤트 로그 파일을 참고하세요. |
N8N_EVENTBUS_LOGWRITER_MAXTOTALMESSAGESPERFILE |
Number | 500000 |
복구 과정에서 단일 이벤트 로그 파일로부터 파싱되는 최대 줄 수입니다. 이벤트 로그 파일에 유효하지 않은 줄이 많을 때 메모리 사용량을 제한합니다. |
환경 변수로 로그 스트리밍 대상 관리하기#
N8N_LOG_STREAMING_MANAGED_BY_ENV를 true로 설정하면 환경 변수로 로그 스트리밍 대상을 관리할 수 있습니다. 활성화 패턴이 동작하는 방식은 환경 변수를 사용한 인스턴스 설정 관리를, 대상별 JSON 형식은 환경 변수를 사용한 로그 스트리밍 대상 구성을 참고하세요.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.