¶ 📜 Logs de Ativação – Ações Executadas no Sistema
Este documento descreve os Logs de Ativação, responsáveis por registrar todas as ações executadas sobre um assinante FTTH / GPON, independentemente da origem da ação.
Os logs funcionam como auditoria técnica oficial, permitindo rastrear quem executou, quando executou, qual ação foi realizada e quais parâmetros foram alterados.
¶ 🎯 Objetivo dos Logs de Ativação
Os Logs de Ativação têm como finalidade:
- Registrar ações técnicas executadas na rede
- Identificar a origem da ação (Portal, ACS, App ou API)
- Exibir parâmetros alterados com valores anteriores e novos
- Garantir rastreabilidade e auditoria
- Auxiliar análises de falhas e troubleshooting
- Suportar investigações de erros operacionais ou automações
¶ 🧭 Origem das Ações Registradas
As ações podem ser executadas por diferentes origens, todas registradas no histórico:
-
🖥️ Portal
Ações manuais realizadas por usuários administrativos. -
🤖 ACS (TR-069 / TR-369)
Automações de configuração e gerenciamento remoto da ONU/CPE. -
📱 Aplicativo Técnico
Ações executadas em campo durante instalação, manutenção ou sanitização. -
🔌 Usuários de API
Ações originadas por integrações externas (ERP, bots, sistemas parceiros).
A origem é identificada pelo usuário executor, contexto da operação e tipo de ação.
¶ 🧱 Estrutura de um Registro de Log
Cada registro de log de ativação é composto pelos blocos abaixo:
¶ 👤 Identificação do Assinante
Contém as informações básicas do cliente afetado pela ação:
- ID do Cliente GPON
- Nome do Assinante
- Cidade
- Plano Contratado
- Status do Serviço
Exemplo:
gpon_clients/147- Nome: Matheus Benitti
- Cidade: Porto Alegre
- Plano: Internet 150 Mbps AC
- Status: Ativo
¶ ⚙️ Operação Executada
Indica qual ação foi realizada e o resultado da execução.
Exemplos de operações:
- Habilitado acesso à Internet após instalação
- Parâmetros alterados via aplicativo
- Alterado status do plano
- ONU reiniciada
- Provisionamento / Reprovisionamento
- Atualização de parâmetros Wi-Fi
- Limpeza de dados da ONU
Status da operação:
- 🟢 Sucesso
- 🔴 Erro
¶ 🔄 Parâmetros Alterados
Este bloco apresenta todas as alterações realizadas, sempre no formato de para valor antigo >> valor novo
¶ 🧾 Principais Parâmetros Registrados
¶ 🌐 Parâmetros GPON
- Endereço MAC
- OLT
- ONU ID
- Modelo da ONU
- PON Link
- Service Port
- Número de Série da ONU
- Estado da instalação (concluída / não concluída)
¶ 📶 Parâmetros de Wi-Fi / CPE
- SSID Wi-Fi 2.4GHz
- SSID Wi-Fi 5GHz
- Senha Wi-Fi
- Usuário AP
- Senha AP
- Porta Web
- Limpeza ou reaplicação de configurações
¶ 🧠 Estados Operacionais
- Status do plano
- Velocidade aplicada
- Reinício de ONU
- Alterações pós-instalação
- Ações de sanitização
¶ 🕒 Data, Hora e Executor
Cada log registra de forma obrigatória:
- 📅 Data e hora exata da execução
- 👤 Usuário executor
- Usuário do Portal
- Técnico (Aplicativo)
- Usuário de API
- Processo automático (ACS)
Essas informações permitem auditoria completa, correlação com eventos de rede e análise temporal.
¶ 🔍 Interpretação dos Logs na Prática
Os Logs de Ativação permitem responder perguntas como:
- Quem provisionou ou reprovisionou esta ONU?
- A ação foi feita manualmente ou por automação?
- Algum parâmetro foi limpo indevidamente?
- Houve múltiplas ações em curto intervalo?
- A ação veio do App, Portal, ACS ou API?
- Qual foi o último estado válido aplicado?
¶ 🧪 Boas Práticas de Análise
✔ Sempre verificar:
- Origem da ação
- Usuário executor
- Horário da ação em relação ao evento reportado
- Parâmetros realmente alterados
⚠ Atenção especial quando:
- Valores retornam para
(vazio) - Existem ações duplicadas
- Ações são executadas por usuários de API
- Há divergência entre App, Portal e ACS
¶ 🧩 Observações Importantes
- Logs não alteram estado, apenas registram ações
- A ausência de parâmetros indica nenhuma mudança aplicada
- Logs são fundamentais para Suporte N2 e N3
- Toda integração deve gerar logs consistentes
- Logs são a fonte oficial de auditoria técnica
¶ 📎 Documentos Relacionados
- 🧭 Sumário do Ponlink
- 🔌 Provisionamento GPON
- 🤖 Automações ACS
- 📱 App Técnico – Sanitização e Ativação
📌 Importante:
Sempre que houver dúvidas sobre comportamento da rede, a análise deve começar pelos Logs de Ativação.