Pandora FMS: Plugin Enterprise de VMware

Este plugin permite monitorizar ESX, Datastores y VM de las arquitecturas VMware automaticamente. También incorpora muchos modulos para monitorizar arquitecturas virtuales. Para más información visite la siguiente pagina web: http://pandorafms.com/index.php?sec=Library&sec2=repository&lng=en&action=view_PUI&id_PUI=269

1. Pandora FMS
Manual Administrador
Plugin VMware

2. Manual Administrador Plugin VMware
©
 Artica Soluciones Tecnológicas 2005­2012
Índice de contenido
1Histórico de cambios..........................................................................................................................3
2Introducción a la monitorización VMware.........................................................................................4
2.1.Arquitectura VMware a monitorizar .........................................................................................4
3Matriz de compatibilidad ...................................................................................................................5
4Documentación a entregar por el Área que requiere la monitorización.............................................6
5Módulos de agentes de la arquitectura virtual VMware ....................................................................7
5.1.Módulos para agentes del tipo Datastore ..................................................................................7
5.2.Módulos para agentes del tipo host ESXi .................................................................................7
5.3.Módulos para agentes del tipo máquina virtual ........................................................................8
6Requisitos previos a la instalación ..................................................................................................10
6.1.RedHat ....................................................................................................................................10
6.2.SLES .......................................................................................................................................10
6.3.Debian/Ubuntu ........................................................................................................................10
7Instalación de VMware vSphere SDK para Perl .............................................................................11
8Monitorización con VMware Monitoring Plugin ............................................................................12
8.1.Funcionamiento interno del plugin .........................................................................................12
9Registro de plugin ............................................................................................................................13
9.1.Registro con paquete PSPZ .....................................................................................................13
9.2.Registro manual.......................................................................................................................14
9.3.Registro del Recon Script .......................................................................................................15

3. 1 HIST
ÓRICO
 DE CAMBIOS
Fecha Autor Cambio Versión
03/20/12 Dario Primera versión del plugin V1.0r1
03/21/12 Dario Reescrito plugin con cache en ficheros V1.0r2
03/27/12 DarioCorregido bug que cargaba mucho el sistema
al usar el plugin
V2.0r1
03/27/12 Dario Ampliada documentación V2.0r2
Page 3

4. 2 INTRODUCCI
ÓN
 A LA MONITORIZACI
ÓN
 VMWARE
Los entornos virtuales tiene gran importancia en las arquitecturas IT de todas las empresas y por 
ello su monitorizaci
ón es esencial. Con 
Pandora FMS Enterprise podr
ás tener acceso al 
VMware 
Monitoring Plugin  un plugin que permite tener bajo control la arquitectura virtual VMware de 
forma sencilla. 
2.1. Arquitectura VMware a monitorizar 
Con este sistema se pueden monitorizar arquitecturas como la que se muestra en el siguiente 
esquema: 
Pandora FMS puede monitorizar servidores ESXi, Datastores y M
áquinas Virtuales. Pandora FMS se
 
apoya en el API Web que proporciona el vCenter Server de VMware para la recolecci
ón de datos. 
Page 4

5. 3 MATRIZ DE COMPATIBILIDAD 
La matriz de compatibilidad de la monitorizaci
ón VMware es la que se muestra a continuación:
Sistemas donde se ha probado •Vmware 4.1
Sistemas donde deber
ía funcionar
•Vmware 4.1
Page 5

6. 4 DOCUMENTACI
ÓN
 A ENTREGAR POR EL 
Á
REA QUE REQUIERE LA 
MONITORIZACI
ÓN
.
Para la correcta monitorizaci
ón de arquitectura VMware es necesario que el Área técnica envíe
 
cierta informaci
ón que será necesaria para la ejecución de los scripts. La información necesaria es la
 
siguiente:
•IP del servidor donde est
á alojado el vCenter de VMware. 
•Nombre y contrase
ña del usuario creado para la monitorización de VMware. Con permisos
 
de lectura.
•Nombre del Datacenter a monitorizar.
•Archivo   de   configuraci
ón   con   la   lista   de   módulos   a   monitorizar   o   descartar   con   sus
 
