Difference between revisions of "Pandora: QuickGuides EN: General Quick Guide"

From Pandora FMS Wiki
Jump to: navigation, search
(Packet loss in the network)
(Monitorizar un servicio de red TCP)
Line 260: Line 260:
 
This is a very interesting plugin that used with the basic connectivity one (ping) and the latency time, help us to determine the quality of our network, because it indicates us the percentage of packet loss taking samples every 5 minutes.
 
This is a very interesting plugin that used with the basic connectivity one (ping) and the latency time, help us to determine the quality of our network, because it indicates us the percentage of packet loss taking samples every 5 minutes.
  
== Monitorizar un servicio de red TCP ==
+
== Monitor a TCP network service ==
  
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.
+
In this particular case we are going to add a monitoring to verify that a SMTP services (mail) is active in a machine. Although it can be a very complex check (simulating that we send an email, or user and password credentials, etc) we'll simplify it checking only that the port is open and answers.  
  
Para ello repetiremos los mismos pasos iniciales del ejemplo anterior, pero esta vez escogeremos "Modulo de red" (Network module)
+
For that we'll repeat the same initial steps of the previous example, but this time we will pick "network Module".
  
 
<center>
 
<center>
Line 272: Line 272:
 
<br>
 
<br>
  
Luego utilizaremos los controles desplegables hasta encontrar nuestro chequeo (Check SMTP Server) y haremos click para crear el módulo.  
+
After that we'll use the drop down controls to find our check (Check SMTP Server) and we'll click to create the module.
  
 
<center>
 
<center>
Line 281: Line 281:
 
<br>
 
<br>
  
Finalmente, volveremos a repetir los pasos (ir a la vista de operación, y refrescar hasta que aparezca el monitor) de manera que el resultado final será algo similar a esto:
+
Finally, we'll repeat the steps (go to the Operation View, and refresh till the monitor appears) so that the final result will be something similar to the following:  
  
 
<center>
 
<center>

Revision as of 11:29, 28 April 2015

1 Introduction to this guide

The purpose of this guide is to quickly introduce Pandora FMS to someone not familiar with Pandora FMS, but who has a medium/high knowledge of systems and networks. We don't pretend to make a path along all the features of Pandora FMS, but remark the most important of them, so that a user that read the complete guide could make basic administration and operation tasks in record time. It's good to consider that the Pandora FMS official training lasts 40 hours, and the official documentation has more than 1200 pages, so this is just a small bridge to make easier the approach to Pandora FMS.

2 Installation

We'd use the Pandora FMS CD Appliance because it's the quickest and easiest method for intermediate users. There are several alternative ways to install Pandora FMS, but this is the one we recommend. For further information, please read Pandora FMS Installation chapter.

The installation CD is based on Linux CentOS 6.5, and contains pre-installed all the things required to make Pandora FMS work. You should have a machine with a minimum hardware requirements to make Pandora FMS run properly. You must have a minimum of 2GB of RAM and 20GB of disk.


Info.png

The more systems you want to monitor the more resources (CPU, memory, Disk speed) you'll have to assign to the Pandora FMS server.

 


2.1 Installing the Appliance CD

Download the CD image from the Download section of our website and record the ISO image in a DVD, or run the system from that file if you are using a virtualized system (XenServer, VMware, VirtualBox, etc). There are CD images of 32 and 64 bit.

The following screen will be displayed at the beginning of the boot. If Nos aparece esta pantalla al inicio del arranque. If you don't press any key it will automatically load the Live CD, instead of that, press any key and select "Installation" option.



Centos1.png



Centos2.png



The graphic installer will lead you step by step during the whole installing process. This installer is a standard installing process used by CentOS, and it's available in different languages. It's a very easy process and you'll just have to pay special attention when introducing the superuser password (root), and when you'll be asked about the partitioning:



Guiarapida password.png

We choose "root" user password (superuser)



Guiarapida disco.png

We choose the partitioning. Unless you know what it does, use the "Use all space".


2.2 First steps

Once installed, the system should boot and after a few seconds show the desktop that has to be similar to the following:



Guiarapida escritorio.png



The first step should be to know the IP that the system has assigned to us to allow us to connect to the server from outside. For that, we will open a terminal in the Applications menu Applications -> System Tools -> Terminal. In this terminal we will write the command:

ifconfig 



Guiarapida ifconfig.png



You can see this example. In this particular case, the system IP is 192.168.70.121

If the system has booted and and taken an IP from our network it will be shown in the list. If we want to set a fixed IP to this system, we could do it through the CentOS Network Configuration Interface. Click on the right button over the network icon and "Edit connections". The purpose of this guide is not detail the configuration of the base system but allow the minimum work configuration.

Once you know the IP address of Pandora FMS system, you can access to it from outside the virtual machine, which is always more comfortable. You can do it via SSH or via HTTP. Remember that you set the root password (superuser) in the configuration.

Open a browser and write the following address with the IP that you got from your server:

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

In the last example it would be http://192.168.70.121/pandora_console, but you must get the IP of your system correctly to continue. If everything is correct you must access the welcome screen of Pandora FMS console, similar to the next:



