Cadastro e Descoberta de Dispositivos
Use hostname/IP estável e credencial adequada. Um dispositivo deve resolver/ser alcançável a partir do poller responsável.
Ponto técnico 1
Cadastro manual: Use hostname/IP estável e credencial adequada. Um dispositivo deve resolver/ser alcançável a partir do poller responsável.
Ponto técnico 2
Discovery inicial: Após o cadastro, discovery identifica OS, portas, sensores, processors, storage, routing e outros módulos suportados.
Ponto técnico 3
Forçar discovery/poller: Em laboratório, execute discovery.php e poller.php com debug para um dispositivo específico para ver exatamente qual módulo falha.
Ponto técnico 4
Reachability: Ping e SNMP são verificações diferentes. Um dispositivo pode responder SNMP e bloquear ICMP, ou vice-versa; configure política conscientemente.
Ponto técnico 5
OS detection: sysObjectID/sysDescr orientam a identificação. Quando detection falha, não force um OS arbitrário sem validar o motivo.
Ponto técnico 6
Inventário: Hardware, serial, software, entidade física e sensores dependem do suporte do vendor/MIB.
Ponto técnico 7
Onboarding: Defina padrão: hostname, localização, grupo, purpose, SNMP, owner, alert rules e descrição de interfaces antes de 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.
Comandos / fluxo de referência
cd /opt/librenms
./discovery.php -h HOSTNAME -d
./poller.php -h HOSTNAME -dRotina 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.
Sintoma → escopo → camada → evidência → hipótese → validação
Construa, quebre, diagnostique e recupere
- Registre um baseline saudável.
- Induza uma falha controlada relacionada ao tema.
- Identifique a camada com falha antes de reiniciar componentes.
- Corrija a causa identificada e valide a recuperaçã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.
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.