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.

- 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
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
| Item | Requisito, licença ou versão |
|---|---|
| VM Zabbix Server | 1 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 Grafana | 1 vCPU, 1GB RAM, Debian 11 ou superior |
| Zabbix Server | GPLv2 · 6.0 LTS |
| Zabbix Agent | GPLv2 · 6.0 LTS |
| Grafana | AGPLv3 · a versão estável atual |
Roteiro
- 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.
- 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-serverO que você deve ver: Zabbix Server e frontend instalados sem erros.
- 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.
- 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 zabbixO que você deve ver: Importação completa sem erros.
- Configurar o Zabbix Server
Edite /etc/zabbix/zabbix_server.conf para apontar para o banco criado.
DBPassword=zabbixpassO que você deve ver: Arquivo salvo com senha correta.
- 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 apache2O que você deve ver: Serviços ativos e sem erros.
- Instalar Zabbix Agent no Linux AP
No host 192.168.56.20, instale o agente Zabbix.
sudo apt update sudo apt install zabbix-agentO que você deve ver: Agente instalado.
- 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.0O que você deve ver: Arquivo salvo corretamente.
- 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.confO que você deve ver: Arquivo wifi.conf criado com o UserParameter.
- Reiniciar o agente Zabbix
Reinicie o serviço para aplicar as configurações.
sudo systemctl restart zabbix-agentO que você deve ver: Agente ativo sem erros.
- 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.
- 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-serverO que você deve ver: Grafana rodando na porta 3000.
- 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
| Teste | Comando | Critério |
|---|---|---|
| Verificar coleta do sinal Wi-Fi no Zabbix | Item 'wifi.signal' mostra valores atualizados no frontend. | |
| Verificar logs do agente | sudo tail -f /var/log/zabbix/zabbix_agentd.log | Sem erros de UserParameter ou conexão. |
| Visualizar dashboard no Grafana | Painel mostra gráfico do sinal Wi-Fi. | |
| Testar query manual do UserParameter | zabbix_agentd -t wifi.signal | Retorno numérico esperado. |
| Ping entre as VMs | ping 192.168.56.10 | Resposta positiva de todas as VMs. |
Troubleshooting
| Sintoma | Causa provável | Correção |
|---|---|---|
| Item 'wifi.signal' não coleta dados | UserParameter mal configurado ou permissão insuficiente | Verifique sintaxe do UserParameter e permissões do agente. |
| Dashboard Grafana vazio | Datasource MySQL mal configurado ou query errada | Revise configurações do datasource e queries. |
| Erro de conexão do agente | Firewall bloqueando porta 10050 | Libere a porta 10050/tcp entre as VMs. |
| Frontend Zabbix não abre | Apache ou PHP não configurados corretamente | Consulte logs do Apache e revise configuração PHP. |
| UserParameter retorna vazio | Interface wlan0 não existe ou iwconfig não instalado | Confirme 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
- Zabbix Documentation 6.0: Installation on Debian · Zabbix LLC (zabbix.com)
- Zabbix Documentation 6.0: UserParameters · Zabbix LLC (zabbix.com)
- Grafana Documentation: MySQL Data Source · Grafana Labs (grafana.com)
- 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
