Check librenms-version

Overview

Displays LibreNMS instance information. This is not a „is there a new version out there“ check as LibreNMS is capable of updating itself (if running the Git version).

You need to create an API token for a user with „Global Read“ level (login with an admin account, then go to LibreNMS > Gear Icon > API > API Settings, choose this user and create the API token).

Hints:

  • Don’t forget to check the EOL date for Apache, MariaDB and all other components using our other *-version check plugins.

Fact Sheet

Check Plugin Download

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

Check Interval Recommendation

Once a day

Can be called without parameters

No

Compiled for

Linux, Windows

Requirements

LibreNMS API Token

Uses SQLite DBs

$TEMP/linuxfabrik-lib-librenms-*.db

Help

usage: librenms-version [-h] [-V] [--insecure] [--no-proxy]
                        [--timeout TIMEOUT] --token TOKEN [--url URL]

This check displays LibreNMS instance information, using its API. This is not
a "is there a new version out there" g itself (if running the Git version).

options:
  -h, --help         show this help message and exit
  -V, --version      show program's version number and exit
  --insecure         This option explicitly allows to perform "insecure" SSL
                     connections. Default: False
  --no-proxy         Do not use a proxy. Default: False
  --timeout TIMEOUT  Network timeout in seconds. Default: 3 (seconds)
  --token TOKEN      LibreNMS API token
  --url URL          LibreNMS API URL. Default: http://localhost

Usage Examples

./librenms-version --url http://librenms --token 03xyza61e74a9876f3dc7ab11234229d

Output:

LibreNMS 21.6.0 (Git: HEAD), DB-Schema 2021_06_07_123600_create_sessions_table (211), MariaDB 10.6.3-MariaDB, NET-SNMP 5.8, PHP 8.0.8, Python 3.6.8, RRD-Tool 1.7.0

States

  • Always returns OK.

Perfdata / Metrics

Name

Type

Description

librenms-version

Float

Version number as a floating point number

mysql-version

Float

Version number as a floating point number

netsnmp-version

Float

Version number as a floating point number

php-version

Float

Version number as a floating point number

python-version

Float

Version number as a floating point number

rrdtool-version

Float

Version number as a floating point number

Credits, License