OpenStack probe
1 Main Features
This probe works by getting the list of available providers and, for each Openstack API available, a VM is created, inspected and deleted, as a way to confirm that the main operations to be done are working as expected in the provider under evaluation. The probe is able to monitor several providers concurrently and it sends all the gathered metrics to the Zabbix server collecting all the information.
2 Pre-Requisites
Not fulfilling these requisites will have a negative impact in the execution of the probes.
It requires a CMDB available, so it will be possible to retrieve the list of available providers. Having no access to a CMDB means that the probe will not be able to retrieve a list of providers to monitor, therefore not doing anything;
Since the implementation of the probe is in Java, it requires, Java8 JVM to be already installed.
3 Installation
3.1 Ubuntu 16.04
You have to enable the INDIGO - DataCloud packages repositories. See full instructions
here.
After that you need to install the Java 8 Runtime Environment with
Finally you can install the probe with the command
3.2 Centos 7
You have to enable the INDIGO - DataCloud packages repositories. See full instructions
here.
After that you need to install the Java 8 Runtime Environment with
Finally you can install the probe with the command
3.3 Cron Job
Although the probes can be run just on demand, the best option is to configure them as Cron jobs. That can be configured by editing the configuration file with the following command:
Then, add the following lines:
This means that the probe will run every hour at xx:00. Modify this configuration according to your needs, so the probes will run when required.
4 Configuration
The Openstack probe requires to modify the openstackprobe.properties (inserted in /etc/zabbix/ for linux systems in C:\zabbixconfig for Windows ones) file in order to set the following parameters:
java.keystore - Set here the full location of the security certificates keystore
cmdb.location - Provide the full URL of the CMDB component, providing the information about the available providers
wait.real.vm.creation - Provides the user to get information about the real creation response time of a machine or just the immediate response from the client
is-iam-authenticated - If set to true the probe tries authenticating itself to Openstack via IAM. in this case just make sure to have filled all the fields in the property file especially the following ones:
iam.location - Endpoint of IAM
iam.username
iam.password
iam.clientid
iam.clientsecret
openstack.project - Name of the tenant where deploying the VMs
providers.exceptions - Meaning there are differences in configurations amongst the cloud providers just like the following two parameters
iam.protocol - Stands for the method used to get the unscoped token from openstack by using the already obtained bearer token
iam.identity.provider - stands for the general provider and that is as standard: indigo-dc
The probe now supports IAM authenticatiom so that with SSO it can communicate with all the Opestack supporting IAM authentication standard. However, if skipping Iam authentication from porperty file, just make sure to insert the credentials of openstack tenant (where the probe tries creating, deleting and inspecting the instances) inside oszones.yml file located at the same path as openstackprobe.properties.
5 Potential Issues
In the case of providers requiring some communication using SSL, if the provider certificate is not signed by a known entity, the JVM may throw exceptions. In such case, it is necessary to register the corresponding certificate with the following command:
Last updated