n8n 中文文档

记录环境变量

提示

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 工作流库 找现成的中文工作流。