InfoGrab Docs

로그 환경 변수

요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지에서는 디버깅을 위한 로깅 설정에 사용되는 환경 변수 목록을 제공합니다. 이 기능에 대한 자세한 내용은 로그 스트리밍을 참고하세요.

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

이 페이지에서는 디버깅을 위한 로깅 설정에 사용되는 환경 변수 목록을 제공합니다. 자세한 내용은 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 현재 활성화된 크론 작업을 로깅하는 간격(분 단위). 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로 설정하면 프로덕션 실행에서만 Code 노드의 console.log 또는 print 로그를 프로세스의 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 형식은 환경 변수를 사용한 로그 스트리밍 대상 구성을 참조하세요.

Note

이 섹션의 내용은 원문 문서를 참조하세요. (log-streaming.md)

로그 환경 변수

원문 보기
요약

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 이 페이지에서는 디버깅을 위한 로깅 설정에 사용되는 환경 변수 목록을 제공합니다. 이 기능에 대한 자세한 내용은 로그 스트리밍을 참고하세요.

파일 기반 구성

개별 변수에 _FILE을 추가하여 별도의 파일에서 구성을 제공할 수 있습니다. 자세한 내용은 별도 파일에 민감한 데이터 보관하기를 참고하세요.

이 페이지에서는 디버깅을 위한 로깅 설정에 사용되는 환경 변수 목록을 제공합니다. 자세한 내용은 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 현재 활성화된 크론 작업을 로깅하는 간격(분 단위). 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로 설정하면 프로덕션 실행에서만 Code 노드의 console.log 또는 print 로그를 프로세스의 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 형식은 환경 변수를 사용한 로그 스트리밍 대상 구성을 참조하세요.

Note

이 섹션의 내용은 원문 문서를 참조하세요. (log-streaming.md)