Pandora: Documentation es: SatelliteServer

From Pandora FMS Wiki
Jump to: navigation, search

Volver a Indice de Documentacion Pandora FMS

Contents

1 Satellite Server

1.1 Introducción

El Satellite Server se emplea para descubrir y monitorizar redes y equipos remotos, bien elementos de red (routers, switches, etc.) vía SNMP o ICMP, o bien servidores Windows (vía WMI) o Linux (vía SNMP). Este no es un servidor "ordinario", sino que más bien se podría considerar como un Agente en modo broker con funcionalidades extendidas. Es especialmente útil para monitorizar redes remotas inaccesibles desde el servidor de Pandora FMS, y donde tampoco podemos instalar agentes.

Info.png

El Satellite Server es un componente exclusivo de la versión Enterprise.

 



Esquema-satellite.png


El Satellite Server funciona tanto en Windows como en Linux (recomendado), y tiene algunas características que lo hacen especial, más que recomendable en determinados entornos.

  • Puede ejecutar pruebas de red (ICMP, Latencia y SNMP v1 y v2) a una tasa extremadamente alta (500 chequeos por segundo).
  • Solo envía datos al servidor cada X segundos (por defecto 300), pero puede ejecutar las pruebas de latencia, ICMP y SNMP con un intervalo menor (por ejemplo 30 segundos), de forma que, cuando detecta cambios de estado, notifica inmediatamente al servidor. Estos cambios de estado se han de definir previamente si el tipo de módulo no es un *_proc (por ejemplo interfaces de red o conectividad general de red).
  • Es un servidor autónomo, no requiere conexión a la BBDD. Envía todos los datos como XML de forma que funciona como un servidor independiente, similar a como lo hace un agente en modo broker o a un Export server.
  • Tiene un mecanismo de autodiscovery para SNMP y WMI, de forma que crea los agentes detectados (por IP), detecta los elementos dinámicos (interfaces de red, almacenamiento) y los monitoriza de forma automática.
  • En sistemas Windows detecta discos, CPU y memoria.
  • En sistemas de red con SNMP detecta estado de las interfaces, tráfico de entrada y salida por cada interfaz, y el nombre del sistema.
  • Los módulos autogenerados se pueden modificar, como otro módulo más, gestionando el agente desde la consola, como si fuera un agente ordinario (en la sección de operaciones masivas -> Satélite).
  • Podemos crear agentes manualmente, creando un fichero de configuración de agente en el directorio de configuraciones del Satellite Server (explicado más adelante).


1.1.1 Capacidad

Es difícil precisar la capacidad máxima del Satellite, ya que depende totalmente del servidor donde se ejecuta, y el tipo de chequeos que se quiere realizar. En nuestro entorno de pruebas hemos logrado realizar 500 chequeos ICMP y SNMP por segundo, pero eso depende mucho de los tiempos de respuesta del dispositivo remoto (no es lo mismo uno que responde en 0.5ms que uno que tarda 2seg en responder). En condiciones ideales teóricas podemos hablar de que se pueden monitorizar unos 150.000 monitores con un solo Satellite Server. En condiciones reales hemos probado en entornos más o menos controlados (redes locales) unos 50.000 módulos con un Satellite Server en un ordenador de hardware muy discreto (Intel i5, 2GHz, 4GB RAM).

Template warning.png

Si existen muchos módulos críticos, el rendimiento puede verse muy afectado. También hay que tener en cuenta el timeout configurado, ya que solo se realiza una comprobación crítica por timeout. Si tenemos 1.000 módulos críticos y el timeout configurado a 4 segundos, se tardaría 4.000 segundos en ejecutar todos estos chequeos con un único hilo.

 


1.2 Instalación

El Satellite Server se distribuye en forma de tarball (Linux) o .exe (Windows), de forma que no hace falta instalar Perl o ninguna librería adicional. El funcionamiento en las versiones Windows o Linux es idéntica. En caso de Windows se instala como servicio, y en el caso de Linux se instala como demonio del sistema. El fichero de configuración y las especificaciones de ambos son idénticas.

La versión de Linux del Satellite Server depende de paquetes externos que se especifican en la sección correspondiente de esta documentación.

1.3 Instalación de Satellite Server en Linux

Una vez descargado el paquete que contiene el Satellite Server sería necesario situarnos dentro de la carpeta de descarga con privilegios de root y descomprimir el binario:

tar -xvzf pandorafms_satellite_server_X.XNG.XXX_x86_64.tar.gz


Desarchivar nuevo.png


A continuación se generará una carpeta denominada satellite_server. Tenemos que situarnos dentro tecleando:

