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

Polling e Dispatcher Service

Poller coleta métricas e atualiza banco/RRD. O objetivo operacional é terminar toda a carga dentro do intervalo.

librenms://Coleta
$ platform: Librenms
$ topic: Polling e Dispatcher Service
$ mode: production
$ method: evidence-first_
Escopo técnico

Polling e Dispatcher Service

Poller coleta métricas e atualiza banco/RRD. O objetivo operacional é terminar toda a carga dentro do intervalo.

01 · Coleta

Ponto técnico 1

Poller: Poller coleta métricas e atualiza banco/RRD. O objetivo operacional é terminar toda a carga dentro do intervalo.

02 · Coleta

Ponto técnico 2

Discovery: Discovery roda com frequência menor e detecta mudanças de inventário; não confunda atraso de discovery com falha de polling.

03 · Coleta

Ponto técnico 3

Dispatcher Service: librenms-service.py agenda Poller, Discovery, Services, Alerting, Billing, Fast Ping e manutenção diária sem substituir os scripts PHP que executam as tarefas.

04 · Coleta

Ponto técnico 4

Migração de cron: Ao usar Dispatcher para uma tarefa, evite executá-la simultaneamente pelo cron. A documentação alerta para remover o cron antigo quando apropriado para evitar polling duplicado.

05 · Coleta

Ponto técnico 5

Workers: Consumed Worker Seconds deve permanecer abaixo de Maximum Worker Seconds. Devices Pending indica insuficiência ou distribuição ruim.

06 · Coleta

Ponto técnico 6

Fast Ping: É scheduler separado e desabilitado por padrão. Habilite somente se houver objetivo operacional.

07 · Coleta

Ponto técnico 7

Systemd watchdog: Há unidade alternativa com WatchdogSec para reiniciar Dispatcher travado; ela exige suporte python-systemd.

08 · Coleta

Ponto técnico 8

Diagnóstico: systemctl status librenms → logs → validate.php → Poller UI → workers/pendências → dispositivo lento.

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

systemctl status librenms --no-pager
journalctl -u librenms -n 200 --no-pager
cd /opt/librenms && ./validate.php
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.