respectivos valores.
Page 6

7. 5 MÓ
DULOS
 DE AGENTES DE LA ARQUITECTURA VIRTUAL VMWARE 
Los m
ódulos disponibles para cada elemento de la arquitectura VMware son los siguientes: 
5.1. M
ódulos para agentes del tipo Datastore 
•Capacity: Capacidad m
áxima del Datastore en bytes. 
•Free Space: Porcentaje de espacio libre del Datastore. 
•Disk Overallocation: Porcentaje de sobre asignaci
ón del disco. 
5.2. M
ódulos para agentes del tipo host ESXi 
•Boot Time: 
Última fecha en la que se encendió el host. 
•CPU Info: Informaci
ón general de la CPU (Se crea un módulo por CPU del ESXi). 
•Memory Size: Cantidad total de memoria f
ísica del host en Bytes. 
•Overall CPU Usage: Suma del uso de todas las CPUs en Mhz. 
•Overall Memory Usage: Memoria f
ísica usada en el host en MB. 
•Power State: Estado de la energ
ía del host. 
•SSL Thumbprint: Huella SSL del host. 
•Uptime: Uptime del host en segundos. 
•VNIC Info: Informaci
ón sobre interfaces de red virtuales del host. 
•Host Alive: M
ódulo del tipo Keep Alive que vale 1 si el ESX está conectada y 0 en caso
 
contrario. 
•Connection State: Estado de la conexi
ón del host. 
•Disk Read: Tasa de Kbps leidos del disco. 
•Disk Write: Tasa de Kbps escritos del disco. 
•Disk Read Latency: Latencia de lectura del disco en milisegundos. 
•Disk Write Latency: Latencia de escritura del disco en milisegundos. 
•Data received: Tasa de Kbps recibidos del host. 
•Data transmitted: Tasa de Kbps enviados del host. 
•Packages Received: N
úmero de paquetes recibidos en el intervalo. 
•Packages Transmitted: N
úmero de paquetes enviados en el intervalo. 
•CPU Status: Estado de las cpu f
ísica del host (Hardware Status de VMware) uno por CPU. 
•Disk Status: Estado de los discos f
ísicos del host (Hardware Status de VMware) uno por
 
disco. 
•Mem Status: Estado de la memoria f
ísica del host (Hardware Status de VMware) uno por
 
memoria. 
Page 7

8. 5.3. M
ódulos para agentes del tipo máquina virtual 
Estos m
ódulos ofrecen la información desde el punto de vista de la arquitectura VMware. Si se
 
desea monitorizar otros par
ámetros relativos a la máquina virtual se deberían considerar otras
 
opciones como la Monitorizaci
ón con agentes software
 o la Monitorizaci
ón remota
.
•Boot Time: 
Última fecha en la que se encendió la máquina virtual. 
•Connection State: Estado de la conexi
ón. 
•Consumed Overhead Memory: Cantidad de memoria consumida por la m
áquina virtual en
 
MB. 
•CPU Allocation: Informaci
ón sobre los recursos asignados a la CPU de la máquina virtual. 
•Disk Free: Porcentaje libre del disco de la m
áquina virtual. (Habrá un módulo por cada disco
 
que contenga la m
áquina virtual). 
•Guest State: Modo de operaci
ón del sistema operativo huésped. 
•Host Info: Informaci
ón sobre el host VMware. 
•Host Alive: M
ódulo del tipo Keep Alive que vale 1 si la máquina virtual está en ejecución y 0
 
en caso contrario. 
•Host Memory Usage: Memoria consumida por la m
áquina virtual en MB. 
•Host Name: Nombre del sistema operativo invitado. 
•IP Address: Direcci
ón IP de la máquina. (Aparecerá una por interfaz de red disponible). 
•MAC Address: Direcci
ón MAC de la máquina. (Aparecerá una por interfaz de red disponible).
 
