You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

40 lines
1.7 KiB
HTML

<h1>InfluxDB data monitoring plugin</h1>
<br>Queries any number of fields/measurements and returns a defined number of raw or aggregated values in Nagios format.<br>
Requirements:<br>
- PHP interpreter and composer<br>
- InfluxDB (0.13.0 recommended)
<br><br>
Run <i>composer install</i> to download <a href="https://github.com/influxdata/influxdb-php" target="_blank">InfluxDB PHP Client</a> dependency.
<br>
<h3>Example InfluxDB config</h3>
<pre class="light-well">[http]
enabled = true
bind-address = "localhost:8086"
auth-enabled = false</pre>
<h3>Plugin settings</h3>
$host, $port and $db variables must be configured according to InfluxDB.
<h3>Plugin parameters</h3>
<pre class="light-well">-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</pre>