pandora fms: informix plugin
DESCRIPTION
Este plugin permite monitorizar un servidor Informix. Se trata de un plugin local, que utiliza herramientas locales de Informix para la recolección de la información. Para más información visite la siguiente pagina web: http://pandorafms.com/index.php?sec=Library&sec2=repository&lng=es&action=view_PUI&id_PUI=591TRANSCRIPT
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:
informix_stats onstat;check_dbspace;*
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
informix_stats onstat;check_dbspace;*
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