日志环境变量#

/// 注意 | 基于文件的配置您可以在个别变量后添加 _FILE 后缀，通过单独的文件提供配置。详情请参阅将敏感数据保存在单独文件中。 ///

本页面列出了用于设置调试日志的环境变量。详情请参考 n8n 中的日志记录。

n8n 日志#

变量名	类型	默认值	描述
`N8N_LOG_LEVEL`	枚举字符串: `info`, `warn`, `error`, `debug`	`info`	日志输出级别。详情参考日志级别。
`N8N_LOG_OUTPUT`	枚举字符串: `console`, `file`	`console`	日志输出位置。多个值以逗号分隔列表形式提供。
`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` 可将 Code 节点日志发送到进程的 stdout，用于调试、监控或日志记录目的。
`NO_COLOR`	任意值	`undefined`	设置为任意值可输出不带 ANSI 颜色的日志。更多信息请参阅 no-color.org 网站。

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

变量	类型	默认值	描述
`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`	事件日志文件的基础名称。