cd satellite_server/

Antes de proceder con la instalación es necesario dejar claro cuáles son las dependencias fundamentales del Satellite Server: fping, nmap, wmic y braa.

También será necesario para la ejecución del servidor tener instalado Perl en el dispositivo. Puede instalarse con el siguiente comando:

yum install perl

En el instalador se adjuntan las dependencias de Braa y Wmic. Es necesario instalar Fping y Nmap de forma independiente:

yum install fping nmap

A continuación, para instalar el Satellite Server, solamente tendremos que ejecutar el comando de instalación:

./satellite_server_installer --install


Instalacion linux nuevo.png

Una vez terminado el proceso, será necesario editar el fichero de configuración del satélite (localizado en /etc/pandora/satellite_server.conf), buscar el token pandora_license, descomentarlo e introducir la licencia de nuestro servidor Pandora FMS. Tras ello podemos guardar el archivo y levantar el servicio, ejecutando lo siguiente:

sudo /etc/init.d/satellite_serverd start

En caso de algún error o mal funcionamiento, puede revisar el fichero satellite_server.log, localizado en la ruta /var/log/satellite_server.log.

1.4 Instalación en Windows

El proceso de instalación en Windows se puede realizar siguiendo las imágenes que veremos a continuación:

Empezamos por elegir el idioma de instalación:



Instalacion windows1.png


Hacemos click en Siguiente:



Instalacion windows2 nuevo.png


A continuación podemos elegir el lugar donde queremos instalar el programa:



Instalacion windows3 nuevo.png


Será necesario instalar tambien WinPCap. La ventana de instalación aparecerá en este paso de la instalación.



Instalación wincap1.png


Configuramos el encendido de WinPCap al iniciar la máquina:



Instalación wincap2.png


Una vez terminada la instalación de WinCap podra ver la siguiente pantalla:



Instalación wincap3.png


Será necesario introducir la clave de licencia de Pandora FMS para poder seguir con la instalación:



Instalacion windows4 nuevo.png


En el siguiente apartado tenemos que configurar la dirección del servidor Pandora FMS para el envío de los datos; podremos definir las reglas exploración de red para el Satellite Server.



Instalacion windows5 new.png


Será necesario reiniciar la máquina para que se apliquen todos los cambios.



Instalacion windows6 nuevo.png


Una vez terminado el proceso, puede arrancar y parar el servicio Satellite Server desde el menú Inicio.


1.4.1 Funcionamiento módulos WMI en algunas versiones de Windows

Por motivos de seguridad de Windows, algunas versiones tienen limitados los usuarios con los que realizar consultas WMI remotas. En el caso de que estas consultas no se lleven a cabo, la solución es ejecutar el servicio del Satellite Server como usuario Administrador.

El proceso a seguir es el siguiente:

Abrimos los servicios:


Instalacion windows7 nuevo.png


Hacemos click derecho sobre el servicio y entramos en Propiedades:



Instalacion windows8 nuevo.png


Sobre la ventana de Iniciar sesión seleccionamos una cuenta con permisos de Administrador y Aplicamos cambios:


Instalacion windows9 nuevo.png


Debe reiniciarse el servicio para aplicar los cambios.

1.5 Configuración

Todos los parámetros que requieren un timeout o tiempo se especifican en segundos (por ejemplo: 300 = 5 minutos).

Es importante destacar que los intervalos de latency y SNMP son específicos al cambio de estado. En el caso de los chequeos booleanos (estado de un puerto, estado de la máquina), el umbral que define el cambio de estado es automático; en el caso de valores numéricos (latencia, tráfico de red en una interfaz, espacio de disco, CPU, etc.), se basa en el umbral. Por defecto no se definen umbrales; esto tiene que hacerse en la definición del módulo.

1.5.1 agent_interval xxx

Por defecto, 300 segundos (5 minutos); crea agentes con un intervalo de 5 minutos. Será el tiempo tras el que enviará datos al servidor, independientemente de que los chequeos que haga el Satellite Server sean con un intervalo más corto.

1.5.2 agent_threads xxx

Número de hilos que se utilizan para mandar ficheros XML de datos.

1.5.3 xxxxxx_interval xxx

Ejecuta todos los chequeos (latencia, SNMP, etc) cada xxx segundos. Si el dato recopilado cambia respecto al anterior lo envía en ese momento. Si es igual, lo enviará cuando el intervalo de ese agente así lo ordene. Es útil para realizar pruebas muy intensivas, y notificar solo en el caso de cambio de estado.

