洞察环境变量

基于文件的配置

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

洞察功能为实例所有者和管理员提供了工作流随时间表现的可见性。有关详细信息，请参考洞察。

存储与压缩阈值

N8N_INSIGHTS_COMPACTION_HOURLY_TO_DAILY_THRESHOLD_DAYS 和 N8N_INSIGHTS_COMPACTION_DAILY_TO_WEEKLY_THRESHOLD_DAYS 用于设置 n8n 在每一步压缩之前保留高分辨率洞察数据（以 1 小时为粒度存储的指标）的天数，也就是先从小时桶压缩到天桶，再从天桶压缩到周桶。这两个天数都需要你在实例中自行配置。

提高这些值会延后压缩时间。这会给 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	实例检查并删除超过有效最大保留期的洞察数据的频率（小时）。