Plugin Kemp Loadmaster

• Introduction
• Compatibility matrix
• Pre requisites
• Previous configuration
• Parameters
• Manual execution
• Configuration in PandoraFMS
• Módules generated by the plugin

Introduction

Ver. 08-06-2022

With this plugin you can pull performance statistics data from Kemploadmaster.

Compatibility matrix

Systems where tested	CentOS 7, Fedora, rocky linux
Systems where it should work	Any linux system

Pre requisites

• Pandora FMS Data Server enabled
• Pandora FMS Plugin Server enabled

Previous configuration

It is necessary to enable kemp's Rest API interface in order to use the plugin. The following link specifies how to do it.

https://support.kemptechnologies.com/hc/en-us/articles/201640799-How-to-Enable-Kemp-LoadMaster-RESTful-API-interface

Remember that the data server and plugin server must be enabled, but this is the default.

 

Parameters

Parámetro	Descripción
--tentacle_port	Tentacle port Default 41121(optional)
--tentacle_address	Ip del servidor tentacle al que mandar los datos(opcional)
--agent_name	To name the agent that will contain the modules, by default : "Kemp". (optional)
--prefix_module	To prefix the modules in case you want to differentiate them from other executions (optional).
--url	Host or IP of your Kemp Load master server
--user	User of kemp loadmaster (required)
--password	Password de kemp loadmaster (obligatorio)
-g,--group	Pandora FMS target group (optional)
--data_dir	Pandora FMS data directory. By default it is /var/spool/pandora/data_in/ (optional)
--as_agent_plugin	It is optional, if you want the plugin to be an agent plugin and put the modules in the pandora agent, execute this with a 1 (optional)

Manual execution

Example of manual execution in server mode

python pandora_kemploadmaster.py -u <user> -us <user> -p <pass> --tentacle_address <ip> --data_dir <path>

Example execution in agent mode

python pandora_kemploadmaster.py -u <user> -us <user> -p <pass> --as_agent_plugin 1

Configuration in PandoraFMS

As a server plugin

Installation from console

To register the plugin, from the console, go to the "register plugin" section.

 

Click on select file.

Select the pspz2 file containing the plugin.

 

We will see a message that will indicate if it has been registered correctly.

 

Once the plugin is registered, we will see it in the plugins section.

 

Clicking in the title we will accede to the menu of the plugin.

 

In parameters, we will see all the parameters of the plugin, remember that not all of them are mandatory, only in those that are specified.

 

Below, in the macros of the parameters we will be able to add the required value.

 

 

Manual installation

Go to servers > plugins:

 

Click on add:

We put in name and the description that is preferred:

 

 

 

We put as command the execution with the path of the plugin:

 

And in plugin parameters we will introduce these followed by the macro "_field_", the mandatory ones for the plugin to work are -c and --as_agent_plugin (in case we want to run it as a server plugin, otherwise the latter is not essential.

We will define these with the macros below.

 

 

Once this is done, click on "create".

You can check that you have entered the values correctly by executing the preview command in the terminal.

If it does not give errors is that it has been entered well.

Once this is done, the only thing left to do is to call it, so we will go to the view of some agent and we will create a module of complements:

 

We will give it a name and in the section "plugin" we will put the one we have just configured.

Once this is done, click on create.

If the module is shown with 1, it means that it is running correctly. 

 

Módules generated by the plugin

The plugin execution will create an agent with the following modules:

 

Example in the agent view of the modules