Como instalar Zabbix Agent 2 no Debian, Ubuntu e Proxmox VE, configurar Server e Hostname, liberar a porta 10050 e monitorar Docker e SMART.

Para que serve

O Zabbix é uma plataforma de monitoramento open source muito usada por provedores e MSPs. Para usá-la, você precisa instalar Zabbix Agent 2 (Zabbix Agent 2 é o agente de nova geração, escrito em Go) em cada servidor, VM ou host Proxmox. Ele coleta CPU, memória, disco, rede, serviços e, por plugins, também Docker, MySQL, PostgreSQL, Redis e SMART dos discos, e envia tudo para o seu Zabbix Server, que gera gráficos e alertas.

Este artigo mostra como instalar Zabbix Agent 2 e cadastrar o host. Ele presume que você já tem (ou vai criar) um Zabbix Server, por exemplo numa VM do seu Proxmox ou em outro local. Se você só quer saber se sites e portas estão no ar, o Uptime Kuma é mais simples (veja o artigo «Como instalar Uptime Kuma com Docker e monitorar sites, portas e serviços»).

Pré-requisitos

  • Zabbix Server funcionando e acessível (anote o IP dele e a versão: 7.0 LTS, 7.4 etc.).
  • Servidor monitorado com Debian 12/13, Ubuntu 22.04/24.04 ou Proxmox VE 8/9 (que é Debian 12/13).
  • Liberação de rede entre os dois: porta 10050/TCP do servidor para o agente (checagens passivas) e/ou 10051/TCP do agente para o servidor (checagens ativas).
Use no agente a mesma versão maior do seu Zabbix Server (ou anterior). Agente mais novo que o servidor pode ter itens que o servidor não entende. Os exemplos abaixo usam a 7.0 LTS; troque o número se o seu servidor for outra versão.

Passo a passo para instalar Zabbix Agent 2

  1. Adicione o repositório oficial do Zabbix. No Debian 12 ou Proxmox VE 8: 
    wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian12_all.deb
dpkg -i zabbix-release_latest_7.0+debian12_all.deb
apt update
    Para Debian 13 / Proxmox VE 9, use o arquivo ...+debian13_all.deb. Para Ubuntu 24.04, troque o caminho para /zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu24.04_all.deb. O site do Zabbix (página Download) gera os comandos exatos para cada combinação.
  2. Instale o agente e os plugins: 
    apt install -y zabbix-agent2 zabbix-agent2-plugin-*
    Se o antigo zabbix-agent estiver instalado, remova-o antes (apt remove zabbix-agent): os dois usam a porta 10050.
  3. Configure o agente. Edite /etc/zabbix/zabbix_agent2.conf e ajuste: 
    Server=IP_DO_ZABBIX_SERVER
ServerActive=IP_DO_ZABBIX_SERVER
Hostname=srv01-proxmox
    Server define quem pode consultar o agente (modo passivo). ServerActive define para onde o agente envia dados (modo ativo). Hostname deve ser idêntico ao nome do host cadastrado no Zabbix. Se o agente fica atrás de NAT e só o modo ativo é viável, você pode deixar apenas o ServerActive preenchido.
  4. Libere o firewall só para o Zabbix Server. Nunca deixe a 10050 aberta para a internet. Com UFW: 
    ufw allow from IP_DO_ZABBIX_SERVER to any port 10050 proto tcp
    No Proxmox, crie a regra equivalente no firewall do nó (Datacenter → Firewall ou Nó → Firewall).
    Ao mexer no firewall do host Proxmox, confirme que as regras de SSH (22) e da interface web (8006) continuam liberadas antes de ativá-lo. Se perder o acesso, entre pelo console iLO/IPMI e rode pve-firewall stop.
  5. Inicie e habilite o serviço: 
    systemctl enable --now zabbix-agent2
systemctl restart zabbix-agent2
  6. Cadastre o host no Zabbix. Em Data collection → Hosts → Create host: informe o mesmo Host name, um grupo, a interface Agent com o IP do servidor e porta 10050, e vincule o template Linux by Zabbix agent (ou Linux by Zabbix agent active, se usar só modo ativo).

