Plugin de monitorización de Hyper-V que permite manejar arquitecturas virtuales Hyper-V facilmente. Para más información visite la siguiente pagina web: http://pandorafms.com/index.php?sec=Library&sec2=repository&lng=es&action=view_PUI&id_PUI=587

1. Pandora FMS
Manual Plugin Hyper-V

2. Manual Plugin Hyper­V
© Artica Soluciones Tecnológicas 2005­2013
Índice de contenido
1Histórico de cambios..........................................................................................................................3
2Introducción a la monitorización Vmware.........................................................................................4
3Matriz de compatibilidad ...................................................................................................................5
4Requisitos para la ejecución/configuracion del Plugin......................................................................6
5Módulos de agentes de la arquitectura virtual Hyper-V ...................................................................7
5.1.Módulos para agente local ........................................................................................................7
5.2.Módulos para agentes del tipo máquina virtual ........................................................................8
6Instalacion del Plugin.........................................................................................................................9
7Parametrizacion del Archivo de Configuracion...............................................................................10
8Capturas de Configuración y Resultados.........................................................................................13

3. 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

4. 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

5. 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

6. 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

7. 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

8. 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

9. 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_agentutil).
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 tempconfig.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

10. 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.50
Interval 300
Agent_Version 5.0
Group Servers
File_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#ALL
VM_Uptime OK
VM_Dinamic_Memory OK
VM_I/O_Disk OK
VM_I/O_Network OK
VM_Snapshot OK
# Host Module Configuration
HS#ALL
HS_Dynamic_Memory OK
HS_I/O_Disk OK
HS_I/O_Network OK
HS_Mem OK
HS_CPU OK
HS_Critical NO
HS_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

11. 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

12. 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

13. 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_begin
module_plugin powershell -Command "hyperV_v1r1.ps1 -c tempHyperV-config.txt"
module_interval 2
module_end
Page 13

14. 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