OpenStack data collector
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 and sudo access to the Linux KVM hypervisor. If you are not using the admin account or admin equivalent privileges, you will need to use trial and error to identify the default policies to relax for your data collector userid.
-
The OpenStack Gnocchi module must be installed and configured for performance collection. Configuring Gnocchi 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
-
Ocata
-
-
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 Gnocchi 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 |
SSH Port |
Port used for SSH |
SSH Process Retries |
Number of inventory retry attempts |
Inventory Poll Interval (min) |
Interval between inventory polls. The default is 20 minutes. |
Troubleshooting
Some things to try if you encounter problems with this data collector:
Inventory
Problem: | Try this: |
---|---|
"Configuration error" with error messages start with “Policy doesn't allow” or “You are not authorized” |
* Check ip address |
Additional information may be found from the Support page or in the Data Collector Support Matrix.