{"id":18690459,"url":"https://github.com/kvaps/opennebula-addon-zabbix","last_synced_at":"2025-06-12T07:04:17.382Z","repository":{"id":80916085,"uuid":"112893284","full_name":"kvaps/opennebula-addon-zabbix","owner":"kvaps","description":"  Zabbix template for monitoring OpenNebula cloud","archived":false,"fork":false,"pushed_at":"2018-01-26T00:30:11.000Z","size":299,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-28T02:30:20.865Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kvaps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-12-03T02:17:28.000Z","updated_at":"2020-03-02T09:45:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"88f40692-475e-4fe6-832e-7775e25f4e07","html_url":"https://github.com/kvaps/opennebula-addon-zabbix","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fopennebula-addon-zabbix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fopennebula-addon-zabbix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fopennebula-addon-zabbix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvaps%2Fopennebula-addon-zabbix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kvaps","download_url":"https://codeload.github.com/kvaps/opennebula-addon-zabbix/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239550283,"owners_count":19657541,"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":[],"created_at":"2024-11-07T10:47:39.461Z","updated_at":"2025-02-18T21:14:11.919Z","avatar_url":"https://github.com/kvaps.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenNebula Zabbix Template\n\nZabbix template for monitoring OpenNebula cloud.\n\n## Description\n\nTemplate includes preconfigured parameters, graphics and triggers for complex monitoring OpenNebula cloud.\n\n**Example graphics:**\n\n\u003cimg src=\"images/graphs.png\"\u003e\n\n**Example triggers:**\n\n\u003cimg src=\"images/triggers.png\"\u003e\n\n## Development\n\nTo contribute bug patches or new features, you can use the github Pull Request model. It is assumed that code and documentation are contributed under the Apache License 2.0. \n\nMore info:\n* [How to Contribute](http://opennebula.org/addons/contribute/)\n* Support: [OpenNebula user forum](https://forum.opennebula.org/c/support)\n* Development: [OpenNebula developers forum](https://forum.opennebula.org/c/development)\n* Issues Tracking: [Github issues](https://github.com/OpenNebula/addon-zabbix/issues)\n\n## Author\n\n* [kvaps](mailto:kvapss@gmail.com)\n\n## Compatibility\n\nThis add-on is compatible with OpenNebula 4.6+\n\n## Requirements\n\n### OpenNebula Front-end Server\n\n* Installed `xmlstarlet` package.\n* Installed and configured `zabbix-agent`.\n\n## Limitations\n\nCommon values of all resources is gathering by default.\nDiscovery resources is not supported for now, but you can specify it manually.\n\n## Installation\n\nFor install or update agent script on OpenNebula server execute:\n\n```\ncurl -o /etc/zabbix/zabbix_agentd.d/opennebula_zabbix.conf https://raw.githubusercontent.com/opennebula/addon-zabbix/master/opennebula_zabbix.conf\ncurl --create-dirs -o /usr/libexec/zabbix-extensions/scripts/one.sh https://raw.githubusercontent.com/opennebula/addon-zabbix/master/one.sh\nchmod +x /usr/libexec/zabbix-extensions/scripts/one.sh\nsystemctl restart zabbix-agent\n```\nAlso the authentification file is required, you can use oneadmin account here:\n```\nmkdir -p /var/lib/zabbix/.one/\ncp /var/lib/one/.one/one_auth /var/lib/zabbix/.one/one_auth\nchown -R zabbix:zabbix /var/lib/zabbix\n```\n\nYou can check agent configuration. Just run this command on Zabbix server:\n```\nzabbix_get -s \u003cyour_server\u003e -k one.collect[host]\n```\n* If you see `0` - everything is fine.\n* If you see `1` - something wrong. Please check: User `zabbix` should have opportunity for run `onehost`/`onevm` commands.\n\nDownload and improt zabbix template:\n\n * **[zbx_template_opennebula.xml](https://github.com/opennebula/addon-zabbix/raw/master/zbx_template_opennebula.xml)**\n\n## Configuration\n### Configuring Zabbix-Server\n\nBy default items configured for generalized information of resources.\nIf you want to set target to specific datastores you should update items in zabbix interface.\n\n**For example:**\n\nGo to the Templates --\u003e Template OpenNebula --\u003e Items\n\nIf you want to monitor specufuc datastore insted all, replace items like:\n    \t\n```\none.datastore.free_space --\u003e one.datastore.free_space[101]\none.datastore.pfree_space --\u003e one.datastore.pfree_space[101]\none.datastore.total_space --\u003e one.datastore.total_space[101]\none.datastore.used_space --\u003e one.datastore.used_space[101]\none.datastore.pused_space --\u003e one.datastore.pused_space[101]\n```\n\n  *where `101` - datastore id*\n\nIf you want to monitor specufuc network for free leases insted all, replace items like:\n    \t\n```\none.vnet.free_leases --\u003e one.vnet.free_leases[23]\none.vnet.pfree_leases --\u003e one.vnet.pfree_leases[23]\none.vnet.total_leases --\u003e one.vnet.total_leases[23]\none.vnet.used_leases --\u003e one.vnet.used_leases[23]\none.vnet.pused_leases --\u003e one.vnet.pused_leases[23]\n```\n\n  *where `23` - network id*\n\nIf you want monitor multiple individual resources you need to create more items and separated triggers.\nYou can also use `avg` parameter if you want have average data from all resources instead common.\n\n## Usage \n\nYou need to attach template to your OpenNebula host in Zabbix server.\nAfter that you will have custom metrics and graphics.\n\n## Tuning \u0026 Extending\n\nYou can create custom items and triggers, open `one.sh` file, for check which parameters is supported.\n\n### Todo list\n\nThese features is not yet implemented, but it would be nice to have it.\nYou can help, and contribute to the project, if you want.\n\n* [ ] Discovery Rules (Datastores, VNets, Hosts, VMs, Users and Groups)\n* [ ] Single VM resources usage monitoring.\n* [ ] User quotas usage monitoring.\n* [ ] Group quotas usage monitoring.\n* [ ] Separated clusters resources usage monitoring.\n\n## Optimizations\n\nAgent script already use caching when retrieves information from oned daemon.\nNo specufic configuration is needed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvaps%2Fopennebula-addon-zabbix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkvaps%2Fopennebula-addon-zabbix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvaps%2Fopennebula-addon-zabbix/lists"}