Network Topology 5.6.0 — lendo os switches com mais precisão: LLDP tipado, IP de gerência e alerta de orçamento PoE

O módulo principal e todos os oito widgets de dashboard rodam no Zabbix 7.0 LTS, 7.4 e 8.0. Baixe: github.com/linuser/zabbix-network-topology/releases

O post da 5.5.27 parou no localizador MAC e na mudança para o Zabbix 8. Bastante coisa chegou desde então — anéis, spanning-tree, PoE por porta, a visão VLAN, fundos aéreos e de planta baixa, um widget de WLAN — e com a 5.6.0, três coisas que deixam o dia a dia perceptivelmente mais calmo. A lista completa está no changelog; aqui vão os destaques.

Presente desde a 5.5.27: a visão Plan posiciona os dispositivos numa planta baixa ou imagem aérea (aqui uma planta demo sintética) — o status fica onde o dispositivo está fisicamente.

↶ Um movimento a mais? Desfaça

Você arruma o mapa à mão — arrasta nós, agrupa, até ficar legível. E aí um deslize arrasta o nó errado e lá se foi o arranjo limpo.

Agora não mais: Ctrl/Cmd+Z desfaz a última alteração de layout, Ctrl/Cmd+Shift+Z (ou Ctrl+Y) refaz. Dois botões na barra de ferramentas (↶ / ↷) fazem o mesmo e ficam cinza quando não há o que desfazer. Aplicar um layout também é reversível — escolheu outro layout e se arrependeu? Um desfazer traz de volta o seu arranjo feito à mão.

O histórico sobrevive a um refresh em segundo plano e só é zerado quando você realmente troca de visão (um conjunto diferente de nós). Baseado em snapshots, até 60 passos, robusto a nós que aparecem ou somem entre os passos.

Mova um nó, ↶ acende — um Ctrl+Z e ele volta, com ↷ pronto.

O LLDP para de adivinhar

Duas fontes de vizinhos errados foram embora.

O chassis-id agora é tipado. Um vizinho reporta seu identificador com um subtype — MAC, endereço de rede, nome de interface, ou simplesmente uma string local. Antes o módulo forçava todo identificador a virar um MAC e casava por ele; um identificador que na verdade era um IP ou um nome virava um MAC inventado e acertava o host errado. O template agora coleta lldpRemChassisIdSubtype, e o módulo trata cada identificador como aquilo que ele é — menos arestas erradas.

O IP de gerência do vizinho é lido. Via lldpRemManAddr o módulo agora conhece o endereço que um vizinho anuncia. Daí saem duas coisas:

• Um vizinho não resolvido cujo IP de gerência anunciado pertence a um host monitorado é ligado a ele mesmo assim — mesmo quando nome e MAC nunca casaram.
• Um vizinho não monitorado (um fantasma) mostra seu IP no painel de detalhes, e “criar host” preenche uma interface SNMP nele. “tem algo ali pendurado” vira um host que você coloca em monitoramento em dois cliques.

Um vizinho não monitorado anuncia seu IP de gerência — o painel o mostra, “criar host” o leva como interface SNMP.

O orçamento PoE finalmente fala

A faceplate de um switch mostrava seu orçamento PoE como um número silencioso — 78 / 95 W, na mesma cor apagada sob qualquer carga. Você via o valor, mas não que estava apertando.

Agora mostra a porcentagem, fica âmbar a partir de 80 % e vermelho + ⚠ a partir de 95 %, e desenha uma pequena sparkline das últimas seis horas ao lado — um orçamento PoE que há vinte minutos estava em 60 % e agora raspa os 94 % se vê num relance, não só quando o próximo access point não sobe.

A faceplate mostra as portas alimentadas por PoE (raio) e o orçamento do switch — aqui 61 e 70 de 95 W. A partir de 80 % fica âmbar, a partir de 95 % vermelho, com a tendência de seis horas ao lado.

Correções que você percebe

• Mapas grandes renderizam de novo. Camadas largas de hierarquia e de hops eram dispostas em uma única fileira enorme, o mapa dava zoom até sub-pixels e parecia vazio. As camadas agora quebram, e mapas com 1000+ hosts são visíveis.
• O CDP não inventa mais arestas a partir de hex opaco. Um id CDP de cinco bytes como 01 02 03 04 05 era truncado para 01 e casava com um host alheio — uma aresta falsa, e vários desses ids colapsavam em um fantasma fantasma. Corrigido. (Encontrado no fork Liberamente por Mauro Majeroni.)
• Layouts host+hops compartilhados são mantidos. O arranjo compartilhado de um super-admin salvo no modo de foco host+hops era descartado em silêncio no carregamento; agora sobrevive.

🔒 Reforço de segurança

Uma revisão externa de código/segurança (F01–F13) foi trabalhada — cada achado primeiro reproduzido, depois corrigido, cada correção com um teste que falha sem ela. Entre elas: criar um host agora exige também o direito de configuração de Hosts; o enviador de mudanças de topologia verifica TLS e mantém a senha e a resposta fora dos argumentos de processo; o deploy.sh é seguro para rollback; escritas de config compartilhada falham fechado em vez de sobrescrever uma mudança concorrente com uma cópia desatualizada; imagens de fundo de planta baixa devem ser HTTPS.

⬆️ Notas de upgrade

• Reimporte o template NT LLDP Neighbors by SNMP (Data collection → Templates → Import, Update existing) para que os itens de chassis-id tipado e IP de gerência cheguem. Nada muda para dispositivos que não enviam nenhum dos dois.
• Fundos de planta definidos por URL devem ser https:// agora — URLs http:// são rejeitadas. Fundos do image store do Zabbix não são afetados.

Baixe

A 5.6.0 é a atual, e a primeira versão pública desde a 5.5.27 — ela reúne tudo que veio no meio, versão por versão no changelog. Atualizar dentro da 5.5/5.6 significa “trocar a pasta, recarregar uma vez” — layouts, links, pins e notas ficam onde estão. Só os novos dados de LLDP precisam do template reimportado uma vez. Releases & instalação →