View source for Pandora: QuickGuides ES: Guia Rapida General

= Introducción =

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.

= Instalación =

Se utilizará 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, Se puede consultar el capítulo [[Pandora:Documentation_es:Instalacion|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 4GB de RAM y 20GB de disco. 

{{Tip|Cuantos más sistemas queramos monitorizar, más recursos (CPU, memoria, velocidad del disco) se deberán de asignar al servidor de Pandora FMS}}

== Instalación desde el CD Appliance ==

Se descargará la imagen de CD desde la sección de descargas y se grabará la ISO en un DVD o también se puede arrancar el sistema desde ese fichero si lo se está realizando desde un sistema de virtualización (XenServer, VMware, VirtualBox, etc). Disponemos de imágenes de CD de 32 y de 64 bits. 

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

<center>
[[image:install_1.png|400px]]
</center>

El instalador gráfico 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 se debe prestar especial atención es cuando se pregunta por la password de superusuario (root) y cuando se pregunta acerca del particionado:

<center>
[[image:install_2.png|500px]]]
<br>
Seleccionamos el idioma de preferencia
</center>
<br>

<center>
[[image:install_3.png|500px]]
</center>

Se seleccionan y configuran las opciones solicitadas," Fecha y Hora", " Teclado" y el "Destino de la Instalación".
Se debe de activar el dispositivo de red, si no se tendrá que configurar manualmente cuando el sistema esté instalado.

<center>
[[image:install_4.png|500px]]
[[image:install_5.png|500px]]
<br>
Se activa la interfaz de red y opcionalmente se puede cambiar el hostname
</center>
<br>

Al hacer clic en destino de la instalación, se comenzará con el particionamiento del disco.
<center>
[[image:particionamiento.png|500px]]
<br>
<center>
[[image:install_6.png|500px]]
<br>
Se selecciona el disco donde vamos a instalar, y se cliquea en Listo. 
[[image:install_7.png|500px]]
<br>
</center>

Se escoge el particionamiento. Salvo que se tenga conocimientos avanzados, se utilizará la opción "Haga clic para crearlos automaticamente".

<center>
<br>
[[image:install_8.png|500px]]
<br>
Se verifican las particiones creadas y hacer clic en Listo.
<br>
[[image:install_9.png|500px]]
<br>
Hacer clic en Aceptar cambios.
<br>
[[image:install_10.png|500px]]
<br>
Clic en Empezar instalación.
<br>
[[image:install_11.png|500px]]
<br>
Aquí Se puede asignar la contraseña de root y opcionalmente la creación de usuario.
</center>

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

== Primeros pasos ==

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

<center>
[[image:F_step_1.png|500px]]
</center>

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

 ifconfig 

<center>
[[image:F_step_2.png|500px]]
</center>

Aquí se puede ver un ejemplo. En el caso de esta captura de pantalla, la IP del sistema es 192.168.70.158

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

<center>
[[image:F_step_3.png|400px]]
</center>

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

Después se abrirá un navegador y se escribirá en él la siguiente dirección compuesta por la IP que se ha obtenido en el servidor:


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

En el ejemplo anterior sería http://192.168.70.158/pandora_console, pero se tiene que obtener la IP del sistema correctamente para poder continuar. Si todo es correcto se accederá a la pantalla de bienvenida de la consola de Pandora, similar a esta:

<center>
[[image:F_step_4.png|400px]]
</center>

{{Tip|Utilizaremos las credenciales por defecto: usuario ''admin'' y password ''pandora''}}

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

== Activación de la licencia Enterprise ==

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

{{tip|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 Se haya accedido a Pandora a través del navegador, se pedirá introducir una licencia válida:

<br>
<br>
<center>
[[image:Enterprise_1.png|400px]]
</center>
<br>
<br>

Se hace clic en '''Request new licence''' y se procede al siguiente paso. En este paso se debe rellenar la información de contacto y el '''Auth key''' que el [mailto:sales@pandorafms.com departamento comercial] se haya enviado, tratandose de una versión Enterprise.

<center>
Se procede al siguiente paso haciendo clic en '''Online validation'''
[[image:Enterprise_2.png|400px]]
<br>
</center>

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

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

== Arrancar el servidor Enterprise ==
{{Warning|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 el servidor de Pandora, se abrirá una terminal a través de Applications -> System Tools -> Terminal, y escribiremos:

 sudo /etc/init.d/pandora_server start

Para verificar su correcto funcionamiento, se accederá a Pandora a través del navegador y se irá a '''Manage servers'''. Se debería de ver algo como lo siguiente:

<br>
<br>
<center>
[[image:Pandora servers.PNG|800px]]
</center>
<br>
<br>

= 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 se va a realizar una monitorización muy básica (ver si responden a un ping). Luego, se puede mejorar la monitorización una vez se tengan detectados. 

== Creando una tarea de reconocimiento ==

Se deben seguir los siguientes pasos. En el menú lateral se irá a la sección de “Discovery -> Discovery” tal y como se muestra en la imagen. Una vez dentro, nos iremos a “ Host&Devices” y se hará clic en el botón “Net Scan”

<center>
<br><br>
[[File:Guiarapida recon1.png|400px]]
<br><br>
<br><br>
[[File:Guiarapida recon1_2.png]]
<br><br>
<br><br>
[[File:Guiarapida recon1_3.png]]
<br><br>
</center>

Crearemos la tarea tal como sigue:
Se tendrá que modificar únicamente el rango de red a explorar, en esta captura es 192.168.70.1/24, que significa que todos los hosts de la red 192.168.70.xx serán explorados. Se utilizará aquí la máscara apropiada para definir la red. Seleccionando el grupo “Applications”, 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.

<center>
<br><br>
[[File:Guiarapida recon2.png|800px]]
<br><br>
</center>

Se ha seleccionado la plantilla de red (module template) "Basic monitoring" que cubre únicamente chequeos de latencia y disponibilidad de red. Se podrán seleccionar otro tipo de chequeos como SNMP o WMI a realizar durante el reconocimiento.

<center>
<br><br>
[[File:Guiarapida recon2_1.png|800px]]
<br><br>
</center>

Una vez creado, se  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:

<center>
<br><br>
[[File:Guiarapida viewrecon.png|800px]]
<br><br>
</center>

Al hacer clic en el icono de la lupa, se mostrará el estado actual de la tarea, que en este caso es de completada. En esta imagen se puede observar cómo la barra de progreso no está y el sistema ya ha encontrado los sistemas en la red para añadirlos a la monitorización.

<center>
<br><br>
[[File:Guiarapida_reconexec.png|800px]]
<br><br>
</center>

== Revisando los sistemas detectados ==

En este punto es mejor que se espere a que toda la red haya sido detectada. Cuando se haya terminado, se accederá 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:

<center>
<br><br>
[[File:Guiarapida_monitoringagentdetail.png|800px]]
<br><br>
</center>

En este punto, se pueden 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), se irá a la vista de detalle del agente, que mostrará toda la información de ese sistema.

<center>
<br><br>
[[File:guiarapida_agentdetailedview.png|800px]]
<br><br>
</center>

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

Ahora que ya se encuentran los sistemas detectados, se van a agregar algunos módulos de monitorización. Se van 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.

== 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 se localizará el agente de donde se quiere obtener el tráfico de red, en este caso es 192.168.70.1. Siguiendo el mismo proceso ''(Monitoring > Views > Agent detail)'' se llega a la vista principal del agente que se quiere configurar y se hará clic en la ultima pestaña de la derecha, que llevará a la vista de edición de ese agente.

<br><br>
<center>
[[file:Guiarapida agentedit.png|800px]]
<br><br>
</center>

Se pasará a la vista principal de edición del agente. Aquí se mostrará el submenú de "Wizards" de configuración para este agente, donde se escogerá el Wizard de Interface SNMP, tal como se aprecia en la siguiente captura de pantalla:

<br><br>
<center>
[[file:Guiarapida_snmpinterfacewizard.png|800px]]
<br><br>
</center>

Llegados a este punto se debe proporcionar la ''comunidad SNMP'' que tiene configurada el equipo, y cerciorarse de que el dispositivo soporta consultas SNMP habilitadas en la IP que se muestra en la pantalla. Se puede cambiar la IP y la comunidad SNMP por defecto, que es ''public''. Una vez este relleno, le se dará al botón "SNMP Walk". Si todo va bien, mostrará las interfaces y los datos que se pueden obtener de ellas.

<br><br>
<center>
[[file:Guiarapida_snmpinterfacewizard2.png|800px]]
<br><br>
</center>

Con Ctrl+Clic (o CMD+Clic en Mac) se pueden seleccionar varios elementos en ambas cajas, tal como se muestra en la captura. Se recuerda 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.

Se pulsa en el botón "Create modules" y una pantalla debe de informar 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 se acaba de recoger y la anterior. Muestra una "tasa" (en este caso en bytes/sec), de forma que necesita un tiempo (entre 5 y 10 minutos) antes de mostrar nada.

Se hace clic en la pestaña "View" para volver a la vista del agente y Se esperan 5 minutos hasta que ya se tengan datos de tráfico, actualizando o haciendo clic en la pestaña "View". Después de un tiempo, se debería tener una pantalla similar a esta, donde ya se tienen datos de los módulos de tráfico (entrada y salida, por separado) y una nueva sección en el agente, que 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 se hace clic en el título donde dice ''"Interface information (SNMP)"'').

Si no se queire esperar más o se quiere "forzar" la ejecución de los módulos de red, se puede 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 del servidor, puede tardar entre 2 y 15 segundos en ejecutar la prueba de red.

<br><br>
<center>
[[file:guiarapida_forcenet.png]]
<br><br>
</center>

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 [[file:chart_curve.png]] mostrará una ventana con la gráfica de ese monitor y al pulsar en el icono de datos [[file:binary.png]], una tabla con los datos.

== Pérdida de paquetes en la red ==

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

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

<br><br>
<center>
[[file:guiarapida_moduleeditor1.png|800px]]
<br><br>
</center>

Se escoge un módulo de tipo plugin y se le da al botón de "crear", que llevará a la interfaz de configuración de módulos de tipo "Plugin remoto".

<br><br>
<center>
[[file:guiarapida_moduleeditor2.png|530px]]
<br><br>
</center>

Se escoge el plugin "Package loss" utilizando los desplegables, y finalmente se pondrá la IP sobre la que se quiere lanzar el chequeo. El resto de campos se dejan como están.

<br><br>
<center>
[[file:guiarapida_moduleeditor3.png|800px]]
<br><br>
</center>

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

<br><br>
<center>
[[file:Guiarapida_packetloss.png|800px]]
<br><br>
</center>

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

== Monitorizar un servicio de red TCP ==

En este caso, se va 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 se envían credenciales de usuario y password, que se envía un correo, etc) se va a simplificar verificando únicamente que el puerto está abierto y que responde.

Para ello se repetirán los mismos pasos iniciales del ejemplo anterior, pero esta vez se escogerá un "Módulo de red" (Network module)

<center>
<br>
[[Image:guiarapida_networkmodule.png]]
</center>
<br>

Luego se utilizarán los controles desplegables hasta encontrar el chequeo deseado (Check SMTP Server) y se hará clic para crear el módulo. 

<center>
<br><br>
[[Image:guiarapida_networkmodule2.png|800px]]
</center>
<br>
<br>

Finalmente se volverán 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:

<center>
<br><br>
[[Image:guiarapida_networkmodule3.png|800px]]
</center>
<br>
<br>

= 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. La primera alerta que se va a realizar va a consistir simplemente en enviar un email cuando se caiga una de las máquinas que ya se estan 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 se va a utilizar un comando predefinido (envío de emails), se va a modificar una acción que ya existe (Mail to XXX) y se va a utilizar una plantilla que también existe ya, la plantilla ''Critical condition'', que ejecutará la alerta cuando el módulo en cuestión aparezca en estado crítico.

== Configuración del Servidor ==

Para el correcto funcionamiento del comando email, se debe configurar en el fichero ''pandora_server.conf'', un servidor de correo que permita hacer relay. En el ejemplo, el servidor de correo situado en nuestro localhost mediante postfix. Se debe poner la IP del servidor de correo local, o uno en Internet (configurando para ello la autenticación). Para modificar el fichero de configuración del servidor, se debe acceder a él situado en ''/etc/pandora/pandora_server.conf'' como usuario root, por lo que antes de hacerlo se debe hacer root con sudo su:

<br><br>
<center>
[[file:Guiarapida mailconf02.png|600px]]
<br><br>
</center>

Se buscan las líneas que se observan en la captura de abajo y se configuran como aparecen en pantalla. Si no se dispone de un servidor de correo, se puede usar por ejemplo una cuenta de gmail. Se puede 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.

<br><br>
<center>
[[file:Guiarapida mailconf03.png|600px]]
<br><br>
</center>

Una vez realizados los cambios se pulsa “ESC” y “:wq” para salir y guardar los cambios:
Tras quedar guardados los cambios se reinicia pandora_server:

 /etc/init.d/pandora_server restart

== Configuración de la Alerta==

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

<br><br>
<center>
[[file:Guiarapida mailconf8.png|300px]]
<br><br>
</center>

Para poder configurar esta alerta solo se necesita modificar la acción. La acción que se usa es '''Mail to XXX'''. En este caso, si se tiene que modificar la dirección de email que se quiere usar (info@artica.es), se podría alterar "Mail to XXX" para que ponga "Mail to info@artica.es" y así identificar bien qué acción se está ejecutando.

Se modificarán el campo 1 y se pondrá la dirección email de destino.

En el campo 2, se dejará 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.

<br><br>
<center>
[[file:Guiarapida mailconf13.png|800px]]
<br><br>
</center>

Se seleccionará la Acción '''Mail to XXX''' y se editará la dirección de correo electrónico (info@artica.es).

<br><br>
<center>
[[file:Guiarapida mailconf1.png|800px]]
<br><br>
</center>

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

<br><br>
<center>
[[file:Guiarapida mailconf5.png|800px]]
<br><br>
</center>

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

<br><br>
<center>
[[file:Guiarapida mailconf4.png|800px]]
<br><br>
</center>

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:

<br><br>
<center>
[[file:Guiarapida mailconf6.png|800px]]
<br><br>
</center>

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

<br><br>
<center>
[[file:Guiarapida_forcealert.png]]
<br><br>
</center>

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.

<br><br>
<center>
[[file:guiarapida_mail.png|800px]]
<br><br>
</center>

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: [[Pandora:Documentation_es:Alertas|Alertas en Pandora FMS]]

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

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

<br>
<br>
<center>
[[image:Pandora_agent_3.0_RC3_install_windows_01.png]]
</center>
<br>
<br>

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:

<br>
<br>
<center>
[[image:Pandora_agent_3.0_RC3_install_windows_04.png]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Pandora_agent_3.0_RC3_install_windows_07.png]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Pandora_agent_config_remoto.png]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Pandora_agent_3.0_RC3_install_windows_08.png]]
</center>
<br>
<br>

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

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

