Pandora FMSManual Plugin Hyper-V

Manual  Plugin Hyper­V

© Artica Soluciones Tecnológicas 2005­2013

Índice de contenido1Histórico de cambios..........................................................................................................................32Introducción a la monitorización Vmware.........................................................................................43Matriz de compatibilidad ...................................................................................................................54Requisitos para la ejecución/configuracion del Plugin......................................................................65Módulos de agentes de la arquitectura virtual Hyper-V ...................................................................7

5.1.Módulos para agente local ........................................................................................................75.2.Módulos para agentes del tipo máquina virtual ........................................................................8

6Instalacion del Plugin.........................................................................................................................97Parametrizacion del Archivo de Configuracion...............................................................................108Capturas de Configuración y Resultados.........................................................................................13

1 HISTÓRICO DE CAMBIOS

Fecha Autor Cambio Versión

08/10/13 Mario P Primera versión del plugin V1r1

14/10/13 S. Lerena

Global revission V1r1.1

Page 3

2 INTRODUCCIÓN A LA MONITORIZACIÓN HYPER­V Los entornos virtuales tiene gran importancia en las arquitecturas IT de todas las empresas y por 

ello su monitorización es esencial. Con Pandora FMS Enterprise podrás tener acceso al  Hyper­V 

Monitoring Plugin un plugin que permite tener bajo control la arquitectura virtual Hyper de forma 

sencilla. 

 

Page 4

3 MATRIZ DE COMPATIBILIDAD 

La matriz de compatibilidad de la monitorización Hyper­V  es la que se muestra a continuación:

Sistemas donde se ha probado • Hyper­V 2012

Sistemas donde debería funcionar • Hyper­V 2008

Page 5

4 REQUISITOS PARA LA EJECUCIÓN/CONFIGURACION DEL PLUGIN

Los requisitos para el correcto funcionamiento del Plugin son los siguientes:

­ Instalar el agente de Pandora FMS en la versión 3.2.1 o superior.  

­   Una   consola   Powershell   para   ejecutar   el   plugin.   Por   defecto   viene   instalada   en 

sistemas Windows Server 2008 R2 y Windows 2012 por lo tanto no debería haber problemas en 

este punto de los requisitos.

­ Es necesario que el usuario con el que se ejecuta el agente de Pandora FMS, que es el  

usuario que ejecutará el plugin, disponga de los siguiente permisos del sistema: 

– Administrador Local

­ Tener habilitado WMI y los contadores de rendimiento asi como la Administrador de 

Hyper­V   remoto   mediante   comandos   powershell   (   Get­VM,   Get­VMMemory,   Get­

VMHardDiskDrive....). Suelen estar habilitadas en equipos donde se encuentra Hyper­V instalado, 

pero en el caso de error a la hora de su ejecución, revisar estos 3 puntos.

­ La política de ejecución de scripts Powershell debe ser establecida como RemoteSigned 

o inferior: 

Set­ExecutionPolicy RemoteSigned

Page 6

5 MÓDULOS DE AGENTES DE LA ARQUITECTURA VIRTUAL HYPER­V  Los módulos disponibles para cada elemento de la arquitectura Hyper­V  son los siguientes: 

5.1. Módulos para agente local 

• % Mem Use: Porcentaje de uso de memoria RAM del equipo Host en uso. Viene definido por 

defecto con unos umbrales que se pueden modificar una vez este definido el módulo en la 

consola de Pandora.

• CPU Use: Porcentaje de uso de CPU del equipo Host. Viene definido por defecto con unos 

umbrales   que   se   pueden  modificar   una   vez   este   definido   el  módulo   en   la   consola   de 

Pandora.

• Avail   Dynamic   Memory   Balancer:   Cantidad   total   de   memoria   física   del   host   en   Bytes, 

disponible para intercambio de Memoria Dinámica. 

• FreeDisk (Volume_Name): %Disco libre en los diferentes Volumenes del Host. Viene definido 

por defecto con unos umbrales que se pueden modificar una vez este definido el módulo en 

la consola de Pandora. Se añadirán tantos módulos como unidades haya en el equipo.

• Disk Read Bytes (Volume_Name) : Bytes/sec leidos por cada Disco. 

• Disk Write Bytes (Volume_Name) : Bytes/sec escritos en cada Disco. 

• Health VM Critical: Numero de VM que se encuentran en estado crítico. Cuando hay alguna 

aparece en estado crítico el módulo.

• Bytes  Sent  (Interfaz):  Número de bytes/sec enviados por  cada  interfaz  de red.  Se podrá 

