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

Configuração

A documentação atual prefere lnms config:set/get para grande parte das opções. config.php continua existindo para configurações específicas e locais.

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

Configuração

A documentação atual prefere lnms config:set/get para grande parte das opções. config.php continua existindo para configurações específicas e locais.

01 · Administração

Ponto técnico 1

lnms config: A documentação atual prefere lnms config:set/get para grande parte das opções. config.php continua existindo para configurações específicas e locais.

02 · Administração

Ponto técnico 2

config.php: Evite transformar config.php em arquivo desorganizado. Comente alterações locais, separe segredos e registre por que uma configuração diverge do padrão.

03 · Administração

Ponto técnico 3

.env: Instalações modernas usam .env para valores de aplicação, banco e, em distributed polling, APP_KEY/NODE_ID. Proteja permissões e não versiona segredos.

04 · Administração

Ponto técnico 4

Timezone: Sistema, PHP e banco precisam usar timezone coerente. Diferenças afetam gráficos, alertas, syslog e troubleshooting.

05 · Administração

Ponto técnico 5

SNMP Defaults: Centralize padrões SNMP por política, mas não force uma única community/credencial em toda rede se isso ampliar o impacto de vazamento.

06 · Administração

Ponto técnico 6

Poller: Workers, polling interval e grupos devem ser alterados somente com métrica de consumo/pendência.

07 · Administração

Ponto técnico 7

Web: Base URL, proxy, HTTPS e headers precisam refletir a arquitetura. Falhas de reverse proxy podem afetar API e autenticação.

08 · Administração

Ponto técnico 8

Validação: Toda mudança relevante deve terminar com validate.php, polling de um dispositivo conhecido e inspeção de logs.

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.