日志环境变量

¥Logs environment variables

File-based configuration

You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.

本页列出用于设置调试日志的环境变量。有关详细信息，请联系 正在登录 n8n。

¥This page lists environment variables to set up logging for debugging. Refer to Logging in n8n for details.

n8n 日志

¥n8n logs

变量	类型	默认	描述
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_CRON_ACTIVE_INTERVAL	数字	0	记录当前活动定时任务的间隔（分钟）。设置为 0 可禁用。
N8N_LOG_FILE_COUNT_MAX	数字	100	要保留的最大日志文件数。
N8N_LOG_FILE_SIZE_MAX	数字	16	每个日志文件的最大大小（单位：MB）。
N8N_LOG_FILE_LOCATION	字符串	<n8n-directory-path>/logs/n8n.log	日志文件位置需要将 N8N_LOG_OUTPUT 设置为 file。
DB_LOGGING_ENABLED	布尔值	false	是否启用数据库特定日志记录。
DB_LOGGING_OPTIONS	枚举字符串：query, error, schema, warn, info, log	error	数据库日志输出级别要启用所有日志记录，请指定 all。请参考 TypeORM 日志选项
DB_LOGGING_MAX_EXECUTION_TIME	数字	1000	n8n 记录警告之前的最大执行时间（单位：毫秒）。设置为 0 可禁用长时间运行查询警告。
CODE_ENABLE_STDOUT	布尔值	false	设置为 true 可将 console.log 或 print 的代码节点日志发送到进程的标准输出（stdout），仅在生产环境中执行时启用。
NO_COLOR	any	undefined	设置为任意值以输出不带 ANSI 颜色的日志。更多信息，请参阅 no-color.org 网站。

日志流

¥Log streaming

有关此功能的更多信息，请参阅 日志流。

¥Refer to Log streaming for more information on this feature.

变量	类型	默认	描述
N8N_EVENTBUS_CHECKUNSENTINTERVAL	数字	0	检查未发送事件消息的频率（以毫秒为单位）是多少？在极少数情况下，可能会发送两次消息。设置为 0 可禁用自动思考。
N8N_EVENTBUS_LOGWRITER_SYNCFILEACCESS	布尔值	false	所有文件访问是否在线程内同步进行（true）或不同步（false）。
N8N_EVENTBUS_LOGWRITER_KEEPLOGCOUNT	数字	3	要保留的事件日志文件数。
N8N_EVENTBUS_LOGWRITER_MAXFILESIZEINKB	数字	10240	事件日志文件的最大大小（以千字节为单位），超过此大小将开始生成新的事件日志文件。
N8N_EVENTBUS_LOGWRITER_LOGBASENAME	字符串	n8nEventLog	事件日志文件的基本名称。