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

Observabilidade do LibreNMS

O monitoramento deve incluir o próprio servidor/pollers, banco, Redis, RRDCached, disco e filas.

librenms://Operação
$ platform: Librenms
$ topic: Observabilidade do LibreNMS
$ mode: production
$ method: evidence-first_
Escopo técnico

Observabilidade do LibreNMS

O monitoramento deve incluir o próprio servidor/pollers, banco, Redis, RRDCached, disco e filas.

01 · Operação

Ponto técnico 1

Monitore o LibreNMS: O monitoramento deve incluir o próprio servidor/pollers, banco, Redis, RRDCached, disco e filas.

02 · Operação

Ponto técnico 2

validate.php: É ferramenta central de health-check e verifica config, DB, RRD, disk, fping, ownership e outras condições. Há módulos mail, dist-poller e rrdcheck.

03 · Operação

Ponto técnico 3

Poller UI: Acompanhe workers, pending devices e performance por nó.

04 · Operação

Ponto técnico 4

Logs: /opt/librenms/logs, systemd, NGINX/PHP-FPM, MariaDB e Redis fornecem camadas distintas de evidência.

05 · Operação

Ponto técnico 5

RRD: Monitore I/O e integridade. validate.php -m rrdcheck ajuda a detectar RRD corrupto/ilegível.

06 · Operação

Ponto técnico 6

API/Synthetic: Use API/health funcional, login e consulta de device como teste sintético.

07 · Operação

Ponto técnico 7

Alerting: Crie alertas externos para falha de poller/DB/storage, evitando depender apenas da plataforma afetada.

08 · Operação

Ponto técnico 8

Baseline: Registre tempo normal de polling, workers, DB latency, disk I/O e crescimento.

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.

Comandos / fluxo de referência

cd /opt/librenms
./validate.php
./validate.php -m rrdcheck
./validate.php -m mail
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.