•Max CPU Usage: L
ímite superior de uso de la CPU de la máquina virtual. 
•Max Memory Usage: L
ímite superior de uso de la memoria RAM de la máquina virtual. 
•Memory Allocation: L
ímite de los recursos para la memoria. 
•Memory Overhead: Cantidad de memoria usada por la m
áquina virtual por encima de las
 
necesidades del sistema operativo hu
ésped en Bytes. 
•Overall CPU Demand: Estad
ísticas básicas sobre el rendimiento de la CPU en Mhz. 
•Overall CPU Usage: Estad
ísticas básicas sobre el uso de la CPU en Mhz. 
•Power State: Estado actual de la energ
ía de la máquina virtual. 
•Private Memory: Cantidad de memoria en MB que se otorga a la m
áquina virtual de la
 
memoria no compartida. 
•Shared Memory: Cantidad de memoria en MB que se otorga a la m
áquina virtual de la
 
memoria compartida. 
•Tools Running Status: Estado actual de ejecuci
ón de VMware Tools instaladas en el sistema
 
operativo hu
ésped. 
•Trigger Alarm State: Estado de las alarmas de VMware. 
•Uptime Seconds: Uptime de la m
áquina virtual en segundos. 
•Virtual Image Path: Ruta del archivo de configuraci
ón de la máquina virtual (.vmx). 
•Disk Read: Tasa de Kbps leidos del disco. 
Page 8

9. •Disk Write: Tasa de Kbps escritos del disco. 
•Disk Read Latency: Latencia de lectura del disco en milisegundos. 
•Disk Write Latency: Latencia de escritura del disco en milisegundos. 
•Data received: Tasa de Kbps recibidos del host. 
•Data transmitted: Tasa de Kbps enviados del host. 
•Packages Received: N
úmero de paquetes recibidos en el intervalo. 
•Packages Transmitted: N
úmero de paquetes enviados en el intervalo. 
Page 9

10. 6 REQUISITOS PREVIOS A LA INSTALACI
ÓN
 
Antes de instalar el SDK para Perl de vSphere debemos instalar algunas dependencias. Si surgiera 
alg
ún problema durante la instalación tanto de las  dependencias como del vSphere SDK será
 
necesario consultar la gu
ía proporcionada por VMware en el siguiente enlace: 
http://communities.vmware.com/community/vmtn/developer/documentation
6.1. RedHat 
En RedHat necesitamos instalar el LibXML2 y el paquete OpenSSL para desarrollo, que se instalan 
con el siguiente comando: 
yum install openssl-devel libxml2-dev
6.2. SLES 
Para SLES necesitamos tener instalado el paquete OpenSSL para desarrollo, que podemos instalar 
con el siguiente comando: 
yast -i openssl-devel
6.3. Debian/Ubuntu 
En distribuciones Debian/Ubuntu son necesarios los siguientes paquetes: 
libssl-dev perl-doc liburi-perl libxml-libxml-per libcrypt-ssleay-perl perl-doc
Que instalaremos con la siguiente instrucci
ón: 
sudo apt-get install libssl-dev liburi-perl libxml-libxml-perl libcrypt-ssleay-perl
perl-doc
Si tenemos una versi
ón de 64 bits adicionalmente tenemos que instalar el paquete, como sigue: 
sudo apt-get install ia32-libs
Page 10

11. 7 INSTALACI
ÓN
 DE VMWARE VSPHERE SDK PARA PERL 
Para instalar el SDK primero es necesario descargar la version 4.1 de la web de VMware: 
http://communities.vmware.com/community/developer/downloads
Una vez descargado, descomprimimos el paquete y ejecutaremos el siguiente comando: 
sudo perl vmware-install.pl
Page 11

12. 8 MONITORIZACI
ÓN
 CON VMWARE MONITORING PLUGIN 
La monitorizaci
ón de entornos virtualizado con VMware se basa en dos componentes: 
1.Una recon task que es capaz de extraer los host ESXi, Datastores y las m
áquinas virtuales
 
que est
án disponibles a través del vCenter de VMware. 
2.Un plugin que es el encargado de extraer la informaci
ón a monitorizar en forma de módulos
 
