Ayuda de Pandora v1.2

3. Agentes

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:

• Ver el estado
• Acceder a la información reportada
• Acceder a cada característica monitorizada y ver su evolución a lo largo del tiempo
• Ver informes gráficos
• Configurar alertas

3.1. Gestión de grupos

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:

• Applications
• Comms
• Databases
• Firewall
• IDS
• Others
• Servers
• Workstations

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.

3.2. Añadir un agente

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:

• Nombre del agente: Tiene que coincidir con el nombre que se ha configurado en la variable «agent name» en el archivo agent.conf que hay en cada agente. En el caso en el que esta variable esté comentada se utilizara el nombre de Host de la máquina donde se está ejecutando el agente (éste se obtiene ejecutando el comando hostname).
• Dirección IP: Muestra la IP del agente, es un dato a título informativo y puede coincidir en varios Agentes.
• Grupo: Define el grupo al que pertenece el agente, dentro de los grupos definidos en Pandora.
• Intervalo: Intervalo de ejecución que tiene el agente. Es el tiempo que pasa desde que se ejecuta.
• SO: Define el Sistema Operativo que se quiere monitorizar dentro de las siguientes opciones: AIX, BeOS, BSD, Cisco, HPUX, GNU/Linux, MacOS, Other, Solaris o Windows.
• Descripción: Breve descripción del agente
• Definición de módulos: Existen dos modos de definir un módulo:

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

• Estado: Define si el agente está activado y listo para enviar datos o si está desactivado. Los agentes desactivados no se ven en las vistas de usuario.

3.2.1. Asignación de módulos

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:

• Tipo de módulo: En este campo se definen el tipo del dato que Pandora va a procesar. Hay 5 tipos de datos:

- 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).

• Nombre del módulo: Define el nombre del módulo.
• Máximo: Define el valor máximo que se aceptara para este dato. Cualquier valor por encima del maximo definido se interpretará como un dato no válido y se descartará el módulo completo.
• Mínimo: Define el valor mínimo que se aceptara para este dato. Cualquier valor por debajo del mínimo definido se interpretará como un dato no válido y se descartará el módulo completo.
• Comentario: Campo para incluir un comentario al módulo.

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:

• borrar un módulo pinchando en el icono
• o editarlo, pinchando en el icono

No será posible modificar el tipo de dato del módulo.

3.2.2. Alertas

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.

3.2.2.1. Creación de alertas

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:

• eMail. Envía un email desde el servidor de Pandora
• Internal audit. Escribe en el log en el sistema de auditoría interna de Pandora
• LogFile. Escribe en el log /var/log/pandora_alert.log.

• SMS Text. Envía un SMS al número móvil elegido
• SNMP Trap. Envía un Trap SNMP
• Syslog. Envía la alerta a un Syslog

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:

• Nombre de la alerta: Un nombre descriptivo para la alerta
• Comando: Comando que ejecutará la alerta
• Descripción: Descripción de la alerta

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 alerta

3.2.2.2. Asignación de alertas

Una 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:

• Tipo de Alerta: Se elige la alerta que se generará dentro de las alertas que hay definidas.
• Valor Mínimo: Define el valor mínimo válido para un módulo. Cualquier valor por debajo de él, disparará la alerta.
• Valor Máximo: Define el valor máximo válido para un módulo. Cualquier valor por encima de él, disparará la alerta.
• Descripción: Describe la función de la alerta, es útil para poder discriminarlo en la vista general de alertas.
• Campo #1 (Alias nombre): Define el valor utilizado para la variable «_field1_».
• Campo #2 (Línea sencilla): Define el valor utilizado para la variable «_field2_».
• Campo #3 (Texto completo): Define el valor utilizado para la variable «_field3_».
• Umbral de tiempo: Tiempo que ha de pasar desde que se dispara una alerta hasta que se puede disparar otra.
• Mínimo Alertas: Define el número mínimo de alertas que se envían de forma continua.
• Máximo Alertas: Define el número máximo de alertas que se envían de forma continua.
• Módulo Asignado: Define el módulo que será monitorizado por la alerta.

Todas las alertas creadas para un agente se pueden ver accediendo al agente, en «Gestión de agentes» desde el menú de administración.

3.2.3. Gestión de módulos y alertas de agentes

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 éstos.

3.3. Monitorización de agentes

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.

3.3.1. Ver agentes

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:

Último contacto: Muestra la fecha y hora en que se recibieron los últimos datos del agente.

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.

3.3.2. Acceso a los datos de un agente concreto

Al acceder a un agente concreto, pinchando en el nombre del agente, se ven todos los datos relacionados con dicho agente.

3.3.2.1. Información general de un agente

Informa sobre los datos facilitados al crear el agente y el número de paquetes totales que ha enviado el agente.

3.3.2.2. Muestra de últimos datos obtenidos

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.

La 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

3.3.2.3. Lista completa de monitores

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.

3.3.2.4. Lista completa de alertas

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

3.3.3. Detalle de grupos

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.

3.3.4. Ver monitores

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.

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.

3.3.5. Detalle de alertas

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.

3.3.6. Exportar datos

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.

3.3.7. Estadísticas

Desde «Ver agentes» > «Estadísticas» en el menú de operación se accede a dos tipos de estadísticas gráficas de los agentes:

• Una gráfica con el número de módulos que tiene configurado cada uno de los agentes.
• Una gráfica con el número de paquetes enviado por cada uno de los agentes, siendo un paquete el conjunto de datos relacionados con los módulos que envía un agente cada intervalo de tiempo.