1.5.4 xxxxx_retries xxx

Número de reintentos en los chequeos (latencia, SNMP, ping...)

1.5.5 xxxxx_timeout xxx

Timeout en segundos para las pruebas de tipo SNMP, latencia y ping.

1.5.6 xxxxx_block xxx

Fuerza al servidor a ejecutar las consultas (latencia, ping y snmp) en bloques de XXX consultas. Cuanto mayor sea el número (hasta 500), más capacidad de proceso tendrá, pero a costa de incrementar la latencia. En algunos casos puede ser conveniente disminuir ese número.

1.5.7 xxxxx_threads n

Número de hilos asignados a cada tipo de chequeo para que trabajen de manera concurrente. Dependerá de la potencia (CPU y RAM) de la máquina. Cuantos más hilos, más se cargará el sistema, pero más capacidad de proceso tendrá. Al superar los 20 hilos, dependiendo del sistema, puede empeorar el rendimiento.

1.5.8 log_file xxx

Indica el fichero en el que se escribe el log del Satellite Server, por defecto en /var/log/satellite_server.log .

1.5.9 recon_task xxxxx[,yyyy]

Direcciones/Redes IP empleadas para el autodiscovery, separadas por comas. Ej:

192.168.50.0/24,10.0.1.0/22,192.168.70.64/26

1.5.10 server_ip <ip>

Dirección IP o nombre DNS del servidor de Pandora FMS al que queremos enviar la información. La información se envía por Tentacle, de forma que la comunicación hacia el servidor debe ser posible por el puerto de Tentacle (41121/tcp).

1.5.11 recon_mode [icmp,snmp,wmi]

Modo de autodescubrimiento. El sistema empleará esos protocolos para descubrir los sistemas:

  • ICMP: Se limitará a hacer verificación de si el host está vivo (ping) y medir el tiempo de latencia.
  • SNMP: Si es capaz de comunicar por SNMP (v1 y v2 únicamente), buscará todas las interfaces de red, y sacará el tráfico de todas ellas, así como su estado operativo, además del nombre del dispositivo y ubicación. Probará con las diferentes comunidades suministradas en el fichero de configuración para conectar.
  • WMI: Similar al caso anterior, en este caso mostrando Carga de CPU, Memoria y Discos (todos los disponibles).

1.5.12 recon_community aaa,bbb,ccc...

Especifica una lista de comunidades SNMP para usar en el discovery de SNMP, separadas por comas. Utilizará esta lista en la exploración SNMP: por cada IP encontrada, intentará ver si responde a alguna de estas comunidades.

1.5.13 wmi_auth Administrator%password[,user%pass]

Especifica una lista de parejas de Usuario%Password; por ejemplo: admin%1234,super%qwerty. Utilizará esta lista en la exploración WMI. Por cada IP encontrada, intentará ver si responde a alguna de estas combinaciones.

1.5.14 agent_conf_dir <directorio conf de los agente>

En este directorio se crean automáticamente los ficheros de configuración de cada agente creado por el Satellite Server, por defecto /etc/pandora/conf. Puede crearlos a mano, como se muestra más adelante.

1.5.15 group <grupo>

Define el grupo por defecto de los agentes creados por el satélite. Por ejemplo, "Servers".

1.5.16 daemon [1|0]

Si su valor es 1, levanta en demonio en background (por defecto).

1.5.17 hostfile <file>

Es un método alternativo/complementario al de escanear una red para encontrar hosts. Se le pasa un fichero donde en cada línea hay una dirección. Alternativamente, se le puede pasar en la misma línea el hostname seguido de la IP, de forma que cree el agente con ese nombre y use esa IP para los módulos (ej: 192.168.0.2 hostname). Se debe poder realizar un fping a esas direcciones para que sean válidas.

1.5.18 pandora_license xxxxxxx

Ahí debe escribir la licencia de su servidor Pandora FMS, tal como se muestra en la seccion Setup -> Licencia de su consola Pandora FMS. Puede usar la misma licencia en tantos servidores Satellite como necesite, ya que el total de agentes que usan la licencia se verifica en el servidor de Pandora FMS, no en el Satellite.

1.5.19 remote_config [1|0]

Activa por defecto la configuración remota en los agentes detectados, necesario si quiere gestionarlos desde la consola después de detectarlos. También activa la configuración remota del propio Satellite Server. Para más información sobre configuración remota, ver: Configuración remota.

1.5.20 temporal_min_size xxx