Guiarapida login.png



Info.png

Use the credentials by default: user admin and password pandora

 


Once arrived to this point, you have a complete installation of Pandora FMS ready to use.

3 Detecting problems in your network

To start with Pandora FMS, the best option is detect and try to monitor the devices that are around. No matter if they are PCs with Windows, Linux servers or routers/switches because we are doing a very basic monitoring (check if they answer to a ping). After that and once they are detected we could improve the monitoring.


3.1 Create a Recon Task

Let's follow the next steps. In the side menu go to "Manage Servers" -> "Manage Recon Task" as shown in the image below, and click on Create Recon Task button.



Guiarapida recon1.png

Create the task as in the image:



Guiarapida recon2.png

You will have to modify only the network range to explore. In this screenshot is 192.168.70.0/24 which means that all the hosts of the 192.168.70.xx network will be explored. Use here the appropriate mask to define your network.

"Basic monitoring" network template which covers uniquely the latency and network availability checks has been selected. Group "Network" that will be used to contain the detected devices has been selected. From know and on we will call "agents" (in a generic way) to the devices managed or monitored by Pandora FMS.

Once created it will show us the entry, and we must click on the lens icon to see the task details, as shown in the screenshot below:



Guiarapida viewrecon.png

By clicking on the lens icon, it will show the current status os the task, which should be the task execution. In this screenshot you could see how advanced is the progress bar, and in that moment the system is searching systems in the network to add the monitoring.



Guiarapida reconexec.png

3.2 Review the detected systems

At this point, is recommended to wait till all the network has been detected. Click on Refresh tab Refreshtab.png. When you are finished, go to Agent Detail view to see all the systems detected. Menu "Monitoring" -> "Agent detail", as in the image:



Guiarapida monitoringagentdetail.png

Here we could see severial systems that have been properly detected by Pandora FMS. Sometimes the name of the system would have been solved (if possible by DNS), and in other cases the OS would have been detected. When clicking on the name of the system (in this case the first of the screenshot), we'll go to Agent Detail view that will display all the information of that system.



Guiarapida agentdetailedview.png

4 Add the remote check over an already monitored system

Now that we have our systems detected, we are going to add some monitoring modules. Let's add the following monitoring:

  • Network traffic on an interface.
  • Packet loss in the network.
  • Check if a service is answering by the network trough a TCP port.
  • Check a website.

4.1 Network traffic on the interface

For that is essential that the SNMP is configured in the remote device. This usually needs to be activated and a minimum configuration that allows us to consult data. The SNMP devices allows to configure the IP that can make queries, and with which community, what is a kind of password.

First of all we have to locate the agent from where we want to get the network traffic, in our case it's 192.168.70.1. Following the same process (Monitoring -> Agent Detail View) we'll go to the Main View of the agent we want to configure and we will click on the last tab on the right, which will take us to the edit view of that agent.

Guiarapida agentedit.png

Now we will go to the Agent edit main view. We'll have to show the configuration wizard submenu for this agent, we'll choose the SNMP Interface wizard, as you can see in the next screen:

Guiarapida snmpinterfacewizard.png

At this point, we must provide the "SNMP community" that we have configured in the machine, and make sure that the device supports SNMP queries enabled in the IP shown on the screen. We can change the IP address and the SNMP community by default, which is public (in our case is different, is 'artica06'). Once filled, we must click on the "SNMP Walk" button. If everything goes right, it will shoe the interfaces and the data that we can get from them.

Guiarapida snmpinterfacewizard2.png

With CONTROL-Click (or CMD-Click in Mac) we can select more than one element in both boxes such us in the following screenshot. We recommend to always monitor the outgoing traffic (ifOutOctets), the incoming traffic (ifInOctets) and the status of the interface (ifOperStatus) per each interface. In this particular case, eth1, eth2 y eth3.

We click on "Create modules" button and a screen should inform us about the modules that have been created.

We must consider that the network traffic modules are incremental type, ie its value is the difference between the sample of information that we've just taken and the above, ie, it shows us a "rate" (in this case bytes/sec) so it takes time (between 5 and 10 minutes) before showing anything.

Guiarapida opermode.png

He have to click on "View" tab to return to the Agent View, and wait 5 minutes to have traffic data, refreshing or clicking on the "View" tab. After a while, we must have a screen similar to that, where we have data of the traffic modules (incoming and outcoming separated), and a new section in the agent, that shows information about the interfaces with a direct access to an aggregate graph with the outcoming and incoming traffic overlay (click on the title "Interface information (SNMP)").

Guiarapida interfaceinfo.png

If we don't want to wait or we don't want to force the execution of the network modules, we can use the force remote check icon (it wont work with local modules, or with modules collected in local by a software agent). Depending on the load of our server it could last between 2 and 15 seconds in executing the network test.

Guiarapida forcenet.png

The information of the traffic modules will be displayed like this, and the graphs per each metric. Clicking on the graph icon Chart curve.png it will show a window with the graph of this monitor, and when we click on the data icon Binary.png it will show a table with data.

Guiarapida moduledata.png

4.2 Packet loss in the network

