Entrar ou criar conta

ULC Lab · implementação reproduzível

Laboratório: Monitoramento Wi-Fi com Zabbix, host Linux e dashboard Grafana

Você terá um ambiente de monitoramento Wi-Fi funcional usando Zabbix Server, um agente em um Linux simulando um AP e um dashboard Grafana integrado. O laboratório leva cerca de 2 horas.

Monitoramento Wi-Fi do zero à automação com Zabbix
Ligado ao treinamento Monitoramento Wi-Fi do zero à automação com Zabbix
ULC-LAB-WIFI-0002 · Status de validaçãoNão validado pela Upnetix: roteiro derivado da documentação oficial, para você executar e validar
Duração estimada
120 min
Passos
13
Validações
5
Versões da documentação consultada
Zabbix Server 6.0 LTS · Zabbix Agent 6.0 LTS · Grafana a versão estável atual
Objetivo

Este laboratório ensina como implantar o Zabbix Server em uma VM, instalar o agente Zabbix em um host Linux para monitorar interfaces Wi-Fi, coletar métricas relevantes e visualizar os dados em um dashboard Grafana. O foco é mostrar, na prática, como monitorar redes Wi-Fi de forma automatizada e personalizável, usando apenas software livre.

Topologia

Uma VM com Zabbix Server (192.168.56.10), uma VM Linux (192.168.56.20) simulando um AP Wi-Fi com interface wlan0, e uma VM ou host com Grafana (192.168.56.30). O Zabbix Server coleta dados do agente Zabbix na VM Linux e Grafana acessa o banco do Zabbix para exibir dashboards.

        +----------------+
        |  Grafana VM   |
        |192.168.56.30  |
        +-------+--------+
                |
                |
        +-------v--------+
        | Zabbix Server  |
        |192.168.56.10   |
        +-------+--------+
                |
                |
        +-------v--------+
        | Linux AP (wlan0)|
        |192.168.56.20   |
        +----------------+

Equipamentos e software

ItemRequisito, licença ou versão
VM Zabbix Server1 vCPU, 2GB RAM, 10GB disco, Debian 11 ou superior
VM Linux (simulando AP)1 vCPU, 1GB RAM, interface Wi-Fi ou adaptador USB, Debian 11 ou superior
VM Grafana1 vCPU, 1GB RAM, Debian 11 ou superior
Zabbix ServerGPLv2 · 6.0 LTS
Zabbix AgentGPLv2 · 6.0 LTS
GrafanaAGPLv3 · a versão estável atual