Si el espacio libre (en megabytes) de la partición en la que se encuentra el directorio temporal es menor que este valor, no se siguen generando paquetes de datos. De este modo se evita que se llene el disco si por alguna razón se pierde la conexión con el servidor durante un intervalo de tiempo prolongado.

1.5.21 xml_buffer [0|1]

Por defecto 0. Estando a 1 el agente guardará los XML de datos que no haya podido enviar para intentarlo de nuevo más adelante.

En Unix, si está en un entorno seguro debería considerar cambiar el directorio temporal, ya que /tmp tiene permisos de escritura para todos los usuarios.


1.5.22 snmp_version xx

Versión de SNMP que se utilizará por defecto (solo 1 y 2c están soportadas). 1 por defecto.

Template warning.png

Algunos módulos podrían dejar de funcionar si se cambia este valor.

 


1.5.23 braa <path a braa>

Path al binario de braa (/usr/bin/braa por defecto).

1.5.24 fping <path a fping>

Path al binario de fping (/usr/sbin/fping por defecto).

1.5.25 fsnmp <path a fsnmp>

Path al binario de SNMP(/usr/bin/pandorafsnmp por defecto).

1.5.26 latency_packets xxx

Número de paquetes ICMP que se envían por petición de latencia.

1.5.27 nmap <path a nmap>

Path al binario de nmap (/usr/bin/nmap por defecto).

1.5.28 nmap_timing_template xxx

Un valor que especifica cómo de agresivo debe ser nmap, de 1 a 5. 1 significa más lento pero más fiable, 5 significa más rápido pero menos fiable. Por defecto 2.

1.5.29 ping_packets xxx

Número de paquetes ICMP que se envían por cada ping.

1.5.30 recon_enabled [0|1]

Habilita (1) o deshabilita (0) el autodescubrimiento de equipos.

1.5.31 recon_timing_template xxx

Como nmap_timing_template, pero aplicado a los escaneos de red.

1.5.32 server_port xxxxx

Puerto del servidor de Tentacle.

1.5.33 server_name xxxxx

Nombre que se quiere dar al servidor Satellite (por defecto toma el hostname de la máquina).

1.5.34 server_path xxx

Ruta donde los ficheros XML son copiados si el transfer_mode está en local (por defecto /var/spool/pandora/data_in).

1.5.35 server_opts

Parametros del servidor que son pasados a Tentacle.

1.5.36 transfer_mode [tentacle|local]

Modo de tranferencia de ficheros. Puede ser únicamente Tentacle o local (por defecto Tentacle).

1.5.37 Servidor Secundario

Un tipo especial de parámetro de configuración general es la definición de un servidor secundario. Esto permite definir un servidor al que se le envían los datos, de forma complementaria al servidor definido de forma estándar. El modo de servidor secundario funciona de dos formas:

  • on_error: Envía datos al servidor secundario solo si no puede enviarlas al primario.
  • always: Siempre envía datos al servidor secundario, independientemente de si puede contactar o no con el servidor principal.

Ejemplo de configuración:

secondary_server_ip     192.168.1.123
secondary_server_path   /var/spool/pandora/data_in
secondary_mode          on_error
secondary_transfer_mode tentacle
secondary_server_port   41121

1.5.38 snmp_verify [0|1]

Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv1 que hacen fallar braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse.

1.5.39 snmp2_verify [0|1]

Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv2 que hacen fallar braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse.

Template warning.png

¡Comprobar módulos SNMP versión 2 puede ser muy lento!

 


1.5.40 snmp3_verify [0|1]

Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv3 que hacen fallar braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse.

1.5.41 startup_delay xxx

Espera xxx segundos antes de enviar ficheros de datos por primera vez.

1.5.42 temporal <directorio>

Directorio temporal donde se crean los ficheros XML, por defecto /tmp.

1.5.43 tentacle_client <path a tentacle_client>

Path al binario del cliente de Tentacle (/usr/bin/tentacle_client por defecto).

1.5.44 wmi_client <path a wmic>

Path al binario de wmic (/usr/bin/wmic por defecto).

1.5.45 snmp_blacklist <path to the blacklist>

Path a la lista negra de módulos SNMP (/etc/pandora/satellite_server.blacklist por defecto).

1.5.46 add_host <dirección IP> [nombre del agente]

Añade el host dado a la lista de agentes monitorizados. Se puede especificar el nombre del agente después de la dirección IP. Se pueden añadir múltiples hosts, uno por línea. Por ejemplo:

add host 192.168.0.1
add host 192.168.0.2 localhost.localdomain

1.5.47 ignore_host <nombre del agente>

