Pandora: QuickGuides ES: Guia Rapida General

From Pandora FMS Wiki
Jump to: navigation, search

1 Introducción a esta guía

El propósito de esta guía es introducir en Pandora FMS de forma rápida y concisa a alguien que no está familiarizado con la herramienta, pero que tiene un conocimiento medio/alto de redes y sistemas. La finalidad no es hacer un recorrido de todas las funcionalidades de Pandora FMS, sino que solo se hablará de aquellas más relevantes de forma que un usuario que recorra toda la guía pueda ejecutar tareas básicas de administración y operación en tiempo récord. Debemos tener en cuenta que los cursos oficiales de certificación de Pandora FMS duran 40 horas, y que la documentación oficial se extiende más allá de las 1200 páginas. Con esta guía pretendemos tender un puente para que la entrada en Pandora FMS no sea tan complicada.

2 Instalación

Utilizaremos el CD Appliance de Pandora FMS ya que es el método más rápido y fácil para usuarios intermedios. Para más información sobre métodos alternativos de instalación, podremos consultar el capítulo Instalación de Pandora FMS.

El CD de instalación se basa en Linux CentOS 7, y contiene pre-instalado todos los componentes y dependencias necesarias para que Pandora FMS funcione. Deberemos disponer de una máquina con unos requisitos mínimos de hardware, un mínimo de 2GB de RAM y 20GB de disco. También se puede instalar la ISO en un Pendrive USB, con algunas diferencias menores en el proceso de instalación.

Info.png

Cuantos más sistemas queramos monitorizar, más recursos (CPU, memoria, velocidad del disco) tendremos que asignar al servidor de Pandora FMS

 


2.1 Instalación de la ISO con un pendrive USB

Puede instalar el appliance de Pandora FMS desde un pendrive USB. Para ello:

  • Descargue la imagen ISO de Pandora FMS desde la sección de descargas.
  • Descargue el programa rufus para preparar su pendrive para la instalación (https://rufus.akeo.ie/)
  • Inserte el pendrive.
  • Inicie el programa rufus.

Usb installation 1.PNG

  • Seleccione la imagen ISO de Pandora FMS.

Usb installation 2.PNG

  • Presione START para iniciar la creación del USB de instalación de Pandora FMS

Usb installation 3.PNG

Usb installation 4.PNG

  • Su dispositivo USB de instalación de Pandora FMS está listo

Usb installation 5.PNG

  • Conecte el lápiz USB en la máquina donde desea instalar Pandora FMS.
  • Al iniciar su sistema, configure la BIOS para iniciar primero desde USB.

Debería ver la siguiente pantalla:

Usb installation 6.PNG

Seleccione "Installing from USB stick" y continúe la instalación como se indica en el capítulo siguiente.

2.2 Instalación desde el CD Appliance

Descargaremos la imagen de CD desde la sección de descargas y grabamos la ISO en un DVD o también podemos arrancar el sistema desde ese fichero si lo estamos haciendo desde un sistema de virtualización (XenServer, VMware, VirtualBox, etc). Disponemos de imágenes de CD de 32 y de 64 bits.

Nos aparece esta pantalla al inicio del arranque. Si no pulsamos ninguna tecla, se iniciará en 60 segundos el Live CD, o podemos pulsar cualquier tecla, seleccionar la opción “Install Pandora FMS” y pulsar la tecla enter para comenzar la instalación.

Install 1.png

El instalador gráfico nos guiará paso a paso por todo el proceso de instalación. Este instalador está en varios idiomas y sigue un proceso de instalación estándar usado por CentOS. Es un proceso muy sencillo, las dos secciones donde debemos prestar especial atención es cuando nos pregunta por la password de superusuario (root) y cuando nos pregunta acerca del particionado:

Install 2.png]
Seleccionamos el idioma de preferencia


Install 3.png

Seleccionamos y configuramos las opciones solicitadas," Fecha y Hora", " Teclado" y el "Destino de la Instalación". Recordemos activar el dispositivo de red, si no tendremos que configurar manualmente cuando el sistema esté instalado.

Install 4.png Install 5.png
Activamos la interfaz de red y opcionalmente podemos cambiar el hostname


Al hacer clic en destino de la instalación, comenzaremos con el particionamiento del disco.

Install 6.png
Seleccionamos el disco donde vamos a instalar, y hacemos clic en Listo. Install 7.png

Escogemos el particionamiento. Salvo que tengamos conocimientos avanzados, utilizaremos la opción "Haga clic para crearlos automaticamente".


Install 8.png
Verificar las particiones creadas y hacer clic en Listo.
Install 9.png
Hacer clic en Aceptar cambios.
Install 10.png
Clic en Empezar instalación.
Install 11.png
Aquí podemos asignar la contraseña de root y opcionalmente la creación de usuario.

