Speedtest-Tracker 记录修剪功能解析与问题排查

背景介绍

Speedtest-Tracker 是一个用于定期执行网络速度测试并记录结果的工具，它提供了自动修剪旧记录的功能。用户可以通过设置环境变量 PRUNE_RESULTS_OLDER_THAN 来控制保留记录的天数。

功能原理

Speedtest-Tracker 的记录修剪功能基于以下机制工作：

1. 定时任务：系统每天午夜自动执行一次记录修剪操作
2. 修剪标准：根据 PRUNE_RESULTS_OLDER_THAN 环境变量设置的天数，删除所有早于该天数的记录
3. 手动触发：用户也可以通过Web界面手动执行"Truncate"操作来清空所有记录

常见问题分析

在实际使用中，用户可能会遇到记录未被正确修剪的情况，这通常由以下几个原因导致：

1. 环境变量未生效：修改环境变量后未重启容器，导致新设置未被应用
2. 时间计算错误：系统时间或时区设置不正确，影响修剪判断
3. 权限问题：容器没有足够的权限操作数据库
4. 数据库锁定：数据库被其他进程锁定，导致修剪操作失败

解决方案

当遇到记录未被正确修剪时，可以按照以下步骤排查：

1. 验证环境变量：确认 PRUNE_RESULTS_OLDER_THAN 已正确设置并重启容器
2. 检查定时任务：进入容器执行 php artisan model:prune --pretend 命令，查看预期修剪的记录
3. 查看日志：检查容器日志中是否有修剪操作的执行记录或错误信息
4. 手动测试：临时调整系统时间或手动触发修剪操作进行测试

最佳实践

为了确保记录修剪功能正常工作，建议：

1. 修改环境变量后总是重启容器
2. 定期检查记录数量是否符合预期
3. 考虑设置监控，确保定时任务正常执行
4. 对于重要数据，修剪前先进行备份

通过理解这些原理和排查方法，用户可以更好地管理Speedtest-Tracker的记录存储，保持系统高效运行。