Proxmox
Plugin para monitorizar proxmox, pudiendo extraer datos de la API de los nodos, backups, maquinas virtuales, lxc containers y storage
- Introducción
- Matriz de compatibilidad
- Pre requisitos
- Parámetros
- Ejecución manual
- Configuración en PandoraFMS
- Módulos generados por el plugin
Introducción
Ver. 29-11-2022
Plugin para monitorizar proxmox, pudiendo extraer datos de la API de los nodos, backups, maquinas virtuales, lxc containers y storage
Matriz de compatibilidad
Sistemas donde se ha probado |
CentOS 7, Fedora, rocky linux |
Sistemas donde debería funcionar |
Cualquier sistema linux |
Pre requisitos
- Tener el Data Server de Pandora FMS habilitado
- Tener el Plugin Server de Pandora FMS habilitado
Parámetros
Parámetros Proxmox
--host | Ip o host de proxmox |
--user | Nombre del usuario de proxmox que realizará las consultas |
--password | Contraseña del usuario proxmox que realizará las consultas |
--port | Por defecto 8006 |
--vm | Para obtener datos de las máquinas virtuales, 1 para activar 0 para desactivar |
--lxc | Obtener datos de los contenedores lxc, 1 para activar 0 para desactivar |
--backups | Extraer datos de las copias de seguridad, 1 para activar 0 para desactivar |
--nodes | Obtener datos de los nodos, 1 para activar 0 para desactivar |
--discard_node | Descartar un nombre de nodo para el monitoreo de vm y lxc. |
Parámetros configuración pandora
--transfer_mode | Modo de transferencia, local o tentacle. Por defecto será local. |
--tentacle_port | Puerto de tentacle.Por defecto 41121(opcional) |
--tentacle_address | Ip del servidor tentacle al que mandar los datos(opcional) |
-g,--group | Grupo de destino de Pandora FMS (opcional) |
--data_dir | Directorio de datos de Pandora FMS. Por defecto es /var/spool/pandora/data_in/ (opcional) |
--as_discovery_plugin | Para ser ejecutado en modo 'discovery', la ejecución mostrará un json en la salida con información sobre la monitorización. |
Los backups monitorizables son a nivel de cluster, los backups a nivel de vm o lxc container serán incluidos en una futura actualización.
Ejecución manual
./pandora_proxmox \
--host < host > \
--user < user > \
--password < password > \
[ --port < port > ] \
[ --vm < 1 or 0 > ] \
[ --lxc < 1 or 0 > ] \
[ --backups < 1 or 0 > ] \
[ --nodes < 1 or 0 > ] \
[ --transfer_mode < local o tentacle > ] \
[ --tentacle_port < tentacle_port > ] \
[ --tentacle_address < tentacle_address > ] \
[ -g < group > ] \
[ --data_dir < data dir > ] \
[ --as_discovery_plugin < 1 o 0 > ] \
[ --discard_node < nombre de nodo > ]
Ejecución normal
Ejecución modo discovery
Configuración en PandoraFMS
Como plugin de servidor
Instalación manual
Se debe ir a la opción a servidores > plugins:
Se debe pinchar en añadir:
Se le pone el nombre y la descripción que se prefiera.
Se debe meter como comando la ejecución con la ruta del plugin:
/path_pandora_proxmox
Recuerda que la ruta recomendada para el uso de los plugins de servidor es: /usr/share/pandora_server/util/plugin/
Y en parámetros del plugin introduciremos estos seguidos de la macro "_field<N>_", son obligatorios los parámetros de conexion, --host, --user y --password, por defecto el plugin tiene activada la extraccion de datos de lxc containers, VMs, de nodos y de backups, pueden desactivarse para una monitorización personalizada.
Una vez hecho esto, daremos a "crear".
Una vez hecho esto, solo queda llamarlo por lo que iremos a la vista de algún agente y crearemos un módulo de complementos:
Le daremos un nombre y en el apartado "plugin" pondremos el que acabamos de configurar.
Una vez hecho esto, damos a crear.
Si el modulo se muestra con 1, quiere decir que se esta ejecutando correctamente.
Módulos generados por el plugin
El plugin con todos los parámetros activados devolverá lo siguiente:
Un agente para cada nodo con los siguientes módulos:
maxdisk |
uptime |
status |
maxcpu |
disk |
mem |
maxmem |
cpu |
ssl_fingerprint
|
Un agente por cada maquina virtual y por cada lxc container del nodo con los siguientes módulos:
status |
netout |
diskread |
cpu |
disk |
mem |
netin |
uptime |
maxmem |
maxdisk |
diskwrite |
cpus |
Un agente para backups que tendrá un módulo por cada backup con los siguientes datos (información general):
Nombre: vmid, node_backup_info
Descripción: next_run,schedule,storage,backup_id,repeat-missed
valor: enabled or disabled
Y también dispone de otro módulo que mostrara, cuanto tiempo falta para el siguiente backup en segundos:
Nombre: vmid, node_backup_info
Descripción: Tiempo en segundos para la siguiente copia de seguridad
valor: segundos que faltan para el siguiente backup