Want to know who did what, and when? Keep an eye on everything that is happening on your Matomo (Piwik) platform with this plugin.
The activity log, also known as audit log or audit trail, improves your Matomo's security and diagnostic by showing a chronological set of entries that provides documentary evidence of activities that happened in your Matomo.
It allows Matomo Super Users to quickly review the actions performed by members of your organization or clients, and also lets every user review details of their own actions.
So far this plugin supports over 80 different type of Matomo activities, for example:
For a full list of supported activities have a look in the FAQ.
To learn more about the plugin have a look at the Activity Log FAQ.
This plugin is built and maintained by the creators of Matomo.
This plugin is compatible with Matomo 3 (see requirements below for more details).
What does Activity Log do?
The Activity Log plugins keeps a record of all important activities performed by your Matomo (Piwik) users on your Matomo. You can view all activities that happened in the past in a chronological order to see who did what and when.
The Activity Log allows Super Users to quickly review the actions performed in Matomo by members of your organization or clients. It also lets every one of these user also review details of their own actions.
Why is it important to keep an eye on these activities?
There are many reasons why it is important, for example:
Who develops & maintains the Activity Log plugin?
The plugin is developed and maintained by InnoCraft, the company of the makers of Matomo. At InnoCraft, talented and passionate developers build and maintain the free and open source project Matomo. This ensures that the plugin is well integrated, kept up to date and automatically tested whenever a change is made. By purchasing this plugin you also help the developers to being able to maintain the free and open source project Matomo itself.
How do I access the activity log?
First you need to log in to your Matomo.
If you are a Super User, go to "Administration" and click in the "Diagnostic" section on "Activity Log".
As a user with view or admin access you can see your activity log entries by clicking on "Personal" in the top right corner followed by clicking on "Activity Log" in the left menu.
Who has access to the activity log?
Super Users are able to see all activities and can also filter activities by user.
All other users can view their own activities.
Can the activity log data be exported?
You can use the Matomo HTTP API to query activities.
The plugin currently adds the following API methods to your Matomo:
ActivityLog.getEntriesReturns logged activity entries.
ActivityLog.getEntryCountReturns the number of available activity entries.
An export feature will be also available in the UI soon.
How long will the activity data be stored?
Activities are stored forever, there are no limits. If you are interested in a feature to setup an automatic purge of activities after a certain time, let us know.
How do I enable Gravatar images in the activity log?
Gravar means Globally Recognized Avatar. When enabled, it will try to find a matching avatar image for your users so you can easily see which user has performed which activity. An avatar image may be shown next to an activity in the activity log. This feature is not enabled by default as our plugins do not send any of your data or metadata to external web services for privacy compliance.
To enable Gravatar images, log in to Matomo as a Super User and go to "Administration => Plugin Settings", where you can enable the Gravatar setting.
As a developer, how do I log activities done within my custom plugin?
To log custom activities happening in your custom plugin, you can define Activity classes (extending
You need to place these classes in a directory named
Activity within any plugin. The Audit log will then include all
such activities recorded by your plugin.
How can I export the Activity Log UI to embed it somewhere else?
First you need to log in to your Matomo. Then click on "Personal" in the top right corner and click on "Widgets" in the left menu. There you can find the widget "Activity Log" in the "Diagnostic" section. Below the widget the URL to export it is shown. To learn more about this, read the Embed Matomo Widget user guide.
Which events / activities are being tracked?
The audit log reports all these activities:
Other plugins' activity log events:
Do I get access to the raw data that was tracked?
Yes, if you host Matomo yourself you get access to all data that is stored in your MySQL database.
The data is stored in a table called
piwik_activity_log. The data is also made easily available via the
Activity Log HTTP Reporting API.