记录环境变量
提示
File-based configuration 基于文件的配置
您可以将 _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 可将代码节点日志从 console.log 或 print 发送到进程的标准输出,仅适用于生产执行。 |
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 |
事件日志文件的基本名称。设置 N8N_EVENTBUS_LOGWRITER_LOGFULLPATH 时忽略。 |
N8N_EVENTBUS_LOGWRITER_LOGFULLPATH |
字符串 | '' |
事件日志文件的绝对路径。必须以 .log 结尾。设置后,将逐字使用此路径并覆盖 N8N_EVENTBUS_LOGWRITER_LOGBASENAME 和默认的每进程后缀。当多个进程共享可写文件系统时,使用它可以为每个 n8n 进程提供唯一的事件日志路径。有关详细信息,请参阅每进程事件日志文件。 |
N8N_EVENTBUS_LOGWRITER_MAXTOTALMESSAGESPERFILE |
数量 | 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,并附带该类型对应的配置。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。