Inventário e Diagnóstico UniFi: Auditoria Automatizada de Site
UNIFI
O Desafio
Gerenciar um grande ambiente UniFi muitas vezes envolve clicar em vários sites na interface do Controlador para obter uma contagem simples de dispositivos ou verificar o status da WAN. Para Provedores de Serviços Gerenciados (MSPs) ou grandes empresas, agregar esses dados manualmente para relatórios é tedioso e propenso a erros.
O objetivo era recuperar instantaneamente um inventário de alto nível para:
- Listar todos os sites e seus IDs exclusivos
- Contar clientes conectados (Sem fio vs. Com fio)
- Verificar a saúde dos uplinks WAN
- Apresentar dados em um formato administrativo limpo
O Prompt Enviado ao Myrmex
Usando a integração Myrmex para UniFi, enviamos:
Conecte-se ao Controlador UniFi e recupere uma lista completa de todos os sites configurados.
Para cada site, exiba o nome do site, seu ID exclusivo e o número atual de dispositivos conectados.
Apresente os dados em uma lista clara ou formato de tabela para revisão administrativa
sem fazer nenhuma alteração de configuração.
Nota: O Myrmex abstrai a complexidade da API UniFi, lidando com autenticação e parsing de JSON para entregar insights legíveis por humanos.
O Que o Myrmex Fez
O Myrmex conectou-se ao Controlador UniFi e recuperou os dados de inventário.
✅ Relatório de Inventário de Site UniFi
A tabela a seguir fornece a visão geral administrativa dos sites configurados e suas métricas de conexão atuais:
| Nome do Site | Site ID | Clientes Conectados (Total) | Dispositivos de Infraestrutura |
|---|---|---|---|
| Padrão (Site 1) | 67e5b22607d16a1beddf0193 | 550 | 95 |
| Padrão (Site 2) | 67f815a6c586ec1e33bd0cac | 440 | 83 |
Resumo Técnico e Observações
Com base nos metadados recuperados durante a execução, aqui está um detalhamento da distribuição de clientes e saúde do site:
Site 1 (67e5b226...)
- Clientes Sem Fio: 547
- Clientes Com Fio: 3
- Status de Saúde: ⚠️ WAN1 está inativa (0% uptime). O tráfego está sendo redirecionado e sustentado com sucesso pelo link WAN2 (98.18% uptime), indicando que o failover está funcionando.
Site 2 (67f815a6...)
- Clientes Sem Fio: 439
- Clientes Com Fio: 1
- Status de Saúde: ✅ A conectividade primária está estável via WAN1 (98.81% uptime).
Benefícios da Abordagem
🦅 Visão Panorâmica
Em vez de logar em cada site individualmente, administradores obtêm uma visão consolidada de todo o parque de rede em segundos.
🚨 Verificação de Failover
A auditoria destacou instantaneamente que o Site 1 está rodando na internet de backup (WAN2). Sem essa verificação automatizada, a TI poderia não notar a falha do link primário até que o backup também falhasse.
🛡️ Segurança Não Intrusiva
A operação é estritamente somente leitura. Usa chamadas de API (list_sites, get_health) que não modificam regras de firewall ou configurações de dispositivo.
Resultado
Com a análise do Myrmex:
- ✅ Inventário Automatizado: Contagens precisas de clientes e dispositivos recuperadas para faturamento/planejamento de capacidade.
- ✅ Resiliência Testada: Confirmado que o failover SD-WAN no Site 1 está ativo.
- ✅ Tempo Economizado: Eliminada a necessidade de login manual e agregação manual de dados.
Variações do Prompt
O mesmo padrão pode ser usado para gerenciamento UniFi mais profundo:
Para auditoria de firmware de dispositivo:
Liste todos os Access Points no 'Site 1' que estão rodando firmware mais antigo
que a versão 6.5.54.
Para gerenciamento de Wi-Fi de convidados:
Gere um novo código de voucher Wi-Fi para a rede 'Convidado' válido por
24 horas e exiba-o aqui.