Ahora tenemos que esperar hasta que termine la instalación y el sistema se reinicie.

2.3 Primeros pasos

Una vez instalado, el sistema debería arrancar y tras unos segundos, mostrar el terminal donde podemos logearnos:

F step 1.png

El primer paso debería ser conocer la IP que el sistema nos ha asignado para poder conectarnos al servidor desde fuera. Para ello, en el terminal escribiremos el comando:

ifconfig 

F step 2.png

Aquí podemos ver un ejemplo. En el caso de esta captura de pantalla, la IP del sistema es 192.168.70.121

Si el sistema ha arrancado y tomado una IP de nuestra red vía DHCP, aparecerá en la lista. Si queremos establecer una IP fija para este sistema, podemos hacerlo a través del comando nmtui el cual muestra una interfaz gráfica para hacerlo.

F step 3.png

Una vez que conocemos la IP del sistema de Pandora FMS, ya podemos acceder a él desde fuera de la máquina virtual, que es siempre más cómodo. Podemos hacerlo vía SSH o vía HTTP. Recordemos que la password de root (superusuario) se estableció en la configuración.

Después abriremos un navegador y escribiremos en él la siguiente dirección compuesta por la IP que hemos obtenido en el servidor:


http://x.x.x.x/pandora_console

En nuestro ejemplo anterior sería http://192.168.70.121/pandora_console, pero tenemos que obtener la IP de nuestro sistema correctamente para poder continuar. Si todo es correcto deberíamos acceder a la pantalla de bienvenida de la consola de Pandora, similar a esta:

F step 4.png

Info.png

Utilizaremos las credenciales por defecto: usuario admin y password pandora

 


Una vez llegado a este punto, ya tenemos una instalación completa de Pandora FMS lista para empezar a usarla.

2.4 Activación de la licencia Enterprise

Template warning.png

Esta sección es solo para usuarios de la versión Enterprise. Podemos ignorarlo si estamos utilizando la versión Open Source

 


Info.png

Es muy importante que no se arranque el demonio pandora_server con la versión Enterprise del mismo instalada, sin haber habilitado antes la versión Enterprise de la consola, ya que se producirán errores.

 


Una vez que hayamos accedido a Pandora a través del navegador, nos pedirá introducir una licencia válida:



Enterprise 1.png



Hacemos clic en Request new licence y procederemos al siguiente paso. En este paso debemos rellenar la información de contacto y el Auth key que el departamento comercial nos haya enviado, tratandose de una versión Enterprise.

Procederemos al siguiente paso haciendo clic en Online validation Enterprise 2.png

Una vez realizado este paso, nos saldrá automáticamente la licencia lista para validar.

Finalmente hacemos clic en Validate.
Enterprise 4.png



Finalizados todos los pasos, ya tenemos la consola lista para ser usada.

2.5 Arrancar el servidor Enterprise

Template warning.png

Esta sección es para usuarios de la versión Enterprise. Podemos ignorarlo si estamos utilizando la versión Open Source

 


Tras activar la licencia, el servidor Enterprise debe arrancarse. En nuestro servidor de Pandora, abriremos una terminal a través de Applications -> System Tools -> Terminal, y escribiremos:

sudo /etc/init.d/pandora_server start

Para verificar su correcto funcionamiento, accederemos a Pandora a través del navegador e iremos a Manage servers. Deberíamos ver algo como lo siguiente:



Pandora servers.PNG



3 Detectando sistemas en nuestra red

Para empezar con Pandora FMS, nada mejor que detectar qué dispositivos hay cerca y empezarlos a monitorizar. Es indiferente si son PCs con Windows, servidores con Linux o router/switches, ya que vamos a hacer una monitorización muy básica (ver si responden a un ping). Luego, podremos mejorar la monitorización una vez los tengamos detectados.

3.1 Creando una tarea de reconocimiento

Vamos a seguir los siguientes pasos. En el menú lateral iremos a la sección de Servers -> "Tarea de reconocimiento" (Servers -> Recon Task) tal como se muestra en la imagen, y una vez dentro, haremos clic en el botón Crear nueva tarea de reconocimiento.



Guiarapida recon1.png

Crearemos la tarea tal como sigue:



Guiarapida recon2.png

Tendremos que modificar únicamente el rango de red a explorar, en esta captura es 192.168.70.0/24, que significa que todos los hosts de la red 192.168.70.xx serán explorados. Utilizaremos aquí la máscara apropiada para definir nuestra red.

Se ha seleccionado la plantilla de red (module template) "Basic monitoring" que cubre únicamente chequeos de latencia y disponibilidad de red. Se ha seleccionado el grupo "Network", que se usará para contener los dispositivos que detecte. A partir de ahora llamaremos de forma genérica "agentes" a los dispositivos gestionados y/o monitorizados por Pandora FMS.

Una vez creado, nos mostrará la entrada, y haremos clic en el icono de la lupa para ver los detalles de la tarea, tal como se muestra en la imagen:



Guiarapida viewrecon.png

Al hacer clic en el icono de la lupa, nos mostrará el estado actual de la tarea, que debería ser de ejecución de la tarea. En esta imagen vemos cómo la barra de progreso esta avanzada y el sistema está en ese momento buscando sistemas en la red para añadirlos a la monitorización.



Guiarapida reconexec.png

3.2 Revisando los sistemas detectados

En este punto es mejor que esperemos a que toda la red haya sido detectada. Pulse en la pestaña de actualizar Refreshtab.png. Cuando hayamos terminado, accederemos a la vista de detalle de agentes para ver todos los sistemas detectados. Menú "Monitoring" > "Views" > " "Agent detail", tal como se ve en la imagen:



Guiarapida monitoringagentdetail.png

En este punto, podemos ver varios sistemas que han sido correctamente detectados por Pandora FMS. En algunos casos se habrá resuelto el nombre del sistema (si por DNS era posible) y en otros, habrá detectado el Sistema Operativo. Al hacer clic en el nombre (en este caso, el primero de nuestra captura), iremos a la vista de detalle del agente, que nos mostrará toda la información de ese sistema.



Guiarapida agentdetailedview.png

4 Añadir un chequeo remoto sobre un sistema ya monitorizado

Ahora que ya tenemos nuestros sistemas detectados, vamos a agregar algunos módulos de monitorización. Vamos a añadir la siguiente monitorización:

  • Tráfico de red en una interfaz.
  • Pérdida de paquetes en la red.
  • Ver si un servicio está respondiendo por la red a través de un puerto TCP.
  • Comprobar una página web.

4.1 Tráfico de red en interfaz

Para ello es imprescindible que el SNMP esté configurado en el dispositivo remoto. Esto generalmente necesita activarse, y una configuración mínima que nos permita consultar datos. Los dispositivos SNMP permiten configurar las IP que pueden hacer consultas y con qué comunidad que a todos los efectos, es una especie de password.

Primero localizaremos el agente de donde queremos obtener el tráfico de red, en nuestro caso es 192.168.70.1. Siguiendo el mismo proceso (Monitoring > Views > Agent detail) llegaremos a la vista principal del agente que queremos configurar y haremos clic en la ultima pestaña de la derecha, que nos llevará a la vista de edición de ese agente.



Guiarapida agentedit.png

Pasaremos a la vista principal de edición del agente. Aquí mostraremos el submenú de "Wizards" de configuración para este agente, escogeremos el Wizard de Interface SNMP, tal como se aprecia en la siguiente captura de pantalla:



Guiarapida snmpinterfacewizard.png

Llegados a este punto deberemos proporcionar la comunidad SNMP que tenemos configurada en el equipo, y cerciorarnos de que el dispositivo soporta consultas SNMP habilitadas en la IP que nos muestra la pantalla. Podemos cambiar la IP y la comunidad SNMP por defecto, que es public (en nuestro caso de ejemplo es diferente, es 'artica06'). Una vez lo tengamos relleno, le daremos al botón "SNMP Walk". Si todo va bien, nos mostrará las interfaces y los datos que podemos obtener de ellas.



Guiarapida snmpinterfacewizard2.png

Con Ctrl+Clic (o CMD+Clic en Mac) podemos seleccionar varios elementos en ambas cajas, tal como se muestra en la captura. Recomendamos siempre monitorizar el tráfico de Salida (ifOutOctets), el tráfico de Entrada (ifInOctets) y el estado del la intefaz (ifOperStatus) por cada interfaz. En el caso de este ejemplo, eth1, eth2 y eth3.

Pulsamos el botón "Create modules" y una pantalla debe informarnos de que los módulos se han creado.

Hay que tener en cuenta que los módulos de tráfico de red son de tipo incremental, es decir, que su valor es la diferencia entre la muestra de información que acabamos de recoger y la anterior. Nos muestra una "tasa" (en este caso en bytes/sec), de forma que necesita un tiempo (entre 5 y 10 minutos) antes de mostrarnos nada.



Guiarapida opermode.png

Haremos clic en la pestaña "View" para volver a la vista del agente y esperaremos 5 minutos hasta que ya tengamos datos de tráfico, actualizando o haciendo clic en la pestaña "View". Después de un tiempo, deberíamos tener una pantalla similar a esta, donde ya tenemos datos de los módulos de tráfico (entrada y salida, por separado) y una nueva sección en el agente, que nos muestra información de las interfaces con un acceso directo a una gráfica agregada con el tráfico de salida y entrada superpuesto (si hacemos clic en el título donde dice "Interface information (SNMP)").



Guiarapida interfaceinfo.png

Si no queremos esperar más o queremos "forzar" la ejecución de los módulos de red, podemos utilizar el icono de forzar chequeo remoto (no funcionará con los módulos locales, o recogidos en local por un agente software). En función de la carga de nuestro servidor, puede tardar entre 2 y 15 segundos en ejecutar la prueba de red.



Guiarapida forcenet.png

La información de los módulos de tráfico se verá de esta manera, y las gráficas para cada métrica, pulsando en el icono de gráfica Chart curve.png mostrará una ventana con la gráfica de ese monitor y al pulsar en el icono de datos Binary.png, una tabla con los datos.



Guiarapida moduledata.png

4.2 Pérdida de paquetes en la red

Queremos agregar un plugin remoto pre configurado en Pandora FMS. Los plugins remotos son chequeos definidos por el usuario que emplean un script o un programa que se ha desplegado en el servidor de Pandora FMS, de forma que este pueda utilizarlo para monitorizar, ampliando el conjunto de cosas que puede hacer.

Vamos a usar un plugin de serie, para ello, iremos a la vista de edición del agente y luego a la solapa de configuración de módulos.



Guiarapida moduleeditor1.png

Escogeremos un módulo de tipo plugin y le daremos al botón de "crear", que nos llevará a la interfaz de configuración de módulos de tipo "Plugin remoto".



Guiarapida moduleeditor2.png

Escogeremos el plugin "Package loss" utilizando los desplegables, y finalmente pondremos la IP sobre la que queremos lanzar el chequeo. El resto de campos los dejaremos como están.



Guiarapida moduleeditor3.png

Haremos clic en el botón "Crear" y volveremos a la vista de operación, como en el caso anterior. Actualizaremos un par de veces la pantalla, hasta que el nuevo módulo aparezca en la lista:



Guiarapida packetloss.png

Este es un plugin muy interesante, que usado en conjunción con el de conectividad básica (ping) y el tiempo de latencia, nos sirve para determinar la calidad de nuestra red, ya que nos indica el porcentaje de pérdida de paquetes, tomando muestras cada 5 minutos.

4.3 Monitorizar un servicio de red TCP

En este caso, vamos a añadir una monitorización para verificar que un servicio SMTP (Correo) está activo en una máquina. Aunque puede ser un chequeo muy complejo (simulando que enviamos credenciales de usuario y password, que enviamos un correo, etc) vamos a simplificarlo verificando únicamente que el puerto está abierto y responde.

Para ello repetiremos los mismos pasos iniciales del ejemplo anterior, pero esta vez escogeremos "Módulo de red" (Network module)


Guiarapida networkmodule.png


Luego utilizaremos los controles desplegables hasta encontrar nuestro chequeo (Check SMTP Server) y haremos clic para crear el módulo.



Guiarapida networkmodule2.png



Finalmente volveremos a repetir los pasos (ir a la vista de operación, y actualizar hasta que aparezca el monitor) de manera que el resultado final será algo similar a esto:



Guiarapida networkmodule3.png



4.4 Comprobar una página web

En la versión Enterprise de Pandora FMS existe la posibilidad de realizar chequeos sintéticos WEB, es decir, enviando datos, manteniendo la sesión, y verificando paso a paso, que una secuencia de pasos lógicos se van dando, necesario para validar una transacción completa.

