InfluxDB data monitoring plugin

InfluxDB data monitoring plugin

Queries any number of fields/measurements and returns a defined number of raw or aggregated values in Nagios format.

Requirements:

  • PHP interpreter and composer

  • InfluxDB (0.13.0 recommended)

Run composer install to download InfluxDB PHP Client dependency.

Example InfluxDB config

[http]
enabled = true
bind-address = "localhost:8086"
auth-enabled = false

Plugin settings

$host, $port and $db variables must be configured according to InfluxDB. Plugin parameters

-k <key1,key2,...>
    [Required] Field keys to select (can contain aggregate functions, return last values)
-m <meas1,meas2,...>
    [Optional] Measurements to get fields from (search all if not specified)
-s <5m|1h|1d|...>
    [Optional] Defines period from now that is used to collect values (defaults to 15 minutes)
-l <limit>
    [Optional] Number of points to display (defaults to 1, results are sorted by time in descending order)
-t <title1,title2,...>
    [Optional] Replace field keys with these titles in an output string
-w <warn_level1,warn_level2,...>
-c <crit_level1,crit_level2,...>
    [Optional] Warning and critical levels for every field
-f <perfdata|info>
    [Optional] Display only info or perfdata part (both if not specified)
-x
    [Optional] Add c units to all values (counters)
-p
    [Optional] Add % to all values (percents)
-b
    [Optional] Add B to all values (data sizes)
-z
    [Optional, Debug] Output query string and returned array of values only