n8n 中文文档

Insights环境变量

提示

File-based configuration 基于文件的配置

您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。

见解使实例所有者和管理员能够了解工作流程随时间的执行情况。详情请参阅见解。

警告

Storage and compaction thresholds 存储和压缩阈值

N8N_INSIGHTS_COMPACTION_HOURLY_TO_DAILY_THRESHOLD_DAYS 和 N8N_INSIGHTS_COMPACTION_DAILY_TO_WEEKLY_THRESHOLD_DAYS 设置 n8n 在每个压缩步骤(从小时桶到日桶,然后从日桶到周桶)之前保留高分辨率见解(存储在一小时桶中的指标)的天数。您可以在实例上配置这些天数。

提高值会延迟压缩。这会向 insights_by_period 添加更多行并增加数据库使用率。有关这与保留的关系,请参阅见解。

如果你在压缩期间遇到数据库负载问题,请调整压缩运行频率,以及 n8n 每次运行时处理的工作量:

  • 减小 N8N_INSIGHTS_COMPACTION_INTERVAL_MINUTES,让压缩更频繁地运行。这可以减少两次运行之间累积的数据量。
  • 增大 N8N_INSIGHTS_COMPACTION_BATCH_DELAY_MILLISECONDS,延长批次之间的等待时间。
  • 减小 N8N_INSIGHTS_COMPACTION_MAX_BATCHES_PER_RUN,让每次运行处理更少批次。
  • 减小 N8N_INSIGHTS_COMPACTION_MAX_RUNTIME_SECONDS,让每次运行更早停止。

这些设置只控制压缩工作量和调度,不会更改保留期,也不会更改各压缩步骤的时间阈值。

变量 类型 默认值 说明
N8N_DISABLED_MODULES String - 设为 insights 可禁用实例上的该功能及指标收集。
N8N_INSIGHTS_COMPACTION_BATCH_SIZE Number 500 单个批次中要压缩的原始洞察数据数量。
N8N_INSIGHTS_COMPACTION_BATCH_DELAY_MILLISECONDS Number 100 完整压缩批次之间的延迟(毫秒)。增大该值可延长批次之间的等待时间。设为 0 可跳过延迟。
N8N_INSIGHTS_COMPACTION_DAILY_TO_WEEKLY_THRESHOLD_DAYS Number 180 日级洞察数据在保留多少天后会被压缩为周级数据。
N8N_INSIGHTS_COMPACTION_HOURLY_TO_DAILY_THRESHOLD_DAYS Number 90 小时级洞察数据在保留多少天后会被压缩为日级数据。
N8N_INSIGHTS_COMPACTION_INTERVAL_MINUTES Number 60 压缩任务的运行间隔(分钟)。减小该值可更频繁地运行压缩,并减少两次运行之间累积的数据量。
N8N_INSIGHTS_COMPACTION_MAX_BATCHES_PER_RUN Number 1000 单次运行最多处理的压缩批次数。减小该值可让每次运行处理更少批次。设为 0 可禁用此限制。
N8N_INSIGHTS_COMPACTION_MAX_RUNTIME_SECONDS Number 300 单次压缩运行的最长运行时间(秒)。减小该值可让每次运行更早停止。设为 0 可禁用此限制。
N8N_INSIGHTS_FLUSH_BATCH_SIZE Number 1000 刷新到数据库之前,缓冲区中最多保留的洞察数据条数。
N8N_INSIGHTS_FLUSH_INTERVAL_SECONDS Number 30 n8n 将洞察数据刷新到数据库的时间间隔(秒)。
N8N_INSIGHTS_MAX_AGE_DAYS Number 365 压缩后的洞察数据在被清理前保留的天数。最大值为 730(两年)。
N8N_INSIGHTS_PRUNE_CHECK_INTERVAL_HOURS Number 24 实例检查并删除超过有效最大保留期的洞察数据的频率(小时)。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。