Requirements for Log Analytics

This page explains the requirements to import your server logs in Matomo.

• Log Analytics works with Matomo Cloud, Matomo On-Premise, and Matomo for WordPress
• To execute the import script, you need access to a server via SSH or some way of executing scripts on your server
• Python 3.5 or newer required. The script that loads and parses the log files is written in Python.
• You will also need one or more log files to parse and analyse with Matomo (inside each log file the log lines must be ordered by date)
• Note: It is recommend to use a log format that includes the User-Agent, referrer URL, and full request URL including the hostname. These fields provide Matomo with more information about each request and help produce more complete and accurate analytics. The importer can process logs without these fields, but some reporting data may be unavailable or less accurate. The importer supports a wide range of log formats. See the supported log formats.
• Using Matomo On-Premise? Setup Geo Location for accurate country and city detection. Browser language is not available in server access logs, so Matomo cannot use it as a fallback for country detection. This step is taken care of for you automatically if you are on the Matomo Cloud or if you are using Matomo for WordPress.