Check openstack-nova-list

Overview

Nova is the OpenStack project that provides a way to provision compute instances (aka virtual servers). This monitoring plugin lists all virtual servers and checks their status.

You have to provide a path to an rc file to authenticate. A working rc file might look like this:

export OS_AUTH_URL=https://linuxfabrik.cloud/identity/v3
export OS_IDENTITY_API_VERSION=3
export OS_INTERFACE=public
export OS_PROJECT_DOMAIN_NAME=default
export OS_PROJECT_ID=492a82d9-003a-4f52-8891-406eb19d0573
export OS_PROJECT_NAME=MYPROJECT
export OS_REGION_NAME=default
export OS_USER_DOMAIN_NAME=default
export OS_USERNAME=MYUSER
OS_PASSWORD='linuxfabrik'
export OS_PASSWORD

Fact Sheet

Check Plugin Download

https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/openstack-nova-list

Check Interval Recommendation

Once a minute

Can be called without parameters

Yes

Compiled for

Linux

3rd Party Python modules

python-novaclient

Help

usage: openstack-nova-list [-h] [-V] [--always-ok] [--rc-file RC_FILE]

Nova is the OpenStack project that provides a way to provision compute
instances (aka virtual servers). This monitoring plugin lists all virtual
servers and checks their status.

options:
  -h, --help         show this help message and exit
  -V, --version      show program's version number and exit
  --always-ok        Always returns OK.
  --rc-file RC_FILE  Specifies a rc file to read connection parameters like
                     OS_USERNAME from (instead of specifying them on the
                     command line), for example
                     `/var/spool/icinga2/.openstack.cnf`. Default:
                     /var/spool/icinga2/.openstack.cnf

Usage Examples

openstack-nova-list --rc-file /var/spool/icinga2/rc/.openstack-myproject.rc

Output:

2 servers checked. 1 active, 0 migrating, 1 demand verify resize, 0 in error. Last status update 2023-06-13 12:34:00 UTC (3h 6m ago).

Name              ! ID                                   ! Updated (UTC)                      ! Status
------------------+--------------------------------------+----------------------------------+--------------------------
first_server      ! 48f44934-2bdf-4aed-84f8-df0960689620 ! 2023-06-08 16:39:51 (3D 18h ago) ! VERIFY_RESIZE [WARNING]
second_server     ! 38654a93-435d-40ea-bd39-64d01b186830 ! 2023-06-12 09:11:09 (2h 45s ago) ! ACTIVE

States

  • Alerts when a VM returns a status other than ACTIVE, MIGRATING, REBOOT, SHELVED, SHELVED_OFFLOADED, SHUTOFF, SUSPENDED.

Perfdata / Metrics

Name

Type

Description

total

Number

Number of total VMs

ACTIVE

Number

Number of VMs in this state

BUILD

Number

Number of VMs in this state

DELETED

Number

Number of VMs in this state

ERROR

Number

Number of VMs in this state

HARD_REBOOT

Number

Number of VMs in this state

MIGRATING

Number

Number of VMs in this state

PASSWORD

Number

Number of VMs in this state

PAUSED

Number

Number of VMs in this state

REBOOT

Number

Number of VMs in this state

REBUILD

Number

Number of VMs in this state

RESCUE

Number

Number of VMs in this state

RESIZE

Number

Number of VMs in this state

REVERT_RESIZE

Number

Number of VMs in this state

SHELVED

Number

Number of VMs in this state

SHELVED_OFFLOADED

Number

Number of VMs in this state

SHUTOFF

Number

Number of VMs in this state

SOFT_DELETED

Number

Number of VMs in this state

SUSPENDED

Number

Number of VMs in this state

UNKNOWN

Number

Number of VMs in this state

VERIFY_RESIZE

Number

Number of VMs in this state

Credits, License