日志环境变量#
基于文件的配置
您可以在单个变量后添加 _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 |
记录当前活动 cron 作业的间隔（分钟）。设置为 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 以将来自 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 |
单个事件日志文件在切换到新文件前允许达到的最大大小（KB）。 |
N8N_EVENTBUS_LOGWRITER_LOGBASENAME |
String | n8nEventLog |
事件日志文件的基础名称。当设置 N8N_EVENTBUS_LOGWRITER_LOGFULLPATH 时会忽略该值。 |
N8N_EVENTBUS_LOGWRITER_LOGFULLPATH |
String | '' |
事件日志文件的绝对路径，必须以 .log 结尾。设置后，n8n 会按该路径原样使用，不再追加进程类型后缀，同时会覆盖 N8N_EVENTBUS_LOGWRITER_LOGBASENAME 和默认的按进程后缀。多个 n8n 进程共享可写文件系统时，可用此变量为每个进程分配唯一的事件日志路径。详情请参阅按进程划分的事件日志文件。 |
N8N_EVENTBUS_LOGWRITER_MAXTOTALMESSAGESPERFILE |
Number | 500000 |
恢复过程中从单个事件日志文件中最多解析的行数。用于限制当日志文件包含大量无效行时的内存占用。 |
使用环境变量管理日志流目标#
将 N8N_LOG_STREAMING_MANAGED_BY_ENV 设为 true 后，即可通过环境变量管理日志流目标。关于激活模式的工作方式，请参阅使用环境变量管理实例设置；关于每种目标的 JSON 结构，请参阅使用环境变量配置日志流目标。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_LOG_STREAMING_MANAGED_BY_ENV |
Boolean | false |
设为 true 后，可通过环境变量管理日志流。启用后，n8n 会在每次启动时应用日志流相关变量，并锁定对应的 UI 控件。 |
N8N_LOG_STREAMING_DESTINATIONS |
JSON string | - | 日志流目标的 JSON 数组。每个目标都是一个对象，type 可为 webhook、syslog 或 sentry，并附带该类型对应的配置。 |