OpenStack data collector Edit on GitHub Request doc changes

The OpenStack (REST API / KVM) data collector acquires inventory data for all OpenStack instances, and optionally, VM performance data.

Requirements

  • IP address of the OpenStack controller

  • OpenStack admin role credential & sudo access to the Linux KVM hypervisor

  • The OpenStack Ceilometer module must be installed and configured for performance collection. Configuring the Ceilometer is done by editing the nova.conf file for each hypervisor and then restarting the Nova Compute service on each hypervisor. The option name changes for different releases of OpenStack:

    • Icehouse

    • Juno

    • Kilo

    • Liberty

    • Mitaka

    • Newton

  • For CPU stats, “compute_monitors=ComputeDriverCPUMonitor” needs to be turned on in /etc/nova/nova.conf on compute nodes.

  • Port requirements:

    • 5000 for http and 13000 for https, for the Keystone service

    • 22 for KVM SSH

    • 8774 for Nova Compute Service

  • 8776 for Cinder Block Service

    • 8777 for Ceilometer Performance Service

    • 9292 for Glance Image Service
      Note The port binds to the specific service, and the service may run on the controller or another host in larger environments.

Configuration

Field Description

OpenStack Controller IP Address

IP address or fully-qualified domain name of the OpenStack Controller

OpenStack Administrator

User name for an OpenStack Admin

OpenStack Password

Password used for the OpenStack Admin

OpenStack Administrator Tenant

OpenStack Administrator Tenant name

KVM Sudo User

KVM Sudo User name

Choose 'Password' or 'OpenSSH Key File' to specify credential type

Credential type used to connect to the device via SSH

Full Path to Inventory Private Key

Full Path to Inventory Private Key

KVM Sudo Password

KVM Sudo Password

Advanced configuration

Field Description

Enable hypervisor inventory discovery through SSH

Check this to enable hypervisor inventory discovery through SSH

OpenStack Admin URL port

OpenStack Admin URL port

Use HTTPS

Check to use secure HTTP

HTTP Connection Timeout (sec)

Timeout for HTTP connection. The default is 300 seconds.

SSH Port

Port used for SSH

SSH Process Wait Timeout (sec)

SSH process timeout. The default is 30 seconds.

SSH Process Retries

Number of inventory retry attempts

Inventory Poll Interval (min)

Interval between inventory polls. The default is 20 minutes.