13. Logs
Registro técnico do que o sistema fez (coletas, descobertas, erros). Útil para investigar um problema a fundo.
Tela de Logs: filtros por nível e componente, a lista de registros e o painel de explicação que abre ao clicar numa linha.
- Filtros: nível (INFO/WARNING/ERROR/DEBUG/TRACE, em botões clicáveis), componente (ex.: coleta, descoberta, IA, SNMP) e busca por texto.
- Colunas: data/hora, nível, componente, ID de correlação, mensagem, recurso (qual equipamento/ONU) e detalhes extras (JSON expansível).
- Explicação (clique na linha): cada registro pode ser expandido com um clique para mostrar uma explicação em linguagem direta. Em erros e avisos acionáveis ela traz o que é / causa provável / o que fazer; em informativos, um resumo curto do que aquele evento significa. O painel também mostra os detalhes extras (JSON). Útil para entender um log sem decorar mensagens técnicas.
- Purgar logs antigos: apaga registros por política de retenção por nível — DEBUG > 1 dia, INFO > 7 dias, WARNING > 30 dias, ERROR/CRITICAL > 90 dias. Registros mais recentes que esses limites são preservados. A limpeza é manual (botão); não há purga automática agendada.
- Excluir logs (somente engenharia da base central): apaga exatamente o recorte em tela — os filtros ativos (nível, componente, busca, correlação). Útil para limpar o ruído de uma fonte específica. Sem filtro, apaga todos os logs (com dupla confirmação). O botão só aparece em sessão de engenharia e a ação é registrada em auditoria.
Severidade: ERRO é reservado ao que compromete o ambiente/dado e exige reparo imediato. Situações esperadas ou transitórias (ex.: uma amostra de coleta descartada) entram como AVISO, não erro — então um "AVISO" não significa, por si só, algo quebrado. CRÍTICO é o topo: só dispara em catástrofe que exige ação imediata — o loop de coleta parou, todos os equipamentos ficaram offline num ciclo, ou o disco/memória do servidor passou de 95%. Se o cartão CRÍTICO sair de 0, trate como urgência (a explicação diz o que fazer). Condições de PON/equipamento (temperatura, porta down, utilização) ficam na tela de Alertas, não nos Logs.
Dica: o ID de correlação liga vários registros de uma mesma operação. Ao investigar um incidente, filtre por esse ID para ver a história completa do que aconteceu.
Volume alto? Boa parte do volume costuma vir de poucas mensagens repetidas. Filtre por nível (ex.: WARNING) e ordene por componente para identificar a fonte dominante — a Explicação indica a causa e o que fazer.