{"id":16317928,"url":"https://github.com/handcode/check_mk_zvolsize","last_synced_at":"2025-05-13T17:15:28.287Z","repository":{"id":156187520,"uuid":"80161498","full_name":"handcode/check_mk_zvolsize","owner":"handcode","description":"check_mk plugin to check/collect zvol (zfs volumes) sizes","archived":false,"fork":false,"pushed_at":"2021-04-30T17:32:52.000Z","size":27,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-16T20:27:04.014Z","etag":null,"topics":["checkmk","monitoring","omd-server","zfs-volumes"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/handcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-26T22:22:41.000Z","updated_at":"2021-04-30T17:32:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"d6b4593d-50b7-4ebc-809b-8d0d0902a73f","html_url":"https://github.com/handcode/check_mk_zvolsize","commit_stats":{"total_commits":28,"total_committers":2,"mean_commits":14.0,"dds":0.0714285714285714,"last_synced_commit":"0a5d6a046e23bc746a1b31b033457f637153bd51"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcode%2Fcheck_mk_zvolsize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcode%2Fcheck_mk_zvolsize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcode%2Fcheck_mk_zvolsize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/handcode%2Fcheck_mk_zvolsize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/handcode","download_url":"https://codeload.github.com/handcode/check_mk_zvolsize/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253990502,"owners_count":21995776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["checkmk","monitoring","omd-server","zfs-volumes"],"created_at":"2024-10-10T22:09:33.791Z","updated_at":"2025-05-13T17:15:23.266Z","avatar_url":"https://github.com/handcode.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# check_mk zvolsize plugin\n\nplugin to check/collect zvol (zfs volume) sizes with volsize, used size, snapshot sizes and comp.ratio\nusecase: monitor used diskspace (including snapshots) for sparse zvols when overcommitting diskspace for VMs. \n\n### Links:\n- [Public github repo](https://github.com/handcode/check_mk_zvolsize)\n- [\"Writing checks for Check_MK\"](https://mathias-kettner.de/checkmk_writing_checks.html)\n\n## Example output (without Headline) from agent plugin:\n\n```\nzfs list -p -t volume -r -o name,volsize,used,available,usedbydataset,usedbysnapshots,compressratio\nNAME             VOLSIZE         USED        AVAIL       USEDDS    USEDSNAP  RATIO\nzserv/vm1    16106127360  13741113344  66381434880  11687993344  2053120000  1.27x\nzserv/vm3    16106127360  14498553856  66381434880  12562055168  1936498688  1.18x\nzserv/vm5    26843545600   6466097152  66381434880   5196242944  1269854208  1.26x\n...\n```\n\n## Install\n\n### OMD Server Install\n\n#### check_mk package:\n```\ncmk -vP install releases/zvolsize-\u003cVERSION\u003e.mkp\n```\n\n#### manually:\n```\ncp checks/zvolsize /omd/sites/$(OMD_SITE)/local/share/check_mk/checks/\ncp plugins/zvolsize /omd/sites/$(OMD_SITE)/local/share/check_mk/agents/plugins/\ncp templates/check_mk-zvolsize.php /omd/sites/$(OMD_SITE)/local/share/check_mk/pnp-templates/\ncp packages/zvolsize /omd/sites/$(OMD_SITE)/var/check_mk/packages/\n```  \n\n#### use make target:\n```\nusage: make [target ...]\n\npkg:\n  pkg......................alias for package\n  package..................build check_mk package from installed repo files\n  release..................build check_mk package and copy *.mkp file to repo\n\ndev:\n  install..................install check_mk plugin, optional OMD_SITE3=hrzg can be overwritten\n  purge....................purge check_mk plugin files, optional OMD_SITE3=hrzg can be overwritten\n\nsystem:\n  help.....................show this help\n```\n\n### Client Install\n```\ncp plugins/zvolsize /usr/lib/check_mk_agent/plugins/zvolsize\n```\nOr download plugin from OMD Server, or rollout plugin with puppet ;-)\n\n\n\n\n### check_mk package cheatsheet\n#### pack check_mk package (see make target above)\n\n```\n#create package meta file (only required if repo dosn't include it yet or the first time)\ncmk -vP \n# bundle package file\ncmk -vP pack zvolsize\n```\n\n#### Other Options for package handling see:\n```\ncmk -vP\nUsage: check_mk [-v] -P|--package COMMAND [ARGS]\n\nAvailable commands are:\n   create NAME      ...  Collect unpackaged files into new package NAME\n   pack NAME        ...  Create package file from installed package\n   release NAME     ...  Drop installed package NAME, release packaged files\n   find             ...  Find and display unpackaged files\n   list             ...  List all installed packages\n   list NAME        ...  List files of installed package\n   list PACK.mkp    ...  List files of uninstalled package file\n   show NAME        ...  Show information about installed package\n   show PACK.mkp    ...  Show information about uninstalled package file\n   install PACK.mkp ...  Install or update package from file PACK.mkp\n   remove NAME      ...  Uninstall package NAME\n\n   -v  enables verbose output\n\nPackage files are located in /omd/sites/$(OMD_SITE)/var/check_mk/packages/.\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhandcode%2Fcheck_mk_zvolsize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhandcode%2Fcheck_mk_zvolsize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhandcode%2Fcheck_mk_zvolsize/lists"}