Check librenms-health


Get health details of all devices in LibreNMS (mostly for quick debugging purposes). Depending on the number of devices and their sensors, the execution can take 300 seconds or longer.

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).


This check could, but does not return any performance data, as LibreNMS offers direct integration into various time series databases like Graphite, InfluxDB, OpenTSDB, Prometheus and RRDTool. The configuration options can be found in LibreNMS under Settings > Global Settings > Poller > Datastore.

Fact Sheet

Check Plugin Download

Check Interval Recommendation

Once an hour

Can be called without parameters


Compiled for

Linux, Windows


LibreNMS API Token


usage: librenms-health  [-h] [-V] [--device-group DEVICE_GROUP]
                        [--device-hostname DEVICE_HOSTNAME]
                        [--device-type {appliance,collaboration,environment,firewall,loadbalancer,network,power,printer,server,storage,wireless,workstation}]
                        [--insecure] [--lengthy] [--no-proxy]
                        [--timeout TIMEOUT] --token TOKEN [--url URL]

This check fetches sensor information from a LibreNMS instance, using its API.

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --device-group DEVICE_GROUP
                        Filter by LibreNMS Device Group.
  --device-hostname DEVICE_HOSTNAME
                        Filter by LibreNMS Hostname (repeating).
  --device-type {appliance,collaboration,environment,firewall,loadbalancer,network,power,printer,server,storage,wireless,workstation}
                        Filter by LibreNMS Device Type (repeating).
  --insecure            This option explicitly allows to perform "insecure"
                        SSL connections. Default: False
  --lengthy             Extended reporting.
  --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-health --url http://librenms --token 03xyza61e74a9876f3dc7ab11234229d


Everything is ok.

Hostname     SysName         Sensor                      Val (prev)  Limit low/high
--------     -------         ------                      ----------  -------------- S3900-48T4S     Oper State                  3 (None)    None/None S3900-48T4S     Temperature Unit 1 sensor 1 37 (38)     27/57  brw38b1db3b30f4 Life time sheets            3492 (None) None/None  brw38b1db3b30f4 Sheets since powered on     0 (286)     None/None  brw38b1db3b30f4 Printer Device Status       3 (5)       None/None


  • Always returns OK.

Perfdata / Metrics






Number of devices found

Credits, License