<br>
<br>
<center>
[[image:Guia rapida_windows1.png]]
</center>
<br>
<br>

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

<br>
<br>
<center>
[[image:Guia rapida_windows2.png|800px]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Guia rapida_windows3.png|400px]]
</center>
<br>
<br>

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

<br>
<br>
<center>
[[image:Guia rapida_windows4.png|800px]]
</center>
<br>
<br>

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

<br>
<br>
<center>
[[image:Guia rapida_windows5.png|800px]]
</center>
<br>
<br>

Si necesitamos añadir nuevos módulos a este agente, podemos consultar la documentación avanzada de [http://wiki.pandorafms.com/index.php?title=Pandora:Documentation_es:Operacion 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:

<br>
<br>
<center>
[[image:Guia rapida_windows6.png|800px]]
</center>
<br>
<br>

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

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

<br>
<br>
<center>
[[image:Guia rapida_consvisual1.png|800px]]
</center>
<br>

<br>
<center>
[[image:Guia rapida_consvisual2.png|800px]]
</center>
<br>
<br>

Una vez creado pinchamos sobre el Wizard de elementos:

<br>
<center>
[[image:Guia rapida_consvisual3.png|800px]]
</center>
<br>
<br>

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. 

<br>
<br>
<center>
[[image:Guia rapida_consvisual4.png|800px]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Guia rapida_consvisual5.png|800px]]
</center>
<br>
<br>

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

