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

Templates, Transports e Operations

Rule detecta; Template formata; Operation define escalonamento; Transport entrega. Misturar esses papéis dificulta manutenção.

librenms://Alerting
$ platform: Librenms
$ topic: Templates, Transports e Operations
$ mode: production
$ method: evidence-first_
Escopo técnico

Templates, Transports e Operations

Rule detecta; Template formata; Operation define escalonamento; Transport entrega. Misturar esses papéis dificulta manutenção.

01 · Alerting

Ponto técnico 1

Separação de responsabilidades: Rule detecta; Template formata; Operation define escalonamento; Transport entrega. Misturar esses papéis dificulta manutenção.

02 · Alerting

Ponto técnico 2

Templates: Templates atuais usam Laravel Blade e placeholders. A própria documentação alerta que @php pode executar código; apenas usuários confiáveis devem editar templates.

03 · Alerting

Ponto técnico 3

Transports: Email, Slack, Telegram, API/webhook e outros transports enviam notificações. Teste cada destino independentemente da regra.

04 · Alerting

Ponto técnico 4

Operations: Operations são planos reutilizáveis com segmentos, steps, timing e targets. Permitem escalonar NOC → L2 → gestão/on-call.

05 · Alerting

Ponto técnico 5

Transport Groups: Agrupe destinos reutilizáveis para reduzir duplicação.

06 · Alerting

Ponto técnico 6

Recovery/Update: Planeje fases problem, recovery e update/ack conforme o processo do NOC.

07 · Alerting

Ponto técnico 7

Segurança: Webhook/API transport pode carregar segredo/header. Proteja tokens e não os exponha em template/log.

08 · Alerting

Ponto técnico 8

Troubleshooting: Rule ativa → operation associada → step atual → transport → template renderizado → HTTP/SMTP destino.

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.