zabbix-mini-IPMI

CPU and disk temperature monitoring scripts for zabbix. Also support voltage and fan speed monitoring on certain configurations. Uses lm-sensors, smartmontools and OpenHardwareMonitorReport. For Linux, BSD and Windows.

Features

Multi-CPU, disk and GPU solution
Low-Level Discovery
Bulk item upload with zabbix-sender
No unnecessary processes are spawned
Does not spin idle drives
RAID passthrough (manual)

More screenshots.

STANDBY drives

Update intervals on discovery scripts are set in a way to never induce drive spun up or prevent the disk from entering standby mode. With latest OHMR, however, drives will always be checked and spinned. Thus, update interval for cpu discovery must be less than disk idle mode on OS (20 minutes on Windows by default). This way the drive will not be spinned for every check. If you have more than one disk - please keep close attention to update interval setting and choose apropriate OHMR version.

Choosing OHMR version

0.3.2.0

That's the only available version without drive monitoring, but its hardware information is outdated. Any other version than this will work very slowly on Windows XP.

0.5.1.7

Introduces drive monitoring, thus making idle drives spun on CPU every check. Wider hardware info.

0.8.0.2

2017 version with drive monitoring.

Installation

As prerequisites you need python3, lm-sensors, smartmontools, sudo and zabbix-sender packages. For testing zabbix-get is also required.
Take a look at scripts first lines and provide paths if needed. If you have a RAID configuration, also provide that by hand. Import Template_mini-IPMI_v2.xml in zabbix web interface.

First step

Linux

mv mini_ipmi_smartctl.py Linux/mini_ipmi_lmsensors.py sender_wrapper.py /etc/zabbix/scripts/
mv sudoers.d/zabbix /etc/sudoers.d/   # place sudoers include here for mini_ipmi_smartctl.py sudo access
mv userparameter_mini-ipmi2.conf /etc/zabbix/zabbix_agentd.d/

FreeBSD

mv mini_ipmi_smartctl.py mini_ipmi_bsdcpu.py sender_wrapper.py /etc/zabbix/scripts/
mv sudoers.d/zabbix /usr/local/etc/sudoers.d/
mv userparameter_mini-ipmi2.conf /usr/local/etc/zabbix/zabbix_agentd.d/

Then, for Intel processor you need to add coretemp_load="YES" to /boot/loader.conf. For AMD it will be amdtemp_load="YES". Reboot or manual kldload is required to take effect.

Windows

move mini_ipmi_smartctl.py C:\zabbix-agent\scripts\
move mini_ipmi_ohmr.py C:\zabbix-agent\scripts\
move sender_wrapper.py C:\zabbix-agent\scripts\
move userparameter_mini-ipmi2.conf C:\zabbix-agent\zabbix_agentd.conf.d\

Install python3 for all users, adding it to PATH during installation. Install smartmontools and add its bin folder to PATH in environment variables. .NET Framework is also required for OpenHardwareMonitorReport.

Second step

Then you need to include your zabbix conf folder in zabbix_agentd.conf, like this:

Include=/usr/local/etc/zabbix/zabbix_agentd.conf.d/

Also its recomended to add at least Timeout=10 to config file to allow drives spun up and OHMR execution.

Thats all for Windows. For others run the following to finish configuration:

chmod 755 scripts/mini_ipmi*.py scripts/sender_wrapper.py   # apply necessary permissions
chown root:zabbix scripts/mini_ipmi*.py scripts/sender_wrapper.py 
chmod 644 userparameter_mini-ipmi2.conf
chown root:zabbix userparameter_mini-ipmi2.conf
chmod 400 sudoers.d/zabbix
chown root sudoers.d/zabbix
visudo   # test sudoers configuration, type :q! to exit

Testing

zabbix_get -s 192.0.2.1 -k mini.cputemp.discovery[get,"Example host"]
zabbix_get -s 192.0.2.1 -k mini.disktemp.discovery[get,"Example host"]

Default operation mode. Displays json that server should get, detaches, then waits and sends data with zabbix-sender. Example host is your Host name field in zabbix.

zabbix_get -s 192.0.2.1 -k mini.cputemp.discovery[getverb,"Example host"]
zabbix_get -s 192.0.2.1 -k mini.disktemp.discovery[getverb,"Example host"]

Verbose mode. Does not detaches or prints LLD. Lists all items sent to zabbix-sender, also it is possible to see sender output in this mode.

These scripts were tested to work with following configurations:

Centos 7 / Zabbix 2.4 / Python 3.4
Debian 8 / Zabbix 2.4, 3.4 / Python 3.4
Ubuntu 17.10 / Zabbix 3.0 / Python 3.6
FreeBSD 10.3 / Zabbix 2.4 / Python 3.6
Windows XP / Zabbix 2.4 / Python 3.4
Windows 7 / Zabbix 2.4, 3.4 / Python 3.2, 3.4
Windows Server 2012 / Zabbix 2.4 / Python 3.4

Known issues

Zabbix web panel displays an error on json discovery, but everything works fine (#18)
Data on some systems may be absent right after boot due to ACHI warmup
Windows version does not detaches, and data will only be gathered on second pass (probably permanent workaround)

samirfor / zabbix-mini-IPMI