Matomo核心归档进程并发控制失效问题分析

问题背景

在Matomo网站分析平台中，核心归档功能(core:archive)负责处理原始访问数据并生成聚合报告。该功能通常通过定时任务(cron)执行，支持设置并发归档进程数(--concurrent-archivers参数)来控制系统负载。

问题现象

用户配置了4个定时任务，每个任务限制最大并发数为8，理论上系统应保持最多8个归档进程同时运行。但实际观察发现系统中有约30个归档进程并行执行，远超过配置限制。日志显示系统错误地报告"0 out of 8 archivers running currently"。

根本原因

深入分析发现问题出在进程检测机制上。Matomo通过执行ps命令获取运行中的进程列表，然后筛选出归档进程进行计数。但在某些Linux系统环境下，ps命令默认输出会被截断，导致进程命令信息不完整。

具体表现为：

1. 进程检测代码依赖完整的命令行参数匹配
2. 截断后的命令缺少关键匹配字段(如"core:archive")
3. 导致系统无法正确识别运行中的归档进程
4. 最终错误地认为没有归档进程在运行

技术细节

Matomo使用Process::getListOfRunningProcesses()方法获取进程列表，该方法内部执行ps x命令。在默认配置下，Linux的ps命令会限制输出宽度，导致长命令行被截断。

例如实际进程可能是：

/usr/bin/php /srv/www/matomo.example.com/matomo/console core:archive --url=https://example.com/

但ps输出被截断为：

/usr/bin/php /srv/www/matomo.example.com/matomo/con

解决方案

修改Process类中的PS_COMMAND常量，增加-ww参数强制ps命令使用无限宽度输出：

public const PS_COMMAND = 'ps x -ww';

-ww参数的作用：

1. 第一个w表示宽输出模式
2. 第二个w表示无限宽度
3. 确保完整命令行不被截断

影响范围

该问题主要影响：

1. 使用长路径部署Matomo的环境
2. 配置了多个参数的归档命令
3. 需要精确控制归档进程数的生产环境

最佳实践建议

1. 对于生产环境，建议应用此修复以确保归档进程数控制生效
2. 定期检查归档进程实际运行数量
3. 考虑使用进程管理工具进行更精确的控制
4. 监控系统负载，合理设置并发归档进程数

总结

Matomo的归档进程并发控制机制依赖准确的进程检测，而ps命令输出截断会导致这一机制失效。通过修改ps命令参数确保完整输出是简单有效的解决方案。这一修复有助于维持系统稳定性，防止因归档进程过多导致的资源争用问题。