para cada ESXi, Datastore y m
áquina virtual que se ha encontrado en la recon task. 
Con este sistema obtenemos un agente remoto por cada host ESXi, Datastore o m
áquina virtual
 
encontrados.   Esto   que   nos   permitir
á  tratarlos   como   entidades   independientes   sin   importar   la
 
relaci
ón que exista entre ellos dentro de la arquitectura de virtualización. Además cada agente
 
tendr
á los módulos correspondientes para su monitorización según sea ESXi, Datastore o máquina
 
virtual. 
•NOTA: Para poder usar el plugin de VMware y el script de reconocimiento es necesario tener 
activados el pluginserver y el reconserver. 
8.1. Funcionamiento interno del plugin 
Como se ha explicado el plugin VMware de Pandora FMS extrae la informaci
ón a través del
 
vCenter. Para evitar una sobrecarga en la base de datos del vCenter el plugin crea un buffer 
intermedio para cada agente. Este buffer intermedio consiste en un fichero por agente alojado en la 
carpeta /tmp que se renueva cada 300 segundos (5 minutos). De este modo s
ólo se realizará una
 
consulta al vCenter cuando el archivo sea demasiado viejo. 
•NOTA:  Es   muy   importante   tener   en   cuenta   que   los  archivos   con   nombre   tipo 
xxx_pandora_vmware.txt   son   usados   por   el   plugin  para   extraer   los   datos.   Si   estos 
archivos   son  eliminados  el  rendimiento   de   la   base   de   datos   del   vCenter   podr
ía
 
disminuir. 
Page 12

13. 9 REGISTRO DE PLUGIN 
9.1. Registro con paquete PSPZ 
Para el resgistro del plugin VMware Monitoring Plugin usaremos el registro autom
ático de plugins
 
mediante paquetes pspz. Para ello clickamos en el submen
ú 
Register plug­in  del men
ú Manage
 
Servers. 
Despu
és veremos la imagen siguiente donde debemos escoger el archivo vmware­plugin.pspz y
 
pulsar el bot
ón 
Upload. 
Si la operaci
ón ha sido exitosa aparecerá la siguiente pantalla para verificar la operación. 
Page 13

14. Si pulsamos en el submen
ú 
Manage plug­ins del men
ú Manage Server podremos comprobar que el
 
plugin VMware Monitoring Plugin aparece en la lista de plugins. 
En la lista de plugins deber
á aparecer un campo como el que se puede ver en la siguiente imagen
 
mostrando que est
á instalado el plugin 
VMware Monitoring Plugin. 
Con esto tenemos registrado el plugin que permite extraer informaci
ón de la arquitectura VMware. 
9.2. Registro manual
Si   desea   registrar   el   plugin   de   forma   manual   puede   seguir   los   pasos   descritos   en   la   secci
ón
 
Monitorizaci
ón con Plugins
 
Los valores que debe poner en los diferentes campos son los siguientes: 
•Name: VMware Monitoring Plugin 
•Plug­in Command: /var/www/pandora/attachment/plugin/vmware­plugin.pl (Path donde 
est
á el archivo vmware­plugin.pl) 
•Plug­in type: Standard 
•Max. timeout: 300 
•IP address option: ­­server 
•Port option: <vacio> 
•User option: ­­username 
•Password option: ­­password 
•Description: This plugin gets information of VMware vCenter. 
NOTA: Para que las extensiones del plugin VMware funcionen correctamente es importante que el 
nombre del plugin sea exactamente VMware Monitoring Plugin 
Page 14

15. 9.3. Registro del Recon Script 
Ahora tenemos que registrar el  Recon Script  que realiza la b
úsqueda de host ESXi y máquinas
 
virutales. Para ello seleccionamos el submen
ú 
Manage recon script  dentro del men
ú 
Manage 
Servers. 
Una vez que vemos la pantalla inicial del submen
ú 
Manage recon script pulsamos en el bot
ón 
Add. 
Despu
és veremos la ventana para rellenar los datos del nuevo 
Recon Script, en la que rellenaremos 
los datos de manera oportuna como el ejemplo que se ve en la siguiente imagen. En el campo Script 
fullpath  es necesario especificar el interprete o programa con el que se ejecutar
á el script (en
 
nuestro caso perl) y la ruta completa donde est
á situado el script. Una vez relleno el formulario
 