We want to add a remote plugin preconfigured in Pandora FMS. Remote plugins are checks defined by the user that use a script or a software deployed in the Pandora FMS server, so that it could be used for monitoring, increasing the number of things that it could do.

Let's use a serial plugin, for that we must go to the Agent edit View, and after to the Module configuration tab.

Guiarapida moduleeditor1.png

We will choose a module type plugin and we'll click on "Create" button, which will lead us to the interface of configuration of "plugin remote" type modules.

Guiarapida moduleeditor2.png

We'll choose the "Packet loss" using the drop down, and finally we'll introduce the IP address on which we want to launch the checks. We leave the rest of fields as they are.

Guiarapida moduleeditor3.png

We'll click on the "Create" button and return the Operation View, as in the case described above. We'll refresh a couple of times till the new module appears in the list:

Guiarapida packetloss.png

This is a very interesting plugin that used with the basic connectivity one (ping) and the latency time, help us to determine the quality of our network, because it indicates us the percentage of packet loss taking samples every 5 minutes.

4.3 Monitor a TCP network service

In this particular case we are going to add a monitoring to verify that a SMTP services (mail) is active in a machine. Although it can be a very complex check (simulating that we send an email, or user and password credentials, etc) we'll simplify it checking only that the port is open and answers.

For that we'll repeat the same initial steps of the previous example, but this time we will pick "network Module".


Guiarapida networkmodule.png


After that we'll use the drop down controls to find our check (Check SMTP Server) and we'll click to create the module.



Guiarapida networkmodule2.png



Finally, we'll repeat the steps (go to the Operation View, and refresh till the monitor appears) so that the final result will be something similar to the following:



Guiarapida networkmodule3.png



4.4 Comprobar una página web

En la versión Enterprise de Pandora 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 version "Open" de Pandora, 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 libreria de modulos de Pandora FMS en su versión en ingles (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 en este caso 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 (envio de email) ante un problema

En PandoraFMS la forma más básica de alertas es asignar una alerta a un módulo específico. Se pueden hacer cosas mas 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 modulo Host alive).

Las alertas en Pandora están compuestas de tres elementos: Comando, Accion 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 nuestro ejemplo el servidor de correo situado en 192.168.50.2 tiene habilitada esta función. Deberás poner la IP de tu 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 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 se componen de 3 partes: Comando, Acción y Plantilla. Podremos encontrar estas opciones en la sección Manage 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" y para que ponga "Mail to [email protected]" y así identificar bien que 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. Aqui se están usando dos macros que reemplazarán en tiempo de ejecución el nombre del agente y el modulo que han 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 de el 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 a mi buzón. 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 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 a los diferentes dispositivos ) y local ( se instala un agente software en cada una de las máquinas a monitorizar, éste se encarga de extraer la información y enviársela al servidor de Pandora )

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

Primero ante todo nos tenemos que 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-click sobre el 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 del instalador, aceptamos la licencia, 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 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 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 la hora de comprobar que 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. Para ello tenemos varias opciones. La primera de ellas pasa por 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, indicando el nombre del agente.



Guia rapida windows3.png



Nos aparecerá aqui 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 precargados, 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 es la posibilidad de crear Consolas Visuales. La Consola Visual permite representar la información de monitorización, en tiempo real, deciéndolo el usuario, 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 critico 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 nos aparecerá 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.

Primero de todos creamos el nuevo mapa como hicimos el 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 configuramos el parent a un Item 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 arrastrandolos directamente con el ratón en la posición que queramos.



Guia rapida spain5.png



7.3 Linkado de ambos mapas

Creamos en los pasos anteriores los dos mapas. En este paso vamos a indicar como 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-click sobre el elemento 192.168.70.70. Se nos abrirá la edición del elemento, pinchamos sobre opciones avanzadas y en la opción Map Linked, seleccionamos el Spain Map. Actualizamos el elemento



Guia rapida link1.png



Al volver sobre la vista del mapa World Map, hacemos click en el elemento situado sobre España y directamente se nos abrirá el mapa de España. Si en el mapa de España hubiera un solo elemento en rojo, el icono que representa a España en el mapa padre, 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 modulo. 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 cuando queremos que se ejecute dicho módulo. Esto aplica 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 que valores debe tener un modulo 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 modulo 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 modulo 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. Explore la documentación de Pandora para descubrir todas ellas.

9 Solución de problemas. Donde mirar, a quien preguntar

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

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

  • /etc/pandora/pandora_server.conf. Fichero de configuración principal del servidor de Pandora. 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 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 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. En la instalación se autoconfigura, pero si ha cambiado algun parámetro de entorno (path, IP, usuario/password de MySQL, host de MySQL) habrá que modificarlo manualmente.

Fuentes de información (logs) donde puedes buscar más informacion, 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 algun 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, create una cuenta y pregunta:

Dispones de una lista de preguntas frecuentemente respondidas (FAQ) que pueden darte una pista o directamente una solución a un problema concreto:

Por supuesto, también tienes la opción de formarte, por medio de los cursos oficiales de Pandora FMS (con certificación), infórmate en: