DB2

• Introducción
• Matriz de compatibilidad
• Pre requisitos
• Parámetros
• Ejecución manual
• Configuración en PandoraFMS
• Módulos generados por el plugin

Introducción

Ver. 13-12-2022

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

Matriz de compatibilidad

Sistemas donde se ha probado	CentOS 7, Fedora, rocky linux
Sistemas donde debería funcionar	Cualquier sistema linux

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 

--hostname	Ip o host
--uid	Nombre del usuario que realizará las consultas
--password	Contraseña del usuario que realizará las consultas
--port	Por defecto 50000
--database	Nombre de la base de datos
--protocol	Por defecto : TCPIP
--default_metrics	Métricas por default, desactivar poniendolo a 0
--conf	Enlace al conf que contiene las consultas

Parámetros configuración pandora

--tentacle_port	Puerto de tentacle.Por defecto 41121(opcional)
--tentacle_address	Ip del servidor tentacle al que mandar los datos(opcional)
-g,--group	Grupo de destino de Pandora FMS (opcional)
--data_dir	Directorio de datos de Pandora FMS. Por defecto es /var/spool/pandora/data_in/ (opcional)
--as_agent_plugin	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)

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:

se vería así el xml:

Configuración en PandoraFMS

Como plugin de servidor

Instalación manual

Iremos a servidores > plugins:

Pinchamos en añadir:

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

Recuerda que la ruta recomendada para el uso de los plugins de servidor es: /usr/share/pandora_server/util/plugin/

Y en parámetros del plugin introduciremos estos seguidos de la macro "_field<N>_", 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.

Recuerda que puedes ponerle un nombre personalizado a los agentes con el parámetro --agent_name

 

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:

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:

no_of_bufferpools

total_logical_reads

total_physical_reads

data_logical_reads

data_physical_reads

index_logical_reads

xda_logical_reads

log_utilization_percent

total_log_used_kb

total_log_available_kb