Los agentes son los recolectores de información, una vez se han instalado en la máquina que se va a monitorizar y se ha copiado la clave publica en el Servidor de Pandora éste empezara a recibir y procesar los datos que el agente recoge. Estos datos se denominan módulos.
Cada módulo tiene el valor de la variable que monitoriza. Para que estos datos se consoliden en la base de datos y se puedan tratar, hay que dar de alta el Agente en el Servidor de Pandora y asignarle a un grupo definido en Pandora.
Para cada agente se permite:
La creación de grupos en Pandora se realiza desde «Gestión de perfiles» > «Gestión de grupos», en el menú de administración.
En esta pantalla se encuentran todos los grupos existentes, hay nueve grupos creados por defecto:
Se pueden crear todos los grupos que se necesiten pulsando en «Crear grupo» y asignándole un nombre.
Para borrar un grupo se pulsa en
el icono 
que cada grupo tienen a su derecha.
Una vez se han copiado en el servidor de Pandora la clave pública de la máquina que se quiere monitorizar y se ha ejecutado el agente de Pandora, para que los datos empiecen a consolidarse en la Base de Datos y se pueda acceder a los mismos, se necesita añadir el agente a través de la consola Web.
Para añadir un agente accedemos a «Gestión de agentes» > «Crear agente», desde el menú de administración.
Para crear un agente se deben de configurar los siguientes datos:
agent name» en el archivo agent.conf que hay en cada agente.
En el caso en el que esta variable esté comentada se
utilizará el nombre de Host de la máquina donde se está ejecutando el agente (éste se obtiene ejecutando el comando hostname).
- Modo aprendizaje: Se admiten todos los módulos que envíe el agente y se definen automáticamente en el sistema. Al principio es más cómodo dar de alta los agentes en este modo y posteriormente desactivar el modo aprendizaje.
- Modo normal: Se deben configurar los módulos que se aceptaran de forma manual. No permite la autodefinición de ningún módulo.
Los agentes de Pandora utilizan comandos propios del sistema operativo para monitorizar un dispositivo. Estos comandos producen una salida que el servidor de Pandora procesa e inserta en la Base de Datos. Estos comandos utilizados en los agentes se denominan módulos.
Si el agente se ha añadido en modo normal, se deben de asignar los módulos que queremos monitorizar. Estos módulos deben de estar configurados en el archivo de configuración del agente.
Para asignarle los módulos, que el servidor de Pandora procesará, accedemos a «Gestión de agentes» en el menú de administración. En está página aparece una lista con todos los agentes que hay en Pandora.
Al pulsar sobre el agente que se quiere modificar aparecen los datos que se han configurado al crear el agente. Desde aquí se crearán los módulos desde el formulario de asociación de módulos.
Para crear un módulo se deben completar los siguientes campos:
- generic_data, tipo numérico de datos enteros.
- generic_data_inc, tipo numérico de datos enteros incrementales.
- generic_data_proc, tipo numérico booleano: 0 Falso, >0 Verdadero.
- generic_data_string, tipo alfanumérico de datos (cadena de texto, máximo 255 caracteres).
Todos los módulos monitorizados por un agente se pueden ver accediendo al agente en «Gestión de agentes», menú de administración.
Desde aquí se puede:
No será posible modificar el tipo de dato del módulo.
Una alerta es la acción que tomará Pandora cuando el valor de un módulo se encuentre fuera de un rango configurado previamente.
Esta acción puede ser desde enviar un mail o un SMS, enviar un trap de SNMP, escribir el suceso en el syslog del sistema, o en archivo de log de Pandora, etc. En definitiva, se podrá ejecutar cualquier script configurado en el Sistema Operativo de Pandora.
Para acceder a las alertas creadas lo hacemos desde la opción de «Gestión de alertas» dentro del menú de administración.
Por defecto hay definidos 6 ejemplos de alertas:
Para borrar una alerta pulsamos en que se encuentra a la derecha de la alerta que se quiere borrar.
Para crear una alerta personalizada se accede a «Gestión de alertas» > «Crear alertas», en el menú de administración
Al crear una alerta, hay que rellenar los siguientes campos:
En el campo «Comando» se pueden utilizar las siguientes variables para construir el comando que ejecutará la máquina donde esté el servidor de Pandora (si hay varios, en el servidor en modo Master), reemplazandose los valores en tiempo de ejecución:
_field1_: Campo 1, generalmente es el nombre de usuario, e-mail destino o identificación para este evento_field2_: Campo 2, generalmente es una breve descripción de eventos, como el «asunto» del e-mail_field3_: Campo 3, texto explicativo del evento_agent_: Nombre del agente_timestamp_: Representación estándar de la hora y fecha. Reemplazada automáticamente cuando se ha lanzado el evento_data_: Valor del dato que lanzó la alertaUna vez se ha añadido el agente, se han configurado los módulos y se han creado las alertas que se quieren generar, se asignan estas alertas al agente correspondiente.
Desde «Gestión de agentes» en el menú de administración, seleccionamos el agente que se quiere configurar. Al final de la página de configuración está la sección «Formulario de asociación de alerta».
Para asignar una alerta hay que rellenar los siguientes campos:
_field1_»._field2_»._field3_».Todas las alertas creadas para un agente se pueden ver accediendo al agente, en «Gestión de agentes» desde el menú de administración.
En muchos casos un usuario se encontrara con el caso de que módulos y alertas configuradas en un agente se repiten en otro agente que se quiere añadir.
Con el fin de simplificar el trabajo de un administrador, dentro de Pandora se pueden copiar módulos y alertas definidas en un agente existente sobre otro agente.
Accedemos a «Gestión de agentes» > «Gestionar conf.», menú de administración:
Desde Agente origen se accede al agente del cual se quieren copiar los módulos y/o alertas. Pinchando en «Obtener info.» se obtienen todos los módulos que tiene el agente elegido.
El proceso de copia se realiza para copiar la configuración de los módulos y/o la configuración de las alertas desde el agente seleccionado como origen hacia los agentes seleccionados como destino. Pueden seleccionarse varios agentes, utilizando el CTRL y el ratón. Hay que marcar las casillas de «alertas» y/o «módulos» para realizar una copia de los elementos seleccionados.
El proceso de borrado se realiza sobre los agentes seleccionados como «destino», en la casilla de selección múltiple. Se pueden seleccionar varios agentes, indicando si queremos eliminar la configuración de los módulos, de las alertas o todo el conjunto. Se pedirá confirmación antes de ejecutar dado que al eliminar los módulos asignados a un agente se eliminará también todos los datos asociados a estos.
Una vez que se han configurado los grupos y los agentes, se puede ver el estado de los grupos de agente utilizando la opción «Ver agentes» del menú de operación
Si pasamos el ratón sobre cualquier imagen de grupo, veremos el número de agentes que tiene el grupo además del número de monitores, organizado por estado.
Si pulsamos el icono 
que aparece a la derecha de cada grupo, se refrescará la información del grupo seleccionado.
Una vez el agente empieza a enviar datos al servidor de Pandora, y es añadido en la consola Web, éste los procesa e inserta los datos en la Base de Datos. Estos datos se consolidan y son accesibles desde la consola Web ya sea el dato en bruto o mediante gráficas.
Desde la opción «Ver agentes» en el menú de operación se tiene acceso a los grupos de agentes. Desde aquí se ve rápidamente estado en que esta cada uno de los agentes simplemente con una rápida mirada, gracias a un sistema de bombillas y círculos coloreados.
Si entramos en la opción «Detalle agente» accedemos a una lista ordenada alfabéticamente de todos los agentes.
En la lista, los agentes aparecen ordenados con las siguientes columnas:
Agente: Muestra el nombre del agente.
SO: Muestra un icono representante del Sistema Operativo.
Intervalo: Muestra el intervalo de tiempo (segundos) en el que el agente envía datos.
Grupo: Muestra el grupo al que pertenece el agente.
Módulos: En estado normal aparecen dos valores el número de módulos y el número de monitores, ambos de color negro. Si hay algún monitor en estado incorrecto, aparecen tres valores: el número de módulos, el número de monitores y el número de monitores con estado incorrecto, éste último en color rojo, el resto de color negro.
Estado: Muestra el estado «general» del agente mediante los siguientes iconos:
Cuando todos los monitores están OK. El estado ideal.
Cuando no hay monitores definidos. A veces no monitorizamos nada que pueda estar «bien» o «mal», y simplemente reporta datos
numéricos o de tipo texto.
Cuando al menos un monitor falla. Generalmente queremos evitar esto y que todos nuestros sistemas tengan un saludable color verde.
Cuando el agente no tiene datos. Los agentes nuevos con un paquete vacío pueden tener este estado.
Cuando hay un cambio entre verde y rojo. Esto indica que un agente acaba de cambiar de estado, de «todo bien» a «tenemos un problema».
Cuando el agente está caído o no se ha recibido información de él en el doble del Intervalo en segundos. Generalmente se debe a un
problema de comunicación o a un «cuelgue» del sistema remoto.
Alertas: Muestra si se han enviado alertas mediante los siguientes iconos:
Cuando no se ha enviado ninguna alerta.
Cuando se ha enviado al menos una alerta en el período definido como «time threshold» o «umbral de tiempo» en la alerta.
Último contacto: Muestra la fecha y hora en que se recibieron los últimos datos del agente, utilizando una barra de progreso, de acuerdo con el valor del intervalo. Si se muestra la imagen 
, el agente no ha enviado datos al finalizar el intervalo. Si pasamos el ratón encima de la imagen, se mostrará el último contacto en formato de fecha y hora.
Nota: El icono 
sólo es visible si es usuario es administrador y es un enlace a la opción «Gestionar agentes» > «Actualizar agente» del menú de administración.
Al acceder a un agente concreto, pinchando en el nombre del agente, se ven todos los datos relacionados con dicho agente.
Informa sobre los datos facilitados al crear el agente y el número de paquetes totales que ha enviado el agente.
Descripción de todos los módulos monitorizados por el agente.
En la lista, los módulos aparecen ordenados con las siguientes columnas:
Nombre de módulo: Nombre asignado al módulo en el archivo de configuración del agente.
Tipo de módulo: Tipo de módulo, según los valores definidos en el punto 3.2.1.
Descripción: Descripción del módulo configurado en el archivo de configuración del agente.
Datos: Último dato enviado por el agente.
Gráfico: A partir de los datos envidados por el agente a lo largo del tiempo se generan una serie de gráficas mensuales, semanales, diarias y horarias (M, W, D y H, respectivamente).
En la parte izquierda de la gráfica se sitúan los datos más nuevos, mientras que en la parte derecha están los datos más antiguos.
Las gráficas que se generan son:
- Gráfico horario (
) con un rango total de 60 minutos
- Gráfico diario (
) con un rango total de 24 horas
- Gráfico semanal (
) con un rango total de 7 días
- Gráfico mensual (
) con un rango total de 30 días
Datos: Son, en bruto, los datos enviados por el agente:
- 
El último mes
- 
La última semana
- 
El último día
Descripción de todos los monitores definidos en el agente
En la lista, los monitores aparecen ordenados con las siguientes columnas:
Agente; Agente donde está definido el monitor.
Tipo: Tipo de dato del monitor. Al ser un monitor esté será siempre de tipo.
Nombre del módulo: Nombre definido al crear el módulo.
Descripción: Descripción del módulo configurado en el archivo de configuración del agente.
Estado: Aparece el estado del agente mediante los siguientes iconos:
Cuando el monitor está correcto
Cuando el monitor falla
Último contacto: Aparece la fecha y hora en que se recibieron los últimos datos del agente.
Nos muestra la descripción de todas las alarmas definidas en el agente.
En la lista, los monitores aparecen ordenados con las siguientes columnas:
ID: Agente donde está definida la alerta.
Tipo: Tipo de la alerta.
Descripción: Descripción de la alerta definida cuando se creó.
Lanzada por último vez: Última vez que se ejecutó la alerta.
Número de veces lanzada: Número de veces que se ha lanzado la alerta.
Estado: Muestra si se han enviado alertas mediante los siguientes iconos:
Cuando no se ha enviado ninguna alerta
Cuando se ha enviado al menos una alerta
Desde «Ver agentes» > «Detalle de grupos» en el menú de operación se accede a los grupos configurados en Pandora. Desde aquí se ve rápidamente el estado en que están cada uno de los grupos simplemente con una rápida mirada, gracias a un sistema de bombillas de distintos colores.
En la lista, los monitores aparecen ordenados con las siguientes columnas:
Grupos: Nombre del grupo.
Agente: Número de agentes configurados en el grupo.
Monitores: Número de monitores configurados en el grupo.
Estado: Estado del agente, mediante los siguientes iconos:
Aparece cuando todos los monitores están correctos.
Aparece cuando al menos un monitor tiene algún fallo.
Aparece cuando al menos un monitor está caído o no hay contacto.
Aparece cuando el agente no tiene ningún monitor definido.
Ok: Número de monitores que están correctos.
Fallo: Número de monitores que tienen algún fallo
Caídos: Número de monitores que están caídos.
Desde «Ver agentes» > «Detalle monitores» en el menú de operación, se puede ver la descripción de todos los monitores definidos en el servidor (un monitor es un módulo de tipo proc).
En la lista, los monitores aparecen ordenados de forma similar a la vista individual de cada agente, excepto que ahora aparecen todas juntas, esto permite un análisis más pormenorizado de cada monitor.
Desde «Ver agentes» > «Detalle alertas» en el menú de operación, se puede ver la descripción de todas las alarmas definidas en el servidor.
En la lista, las alertas aparecen ordenadas de forma similar a la vista individual de cada agente, excepto que ahora aparecen todas juntas, esto permite un análisis más pormenorizado de cada alerta.
Desde «Ver agentes» > «Exportar Datos» en el menú de operación, se puede acceder a una herramienta que permite exportar datos de un agente.
Se puede configurar el agente desde el que se van a exportar los datos, los módulos dentro de dicho agente y el rango de fechas del que exportaremos los datos.
Estos datos pueden exportarse ordenados en tres columnas:
Módulo: Nombre del módulo.
Datos: Información obtenida por el módulo.
Timestamp: Fecha y hora en que el agente remoto de Pandora emitió el paquete.
Si se selecciona el formato CVS se obtendrán los datos separados por comas, para poder exportar a un fichero de texto.
Desde «Ver agentes» > «Estadísticas» en el menú de operación se accede a dos tipos de estadísticas gráficas de los agentes:
Pandora es un proyecto de software libre con licencia GPL.
© Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Raúl Mateos 2004-2006.