# KVM - plugin de monitorización.

# Introducción

Esta guía permite monitorizar el estado de un entorno KVM en ejecución desde Pandora FMS.

Los siguientes comandos se utilizan para obtener información sobre el estado de las máquinas virtuales (VM) de KVM:

- **virsh:** Se utiliza para obtener el estado de las máquinas virtuales y sus métricas de rendimiento.
- **libvirtd:** Se utiliza para comprobar el estado del servidor y los recursos que está consumiendo.

# Matriz de compatibilidad

<table border="1" id="bkmrk-%C2%A0-systems-where-it-h" style="border-collapse: collapse; width: 100%;"><tbody><tr><td class="align-center">**Sistemas donde ha sido probado**

</td><td>- Centos
- Ubuntu 24.04
- Rocky Linux 9

</td></tr><tr><td class="align-center">**Sistemas donde deberia funcionar**</td><td>- Linux based systems

</td></tr></tbody></table>

# Prerequisitos

Para configurar el plugin, necesitarás:

- Un **Pandora FMS Endpoint** desplegado en tu sistema.
- **Perl 5.x** o superior.
- El comando **unzip** (para el despliegue de la colección).
- El usuario utilizado para ejecutar el plugin debe tener permisos para ejecutar el comando **virsh** y conectarse a la instancia de **libvirtd**.

# Despliegue y configuración

Se puede desplegar el plugin subiéndolo manualmente o desplegandolo mediante colecciones en los EndPoint.

\--

Una vez desplegado, habrá que configurarlo en el apartado Plugins del EndPoint

[![imagen (4).png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-08/scaled-1680-/imagen-4.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-08/imagen-4.png)

Si deseas monitorizar varias instancias de servidores KVM con una única ejecución, o una instancia remota, puedes especificar el conjunto de servidores en el archivo de configuración de la siguiente manera:

```bash
user@server
```

<p class="callout info">Recuerda que el acceso SSH al servidor remoto debe realizarse sin intervención del usuario, por lo que debes copiar la clave SSH del equipo que ejecuta el script a los servidores de destino.</p>

# Ejemplos de uso

Puedes ejecutar el script manualmente de la siguiente manera:

```bash
./pandora_kvm.64 [kvm.conf]
```

Por ejemplo, esta es la salida en formato XML de los módulos generados por el plugin:

```bash
<module>
    <name><![CDATA[(local) KVM Server status]]></name>
    <type></type>
    <data><![CDATA[1]]></data>
    <description><![CDATA[Status of the KVM server. 1 instances of libvirtd]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) KVM Server RAM usage]]></name>
    <type>generic_data</type>
    <data><![CDATA[0]]></data>
    <description><![CDATA[RAM usage by the KVM server]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) KVM Server CPU usage]]></name>
    <type>generic_data</type>
    <data><![CDATA[0]]></data>
    <description><![CDATA[CPU usage by the KVM server]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) Number of VMs]]></name>
    <type>generic_data</type>
    <data><![CDATA[2]]></data>
    <description><![CDATA[Shows the number of available VMs in the KVM system]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) Status of ubuntu22.04]]></name>
    <type>generic_proc</type>
    <data><![CDATA[1]]></data>
    <description><![CDATA[Status of ubuntu22.04: running]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) Status of crc]]></name>
    <type>generic_proc</type>
    <data><![CDATA[0]]></data>
    <description><![CDATA[Status of crc: shut]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) CPU usage of ubuntu22.04]]></name>
    <type></type>
    <data><![CDATA[4,5]]></data>
    <description><![CDATA[CPU usage of ubuntu22.04]]></description>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) Virtual CPU usage of ubuntu22.04]]></name>
    <type></type>
    <data><![CDATA[0,5]]></data>
    <description><![CDATA[Virtual CPU usage of ubuntu22.04]]></description>
    <unit><![CDATA[%]]></unit>
    <module_group>KVM</module_group>
</module>
<module>
    <name><![CDATA[(local) Virtual memory usage of ubuntu22.04]]></name>
    <type></type>
    <data><![CDATA[100.00]]></data>
    <description><![CDATA[Mem usage of ubuntu22.04 4194304 of 4194304]]></description>
    <unit><![CDATA[%]]></unit>
    <module_group>KVM</module_group>
</module>
```

Y estos son los módulos en la consola de Pandora FMS:

[![imagen (3).png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-08/scaled-1680-/imagen-3.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-08/imagen-3.png)