# DB2

# Introducción

**Ver**. 13-12-2022

Plugin con el que se puede monitorizar bases de datos DB2, pudiendo ejecutar consultas personalizadas.

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

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="width: 565px;"><tbody><tr><td style="width: 233.993px;">**Sistemas donde se ha probado**</td><td style="width: 330.99px;">CentOS 7, Fedora, rocky linux

</td></tr><tr><td style="width: 233.993px;">**Sistemas donde debería funcionar**</td><td style="width: 330.99px;">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
- Tener instalado python3
- tener instalada la librería ibm\_db

# Parámetros

**Parámetros**

<table border="1" id="bkmrk-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-" style="height: 261px; width: 811px;"><tbody><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--hostname</td><td style="height: 29px; width: 675px;">Ip o host </td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--uid</td><td style="height: 29px; width: 675px;">Nombre del usuario que realizará las consultas</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--password</td><td style="height: 29px; width: 675px;">Contraseña del usuario que realizará las consultas</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--port</td><td style="height: 29px; width: 675px;">Por defecto 50000</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--database</td><td style="height: 29px; width: 675px;">Nombre de la base de datos</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--protocol</td><td style="height: 29px; width: 675px;">Por defecto : TCPIP</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--default\_metrics</td><td style="height: 29px; width: 675px;">Métricas por default, desactivar poniendolo a 0</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 133.993px;">--conf</td><td style="height: 29px; width: 675px;">Enlace al conf que contiene las consultas</td></tr></tbody></table>

**Parámetros configuración pandora**

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3"><tbody><tr><td style="width: 161.997px;">--tentacle\_port</td><td style="width: 643.993px;">Puerto de tentacle.Por defecto 41121(opcional)</td></tr><tr><td style="width: 161.997px;">--tentacle\_address</td><td style="width: 643.993px;">Ip del servidor tentacle al que mandar los datos(opcional)</td></tr><tr><td style="width: 161.997px;">-g,--group</td><td style="width: 643.993px;">Grupo de destino de Pandora FMS (opcional)</td></tr><tr><td style="width: 161.997px;">--data\_dir</td><td style="width: 643.993px;">Directorio de datos de Pandora FMS. **Por defecto** es /var/spool/pandora/data\_in/ (opcional)</td></tr><tr><td style="width: 161.997px;">--as\_agent\_plugin</td><td style="width: 643.993px;">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

```
python3 pandora_db2.py --hostname <host> --uid <user> --database <database> --password <password> --conf <path conf> --as_agent_plugin 1
```

Los datos devueltos por la query se devolverían en formato lista en el módulo, por ejemplo esta consulta:

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

se vería así el xml:

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

# Configuración en PandoraFMS

**Como plugin de servidor**

**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:

```
/path_pandora_db2.py
```

<p class="callout info align-center">Recuerda que la ruta recomendada para el uso de los plugins de servidor es: /usr/share/pandora\_server/util/plugin/</p>

Y en parámetros del plugin introduciremos estos seguidos de la macro "\_field&lt;N&gt;\_", son obligatorios los parámetros de conexion, --hostname, --uid, --database y --password, por defecto el plugin tiene activada la extraccion de algunas métricas, estas pueden desactivarse poniendo el parámetro --default\_metrics a 0. El puerto y protocolo se pueden cambiar si no se usa el de por defecto.

<p class="callout warning">Recuerda que puedes ponerle un nombre personalizado a los agentes con el parámetro --agent\_name</p>

Una vez hecho esto, daremos a "crear".

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

El plugin creara un agente, con módulos para las consultas personalizadas definidas.

A su vez, si la opción --default\_metrics no se pone a 0, creará un agente con los siguientes módulos:

<table border="1" id="bkmrk-no_of_bufferpools-to" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">no\_of\_bufferpools</td></tr><tr><td style="width: 100%;">total\_logical\_reads</td></tr><tr><td style="width: 100%;">total\_physical\_reads</td></tr><tr><td style="width: 100%;">data\_logical\_reads</td></tr><tr><td style="width: 100%;">data\_physical\_reads</td></tr><tr><td style="width: 100%;">index\_logical\_reads</td></tr><tr><td style="width: 100%;">xda\_logical\_reads</td></tr><tr><td style="width: 100%;">log\_utilization\_percent</td></tr><tr><td style="width: 100%;">total\_log\_used\_kb</td></tr><tr><td style="width: 100%;">total\_log\_available\_kb</td></tr></tbody></table>