VMware vSphere

Un vCenter Server y los hosts que gestiona, o un host ESXi independiente: hosts que dejan de responder, se quedan en modo mantenimiento o reportan un estado de salud rojo, máquinas virtuales y sus VMware Tools, datastores que se llenan o se vuelven inaccesibles, y las alarmas que el propio vSphere lanzó.

DumbMonit lee vSphere con un usuario dedicado que tiene el rol integrado Read-only. Nunca enciende ni apaga una VM, nunca entra en modo mantenimiento y nunca confirma una alarma.

El fallo que vale la pena vigilar: un datastore que se llena. Cuando un datastore thin provisioned alcanza el 100 %, toda VM que necesita escribir en él se pausa de golpe. Las alarmas que lanza vCenter también lo indican, pero solo a quien tenga el cliente abierto.

Por qué la Web Services API

DumbMonit habla con la vSphere Web Services API (SOAP, /sdk), no con la API REST (/api/vcenter/*): un host ESXi independiente no tiene API REST, y en un vCenter la API REST no indica el modo mantenimiento, la salud general (overallStatus), el estado de las VMware Tools ni las alarmas activadas. Se lee una vista de todo el inventario en una sola pasada, página por página, y se libera al final.

La sesión se conserva de una sonda a la siguiente y se vuelve a abrir solo cuando caduca: vCenter no registra un nuevo inicio de sesión cada minuto.

Qué vigila

Todas las métricas tienen el prefijo dumbmonit_vsphere_. Los valores de salud siguen el overallStatus de vSphere: 0 verde, 1 amarillo, 2 rojo, 3 gris (desconocido).

Métrica	Qué	Etiquetas
`info`	valor 1	`product` (`vcenter` o `esxi`), `version`, `build`
`hosts`	hosts por estado de conexión: `connected`, `disconnected`, `notResponding`	`state`
`host_connection_state`	0 conectado, 1 desconectado por un administrador, 2 sin respuesta	`esxi`
`host_power_state`	0 encendido, 1 en espera, 2 apagado, 3 desconocido	`esxi`
`host_maintenance`	1 en modo mantenimiento	`esxi`
`host_status`	salud general	`esxi`
`host_cpu_percent`, `host_memory_percent`, `host_memory_bytes`, `host_uptime_seconds`	solo hosts conectados	`esxi`
`vms`	VMs por estado de encendido: `poweredOn`, `poweredOff`, `suspended` (plantillas excluidas)	`state`
`templates`	plantillas de VM
`vm_power_state`	0 encendida, 1 apagada, 2 suspendida; como máximo 1000 VMs	`vm`
`vm_status`	salud general	`vm`
`vm_tools_status`	solo VMs encendidas: 0 actualizadas, 1 versión antigua, 2 instaladas pero no en ejecución, 3 no instaladas	`vm`
`datastores`	datastores
`datastore_capacity_bytes`, `datastore_free_bytes`, `datastore_used_percent`		`datastore`
`datastore_accessible`	1 accesible, 0 inaccesible	`datastore`
`datastore_status`	salud general	`datastore`
`alarms`	alarmas activadas no confirmadas, por color: `red`, `yellow`	`status`
`alarms_acknowledged`	alarmas activadas ya confirmadas
`alarm`	una serie por alarma no confirmada, valor = su código de salud, como máximo 64	`alarm` (su nombre), `entity`, `entity_type`, `status`
`scrape_errors`	llamadas que fallaron en la última sonda

Las reglas integradas que se aplican: vSphere host not responding, vSphere host health red, vSphere host left in maintenance, vSphere datastore almost full, vSphere datastore inaccessible, vSphere VM tools not running, vSphere red alarm, además de Monitor unreachable.

La página del monitor

El panel sobre las gráficas lee lo que guardó la sonda; abrir la página nunca consulta vSphere. Indica primero qué va mal (hosts sin respuesta, alarmas rojas, datastores casi llenos o inaccesibles), luego los hosts con su carga, los datastores con su nivel de llenado, y las VMs por estado de encendido.

Cómo se validó

Contra el simulador govmomi vcsim 0.56.0, en modo vCenter y en modo ESXi: inicio de sesión y contraseña rechazada, reutilización y caducidad de sesión, paginación por el inventario, un host sin respuesta, un host en modo mantenimiento, una VM apagada y una plantilla. El simulador no lanza ninguna alarma: la lectura de las alarmas activadas se validó contra la estructura AlarmState documentada de la Web Services API.

Crear un usuario de solo lectura en vSphere

En un vCenter: Administration → Single Sign On → Users and Groups → Users, dominio vsphere.local → Add. Nombra el usuario como sigue y dale una contraseña larga y aleatoria.
```
dumbmonit
```
Todavía en el vCenter: Administration → Access Control → Global Permissions → Add. Elige ese usuario, el rol Read-only, y marca Propagate to children. Read-only ve cada host, VM, datastore y alarma, y no puede cambiar nada.
En un host ESXi independiente en su lugar: en el host client, Manage → Security & users → Users → Add user, con el mismo nombre. Luego Host → Actions → Permissions → Add user: elígelo, el rol Read-only, y marca Propagate to all children.
En DumbMonit, introduce la dirección del vCenter o del host, por ejemplo «vcenter.lan» o «esxi1.lan», con el nombre de usuario tal como se creó: [email protected] en un vCenter, dumbmonit en un host. Cuando un vCenter gestiona los hosts, añade solo el vCenter: reporta cada host, VM y datastore.
DumbMonit solo lee, a través de la vSphere Web Services API (/sdk). Nunca enciende ni apaga una VM, nunca entra en modo mantenimiento y nunca confirma una alarma.

Credenciales

Credencial	Campos
Nombre de usuario / contraseña	El usuario dedicado con el rol Read-only: `[email protected]` en un vCenter, `dumbmonit` en un host.

Dirección: un nombre de host o IP (vcenter.lan), host:puerto, o una URL completa; se acepta un /sdk o /ui final. Opciones: puerto (443), comprobación de certificado, tiempo de espera de la petición (20 s) y alarmas activadas (lectura).