Monitoramentos extras úteis

  • Proxmox VE: além do agente, use o template Proxmox VE by HTTP, que lê a API do Proxmox (status de VMs, containers, storages e cluster). Crie um usuário e um API token somente leitura (papel PVEAuditor) e preencha as macros do template com o token.
  • Docker: vincule o template Docker by Zabbix agent 2 e dê ao agente acesso ao socket: usermod -aG docker zabbix && systemctl restart zabbix-agent2. Lembre que acesso ao socket do Docker equivale a root.
  • SMART dos discos: o template SMART by Zabbix agent 2 usa o smartctl. Instale smartmontools e permita ao usuário zabbix rodá-lo via sudo, criando /etc/sudoers.d/zabbix com a linha zabbix ALL=(ALL) NOPASSWD: /usr/sbin/smartctl, e ajuste no conf do agente Plugins.Smart.Path=/usr/sbin/smartctl. Discos atrás de controladora RAID podem não ser detectados (veja o artigo «Como monitorar a saúde do disco e a temperatura do servidor (smartd, NVMe e IPMI)» e, para o RAID da controladora, «Como verificar o RAID da controladora HPE Smart Array (ssacli) no Linux e no Proxmox»).

Como saber se funcionou

  • No servidor monitorado: systemctl status zabbix-agent2 deve estar active (running) e zabbix_agent2 -t agent.ping deve retornar 1.
  • No Zabbix Server: zabbix_get -s IP_DO_AGENTE -k agent.version deve devolver a versão do agente.
  • No frontend, o ícone ZBX do host fica verde em alguns minutos e os dados aparecem em Monitoring → Latest data.

Problemas comuns

  • ZBX vermelho, "connection refused" ou timeout: firewall bloqueando a 10050, agente parado ou IP errado na interface do host.
  • "Received empty response ... connection rejected": o IP do Zabbix Server não está na linha Server=. Se o servidor passa por NAT, use o IP de saída dele.
  • Checagens ativas não chegam: Hostname do conf diferente do nome no frontend (diferencia maiúsculas) ou 10051 bloqueada no lado do servidor. Veja /var/log/zabbix/zabbix_agent2.log.
  • Plugin Docker com "permission denied": o usuário zabbix não está no grupo docker ou o serviço não foi reiniciado.
  • Alertas demais: ajuste os limites por macros no host (por exemplo, uso de disco) em vez de editar o template.

Perguntas frequentes

Qual a diferença entre Zabbix Agent e Zabbix Agent 2?

O Agent 2 é escrito em Go, tem plugins nativos (Docker, MySQL, PostgreSQL, Redis, SMART) e mantém conexões persistentes. O agente clássico, em C, continua suportado, mas para instalações novas o Agent 2 é o indicado.

Quais portas o Zabbix Agent 2 usa?

A 10050/TCP recebe as consultas do servidor (modo passivo) e a 10051/TCP no Zabbix Server recebe os dados enviados pelo agente (modo ativo). Libere-as só entre os dois, nunca para a internet.

Posso usar um agente de versão diferente do Zabbix Server?

Use a mesma versão maior do servidor ou uma anterior. Agente mais novo que o servidor pode enviar itens que o servidor não reconhece.

Como monitorar as VMs do Proxmox sem instalar agente em cada uma?

Use o template Proxmox VE by HTTP com um API token somente leitura. Ele mostra estado, CPU e memória das VMs e containers; para métricas internas de cada sistema, instale o agente na VM. Antes de liberar a porta no host, veja também o artigo «Firewall do Proxmox VE: como ativar sem perder o acesso».

Leitura complementar

Precisa de ajuda? Abra um ticket ou fale com o suporte pelo WhatsApp. Sem o serviço de Gerenciamento contratado, a instalação e a operação do Zabbix são de responsabilidade do cliente.

Esta resposta lhe foi útil? 0 Usuários acharam útil (0 Votos)

Leia também