Pandora FMS: Informix plugin

Pandora FMSManual AdministradorPlugin Informix DBSpaces

Manual Administrador Plugin Informix DBSpaces

© Artica Soluciones Tecnológicas 20052012

Índice de contenido1Histórico de cambios..........................................................................................................................32Monitorización de servidores Informix..............................................................................................4

2.1.Introducción...............................................................................................................................42.2.Matriz de compatibilidad...........................................................................................................52.3.Prerequisitos...............................................................................................................................62.4.Configuración de Informix........................................................................................................6

3Configuración del plugin....................................................................................................................64Uso del plugin.....................................................................................................................................8

4.1.Tokens de configuración............................................................................................................84.2.Creación del fichero de configuración:......................................................................................94.3.Creación de la politica.............................................................................................................10

1 HISTÓRICO DE CAMBIOS

Fecha Autor Cambio Versión

18/04/12 Tomas Primera versión del plugin v1r1

Page 3

2 MONITORIZACIÓN DE SERVIDORES INFORMIX

2.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 Informix. De esta forma, este plugin local es capaz de trabajar

haciendo uso de las propias herramientas internas de administración de Informix a través del CLI.

Este plugin realiza varias operaciones desde el plugin:

• Obtención de datos de disponibilidad de un servidor Informix, 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 onstat,

credenciales de acceso de la base de datos a monitorizar y la ruta a los binarios raíz del

servidor Informix ubicada dentro del PATH del sistema o del agente.

• 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 del plugin en la configuración.

• Obtención de datos de disponibilidad de un servidor Informix. Mediante la aplicación onstat

(requiere configuración previa de este servidor).

◦ Informix Free DBSpaces

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 4

2.2. Matriz de compatibilidad

La matriz de compatibilidad del plugin es la siguiente

Sistemas donde se ha probado • Solaris 10 SPARC V9 con Informix 11.7

Sistemas donde deberia funcionar

• Mismo sistema o superior• Cualquier Informix con capacidad de

extracción de información de una instancia via onstat

Page 5

2.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 Informix necesitaremos disponer un usuario con privilegios (p.e.

root) con las variables de entorno necesarias para el funcionamiento de la herramienta onstat a la

hora de establecer conexión contra una instancia de Informix. La definición de este tipo de

chequeos vendrá especificada a lo largo del documento.

2.4. Configuración de Informix

Para configurar el sistema correctamente de cara a la monitorización de Informix mediante su

herramienta de extracción de datos estadísticos por 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 Informix. Por ejemplo:

INFORMIXDIR=/opt/IBM/informix; export INFORMIXDIR;PATH=$INFORMIXDIR/bin:$PATH; export PATH;INFORMIXSERVER=ol_informix1170; export INFORMIXSERVER;ONCONFIG=onconfig.ol_informix1170; export ONCONFIG;INFORMIXSQLHOSTS=$INFORMIXDIR/etc/sqlhosts.ol_informix1170; export INFORMIXSQLHOSTS;INFORMIXTERM=$INFORMIXDIR/etc/termcap; export INFORMIXTERM;LD_LIBRARY_PATH=$INFORMIXDIR/lib; export LD_LIBRARY_PATH;

3 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

Page 6

Y en sistema windows:

c:\archivos de programa\pandora_agent\pandora_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_InformixDBSpaces_vx.yrz.pl /etc/pandora/collections/fc_x/$HOSTNAMEdbspaces.conf 2> dbspacesplugin_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 Informix implica una conexión a través de su herramienta 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 7

4 USO DEL PLUGIN

Usaremos un ejemplo basado en Filecollections y políticas para su despliegue en la monitorización

de un servidor Informix 11.7 corriendo en un sistema Solaris 10 basado en SPARC v9.

4.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 <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 8

informix_stats onstat;check_dbspace;*

Utilizando la herramienta de Informix “onstat”, se obtienen valores de estado del servidor en

cuestión. Actualmente los chequeos soportados son:

– check_ db space (Solo soportado * para la extracción del estado de todos los dbspaces.

Obtiene información acerca del estado de ocupación de los diferentes dbspaces de una base

de datos de una instancia Informix)

Por ejemplo:


4.2. Creación del fichero de configuración:

Creamos un fichero llamado por ejemplo:

• zbeadbspaces.conf

Su contenido es el siguiente:

logparser /var/opt/pandora/etc/pandora/plugins/grep_log

log /tmp/backup.log;Informix_BackupStatus;successful


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.

Creamos la FC llamada “Informix” con ID “fc_1361287520” y copiamos el plugin, los scripts de los

que depende y los ficheros de configuración:

Page 9

4.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:

Aplicamos la política y esperamos a que nos aparezcan los módulos. Nótese que existen otros

modulos en el agente que no tienen que ver con el plugin.

Page 10

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 11