Monitorización de entornos Virtuales

Volver al Índice de Documentación Pandora FMS

Los entornos virtuales tienen una gran importancia en las arquitecturas IT de todas las empresas y por ello su monitorización es esencial. Con Pandora FMS Enterprise podrá tener acceso a Amazon EC2, VMware, RHEV, Nutanix, XenServer, OpenNebula, IBM HMC, HPVM.

Para monitorizar EC2 en entornos Enterprise, por favor, diríjase a Discovery

Esta monitorización específica utiliza el CloudWatch API para monitorizar sus instancias en el servicio Amazon EC2. Necesita tener Cloudwatch habilitado en su instancia. Puede obtener el plugin gratuito en la sección de la librería de módulos.

La idea principal de este plugin de servidor remoto es obtener información de sus instancias utilizando el servidor de plugin de Pandora FMS. Esto significa que necesitará registrar el plugin en el servidor y configurar los diferentes Módulos para que recuperen la información de sus servidores EC2.

Ejemplo de la ejecución utilizando el conector \>

 /home/slerena/ec2_plugin.sh \
          -A AKIAILTVCAS26GTKLD4A \
          -S CgmQ6DxUWES05txju+alJLoM57acDudHogkLotWk \
          -i i_9d0b4af1 \
          -n AWS/EC2 \
          -m CPUUtilization

Devolverá un valor numérico (porcentaje) de la métrica CPUUtilization en la instancia i_9d0b4af1.

Para la instalación necesita:

1. Tener disponible JAVA en su servidor Pandora FMS con su correspondiente directorio JAVAHOME.

2. Copiar este plugin a una ruta y fijar los permisos en 755, configurar la ruta base en la variable AWS_CLOUDWATCH_HOME que está presente en las primeras líneas del plugin. Debe editar las primeras líneas del plugin .

El plugin tiene varios ficheros:

/ec2_plugin.sh - El plugin en sí. /bin/* - Componentes de Amazon CloudWatch (Monitoring) Command Line Tools, incluidos en este paquete. Estos scripts están distribuidos bajo la Licencia Apache.

Ubique el paquete completo en un directorio accesible por el servidor; por ejemplo:

/usr/share/pandora_server/plugin/ec2

Y fije el AWS_CLOUDWATCH_HOME en /usr/share/pandora_server/plugin/ec2.

Para confirmar la instalación ejecute:

/usr/share/pandora_server/plugin/ec2/mon-cmd --version

Debería devolver algo similar a:

Amazon CloudWatch CLI version 1.0.9.5 (API 2010-08-01)

Si obtiene la misma cadena, entonces ya está listo para utilizar el plugin.

Si no, probablemente necesitará instalar y configurar adecuadamente a continuación las herramientas de línea de comandos del Amazon CloudWatch (monitorización).

Requisitos:

• Asegúrese de tener instalada en su sistema la versión de Java 1.5 o superior, ejecute para ello:

java -version

• Descomprima el fichero .zip de despliegue.
• Fije las siguientes variables de entorno:
  • AWS_CLOUDWATCH_HOME - El directorio donde se copiaron los ficheros de despliegue para chequearlos con:

 Unix: ls ${AWS_CLOUDWATCH_HOME}/bin (should list mon-list-metrics ...)
 Windows: dir %AWS_CLOUDWATCH_HOME%\bin (should list mon-list-metrics ...)

• JAVA_HOME - Directorio Home de la instalación de Java.
• Añada a la ruta predeterminada (path) lo siguiente:

${AWS_CLOUDWATCH_HOME}/bin

• En Windows:

%AWS_CLOUDWATCH_HOME%\bin

Establezca sus credenciales AWS de usuario en la herramienta de línea de comandos. Existen dos maneras para proporcionar las credenciales:

1. Las contraseñas AWS.
2. Utilizando los certificados X.509.

Puede especificar de manera explícita las credenciales en la línea de comando:

1. -I ACCESS_KEY --S SECRET_KEY

También puede crear un fichero de credencial. El despliegue incluye un fichero de plantilla:

${AWS_CLOUDWATCH_HOME}/credential-file-path.template.

Debe editar una copia de este fichero para añadir su información. En UNIX también pasa por limitar los permisos para el propietario del fichero de credenciales ( credential-file ):

$ chmod 600 <credential-file>.

Una vez creado el archivo, referencie así:

• Fije la siguiente variable de entorno al mismo:

export AWS_CREDENTIAL_FILE=<credential-file>

• También puede proporcionar la siguiente opción con cada comando:

1. -aws-credential-file <credential-file>

Grabe el certificado y contraseña privadas en los ficheros: my_cert.pem y my-pk.pem.

Existen dos modos de proporcionar la información certificada a la línea de comandos:

• Fije las siguientes variables de entorno:

 EC2_CERT=/path/to/cert/file
 EC2_PRIVATE_KEY=/path/to/key/file

• Especifique los ficheros directamente en la línea de comandos para todos los comandos:

 <command> \
      --ec2-cert-file-path=/path/to/cert/file \
      --ec2-private-key-file-path=/path/to/key/file

Al fijar la variable de entorno SERVICE_JVM_ARGS, podrá pasar arbitrariamente las propiedades JVM a la línea de comando.

Por ejemplo, la siguiente línea fija las propiedades en Linux/UNIX

export SERVICE_JVM_ARGS="-Dhttp.proxyHost=http://my.proxy.com -Dhttp.proxyPort=8080"

Compruebe que su instalación funcione correctamente ejecutando el siguiente comando:

 $ mon-cmd --help

Debería ver la página de uso para todos los comandos de monitorización.

 $ mon-list-metrics --headers

Debería ver también una línea de cabecera. Si tiene alguna métrica definida, debería aparecer también.

Con Pandora FMS Enterprise podrá tener acceso a VMware Monitoring Plugin, un plugin que permite tener bajo control la arquitectura virtual VMware de forma sencilla.

Con este sistema se pueden monitorizar arquitecturas como las que se muestran en el siguiente esquema:

Pandora FMS puede monitorizar VCenter, servidores ESXi, y los componentes que virtualizan: Datastores y Máquinas Virtuales. Pandora FMS se apoya en el API que proporciona el SDK de VMware® para Perl para la recolección de datos.

Siga los pasos descritos en Discovery para monitorizar su infraestructura VMware®.

Los requisitos para el funcionamiento de la tarea de monitorización de VMware® son los siguientes:

• Pandora FMS v7.0NG.732 o superior.
• VMware vSphere® SDK para lenguaje Perl.

Discovery Applications VMware hace uso de las métricas que proporciona la API de los vCenter® y ESXi VMware®. La disponibilidad de estas métricas depende de los niveles configurados para recolección de estadísticas.

Estos niveles se pueden cambiar en el menú vCenter Server Settings y en la opción Statistics. Para cada opción de tiempo y cada nivel obtendrá la descripción de los contadores que recolecta el vCenter. El nivel mínimo para monitorizar con el plugin de Pandora FMS es el Nivel 2.

Dependiendo de la configuración del vCenter, es posible que algunos módulos no reporten datos en Pandora FMS. Esto puede ser porque:

• Falte instalar algún plugin en el vCenter.
• Sea necesario instalar un agente VMware® (vmware-tools) en la entidad.
• Simplemente porque la entidad esté apagada (máquina virtual o ESXi).

Para solucionar estos problemas deberá consultar la documentación de VMware.

Algunas soluciones, como por ejemplo, la monitorización del estado del hardware (Hardware Status), podrían requerir una configuración avanzada tanto del vCenter como de los host que soportan los ESX.

A partir de la versión 732 de Pandora FMS, la monitorización de VMware se realiza utilizando el sistema Discovery Applications (más información en Discovery VMware).

Si por algún motivo en particular se desea configurar manualmente el plugin fuera de esta funcionalidad, puede utilizar el modo clásico descrito a continuación.

Si requiere desplegar o actualizar su versión del plugin de VMware® por una más reciente, por favor siga los pasos descritos en los puntos siguientes:

1.- Acceda al directorio en el que se han extraído los ficheros del plugin VMWare®.

2.- Copie vmware-plugin.{pl,conf} al directorio correspondiente.

 sudo cp vmware-plugin.pl vmware-plugin.conf /usr/share/pandora_server/util/plugin/
 sudo chown pandora:apache /usr/share/pandora_server/util/plugin/vmware-plugin.{pl,conf}
 sudo chmod g+w /usr/share/pandora_server/util/plugin/vmware-plugin.conf

3.- Verifique los datos necesarios para configurar el plugin y utilizar la API de Pandora FMS.

En el menú "Configuración" de la consola de Pandora FMS asigne una contraseña a la API, así como la lista con las direcciones IP permitidas.

4.- Edite el fichero de configuración vmware-plugin.conf.

5.- Verifique la disponibilidad de VMware® SDK para Perl.

Puede lanzar un script con el siguiente contenido para validar su instalación de VMware® SDK Perl

 #!/usr/bin/perl

 use strict;
 use warnings;

 use VMware::VIRuntime;

 print "VMware SDK Version: " . $VMware::VIRuntime::VERSION . "\n";

Ejecute el script:

perl check_vmware.pl

La salida debe ser similar a la siguiente:

VMware SDK Version: 6.5.0

La URL del centro de descargas para el software VMware® requerido es:

https://my.vmware.com/web/vmware/details?downloadGroup=VS-PERL-SDK65&productId=614

Primero descomprima el SDK con el siguiente comando:

# tar -xzvf VMware-vSphere-Perl-SDK-x.x.x-xxxxxx.i386.tar.gz

Ahora compile e instale el SDK con los siguientes comandos:

 # perl Makefile.PL
 # make
 # make install

Si la instalación fue correcta y no se mostró ningún error podrá conectar con el vCenter® con el siguiente comando, en este ejemplo se usa el conector de líneas \:

 # /usr/lib/vmware-viperl/apps/general/connect.pl \
      --server <vcenter_ip> \
      --username <vcenter_user> \
      --password <vcenter_pass>

La respuesta debería ser similar a la que aparece a continuación:

 Connection Successful
 Server Time : 2013-02-21T16:24:05.213672Z

Actualización SDK a 6.5 desde otras versiones

Si está realizando una actualización del SDK de VMware®, siga los siguientes pasos:

• Instale las herramientas para desarrolladores:

yum groupinstall "Developer Tools"

• Instale CPAN:

yum install perl-CPAN

• Instalar algunas dependencias:

 yum install openssl-devel perl-Class-MethodMaker
 yum install epel-release

• Descomprimir los archivos de instalación de VMware® SDK Perl:

tar xvzf VMware-vSphere-Perl-SDK-6.5.0-4566394.x86_64.tar.gz

• Acceda al directorio:

cd vmware-vsphere-cli-distrib

• Lance el instalador:

./vmware-install.pl

Durante la instalación:

• Acepte la licencia.
• Indique no utilizar los módulos preconstruidos para VMware® SDK.
• Acepte la instalación automática de los módulos a través del sistema automatizado por CPAN.
• Verifique que todos los requisitos se han instalado correctamente.
• Indique el directorio donde se deberán instalar los módulos de VMware® SDK Perl

• Instale las dependencias necesarias para UUID-0.03:

yum install libuuid-devel perl-JSON-PP

• Descargue el paquete de código:

wget https://cpan.metacpan.org/authors/id/C/CF/CFABER/UUID-0.03.tar.gz

• Descomprima el fichero y acceda al directorio:

 tar xvzf UUID-0.03.tar.gz
 cd UUID-0.03

• Genere los archivos necesarios para la compilación del módulo Perl:

perl Makefile.PL

• Compile el módulo Perl:

make

• Deberá recibir una respuesta similar a:

Manifying blib/man3/UUID.3pm

• Instale el nuevo módulo compilado:

make install

Una vez instalados los módulos pendientes vuelva a ejecutar el proceso de instalación de VMware® SDK Perl:

./vmware-install.pl

Debe realizar los siguientes pasos manualmente:

• Limpiar librerías antiguas.

 rm -rf /usr/share/perl5/vendor_perl/VMware
 rm -rf /usr/share/perl5/VMware

• Agregar las nuevas librerías VMware®

cp -R /usr/lib/vmware-vcli/VMware/share/VMware /usr/share/perl5/vendor_perl/

Una vez hecho esto puede lanzar un script con el siguiente contenido para validar su instalación de VMware® SDK Perl

 #!/usr/bin/perl

 use strict;
 use warnings;

 use VMware::VIRuntime;

 print "VMware SDK Version: " . $VMware::VIRuntime::VERSION . "\n";

Ejecute el script:

perl check_vmware.pl

La salida debe ser la siguiente:

VMware SDK Version: 6.5.0

Si la salida es diferente, por favor verifique que ha seguido todos los pasos correctamente o póngase en contacto con soporte en https://support.pandorafms.com/integria/

Las dependencias SDK para CentOS 7 son:

 gdbm-devel
 glibc-devel
 glibc-headers
 kernel-headers
 libdb-devel
 libuuid-devel
 make
 openssl
 perl-Business-ISBN
 perl-Business-ISBN-Data
 perl-Class-Inspector
 perl-Class-MethodMaker
 perl-Convert-BinHex
 perl-Crypt-SSLeay
 perl-Digest
 perl-Digest-MD5
 perl-Email-Date-Format
 perl-Encode-Locale
 perl-ExtUtils-Install
 perl-ExtUtils-MakeMaker
 perl-ExtUtils-Manifest
 perl-ExtUtils-ParseXS
 perl-File-Listing
 perl-HTML-Parser
 perl-HTML-Tagset
 perl-HTTP-Cookies
 perl-HTTP-Daemon
 perl-HTTP-Date
 perl-HTTP-Message
 perl-HTTP-Negotiate
 perl-IO-HTML
 perl-IO-SessionData
 perl-IO-Socket-IP
 perl-IO-Socket-SSL
 perl-JSON-PP
 perl-LWP-MediaTypes
 perl-LWP-Protocol-https
 perl-MIME-Lite
 perl-MIME-Types
 perl-MIME-tools
 perl-MailTools
 perl-Mozilla-CA
 perl-Net-HTTP
 perl-Net-LibIDN
 perl-Net-SMTP-SSL
 perl-Net-SSLeay
 perl-SOAP-Lite
 perl-Test-Harness
 perl-TimeDate
 perl-URI
 perl-WWW-RobotRules
 perl-XML-LibXML
 perl-XML-NamespaceSupport
 perl-XML-Parser
 perl-XML-SAX
 perl-XML-SAX-Base
 perl-devel
 perl-libwww-perl
 pyparsing
 systemtap-sdt-devel
 glibc
 glibc-common
 libblkid
 libmount
 libsmartcols
 libuuid
 util-linux

Puede instalar las dependencias extras para plugin con el siguiente comando:

yum install perl-Archive-Zip perl-JSON

Puede instalar las dependencias de cifrado de contraseña con el siguiente comando:

yum install openssl-devel perl-Crypt-CBC perl-Digest-SHA

También puede descargar los RMPs personalizados de perl-Crypt-OpenSSL-AES desde el repositorio de Artica:

• Para CentOS 7.

yum install https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20CentOS%2C%20RHEL/perl-Crypt-OpenSSL-AES-0.02-1.el7.x86_64.rpm

Instale las dependencias:

apt update
apt-get install -y lib32z1 build-essential uuid \
  uuid-dev libssl-dev perl-doc libxml-libxml-perl \
  libcrypt-ssleay-perl libsoap-lite-perl libmodule-build-perl

Descargue desde nuestro repositorio:

wget https://firefly.artica.es/pandorafms/utils/VMware-vSphere-Perl-SDK-7.0.0-16453907.x86_64.tar.gz

Descomprima e instale:

tar xvzf VMware-vSphere-Perl-SDK-7.0.0-16453907.x86_64.tar.gz
cd vmware-vsphere-cli-distrib/
sed --follow-symlinks -i -e "s/[^#].*show_EULA().*/  #show_EULA();/g" vmware-install.pl
./vmware-install.pl --default
cpan Crypt::OpenSSL::AES