Elimina el host dado de la lista de agentes monitorizados, incluso si es encontrado en un escaneo de red por una tarea recon. El host debe identificarse por el nombre del agente. Se pueden ignorar múltiples hosts, uno por línea. Por ejemplo:

ignore host 192.168.0.1
ignore host localhost.localdomain

1.5.48 keepalive xxx

El Satellite Server informa de su estado y comprueba cambios en la configuración remota (de los agentes y de sí mismo) cada keepalive segundos. Por defecto a 30 segundos.

1.5.49 credential_pass xxx

Contraseña utilizada para cifrar las contraseñas de las cajas de credenciales. Debe ser la misma que se defina en la Consola de Pandora FMS. Por defecto se utiliza el nombre de host.

1.5.50 timeout_bin <path a timeout>

Si está definido, el programa timeout (normalmente /usr/bin/timeout) se utilizará al llamar al cliente de Tentacle.

1.5.51 timeout_seconds xxx

Timeout en segundos para el programa timeout. El parámetro timeout_bin debe estar configurado.

1.5.52 proxy_traps_to <dirección[:puerto]>

Redirige los traps SNMP recibidos por el Satellite Server a la dirección (y puerto) especificados. Por defecto se utiliza el puerto 162.

1.5.53 proxy_tentacle_from <dirección[:puerto]>

Redirige los datos recibidos por Tentacle server desde la dirección (y puerto) especificados. Por defecto se utiliza el puerto 41121.

1.5.54 proxy_tentacle_to <dirección[:puerto]>

Redirige las peticiones de clientes de Tentacle recibidas por el Satellite Server a la dirección (y puerto) especificados. Por defecto se utiliza el puerto 41121.

Template warning.png

Esta opción puede entrar en conflicto con la configuración remota de agentes.

Esto ocurre si se pretende usar el Satellite Server como proxy de algunos agentes software y monitorizarlos a su vez desde el mismo Satellite Server de forma remota (ICMP, SNMP, etc.) y la configuración remota está habilitada en ambos casos.

En esta situación se deberá, o bien usar agentes distintos para los chequeos hechos (es decir, con "agent_name" diferente), o bien dejar la configuración remota habilitada solo en uno de los dos (Satellite Server o agentes software).

 


1.5.55 dynamic_inc [0|1]

Poner a 1 para mover los módulos dinámicos descubiertos de forma automática (SNMP, WMI...) a ficheros separados para que no interfieran con la configuración remota de agentes.

1.5.56 vlan_cache_enabled [0|1]

Habilita (1) o deshabilita (0) la cache VLAN de los host autodescubiertos.

1.5.57 verbosity <0-10> (Version > 7.0OUM204)

Nivel de verbosidad del log, donde 10 es el nivel de información más detallado.

1.5.58 agents_blacklist_icmp 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713)

Lista negra de chequeos ICMP. Este campo se puede configurar con una lista de IPs usando la notación CIDR para evitar que se ejecuten módulos de tipo ICMP. Es posible especificar varias subredes separándolas por comas.

1.5.59 agents_blacklist_snmp 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713)

Lista negra de chequeos SNMP. Este campo se puede configurar con una lista de IPs usando la notación CIDR para evitar que se ejecuten módulos de tipo SNMP. Es posible especificar varias subredes separándolas por comas.

1.5.60 agents_blacklist_wmi 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713)

Lista negra de chequeos WMI. Este campo se puede configurar con una lista de IPs usando la notación CIDR para evitar que se ejecuten módulos de tipo WMI. Es posible especificar varias subredes separándolas por comas.

1.5.61 general_gis_exec xxx (Version > 7.0OUM734)

Activando esta opción, se usará un script para proveer posicionamiento GIS a todos los agentes detectados por el Satellite Server. El script debe tener permisos de ejecución e imprimir por pantalla las coordenadas con el formato <longitud>,<latitud>[,<altitud>]. El tercer parámetro, la latitud, es opcional.

1.6 Creación de agentes en Satellite Server

Existen tres modos de crear los agentes en el Satelllite Server: Recon Task, fichero de satellite_hosts.txt o de manera manual creando los .conf de los agentes a monitorizar.

1.6.1 Creación de agentes mediante Recon Task

