在需要对Matomo进行故障排查的时候,我们可能会用到以下日志:
- 追踪器日志:它可以帮助我们排查追踪过程的问题或者优化追踪过程。
- 打开Matomo后台日志:默认情况下Matomo日志是直接呈现在UI上的。如果你需要额外详细的日志,或者想讲日志存储到文件中,你可以通过配置config.ini.php来实现,如下:
以上日志相关配置项也可以在config/global.ini.php中找到。
[log]
; Possible values are “screen” (default value), “file” and “database” (logs to tables logger_*)
log_writers[] = file
; Possible values are ERROR, WARN, INFO, DEBUG
log_level = WARN
; if configured to log to file, log entries will be written to this file
logger_file_path = tmp/logs/matomo.log
重要提示:
- Monolog插件必须被激活
- 一旦启用了日志,你可以很容易地通过LogViewer插件查看和搜索日志。
- 你还可以启用SQL logging & profiling,以查看Matomo执行的SQL语句,按照上面的方法启用日志到screen,然后修改config.ini.php并增加下面几行
- 欢迎加入Matomo中文网官方QQ群255820112(点击滚动至本页末可扫描二维码),随时提问,有问必答。
[Debug]
enable_sql_profiler = 1
Matomo(Piwik)可以输出所有的SQL查询语句,同时会将查询语句汇总去重复。同时给出查询的总时间以及每个查询的平均时间。
排查追踪器故障
为了能够验证数据是否被正确追踪,你可以打开追踪器(piwik.php)的故障排查开关.
打开开关后,追踪请求不再显示1pxX1px的透明GIF图,而是显示追踪日志消息。基于安全的原因,不建议在生产环境这样做,或只允许在生产环境打开很短的时间。
请按照下面的步骤启用追踪器开关和查看排障日志:
- 在path/to/piwik/config/config.ini.php中,添加或修改以下两行
[Tracker]
debug = 1
- 查看发往Matomo服务器的HTTP请求:
- 如果请求发生在浏览器中,你可以使用Firebug查看所有发往piwik.php的请求。
- 如果请求是直接从你的手机应用或软件发出的,你可以输出或将追踪请求写入日志中。
- 你也可以将日志消息写入到文件或者数据库
如果你收到了很多追踪请求,造成日志无法查看的话,你可以启用只对特定请求启用排障模式。请在config.ini.php中添加或修改以下两行:
[Tracker]
debug_on_demand = 1
然后日志系统只会记录带有&debug=1参数的请求,为了安全起见,只能启用很短时间。