pulsamos en el bot
ón 
Create. 
Page 15

16. Una vez registrado el script veremos una pantalla que informa del correcto funcionamiento de la 
operaci
ón y muestra el script registrado en la lista. 
9.4. Creaci
ón de Recon Task 
Para automatizar el descubrimiento de host y m
áquinas virtuales de la arquitectura virtualizada
 
VMware a monitorizar crearemos una Recon Task que se ejecutar
á cada cierto tiempo buscando
 
nuevos host y m
áquinas virtuales presentes en dicha arquitectura. Para crear una  
Recon Task 
pulsamos en el submen
ú 
Recon Task dentro del men
ú 
Manage Servers. 
Al   pulsar  veremos  la  siguiente  imagen   que   muestra   la   vista  general   de  Recon   Task,   en   ella 
pulsamos en el bot
ón 
Create para crear una nueva tarea. 
Page 16

17. Despu
és de pulsar en el botón 
Create aparecer
á un formulario como el de la siguiente imagen. En el
 
rellenaremos los campos de forma apropiada. En el campo  Mode  es importante seleccionar la 
opci
ón  
Custom Script  ya que nos permitir
á seleccionar en el campo  
Recon Script  el script que 
registramos en el paso anterior (en nuestro caso VMware recon script). 
Los campos Script field est
án reservados para los parámetros del script que hemos registrado. En
 
concreto el script para descubrimiento VMware necesita los siguientes campos obligatorios: 
•server: IP del servidor donde est
á alojado el vCenter de VMware. 
•username: Usuario para acceder al vCenter. 
•password: Password para acceder al vCenter. 
•datacenter: Nombre del datacenter a monitorizar. 
•pluginname: Nombre con el que se registro el plugin VMware (en el registro autom
ático
 
siempre es VMware Monitoring Plugin). 
•pandoraconf: Path donde se encuentra el archivo de configuraci
ón de Pandora FMS. 
•reconconf:   Par
ámetro   opcional   que   indica   el   path   donde   se   encuentra   el   archivo   de
 
configuraci
ón del Recon Script. Si no se especifica un archivo de configuración el script de
 
reconocimiento crear
á todos los módulos con los valores por defecto. 
Si se quiere monitorizar diversos datacenter ser
á necesario crear una 
Recon Task para cada uno de 
ellos especificando el nombre del datacenter en el par
ámetro del script adecuado. 
Por 
último pulsamos el botón 
Add para crear la nueva Recon Task. 
Page 17

18. Al pulsar el bot
ón aparecerá la siguiente pantalla informando que la operación ha sido realizada con
 
é
xito y se mostrara la nueva 
Recon Task en la lista. 
En  este  momento tenemos  una  tarea  de reconocimiento  Recon  Task  que  se  ejecutar
á con  el
 
intervalo seleccionado y crear
á los agentes oportunos extrayendo la información de la arquitectura
 
virtual VMware. 
Page 18

19. 10 MONITORIZACI
ÓN
 DE LA ARQUITECTURA VIRTUAL VMWARE 
Para ver el resultado de la Recon Task simplemente comprobaremos que se ha creado un agente 
por cada m
áquina virtual, ESXi y Datastore. Para ello entramos en el submenú 
Agent Detail dentro 
del men
ú 
View Agents. 
Entonces  se  mostrar
á  la  lista  con  todos  los  agentes  donde   aparecerán  los  agente  del  sistema
 
virtualizado VMware que ha encontrado el script de reconocimiento. En nuestro caso tenemos dos 
m
áquinas ESXi y dos máquinas virtuales. En la lista los host ESX aparecen con el prefijo ESX_ , los
 
datastores con el prefijo DS_ y las m
áquinas virtuales con el prefijo VM_. 
Page 19

20. Si pulsamos en el nombre de un agente veremos la vista de agente de Pandora FMS donde podemos 
ver par
ámetros como la IP del agente y en su descripción vemos que es una agente descubierto con
 
el Recon Script para arquitecturas virtuales VMware. 
Si nos fijamos en la lista de m
ódulos que se crean por defecto para una máquina virtual podemos
 
ver algunos como: Host Alive, Free Disk, Host Name, Connection State, y muchos m
ás... 
Page 20

21. Si pulsamos en una agente que corresponde a un host ESXi veremos una lista de m
ódulos como en
 
la siguiente imagen en la que podemos ver m
ódulos como: bootTime, memorySize, uptime... 
En la siguiente secci
ón se explican más detalladamente la información que reporta cada módulo. 
Page 21

22. 11 GESTI
ÓN
 Y VISUALIZACI
ÓN
 DE LA ARQUITECTURA VIRTUAL VMWARE 
Junto con el plugin VMware se distribuyen dos extensiones  VMware Manager  y  VMware View. 
VMware View permite visualizar todos los componentes de la arquitectura VMware de una forma 
c
ómoda, además con VMware Manager podrá gestionar máquinas virtuales parando, arrancando,
 
reseteando o suspendiendo su actividad desde la consola de Pandora FMS. Estas extensiones son 
opcionales y s
ólo funcionan con versiones de Pandora FMS 4.0 o superior. 
11.1. Instalaci
ón de extensiones VMware Manager y VMware View 
Para instalar las extensiones simplemente debe copiar el contenido de la carpeta extensions que 
encontrar
á al descomprimir el plugin en la carpeta extensions de la parte enterprise de la consola
 
de Pandora FMS, los comandos a ejecutar son los siguientes: 
cp -R extensions/* <pandora_console_dir>/enterprise/extensions/
Desde ese momento ya estar
án las extensiones del plugin VMware. 
11.2. Usando la extensi
ón VMware View 
Para comenzar a usar el visor de arquitecturas VMware haga click en el submen
ú VMware View
 
dentro del men
ú View Agents. 
Page 22

23. La extensi
ón VMware View le mostrará un mapa similar al de abajo con toda la arquitectura
 
VMware que se descubri
ó con la Recon Task. 
El mapa contine los elementos de la arquitectura VMware (m
áquinas virtuales, ESX, Datastores y
 
Datacenters) con diferentes iconos que los identifican as
í como el estado de los agentes de Pandora
 
FMS que representan cada elemento. Adem
ás se muestra la relación que existe entre máquinas
 
virtuales, ESX y DataCenter. De esta manera de un vistazo se puede ver el estado de la arquitectura 
VMware de un forma muy sencilla. 
Esta   extensi
ón   tiene   unas   opciones   que   ayudan   a   mejorar   la   visualización   de   la   arquitecura
 
ocultando elementos, aumentando el tama
ño de letra y permitiendo hacer zoom para poder ver los
 
elementos m
ás de cerca. 
Page 23

24. Usando las opciones anteriores podr
íamos ver sólo los Datacenter y los ESX con un tamaño de
 
fuente 14 y con un zoom de 2x 
11.3. Usando la extensi
ón VMware Manager 
Para usar la extensi
ón VMware Manager debe ir a la vista de operación de un agente que se
 
corresponda con una m
áquina virtual en la arquitectura VMware. Dentro de esta vista podrá ver un
 
icono con el s
ímbolo de VMware que corresponde a la extensión. 
La extensi
ón VMware Manager permite gestionar máquinas virtuales desde la consola de Pandora
 
FMS. La extensi
ón muestra el estado actual de la máquina virtual con un código de colores (verde
 
= encendida, naranaja = suspendida y gris = parada), adem
ás en un combo muestra los estados
 
disponibles y permite cambiar el estado de la m
áquina virtual al selecionado pulsando el botón
 
Change Status. 
Page 24

25. Con esta extensi
ón podríamos parar una máquina virtual que está encendida selecionando el estado
 
Stop como en la siguiente imagen: 
Lo que provocar
ía que la máquina se parase y la vista de la extensión VMware Manage cambiara
 
mostrando que la m
áquina ahora está parada como se ve en la siguiente imagen: 
Page 25

26. 12 CONFIGURACI
ÓN
 DEL RECON SCRIPT 
Por defecto el Recon Script de VMware a
ñade todos los chequeos explicados anteriormente. Para
 
poder escoger que chequeos se desean incluir y caules no se dispone el Recon Script puede leer su 
configuraci
ón de un archivo. Para indicar al Recon Script cual es su archivo de configuración se
 
debe   a
ñadir   a   la   llamada   al   Recon   Script   creada   en   Pandora   FMS   el   parámetro   ­­reconconf
 
<path_file>. 
12.1. Archivo de configuraci
ón del Recon Script 
El archivo de configuraci
ón contiene modificaciones o restricciones a los módulos de Pandora FMS
 
que se crean por defecto. Por lo tanto, si un m
ódulo no está presente en el archivo de configuración
 
se agregar
á con los valores por defecto.Con el archivo de configuración del Recon Script podemos
 
establecer valores m
áximo y mínimos para estados Warning y Critical o deshabilitar el módulo. 
La estructura del archivo de configuraci
ón esta separda por tipos de entidades de la arquitectura
 
VMware (Datastores, ESXi y M
áquinas Virtuales) como sigue: 
#These lines are comments
#Datastore Modules
Datastore
capacity disabled
freeSpace name = Espacio Libre; desc = % Espacio libre datastore; limits = 70 90 91
100
#ESX Modules
ESX
uptime disabled
#VM Modules
VM
ipAddress disabled
macAddress disabled
maxCpuUsage name = Uso CPU; desc = Desc Uso CPU; limits = 60 70 71 100
Cada l
ínea del archivo corresponde a las opciones disponibles para un módulo. Como se puede ver
 
hay dos posibles opciones: 
•<modulo> disabled: El m
ódulo 
NO se crear
á 
•<modulo>   name   =   <nombre>;   desc   =   <descripcion>;   limits   =   <min_warning> 
<max_warning> <min_critical> <max_critical>: El m
ódulo se creará con el nombre y la
 
descripci
ón proporcionados y además se definirán los umbrales para los máximos y mínimos
 
de los valores Warning y Critical. 
Es muy importante tener en cuenta la estructura de las l
íneas del archivo de configuración
 y 
sobre todo ver que el caracter ; va pegado al nombre y la descripci
ón del módulo. Estas dos líneas
 
NO SON EQUIVALENTES (veanse los espacios antes del caracter ; ): 
Page 26

27. maxCpuUsage name = Uso CPU; desc = Desc Uso CPU; limits = 60 70 71 100
maxCpuUsage name = Uso CPU ; desc = Desc Uso CPU ; limits = 60 70 71 100
Los m
ódulos están referenciados por su nombre corto, un nombre equivalente más sencillo de
 
escribir en la l
ínea de comandos. La tabla de correspondencia entre nombres cortos y expandidos
 
est
á en la siguiente sección. 
Analicemos el archivo de configuraci
ón de ejemplo: 
Para los Datastores hemos decidido que le m
ódulo Capacity no nos interesa y por ello ponemos la
 
opci
ón disabled. Por otra parte el módulo Free Space se creará con los valores: 
* Nombre: Espacio Libre
* Descripción: % Espacio libre datastore
* Min Warning: 70
* Max Warning: 90
* Min Critical: 91
* Max Critical: 100
Para monitorizar los ESXi hemos decidido deshabilitar el m
ódulo Uptime porque no lo creemos
 
necesario. Los dem
ás módulos disponibles se mostraran con los parámetros por defecto. 
Para las m
áquinas virtuales hemos deshabilitado los módulos IP Address y MAC Address, además
 
hemos definido los par
ámetros para el módulo Max CPU Usage. Recordemos que los módulos no
 
deshabilitados se crear
án con los valores por defecto. 
NOTA: Todos los errores relativos al archivo de configuraci
ón son presentados como eventos en la
 
consola de Pandora FMS, por ello consultando el visor de eventos puede ver si ha ocurrido alg
ún
 
problema al leer el archivo de configuraci
ón. 
12.2. Ejemplos archivo configuraci
ón 
12.2.1. Archivo con todos los m
ódulos desactivados 
#These lines are comments
#Datastore Modules
Datastore
capacity disabled
freeSpace disabled
overallocation disabled
#ESX Modules
ESX
bootTime disabled
cpuInfo disabled
memorySize disabled
overallCpuUsage disabled
overallMemoryUsage disabled
powerState disabled
Page 27

28. sslThumbprint disabled
uptime disabled
vnicInfo disabled
hostAlive disabled
connectionState disabled
diskRead disabled
diskWrite disabled
diskReadLatency disabled
diskWriteLatency disabled
netReceived disabled
netTransmitted disabled
netPkgRx disabled
netPkgTx disabled
cpuStatus disabled
storageStatus disabled
memStatus disabled
memoryAllocation disabled
#VM Modules
VM
bootTime disabled
connectionState disabled
consumedOverheadMemory disabled
cpuAllocation disabled
diskFree disabled
guestState disabled
host disabled
hostAlive disabled
hostMemoryUsage disabled
hostName disabled
ipAddress disabled
macAddress disabled
maxCpuUsage disabled
maxMemoryUsage disabled
memoryAllocation disabled
memoryOverhead disabled
overallCpuDemand disabled
overallCpuUsage disabled
powerState disabled
privateMemory disabled
sharedMemory disabled
toolsRunningStatus disabled
triggeredAlarmState disabled
uptimeSeconds disabled
virtualImagePath disabled
uptimeSeconds disabled
diskRead disabled
diskWrite disabled
diskReadLatency disabled
diskWriteLatency disabled
netReceived disabled
netTransmitted disabled
netPkgRx disabled
netPkgTx disabled
Page 28

29. 12.3. Tabla de correspondencia de nombres cortos 
12.3.1. Datastores 
Nombre Expandido Nombre Corto
Capacity capacity
Free Space freeSpace
Disk Overallocation overallocation
12.3.2. ESX 
Nombre Expandido Nombre Corto
Boot Time bootTime
CPU Info cpuInfo
Memory Size memorySize
Overall CPU Usage overallCpuUsage
Overall Memory Usage overallMemoryUsage
Power State powerState
SSL Thumbprint sslThumbprint
Uptime uptime
VNIC Info vnicInfo
Host Alive hostAlive
Connection State connectionState
Disk Read diskRead
Disk Write diskWrite
Disk Read Latency diskReadLatency
Disk Write Latency diskWriteLatency
Data received netReceived
Data transmitted netTransmitted
Packages Received netPkgRx
Packages Transmitted netPkgTx
CPU Status cpuStatus
Disk Status storageStatus
Mem Status memStatus
12.3.3. M
áquinas Virtuales 
Nombre Expandido Nombre Corto
Boot Time bootTime
Connection State connectionState
Consumed Overhead Memory consumedOverheadMemory
CPU Allocation cpuAllocation
Disk Free diskFree
Guest State guestState
Page 29

30. Host Info host
Host Alive hostAlive
Host Memory Usage hostMemoryUsage
Host Name hostName
IP Address ipAddress
MAC Address macAddress
Max CPU Usage maxCpuUsage
Max Memory Usage maxMemoryUsage
Memory Allocation memoryAllocation
Memory Overhead memoryOverhead
Overall CPU Demand overallCpuDemand
Overall CPU Usage overallCpuUsage
Power State powerState
Private Memory privateMemory
Shared Memory sharedMemory
Tools Running Status toolsRunningStatus
Trigger Alarm State triggeredAlarmState
Uptime Seconds uptimeSeconds
Virtual Image Path virtualImagePath
Disk Read diskRead
Disk Write diskWrite
Disk Read Latency diskReadLatency
Disk Write Latency diskWriteLatency
Data received netReceived
Data transmitted netTransmitted
Packages Received netPkgRx
Packages Transmitted netPkgTx
Page 30