DB2

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

Introducción

Ver. 13-12-2022

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

Tipo: Plug-in de servidor

Matriz de compatibilidad

Sistemas donde se ha probado

CentOS 7, Fedora, rocky linux

Sistemas donde debería funcionar

Cualquier sistema linux 

Pre requisitos

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:

image-1670952605685.png

se vería así el xml:

image-1670952615083.png

Configuración en PandoraFMS

Como plugin de servidor

Instalación manual

Iremos a servidores > plugins:

image-1629974405286.png

Pinchamos en añadir:

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

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:

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:

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