部署托管/Configuration/Environment_variables
日志环境变量#
基于文件的配置
你可以为单个变量添加 _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_CRON_ACTIVE_INTERVAL | 数字 | 0 | 记录当前活跃 cron 任务的时间间隔（单位：分钟）。设为 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 可在生产环境中将 Code 节点中通过 console.log 或 print 输出的日志发送到进程的标准输出（stdout）。 |
NO_COLOR | 任意值 | undefined | 设置任意值即可在日志输出中禁用 ANSI 颜色。更多信息请见 no-color.org 网站。 |
日志流（Log Streaming）#
有关此功能的更多信息，请参阅 日志流。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_EVENTBUS_CHECKUNSENTINTERVAL | 数字 | 0 | 检查未发送事件消息的频率（单位：毫秒）。极少数情况下可能导致消息重复发送。设为 0 可禁用。 |
N8N_EVENTBUS_LOGWRITER_SYNCFILEACCESS | 布尔值 | false | 是否在线程内同步进行所有文件访问（true）或异步进行（false）。 |
N8N_EVENTBUS_LOGWRITER_KEEPLOGCOUNT | 数字 | 3 | 保留的事件日志文件数量。 |
N8N_EVENTBUS_LOGWRITER_MAXFILESIZEINKB | 数字 | 10240 | 单个事件日志文件的最大大小（单位：KB），超过后将创建新文件。 |
N8N_EVENTBUS_LOGWRITER_LOGBASENAME | 字符串 | n8nEventLog | 事件日志文件的基础名称（basename）。 |
聊天查看文档 此页面 !Thumbs up有帮助 !Thumbs down无帮助 感谢您的反馈！ 提交 上一页 Insights 下一页 License 由 Material for MkDocs Insiders 提供支持