KVM

Escrito por Hitfy

 Monitoramento KVM Manager via Zabbix

Template: Template_KVM_Manager_Padrao


Descrição

Este template é responsável pelo monitoramento do ambiente KVM Manager (oVirt/RHV) utilizando integração via API REST. As coletas são realizadas por meio de requisições HTTP autenticadas diretamente no endpoint do engine, permitindo obter informações sobre disponibilidade do manager, inventário de máquinas virtuais, utilização de recursos (CPU, memória e storage), além do estado dos hosts e datastores.

A comunicação ocorre via HTTPS (porta 443), utilizando autenticação Basic Auth.


Padrão de nomenclatura de Host

Para padronização do ambiente, os hosts que utilizam este template devem seguir o formato:

OLVM_xxxxxxxxx

Onde:

  • OLVM: Identifica o ambiente Oracle Linux Virtualization Manager (KVM/oVirt)
  • xxxxxxxxx: Deve representar o nome do ambiente, cliente ou identificador único do Manager

Exemplos:

  • OLVM_PRODUCAO
  • OLVM_HOMOLOGACAO
  • OLVM_CLIENTE_A
  • OLVM_kvm-manager


URL da API

A URL utilizada para acesso à API segue o padrão abaixo:

https://{$IT_DNS_KVM}/ovirt-engine/api/


Pré-requisitos

Antes de aplicar o template, é necessário garantir:

  • Acesso de rede entre o Zabbix Server/Proxy e o KVM Manager
  • API REST do oVirt/RHV habilitada e acessível
  • Porta 443/TCP liberada
  • Usuário com permissão de leitura no ambiente
  • Suporte a requisições HTTP (libcurl) no Zabbix Server ou Proxy
  • Resolução DNS funcional para o endereço configurado


Macros obrigatórias

{$IT_URL_KVM}

URL base do KVM Manager

Exemplo: https://seu-kvm.vss.com.br


{$IT_DNS_KVM}

Hostname ou DNS do KVM Manager

Exemplo: seu-kvm.vss.com.br


{$IT_USUARIO_KVM}

Usuário utilizado para autenticação na API

Exemplo: admin@internal


{$IT_SENHA_KVM}

Senha do usuário configurado


Autenticação

O acesso à API é realizado via Basic Auth, informando usuário e senha nas requisições HTTP.


Teste de conectividade com a API

Para validar o acesso à API, execute o comando abaixo a partir do Zabbix Proxy:

curl -k -u admin@internal:suasenha \
-H "Accept: application/json" \
https://seu-kvm.vss.com.br/ovirt-engine/api/


Resultado esperado

A requisição deve retornar dados da API em formato JSON ou XML, com código HTTP 200, indicando sucesso na autenticação e comunicação com o KVM Manager.


Possíveis problemas

Timeout

Geralmente relacionado a falha de conectividade ou bloqueio de firewall

401 Unauthorized

Usuário ou senha incorretos

403 Forbidden

Usuário sem permissão suficiente na API

Erro de SSL

Certificado inválido ou não confiável (pode ser contornado com uso de -k para testes)

Observação


Este template depende diretamente da disponibilidade da API do KVM Manager. Caso o endpoint esteja indisponível, todas as coletas relacionadas serão impactadas.