Check matomo-version

Overview

This plugin lets you track if a matomo server update is available. To check for updates, this plugin uses the Git Repo at https://github.com/matomo-org/matomo/releases. To compare against the current/installed version of Matomo, the check has to run on the Matomo server itself and needs access to the Matomo installation directory.

Fact Sheet

Check Plugin Download

https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/matomo-version

Check Interval Recommendation

Once a day

Can be called without parameters

Yes

Available for

Python 2, Python 3, Windows

Requirements

None

Uses SQLite DBs

Yes

Help

usage: matomo-version [-h] [-V] [--always-ok] [--cache-expire CACHE_EXPIRE]
                      [--path PATH]

This plugin lets you track if server updates are available.

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  --cache-expire CACHE_EXPIRE
                        The amount of time after which the update check cache
                        expires, in hours. Default: 24
  --path PATH           Local path to your Matomo/Piwik installation,
                        typically within your Webserver's Document Root.
                        Default: /var/www/html/matomo

Usage Examples

./matomo-version --path /var/www/html/matomo
./matomo-version --path /var/www/html/matomo --cache-expire 8 --always-ok

Output:

Matomo v4.3.1 is up to date

States

  • If wanted, always returns OK,

  • else returns WARN if update is available.

Perfdata / Metrics

There is no perfdata.

Credits, License