CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Librenms · Fundamentos

Arquitetura

WebUI/API em PHP/Laravel, MariaDB/MySQL, RRD/RRDCached, Poller, Discovery, Alerting e Scheduler/Dispatcher formam o núcleo. Redis entra em cenários distribuídos para coordenação, cache, filas e sessões.

librenms://Fundamentos
$ platform: Librenms
$ topic: Arquitetura
$ mode: production
$ method: evidence-first_
Escopo técnico

Arquitetura

WebUI/API em PHP/Laravel, MariaDB/MySQL, RRD/RRDCached, Poller, Discovery, Alerting e Scheduler/Dispatcher formam o núcleo. Redis entra em cenários distribuídos para coordenação, cache, filas e sessões.

01 · Fundamentos

Ponto técnico 1

Componentes centrais: WebUI/API em PHP/Laravel, MariaDB/MySQL, RRD/RRDCached, Poller, Discovery, Alerting e Scheduler/Dispatcher formam o núcleo. Redis entra em cenários distribuídos para coordenação, cache, filas e sessões.

02 · Fundamentos

Ponto técnico 2

Fluxo de dados: Dispositivo → ICMP/SNMP → Poller → banco + RRD → Alert Rule → Operation/Transport → NOC. Discovery executa em cadência mais longa e atualiza inventário de portas, sensores, módulos e relacionamentos.

03 · Fundamentos

Ponto técnico 3

Banco relacional: O banco armazena dispositivos, portas, inventário, regras, usuários, alertas e metadados. Ele não deve ser tratado como simples cache descartável.

04 · Fundamentos

Ponto técnico 4

RRD e RRDCached: RRD guarda séries de desempenho. RRDCached desacopla escrita em disco, reduz I/O e é requisito prático para distributed polling.

05 · Fundamentos

Ponto técnico 5

Scheduler: Instalações modernas podem usar systemd scheduler e Dispatcher Service. Dispatcher agenda poller, discovery, services, alerting, billing, fast ping e manutenção diária.

06 · Fundamentos

Ponto técnico 6

Domínios de falha: WebUI, banco, RRD, Redis, pollers e rede SNMP podem falhar independentemente. Um painel vazio não prova que o polling parou; um poller saudável não prova que alerting está entregando.

07 · Fundamentos

Ponto técnico 7

Escala: Comece com uma instalação estável. Depois RRDCached, Dispatcher, tuning, separação de banco/WebUI, Redis e pollers adicionais. Escalar antes de medir cria complexidade sem benefício.

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.