La versión de PERL que se distribuye con el vSphere® SDK no funciona con las librerías de VMware® para PERL. Para solucionar este problema siga los siguientes pasos:

• Instale el VMware vSphere® SDK.
• Instale Strawberry PERL versión 5.12 de http://strawberryperl.com/releases.html.
• Copie el directorio:

%ProgramFiles%\VMware\VMware vSphere CLI\Perl\lib\VMware

a

C:\strawberry\perl\lib

• Desinstale el VMware vSphere® SDK.

Puede configurar el plugin de VMware® manualmente o utilizando la extensión para consola disponible junto con los archivos descargables del plugin de VMware®.

Puede editar manualmente el fichero de configuración; recuerde que las líneas que empiezan por # serán interpretadas como comentarios.

De manera predeterminada la extensión de VMware® descubre todas las entidades y añade los chequeos por defecto. Mediante el archivo de configuración podrá configurar la monitorización y escoger qué variables desea monitorizar.

El archivo de configuración contiene toda la información necesaria para realizar la monitorización, agrupada en las siguientes secciones:

• Configuration .
• Rename.
• Reject.
• Datacenter.
• Datastore.
• ESX.
• VM.

La configuración general está definida por el token Configuration y contiene los siguientes parámetros:

• server

FQDN o dirección IP del servidor VMware® a monitorizar.

• datacenter

Nombre del datacenter (por defecto: ha-datacenter).

• user

Usuario con permisos de lectura en vCenter®.

• pass

Contraseña del usuario en vCenter®.

• group

Grupo de destino de los agentes generados por el plugin, por ejemplo “Servers” o “Workstations”.

• use_encrypted_password

Utilize contraseñas cifradas, use el comando:

perl vmware-plugin.pl --generate_password

Para crearlo, debe agregar token para pasar la contraseña generada; agregue en el fichero de configuración:

use_encrypted_password 1

• interval

Intervalo en segundos de los Agentes y Módulos que se generarán (ajustar conforme a la frecuencia de ejecución del plugin).

• threads

Número máximo de hilos a utilizar (por defecto 1, recomendado 4 ).

• recon_interval

Intervalo en segundos tras el que se autoeliminará el fichero temporal de caché de entidades para reexplorar la infraestructura VMware® .

• virtual_network_monitoring

Incluir la monitorización de switches virtuales ( 1 ) o no ( 0 ).

• logfile

Ruta y nombre del archivo para registrar datos, por defecto /tmp/vmware_plugin.log

• entities_list

Archivo de entidades a monitorizar, por defecto /tmp/vmware_entitites_list.txt . Véase también escaneo de entidades.

• event_pointer_file

Archivo de índices auxiliar para eventos VMware, por defecto /tmp/vmware_events_pointer.txt .

• temporal

Directorio de trabajo temporal, por defecto: /tmp .

• transfer_mode

Modo de transferencia de XML a Pandora FMS, puede ser tentacle o local (por defecto local):

1. tentacle: Envía los archivos XML al servidor de Pandora FMS usando el protocolo Tentacle.
2. local: Copia los archivos a una carpeta local; el Agente debe ejecutarse en la misma máquina donde se encuentra la carpeta local.

• tentacle_client

Para utilizar Tentacle como herramienta de transferencia se debe configurar como cliente: tentacle_client tentacle_client .

• tentacle_ip

Dirección del servidor de Pandora FMS, por defecto 127.0.0.1 .

• tentacle_port

Puerto para comunicaciones Tentacle, por defecto 41121 .

• tentacle_opts

Opciones extra para Tentacle remoto. Por defecto ninguna opción extra.

• local_folder

En transferencia local, carpeta de destino para los XML de informe /var/spool/pandora/data_in .

• pandora_url

Dirección web de la consola de Pandora FMS, por defecto:

http://127.0.0.1/pandora_console

• api_pass

Contraseña de la API de la Consola de Pandora FMS.

• api_user

Usuario con acceso a la API de Pandora FMS.

• api_user_pass

Contraseña del usuario con acceso a la API de Pandora FMS.

• retry_send

Reintentar ( 1 ) o no ( 0 ) el envío de XML en caso de error (similar a buffer_xml).

• event_mode

Recuperar información ( 1 ) de eventos de VMware® o no ( 0 ).

• verbosity

Nivel de debug o depurado de procesos (recomendado 1 ).

• virtual_network_monitoring

Habilita ( 1 ) o deshabilita ( 0 ) la monitorización de switches virtuales (estándar).

• use_ds_alias_as_name

Habilita ( 1 ) o deshabilita ( 0 ) el uso de un alias como nombre de Agente en agentes de almacenamiento de datos.

Un ejemplo de esta sección en el archivo de configuración podría ser la siguiente:

 Configuration
 server 192.168.70.249
 user Administrator
 pass S1stemas
 datacenter artica
 temporal /tmp
 logfile /tmp/vmware_plugin.log
 entities_list /tmp/vmware_entities_list.txt
 transfer_mode tentacle
 tentacle_ip 192.168.70.81
 tentacle_port 41121
 tentacle_opts
 local_folder /var/spool/pandora/data_in
 pandora_url http://192.168.70.81/pandora_console
 api_pass 1234
 api_user admin
 api_user_pass pandora
 event_mode 0
 event_pointer_file /tmp/vmware_events_pointer.txt

Debido al tamaño de las infraestructuras VMware® que caracteriza a los clientes Enterprise, un escaneo general de todas las entidades disponibles en cada ejecución podría desencadenar problemas de rendimiento.

Para evitar esta situación, el plugin de monitorización de VMware® dispone del archivo de entidades ( entities_list ) donde almacena la lista de entidades escaneadas en la primera ejecución.

Siempre que este archivo exista, la monitorización se limitará a las entidades indicadas en él.

Si necesita un escaneo periódico de su infraestructura VMware®, puede eliminar este fichero cada cierto tiempo (por ejemplo, cada hora) usando el cron de sistema.

El renombrado de entidades se realiza usando el token RENAME y permite cambiar el nombre a las entidades descubiertas por el plugin. Usando esta funcionalidad los Agentes creados en Pandora FMS aparecerán con el nuevo nombre asignado. La estructura de esta sección es la siguiente:

<nombre actual> TO <nombre nuevo>

Un ejemplo de configuración de esta sección podría ser el siguiente:

 #Rename entities
 Rename
 Debian 11 TO Virtual Machine 1
 RedHat 12 TO Web server
 ESX Workstation TO Host Work Sales

El plugin permite realizar un descarte de entidades por tipo o de forma individual; a continuación se explican ambas opciones.

El descarte de tipos de entidades se realiza usando el token REJECT. En esta sección podrá descartar las entidades según su tipo; por ejemplo todas las máquinas virtuales o todos los hosts ESX. Los posibles valores que puede tomar esta sección son los siguientes:

all_datastore

all_datacenter

all_esx

all_vm

all_ipaddresses

Una configuración de esta sección que descarta todas las entidades sería la siguiente:

 #Dismissed entities
 Reject
 all_datastore
 all_datacenter
 all_esx
 all_vm

