日志环境变量

基于文件的配置

您可以在单个变量后添加 _FILE 以在单独的文件中提供其配置。有关更多详细信息，请参阅在单独文件中保存敏感数据。

本页列出了为调试设置日志记录的环境变量。有关详细信息，请参考 n8n 中的日志记录。

n8n 日志

变量	类型	默认值	描述
N8N_LOG_LEVEL	枚举字符串：info、warn、error、debug	info	日志输出级别。有关详细信息，请参考日志级别。
N8N_LOG_OUTPUT	枚举字符串：console、file	console	日志输出位置。提供多个值作为逗号分隔列表。
N8N_LOG_FORMAT	枚举字符串：text、json	text	要使用的日志格式。text 打印人类可读的消息。json 每行打印一个包含消息、级别、时间戳和所有元数据的 JSON 对象。这对于生产监控和调试都很有用。
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	枚举字符串：query、error、schema、warn、info、log	error	数据库日志输出级别。要启用所有日志记录，请指定 all。参考 TypeORM 日志记录选项
DB_LOGGING_MAX_EXECUTION_TIME	Number	1000	n8n 记录警告之前的最大执行时间（以毫秒为单位）。设置为 0 以禁用长时间运行查询警告。
CODE_ENABLE_STDOUT	Boolean	false	设置为 true 以将代码节点日志发送到进程的 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	事件日志文件的基本名称。