Pandora FMS: Plugin Enterprise de monitorización de servidor DB2
1 recomendación335 vistas
El documento detalla un plugin de monitorización para servidores DB2, permitiendo la supervisión automática de su disponibilidad y estado utilizando herramientas internas de DB2. Incluye instrucciones sobre configuración, requisitos previos y uso del plugin, así como ejemplos de chequeos y la estructura de archivos necesarios para su implementación. Además, se presenta una matriz de compatibilidad para los sistemas donde es funcional el plugin.
Pandora FMS: Plugin Enterprise de monitorización de servidor DB2
- 1. Plugin de Monitorización de servidores DB2 Versión 1.0r1 12/12/2012 Page 1
- 2. Monitorización genérica de servidores DB2 OpenOffice/PDF Version 1st Edition, 12 Dec 2012 © Artica Soluciones Tecnológicas 2012 Índice de contenido 1 Monitorización de servidores DB2......................................................................................3 1.1. Introducción................................................................................................................3 1.2. Matriz de compatibilidad.............................................................................................4 1.3. Prerequisitos...............................................................................................................4 1.4. Configuración de DB2.................................................................................................4 2 Configuración del plugin.....................................................................................................5 3 Uso del plugin.....................................................................................................................6 3.1. Tokens de configuración.............................................................................................6 3.2. Creación del fichero de configuración:.......................................................................7 3.3. Creación de la politica................................................................................................8 Page 2
- 3. 1 MONITORIZACIÓN DE SERVIDORES DB2 1.1. Introducción Este plugin se ha realizado con el propósito de definir una monitorización personalizada a la par que automática de servidores DB2. De esta forma, este plugin local es capaz de trabajar haciendo uso de las propias herramientas internas de administración de DB2 a través del CLI. Este plugin realiza varias operaciones desde el plugin: • Obtención de datos de disponibilidad de un servidor DB2, dado un tipo de chequeo, y opcionalmente nombre del objeto concreto a monitorizar de todo el chequeo en cuestión. Se le proporciona una expresion regular para verificar que la respuesta sea correcta. Para realizar estas comprobaciones es necesario disponer de la herramienta db2, credenciales de acceso de la base de datos a monitorizar y la ruta a los binarios raíz del servidor DB2 ubicada dentro del PATH del sistema o del agente. • Verificación de disponibilidad de bases de datos en una instancia. Activación, conexión y verificación de estado en cualquier base de datos de la instancia, con o sin credenciales. • Verificación de disponibilidad de aplicaciones de bases de datos de una instancia. Comprobación del estado de conexión de cada aplicación asociada a una instancia de base de datos. • Datos sobre un filesystem o volumen lógico. Indicando el % de disco libre. • Parseo de un fichero log. Utilizando el plugin de parseo de logs básico de Pandora FMS. Se le debe proveer el path el plugin. • Obtención de datos de disponibilidad de un servidor DB2. Mediante la aplicación wsadmin (requiere configuración previa de este último). ◦ DB2 Connection Status ◦ DB2 Application Status ◦ DB2 Total Connected Application Count ◦ DB2 Total Disconnected Application Count ◦ DB2 Active Application Count El plugin tiene un fichero de configuración donde se pueden configurar todos esos chequeos. Se pueden realizar 1..n chequeos de los enumerados arriba. Nótese además que cada módulo incluirá una descripción extendida sobre su significado y su unidad de medición. Page 3
- 4. 1.2. Matriz de compatibilidad La matriz de compatibilidad del plugin es la siguiente Sistemas donde se ha probado • Solaris 10 SPARC V9 con DB2 10.1 Sistemas donde deberia funcionar • Mismo sistema o superior • Cualquier DB2 con capacidad de extracción de snapshot de los diferentes monitor switches de una instancia 1.3. Prerequisitos Se creará un fichero de configuración por servidor, y en cada fichero de configuración habrá que especificar: • El nombre de proceso completo que queramos verificar para obtener su estado, memoria y CPU. • El nombre completo del volumen que queramos monitorizar. • El log y la cadena que queramos verificar en caso de buscar expresiones en un fichero log. • Para obtener información sobre DB2 necesitaremos disponer un usuario con privilegios (sea root, sea el usuario db2instx, etc) con las variables de entorno necesarias para el funcionamiento de la interfaz DB2 y la conexión contra las bases de datos de una instancia. La definición de este tipo de chequeos vendrá especificada a lo largo del documento. 1.4. Configuración de DB2 Para configurar el sistema correctamente de cara a la monitorización de DB2 mediante su interfaz en línea de comandos hacia Pandora, tendremos simplemente que asegurarnos de incluir dentro de las variables de entorno la instancia a la que conectarse, y la ruta a las librerías y binarios de DB2. Por ejemplo: Page 4
- 5. DB2INSTANCE=db2inst1 LD_LIBRARY_PATH=/export/home/db2inst1/sqllib/lib64:/export/home/db2inst1/sqllib/lib3 2 PATH=/usr/bin:/export/home/db2inst1/sqllib/bin:/export/home/db2inst1/sqllib/adm:/exp ort/home/db2inst1/sqllib/misc:/export/home/db2inst1/sqllib/db2tss/bin CLASSPATH=/export/home/db2inst1/sqllib/java/db2java.zip:/export/home/db2inst1/sqllib /java/db2jcc.jar:/export/home/db2inst1/sqllib/java/sqlj.zip:/export/home/db2inst1/sq llib/function:/export/home/db2inst1/sqllib/java/db2jcc_license_cu.jar:. 2 CONFIGURACIÓN DEL PLUGIN Una vez tenemos el plugin copiado al disco (mediante filecollections o a mano) y un fichero de configuración con los valores que queremos monitorizar, incluiremos la llamada de este plugin en el fichero pandora_agent.conf como un plugin local de agente. Dicho plugin introducirá generará toda la monitorización con esa simple llamada. pandora_agent.conf es el archivo de configuración del Agente Software de Pandora y donde se deben localizar todos los plugins de agente. Este archivo puede encontrarse por defecto en: /etc/pandora/pandora_agent.conf Y en sistema windows: c:archivos de programapandora_agentpandora_agent.conf Una vez localizado, escribiremos lo siguiente para crear la llamada al plugin de agente, en Unix: module_plugin /etc/pandora/collections/fc_x/Pandora_Plugin_DB2_vx.yrz.pl /etc/pandora/collections/fc_x/$HOSTNAME-db2.conf 2> plugin_error.log Es importante hacer una redirección de errores a /dev/null o a un log debido a que la ejecución de los chequeos DB2 implica una conexión con su interfaz para extraer los datos, proceso en el que algunos datos pueden aparecer en stderr. La no redirección de errores implicaría la no obtención de información en caso de un error en la ejecución del plugin o el fallo en la ejecución debido al conflicto entre dichos datos y el formato XML en el que la información es extraida para ser procesada por el Data Server en Pandora. Page 5
- 6. 3 USO DEL PLUGIN Usaremos un ejemplo basado en Filecollections y políticas para su despliegue en la monitorización de un servidor DB2 8.5 corriendo en un sistema Solaris 10 basado en SPARC v9. 3.1. Tokens de configuración Los tokens de configuración son los siguientes: logparser <path_to_log> Utiliza el logparser indicado en el path. Para usar la opción log (descrita en más adelante en este documento) es necesario configurar correctamente este token. Ejemplo: logparser /etc/pandora/plugins/grep_log volume <web_server>;<X> Monitorización de disco X, devuelve el espacio libre en %. Ejemplo: volume main_server;/opt process <module_name>;<process_path> Devuelve informacion sobre el proceso. Se especifica el nombre que queramos que aparezca en el modulo de pandora y el nombre del proceso (literal) en el sistema. Devolverá estado, consumo de memoria total (todas las intancias) y consumo de CPU total (todas las intancias) . Ejemplo: process webserver;webservd -d /opt/oracle/webserver7/admin-server log <path_to_log>;<regexp to match> Parsea un fichero log (p.e: /tmp/error.log) generando un modulo llamado “log_test” y buscando la expresion regular “error”. Para usar esta opción previamente se debe configurar correctamente el token “logparser” descrito anteriormente. Ejemplo: log /tmp/error.log;log_test;error Page 6
- 7. db2_stats db2;<check_type>;<instance_name>;<database_name>;<app_name>;<system_username>; <db2_username>;<db2_password> Utilizando el CLI de DB2, se obtienen valores de estado del servidor en cuestión. Actualmente los chequeos soportados son: – check_dbconnect (usuario y contraseña opcionales, app_name no utilizado. Obtiene información acerca de la conexión de DB2 contra una base de datos de una instancia y su estado) – check_application (usuario y contraseña opcionales. Obtiene información acerca del estado de una aplicación, en caso de nombrarla en app_name, de todas las aplicaciones, en caso de asignar * a app_name o información general sobre el número de aplicaciones totales, conectadas o desconectadas, dejando app_name en desuso) Por ejemplo: db2_stats db2;check_application;db2instl;SAMPLE;db2stmm;db2instl;; En este ejemplo que usa el chequeo check_application, se comprueba el estado de la aplicación db2stmm, dentro de la base de datos SAMPLE de la instancia db2instl, utilizando como usuario del sistema con privilegios de acceso aquel con el mismo nombre de la instancia. 3.2. Creación del fichero de configuración: Creamos un fichero llamado por ejemplo: • zbea-db2.conf Su contenido es el siguiente: logparser /var/opt/pandora/etc/pandora/plugins/grep_log log /tmp/db2backup.log;DB2_BackupStatus;successful db2_stats db2;check_dbconnect;db2instl;SAMPLE;;db2instl;; #db2_stats db2;check_application;db2instl;SAMPLE;db2stmm;db2instl;; db2_stats db2;check_application;db2instl;SAMPLE;*;db2instl;; db2_stats db2;check_application;db2instl;SAMPLE;;db2instl;; Nótese que al usar el * en un chequeo de tipo check_application, es necesario comentar o eliminar los chequeos contra objetos únicos, ya que con el * ya nos encargamos de extraer la información del estado de todas y cada una de las aplicaciones que corren en dicha instancia de base de datos simultáneamente. Page 7
- 8. Creamos la FC llamada “DB2” con ID fc_1355338194 y copiamos el plugin, los scripts de los que depende y los ficheros de configuración: 3.3. Creación de la politica Crearemos un modulo de tipo local en la política con el siguiente aspecto: Asociaremos el file collection a la política: Page 8
- 9. Aplicamos la política y esperamos a que nos aparezcan los módulos. Notese que existen otros modulos en el agente que no tienen que ver con el plugin. Ahora vamos a trabajar con la herramienta de operaciones masivas, y modificar los umbrales para algunas métricas, como las de consumo de CPU a nivel de sistema y de usuario: Podemos hacer lo mismo para agregar alertas a todos los modulos de tipo PROCESS_STATUS. Aunque tuvieran nombres iguales (e internamente busquen cosas diferentes ) no habrá que hacerlo uno por uno. La misma operación se podria hacer adoptando módulos en la politica. Page 9