# Plugin Kemp Loadmaster

# Introducción

**Ver**. 08-06-2022  
  
Con este plugin se puede sacar datos de las estadísticas de rendimiento de Kemploadmaster.

<div id="bkmrk-tipo%3A-plug-in-de-ser"><div>**Tipo**: Plug-in de servidor o agente</div></div>

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="height: 70px; width: 597px;"><tbody><tr style="height: 35px;"><td style="height: 35px; width: 291.719px;">**Sistemas donde se ha probado**</td><td style="height: 35px; width: 304.281px;">CentOS 7, Fedora, rocky linux

</td></tr><tr style="height: 35px;"><td style="height: 35px; width: 291.719px;">**Sistemas donde debería funcionar**</td><td style="height: 35px; width: 304.281px;">Cualquier sistema linux

</td></tr></tbody></table>

# Pre requisitos

- Tener el **Data Server** de Pandora FMS habilitado
- Tener el **Plugin Server** de Pandora FMS habilitado

# Configuración previa

Es necesario habilitar la Rest API interface de kemp para poder utilizar el plugin. En el siguiente link se especifica como hacerlo.  
  
[https://support.kemptechnologies.com/hc/en-us/articles/201640799-How-to-Enable-Kemp-LoadMaster-RESTful-API-interface](https://support.kemptechnologies.com/hc/en-us/articles/201640799-How-to-Enable-Kemp-LoadMaster-RESTful-API-interface)

<p class="callout info align-center">Recuerda que tiene que estar activado el data server y el plugin server, pero esto es así por defecto.</p>

# Parámetros

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 401px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">**Parámetro**</td><td style="width: 50%; height: 29px;">**Descripción**</td></tr><tr><td style="width: 50%;">--tentacle\_port</td><td style="width: 50%;">Puerto de tentacle.Por defecto 41121(opcional)</td></tr><tr><td style="width: 50%;">--tentacle\_address</td><td style="width: 50%;">Ip del servidor tentacle al que mandar los datos(opcional)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--agent\_name</td><td style="width: 50%; height: 29px;">Para ponerle un nombre al agente que contendrá los módulos , por defecto : "Kemp". (opcional)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--prefix\_module</td><td style="width: 50%; height: 29px;">Para ponerle un prefijo a los módulos por si se quieren diferencias de otras ejecuciones.(opcional)</td></tr><tr><td style="width: 50%;">--url</td><td style="width: 50%;">Host o IP de tu servidor de Kemp Load master</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--user</td><td style="width: 50%; height: 29px;">User de kemp loadmaster (obligatorio)</td></tr><tr><td style="width: 50%;">--password</td><td style="width: 50%;">Password de kemp loadmaster (obligatorio)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">-g,--group</td><td style="width: 50%; height: 29px;">Grupo de destino de Pandora FMS (opcional)</td></tr><tr style="height: 46px;"><td style="width: 50%; height: 46px;">--data\_dir</td><td style="width: 50%; height: 46px;">Directorio de datos de Pandora FMS. **Por defecto** es /var/spool/pandora/data\_in/ (opcional)</td></tr><tr style="height: 63px;"><td style="width: 50%; height: 63px;">--as\_agent\_plugin</td><td style="width: 50%; height: 63px;">Es opcional, si quieres que el plugin sea de agente y te meta los módulos en el agente de pandora, ejecuta esto con un 1 (opcional)</td></tr></tbody></table>

# Ejecución manual

**Ejemplo de ejecución manual en modo server**

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

[![kemp_sever.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-06/scaled-1680-/kemp-sever.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-06/kemp-sever.png)

**Ejemplo ejecución en modo agente**

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

[![kemp_manual.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-06/scaled-1680-/kemp-manual.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-06/kemp-manual.png)

# Configuración en PandoraFMS

**Como plugin de servidor**

**Instalación desde consola**

Para el registro del plugin, desde la consola, se debe ir al apartado "registrar plugin".

**[![register_plugin.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register-plugin.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register-plugin.png)**

Daremos a seleccionar archivo.

**[![register_plugin2.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register-plugin2.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register-plugin2.png)**

Seleccionaremos el fichero pspz2 que contiene el plugin

Nos saldrá un mensaje que indicará si se ha registrado correctamente

Una vez registrado el plugin, lo veremos en el apartado plugins.

[![serversingles.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/serversingles.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/serversingles.png)

Pinchando en el título accederemos al menu del plugin.

En parámetros, veremos todos los del plugin, recordar que no todos son obligatorios, solo en los que así se especifíca

Abajo, en las macros de los parámetros podremos añadirles el valor requerido.

**Instalación manual**

Iremos a servidores &gt; plugins:

[![image-1629974405286.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/scaled-1680-/image-1629974405286.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974405286.png)

Pinchamos en añadir:

[![image-1629974430627.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/scaled-1680-/image-1629974430627.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974430627.png)

Le ponemos en nombre y la descripción que se prefiera:

Metemos como comando la ejecución con la ruta del plugin:

Y en parámetros del plugin introduciremos estos seguidos de la macro "\_field\_", los obligatorios para que el plugin funcione son -c y --as\_agent\_plugin (en caso de que queramos ejecutarlo como plugin de servidor, si no este último no es imprescindible.

Definiremos estos con las macros abajo.

  
Una vez hecho esto, daremos a "crear".

Puedes comprobar que has introducido bien los valores ejecutando el comando de vista previa por terminal

Si no da errores es que se ha introducido bien.

Una vez hecho esto, solo queda llamarlo por lo que iremos a la vista de algún agente y crearemos un módulo de complementos:

[![image-1646741530197.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-03/scaled-1680-/image-1646741530197.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-03/image-1646741530197.png)

Le daremos un nombre y en el apartado "plugin" pondremos el que acabamos de configurar.

Una vez hecho esto, damos a crear.

Si el modulo se muestra con 1, quiere decir que se esta ejecutando correctamente

# Módulos generados por el plugin

La ejecución del plugin creará un agente con los siguientes módulos:

<div id="bkmrk---user---system---id"><div>- User</div><div>- System</div><div>- Idle</div><div>- IOWaiting</div><div>- Mbtotal</div><div>- memused</div><div>- Mbused</div><div>- percentmemused</div><div>- memfree</div><div>- Mbfree</div><div>- percentmemfree</div><div>- CurrentConnections</div><div>- CurrentConnectionsBlocked</div><div>- SuccessfulConnectionAttempts</div><div>- SuccessfulRequestAttempts</div><div>- SuccessfulMatchedRuleAttempts</div><div>- ConnectionAttemptsBlocked</div><div>- RequestAttemptsBlocked</div><div>- MatchedRulesBlocked</div><div>- DifferentCountries</div><div>- LastHour</div><div>- LastDay</div><div>- ConnsPerSec</div><div>- TotalConns</div><div>- BitsPerSec</div><div>- TotalBits</div><div>- BytesPerSec</div><div>- TotalBytes</div><div>- PktsPerSec</div><div>- TotalPackets</div><div>- tps_total</div><div>- tps_ssl</div><div>- Sec</div><div>- Usec</div><div>- Period</div></div>**Ejemplo en la vista del agente de los módulos**

[![image-1654701506200.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-06/scaled-1680-/image-1654701506200.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-06/image-1654701506200.png)