Integraciones

Proxmox VE

Cree un token de API limitado y supervise un nodo, una VM o un LXC.

NasDash llama a la API HTTPS de Proxmox en el puerto 8006. Construye la cabecera de autorización a partir del Token ID y la Secret del Token ingresados por separado.

Crear el token

Un usuario dedicado de solo lectura y su propio token, con la separación de privilegios (Privilege Separation) activada. El token solo tiene entonces los permisos que se le dan, nunca más que su usuario. En Proxmox VE, en Datacenter → Permissions:

  1. Users → Add: un usuario como nasdash en el dominio pve (no hace falta contraseña para la API).
  2. Add → User Permission: ruta /, ese usuario, rol PVEAuditor, Propagate activado.
  3. API Tokens → Add: ese usuario, Token ID monitoring, Privilege Separation marcada. Copie el secreto enseguida: solo se muestra una vez.
  4. Add → API Token Permission: ruta /, el token nasdash@pve!monitoring, rol PVEAuditor, Propagate activado.

PVEAuditor es de solo lectura e incluye Sys.Audit, VM.Audit y Datastore.Audit. Para limitar el alcance, dé ambos permisos en /nodes/<node> y en los /vms/<vmid> que se vigilan en lugar de /. Lo mismo desde la consola de un nodo:

pveum user add nasdash@pve
pveum acl modify / --users nasdash@pve --roles PVEAuditor
pveum user token add nasdash@pve monitoring --privsep 1
pveum acl modify / --tokens 'nasdash@pve!monitoring' --roles PVEAuditor

El paso 4 es el que más se olvida: un token con separación de privilegios y sin permiso propio no lee nada, aunque su usuario pueda (la API responde entonces 403). Desmarcar Privilege Separation también funciona, pero el token tiene entonces todos los derechos de su usuario; es preferible el permiso del token. Los tokens se describen en la guía de administración de Proxmox VE.

Campos de NasDash

En Ajustes → Integraciones, introduzca el host, por ejemplo pve.example.com, sin protocolo, puerto ni ruta de API. Introduzca 8006 por separado en Puerto, el identificador completo como nasdash@pve!monitoring en Token ID y el secreto en Token Secret. NasDash añade HTTPS y la ruta de API. Añada después una máquina y seleccione conexión, nombre exacto del nodo y, si procede, ID VM/LXC y tipo qemu o lxc.

El almacenamiento del nodo se lee si el token permite. 401/403 indican credenciales o permisos; timeout/rechazo se reintentan. Para certificado autofirmado local, active Aceptar certificados autofirmados en esa conexión. En otro caso se valida TLS normalmente. No desactive globalmente.

La detección funciona pero la máquina aparece desconectada

Probar y listar máquinas comprueba la detección, no el acceso a las métricas de cada máquina. Proxmox puede devolver un nodo online desde /nodes y rechazar /nodes/<node>/status con 403. En el editor del dispositivo, elija la máquina y use Probar métricas para leer las mismas métricas que el widget.

Compruebe los permisos efectivos en Proxmox, en Datacenter → Permissions:

  • CPU, RAM y tiempo de actividad del nodo: Sys.Audit en /nodes/<node>.
  • Métricas de una VM o LXC: VM.Audit en /vms/<vmid>.
  • Estadísticas de almacenamiento opcionales: Datastore.Audit en cada /storage/<storage-id> necesario. Un rechazo del almacenamiento no impide cargar CPU, RAM o tiempo de actividad.

Con Privilege Separation activada, asigne los permisos de solo lectura necesarios tanto al usuario (o su grupo) como al token API en las rutas adecuadas. El acceso efectivo del token es la intersección de estos permisos. Mantenga la separación de privilegios; no se necesitan permisos de administración o escritura. Crear otro token no concede los permisos que faltan.

401 indica un problema de autenticación; 403 significa que la API denegó el acceso al recurso solicitado y puede ocurrir sin un inicio de sesión fallido en el registro. Vuelva a probar el nodo o la VM/LXC elegido tras cambiar sus permisos. NasDash reintenta la supervisión automáticamente. Un 403 por sí solo no demuestra incompatibilidad con una versión de Proxmox.

La API estándar de estado Proxmox proporciona CPU, RAM, almacenamiento y tiempo de actividad cuando están disponibles. No proporciona temperaturas CPU/GPU ni uso de GPU a esta integración; use una fuente de sensores compatible, como Glances, para esas métricas.