check_pve

                                

        
        

            
            

                

    

    
check_pve


Proxmox Virtual Environment Naemon/Icinga/Nagios plugin which checks various stuff via Proxmox API(v2).


Tested with: Naemon 1.0.6; Ruby 2.3.0, 2.3.3; PVE 5.0, 5.1


Requirements


Ruby


  • Ruby >2.3
    • 

PVE


A user/role with appropriate rights. See User Management for more information.


# /etc/pve/user.cfg
user:monitoring@pve:1:0::::::

role:PVE_monitoring:Datastore.Audit,Sys.Audit,Sys.Modify:
acl:1:/:monitoring@pve:PVE_monitoring:


Usage


./check_pve.rb
check_pve v0.1 [https://gitlab.com/6uellerBpanda/check_pve]

This plugin checks various parameters of Proxmox Virtual Environment API(v2)

Mode:
  Cluster:
    cluster         Checks quorum of cluster
  Node:
    smart           Checks SMART health of disks
    updates         Checks for available updates
    subscription    Checks for valid subscription
    services        Checks if services are running
    storage         Checks storage usage in percentage
    cpu             Checks CPU usage in percentage
    memory          Checks Memory usage in gigabytes
    io_wait         Checks IO wait in percentage

Usage: check_pve.rb [options]

Options:
    -s, --address ADDRESS            PVE host address
    -k, --insecure                   No ssl verification
    -m, --mode MODE                  Mode to check
    -n, --node NODE                  PVE Node name
    -u, --username USERNAME          Username with auth realm e.g. monitoring@pve
    -p, --password PASSWORD          Password
    -w, --warning WARNING            Warning threshold
    -c, --critical CRITICAL          Critical threshold
        --name NAME                  Name for storage
    -v, --version                    Print version information
    -h, --help                       Show this help message


Options


  • 

    -s: PVE host address, only https supported, e.g. pve-01.test.at
    

    • 

  • 

    -k: Don't validate certificate
    

    • 

  • 

    -n: PVE Node name
    

    • 

  • 

    -n: Username with auth realm, e.g. monitoring@pve, root@pam
    

    • 

  • --name: Storage name, e.g. local, local-lvm
    • 

Modes


Cluster


Checks if the cluster is quorate. Warning if not. (/cluster/status)


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -m cluster
OK - LNZ: Cluster ready - quorum is ok


Node


The node name (via -n option) is required for all node checks.


SMART


Checks SMART status of the disks. (/nodes/{node}/disks/list)


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m smart
OK - No SMART errors detected


Updates


Displays a warning if new updates are available. (/nodes/{node}/apt/update)


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m update
Warning - New updates available


Subscription


Checks if subscription is valid. (/nodes/{node}/subscription)


Specify warning threshold for minimum number of days subscription has to be valid.
Critical status if the subscription has expired.


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m subscription -w 303                                                 
Warning - Subscription will end at 2018-10-13


Services


Displays a warning if a service isn't running. (/nodes/{node}/services)


./check_pve.rb -s hv-vm-01.test.a -u monitoring@pve -p test1234 -n hv-vm-01 -m services
Warning - postfix, spiceproxy not running


Storage


Checks storage usage in percentage. Value will be rounded. (/nodes/{node}/storage/{storage}/status)


Specify datastore/storage with "--name" option.


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m storage --name local -w 40 -c 60
Warning - Storage usage: 45% | Usage=45%;40;60


CPU


Checks CPU usage in percentage. Value will be rounded. (/nodes/{node}/status)


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m cpu -w 40 -c 60
OK - CPU usage: 30% | Usage=1%;40;60


Memory


Checks memory usage in gigabytes. (/nodes/{node}/status)


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m memory -w 40 -c 60
Warning - Memory Usage: 45GB | Usage=45GB;40;60


IO Wait


Checks IO wait/delay usage in percentage. Value will be rounded. (/nodes/{node}/status)


./check_pve.rb -s hv-vm-01.test.at -u monitoring@pve -p test1234 -n hv-vm-01 -m io_wait -w 1 -c 3
OK - IO Wait: 0% | Wait=0%;1;3