Las claves en 30 segundos
- LibreNMS monitoriza Proxmox VE a través de su API. Descubre las máquinas virtuales y los contenedores LXC de cada host y recoge su uso de CPU, memoria, disco, E/S de disco y red. Las operaciones de disco (IOPS) solo están disponibles para las VMs.
- Hay que configurarlo en cada nodo. El método de sondeo «Proxmox API» se añade nodo a nodo, y cada nodo solo informa de los invitados que ejecuta. Si en un nodo falta, sus VMs y contenedores no se monitorizan.
- Basta un token de solo lectura con el rol
PVEAuditor. En Proxmox VE 9 ese rol ya permite leer el agente QEMU de las VMs; en Proxmox VE 8 haría falta un privilegio que deja de ser de solo lectura.
- Sustituye al método anterior, el script por SNMP. Al actualizar, LibreNMS borra las tablas y los datos de la aplicación Proxmox anterior, y las gráficas de tráfico antiguas no se conservan.
- Es muy reciente. Entró en la rama principal de LibreNMS el 9 de noviembre de 2026, junto a un sistema nuevo de métodos de sondeo y secretos que se fusionó el 20 de octubre.
LibreNMS es una de las herramientas de monitorización de red de código abierto más extendidas. Descubre equipos por SNMP, dibuja sus interfaces y avisa cuando algo cae. Con Proxmox VE siempre tuvo una relación algo forzada: para ver las máquinas virtuales había que instalar un script en cada host, exponerlo por SNMP con un extend y, en muchos casos, darle sudo al usuario del demonio SNMP. Lo que se obtenía a cambio era poco más que el tráfico de red de cada VM.
Eso ha cambiado. La documentación de LibreNMS para Proxmox describe ahora un método distinto, basado en la API REST de Proxmox VE, con más métricas y sin tocar SNMP. El cambio tiene letra pequeña, y es la que más conviene leer antes de actualizar.
Qué mide y qué no
Con el método nuevo, LibreNMS recoge por cada invitado:
| Métrica | Máquinas virtuales | Contenedores LXC |
|---|
| CPU | Sí | Sí |
| Memoria | Sí | Sí |
| Uso de disco | Sí (mejor con el agente QEMU) | Sí |
| E/S de disco (bytes) | Sí | Sí |
| Operaciones de disco (IOPS) | Sí | No |
| Red | Sí | Sí |
| Sistema operativo | Solo con el agente QEMU | Tipo de sistema, desde la configuración |
Cada invitado tiene su propia página con sus gráficas, colgada del dispositivo del nodo donde se ejecuta. Si la VM migra a otro nodo, el nuevo la asume en su siguiente sondeo y LibreNMS registra un evento de migración; la VM conserva su página y su histórico. Para conseguirlo, las gráficas se guardan por clúster, no por dispositivo, en rrd/proxmox-<id del clúster>/.
Ese identificador sale de la huella del certificado raíz de la CA de Proxmox. Así, dos clústeres que se llamen igual no se mezclan. La contrapartida: si regeneras la CA del clúster, LibreNMS empieza gráficas nuevas. Para no perder el histórico hay que renombrar el directorio a mano.
El uso de disco de las VMs tiene un matiz. Si la VM tiene el agente QEMU en marcha, LibreNMS lee de él el espacio real ocupado en cada sistema de archivos. Si no, usa los valores del hipervisor, que no informan del espacio usado y solo dan el tamaño del disco de arranque. En la práctica, sin agente QEMU no sabrás si una VM se está quedando sin disco.
Por qué hay que configurar cada nodo
Es la advertencia que más repite la documentación, y tiene una explicación técnica. El código de LibreNMS pide la lista de invitados a nodes/localhost/qemu y nodes/localhost/lxc: es decir, a cada nodo le pregunta por sus VMs y sus contenedores, no por los del clúster. Proxmox puede devolver todo el inventario desde cualquier nodo, pero LibreNMS ha optado por colgar cada invitado del dispositivo que lo ejecuta, y eso exige hablar con cada uno.
La consecuencia práctica es fácil de olvidar: el día que añades un nodo al clúster, tienes que añadirlo también a LibreNMS con su método de sondeo. Si no, las VMs que el balanceador o la alta disponibilidad muevan a ese nodo dejarán de recoger datos sin que salte ningún aviso de que faltan. Merece la pena tenerlo en la lista de pasos para ampliar un clúster, junto al quórum y la red de Corosync.
Es una diferencia con otras herramientas. La plantilla oficial de Zabbix para Proxmox VE, que repasamos en Proxmox VE, Zabbix y Grafana, consulta /cluster/resources y ve el clúster entero desde un único punto. LibreNMS gana a cambio una vista por dispositivo coherente con el resto de su inventario de red.
Paso 1: crear el token en Proxmox
En cualquier nodo del clúster (los usuarios y los permisos se replican a todos), se crea un usuario dedicado, se le da el rol de solo lectura PVEAuditor sobre la raíz y se le genera un token:
pveum user add librenms@pve
pveum aclmod / -user librenms@pve -role PVEAuditor
pveum user token add librenms@pve monitoring --privsep 0
El ID del token queda como librenms@pve!monitoring. El secreto solo se muestra una vez: guárdalo en el gestor de contraseñas antes de cerrar la terminal.
La opción --privsep 0 hace que el token herede los permisos del usuario, que aquí son solo de lectura. Si prefieres separar privilegios, puedes crear el token con separación y asignarle el rol directamente a él; el resultado es el mismo y el usuario queda sin permisos propios. Repasamos ese patrón en cómo endurecer el acceso a Proxmox.
El agente QEMU y la versión de Proxmox
Aquí la versión de Proxmox importa:
- Proxmox VE 9:
PVEAuditor ya incluye VM.GuestAgent.Audit, que permite leer del agente QEMU el sistema operativo y los sistemas de archivos. El token sigue siendo de solo lectura.
- Proxmox VE 8:
PVEAuditor no da acceso al agente. LibreNMS no recogerá el sistema operativo de las VMs y usará los valores de disco del hipervisor. Para tenerlos haría falta VM.Monitor, pero ese privilegio también permite ejecutar comandos dentro de la VM, escribir ficheros y cambiar contraseñas a través del agente. La propia documentación de LibreNMS advierte que el token deja de ser de solo lectura.
Nuestra recomendación es no dar VM.Monitor a un token de monitorización. Proxmox VE 8 dejó de tener soporte en agosto de 2026, así que la salida razonable es actualizar a la 9 y no ampliar permisos.
Paso 2: añadir el método de sondeo en LibreNMS
El nodo de Proxmox tiene que existir como dispositivo en LibreNMS. Después:
- Entra en el dispositivo y ve a Edit → Polling.
- Añade el método Proxmox API.
- Crea un secreto con el ID del token y su valor. Los secretos se guardan cifrados con la clave de la aplicación (
APP_KEY) y se pueden compartir entre dispositivos, así que un mismo secreto sirve para todos los nodos del clúster.
- Revisa los ajustes:
| Ajuste | Valor por defecto |
|---|
| Hostname | El del dispositivo |
| Puerto | 8006 |
| Tiempo de espera | 10 segundos |
| Verificar el certificado TLS | Sí |
El método activa el módulo vminfo del dispositivo. Las VMs aparecen en el siguiente ciclo de descubrimiento, no al instante. Si en Edit → Modules tienes vminfo desactivado a mano, ese ajuste manda.
Repite el proceso en cada nodo del clúster.
El certificado
Proxmox VE se instala con un certificado autofirmado, y LibreNMS lo rechazará con la verificación TLS activada. Hay dos salidas: desactivar la verificación o instalar en cada nodo un certificado de confianza. La segunda es la correcta y no cuesta mucho: Proxmox VE tiene integrado ACME para pedir certificados de Let’s Encrypt desde Nodo → Sistema → Certificados. Desactivar la verificación hace que el token viaje a un servidor cuya identidad nadie comprueba; en una red de gestión aislada puede aceptarse, en cualquier otra no.
Antes de actualizar: lo que se borra
Si ya monitorizabas Proxmox con el método anterior (el script proxmox de librenms-agent expuesto por SNMP con extend), la actualización tiene consecuencias. La migración de base de datos que acompaña al cambio:
- Borra las tablas
proxmox y proxmox_ports.
- Elimina las aplicaciones Proxmox de todos los dispositivos y sus métricas.
- Quita la opción
enable_proxmox de la configuración.
- Deja un aviso en LibreNMS: los dispositivos dejan de recoger datos de Proxmox hasta que un administrador añada el método nuevo en cada host, y las gráficas de tráfico anteriores no se trasladan.
Si ese histórico te importa, para auditorías o para comparar consumos de un año a otro, exporta las gráficas o copia los RRD antes de actualizar. Después, el script ya no sirve: puedes quitar la línea extend proxmox de snmpd.conf, la entrada de sudoers si la tenías y el paquete libpve-apiclient-perl si no lo usa nada más.
¿Cuándo llega a tu instalación?
Depende de cómo instalaste LibreNMS:
- Instalación clásica desde git: por defecto, LibreNMS se actualiza solo cada noche a las 00:19 con
daily.sh, desde la rama principal. Si no has desactivado las actualizaciones automáticas, ya lo tienes, y la migración ya se ha ejecutado.
- Actualizaciones desactivadas o solo ciertos días (
update o update_on_days): llegará cuando ejecutes ./daily.sh o en el día configurado.
- Imagen Docker o paquetes que siguen las versiones publicadas: llegará con la primera versión mensual que lo incluya. A 10 de noviembre, la última versión publicada era la 26.10.2, que no lo trae.
En los tres casos conviene saber que el cambio viene con otro más grande: los métodos de sondeo y los secretos, fusionados el 20 de octubre. Mueven las credenciales SNMP, IPMI y del agente Unix desde la tabla de dispositivos a esos dos modelos nuevos, y la migración las convierte automáticamente. Si tienes varios pollers distribuidos, todos deben usar la misma APP_KEY, porque los secretos van cifrados con ella.
Qué haríamos nosotros
- Si ya usas LibreNMS para la red, el método nuevo merece la pena: pasas de ver tráfico por VM a ver CPU, memoria, disco y E/S, con histórico que sobrevive a las migraciones. Crea un token por clúster, comparte el secreto entre nodos y apunta en el procedimiento de alta de nodos que hay que añadirlo también aquí.
- Si venías del script por SNMP, guarda antes los RRD que quieras conservar y revisa después que todos los nodos tienen el método. El aviso de LibreNMS te dirá que la aplicación se eliminó, pero no qué nodos te faltan.
- Si no usas LibreNMS, no hay motivo para adoptarlo solo por esto. Para Proxmox, Prometheus y Grafana o Zabbix dan más detalle del propio hipervisor. LibreNMS tiene sentido cuando la red es lo principal y quieres tener los hosts y sus VMs en la misma herramienta.
- En cualquier caso, instala el agente QEMU en las VMs. Sin él, LibreNMS no puede decirte cuánto disco ocupan, y ninguna otra herramienta lo hará mejor por la misma vía.
Si gestionas varios clústeres y prefieres que la monitorización la lleve un tercero, en servicios gestionados te contamos cómo trabajamos con Proxmox.
Preguntas frecuentes
¿LibreNMS monitoriza Proxmox VE sin SNMP?
Para las VMs y los contenedores, sí: el método «Proxmox API» usa la API REST de Proxmox VE en el puerto 8006 con un token. El nodo sigue apareciendo como dispositivo en LibreNMS y puede monitorizarse además por SNMP para sus interfaces, discos y sensores.
¿Por qué no aparecen las VMs de un nodo?
Porque ese nodo no tiene configurado el método de sondeo «Proxmox API». Cada nodo solo informa de los invitados que ejecuta, así que hay que añadir el método en todos. También puede ser que aún no haya pasado el siguiente ciclo de descubrimiento, o que el módulo vminfo esté desactivado a mano en el dispositivo.
¿Qué permisos necesita el token de Proxmox para LibreNMS?
El rol PVEAuditor, de solo lectura, asignado en la raíz (/). En Proxmox VE 9 incluye el acceso al agente QEMU que LibreNMS usa para leer el sistema operativo y el uso de disco de las VMs.
¿Se conservan las gráficas al migrar una VM entre nodos?
Sí. LibreNMS guarda las gráficas por clúster, no por nodo, y registra un evento de migración. La VM mantiene su página y su histórico. Lo que inicia gráficas nuevas es regenerar la CA raíz del clúster.
¿Qué pasa con el script de Proxmox por SNMP que usaba antes?
Deja de usarse. La actualización elimina la aplicación Proxmox anterior, sus tablas y sus métricas, y las gráficas de tráfico antiguas no se trasladan. Puedes quitar el script y la línea extend de snmpd.conf de los hosts.
Fuentes