Get cluster and node details from the Proxmox API and report them to Zabbix using zabbix_sender.
- Low Level Discovery of cluster nodes
- Collects cluster quorum and nodes status, overall cluster and nodes RAM/CPU usage and KSM sharing, vRAM allocation and usage, vCPU and vHDD allocations, number of VMs and LXC containers running or stopped.
The script can run on any host with Python, a functional zabbix_sender and access to the Proxmox API. A Zabbix server or Zabbix proxy would be logical candidates.
- Install Python proxmoxer:
pip install proxmoxer - Install Python requests:
pip install requests - Copy script scripts/proxmox_cluster.py and make it executable. The script is executed from cron or systemd timers and can be placed anywhere logical.
- Import the valuemap templates/snmp_boolean_type_valuemap.xml into your Zabbix server. This valuemap is used to display quorum and nodes online status.
- Import the template templates/proxmox_cluster_template.xml into your Zabbix server.
- Create a Proxmox host in Zabbix. This is not an actual server but represents the whole cluster.
- Attach the template Template Proxmox cluster to the host.
- Create a zabbix user in Proxmox:
pveum useradd zabbix@pve -comment "Zabbix monitoring user" - Set a password for the zabbix user in Proxmox:
pveum passwd zabbix@pve - Grant read only permissions to the zabbix user. The built in PVEAuditor role seems a good choice:
pveum aclmod / -user zabbix@pve -role PVEAuditor - Set up scheduled tasks executing the script. The following two examples use cron:
crontab -e -u zabbix- Send discovery data:
0 */4 * * * /usr/lib/zabbix/bin/proxmox_cluster.py -a pmx01.your.tld -u zabbix@pve -p password -t proxmox.tokyo.prod -d - Send item data:
*/10 * * * * /usr/lib/zabbix/bin/proxmox_cluster.py -a pmx01.your.tld -u zabbix@pve -p password -t proxmox.tokyo.prod
- Send discovery data:
The script accepts the following parameters:
- -a : Proxmox API hostname or IP address (can include port if the API listens on a non default port, e.g. pmx01.your.tld:8443)
- -c : Zabbix agent configuration file that is passed as a parameter to zabbix sender (defaults to: /etc/zabbix/zabbix_agentd.conf)
- -d : Send discovery data instead of item data
- -e : Get extended VM configuration details in order to collect vHDD allocations (see notes)
- -p : Proxmox API password
- -t : Zabbix target host name (the host in Zabbix with the Template Proxmox cluster template attached)
- -u : Proxmox API username (defaults to: zabbix@pve)
- -v : Verbose, prints data and zabbix_sender results to stdout.
- -z : Full path to zabbix_sender (defaults to /usr/bin/zabbix_sender)
Getting all vHDD information requires parsing the full VM configuration. That results in one additional API call for each VM to retrieve the configuration. Subsequent processing relies heavily on regular expressions. As this is an expensive process it is optional and can be enabled by specifying -e on the command line.
Resources allocated to templates are not included in the total vCPU, vHDD and vRAM numbers reported to zabbix.
If there is no load balancer fronting the API it would make sense to use multiple scheduled tasks using different Proxmox servers. This would distribute the load and ensure Zabbix remains updated during maintenance or downtime of a host. An example using cron would look as follows:
# Item updates every 10 minutes
0,20,40 * * * * /usr/lib/zabbix/bin/proxmox_cluster.py -a pmx01.your.tld -u zabbix@pve -p password -t proxmox.tokyo.prod
10,30,50 * * * * /usr/lib/zabbix/bin/proxmox_cluster.py -a pmx02.your.tld -u zabbix@pve -p password -t proxmox.tokyo.prod
# LLD updates every 4 hours
23 0,8,16 * * * /usr/lib/zabbix/bin/proxmox_cluster.py -a pmx01.your.tld -u zabbix@pve -p password -t proxmox.tokyo.prod -d
38 4,12,20 * * * /usr/lib/zabbix/bin/proxmox_cluster.py -a pmx02.your.tld -u zabbix@pve -p password -t proxmox.tokyo.prod -d
Minimum requirements Proxmox 5, Python 3.4 and Zabbix 3.0.
This software is licensed under GNU General Public License v3.0