configurar en la consola de Pandora los intervalos dependiendo de la velocidad del interfaz 

si es mayor al 50% de la velocidad hasta 79% en estado warning y si es mayor del 80% en 

estado crítico.

• Bytes Received (Interfaz): Número de bytes/sec recibidos por cada interfaz de red. Se podrá 

configurar en la consola de Pandora los intervalos dependiendo de la velocidad del interfaz 

si es mayor al 50% de la velocidad hasta 79% en estado warning y si es mayor del 80% en 

estado crítico.

• Packets Received: Número de paquetes recibidos por  la  interfaz de red en cada intervalo 

(Pack/sec)

Page 7

5.2. Módulos para agentes del tipo máquina virtual 

• VMsUptime: Uptime de la Máquina Virtual. 

• Status: Estado de la conexión. Se mostrará en la descripción el estado concreto en el que se 

encuentra, aunque si esta apagada, observaremos el módulo en estado crítico.

• %Mem Dynamic Use: Porcentaje de memoria dinámica usada por la máquina virtual, este 

módulo solo se generará si la memoria dinámica se encuentra habilitada en la configuración 

de   la   Máquina   Virtual.   Viene   definido   por   defecto   con   unos   umbrales   que   se   pueden 

modificar una vez este definido el módulo en la consola de Pandora.

• CPU Usage:  % CPU usada en  la  máquina Virtual.    Viene  definido por defecto  con unos 

umbrales   que   se   pueden  modificar   una   vez   este   definido   el  módulo   en   la   consola   de 

Pandora.

• Read_Bytes/sec: Bytes por segundo de lectura del disco perteneciente a la Máquina Virtual. 

• Write_Bytes/sec: Bytes por segundo de escritura del disco perteneciente a la Máquina Virtual. 

• %Disk used: Porcentaje libre del disco de la máquina virtual. (Habrá un módulo por cada 

disco que contenga la máquina virtual). 

• Bytes Received/sec: Bytes/sec recibidos por el adaptador de red de la Máquina Virtual. Se 

podrá configurar en la consola de Pandora los intervalos dependiendo de la velocidad del 

interfaz si es mayor al 50% de la velocidad hasta 79% en estado warning y si es mayor del  

80% en estado crítico. En este caso será 

• Bytes Send/sec: Bytes/sec enviados por el adaptador de red de la Máquina Virtual. Se podrá 

configurar en la consola de Pandora los intervalos dependiendo de la velocidad del interfaz 

si es mayor al 50% de la velocidad hasta 79% en estado warning y si es mayor del 80% en 

estado crítico.

• Number of Snapshots: Número de Snapshots que existen de la Máquina Virtual monitorizada.

Page 8

6 INSTALACION DEL PLUGIN

Este plugin se trata de un plugin de Agente, por lo tanto habrá que realizar la llamada en el archivo 

de configuración del módulo. La llamada se realizará de la siguiente forma:

module plugin powershell.exe ­command “plugin_hyper­V.ps1 ­c hyperV_config.txt“

El ejemplo indicado se dará en el caso en el que el plugin se encuentre copiado en la carpeta por  

defecto del agente windows ( %programfiles%\pandora_agent\util).

También  por  defecto  esta   configurado  el  plugin,  para  que  dentro  de  util   se   cree  una   carpeta 

temporal (temp), donde se guarden momentáneamente los XML de los agentes correspondientes a 

las máquinas virtuales y donde se podrá guardar también el archivo de configuración del plugin. Si 

no se añade ningún nombre de archivo de configuración, este lo buscará en temp\config.txt. Si no 

se encuentra ahi, el plugin dará errores, por lo que habrá que indicarselo en la llamada.

Para ejecutar la ayuda se realiza de la siguiente forma

plugin_hyper­V.ps1 ­h

Page 9

7 PARAMETRIZACION DEL ARCHIVO DE CONFIGURACION

A continuación se va a explicar la parametrización del archivo de configuración

Este es un ejemplo del mismo:

ServerIP 192.168.1.50Interval 300Agent_Version 5.0Group ServersFile_Path temp/Tentacle_Options

# VM Module Configuration (if you don't want to use any module use NO or delete it of the list)VM#ALLVM_Uptime OKVM_Dinamic_Memory OKVM_I/O_Disk OKVM_I/O_Network OKVM_Snapshot OK

# Host Module ConfigurationHS#ALLHS_Dynamic_Memory OKHS_I/O_Disk OKHS_I/O_Network OKHS_Mem OKHS_CPU OKHS_Critical NOHS_FreeDisk OK

Server IP : En este “token” debemos configurar la IP del servidor a la que esta apuntando el agente 