La creación de agentes mediante Recon Task es la más utilizada por los usuarios de Pandora FMS. Para llevarla a cabo, debemos acceder al fichero de configuración del Satellite Server y configurar los siguientes parámetros:

  • recon_community: Se debe especificar una lista de comunidades SNMP para usar en el discovery de SNMP separadas por comas (en el caso de realizar una recon de tipo SNMP).
  • recon_enabled: Se debe poner a 1 para habilitar el recon task del Satellite Server.
  • recon_interval: Intervalo de tiempo donde se escanea la red que queramos, en segundos (por defecto 604800 segundos, 7 días).
  • recon_mode: Modo de realizar la recon task (SNMP,ICMP,WMI), separados por comas.
  • recon_task: Lista de redes a las cuales queremos hacer el reconocimiento, separadas por comas.
  • recon_timing_template: Un valor que especifica cómo de agresivo debe ser nmap, de 1 a 5. 1 significa más lento pero más fiable; 5 significa más rápido pero menos fiable (por defecto 3).

Un ejemplo de realización de Recon Task es:

recon_community public
recon_enabled 1
recon_interval 604800
recon_mode icmp,snmp,wmi
recon_task 192.168.0.0/24,192.168.1.0/24
recon_timing_template 3

Una vez configurados los datos, ejecutamos el Satellite Server mediante el comando:

/etc/init.d/satellite_serverd start

1.6.2 Creación de agentes mediante fichero satellite_hosts.txt

En primer lugar, para poder crear un agente mediante el fichero satellite_hosts.txt, debemos ir al archivo de configuración del Satellite Server y descomentar la línea:

host_file /etc/pandora/satellite_hosts.txt

En segundo lugar crearemos el fichero satellite_hosts.txt con las IP de los host que queremos crear poniendo IP y nombre del agente a crear:

192.168.10.5 Server5
192.168.10.6 Server6
192.168.10.7 Server7

Template warning.png

Para que los agentes con estas IPs puedan ser creados, es necesario que respondan a la llamada fping, pues en caso contrario no se crearán.

 


Una vez configurados los datos, iniciamos el Satellite Server mediante el comando:

/etc/init.d/satellite_serverd start

1.6.3 Creación de agentes de manera manual

En primer lugar nos situamos en el fichero de configuración del Satellite Server en el parametro agent_conf_dir, que es donde se crean los ficheros de configuración de los nuevos agentes (por defecto /etc/pandora/conf).

cd /etc/pandora/conf

Una vez situados en dicho directorio, solo tendremos que crear un archivo.conf de los agentes que queramos crear, tomando por ejemplo el agente del servidor como ejemplo, y rellenando manualmente los siguientes campos:

  • agent_name: Pondremos el nombre que queremos dar al agente.
  • agent_alias: Ponemos el alias que queremos dar al agente.
  • address: Poner la IP del elemento que queremos monitorizar.
  • group: Grupo al que queremos asignar al agente.
  • gis_exec: Script de posicionamiento (opcional). Si se utiliza, sobreescribe la localización provista por el parámetro general_gis_exec del Satellite Server.
  • Lo siguiente ya sería crear los módulos que queramos que se monitorice en el agente.

Un ejemplo sería:

agent_name Ejemplo1
agent_alias Es un ejemplo
address 127.0.0.1
group Servers

module_begin
module_name Ping
module_ping
module_end

module_begin
module_name Latency
module_latency
module_end

Una vez configurados los datos, iniciamos el Satellite Server mediante el comando:

/etc/init.d/satellite_serverd start

1.7 Eliminación de agentes en Satellite Server

Existen varios casos en relación a la eliminación de agentes de Satellite Server: eliminación total de agentes o eliminación parcial de agentes.

Para la eliminación total de agentes debemos tener en cuenta el método utilizado en la creación de agentes.

  • Manual: Habrá que eliminar, en primer lugar, los ficheros .conf de los agentes creados en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.
  • Fichero satellite_hosts.txt: Habrá que el fichero.txt, así como los .conf que se han creado en la carpeta /etc/pandora/conf, y posteriormente eliminar los agentes en la consola.
  • Recon_task: Habrá que desconfigurar la recon_task en el fichero conf del Satellite Server, posteriormente eliminar los .conf que se han creado en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.

Para la eliminación parcial también debemos de tener en cuenta el método utilizado en la creación de agentes.

  • Manual: Habrá que eliminar, en primer lugar, los ficheros .conf de los agentes que queramos borrar en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.
  • Fichero satellite_hosts.txt: Habrá que eliminar del fichero.txt las líneas de las IPs a eliminar, así como los .conf que se han creado en la carpeta /etc/pandora/conf con esas IPs, y posteriormente eliminar los agentes en la consola.
  • Recon_task: Habrá que configurar la blacklist de la recon_task en el fichero conf del Satellite Server, después borrar los .conf que se han creado en la carpeta /etc/pandora/conf con esas IPs y eliminar los agentes en la consola.

1.8 Configuraciones personalizadas (por agente)