En este caso vamos a realizar algo más sencillo, posible en la versión Open Source de Pandora FMS, vamos a conectarnos a una WEB y verificar que devuelve un código específico. En este caso vamos a conectarnos a la página de la librería de módulos de Pandora FMS en su versión en inglés (http://pandorafms.com/Library/repository/en) y verificar que la cadena de texto "Main categories" se devuelve en la salida (ver imagen):



Guiarapida webmonitor2.png



Para ello, crearemos un chequeo de red, similar al caso anterior. En este caso usaremos la plantilla genérica "Check HTTP" y modificaremos algunos campos avanzados, tal como se puede ver en esta captura:



Guiarapida webmonitor.png



Los caracteres ^M se escriben tal cual, y representan un retorno de carro. Para el protocolo HTTP es necesario pasarle dos retornos de carro después de la petición.

El resultado final debe ser un chequeo que devuelve OK, tal como este:



Guiarapida webmonitor3.png



5 Añadir una alerta (envío de email) ante un problema

En Pandora FMS, la forma más básica de alertas es asignar una alerta a un módulo específico. Se pueden hacer cosas más avanzadas (alertas sobre eventos, correlación, etc.) pero no entra dentro de esta guía. Nuestra primera alerta va a consistir simplemente en enviar un email cuando se caiga una de las máquinas que ya estamos monitorizando (con el módulo Host alive).

Las alertas en Pandora FMS están compuestas por tres elementos: Comando, Acción y Plantilla. En este caso concreto vamos a utilizar un comando predefinido (envío de emails), vamos a modificar una acción que ya existe (Mail to XXX) y vamos a utilizar una plantilla que también existe ya, la plantilla Critical condition, que nos ejecutará la alerta cuando el módulo en cuestión aparezca en estado crítico.

5.1 Configuración del Servidor

Para el correcto funcionamiento del comando email, debemos configurar en el fichero pandora_server.conf, un servidor de correo que permita hacer relay. En el ejemplo, el servidor de correo situado en 192.168.50.2 tiene habilitada esta función. Deberemos poner la IP de nuestro servidor de correo local, o uno en Internet (configurando para ello la autenticación). Para modificar el fichero de configuración del servidor, debemos acceder a él mediante una shell o terminal que podemos abrir desde:



Guiarapida mailconf01.png

Una vez abierta la shell, debemos abrir el fichero de configuración del servidor situado en /etc/pandora/pandora_server.conf como usuario root, por lo que antes de hacerlo debemos hacernos root con sudo su:



Guiarapida mailconf02.png

Buscamos las líneas que observamos en la captura de abajo y las configuramos como aparecen en pantalla. En este caso recordamos que el servidor de correo se encuentra situado en 192.168.50.2. Si no disponemos de un servidor de correo, podemos usar por ejemplo una cuenta de gmail. Podemos ver una guía rápida de como configurar el servidor de Pandora FMS para que funcione con una cuenta de gmail en el siguiente enlace: http://wiki.pandorafms.com/index.php?title=Pandora:Configuracion_alertas_emails

Las líneas que comienzan con el caracter # son comentarios y no son tenidos en cuenta por el servidor.



Guiarapida mailconf03.png

Una vez realizados los cambios pulsamos Ctrl+X para salir, y confirmamos guardar los cambios:



Guiarapida mailconf04.png

Tras quedar guardados los cambios reiniciamos pandora_server:

service pandora_server restart

5.2 Configuración de la Alerta

Como se comentaba anteriormente, las alertas en Pandora FMS se componen de 3 partes: Comando, Acción y Plantilla. Podremos encontrar estas opciones en la sección Alerts.



Guiarapida mailconf8.png

Para poder configurar esta alerta solo necesitamos modificar la acción. La acción que usaremos es Mail to XXX. En este caso, si tenemos que modificar la dirección de email que queremos usar ([email protected]), podríamos alterar "Mail to XXX" para que ponga "Mail to [email protected]" y así identificar bien qué acción estamos ejecutando.

Modificaremos el campo 1 y pondremos la dirección email de destino.

En el campo 2, dejaremos el texto que hay en la captura. Aquí se están usando dos macros que reemplazarán en tiempo de ejecución el nombre del agente y el módulo que ha generado la alerta.



Guiarapida mailconf13.png

Seleccionamos la Acción Mail to XXX y editamos la dirección de correo electrónico ([email protected]).



Guiarapida mailconf1.png

5.3 Asignar alerta al módulo

Navegamos hasta la edición del agente donde tengamos el módulo definido y pinchamos sobre la pestaña de alertas:



Guiarapida mailconf5.png

Ahora añadimos el módulo (Host Alive), la plantilla (Critical Condition) y la acción ( Mail to XXX ). Añadimos la alerta.



Guiarapida mailconf4.png

Una vez añadida la podremos observar en la vista del agente comprobando si se esta ejecutando o no, viendo el color de su estado:



Guiarapida mailconf6.png

Podemos esperar (o forzar) a que se caiga el host para ver si la alerta funciona, o bien podemos "forzar la alerta" para ver si efectivamente llega el correo. Haremos click en el icono de forzar (ver imagen):



Guiarapida forcealert.png

Finalmente, un correo con la alerta debería llegar al buzón de correo. Al ser una alerta "forzada" en el campo datos pone N/A. En un caso real pondría el valor real del módulo.



Guiarapida mail.png

Las alertas de Pandora FMS son extremadamente flexibles, y por tanto, en ocasiones, complejas de emplear. Existe un capítulo de la documentación específicamente para ellas: Alertas en Pandora FMS

6 Monitorizar un servidor Windows con un agente software

En Pandora FMS existen dos tipos de monitorización: remota (la que se realiza desde el servidor de Pandora FMS a los diferentes dispositivos), y local (se instala un agente software en cada una de las máquinas a monitorizar y este se encarga de extraer la información y enviársela al servidor de Pandora FMS).

En este punto vamos a tratar la instalación de un agente software en un equipo Windows y la monitorización básica del mismo.

6.1 Instalación del Agente

El primer paso es descargar el agente de Windows. Lo podemos descargar desde:

http://sourceforge.net/projects/pandora/files/Pandora%20FMS%205.1/SP2Final/Windows/

En este enlace podemos elegir entre el agente de 32 bits o de 64 bits.

Una vez descargado el agente, lo ejecutamos haciendo doble-clic sobre él y nos aparecerá la pantalla de selección de idioma:



Pandora agent 3.0 RC3 install windows 01.png



Es un instalador estándar de Windows que nos pedirá seguir los pasos, aceptamos la licencia y avanzamos por las diferentes ventanas del instalador. Seleccionamos la ruta donde se instalará el agente de Pandora FMS (por defecto se instala en C:/Program Files/pandora_agent), puede cambiarse pulsando Browse..., una vez indicada correctamente pulsamos Next:



Pandora agent 3.0 RC3 install windows 04.png



Esperamos a que se copien los ficheros. Configuramos la dirección IP (o nombre) del servidor de Pandora FMS que recibirá los datos del agente y el grupo al que queremos que se asocie el agente.



Pandora agent 3.0 RC3 install windows 07.png



En la siguiente ventana nos aparece la opción de habilitar la configuración remota. Es importante tenerla activada mediante un 1 si queremos tener una copia del agente en el servidor de Pandora FMS y desde ahí poder añadir, editar y borrar módulos locales directamente desde el agente.



Pandora agent config remoto.png



Decidimos si queremos iniciar el servicio del agente al final de la instalación del agente de Pandora FMS, de lo contrario tendrá que hacerlo de forma manual, o bien se iniciará cuando Windows se reinicie de nuevo.



Pandora agent 3.0 RC3 install windows 08.png



Una vez terminado este proceso ya se queda instalado y corriendo el agente de Windows en el equipo.

6.2 Comprobación de la información que devuelve el agente

Una vez arrancado el agente de Windows tras su instalación, es hora de comprobar qué está reportando este agente. Para ello, debemos conocer el nombre con el que va a reportar este agente. Por defecto se crea el agente con el nombre del host. Podríamos ver el nombre del host de Windows con la ejecución del comando hostname en un cmd.exe.



Guia rapida windows1.png



Una vez sabemos el nombre del agente, el siguiente paso es ver si se ha creado en Pandora FMS. Para ello tenemos varias opciones. La primera de ellas es buscar en detalles del agente, dentro del grupo en el que se ha creado el agente, en nuestro ejemplo el grupo "Servers".



Guia rapida windows2.png



Una forma más rápida y eficaz de encontrar el agente, es realizando la búsqueda directamente a través del buscador de Pandora FMS, indicando el nombre del agente.



Guia rapida windows3.png



Aquí nos aparecerá el agente y pinchando en él accedemos a la información que está reportando.



Guia rapida windows4.png



Por defecto el agente de Windows viene con varios módulos locales pre-cargados, de monitorización básica, como son carga de CPU (CPU Load), % de memoria RAM libre (FreeMemory), espacio libre en MB de los discos, estado DHCP (DHCP Enabled) y número de procesos (Number processes).



Guia rapida windows5.png



Si necesitamos añadir nuevos módulos a este agente, podemos consultar la documentación avanzada de monitorización con agentes software.

Podemos ver gráficas generadas con el histórico de datos del módulo y una tabla con el histórico de los mismos desde esta vista pinchando en los iconos marcados en la siguiente captura:



Guia rapida windows6.png



7 Crear una pantalla visual con detalles de mi monitorización

Una de las opciones de visualización que nos ofrece Pandora FMS es la posibilidad de crear Consolas Visuales. La Consola Visual permite representar la información de monitorización, en tiempo real de una forma totalmente gráfica. Es este ejemplo de Consola Visual, vamos a crear un ejemplo de una red distribuida por todo el mundo y cómo al pinchar en el nodo que aparece sobre España, podemos ver otro mapa de España con otros elementos propios de la instalación de España.

La potencia de los mapas es que permite "resumir" el estado de un mapa hijo en la visualización del mapa padre, es decir, si alguno de los elementos visualizados en el mapa de España se pone en estado crítico, el icono que representa España se pondrá en rojo. Esto permite establecer jerarquías muy personalizadas a la hora de mostrar información. Los mapas pueden contener información de estado de grupos, agentes, módulos. Además pueden incluirse gráficas y datos (numéricos o de texto), además de etiquetas de texto e iconos.

7.1 Creación de mapa 1 (Padre)

En este primer mapa vamos a añadir el estado de varios agentes distribuido en un mapa mundial. Se puede realizar de forma manual uno a uno, o mediante el Wizard. Para facilitar la creación del mismo vamos a utilizar el Wizard en el ejemplo.

Lo primero que tenemos que hacer es crear un nuevo mapa, que llamaremos World Map.



Guia rapida consvisual1.png



Guia rapida consvisual2.png



Una vez creado pinchamos sobre el Wizard de elementos:


Guia rapida consvisual3.png



En el Wizard seleccionamos el tipo de elemento, en este ejemplo Static Graph, la imagen que queremos usar, si queremos usar un item por agente o por módulo (en nuestro caso por agente), y seleccionamos los agentes que vamos a añadir dentro del listado que aparece.



Guia rapida consvisual4.png



Pinchamos sobre el botón añadir y aparecerán en el mapa todos los elementos creados, tal y como vemos en la siguiente captura.



Guia rapida consvisual5.png



Movemos todos los elementos como los queramos tener posicionados en el mapa, pinchando y arrastrándolos sobre el mismo.



Guia rapida consvisual6.png



7.2 Creación de mapa 2 (Mapa hijo)

En el segundo mapa se va a crear un elemento que nos indica el estado de uno de los agentes principales, unidos a él todos los módulos dados. Visualizaremos en este mapa también una gráfica del módulo FreeRAM del mismo agente.

El primer paso es crear el nuevo mapa tal y como hicimos la vez anterior:



Guia rapida spain1.png



Una vez creado, añadimos el elemento que nos muestra el estado del agente en la sección Static Graph, tal y como aparece en la imagen adjunta:



Guia rapida spain2.png



Creamos también la gráfica con la configuración adjunta, pinchando en el icono de gráficas, añadiendo el agente y módulo del que vamos a ver reflejada la gráfica.



Guia rapida spain3.png



Ya tenemos creado el elemento principal del mapa, ahora vamos a crear un elemento nuevo por cada uno de los módulos que existen en el agente. Para ello, vamos a usar el Wizard realizando su configuración tal y como vemos en la captura adjunta. Seleccionamos Static Graph del agente y los módulos que indicamos. Le ponemos como etiqueta el nombre del módulo y le asignamos a este item un parent previamente creado en el Mapa Visual, en este caso el elemento anterior que hemos añadido.



Guia rapida spain4.png



Tras crear todos estos elementos, nos aparecerán unidos al elemento principal y los podemos mover arrastrándolos directamente con el ratón en la posición que queramos.



Guia rapida spain5.png



7.3 Linkado de ambos mapas

En los pasos anteriores creamos los dos mapas. En este paso vamos a indicar cómo al pinchar en el elemento situado sobre España en el mapa "World Map", se nos abre directamente el mapa "Spain Map".

Para ello abrimos el mapa World Map, en el modo edición, haciendo doble-clic sobre el elemento 192.168.70.70. Se nos abrirá la edición del elemento, pinchamos sobre opciones avanzadas y en la opción Linked Map, seleccionamos el Spain Map. Actualizamos el elemento.



Guia rapida link1.png



Al volver sobre la vista del mapa World Map, hacemos clic en el elemento situado sobre España y directamente se nos abrirá el mapa de España. Con que en el mapa de España hubiera un solo elemento en rojo, el icono que representa a España en el mapa padre, también se vería en rojo.



Guia rapida link2.png





Guia rapida spain5.png



8 Ajustar mi monitorización (umbrales, unidades, otros)

En este apartado veremos como configurar algunas de las opciones avanzadas de un módulo.


Navegamos hasta la vista de los módulos del agente.


ModuloU.png

Seleccionamos el módulo deseado a configurar.

ModuloseleccionadoU.png

Posteriormente abrimos la pestaña de "Avanced Options" y procedemos a configurar los campos deseados.


Advanced.png


En los dos siguientes apartados veremos como configurar los campos "Unit" e "Interval" y los umbrales "Warning Status" y "Critical Status".

8.1 Configuración de las unidades de un módulo

Permite definir las unidades del dato obtenido en un módulo. Esta unidad se incluirá en gráficas e informes, de forma que sea más fácil interpretar los datos que se muestran al usuario.

En nuestro ejemplo, el módulo IOWaitCPU queremos que tenga como unidad "ticks/sec". Nos situamos dentro del campo "Unit" y escribimos la unidad deseada.



UnitU.png

Finalmente, hacemos click en el botón "Update" y comprobamos que se muestra correctamente nuestra unidad en la vista de los módulos.



VistaunidadU.png

8.2 Configuración del intervalo de un módulo

Configurando/modificando el intervalo del módulo, definiremos cada cuánto queremos que se ejecute dicho módulo. Esto afecta a módulos remotos (no que se ejecuten en local), ya que los módulos locales se configuran de una manera algo más compleja. Cuanto más frecuentemente se monitorice un sistema remoto, más carga generará en el sistema.



IntervaloU.png

Hacemos click en el botón "Update" y ya tendremos configurado el módulo.

8.3 Configuración de los umbrales de un módulo

En esta sección configuraremos los umbrales "Warning" y "Critical" para un módulo, que definen qué valores debe tener un módulo para estar en un estado CRITICAL, WARNING o NORMAL. La forma mas fácil de entenderlo es mediante un ejemplo:

En nuestro caso tenemos un módulo de la CPU al que queremos añadirle umbrales. Este módulo siempre estará en estado NORMAL (verde) siempre y cuando esté entre 0% y 100%. Si queremos que este módulo se muestre en estado "Critical" o "Warning" cuando la CPU alcance un % determinado, deberemos configurarlo determinando los umbrales de "Warning Status" y "Critical Status" deseados. En este ejemplo los configuraremos para que cuando la CPU llegue al 60% de uso el módulo se ponga en estado "Warning" y si supera el 80%, se ponga en "Critical".



UmbralesU.png

Después de configurar los umbrales, solo tendremos que pulsar en el botón "Update" y ya tendremos nuestro umbrales correctamente configurados. El próximo dato recibido ya interpretará esos umbrales.

8.3.1 Parámetros avanzados de los umbrales

La casilla "inverse interval" sirve para definir rangos no contiguos. En este ejemplo, el módulo cambiará al estado critical si el valor está por debajo de 20 y/o por encima de 80:



Quickguide inverse1.PNG

En módulos de tipo cadena de texto, el umbral se define como una subcadena. De igual manera, se puede invertir para que el módulo pase a critical si NO contiene la subcadena pasada como parámetro:



Quickguide inverse2.PNG

8.3.2 Otros parámetros avanzados

La configuración de un módulo es muy flexible, con decenas de posibilidades. En la documentación de Pandora podemos descubrir todas ellas.

9 Solución de problemas. Dónde mirar, a quién preguntar

9.1 Ficheros de configuración y fuentes de información de diagnóstico

Los principales ficheros de configuración que podemos necesitar tocar/revisar son los siguientes:

  • /etc/pandora/pandora_server.conf. Fichero de configuración principal del servidor de Pandora FMS. Si tocas algo ahí, tendrás que reiniciar el servidor de Pandora FMS.
  • /etc/pandora/pandora_agent.conf. Fichero de configuración principal del agente software de Pandora FMS en Unix. Si tocas algo ahí, tendrás que reiniciar el agente de Pandora FMS.
  • %PROGRAM_FILES%\pandora_agent\pandora_agent.conf. Fichero de configuración principal del agente software de Pandora FMS en Windows. Si tocas algo ahí, tendrás que reiniciar el servicio agente de Pandora FMS.
  • /etc/my.cnf. Fichero de configuración principal de MySQL.
  • /var/www/html/pandora_console/include/config.php, fichero de configuración de la consola de Pandora FMS. En la instalación se autoconfigura, pero si ha cambiado algún parámetro de entorno (path, IP, usuario/password de MySQL, host de MySQL) habrá que modificarlo manualmente.

Fuentes de información (logs) donde podemos buscar más información, errores, etc:

  • /var/log/pandora/pandora_server.log. Fichero log del servidor, contiene pistas muy importantes. Si quieres tener mas detalle modifica el parámetro "verbosity" del fichero de configuración del servidor para que muestre más detalle.
  • /var/log/pandora/pandora_server.error. Fichero log de errores no capturados del servidor, contiene trazas de errores no manejados por el servidor, suelen ser cosas algo feas.
  • /var/log/pandora/pandora_agent.log. Fichero log del agente unix.
  • %PROGRAM_FILES%\pandora_agent\pandora_agent.log. Fichero log del agente en windows.
  • /var/www/html/pandora_console/pandora_console.log, fichero log de la consola de pandora.
  • /var/log/httpd/error_log, fichero log de errores del servidor Apache (httpd).
  • /var/log/messages, fichero log del sistema.
  • dmesg, comando que muestra avisos del kernel.
  • /var/log/pandora/pandora_snmptrap.log, log de traps SNMP. Si existe algún error en el arranque de la consola de traps SNMP puede mostrar trazas de error ahí.
  • /var/log/mysqld.log, log de Mysqld.

Por otro lado es interesante saber algunas cosas respecto a los permisos de algunos directorios:

  • /var/spool/pandora/data_in/ debe ser de pandora:apache con permisos 755.
  • /var/log/pandora/ debe ser de pandora:root con permisos 755.
  • /var/www/html/pandora_console/include/config.php debe ser de apache:apache con permisos 600.

9.2 Soporte

El foro está abierto a cualquiera, podemos crear una cuenta y preguntar:

Disponemos de una lista de preguntas frecuentes (FAQ) que pueden darnos una pista o directamente una solución a un problema concreto:

Por supuesto, también tenemos la opción de formación, por medio de los cursos oficiales de Pandora FMS (con certificación); más información en: