如何升级一个大型Matomo实例而不丢失任何跟踪数据?(没有跟踪API停机时间)

如果您有一个大型Matomo (Piwik)实例，升级到最新的Matomo版本可能需要很长时间(如果最新的Matomo版本之一包含数据库模式更改)。

要升级您的大型Matomo实例，遵循手动三步操作。这包括把Matomo用户界面和跟踪器在维护模式，并运行核心:更新命令。当Matomo Tracker处于维护模式时，数据库中没有数据正在收集。因此，在维护Matomo时，您可能会丢失几个小时的数据。

这个FAQ解释了如何在Matomo中导入缺失的跟踪请求。

你有两个选择。

选项1

在维护期间，您的网站和移动应用程序上的访问者仍然发出跟踪请求。这些piwik.php吗?跟踪请求存储在您的Matomo服务器访问日志文件中。成功升级到最新的Matomo版本后，您可以创建一个包含所有这些内容的新日志文件piwik.php请求(用于Matomo处于维护模式且没有跟踪的时间窗口)。

然后你可以在Matomo中重放这个日志文件，它将回填你的所有数据:在这个FAQ中了解更多。

选项2

第二个选项要求使用QueuedTracking插件MySQL(或Redis)。这种方法的优点是它将能够100%地恢复所有跟踪请求，而选项1(使用服务器访问日志)将不能恢复POST请求。

以下步骤:

1. 安装和设置QueuedTracking插件
2. 将请求写入队列
3. 禁用“跟踪请求期间处理”设置。检查是否设置cronjob正在运行queuedtracking:过程．(我们希望确保队列中的请求没有被处理)。
4. 通过禁用“用户界面”开启部分维护模式(设置maintenance_mode = 1)，但重要的是不要禁用Matomo Tracking(保持默认值record_statistics = 1）.
5. 开始Matomo升级
6. 完成Matomo升级
7. 关闭维护模式
8. 将队列中的所有请求处理到DB中以回填所有数据(通过。/控制台queuedtracking:过程控制台命令)
9. 再次禁用QueuedTracking插件
10. Matomo恢复了正常的行为

如果你有任何反馈或建议，请在下方留言。