Roteiro

  1. Preparar as VMs

    Crie três VMs Debian 11+ em rede NAT ou host-only, com IPs fixos: 192.168.56.10 (Zabbix Server), 192.168.56.20 (Linux AP), 192.168.56.30 (Grafana).

    O que você deve ver: Todas as VMs pingam entre si.

  2. Instalar o Zabbix Server

    No Zabbix Server, instale o Zabbix Server, frontend e banco de dados conforme documentação oficial.

    sudo apt update
    sudo apt install zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-sql-scripts mysql-server

    O que você deve ver: Zabbix Server e frontend instalados sem erros.

  3. Configurar o banco de dados do Zabbix

    Crie o banco e usuário para o Zabbix.

    sudo mysql
    CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
    CREATE USER 'zabbix'@'localhost' IDENTIFIED BY 'zabbixpass';
    GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';
    FLUSH PRIVILEGES;
    EXIT;

    O que você deve ver: Banco de dados e usuário criados.

  4. Importar o schema do Zabbix

    Importe o schema inicial para o banco.

    zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz | mysql -uzabbix -pzabbixpass zabbix

    O que você deve ver: Importação completa sem erros.

  5. Configurar o Zabbix Server

    Edite /etc/zabbix/zabbix_server.conf para apontar para o banco criado.

    DBPassword=zabbixpass

    O que você deve ver: Arquivo salvo com senha correta.

  6. Iniciar Zabbix Server e frontend

    Habilite e inicie os serviços.

    sudo systemctl restart zabbix-server zabbix-agent apache2
    sudo systemctl enable zabbix-server zabbix-agent apache2

    O que você deve ver: Serviços ativos e sem erros.

  7. Instalar Zabbix Agent no Linux AP

    No host 192.168.56.20, instale o agente Zabbix.

    sudo apt update
    sudo apt install zabbix-agent

    O que você deve ver: Agente instalado.

  8. Configurar o Zabbix Agent

    Edite /etc/zabbix/zabbix_agentd.conf para apontar o Server=192.168.56.10 e ListenIP=0.0.0.0.

    Server=192.168.56.10
    ListenIP=0.0.0.0

    O que você deve ver: Arquivo salvo corretamente.

  9. Habilitar coleta de métricas Wi-Fi

    Adicione um UserParameter para coletar status da interface wlan0.

    echo 'UserParameter=wifi.signal,iwconfig wlan0 | grep -i --color=never signal | awk "{print \$4}" | cut -d"=" -f2' | sudo tee -a /etc/zabbix/zabbix_agentd.d/wifi.conf

    O que você deve ver: Arquivo wifi.conf criado com o UserParameter.

  10. Reiniciar o agente Zabbix

    Reinicie o serviço para aplicar as configurações.

    sudo systemctl restart zabbix-agent

    O que você deve ver: Agente ativo sem erros.

  11. Adicionar host no Zabbix Server

    No frontend web do Zabbix, adicione o host 192.168.56.20, template Linux e um item personalizado para 'wifi.signal'.

    O que você deve ver: Host criado e item personalizado salvo.

  12. Instalar e configurar Grafana

    No host 192.168.56.30, instale Grafana e configure o datasource MySQL apontando para o banco do Zabbix.

    sudo apt install -y apt-transport-https
    sudo apt-get install -y software-properties-common wget
    wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -
    echo "deb https://packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
    sudo apt update
    sudo apt install grafana
    sudo systemctl start grafana-server
    sudo systemctl enable grafana-server

    O que você deve ver: Grafana rodando na porta 3000.

  13. Criar dashboard Wi-Fi no Grafana

    No Grafana, crie um dashboard com painel para o item 'wifi.signal' do host monitorado.

    O que você deve ver: Dashboard exibindo gráfico do sinal Wi-Fi.

Como saber que funcionou

TesteComandoCritério
Verificar coleta do sinal Wi-Fi no ZabbixItem 'wifi.signal' mostra valores atualizados no frontend.
Verificar logs do agentesudo tail -f /var/log/zabbix/zabbix_agentd.logSem erros de UserParameter ou conexão.
Visualizar dashboard no GrafanaPainel mostra gráfico do sinal Wi-Fi.
Testar query manual do UserParameterzabbix_agentd -t wifi.signalRetorno numérico esperado.
Ping entre as VMsping 192.168.56.10Resposta positiva de todas as VMs.

Troubleshooting

SintomaCausa provávelCorreção
Item 'wifi.signal' não coleta dadosUserParameter mal configurado ou permissão insuficienteVerifique sintaxe do UserParameter e permissões do agente.
Dashboard Grafana vazioDatasource MySQL mal configurado ou query erradaRevise configurações do datasource e queries.
Erro de conexão do agenteFirewall bloqueando porta 10050Libere a porta 10050/tcp entre as VMs.
Frontend Zabbix não abreApache ou PHP não configurados corretamenteConsulte logs do Apache e revise configuração PHP.
UserParameter retorna vazioInterface wlan0 não existe ou iwconfig não instaladoConfirme existência da interface e instale wireless-tools.

Segurança e hardening

  • Altere as senhas padrão do banco de dados e do frontend Zabbix.
  • Restrinja o acesso ao frontend e ao Grafana à sua rede de laboratório.
  • Desabilite UserParameters não utilizados.
  • Mantenha o sistema operacional e os pacotes atualizados.

Checklist final

Referências

  1. Zabbix Documentation 6.0: Installation on Debian · Zabbix LLC (zabbix.com)
  2. Zabbix Documentation 6.0: UserParameters · Zabbix LLC (zabbix.com)
  3. Grafana Documentation: MySQL Data Source · Grafana Labs (grafana.com)
Verificação editorial
Publicado
09/09/2026
Última revisão
09/09/2026
Versão do conteúdo
1.0
Referências
3 oficiais
Revisão técnica
redação e revisão por IA, URLs conferidas na publicação
Status
Atual
Encontrou um erro? Escreva para comercial@upnetix.com.br com o endereço da página. A revisão semestral por IA nunca altera comandos ou configurações sem passar pela fila de revisão.