ZBX_Disk_Stat

Send statistic from /proc/diskstats to Zabbix

This is small project for my Home server

Features

• AutoDiscovery BlockDev and Filter by LLD Override
• Collect Read\Write Operations per second
• Collect Read\Write Sectors per second
• Calculate Time for 1 Read\Write Operations
  • Trigger when IO_Time >30ms at 10 times per 20min
• Collect IO Queue
• Convert DM(Device Mapper) device to pretty Name
  • Get stat for dm-1 but print for user vg00-lv_root
  • After reboot dm-1 may change to dm-2, but stat will be correct

Requires

• Not work with Zabbix_agent2

Install

1. Add script to server

# Create dir for zabbix sript
mkdir -p /usr/libexec/zabbix/

# Copy script to your server
curl 'https://raw.githubusercontent.com/dusharu/ZBX_Disk_Stat/master/scripts/disk_stat.sh' -o /usr/libexec/zabbix/disk_stat.sh
chmod 755 /usr/libexec/zabbix/disk_stat.sh

2. Import Template_ZBX/latest/ZBX_Disk_Stat.xml
3. Check LLD Override. Default value:
   • ^$ - result FALSE - device was remove
   • .snapshot. - result FALSE - filter LVM snapshot
   • -real$ - result FALSE - filter LVM snapshot
   • -cow$ - result FALSE - filter LVM snapshot
   • ^xvd[a-z]*[0-9]+$ - result FALSE - filter partitions
   • ^[hs]d[a-z]*[0-9]+$ - result FALSE - filter partitions
   • ^loop[0-9]*$ - result FALSE - filter loop device
   • ^sr[0-9]*$ - result FALSE - filter CD-ROM
4. Add host to group "Disk_Stat: io_block_dev"
5. Wait before Zabbix Discovery and Get Some Data

Screenshoot

Graph create by Grafana and Zabbix plugin

Graph create by Zabbix

Files

• Template_ZBX - Zabbix Template
• scripts - Scripts for Zabbix Agent
• README.md - information for Users
• Screenshoots - Screensoot for README.md
• LICENSE - license file

Debug Command

Print HELP

zabbix_get -s <HOST> -k 'system.run[ "/usr/libexec/zabbix/disk_stat.sh" ]'

Discovery

zabbix_get -s <HOST> -k 'system.run[ "/usr/libexec/zabbix/disk_stat.sh blkdev_discovery" ]'

Get statistic

zabbix_get -s <HOST> -k 'system.run[ "/usr/libexec/zabbix/disk_stat.sh blkdev_all_stat <DISK>" ]'

Docs

1. kernel.org: Describe /proc/diskstats
2. kernel.org: I/O statistics fields
3. Wikipedia.org: maximum IOPS on different Disk
4. RAID calcuator
5. Linux Filesystem Hierarchy Standard: /usr/libexec

ToDo

1. Add link with information about maximum IO_time
2. Add plugin for zabbix_agent2