NAME

hv_monitor - LibreNMS style JSON SNMP extend for hypervisor monitoring.

SYNOPSIS

hv_monitor [-c] [-b <backend>]

DESCRIPTION

For cron...

*/5 * * * * /usr/local/bin/hv_monitor -q

For snmpd...

extend hv-monitor /bin/cat /var/cache/hv_monitor.json.snmp

FLAGS

-b <backend>

The backend to use.

Defaults are as below.

FreeBSD: CBSD
Linux: Libvirt

-c

Compress the output using gzip and base64 encoded so it can be transmitted via SNMP with out issue.

This only reflects what is printed to STDOUT.

/var/cache/hv_monitor.json.snmp will always be created as base64 encoded gzipped JSON.

-w

Write the data out to files as well.

Raw JSON: /var/cache/hv_monitor.json For SNMP: /var/cache/hv_monitor.json.snmp

-o

Base file path to use to with -w.

".snmp" will be appended to this for the file containing the SNMP return data.

Default: /var/cache/hv_monitor.json

-q

If combined with -w, this won't print the results.

Error messages will still be printed.

If not used with -w, this will error out.