https://github.com/handcode/check_mk_zvolsize
check_mk plugin to check/collect zvol (zfs volumes) sizes
https://github.com/handcode/check_mk_zvolsize
checkmk monitoring omd-server zfs-volumes
Last synced: 5 months ago
JSON representation
check_mk plugin to check/collect zvol (zfs volumes) sizes
- Host: GitHub
- URL: https://github.com/handcode/check_mk_zvolsize
- Owner: handcode
- Created: 2017-01-26T22:22:41.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-30T17:32:52.000Z (over 4 years ago)
- Last Synced: 2025-02-16T20:27:04.014Z (8 months ago)
- Topics: checkmk, monitoring, omd-server, zfs-volumes
- Language: Python
- Homepage:
- Size: 26.4 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# check_mk zvolsize plugin
plugin to check/collect zvol (zfs volume) sizes with volsize, used size, snapshot sizes and comp.ratio
usecase: monitor used diskspace (including snapshots) for sparse zvols when overcommitting diskspace for VMs.
### Links:
- [Public github repo](https://github.com/handcode/check_mk_zvolsize)
- ["Writing checks for Check_MK"](https://mathias-kettner.de/checkmk_writing_checks.html)
## Example output (without Headline) from agent plugin:
```
zfs list -p -t volume -r -o name,volsize,used,available,usedbydataset,usedbysnapshots,compressratio
NAME VOLSIZE USED AVAIL USEDDS USEDSNAP RATIO
zserv/vm1 16106127360 13741113344 66381434880 11687993344 2053120000 1.27x
zserv/vm3 16106127360 14498553856 66381434880 12562055168 1936498688 1.18x
zserv/vm5 26843545600 6466097152 66381434880 5196242944 1269854208 1.26x
...
```
## Install
### OMD Server Install
#### check_mk package:
```
cmk -vP install releases/zvolsize-.mkp
```
#### manually:
```
cp checks/zvolsize /omd/sites/$(OMD_SITE)/local/share/check_mk/checks/
cp plugins/zvolsize /omd/sites/$(OMD_SITE)/local/share/check_mk/agents/plugins/
cp templates/check_mk-zvolsize.php /omd/sites/$(OMD_SITE)/local/share/check_mk/pnp-templates/
cp packages/zvolsize /omd/sites/$(OMD_SITE)/var/check_mk/packages/
```
#### use make target:
```
usage: make [target ...]
pkg:
pkg......................alias for package
package..................build check_mk package from installed repo files
release..................build check_mk package and copy *.mkp file to repo
dev:
install..................install check_mk plugin, optional OMD_SITE3=hrzg can be overwritten
purge....................purge check_mk plugin files, optional OMD_SITE3=hrzg can be overwritten
system:
help.....................show this help
```
### Client Install
```
cp plugins/zvolsize /usr/lib/check_mk_agent/plugins/zvolsize
```
Or download plugin from OMD Server, or rollout plugin with puppet ;-)
### check_mk package cheatsheet
#### pack check_mk package (see make target above)
```
#create package meta file (only required if repo dosn't include it yet or the first time)
cmk -vP
# bundle package file
cmk -vP pack zvolsize
```
#### Other Options for package handling see:
```
cmk -vP
Usage: check_mk [-v] -P|--package COMMAND [ARGS]
Available commands are:
create NAME ... Collect unpackaged files into new package NAME
pack NAME ... Create package file from installed package
release NAME ... Drop installed package NAME, release packaged files
find ... Find and display unpackaged files
list ... List all installed packages
list NAME ... List files of installed package
list PACK.mkp ... List files of uninstalled package file
show NAME ... Show information about installed package
show PACK.mkp ... Show information about uninstalled package file
install PACK.mkp ... Install or update package from file PACK.mkp
remove NAME ... Uninstall package NAME
-v enables verbose output
Package files are located in /omd/sites/$(OMD_SITE)/var/check_mk/packages/.
```