Plugin Kemp Loadmaster

Plugin to get performance statistics from Kemp Loadmaster

Introduction

Ver. 08-06-2022

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

Tipo: Plug-in server

Compatibility matrix

Systems where tested

CentOS 7, Fedora, rocky linux

Systems where it should work

Any linux system

Pre requisites

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>

kemp_sever.png

Example execution in agent mode

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

kemp_manual.png

Configuration in PandoraFMS

As a server plugin

Installation from console

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

 

register_plugin.png

Click on select file.

register_plugin2.png

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.

 

serversingles.png

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:

 

image-1629974405286.png

Click on add:

image-1629974430627.png

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:

 

image-1646741530197.png

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:

- User
- System
- Idle
- IOWaiting
- Mbtotal
- memused
- Mbused
- percentmemused
- memfree
- Mbfree
- percentmemfree
- CurrentConnections
- CurrentConnectionsBlocked
- SuccessfulConnectionAttempts
- SuccessfulRequestAttempts
- SuccessfulMatchedRuleAttempts
- ConnectionAttemptsBlocked
- RequestAttemptsBlocked
- MatchedRulesBlocked
- DifferentCountries
- LastHour
- LastDay
- ConnsPerSec
- TotalConns
- BitsPerSec
- TotalBits
- BytesPerSec
- TotalBytes
- PktsPerSec
- TotalPackets
- tps_total
- tps_ssl
- Sec
- Usec
- Period

 

Example in the agent view of the modules

image-1654701506200.png