CIRCUITO
CARIOCA TI · DOCUMENTAÇÃO
♙
Librenms · Backup de Configuração

Integração Oxidized

Oxidized adiciona backup/versionamento de configuração de equipamentos, enquanto LibreNMS fornece inventário e integração visual.

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

Integração Oxidized

Oxidized adiciona backup/versionamento de configuração de equipamentos, enquanto LibreNMS fornece inventário e integração visual.

01 · Backup de Configuração

Ponto técnico 1

Objetivo: Oxidized adiciona backup/versionamento de configuração de equipamentos, enquanto LibreNMS fornece inventário e integração visual.

02 · Backup de Configuração

Ponto técnico 2

Arquitetura: Oxidized pode consumir a API /api/v0/oxidized do LibreNMS para obter devices/model/group.

03 · Backup de Configuração

Ponto técnico 3

Credenciais: LibreNMS não fornece credenciais de login dos equipamentos ao Oxidized; elas ficam na configuração/grupos do Oxidized.

04 · Backup de Configuração

Ponto técnico 4

Integração Web: oxidized.enabled e oxidized.url permitem mostrar configurações na página do dispositivo.

05 · Backup de Configuração

Ponto técnico 5

Versionamento: Com output Git no Oxidized, LibreNMS pode expor histórico/versioning.

06 · Backup de Configuração

Ponto técnico 6

Groups: LibreNMS pode devolver groups ao Oxidized para aplicar credenciais por grupo.

07 · Backup de Configuração

Ponto técnico 7

API Token: A integração usa X-Auth-Token; proteja o token e restrinja HTTPS/rede.

08 · Backup de Configuração

Ponto técnico 8

Segurança: Backup de configuração pode conter communities, chaves ou topologia; aplique controle de acesso e retenção.

09 · Backup de Configuração

Ponto técnico 9

Troubleshooting: API oxidized → model mapping → reachability SSH → credential group → output repo → integração WebUI.

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

lnms config:set oxidized.enabled true
lnms config:set oxidized.url http://127.0.0.1:8888

curl -H 'X-Auth-Token: \${LIBRENMS_TOKEN}' https://librenms.exemplo/api/v0/oxidized
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.