CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Librenms · Automação

Auto-Discovery

Auto-discovery reduz cadastro manual, mas precisa de fronteiras. Descobrir tudo sem governança pode importar equipamentos indevidos.

librenms://Automação
$ platform: Librenms
$ topic: Auto-Discovery
$ mode: production
$ method: evidence-first_
Escopo técnico

Auto-Discovery

Auto-discovery reduz cadastro manual, mas precisa de fronteiras. Descobrir tudo sem governança pode importar equipamentos indevidos.

01 · Automação

Ponto técnico 1

Objetivo: Auto-discovery reduz cadastro manual, mas precisa de fronteiras. Descobrir tudo sem governança pode importar equipamentos indevidos.

02 · Automação

Ponto técnico 2

Métodos: LibreNMS pode usar protocolos e relacionamentos de rede, além de SNMP scan conforme configuração, para encontrar vizinhos.

03 · Automação

Ponto técnico 3

LLDP/CDP e vizinhança: Descoberta por vizinhos depende de informação correta nos dispositivos e alcance SNMP do novo nó.

04 · Automação

Ponto técnico 4

Faixas permitidas: Defina redes/regex permitidas e excluídas. Não use auto-discovery para atravessar redes que não pertencem ao domínio de monitoramento.

05 · Automação

Ponto técnico 5

Credenciais: O novo dispositivo precisa responder com credencial SNMP conhecida. Segredo compartilhado global facilita descoberta, mas aumenta blast radius.

06 · Automação

Ponto técnico 6

Duplicidade: DNS, IP e sysName inconsistentes podem gerar cadastros duplicados ou impedir descoberta.

07 · Automação

Ponto técnico 7

Operação: Revise periodicamente dispositivos adicionados automaticamente e atribua owner/grupos/alertas.

Aplicação em produção

Procedimento de engenharia

Escopo e impacto

Defina serviço, owner, estado esperado e impacto antes de alterar o monitoramento.

Evidência primeiro

Valide fonte, caminho, credenciais, baseline e timestamps antes de alterar thresholds.

Mudança controlada

Altere uma variável por vez e mantenha um caminho de rollback.

Manutenção

Rotina operacional recomendada

  • Revise estados críticos, lacunas de coleta e falhas de entrega a cada turno.
  • Revise alertas ruidosos, objetos lentos, credenciais e erros recorrentes semanalmente.
  • Revise versões, backup/restore, permissões e capacidade periodicamente.
Troubleshooting por evidências

Sintoma → escopo → camada → evidência → hipótese → validação

Capture logs, timestamps, saídas e topologia antes da ação corretiva sempre que possível.
Laboratório guiado

Construa, quebre, diagnostique e recupere

  1. Registre um baseline saudável.
  2. Induza uma falha controlada relacionada ao tema.
  3. Identifique a camada com falha antes de reiniciar componentes.
  4. Corrija a causa identificada e valide a recuperação.
Checklist de produção

Pronto para produção?

Responsabilidade

Objetivo, escopo e owner estão definidos.

Segurança

Credenciais e integrações seguem menor privilégio.

Validação

Falha e recuperação foram testadas e documentadas.

Versão e referências

Documentação sensível à versão

LibreNMS é rolling release. O conteúdo foi confrontado com a documentação oficial atual; instalação, Dispatcher, API, distributed polling, RRDCached, Redis, HA e requisitos devem ser reconfirmados antes de change.