Adicionalmente a los módulos "automáticos", se podrá agregar a la monitorización cualquier chequeo TCP, SNMP, WMI o SSH que esté disponible, usando una sintaxis similar a que se usa para los módulos locales en los agentes software. A continuación vemos algunos ejemplos de módulos válidos para el Satellite Server, tal como se autogeneran después de detectar el sistema.

Template warning.png

¡Asegúrese de que los OID empiezan con un punto o los módulos SNMP no funcionarán!

 


Estado de la interfaz vía SNMP. El Satellite Server detecta automáticamente cada interfaz:

module_begin
module_name if eth1 OperStatus
module_description IP address N/A. Description: The current operational state of the interface. The testing(3) state indicates that no operational packets can be passed.
module_type generic_data_string
module_snmp 192.168.70.225
module_oid .1.3.6.1.2.1.2.2.1.8.3
module_community artica06
module_end

Para obligar al módulo a utilizar SNMP versión 2c añada la línea:

module_version 2c

Para obligar al módulo a utilizar SNMP versión 1 añada la línea:

module_version 1

Por ejemplo:

module_begin
module_name if eth1 OperStatus
module_description IP address N/A. Description: The current operational state of the interface. The testing(3) state indicates that no operational packets can be passed.
module_type generic_data_string
module_snmp 192.168.70.225
module_version 2c
module_oid .1.3.6.1.2.1.2.2.1.8.3
module_community artica06
module_end

Conectividad a una máquina (vía PING):

module_begin
module_name ping
module_type generic_data
module_ping 192.168.70.225
module_end

Comprobación de un puerto (vía TCP):

module_begin
module_name Port 80
module_type generic_proc
module_tcp
module_port 80
module_end

Consulta genérica SNMP. En este caso el Satellite Server saca automáticamente el tráfico de cada interfaz, con su nombre "real" descriptivo:

module_begin
module_name if eth0 OutOctets
module_description The total number of octets transmitted out of the interface, including framing characters.
module_type generic_data_inc
module_snmp 192.168.70.225
module_oid .1.3.6.1.2.1.2.2.1.16.2
module_community public
module_end

Consulta WMI para uso de CPU (porcentaje):

module_begin
module_name CPU
module_type generic_data
module_wmicpu 192.168.30.3
module_wmiauth admin%none
module_end

Consulta WMI para memoria libre (porcentaje):

module_begin
module_name FreeMemory
module_type generic_data
module_wmimem 192.168.30.3
module_wmiauth admin%none
module_end

Consulta genérica WMI:

module_begin
module_name GenericWMI
module_type generic_data_string
module_wmi 192.168.30.3
module_wmiquery SELECT Name FROM Win32_ComputerSystem
module_wmiauth admin%none
module_end


Comando genérico SSH:

module_begin
module_name GenericSSH
module_type generic_data
module_ssh 192.168.30.3
module_command ls /tmp | wc -l
module_end

Para introducir un umbral hay que hacerlo tanto en la definición de texto del modulo (module_min_warning, module_min_critical) como en la definición de umbrales mediante la interfaz web. Por ejemplo:

module_begin
module_name Latency
module_type generic_data
module_latency 192.168.70.225
module_min_warning 80
module_min_critical 120
module_end

Manualmente podemos crear módulos de ejecución. Los scripts o comandos que ejecute el Satellite Server deben estar previamente desplegados y accesibles por el mismo. En este sentido, funciona igual que un module_exec de un agente. Tenga en cuenta que el uso de module_exec puede hacer que el rendimiento del Satellite Server disminuya.

module_begin
module_name Sample_Remote_Exec
module_type generic_data
module_exec /usr/share/test/test.sh 192.168.50.20
module_min_warning 90
module_min_critical 95
module_end

A partir de la versión 7 de Pandora FMS también pueden añadirse plugins. Al igual que estos, hay que tener en cuenta que los plugins se ejecutarán en la máquina donde está corriendo el Satellite Server. Por lo tanto, habrá que implementar en estos plugins algún método para conectarse al equipo remoto que se quiere monitorizar. La ventaja respecto a los anteriores es su gran flexibilidad. De esta forma, se pueden implementar condiciones y otros mecanismos para los que un module_exec se queda corto. La sintaxis es la misma que la de los agentes. Un ejemplo de uso de un plugin podría ser el siguiente:

module_plugin /usr/share/pandora/remote_advanced_checks.sh 192.168.0.1

1.8.1 SNMPv3

