如何打开MATOMO日志开关

在需要对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参数的请求，为了安全起见，只能启用很短时间。