Guia de Operações do RAN Monitor
Plataforma de Monitoramento e Gerenciamento de Rede de Acesso Rádio (RAN)
por Omnitouch Network Services
Índice
- Visão Geral
- O que o RAN Monitor Faz
- Arquitetura do Sistema
- Visão Geral da Interface Web
- Monitoramento com Grafana
- Operações Comuns
- Índice de Documentação
- Referência Rápida
- Suporte
Visão Geral
O RAN Monitor é uma plataforma de gerenciamento e monitoramento para estações base Nokia AirScale em redes 3GPP LTE e 5G. Ele fornece visibilidade em tempo real sobre a saúde, desempenho e configuração do seu equipamento RAN.
Principais Recursos
- Monitoramento em Tempo Real - Coleta contínua de métricas de desempenho e alarmes
- Gerenciamento Automatizado - Mantém conexões persistentes com estações base
- Análise Histórica - Armazena dados para análise de tendências e planejamento de capacidade
- Painel Web - Visibilidade operacional em tempo real através da interface Web integrada
- Integração com Grafana - Análises avançadas e painéis personalizados
Componentes do Sistema
| Componente | Propósito | Acesso |
|---|---|---|
| Gerenciador do RAN Monitor | Aplicativo central que gerencia conexões com estações base | Serviço em segundo plano |
| Endpoint NE3S da Nokia | Receptor de PM/config/alarme da Nokia AirScale | http://<server>:9076 |
| Endpoint PM da Casa | Receptor de push de PM da femtocell Casa (veja Coleta de PM da Casa) | http://<server>:9077 |
| Endpoint de Push da Flexi Zone | Receptor de push de PM/alarme da Classic Nokia Flexi Zone e API de integração (veja Coleta da Flexi Zone) | http://<server>:9081 |
| Poller Baicells | Polls a API /fsmoam/ da Baicells eNB (veja Coleta da Baicells) | outbound → cell :443 |
| Painel de Controle da Interface Web | Painel operacional em tempo real | https://<server>:9443 |
| Banco de Dados MySQL | Estado da sessão e configuração do dispositivo | Interno |
| InfluxDB | Armazenamento de métricas de séries temporais | http://<server>:8086 |
| Grafana | Painéis de análise e alertas | http://<server>:3000 |
| Servidor TCE NSNTI | Coleta de rastreamento de estações base | Porta TCP 49151 |
| Encaminhador TCE TZSP | Exportação de rastreamento em tempo real para Wireshark | Porta UDP 37008 |
Exemplo: Painel de Monitoramento Detalhado
Painel de monitoramento abrangente mostrando o status das conexões S1 por LNMME, estado operacional, dados transferidos, UEs conectados, uso médio de PRB, métricas de monitoramento de desempenho e mapa de cobertura geográfica. Este painel fornece aos operadores de rede visibilidade instantânea sobre a saúde do dispositivo, status de conectividade e indicadores-chave de desempenho.
O que o RAN Monitor Faz
O RAN Monitor opera continuamente em segundo plano para:
- Registrar e Conectar - Estabelece conexões seguras com suas estações base Nokia
- Coletar Dados de Desempenho - Coleta KPIs a cada 10 segundos (configurável)
- Monitorar Alarmes - Acompanha falhas e seus níveis de severidade
- Rastrear Configuração - Registra o estado do sistema e mudanças de parâmetros
- Armazenar Dados Históricos - Preserva m��tricas em banco de dados de séries temporais
- Fornecer Visibilidade - Exibe status em tempo real através da interface Web e Grafana
Fluxo de Dados
O que é Coletado
Métricas de Desempenho:
- Disponibilidade e tempo de atividade da célula
- Taxa de transferência de tráfego (uplink/downlink)
- Utilização de recursos (uso de PRB)
- Taxas de sucesso na configuração de chamadas
- Desempenho de transferência
- Medições de qualidade de rádio
Alarmes:
- Severidade da falha (Crítica, Maior, Menor, Aviso)
- Sistemas e componentes afetados
- Causa provável e descrições
- Carimbos de data/hora e durações
Configuração:
- Capturas completas de configuração XML (armazenadas como arquivos versionados)
- Detecção automática de mudanças e versionamento
- Histórico de configuração e trilha de auditoria
- Últimas 10 versões retidas por dispositivo
Para detalhes sobre gerenciamento de configuração, veja o Guia de Arquivo de Configuração.
Para definições detalhadas de contadores, veja o Referência de Contadores da Nokia.
Arquitetura do Sistema
Visão Geral da Infraestrutura
Visão Geral da Configuração
Para detalhes completos da configuração, veja o Guia de Configuração em Tempo de Execução.
Entidade de Coleta de Rastreio (TCE)
O RAN Monitor inclui uma Entidade de Coleta de Rastreio integrada para capturar e analisar mensagens de protocolo LTE/5G. Isso permite uma solução detalhada de problemas, testes de drive e otimização de RF.
O que é TCE?
A Entidade de Coleta de Rastreio recebe dados de rastreio de estações base Nokia AirScale contendo:
- Mensagens S1-AP - Sinalização do plano de controle entre eNodeB e EPC
- Mensagens RRC - Sinalização de Controle de Recursos de Rádio
- Mensagens NAS - Sinalização do Estrato Não Acessível
- Dados do Plano do Usuário - Informações de taxa de transferência da camada PDCP
Casos de Uso
Teste de Drive:
- Capturar a experiência de RF do usuário final
- Analisar o desempenho de transferência
- Medir a qualidade do sinal (RSRP, RSRQ, SINR)
- Identificar buracos de cobertura
Solução de Problemas:
- Depurar falhas na configuração de chamadas
- Analisar problemas de transferência
- Investigar chamadas perdidas
- Revisar eventos de mobilidade
Otimização de RF:
- Validação do planejamento de PCI
- Otimização de relações de vizinhança
- Ajuste de parâmetros de transferência
- Análise de cobertura e capacidade
Para procedimentos completos de coleta de rastreio e análise no Wireshark, veja o Guia de Coleta de Dados MDT do TCE.
Visão Geral da Interface Web
O RAN Monitor inclui uma interface Web integrada para monitoramento e gerenciamento operacional em tempo real.
Acesso: https://<ran-monitor-ip>:9443
O painel principal fornece visibilidade instantânea sobre a saúde do sistema, status do dispositivo e alarmes ativos.
Páginas Principais
Painel Principal
Visão geral do sistema em tempo real com:
- Indicadores de saúde do sistema
- Resumo do status do dispositivo (contagens associadas/falhadas)
- Contagens de alarmes ativos por severidade
- Atividade e eventos recentes
Atualiza automaticamente a cada 5 segundos para visibilidade em tempo real.
Página de Estações Base
Visualize todos os dispositivos gerenciados com seu status atual:
- Status da conexão (verde = associado, vermelho = falhado)
- Estado de registro e informações da sessão
- Carimbo de data/hora do último contato
- Capacidades de filtro, pesquisa e ordenação
Clique em qualquer dispositivo para visualizar informações detalhadas, incluindo detalhes de registro, ciclo de vida da sessão, métricas recentes e alarmes ativos.
Página de Alarmes
Monitore todas as falhas em sua rede:
- Codificação por cores de acordo com a severidade (Vermelho = Crítico, Laranja = Maior, Amarelo = Menor, Azul = Aviso, Verde = Limpo)
- Detalhes do alarme, causa provável, sistema afetado
- Acompanhamento de carimbos de data/hora e duração
- Ordenar por severidade e capacidades de filtro
Para procedimentos de manuseio de alarmes, veja o Guia de Gerenciamento de Alarmes.
Gerenciamento de Configuração
Gerencie configurações de estações base com segurança:
- Baixar configuração atual (backup)
- Carregar nova configuração → receber ID do Plano
- Validar configuração usando ID do Plano
- Ativar configuração validada
- Verificar se as mudanças tiveram efeito
Sempre valide antes de ativar para evitar interrupções no serviço.
Arquivo de Configuração: Todas as mudanças de configuração são automaticamente rastreadas e versionadas. Visualize configurações históricas, baixe versões anteriores ou compare mudanças através da página de Arquivo de Configuração.
Para procedimentos detalhados, veja o Guia da Interface Web - Gerenciamento de Configuração e Guia de Arquivo de Configuração.
- Guia de Push de Configuração - Enviando mudanças de configuração completas ou parciais para estações base (impacto de reinicialização, atualizações parciais, formato SCF)
eNodeBs Não Configurados
Descubra estações base tentando se conectar que ainda não estão configuradas:
- ID do Agente (use ao adicionar à configuração)
- Carimbo de data/hora da última visualização
- Número de tentativas de conexão
- Ações: Atualizar, Excluir, Limpar Tudo
Caso de Uso: Quando novas estações base são implantadas, elas aparecem aqui. Copie o ID do Agente e adicione-o a config/runtime.exs.
Logs da Aplicação
Painel de logs em tempo real para solução de problemas:
- Filtrar por nível de log (Emergência até Depuração)
- Pesquisar em todas as mensagens
- Pausar/Retomar streaming ao vivo
- Alterar dinamicamente o nível de log do sistema
- Codificação por cores de acordo com a severidade
Para procedimentos de solução de problemas, veja o Guia de Solução de Problemas.
Política de Retenção de Dados
Gerencie por quanto tempo os dados são armazenados no InfluxDB:
- Visualizar política de retenção global e contagens totais de registros
- Definir períodos de retenção por dispositivo
- Visualizar contagens de registros por tipo de medição (Métricas de Desempenho, Configuração, Alarmes)
- Acionar manualmente limpeza ou limpar todos os dados de um dispositivo
Para informações completas sobre retenção de dados, veja o Guia de Política de Retenção de Dados.
Status do InfluxDB
Monitore a saúde do banco de dados de séries temporais:
- Indicador de status da conexão
- Contagens de medições por tipo
- Informações de armazenamento
- Versão e configuração do banco de dados
- Atualiza automaticamente a cada 5 minutos
Interpretando o Status:
- Conectado + Contagens Crescentes = Operação normal
- Conectado + Sem Dados = Verifique o registro do dispositivo
- Desconectado = Verifique a conectividade do InfluxDB
Guia Completo da Interface Web
Para documentação abrangente da Interface Web, incluindo todos os recursos, fluxos de trabalho e melhores práticas, veja:
Guia da Interface Web - Referência completa do painel de controle
Monitoramento com Grafana
Enquanto a Interface Web fornece visibilidade em tempo real, o Grafana permite uma análise histórica profunda e painéis personalizados.
Por que Usar o Grafana?
Grafana é Melhor Para:
- Análise de tendências históricas ao longo de dias/semanas/meses
- Painéis de KPI personalizados adaptados às suas necessidades
- Planejamento de capacidade a longo prazo
- Identificação de padrões e detecção de anomalias
- Relatórios executivos e rastreamento de SLA
- Alertas avançados com canais de notificação
A Interface Web é Melhor Para:
- Verificações imediatas do status do dispositivo
- Monitoramento de alarmes em tempo real
- Gerenciamento de configuração
- Solução de problemas de sessão
- Tarefas de administração do sistema
Exemplo de painel do Grafana mostrando disponibilidade de células, tendências de throughput e utilização de recursos
Tipos de Painéis
Painel de Resumo Executivo:
- Visão geral da saúde da rede
- Contagem total de alarmes por severidade
- Disponibilidade média de células em todos os sites
- Métricas agregadas de throughput e capacidade
- Grade de status do dispositivo
Painel de Operações NOC:
- Tabela de problemas ativos em tempo real
- Medidores de utilização de recursos
- Visão geral do tráfego (últimas 24 horas)
- Gráficos de tendência de alarmes
- Visão rápida do status do dispositivo
Painel de Análise Profunda de Engenharia:
- Análise de padrões de tráfego
- Métricas de qualidade de célula (distribuições de SINR, RSRP)
- Desempenho de rádio (retransmissão RLC, sucesso na configuração RRC)
- Trilhas de auditoria de configuração
- Análise de correlação
Painel de Desempenho da Nokia AirScale:
- Utilização de PRB (DL/UL)
- Tendências de throughput (camada PDCP)
- Contagens de UE ativas
- Cálculos de disponibilidade de células
- Quebras de recursos por célula
- Medições de RSSI
- Sucesso na configuração de conexão RRC
- VSWR por antena
- Consumo de energia
Para exemplos completos de painéis, padrões de consulta e definições de contadores, veja:
Guia de Integração com Grafana - Guia completo de análises e painéis
Referência de Contadores da Nokia - Definições de contadores de desempenho
Operações Comuns
Operações Diárias
Verificação de Saúde Diária (5-10 minutos):
- Abra o painel da Interface Web
- Verifique se todos os dispositivos mostram status verde
- Verifique a contagem e severidade dos alarmes
- Revise quaisquer dispositivos falhados
- Investigue problemas conforme necessário
Para procedimentos detalhados, veja o Guia da Interface Web - Fluxos de Trabalho.
Investigação de Alarmes:
- Abra a página de Alarmes, ordene por severidade
- Clique no alarme para detalhes completos
- Navegue até o dispositivo afetado
- Faça referência cruzada com as métricas
- Determine a ação necessária e resolva
Para procedimentos de manuseio de alarmes, veja o Guia de Gerenciamento de Alarmes.
Gerenciamento de Dispositivos
Adicionando uma Nova Estação Base:
- Verifique a conectividade de rede com o dispositivo
- Verifique a página de eNodeBs Não Configurados para o dispositivo
- Adicione o dispositivo a
config/runtime.exs - Reinicie o RAN Monitor
- Verifique se o registro é bem-sucedido (status verde)
- Confirme se as métricas estão fluindo para o InfluxDB
Removendo uma Estação Base:
- Decida se deseja preservar ou excluir dados históricos
- Comente ou remova o dispositivo de
config/runtime.exs - Opcionalmente, limpe dados através da página de Retenção de Dados
- Reinicie o RAN Monitor
- Atualize os painéis do Grafana
Atualizando Credenciais do Dispositivo:
- Anote o status atual do dispositivo
- Atualize as credenciais em
config/runtime.exs - Reinicie o RAN Monitor
- Verifique se a reconexão é bem-sucedida
Para procedimentos operacionais completos, veja:
Guia de Operações Comuns - Tarefas de gerenciamento do dia a dia
Gerenciamento de Configuração
Fluxo de Trabalho Seguro para Atualização de Configuração:
- Baixar configuração atual (backup) - ou recuperar do Arquivo de Configuração
- Modificar configuração offline
- Carregar para o dispositivo → obter ID do Plano
- Validar usando ID do Plano → verificar se não há erros
- Ativar se a validação for bem-sucedida
- Verificar se as mudanças tiveram efeito
- Monitorar a estabilidade do dispositivo por 15-30 minutos
- Confirmar que a nova versão aparece no Arquivo de Configuração (dentro de 1 hora)
Importante: Sempre valide antes de ativar. Programe mudanças durante janelas de manutenção, quando possível.
Rollback de Configuração: Se ocorrerem problemas, baixe uma versão anterior do Arquivo de Configuração e carregue-a usando o mesmo fluxo de trabalho.
Para detalhes sobre configuração de estações base, veja o Guia de Configuração AirScale.
Para histórico de configuração e versionamento, veja o Guia de Arquivo de Configuração.
Índice de Documentação
A documentação do RAN Monitor está organizada por público e caso de uso:
Para Equipes de Operações (NOC, Administradores)
| Documento | Propósito | Quando Usar |
|---|---|---|
| Guia da Interface Web | Referência completa do painel de controle | Operações diárias, monitoramento de dispositivos |
| Guia de Operações Comuns | Tarefas de gerenciamento do dia a dia | Adicionando dispositivos, gerenciando configs, backups |
| Guia de Arquivo de Configuração | Versionamento e histórico de configuração | Rastreando mudanças de configuração, rollback, auditoria |
| Guia de Gerenciamento de Firmware | Repositório de pacotes de software | Carregando firmware, atualizações de software da estação base |
| Guia de Gerenciamento de Alarmes | Manuseio e escalonamento de alarmes | Investigando falhas, respondendo a alertas |
| Guia de Solução de Problemas | Procedimentos de resolução de problemas | Quando ocorrem problemas, diagnóstico de erros |
| Guia de Política de Retenção de Dados | Gerenciamento do ciclo de vida dos dados | Gerenciando armazenamento, definindo períodos de retenção |
Para Engenharia e Análise
| Documento | Propósito | Quando Usar |
|---|---|---|
| Guia de Integração com Grafana | Painéis, consultas e alertas | Construindo painéis, configurando alertas |
| Referência de Métricas | Métricas do Prometheus expostas pelo RAN Monitor (nomes, tipos, rótulos) | Alertas, painéis, monitoramento da saúde do aplicativo |
| Referência de Contadores da Nokia | Definições de contadores de desempenho | Entendendo métricas, criando consultas |
| Guia de Configuração AirScale | Configuração e setup da estação base | Configurando dispositivos, entendendo parâmetros |
| Guia de Comissionamento DHCP | Integração de estações base via DHCP | Comissionando novas estações base através da Opção 43 do DHCP |
| Coleta da Flexi Zone | Coleta de PM/alarme da Classic Nokia Flexi Zone e integração da API | Integração e monitoramento de estações base clássicas da Flexi Zone |
| Guia de Coleta de Dados MDT do TCE | Coleta de rastreio MDT e análise no Wireshark | Coletando dados de teste de drive, otimização de cobertura |
| Referência de Endpoints da API | Documentação da API REST | Integrações, automação, scripting |
Para Configuração e Implantação
| Documento | Propósito | Quando Usar |
|---|---|---|
| Guia de Configuração em Tempo de Execução | Referência completa de configuração | Configuração inicial, modificação de configurações |
Início Rápido
Novo no RAN Monitor?
- Comece com o Guia da Interface Web para aprender a interface
- Revise o Guia de Operações Comuns para tarefas rotineiras
- Estude o Guia de Gerenciamento de Alarmes para manuseio de alarmes
- Mantenha o Guia de Solução de Problemas salvo para questões
Configurando Monitoramento?
- Veja o Guia de Integração do Grafana para painéis
- Consulte o Referência de Contadores da Nokia para métricas
- Revise o Guia de Política de Retenção de Dados para gerenciamento de armazenamento
Referência Rápida
Pontos de Acesso
| Serviço | URL | Propósito |
|---|---|---|
| Painel da Interface Web | https://<server>:9443 | Monitoramento e gerenciamento em tempo real |
| Grafana | http://<server>:3000 | Painéis de análise e alertas |
| InfluxDB | http://<server>:8086 | Banco de dados de métricas (geralmente acesso interno apenas) |
Caminhos Importantes
| Caminho | Propósito |
|---|---|
config/runtime.exs | Arquivo de configuração principal (dispositivos, bancos de dados, configurações) |
priv/cert/ | Certificados SSL para a Interface Web HTTPS |
priv/external/nokia/ | Chaves de autenticação do gerente |
priv/airscale_configs/ | Arquivo de configuração (arquivos XML versionados) |
Conceitos Chave
Gerenciamento de Sessão:
- O RAN Monitor estabelece sessões com estações base
- As sessões têm tempos de expiração e requerem keep-alive
- A re-registração acontece automaticamente (padrão: a cada 30 segundos)
- O estado da sessão é armazenado no banco de dados MySQL
Fluxo de Dados:
- Métricas coletadas a cada 10 segundos (configurável)
- Alarmes coletados a cada 10 segundos via polling + webhooks em tempo real
- Capturas de configuração a cada 1 hora (salvas como arquivos versionados quando alteradas)
- Métricas de desempenho e alarmes gravados no InfluxDB para armazenamento histórico
Retenção de Dados:
- Padrão global: 720 horas (30 dias)
- Sobrescritas por dispositivo disponíveis
- Limpeza automática é executada a cada hora
- Limpeza manual disponível via Interface Web
Para detalhes de configuração, consulte o Guia de Configuração em Tempo de Execução.
Fluxos de Trabalho Comuns
Verificação de Saúde Diária:
- Abra a Interface Web → Painel
- Verifique o status do dispositivo (tudo verde?)
- Revise a contagem de alarmes
- Investigue quaisquer problemas
Responder a Alarme Crítico:
- Interface Web → Alarmes → Classificar por severidade
- Clique no alarme para detalhes
- Navegue até o dispositivo
- Revise métricas recentes e alterações de configuração
- Implemente a resolução
- Verifique se o alarme é limpo
Adicionar Novo Dispositivo:
- Verifique a conectividade da rede
- Edite
config/runtime.exs - Adicione o dispositivo à lista de airscales
- Reinicie o RAN Monitor
- Verifique a registro (status verde)
Suporte
Recursos de Solução de Problemas
| Recurso | Usado Para |
|---|---|
| Guia de Solução de Problemas | Problemas comuns e soluções |
| Página de Logs da Aplicação | Logs e erros do sistema em tempo real |
| Visualização de Detalhes do Dispositivo | Status da sessão, problemas de registro |
| Página de Status do InfluxDB | Verificação da coleta de dados |
Passos Rápidos de Diagnóstico
Dispositivo Não Conectando:
- Verifique a página de Estações Base → status do dispositivo
- Verifique a conectividade da rede:
ping <device-ip> - Verifique credenciais em
config/runtime.exs - Revise os Logs da Aplicação para erros
Sem Métricas no Grafana:
- Verifique se o dispositivo está associado (status verde)
- Verifique se a página de Status do InfluxDB mostra contagens crescentes
- Teste a conectividade do InfluxDB
- Verifique a configuração da fonte de dados do Grafana
Interface Web Não Carregando:
- Verifique se a porta 9443 está acessível
- Verifique se o firewall permite tráfego HTTPS
- Verifique se os certificados SSL existem
- Revise os logs da aplicação para erros de inicialização da Interface Web
Para procedimentos completos de solução de problemas, consulte o Guia de Solução de Problemas.
Obtendo Ajuda
Antes de Contatar o Suporte:
Reúna estas informações:
- Descrição do problema e quando começou
- Mensagens de erro dos Logs da Aplicação
- Dispositivos afetados (nomes/IPs)
- Alterações recentes de configuração
- Versão do RAN Monitor e SO
Contato:
Para assistência com o RAN Monitor:
- Suporte da Omnitouch Network Services
- Inclua as informações de diagnóstico reunidas
- Forneça arquivos de configuração (sanitizar senhas)
- Inclua trechos relevantes dos logs
Autoatendimento:
- Pesquise no Guia de Solução de Problemas
- Verifique os Logs da Aplicação para erros específicos
- Revise alterações recentes de configuração
- Teste a conectividade e a funcionalidade básica
- Consulte guias de documentação relevantes