Para configurar un módulo SNMPv3, defina module_version a 3 y especifique el nivel de seguridad (noauth, authnopriv o authpriv), nombre de seguridad, protocolo de autenticación (md5 o sha), clave de autenticación, protocolo de privacidad (aes o des) y clave de privacidad según sea necesario. Por ejemplo:

module_begin
module_name snmp_noauth
module_type generic_data_string
module_snmp 127.0.0.1
module_version 3
module_oid .1.3.6.1.2.1.1.1.0
module_seclevel noauth
module_secname snmpuser
module_end
module_begin
module_name snmp_authnopriv
module_type generic_data_string
module_snmp 127.0.0.1
module_version 3
module_oid .1.3.6.1.2.1.1.2.0
module_seclevel authnopriv
module_secname snmpuser
module_authproto md5
module_authpass 12345678
module_end
module_begin
module_name snmp_authpriv
module_type generic_data_string
module_snmp 127.0.0.1
module_version 3
module_oid .1.3.6.1.2.1.1.2.0
module_seclevel authpriv
module_secname snmpuser
module_authproto sha
module_authpass 12345678
module_privproto aes
module_privpass 12345678
module_end

La configuración específica de SNMPv3 se puede compartir entre módulos sacándola fuera de la declaración del módulo, en caso de que sea la misma para todos (también se puede compartir entre agentes moviéndola al fichero de configuración del satélite):

agent_name snmp
address 127.0.0.1

seclevel authpriv
secname snmpuser
authproto md5
authpass 12345678
privproto des
privpass 12345678

module_begin
module_name snmp_authpriv_1
module_type generic_data_string
module_snmp
module_version 3
module_oid .1.3.6.1.2.1.1.1.0
module_end

module_begin
module_name snmp_authpriv_2
module_type generic_data_string
module_snmp
module_version 3
module_oid .1.3.6.1.2.1.1.2.0
module_end

1.9 Cajas de credenciales

Salvo que la autenticación basada en claves esté configurada, los módulos SSH necesitan un nombre de usuario y una contraseña para funcionar. Estos se configuran en el fichero de configuración principal, satellite_server.conf, utilizando cajas de credenciales con el siguiente formato:

credential_box red/máscara,usuario,contraseña
credential_box red/máscara,usuario,[[contraseña cifrada]]

Por ejemplo:

credential_box 192.168.1.1/32,user,pass1
credential_box 192.168.1.0/24,user,pass2

Las búsquedas en las cajas de credenciales se hacen de máscaras más a menos restrictivas.

Las contraseñas se pueden cifrar utilizando Blowfish en modo ECB. Asegúrese de que credential_pass está definido; de otro modo el nombre del host se utilizará como contraseña de cifrado por defecto. La representación hexadecimal del texto cifrado se debe rodear de corchetes dobles:

credential_box 192.168.1.0/24,user,[[80b51b60786b3de2]]

1.10 Vista en la consola de todos los agentes

Si la configuración del Satellite Server ha sido correcta, deberíamos obtener una vista de agentes parecida a esta:


Selección 146.png


Generalmente en todas las máquinas se crearán módulos de tipo ICMP (Ping y Latencia) pero en algunas también se pueden generar módulos de tipo SNMP y WMI. En las que tengan WMI habilitado se generarán los siguientes módulos, de estar disponibles:


Modulos.png


En las máquinas con SNMP habilitado se generarán los siguientes módulos, de estar disponibles:


Modulos1.png


En el apartado de operaciones masivas de la consola de Pandora FMS hay una sección especial dedicada al Satellite Server, donde se pueden realizar diversas acciones de edición y borrado de agentes y módulos de forma masiva:


Operación massivas.png

1.11 Lista negra de SNMP

Al monitorizar redes grandes los módulos SNMP que devuelven datos inválidos pueden afectar al rendimiento del Satellite Server, y llevar a otros módulos a estado Desconocido. Para evitar esto, el Satellite Server puede leer una lista negra de módulos SNMP que serán descartados en el arranque antes de la ejecución.

Para crear una lista negra, edite el fichero de configuración /etc/pandora/satellite_server.conf y asegúrese de que snmp_blacklist está descomentado y configurado con la ruta al fichero en el que se guardarán los módulos de la lista negra. A continuación ejecute:

satellite_server -v /etc/pandora/satellite_server.conf

Reinicie el Satellite Server. La lista negra se puede regenerar tantas veces como sea necesario.

El formato de la lista negra es:

agent:OID
agent:OID
...

Por ejemplo:

192.168.0.1:1.3.6.1.4.1.9.9.27 
192.168.0.2:1.3.6.1.4.1.9.9.27