<br>
<br>
<center>
[[image:Guia rapida_consvisual6.png|800px]]
</center>
<br>
<br>

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

<br>
<br>
<center>
[[image:Guia rapida_spain1.png|800px]]
</center>
<br>
<br>

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:

<br>
<br>
<center>
[[image:Guia rapida_spain2.png|800px]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Guia rapida_spain3.png|500px]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Guia rapida_spain4.png|800px]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Guia rapida_spain5.png|800px]]
</center>
<br>
<br>

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

<br>
<br>
<center>
[[image:Guia rapida_link1.png|800px]]
</center>
<br>
<br>

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.

<br>
<br>
<center>
[[image:Guia rapida_link2.png|800px]]
</center>
<br>
<br>

<br>
<br>
<center>
[[image:Guia rapida_spain5.png|800px]]
</center>
<br>
<br>

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


<center>
[[file:moduloU.png|800px]]
<br><br>
</center>

Seleccionamos el módulo deseado a configurar.

<center>
[[file:moduloseleccionadoU.png|800px]]
<br><br>
</center>

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


<center>
[[file:advanced.png|800px]]
<br><br>
</center>


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

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

<center>
<br><br>
[[file:unitU.png|800px]]
<br><br>
</center>

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

<center>
<br><br>
[[file:vistaunidadU.png|800px]]
<br><br>
</center>

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

<center>
<br><br>
[[file:intervaloU.png|800px]]
<br><br>
</center>

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

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

<center>
<br><br>
[[file:umbralesU.png|800px]]
<br><br>
</center>

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.

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

<center>
<br><br>
[[file:Quickguide_inverse1.PNG]]
<br><br>
</center>

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:

<center>
<br><br>
[[file:Quickguide_inverse2.PNG]]
<br><br>
</center>

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

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

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

== Soporte ==

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

* [http://forum.pandorafms.com Foro de PandoraFMS]

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

* [http://wiki.pandorafms.com/index.php?title=Pandora:FAQ_ES FAQ de Pandora FMS (en Español)]

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:

* [http://pandorafms.com/Soporte/training/es Formación oficial de Pandora FMS]

[[Category:Pandora FMS]]