Para realizar un descarte de entidades de forma individual será necesario borrarlas del archivo de entidades creado por el plugin. El plugin crea este archivo en la ubicación indicada en el parámetro entities_list (por defecto /tmp/vmware_entities_list.txt). El plugin rellena el contenido de este archivo con la primera ejecución, o siempre que no exista, creando una lista con todas las entidades descubiertas.

Un ejemplo de archivo podría ser el siguiente:

 Datacenter
 artica
 Datastore
 datastore_1
 datastore2
 ESX
 192.168.70.252
 VM
 Pandora FMS 4.0.3
 Debian2
 Debian3
 Debian4
 Redhat
 debian5
 Debian6
 Debian8
 Debian7
 Debian11
 Debian10
 Debian9
 NSM
 Pandora
 vcenter
 suse11.2

El archivo de configuración se divide en varios tokens: Datacenter, Datastore, ESX y VM, donde se listan las diferentes entidades. Una vez que esté creado el archivo de configuración, el plugin leerá de este archivo las entidades a monitorizar. Para descartar una entidad solo tiene que borrarla de este fichero. Si, por ejemplo, no se necesita monitorizar las entidades: Debian2, datastore2, NSM, suse11.2 y 192.168.70.252, el archivo de configuración quedaría así:

 Datacenter
 artica
 Datastore
 datastore_1
 ESX
 VM
 Pandora FMS 4.0.3
 Debian3
 Debian4
 Redhat
 debian5
 Debian6
 Debian8
 Debian7
 Debian11
 Debian10
 Debian9
 Pandora
 vcenter

Esta funcionalidad permite realizar una distribución de la carga de monitorización limitando el número de entidades monitorizadas en cada ejecución del plugin. Más adelante se explican varias técnicas de distribución de carga.

La sección Reject, del plugin de monitorización de entornos VMware® contiene, además, la siguiente opción:

all_ipaddresses

Si esta instrucción está presente, la dirección IP en el XML no será actualizada. Lo que significa que si se habilita esta opción el plugin/tarea de Discovery de VMware no actualizará el campo ip address de los agentes. Esta instrucción también es válida para las tareas de reconocimiento del Discovery sobre VMware®.

Las siguientes secciones del archivo configuran los Módulos creados para cada tipo de entidad. Las secciones usan los tokens Datacenter, Datastore, ESX, VM. En estas secciones podrá habilitar/deshabilitar los Módulos a monitorizar. En el siguiente ejemplo hemos realizamos una configuración seleccionando los módulos que deseamos crear para los ESX y máquinas virtuales:

 ...
 #ESX Modules
 ESX
 cpuUsagePercent disabled
 diskRead enabled
 diskWrite enabled

 #VM Modules
 VM
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate enabled
 ...

Cada línea de configuración se corresponde con un Módulo. En el ejemplo anterior los Módulos serán creados con los valores por defecto, pero es posible configurar el nombre, la descripción y los límites para los estados de Advertencia y de Crítico del Módulo. Un ejemplo de esta configuración podría ser la siguiente:

 ...
 #VM Modules
 ESX
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate name = Tasa Disco; desc = Tasa Lec/Esc disco; limits_warn = 5 10; limits_crit = 0 4
 ...

Las opciones disponibles para la configuración de Módulos son las siguientes:

• <modulo> disabled: El módulo NO se creará.
• <modulo> enabled: El módulo SI se creará (con los valores por defecto).
• <modulo> name = <nombre>; desc = <descripcion>; limits_warn <lim_warn>; limits_crit <lim_crit» 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 estados de Advertencia y Crítico.

Es muy importante tener en cuenta la estructura de las líneas del archivo de configuración y sobre todo comprobar que el carácter ; va pegado al nombre y la descripción del Módulo. Estas dos líneas NO SON EQUIVALENTES (véanse los espacios antes del carácter ; ):

diskRate name = Tasa Disco; desc = Tasa Lec/Esc disco; limits_warn = 5 10; limits_crit = 0 4
diskRate name = Tasa Disco    ; desc = Tasa Lec/Esc disco    ; limits_warn = 5 10; limits_crit    = 0    4

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 de nombres cortos y expandidos se encuentran en la siguiente sección.

Analice la configuración de ejemplo anterior. Se ha configurado el módulo Disk Rate que se creará con los siguientes valores:

 * Nombre: Tasa Disco
 * Descripción: Tasa Lec/Esc disco
 * Min Warning: 5
 * Max Warning: 10
 * Min Critical: 0
 * Max Critical: 4

Hay módulos que se generan de forma dinámica, por ejemplo los relativos a discos o interfaces de red. Para estas métricas el plugin crea un Módulo por cada elemento descubierto. Estos Módulos suelen tener nombres especiales en Pandora FMS, por ejemplo:

Disk Free [0]
Disk Free [1]
Disk Free [2]
...

En estos casos, como el nombre tiene parte dinámica se permite el uso de la macro %s que será sustituida por la parte variable del nombre del Módulo. Un ejemplo de configuración de módulos dinámicos sería el siguiente:

diskFree name = Disk (%s) free space; desc = Free space for disk; limits_warn = 0 0; limits_crit = 0 0

En este caso el nombre del módulo por defecto es:

Disk Free [0]

Y pasará a llamarse:

Disk (0) free space

También es posible configurar cadenas de texto para los límites de los estados Advertencia y Crítico de los Módulos. La configuración sería parecida a la siguiente:

powerState name = Estado funcionamiento; desc = Estado funcionamiento VM; limits_warn = .*suspended.*; limits_crit = .*poweredOff.*

Es posible configurar expresiones regulares para dotar de mayor flexibilidad al establecimiento de los límites.

Siga los pasos descritos en VMware Discovery para configurar la monitorización de su infraestructura VMware® a través de Discovery.

Para comprobar el funcionamiento de su configuración puede ejecutar:

 perl \
    /usr/share/pandora_server/util/plugin/vmware-plugin.pl \
    /usr/share/pandora_server/util/plugin/vmware-plugin.conf

Nota:

• Para VMware SDK 6.5.0, si recibiera la siguiente salida durante la ejecución del plugin:

Server version unavailable at 'https://your_vmwre_fqdn:443/sdk/vimService.wsdl' at /usr/local/lib64/perl5/VMware/VICommon.pm line 734.

La solución recomendada es ajustar las versiones de las librerías LWP de Perl:

cpan install GAAS/libwww-perl-5.837.tar.gz

Se recomienda encarecidamente el utilizar Discovery Applications VMware para monitorizar su infraestructura.

Para utilizar el Agente de Pandora FMS debe copiar vmware-plugin.{pl,conf} en un punto accesible por el Agente de Pandora FMS:

  sudo cp \
    /usr/share/pandora_server/util/plugin/vmware-plugin.{pl,conf} \
    /etc/pandora/plugins/

Para crear un fichero de configuración

vmware-plugin-events.conf

copie vmware-plugin.conf y modifique manualmente event_mode a 1.

Ahora debe añadir un nuevo Módulo de tipo plugin al archivo de configuración del Agente con la siguiente línea:

 module_plugin perl \
     /etc/pandora/plugins/vmware-plugin.pl \
     /etc/pandora/plugins/vmware-plugin.conf

Si además desea realizar la copia de los eventos, debe crear otro Módulo plugin con un archivo de configuración diferente que habilite la copia de eventos. La sintaxis es la siguiente:

 module_plugin perl \
    /etc/pandora/plugins/vmware-plugin.pl \
    /etc/pandora/plugins/vmware-plugin-events.conf

En sistemas Windows® es necesario especificar el intérprete usado:

module_plugin perl "%ProgramFiles%\pandora_agent\util\vmware-plugin.pl" "%ProgramFiles%\pandora_agent\util\vmware-plugin.conf"

En las siguientes secciones se explica en detalle los parámetros del archivo de configuración del plugin.

Puede programar la ejecución del plugin desde el propio cron de sistema. Recuerde que el valor de intervalo de los elementos generados ( interval en la configuración) y la periodicidad de ejecución deben ser coherentes:

# Input to add to crontab, set a range of 600 to use this setting/10 * * * * root perl
 /usr/share/pandora_server/util/plugin/vmware-plugin.pl /usr/share/pandora_server/util/plugin/vmware-plugin.conf

El ejemplo anterior ilustra la línea a agregar a crontab. Configure un intervalo de 600 para utilizar esta configuración

Para ver el resultado de la ejecución del plugin acceda al submenú Agent Detail, dentro del menú Views.

En esta vista aparecerán los Agentes creados por el plugin junto con los demás Agentes de Pandora FMS.

Si pulsa en el nombre de un Agente verá la vista de Agente de Pandora FMS, donde aparecerán los Módulos monitorizados por el plugin VMware®.

Por defecto, el plugin despliega una monitorización básica para cada uno de los elementos VMware®.

• Ping
• Check 443 port

• Capacity
• Free Space
• Disk Overallocation
• Free Space Bytes

• CPU Usage
• Memory Usage
• Data received
• Data transmitted
• Disk Read Latency
• Disk Write Latency
• Host Alive
• Disk Rate
• Net Usage

• CPU Usage
• Memory Usage
• Tools Running Status
• Host Alive
• Disk Free
• Disk Read Latency
• Disk Write Latency
• Data received
• Data transmitted
• Net Usage

En la siguiente sección se explican con detalle todos los Módulos disponibles y la información que reporta cada uno de ellos.

Algunos Módulos podrían no estar disponibles, dependiendo de la versión de VMware® y de la configuración del entorno. En las siguientes tablas se describen los diferentes módulos disponibles y sus características de disponibilidad.

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

Esta funcionalidad realiza una copia de los eventos presentes en el vCenter de VMware® a la lista de eventos de Pandora FMS.

Estos eventos pasan a formar parte del flujo de eventos normales de Pandora FMS y quedan asociados de forma automática al Agente que representa el vCenter del que provienen (si el Agente existe en el momento de creación del evento).

En el proceso de volcado de eventos se respeta la información y severidad que VMware® indica en la creación del evento, de tal forma que los eventos con un nivel de severidad crítico, advertencia o informativo conservarán estos niveles en Pandora FMS. La siguiente imagen muestra un ejemplo de la información detallada de un evento volcado de VMware a Pandora FMS.

Con todos los eventos presentes en Pandora FMS podrá realizar todas las acciones disponibles para la gestión de eventos, como por ejemplo: creación de alertas, configuración de filtros, apertura de incidencias, etc.

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.

Para comenzar a usar el visor de arquitecturas VMware® vaya a Monitoring → VMware view.

De no tener ningún dispositivo a monitorizar o no haber configurado la API de los vCenter® y ESXi VMware® obtendrá algo parecido a la siguiente imagen:

Si el plugin se encuentra en estado operativo obtendrá este mensaje (haga clic en el botón Show):

La extensión VMware View® le mostrará un mapa similar al de abajo con toda la arquitectura VMware®.

El mapa contiene 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 una forma sencilla.

Esta extensión tiene unas opciones que ayudan a mejorar la visualización de la arquitectura ocultando elementos, aumentando el tamaño de letra y permitiendo hacer acercamientos para poder ver los elementos con más detalle.

Usando las opciones anteriores puede mostrar solo los DataCenter y los ESX.

VMware View® aporta dos vistas adicionales además de la vista de mapa topológico de la arquitectura virtual. Las nuevas pestañas permiten cambiar entre las diferentes vistas de la VMware View®.

La primera vista es un dashboard general en el que podrá ver de un vistazo el estado general de la arquitectura virtual en números, es decir, cuántas máquinas virtuales, host ESXi o DataStores tienen problemas. Además podrá ver parámetros de rendimiento generales gracias a las gráficas que muestran las 5 máquinas virtuales que más memoria, CPU, disco y red consumen de toda la arquitectura virtual.

La segunda vista permite ver los parámetros de rendimiento de cada host ESX. En esta vista podrá escoger un host ESX para el que se cargará un cuadro de mando en el que se mostrará el estado del host y de las máquinas virtuales, así como unas métricas de rendimiento relativas al uso de CPU, memoria, disco y red del host ESXi. Además, esta vista también ofrece unas gráficas que muestran las máquinas virtuales que más recursos (CPU, memoria, disco y red) consumen del host seleccionado.

La extensión de VMWare se incluye junto con Pandora FMS Console Enterprise. Dispone de un panel de configuración para establecer las opciones de dashboards y mapas:

• Podrá ajustar los umbrales de vista (mínimos - máximos) de las gráficas de los dashboard.
• Podrá ajustar la configuración de la vista de mapa por defecto.
• Contiene un enlace al sistema de gestión de configuraciones.

Accesible en la pestaña de opciones del VMWare View®:

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 esa arquitectura. 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 (máquina virtual en ejecución).
• Naranja = Suspendida (máquina virtual cuya ejecución está pausada).
• Gris = Detenida (máquina virtual no está en ejecución).

Además, en un combo muestra los estados disponibles y permite cambiar el estado de la máquina virtual al seleccionado, pulsando el botón Change Status.

Seleccionando el estado Stop y pulsando Change status:

Esto provacará que se detenga la ejecución de la máquina virtual y la vista de la extensión VMware Manage cambiará, mostrando así que la máquina virtual ahora está parada:

En esta sección es posible configurar nuevos Módulos relativos a Performance Counters para las máquinas virtuales y los ESX. Para configurar un nuevo Módulo de rendimiento necesitará usar la siguiente estructura:

custom_performance type = mem; metric = swapinRate; module_type = generic_data; name = Swap In Rate; desc = Swap In Rate for host; limits_warn = 0 0; limits_crit = 0 0

Los parámetros a configurar son:

• type: Tipo de métrica a monitorizar. Los tipos de métrica son:
  • cpu: Característica de la Unidad Central de Procesamiento.
  • mem: Memoria.
  • disk: Disco, almacenamiento.
  • net: Red.
  • sys: Sistema.
• metric: Métrica a monitorizar (más adelante se explica dónde ver las métricas disponibles).
• module_type: Tipo del Módulo de Pandora FMS (por ejemplo: generic_data).
• name: Nombre del Módulo.
• desc: Descripción del Módulo.
• limits_warn: Límites para el estado Advertencia.
• limits_crit: Límites para el estado Crítico.

Podrá consultar las métricas disponibles para cada tipo en el apartado Performance de cada entidad. Esta vista se encuentra dentro del vCenter y muestra las métricas de rendimiento que es posible monitorizar con el plugin VMware®. Por ejemplo, la siguiente imagen muestra la vista de Performance para un host ESX.

Para ver el listado completo de todas las métricas según su tipo deberá hacer clic en el botón Advanced y luego en el botón Char option. Verá una lista con todos los tipos de métricas y las respectivas métricas de cada tipo:

Para cada tipo de métrica aparecerán una serie de contadores que son las variables que podremos monitorizar con Pandora FMS. Para monitorizar una variable necesitamos su Internal Name. Además debe asegurarse de que el nivel de estadísticas, configurado en el vCenter, permite mostrar la variable que buscamos, comparándolo con el campo Collection Level de la métrica.

Por ejemplo, si necesita ver el uso de CPU de un host ESX, buscaremos las variables tipo cpu para un ESX y de las disponibles escogeremos utilization. La línea que tiene que añadir al archivo de configuración (en este caso dentro de la sección ESX) será la siguiente:

custom_performance type = cpu; metric = utilization; module_type = generic_data; name = CPU Utilization; desc = CPU Utilization for ESX; limits_warn = 0 0; limits_crit = 0 0

Cada Módulo plugin configurado en el Agente monitoriza un Datacenter, por lo que si se quiere monitorizar varios Datacenter con un mismo Agente Software de Pandora FMS será necesario tomar las siguientes consideraciones.

• Es necesario añadir un module_plugin por cada Datacenter a monitorizar; por ejemplo:

 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2.conf

• En cada archivo de configuración será necesario cambiar los parámetros: logfile, entities_list, event_pointer_file. Los archivos de configuración quedarían como los siguientes:

vmware-plugin-datacenter1.conf

 ...
 logfile /tmp/vmware_plugin_datacenter1.log
 entities_list /tmp/vmware_entities_list_datacenter1.txt
 event_pointer_file /tmp/vmware_events_pointer_datacenter1.txt
 ...

vmware-plugin-datacenter2.conf

 ...
 logfile /tmp/vmware_plugin_datacenter2.log
 entities_list /tmp/vmware_entities_list_datacenter2.txt
 event_pointer_file /tmp/vmware_events_pointer_datacenter2.txt
 ...

• Si además desea realizar la copia de eventos, deberá tener dos Módulos plugin más con los respectivos archivos de configuración y activando la flagevent_mode. La configuración de los module_plugin sería como la siguiente:

 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1-events.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2-events.conf

Las opciones del archivo de configuración del plugin permiten distribuir la carga de monitorización fácilmente entre varios servidores de Pandora FMS. Tome por ejemplo la siguiente estructura de un entorno de virtualización:

 DC
 |
 |- Datastore_1
 |- DataStore_2
 |
 |- ESX_1
       |- mv1.1
       |- mv1.2
       |- mv1.3

 |- ESX_2
       |- mv2.1
       |- mv2.2
       |- mv2.3

Dispone de dos servidores Pandora FMS para realizar la monitorización. Una manera sencilla de dividir la carga sería monitorizar el Datacenter, los Datastores y los ESX en el primer servidor y todas las máquinas virtuales en el segundo. Los archivos de configuración del plugin serían los siguientes:

Servidor 1:

 Reject
 all_vm

Servidor 2:

 Reject
 all_datacenter
 all_datastore
 all_esx

El Servidor 1 monitoriza todo excepto las máquinas virtuales y el Server 2 solo monitoriza las máquinas virtuales.

Otra forma de distribuir la carga sería dividiendo la monitorización por ESX; el primer servidor de Pandora FMS monitorizará todo lo relativo al primer servidor ESX y el segundo todo lo perteneciente al segundo ESX. Para ello, dividiremos el archivo entities_list.txt en dos archivos y configuraremos dos ejecuciones del plugin en diferentes agentes. Los archivos entities_list.txt quedarían así:

Servidor 1:

 Datacenter
 DC
 Datastore
 Datastore_1
 ESX
 ESX_1
 VM
 mv1.1
 mv1.2
 mv1.3

El Servidor 1 omite todo lo relacionado con el segundo grupo de entidades VMware, por lo que se encarga de monitorizar la mitad del entorno.

Servidor 2:

 Datastore
 DataStore_2
 ESX
 ESX_2
 VM
 mv2.1
 mv2.2
 mv2.3

El Servidor 2 omite todo lo relacionado con el primer grupo de entidades VMware además del Datacenter, ya que esto está siendo monitorizado por el Servidor 1.

La configuración de entidades descartadas es muy flexible y permite dividir la carga asignando unas pocas entidades a cada agente de Pandora FMS.

Archivo con todos los módulos desactivados

  #These lines are comments

 #Datacenter Modules
 Datacenter
 ping disabled
 check443 disabled

 #Datastore Modules
 Datastore
 capacity disabled
 freeSpace disabled
 overallocation disabled
 freeSpaceBytes disabled

 #ESX Modules
 ESX
 bootTime disabled
 cpuInfo disabled
 memorySize disabled
 overallCpuUsage disabled
 overallMemoryUsage disabled
 powerState disabled
 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
 cpuUsagePercent disabled
 memoryUsagePercent disabled
 netUsage disabled
 diskRate disabled
 maxDiskLatency disabled
 haStatus disabled

 #VM Modules
 VM
 bootTime disabled
 connectionState disabled
 consumedOverheadMemory disabled
 cpuAllocation disabled
 diskFree disabled
 guestState disabled
 host disabled
 hostAlive disabled
 diskUsed
 provisioningUsed
 totalReadLatency
 totalWriteLatency
 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
 virtualImagePath disabled
 uptimeSeconds disabled
 diskRead disabled
 diskWrite disabled
 diskReadLatency disabled
 diskWriteLatency disabled
 netReceived disabled
 netTransmitted disabled
 netPkgRx disabled
 netPkgTx  disabled
 cpuUsagePercent disabled
 memoryUsagePercent disabled
 netUsage disabled
 diskRate disabled
 maxDiskLatency disabled
 heartbeat disabled
 cpuReady disabled
 snapshotCounter disabled

Red Hat® Enterprise Virtualization (RHEV) es una de las tecnologías más usadas por empresas que tienen como base el sistema operativo Red Hat en su Data Center. Pandora FMS Enterprise ofrece la posibilidad de monitorizar las arquitecturas virtuales basadas en RHEV mediante el plugin RHEV Monitoring Plugin, que permite controlar de forma sencilla todos los aspectos relacionados con la arquitectura virtual RHEV.

Con el plugin es posible monitorizar la arquitectura completa de un sistema RHEV: Data Centers, Host Clusters, Storage Domains, Networks, Hosts y Virtual Machines, ofreciendo una visión global del estado del entorno virtual.

Para ello, Pandora FMS usa la API oficial que provee el sistema de virtualización RHEV.

La monitorización de entornos virtuales RHEV se basa en dos componentes:

1. Un plugin de Agente que realiza las tareas de autodescubrimiento y recogida datos. El plugin de Agente es el encargado de enviar la información a Pandora FMS.
2. Un script de reconocimiento que actualiza diversos valores para las entidades descubiertas. Este guión es necesario para el correcto funcionamiento de las extensiones del plugin.
3. Extensión RHEV Viewer y RHEV Manager. Son extensiones que aportan un valor añadido permitiendo ver la infraestructura monitorizada y operar apagando/encendiendo máquinas virtuales, todo ello desde la consola web de Pandora FMS.

El plugin RHEV Monitoring Plugin extrae la información mediante la API web que sirve el entorno de virtualización RHEV.

Si solo necesita la información de monitorización lo único que tiene que configurar es el plugin de Agente que realizará esta tarea.

El plugin de Agente realiza un descubrimiento de dispositivos y compone los XML con los Módulos para cada uno de ellos. La configuración del plugin permite escoger qué elementos van a ser monitorizados y la configuración de sus Módulos. Los Módulos creados por el plugin son configurables, y es posible cambiar el nombre y la descripción y añadir valores máximos y mínimos para los estados Warning y Critical del Módulo.

Una vez creados los XML, el plugin de Agente envía los archivos, bien usando Tentacle o bien los copia a un directorio local, según el método de transferencia escogido.

Si además va a usar las extensiones RHEV Viewer y RHEV Manager necesitará usar el script de reconocimiento.

El guión de reconocimiento es el encargado de actualizar unas variables para cada uno de los Agentes detectados en Pandora FMS según los valores configurados en RHEV. Estas variables son necesarias para poder visualizar las entidades correctamente en la extensión RHEV Viewer y gestionar adecuadamente las máquinas virtuales con la extensión RHEV Manager.

El plugin de Agente requiere el siguiente software:

• curl.
• perl-XML-Simple.
• Agente Software de Pandora FMS.
• tentacle_client (si se quiere usar tentacle para enviar los archivos, tentacle_client se instala junto con el Agente Software de Pandora FMS).

En sistemas basados en Red Hat® puede instalar las dependencias con el comando:

yum install perl-XML-Simple curl

En sistemas basados en SUSE puede instalar las dependencias con el comando:

zypper install perl-XML-Simple curl

En sistemas basados en Debiand/Ubuntu puede instalar las dependencias con el comando:

apt-get install libxml-simple-perl curl

La instalación del Agente Software de Pandora FMS se explica en la sección Instalación de Pandora FMS, ahí encontrará todo lo necesario para realizar la instalación de dicho Agente en su plataforma.

Antes de usar el plugin será necesario descargar el certificado que permite la conexión por HTTPS al API de RHEV. Para ello, ejecute el siguiente comando:

curl -o rhevm.cer http://[RHEVM-HOST]:8080/ca.crt

Donde [rhevm-host] es el nombre del servidor que sirve el API de RHEV. Un ejemplo concreto podría ser:

curl -o rhevm.cer http://rhevm.server:8080/ca.crt

Una vez descargado el certificado puede comprobar que la conexión a la API se realiza de forma correcta con el siguiente comando mediante el uso de conectores de línea >

curl -X GET \
             -H "Accept: application/xml" \
             -u [USER:PASS] \
             --cacert [CERT] https://[RHEVM-HOST]:8443/api

Con los siguientes valores:

• USER: user @domain para conectarse al API.
• PASS: contraseña del usuario con el que se conectará al API.
• CERT: ruta al certificado descargado en el paso anterior.
• RHEVM-HOST: dirección del host que sirve el API.

Un ejemplo con datos concretos del comando sería como el siguiente:

curl -X GET \
            -H "Accept: application/xml" \
            -u [[email protected]:12345] \
            --cacert /home/user/ca.crt https://rhevm.server:8443/api

Si la ejecución de comando es positiva, devolverá una salida en formato XML con información general sobre la API de RHEV.

En el entorno de virtualización RHEV es posible que varias entidades tengan un mismo nombre. Esto supone un problema, ya que en Pandora FMS esas entidades se transformarán en Agentes en los que no se permite duplicidad en los nombres. Además, también generará problemas a la hora de parsear el resultado devuelto por la API en formato XML, mostrando un error parecido al siguiente:

Warning: <data_center> element has non-unique value in 'name' key attribute: Default at ./plugin-rhev.pl line 199

Para solucionar el problema lo único necesario es seguir una nomenclatura de nombres para las entidades del entorno de virtualización RHEV en el que no se repitan los nombres.

Para instalar el plugin de Agente solo tiene que copiar el script rhev-plugin.pl y el archivo de configuración rhev-plugin.conf en un directorio de la máquina donde está instalado el Agente de Pandora FMS que ejecutará el plugin. El plugin se puede ejecutar en un Agente instalado en las mismas máquina que el servidor de Pandora FMS o en otra máquina distinta.

Para ejecutar el plugin debe añadir al archivo de configuración del Agente (por defecto /etc/pandora/pandora_agent.conf) la siguiente línea:

module_plugin /root/rhev-plugin.pl /root/rhev-plugin.conf

Añadiendo esta línea el plugin de Agente realizará sus funciones en cada ejecución.

Para ver el resultado de la ejecución del plugin de Agente vaya a Monitoring → Views → Agent Detail.

El plugin crea un Agente en Pandora FMS por cada una de las entidades detectadas en el descubrimiento de la arquitectura RHEV.

Al pulsar el nombre de un Agente podrá ver los Módulos de monitorización creados por el plugin, además de otros datos relativos:

Para cada tipo de entidad se crean automáticamente una serie de Módulos determinados, monitorizando la información importante de cada una de ellas.

Si el Agente seleccionado correspondiera a un Host en lugar de una Máquina Virtual, los módulos de monitorización serían distintos.

El plugin RHEV también monitoriza los eventos ocurridos dentro de la arquitectura virtual. El plugin creará un Módulo para cada evento monitorizado dentro de cada entidad afectada:

Los datos para los Módulos creados a partir de eventos son datos del evento: hora del suceso, descripción del evento. Ejemplo de datos:

Además de los Agentes y los Módulos relativos a la arquitectura RHEV propiamente dicha, se genera un Módulo en el Agente que ejecuta el plugin. Este Módulo se llama, por defecto, RHEV Plugin:

El contenido del Módulo será el resultado de ejecución del plugin; podrá ser OK si todo es correcto o mostrará una cadena de error con la explicación del mismo si algo inesperado ocurre. Esta información además de en el Módulo del plugin se podrá consultar en un archivo de log.

Los Módulos de estado de las diferentes entidades devuelven los valores predefinidos en la arquitectura RHEV. Esto significa que los valores serán cadenas de texto cuyo contenido será up, down, error, maintenance, non_operational, etc., dependiendo del estado y la entidad monitorizada.

Para asignar valores warning y critical será necesario definir una expresión regular en la configuración del Módulo. Por ejemplo, para definir un estado crítico en un Módulo que está determinado por los valores error, down y non_operational, insertamos en el campo Str. del valor critical del módulo la siguiente expresión regular:

error|down|non_operational

A continuación se detallan los Módulos disponibles para cada elemento de la arquitectura RHEV.

• Status: Estado del Data Center.

• Available Space: Espacio disponible en el Storage Domain.
• Committed Space: Espacio comprometido en el Storage Domain.
• Used Space: Espacio usado en el Storage Domain.
• Percent Free Space: Porcentaje de espacio libre en el Storage Domain.

• Status: Estado de la red virtual.
• STP Status: Estado de la funcionalidad Spanning Tree Protocol.

• Overcommit Percent: Porcentaje de sobreasignación del clúster.
• Transparent HugePages: Estado de la funcionalidad Transparent HugePages.
• High threshold: Límite superior en las políticas de planificación.
• Low threshold: Límite inferior en las políticas de planificación.
• Threshold duration: Duración de los límites en las políticas de planificación.

• Status: Estado del Host.
• Buffers size: Tamaño de los buffers.
• Cache size: Tamaño de la cache.
• Cached swap: Cantidad de memoria Swap caching (en bytes).
• Free memory: Cantidad de memoria libre (en bytes).
• Percent free memory: Porcentaje de memoria libre.
• Swap cached percent: Porcentaje de memoria Swap caching.
• Swap free: Cantidad de memoria Swap libre (en bytes).
• Swap free percent: Porcentaje de memoria Swap libre.
• Total Memory: Cantidad total de memoria del Host (en bytes).
• Total Swap: Cantidad total de memoria Swap (en bytes).
• Used memory: Cantidad total de memoria usada (en bytes).
• Used Swap: Cantidad total de memoria Swap usada (en bytes).
• Nic [x] TX: Ratio de transferencia de la interfaz de red [x] (en bytes/segundo). Se genera uno por cada interfaz de red detectada.
• Nic [x] RX: Ratio de recepción de la interfaz de red [x] (en bytes/segundo). Se genera uno por cada interfaz de red detectada.
• Nic [x] erros TX: Número de errores de transmisión de la interfaz de red [x]. Se genera uno por cada interfaz de red detectada.
• Nic [x] erros RX: Número de errores de recepción de la interfaz de red [x]. Se genera uno por cada interfaz de red detectada.
• User CPU: Porcentaje de CPU usada por el usuario.
• System CPU: Porcentaje de CPU usada por el sistema.
• CPU Idle: Porcentaje de CPU ociosa.
• CPU Load: Carga media de CPU de los últimos 5 minutos.
• KSM CPU: Porcentaje de CPU usado por KSM.
• Active VM: Número de máquinas virtuales activas en el Host.
• Migrating VM: Número de máquinas virtuales en migración en el Host.
• Total VM: Número total de máquinas virtuales del Host.
• Fence Status: Estado del fencing del host.

• Status: Estado de la máquina virtual.
• Disk [x] read: Tasa de lectura del disco x (bytes/segundo). Se genera uno por cada disco (almacenamiento) detectado.
• Disk [x] write: Tasa de escritura del disco x (bytes/segundo). Se genera uno por cada disco detectado.
• Disk [x] size: Tamaño del disco x (en bytes). Se genera uno por cada disco detectado.
• Disk [x] status: Estado del disco x. Se genera uno por cada disco detectado.
• Nic [x] TX: Ratio de transferencia para la interfaz de red [x] (en bytes/segundo). Se genera uno por cada interfaz de red detectada.
• Nic [x] RX: Ratio de recepción para la interfaz de red [x] (en bytes/segundo). Se genera uno por cada interfaz de red detectada.
• Nic [x] erros TX: Número de errores de transmisión para el la interfaz de red [x]. Se genera uno por cada interfaz de red detectada.
• Nic [x] erros RX: Número de errores de recepción para el la interfaz de red [x]. Se genera uno por cada interfaz de red detectada.
• Installed memory: Cantidad de memoria instalada (en bytes).
• Percent free memory: Porcentaje de memoria libre.
• Used memory: Cantidad de memoria usada (en bytes).
• Stateless: Estado de la funcionalidad Stateless.
• HA Status: Estado de la funcionalidad de HA.
• Total CPU: Porcentaje total de CPU usada por la máquina virtual.
• Hypervisor CPU: Porcentaje de CPU del Hypervisor usado por la máquina virtual.
• Guest CPU: Porcentaje de CPU del Host que usa la máquina virtual.

• Event [x]: Descripción del evento x ocurrido en el sistema. Se creará uno por cada evento detectado en los Agentes afectados.

En esta sección se explica la instalación, configuración y funcionamiento de las extensiones RHEV View y RHEV Manager.

Existe la posibilidad de crear tareas personalizadas de reconocimiento gracias al Discovery server.

Para instalar las extensiones simplemente debe copiar el contenido de la carpeta extensions, que encontrará al descomprimir el plugin, en la correspondiente carpeta extensions de la parte Enterprise de la Consola de Pandora FMS. El comando a ejecutar es el siguiente:

cp -R extensions/* <pandora_console_dir>/enterprise/extensions/

Desde ese momento estarán disponibles las extensiones de monitorización RHEV.

Para usar la extensión RHEV View solo tiene que pulsar en la opción RHEV View dentro del submenú Monitoring.

La extensión mostrará un mapa como el siguiente, con todos los componentes de la arquitectura RHEV descubiertos por el plugin:

En el mapa aparecen representados los diferentes elementos de la arquitectura RHEV (Data Centers, Storage Domains, Clusters, Networks, Hosts y Virtual machines). Cada elemento está representado por un icono, distinto para cada tipo de elemento de la arquitectura. También quedan representadas las relaciones entre los diferentes elementos de la arquitectura RHEV. Con esta vista es muy sencillo ver el estado de los elementos y cómo se interrelacionan.

La extensión cuenta con un menú que permite configurar la vista ocultando o mostrando entidades, ampliando o reduciendo el tamaño del texto y realizando zoom para ver la imagen con más detalle.

Por ejemplo, en la siguiente imagen del mapa se ha ocultado los elementos Networks, Hosts y Virtual Machine de la arquitectura porque se necesita ver en detalle las relaciones de Clusters y Storage Domains con los Data Center.

La extensión RHEV Manager está disponible en la vista de operación de los agentes de Pandora FMS que se correspondan con máquinas virtuales dentro de la arquitectura de virtualización RHEV.

Para acceder a la extensión pulse en el botón con el logo de Red Hat que encontrará junto con los demás tabs del agente.

La extensión permite gestionar máquinas virtuales (encender, apagar y suspender) sin necesidad de abrir la consola de gestión de RHEV. En la extensión se muestra el estado actual de la máquina virtual con un código de colores:

• Verde = Encendida.
• Naranja = Suspendida.
• Gris = Detenida.

Con un combo con los estados disponibles a los estados que se puede llevar la máquina virtual al pulsar el botón Change Status.

Si escoge el estado Stop para detener la máquina virtual, la extensión conectará con la API RHEV y enviará la orden. El resultado será el cambio de estado en la máquina virtual y las opciones del combo:

El paso entre algunos estados no es automático, como por ejemplo del estado Stop a Start. En este caso, la extensión irá mostrando el estado de la máquina virtual según vaya cambiando en la arquitectura de virtualización. Ejemplo:

La configuración del plugin de Agente se realiza mediante un archivo de configuración cuyo nombre por defecto es rhev-plugin.conf.

Por defecto, el plugin de Agente selecciona todas las entidades y crea todos los Módulos correspondientes con unos valores predeterminados para el nombre y la descripción. Todos estos aspectos, así como variables generales del plugin, se pueden configurar a través del archivo de configuración.

El archivo de configuración tiene dos áreas bien diferenciadas: las variables globales y la configuración de la monitorización.

La sección de variables globales comienza con el token Configuration y contiene la información de configuración del plugin. Los parámetros permitidos en esta sección son:

• module_name : Nombre del Módulo del Agente con el estado de la ejecución del plugin.
• server : Nombre del host que sirve la API de RHEV.
• user : Usuario en formato user @domain para conectarse a la API.
• pass : Contraseña para conectarse a la API.
• cert : Ruta del certificado para conectarse a la API.
• temporal : Directorio temporal.
• logfile : Archivo de registro o log.
• transfer_mode : Modo de transferencia. Puede tomar los valores: local o tentacle.
• tentacle_ip : Dirección IP del servidor Tentacle al cual enviar la información. Típicamente estará situado en la misma máquina que el servidor de Pandora FMS. Esta opción solo se usa si transfer_mode tiene el valor tentacle.
• tentacle_port : Puerto del servidor Tentacle. Esta opción solo se usa si transfer_mode tiene el valor tentacle.
• tentacle_opts : Opciones de envío de datos para Tentacle. Esta opción solo se usa si transfer_mode tiene el valor tentacle.

La sección de configuración de la monitorización se divide en varias subsecciones. La primera subsección tiene como token Reject y sirve para listar las entidades del entorno de virtualización que serán descartadas de la monitorización. Para descartar una entidad será necesario poner el nombre de la misma en esta lista. Por ejemplo:

 #Dismissed entities
 Reject
 mv1
 mv_Windows10
 mv_WebServer1
 ...

Es posible descartar todas las entidades de un mismo tipo, por ejemplo todos los hosts, todas las máquinas virtuales, etc. Los token para cada entidad son: all_dc (Data Center), all_host (Hosts), all_network (Networks), all_storage (Storage Domain), all_cluster (Cluster), all_vm (Máquinas Virtuales). Ejemplo de uso de estos tokens:

 #Dismissed entities
 Reject
 all_dc
 all_host
 all_network
 all_storage
 all_cluster
 all_vm

La segunda sección tiene como token Rename y sirve para cambiar los nombres de las entidades monitorizadas a través del plugin. Esta funcionalidad es muy útil si se quiere combinar la monitorización de agentes software con datos extraídos de la API en el mismo Agente de Pandora FMS. La configuración de esta sección se realiza poniendo primero el nombre antiguo y a continuación el nuevo separado por un espacio; por ejemplo:

 #Rename entities
 Rename
 mv_WebServer1 WebServer1
 mv_Windows10 Windows10 Test
 ...

Las siguientes subsecciones se corresponden con la configuración de monitorización para cada entidad. Cada entidad tiene su propio token, siendo los siguientes: DataCenter, StorageDomain, Network, Cluster, Host y VM. Para cada una de estas entidades es posible definir los Módulos que estarán deshabilitados o definir unos valores personalizados para el nombre, la descripción y los rangos de máximos y mínimos para los estados Warning y Critical. Un ejemplo sería el siguiente:

#VM Modules
VM
status disabled
errors_total_tx name = Errores TX Net [%s]; desc = Errores totales TX de red; limits = 60 70 71 100
memory_used name = Memoria en uso; desc = Memoria usada por la maquina virtual; limits = 256 1024 1025 2048
...

Cada línea de configuración de los módulos de monitorización se corresponde dos opciones disponibles:

• <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 carácter ; va pegado al nombre y la descripción del módulo. Estas dos líneas NO SON EQUIVALENTES (véanse los espacios antes del carácter ; ):

errors_total_tx name = Errores TX Net [%s]; desc = Errores totales TX de red; limits = 60 70 71 100 #Correcto
errors_total_tx name = Errores TX Net [%s]    ; desc = Errores totales TX de red    ; limits = 60 70 71 100 #Incorrecto

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.

Ejemplo de configuración para las máquinas virtuales, sección VM:

Para la monitorización de las máquinas virtuales se han definido una serie de Módulos habilitados o no en la sección VM del archivo de configuración. Más concretamente: el Módulo status ha sido deshabilitado y para los Módulos errors_total_tx y memory_used se han definido unos valores personalizados. Los demás Módulos que no aparecen en el listado se crearán con los valores por defecto. Con esta configuración, el Módulo memory_used tomará los siguientes valores:

• Nombre: Memoria en uso.
• Descripción: Memoria usada por la máquina virtual.
• Min Warning: 256.
• Max Warning: 1024.
• Min Critical: 1025.
• Max Critical: 2048.

Los Módulos se generan dinámicamente; por ejemplo, dos relativos a discos o interfaces de los cuales se crea uno por cada elemento detectado. Tienen una sintaxis especial para el nombre del Módulo, que es la siguiente:

errors_total_tx name = Errores TX Net [%s]; desc = Errores totales TX de red; limits = 60 70 71 100

En estos casos, como el nombre tiene parte dinámica, lo que se permite es usar la macro %s que será sustituida por el plugin por la parte variable del nombre del Módulo.

Por ejemplo, el Módulo errors_total_tx tiene por nombre por defecto:

Nic [nic1] errors TX

Pasará a llamarse

Errores TX Net [nic1]

Siendo nic1 la parte dinámica del nombre del módulo.

Además de las secciones propias de cada elemento de la arquitectura, el archivo de configuración tiene una sección común para los Eventos. Esta sección se define con el token EventCodes y en él se listarán los códigos de los eventos a monitorizar; por ejemplo:

 EventCodes
 30
 920
 980
 509
 956

Si no define esta sección, no se realizará la monitorización de eventos.

Mediante el archivo de configuración del plugin de Agente es posible dividir la carga de monitorización de la infraestructura de virtualización RHEV.

Para ello se repartirán las entidades a monitorizar entre los distintos Agentes. Suponga que tiene la siguiente arquitectura:

 DC1
  |
  |- Cluster 1.1
        |- c1.1mv1
        |- c1.1mv2
        |- c1.1mv3

  |- Cluster 1.2
        |- c1.2mv1
        |- c1.2mv2
        |- c1.2mv3

 DC2
  |
  |- Cluster 2.1
        |- c2.1mv1
        |- c2.1mv2
        |- c2.1mv3

  |- Cluster 2.2
        |- c2.2mv1
        |- c2.2mv2
        |- c2.2mv3

Una forma de dividir la carga sería asignando una Datacenter a cada uno de los Agentes Software; para ello usaríamos la funcionalidad para descartar entidades a monitorizar (token Reject).

El primer Agente Software monitoriza el Datacenter DC1 y descarta las entidades de DC2.

 Reject
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

El segundo Agente Software monitoriza el Datacenter DC2 y descarta las entidades de DC1.

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3

También podríamos dividir la carga basándonos en los clústeres, por ejemplo. Para cada clúster de los dos Datacenters se asignará un agente de los cuatro primeros.

Agente Software 1, monitorizar Cluster 1.1 y descarta las demás entidades.

 Reject
 DC1
 Cluster 1.2
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

Agente Software 2, monitorizar Cluster 1.2 y descarta las demás entidades.

 Reject
 DC1
 Cluster 1.1
 c1.1mv1
 c1.1mv2
 c1.1mv3
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

Agente Software 3, monitorizar Cluster 2.1 y descarta las demás entidades.

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.2
 c2.2mv1
 c2.2mv2
 c2.2mv3

Agente Software 4, monitorizar Cluster 2.2 y descarta las demás entidades.

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.1
 c2.1mv1
 c2.1mv2
 c2.1mv3

La configuración de entidades descartadas es totalmente flexible y se podría llegar a dividir la carga asignando varias entidades a cada Agente Software.

Archivo con todos los Módulos deshabilitados

  #These lines are comments

 #Plugin configuration parameters
 Configuration
 server rhevm.server
 user [email protected]
 pass 12345
 cert /home/user/rhevm.cer
 temporal /tmp
 logfile /tmp/plugin-rhev.log
 transfer_mode local
 tentacle_ip 127.0.0.1
 tentacle_port 41121
 tentacle_opts

 #Dismissed entities
 Reject

 #Data Center modules
 DataCenter
 status disabled

 #StorageDomain modules
 StorageDomain
 available disabled
 used disabled
 committed disabled
 free_percent disabled

 #Networks modules
 Network
 status disabled
 stp disabled

 #Clusters modules
 Cluster
 overcommit disabled
 hugepages disabled
 threshold_low disabled
 threshold_high disabled
 threshold_duration disabled

 #Host Modules
 Host
 status disabled
 vm_active disabled
 vm_migrating disabled
 vm_total disabled
 data_current_rx disabled
 data_current_tx disabled
 errors_total_rx disabled
 errors_total_tx disabled
 memory_cached disabled
 memory_total disabled
 swap_free_percent disabled
 swap_cached_percent disabled
 swap_free disabled
 cpu_current_idle disabled
 cpu_current_user disabled
 memory_used disabled
 ksm_cpu_current disabled
 memory_free_percent disabled
 swap_total disabled
 memory_buffers disabled
 cpu_current_system disabled
 cpu_load_avg_5m disabled
 swap_cached disabled
 swap_used disabled
 memory_free disabled
 fence_status disabled

 #VM Modules
 VM
 status disabled
 stateless disabled
 ha disabled
 cpu_current_guest disabled
 cpu_current_hypervisor disabled
 memory_free_percent disabled
 memory_installed disabled
 memory_used disabled
 cpu_current_total disabled
 data_current_read disabled
 data_current_write disabled
 size disabled
 disk_status disabled
 data_current_rx disabled
 data_current_tx disabled
 errors_total_rx disabled
 errors_total_tx disabled

Data Center

Storage Domain

Network

Cluster

Host

Virtual Machine

La solución de hiperconvergencia Nutanix® ofrece la posibilidad de gestionar todos los recursos de red, disco, procesamiento y memoria desde un único punto.

El plugin de monitorización de Pandora FMS para Nutanix® permite controlar en todo momento el estado de nuestra solución Nutanix®.

El plugin Nutanix® es un programa escrito en Perl, que se conectará a la API REST de Nutanix PRISM®, recuperando las métricas necesarias para monitorizar los siguientes elementos:

• Clústeres Nutanix®.
• Dispositivos de almacenamiento.
• Contenedores.
• Máquinas Virtuales.
• Hosts.
• Estado de los procesos de replicación.

Para poder recuperar la información de la API REST, necesita:

• La dirección IP/ FQDN del portal.
• Un usuario con permisos de lectura sobre la API.
• La contraseña de dicho usuario.

En cuanto a la comunicación de los resultados de la monitorización a su Pandora FMS necesita:

• El modo de transferencia de la información, sea local o vía Tentacle.
  • En caso de ser local, la dirección del directorio donde han de entregarse los ficheros XML con los resultados, así como permisos de escritura en dicho directorio.
  • En caso de ser comunicación vía Tentacle, será necesario poder conectar contra la dirección IP o FQDN del servidor Pandora FMS, el puerto utilizado por su instalación Tentacle, la localización del cliente de Tentacle así como cualquier opción extraordinaria que haya definido.

Descargue los archivos requeridos por el plugin de la librería de Módulos. Transfiera los archivos al equipo remoto desde donde desea realizar la monitorización de su infraestructura Nutanix® y extraiga los archivos del plugin:

tar xvzf pandora_nutanix.tar.gz

Se declaran los siguientes campos:

Nutanix API configuration

nx_fqdn

Dirección del servidor principal Prism.

nx_port

Puerto en el que la API REST está publicada (por defecto 9440).

nx_user

Usuario con privilegios de lectura sobre la API REST.

nx_pass

Contraseña de dicho usuario.

use_https

Usar https (1) o no (0)

nx_rest_version

Versión del API Rest (por defecto 'v1').

Nutanix agent configuration

agent_interval

Intervalo de los Agentes generados por el plugin (por defecto 300)

agent_group

Grupo al que pertenecerán los Agentes generados (si se comenta 'autocreate_group' en la configuración de su PandoraServer), por defecto Nutanix.

module_interval

Intervalo de los Módulos de los agentes generados (factor de multiplicación, por defecto 1).

module_tags

Etiquetas asociadas a los nuevos módulos de los agentes generados.

module_group

Grupo al que pertenecerán los nuevos Módulos.

Configuración de la comunicación hacia el servidor de Pandora FMS

mode

Modo de transferencia de datos, “local” o “tentacle”.

tentacle_ip

dirección IP del servidor Pandora FMS, solo aplica en modo Tentacle

tentacle_port

Puerto en el que el servicio Tentacle está escuchando.

tentacle_opts

Cualquier opción extra que haya configurado en su servicio Tentacle.

tentacle_client

Ruta completa a su cliente Tentacle.

temp

Directorio de trabajo temporal.

local_folder

Ruta de entrega para el modo de transferencia de datos “local”.

Filtros

cluster_monitoring

Habilitar (1) o no (0) la monitorización de clústeres.

storage_monitoring

Habilitar (1) o no (0) la monitorización de dispositivos de almacenamiento.

container_monitoring

Habilitar (1) o no (0) la monitorización de los contenedores de almacenamiento.

vm_monitoring

Habilitar (1) o no (0) la monitorización de máquinas virtuales.

host_monitoring

Habilitar (1) o no (0) la monitorización de servidores de máquinas virtuales (nodos Nutanix).

pd_monitoring

Habilitar (1) o no (0) la monitorización de dominios de protección.

Personalizaciones

cluster_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo clúster.

storage_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo dispositivo de almacenamiento.

host_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo servidor de máquinas virtuales (nodos Nutanix).

container_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo contenedores de almacenamiento.

vm_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo máquina virtual.

pd_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo dominio de protección

Reglas de generación de Módulos

vm_stat

Regla para agregado de Módulos para la monitorización de máquinas virtuales, por defecto hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*, esto indica los Módulos extraordinarios que se generarán, cuando el nombre de la métrica coincida con las expresiones regulares indicadas en este campo. Agregue el valor .* para monitorizar todas las métricas disponibles.

host_stat

Regla para agregado de Módulos para la monitorización de servidores de máquinas virtuales (nodos Nutanix), por defecto hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*, esto indica los Módulos extraordinarios que se generarán, cuando el nombre de la métrica coincida con las expresiones regulares indicadas en este campo. Agregue el valor .* para monitorizar todas las métricas disponibles.

pd_stat

Regla para agregado de Módulos para la monitorización de dominios de protección, por defecto replication_transmitted_bandwidth_kBps|replication_total_transmitted_bytes, esto indica los Módulos extraordinarios que se generarán, cuando el nombre de la métrica coincida con las expresiones regulares indicadas en este campo. Agregue el valor .* para monitorizar todas las métricas disponibles.

Renombrado de entidades

RENAME aaa TO bbb

Regla para el renombrado de entidades, puede definir tantas directivas como elementos necesite renombrar.

Exclusión de entidades

REJECT aaa

Regla para la exclusión de monitorización de entidades, puede definir tantas directivas como elementos necesite excluir.

Se recomienda ejecutar el plugin de forma remota desde un equipo con acceso tanto a Pandora Server como a su infraestructura Nutanix® a monitorizar.

Ejecución manual:

./pandora_nutanix-linux-x64 pandora_nutanix.conf

Puede automatizar la ejecución del plugin en el cron de sistema agregando la siguiente línea a /etc/crontab>

• /5 * * * * root /path/to/plugin/pandora_nutanix-linux-x64 /path/to/plugin/pandora_nutanix.conf

Capturas con los resultados obtenidos por el plugin:

Ejemplo de mapa de arquitectura Nutanix®:

Ejemplo de vista de Agente de arquitectura Nutanix®:

Ejemplo de vista de módulos para Agentes de tipo Host Nutanix®:

Xen es un monitor de máquina virtual de código abierto desarrollado por la Universidad de Cambridge.

La meta del diseño es poder ejecutar instancias de sistemas operativos con todas sus características, de forma completamente funcional en un equipo sencillo. Usted puede obtener información interesante acerca de «Cómo monitorizar Citrix XenServer con Pandora FMS» en el blog de Pandora FMS.

Xen proporciona aislamiento seguro, control de recursos, garantías de calidad de servicio y migración de máquinas virtuales en caliente. Los sistemas operativos pueden ser modificados explícitamente para correr Xen (aunque manteniendo la compatibilidad con aplicaciones de usuario). Esto permite a Xen alcanzar virtualización de alto rendimiento sin un soporte especial de hardware.

Intel ha realizado diversas contribuciones a Xen que han permitido añadir soporte para sus extensiones de arquitectura VT-X Vanderpool. Esta tecnología permite que sistemas operativos sin modificar actúen como hosts dentro de las máquinas virtuales de Xen, siempre y cuando el servidor físico soporte las extensiones VT de Intel o Pacifica de AMD.

El plugin Pandora FMS para la monitorización de entornos Xen está escrito en Python. Utiliza XenAPI para recuperar toda la información necesaria. Permite la monitorización de los siguientes tipos de elementos:

• Sistemas virtualizados en Xen.
• Recursos de almacenamiento.
• Propio servidor Xen (host).

Es imprescindible que el sistema que ejecute el plugin disponga de los siguientes requisitos:

• Python instalado
• Librerías Python instaladas:
  • XenAPI
  • xmltodict
• Acceso a la API de su XenServer (web, habilite el tráfico desde el equipo que ejecuta el plugin al puerto 443 o el 80 del XenServer).
• Se recomienda que las máquinas virtuales tengan Xen Server Tools instalada, ya que la información disponible en caso contrario es bastante escasa.

Descargue su copia del plugin de Pandora FMS para XenServer de la librería de módulos Puede desplegarlo en el equipo que prefiera (Windows® o Linux®), extrayendo el contenido del archivo en un directorio no volátil desde donde pueda ejecutarlo, ya bien sea utilizando el Agente de Pandora FMS o el cron de sistema.

Configuración disponible para el plugin Pandora FMS para Xen:

Bloque de configuración [CONF]

xen_server_ip

Dirección IP/FQDN del servidor Xen

user

Usuario con permisos de consulta sobre la API de Xen

password

Contraseña del usuario

temporal

Directorio de trabajo temporal

Bloque de configuración [PANDORA]

tentacle_client

Ubicación del binario del cliente de Tentacle

tentacle_ip

Dirección IP donde el servicio Tentacle está escuchando.

tentacle_port

Puerto donde el servicio Tentacle está escuchando.

logfile

Ruta completa al fichero de log

interval

Intervalo de los agentes generados

group

Grupo asignado a los agentes generados.

Bloque de configuración [TUNNING]

time_adjustment

Parámetro que permite el ajuste de las posibles diferencias de tiempo entre el equipo que ejecuta el plugin y el servidor Xen. (por defecto=10, medido en segundos)

scan_vm_ip

Parámetro que permite definir si el plugin tratará de obtener las IPs de las VMs del servidor de Xen. Solo se pueden tomar las IPs de aquellas VMs con las XenTools instaladas. Se puede habilitar (scan_vm_ip=true) o deshabilitar (scan_vm_ip=false). Si no se especifica se considera habilitado.

Bloque de configuración [RENAME]

xen_element_name = pandora_agent_name

En este bloque se pueden definir tantas entradas como se quiera con este formato. Permite cambiar los nombres de los elementos del Xen Server a otros distintos para ser usados como nombres de agentes en Pandora FMS. Se pueden renombrar las VMs, los SRs y el propio Xen Server. Por ejemplo:

 [RENAME]
 example-xen-server=Example Xen Server
 Example Xen Server 2=example-xen-server-2
 example-vm=Example VM
 Example VM 2=example-vm-2
 example-sr=Example SR
 Example SR 2=example-sr-2**

Aunque los nombres tengan espacios en blanco, no se deben poner comillas.

Puede programar la ejecución del plugin desde cualquier agente de Pandora FMS, agregando lo siguiente a la configuración del mismo:

module_plugin python "<ruta>\xen-plugin.py" "<ruta>\xen-plugin.conf"

Para programarlo a través del cron de sistema puede añadir la línea siguiente a /etc/crontab:

/5 * * * * root python "<ruta>\xen-plugin.py" "<ruta>\xen-plugin.conf"> /dev/null 2>&1

Si ejecuta el plugin manualmente la salida debe ser similar a la que sigue:

python "<ruta>\xen-plugin.py" "<ruta>\xen-plugin.conf"
<module>
<name><![CDATA[XenServer Plugin]]></name>
<type><![CDATA[async_string]]></type>
<description><![CDATA[Result of XenServer Plugin execution]]></description>
<data><![CDATA[OK]]></data>
</module>

Capturas con los resultados obtenidos por el plugin:

Ejemplo de mapa de arquitectura Xen:

Ejemplo de vista de agente de arquitectura Xen:

Ejemplo de vista de módulos para agentes de tipo Host Xen:

OpenNebula es una plataforma para computación en la nube orientada a centros de datos distribuidos y heterogéneos, proporcionando la infraestructura virtual para construir nubes privadas, públicas, e implementaciones híbridas de infraestructura como servicio (IaaS).

OpenNebula es software open source amparado en la Licencia Apache 2.

El plugin Pandora FMS para la monitorización de entornos OpenNebula está escrito en Perl. Se ejecuta de manera local en el servidor OpenNebula y recuperará toda la información necesaria utilizando los propios comandos de gestión de OpenNebula. Permite la monitorización de los siguientes tipos de elementos:

• Clústeres.
• Hosts.
• Máquinas virtuales.
• Recursos de almacenamiento.

Es imprescindible que el sistema que ejecute el plugin disponga de los siguientes requisitos:

• Perl disponible en el equipo
• Usuario con privilegios para ejecutar los siguientes comandos:
  • onehost.
  • onecluster.
  • onedatastore.

Descargue su copia del plugin de Pandora FMS para OpenNebula de la librería de módulos. Debe extraer el contenido del archivo en un directorio no volátil desde donde pueda ejecutarlo, ya bien sea utilizando el agente de Pandora FMS o el cron de sistema.

unzip pandora_OpenNebula.zip

Configuración disponible para el plugin Pandora FMS para OpenNebula.

mode

Modo de transferencia de datos, “local” o “tentacle”.

tentacle_ip

Dirección IP del servidor Pandora FMS, solo aplica en modo tentacle.

tentacle_port

Puerto en el que el servicio Tentacle está escuchando.

tentacle_opts

Cualquier opción extra que haya configurado en su servicio Tentacle.

tentacle_client

Ruta completa a su cliente Tentacle.

temp

Directorio de trabajo temporal.

local_folder

Ruta de entrega para el modo de transferencia de datos “local”.

agent_interval

Intervalo del agente, por defecto 300.

agent_group

Grupo del Agente, por defecto OpenNebula.

MODULE_GROUP

Grupo de los módulos, por defecto OpenNebula.

MODULE_INTERVAL

Intervalo de los módulos (multiplicador), por defecto 1.

MODULE_TAGS

Etiquetas para los Módulos.

cluster_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo clúster.

host_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo servidor de máquinas virtuales.

storage_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo dispositivo de almacenamiento.

vm_agent_header

Cabecera para el nombre del Agente de dispositivos de tipo máquina virtual.

cluster_monitoring

Habilitar (1) o no (0) la monitorización de clústeres.

host_monitoring

Habilitar (1) o no (0) la monitorización de servidores de máquinas virtuales.

storage_monitoring

Habilitar (1) o no (0) la monitorización de dispositivos de almacenamiento.

vm_monitoring

Habilitar (1) o no (0) la monitorización de máquinas virtuales

RENAME aaa TO bbb

Regla para el renombrado de entidades, puede definir tantas directivas como elementos necesite renombrar.

REJECT aaa

Regla para la exclusión de monitorización de entidades, puede definir tantas directivas como elementos necesite excluir.

Para programarlo a través del cron de sistema puede añadir la línea siguiente a /etc/crontab:

/5 * * * * root "<ruta>/pandora_opennebula" "<ruta>/pandora_opennebula.conf"> /dev/null 2>&1

Si ejecuta el plugin manualmente la salida debe ser similar a la que sigue:

[[email protected] ~]# ./pandora_opennebula pandora_opennebula.conf
[[email protected] ~]# echo $?
0

Lista de módulos generados por el plugin OpenNebula:

Para Hosts:

1. Available CPU
2. Available Disk
3. Available memory
4. Error reported by OpenNebula
5. State
6. Total zombies
7. VMs running

Para dispositivos de almacenamiento:

1. Disk Free %

Para máquinas virtuales:

1. Assigned CPU
2. Assigned Memory
3. Network RX
4. Network TX
5. State
6. Time running

Ejemplo de mapa de arquitectura OpenNebula:

Este plugin permite monitorizar equipos de virtualización IBM AIX a través de la consola de administración de hardware HMC. Este plugin recolectará información de todas las particiones lógicas creadas en un entorno AIX administrado por un sistema HMC, creando un Agente por cada servidor administrado, cada partición lógica y cada servidor IO virtual.

Para recoger la información vía SSH, el plugin puede utilizar tres modos de trabajo:

1. Basado en expect utilizando el script ssh_launcher.sh.
2. Basado en la librería Net::SSH::Perl
3. Basado en la librería Net::SSH::Expect

Para complementar la información capturada también se realizarán consultas contra la API REST, por defecto en:

https://fqdn:12443/rest/api/{root_element}

Los parámetros necesarios que tiene que proporcionar el área que requiere los servicios de monitorización son:

• Nombre de usuario para autenticarse en el sistema HMC (solo lectura).
• El usuario debe tener permiso para poder conectarse a la API REST y para hacer login en la shell del HMC y ejecutar los siguientes comandos (como mínimo):
  • lssyscfg
  • lshwres
• Contraseña de dicho usuario.
• Ubicación (FQDN/IP) del HMC (p.e. myhmc.mydomain)
• URL base de la API rest del HMC, por ejemplo:

https://myhmc.mydomain:12443

Los parámetros que monitoriza el plugin son (agrupados por tipo de elemento):

• Current logical partitions
• Max logical partitions
• Max memory available
• Max memory installed
• Proc pool DefaultPool current proc units
• Proc pool DefaultPool max proc units
• Proc pool DevelopmentPool current proc units
• Proc pool DevelopmentPool max proc units
• Proc pool ProductionPool current proc units
• Proc pool ProductionPool max proc units
• Proc pool TestPool current proc units
• Proc pool TestPool max proc units
• Proc pool VIOPool current proc units
• Proc pool VIOPool max proc units
• Processor pools configured
• Processor units available
• Processor units installed
• State
• UUID
• Virtual proc units max

LPAR:

• Auto start : Configuración de particiones lógicas autoinicio.
• LPAR type : Tipo de partición lógica.
• LPAR UUID : Usado para consultar los HMC API.
• Max memory : Memoria máxima.
• Max memory : Memoria disponible.
• Processor units available : Unidades de procesamiento disponibles.
• Processor units current : Unidades de procesamiento instaladas
• RMC IP address : Dirección IP RMC.
• RMC state : Estado del RMC en LPAR
• State : Estado de la partición lógica.
• Virtual proc units : Unidades de procesamiento virtual asignadas a este LPAR.

Virtual IO:

• Auto start : Configuración de particiones lógicas autoinicio.
• LPAR type : Tipo de partición lógica.
• LPAR UUID : Usado para consultar los HMC API.
• Max memory : Memoria máxima.
• Max memory current : Memoria disponible.
• Processor units available: Unidades de procesamiento disponibles
• Processor units current : Unidades de procesamiento instaladas
• RMC IP address : Dirección IP RMC.
• RMC state RMC : Estado del RMC en LPAR.
• State : Estado de la partición lógica.
• Virtual proc units : Unidades de procesamiento virtual asignadas a este LPAR.

Configuración disponible para el plugin Pandora FMS para IBM HMC:

mode

Modo de transferencia de datos, “local” o “tentacle”.

tentacle_ip

Dirección IP del servidor Pandora FMS, solo aplica en modo tentacle.

tentacle_port

Puerto en el que el servicio tentacle está escuchando.

tentacle_opts

Cualquier opción extra que haya configurado en el servicio tentacle.

tentacle_client

Ruta completa a su cliente tentacle.

temp

Directorio de trabajo temporal.

local_folder

Ruta de entrega para el modo de transferencia de datos “local”.

hmc_host

IP o FQDN de la HMC

hmc_user

Usuario con permiso de lectura

hmc_pass

Contraseña

as_agent_plugin

La salida del plugin se devolverá en formato XML para ejecuciones programadas con el Agente de Pandora FMS ( as_agent_plugin = 1 ). O salida estándar ( as_agent_plugin = 0 ) para ejecuciones programadas con el cron de sistema o realizadas como plugin de servidor.

agent_name

Opcional, indicar un nombre para el Agente padre, por defecto `hostname`

agent_interval

Intervalo del Agente, por defecto 300.

agent_group

Grupo del Agente, por defecto IBM

module_group

Grupo de los Módulos, por defecto IBM.

module_interval

Intervalo de los Módulos (multiplicador), por defecto 1.

module_tags

Etiquetas para los módulos

Para el renombrado de entidades se utiliza un renombrado por bloque:

 rename
 MyLPAR_NAME TO my new name
 MyLPAR_NAME2 TO my second new name
 rename_end

El plugin de Pandora FMS para la monitorización de sistemas IBM AIX a través de HMC se despliega de la siguiente manera:

Configurando el parámetro as_agent_plugin a 1 (ejecución como plugin de agente):

module_plugin /usr/bin/perl pandora_hmc.pl pandora_hmc.conf

Configurando el parámetro as_agent_plugin a 0 (ejecución como plugin de servidor):

 # /etc/crontab
 */5 * * * * root /usr/bin/perl /root/hmc/pandora_hmc.pl /root/vmware/pandora_hmc .conf

La virtualización de máquinas provista por Hewlett-Packard® permite correr concurrentemente múltiples máquinas virtuales en cualquier servidor Itanium® corriendo HP-UX®. Es un producto optimizado para servidores.

Este plugin permite monitorizar equipos de virtualización HPVM. Se lanza como un plugin de Agente, generando en paralelo un agente más por cada equipo virtualizado alojado en el sistema monitorizado.

Para recoger la información se utilizan comandos locales.

Verifique cada uno de los siguientes pasos:

• Desplegar un Agente de Pandora FMS en el equipo que se desee monitorizar.
• Disponer de un usuario con permisos para ejecutar el plugin
• Este usuario debe disponer de permisos para ejecutar el comando hpvmstatus para poder interpretar la salida:

1. hpvmstatus.
2. hpvmstatus -X.
3. hpvmstatus -r -X.

Descargue su copia del plugin de Pandora FMS para HPVM HP Virtualization Manager monitoring de la librería de módulos. Puede programar la ejecución utilizando colecciones y el Agente de Pandora FMS desplegado o bien extraer el contenido del archivo en un directorio no volátil desde donde pueda ejecutarlo a través del cron de su sistema.

unzip pandora_HPVM.zip

Configuración disponible para el plugin Pandora FMS para HPVM.

