Proxmox Monitor Agent for Home Assistant

Custom integration do Home Assistant para consumir snapshots do Proxmox Monitor Agent e transformar os dados do host em devices e entidades dentro do HA.

O problema

O Proxmox Monitor Agent resolve a coleta no host, mas o valor real aparece quando esses dados entram no Home Assistant. E la que eu ja tenho historico, dashboards, notificacoes e automacoes.

Sem uma integracao nativa, eu teria que improvisar sensores REST manualmente, repetir templates e manter nomes de entidades na mao. Isso funciona para meia duzia de sensores, mas fica fragil quando entram VMs, LXCs, storage, discos, interfaces e sensores dinamicos.

A solucao

A integracao consulta o endpoint HTTP do agent, valida o schema pma.metrics versao 1 e cria entidades de forma deterministica.

Cada entrada de configuracao representa um host Proxmox. Para mais de um host, basta adicionar outra entrada.

Entidades criadas

Device principal para o host Proxmox.
Devices separados para VMs e containers LXC.
Sensores de status de coleta, duracao da coleta, CPU, load average, memoria, swap e uptime.
Sensores de temperaturas do host.
Sensores de rede, filesystems e storage.
Sensores de status, CPU, memoria e uptime para VMs e LXCs.

Configuracao

A config flow pede:

Host.
Porta, por padrao 9782.
Path, por padrao /metrics.json.
Scan interval.

O polling e local e usa DataUpdateCoordinator, seguindo o modelo recomendado para integracoes Home Assistant.

Instalacao

A integracao pode ser instalada via HACS como custom repository ou copiando custom_components/proxmox_monitor_agent para o diretorio custom_components do Home Assistant.

Depois da instalacao, reinicie o Home Assistant e adicione a integracao pela tela de dispositivos e servicos.