y se utilizará para el envío de los XML que se forman con cada una de las máquinas virtuales.

Interval   :  Indicaremos  el   intervalo  que  van  a   tener   los   agentes  de   las  máquinas  virtuales,   es 

recomendable indicar un intervalo proporcional al del agente. Por ejemplo si el agente tiene 300, 

indicariamos 300, 600, 900, 1200..

Agent_version: Indicaremos la versión del agente de Pandora donde esta instalado el agente para 

que lo muestre en la consola de Pandora.

Group : Se configurará el grupo al que querramos que pertenezcan nuestros agentes VM.

File_Path: Habrá que indicarle el PATH donde queremos que se guarden de forma temporal los 

XML de los diferentes agentes que se formarán con cada máquina virtual. La configuración deberá 

indicar al final del todo “/”

Page 10

Tentacle_Options : En este token indicaremos las opciones de envío de tentacle. En el caso que no 

se necesite ninguna no se indicará nada como esta en el ejemplo. Estas son las opciones disponibles

        ­c              Enable SSL without a client certificate.

        ­e cert         OpenSSL certificate file. Enables SSL.

        ­f ca           Verify that the peer certificate is signed by a ca.

        ­k key          OpenSSL private key file.

        ­p port         Server port (default 41121).

        ­x pwd          Server password.

        ­y proxy        Proxy server string (http://user:password@address:port).

Modulos de VM

VM_ALL : Si únicamente está este token de la forma indicada (VM_ALL) enviará la información de 

todos los módulos disponibles. Si no queremos que se envien todos, debemos eliminar este token o 

como se indica en el ejemplo, falsearlo (VM#ALL)

VM_Uptime: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

VM_Dinamic_Memory:  Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo 

tenemos que configurar un NO o eliminarlo de la lista.

VM_I/O_Disk: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

VM_I/O_Network: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos 

que configurar un NO o eliminarlo de la lista.

VM_Snapshot: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

Page 11

Configuración de los módulos del host.

HS_ALL: Si únicamente está este token de la forma indicada (VM_ALL) enviará la información de 

todos los módulos disponibles. Si no queremos que se envien todos, debemos eliminar este token o 

como se indica en el ejemplo, falsearlo (HS#ALL)

HS_Dynamic_Memory:  Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo 

tenemos que configurar un NO o eliminarlo de la lista.

HS_I/O_Disk: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

HS_I/O_Network: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos 

que configurar un NO o eliminarlo de la lista.

HS_Mem:  Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

HS_CPU:  Mediante un OK,  habilitaremos que se envíe este módulo.  Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

HS_Critical: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

HS_FreeDisk: Mediante un OK, habilitaremos que se envíe este módulo. Para evitarlo tenemos que 

configurar un NO o eliminarlo de la lista.

Page 12

8 CAPTURAS DE CONFIGURACIÓN Y RESULTADOS

Configuración en el agente:

Este   agente   de   ejemplo   ,   tiene   copiado   el   plugin   en   el   directorio   “util”   perteneciente   a 

pandora_agent y el config se encuentra dentro de la carpeta temp con el nombre hyperV_config.txt 

tal y como se indica anteriormente que es su instalación estándar.

Dentro de  la carpeta \temp contenemos el  archivo de configuración del plugin y se guardaran 

también   de   forma   temporal   los   XML   de   los   agentes  VM  y   en   el   caso  de   que   falle   su   envío 

continuaran ahí. Es imprescindible la creación de la carpeta temp o en su caso indicar la ruta 

en el archivo de configuración.

Dentro de la configuración del agente ya sea mediante configuración remota o configuración local 

se quedaría así, este es un ejemplo para la 5.0 en el que la llamada al plugin acepta la siguiente 

configuración.

module_beginmodule_plugin powershell -Command "hyperV_v1r1.ps1 -c temp\HyperV-config.txt"module_interval 2module_end

Page 13

Una vez realizada correctamente la configuración del plugin, este reportará cada intervalo los datos 

y   creará   la   primera   vez   un   agente   por   cada   máquina   virtual   instalada,   y   los   módulos 

correspondientes al Host donde se encuentre instalado el Hyper­V.

Las máquinas virtuales que se encuentren apagadas, en un principio solo reportará un módulo, el 

del estado de la máquina. Hasta que no se enciendan las máquinas virtuales, no reportarán todos 

los módulos que estén habilitados.

Podemos crear un nuevo grupo llamado Hyper­V y en el archivo de configuración del plugin indicar 

ese nombre para que se creen todos los nuevos agentes en ese grupo.

Page 14