mode

Modo de transferencia de datos, “local” o “tentacle”.

tentacle_ip

Dirección IP del servidor Pandora FMS, solo aplica en modo tentacle.

tentacle_port

Puerto en el que el servicio Tentacle está escuchando.

tentacle_opts

Cualquier opción extra que haya configurado en su servicio Tentacle.

tentacle_client

Ruta completa a su cliente Tentacle.

temp

Directorio de trabajo temporal.

local_folder

Ruta de entrega para el modo de transferencia de datos “local”.

agent_name

Opcional, indicar un nombre para el Agente padre, por defecto hostname

agent_interval

Intervalo del Agente, por defecto 300.

agent_group

Grupo al que pertenecerán los agentes, por defecto HPVM.

module_group

Grupo de los Módulos.

module_interval

Intervalo de los Módulos (multiplicador), por defecto 1.

module_tags

Etiquetas para los Módulos.

Ejecutando el plugin desde el Agente de Pandora FMS, aparecerá en el fichero de configuración del Agente:

module_plugin /usr/bin/perl pandora_hpvm.pl pandora_hpvm.conf

Para una prueba manual, configure el plugin siguiendo los pasos descritos, puede lanzarlo como sigue:

perl pandora_hpvm.pl pandora_hpvm.conf

Lista de Módulos generados por el plugin por tipo de elemento.

Agentes del servidor:

• Available VMs : Máquinas virtuales disponibles.
• HPVM Plugin : Estado de ejecución del plugin HPVM.
• HPVM Service : Presencia de hpvmctrld (X instancias).
• HPVM Service CPU usage CPU : Uso de CPU del hpvmctrld (X instancias).
• HPVM Service RAM : Uso de RAM del hpvmctrld (X instancias).
• hpvmapp : Presencia de hpvmapp (X instancias).
• hpvmapp CPU : Uso de CPU del hpvmapp (X instancias).
• hpvmapp RAM : Uso de RAM del hpvmapp (X instancias)

Máquinas virtuales:

• boot_type
• console_type
• CPU usage
• device_number
• direct_io_number
• distributed
• effective_serverid
• guest_type
• Host RAM available
• Host RAM free
• local_id
• memory total
• model_name
• networks_number
• run_pid
• run_serverid
• serial_number
• uuid
• vcpu_number
• vm_condition
• vm_config_label
• vm_config_version
• vm_state
• vm_version
• vm_version_label

Volver al Índice de Documentación Pandora FMS