¶ 🧭 Qualificação da Rede – RobotViabilityTask
Este documento descreve o processo completo de Qualificação da Rede Legada, utilizando robôs de viabilidade (RobotViabilityTask), para preparação e posterior execução de robôs TR-069.
¶ 🎯 Objetivo da Qualificação
A Qualificação da Rede tem como finalidade:
- Identificar equipamentos ativos na base legada
- Mapear modelos de roteadores/APs
- Verificar acesso remoto à interface WAN/Internet do CPE via portas WEB
- Avaliar viabilidade de automação
- Gerar insumos para importação automatizada de devices
¶ 🔁 Visão Geral do Processo
- Criar automação RobotViabilityTask
- Executar a qualificação
- Analisar resultados
- Trabalhar logs e consolidar dados para execução dos robôs TR-069
¶ ⚙️ 1️⃣ Criar Automação – RobotViabilityTask
A qualificação inicia com o cadastro de uma nova RobotViabilityTask no portal.
¶ 🔧 Parâmetros da Automação
| Campo | Descrição |
|---|---|
| Nome | Identificador da qualificação (ex: QUALIFICACAO_REDE_70K). |
| Port list | Portas WEB separadas por vírgula (ex: 80,443,8080). |
| Ordem Aleatória de Tarefas | Gera uma execução com ordem aleatória dos usuários PPPoEs, evitando sempre a mesma sequência de testes. |
| Redescobrir clientes | Permite reprocessar clientes já qualificados. |
| Selecionar cidade | Permite selecionar as cidades onde a qualificação será executada. |
| Threads | Quantidade de tarefas paralelas (recomendado no máximo 10). |
| Tolerância a falhas | Limite de falhas leves (faults conhecidos – recomendado no máximo 100). |
| Data de início | Configurar a data e o horário de início da task, considerando o fuso horário do navegador. |
| Data de término | Data limite para encerramento da task. |
¶ 📊 2️⃣ Resultado da Qualificação
Após a execução, a tela de resultados apresenta:
- Total de tasks executadas
- Tasks com sucesso
- Tasks com falha ou erro
- Tasks interrompidas
- Informações do agendamento
- Gráficos de resultados
- Tabela com modelos de equipamentos identificados e quantidades
- Logs agrupados por tipo de retorno
¶ 🧾 3️⃣ Mensagens de Logs Agrupadas
| Status | Mensagem do Log | Descrição do Cenário | Ação Recomendada | Responsável |
|---|---|---|---|---|
| ❌ Erro | Error getting client IP. Client_IP Possible down |
O robô não conseguiu obter um IP válido a partir da consulta ao Radius. Cliente possivelmente offline ou sem sessão PPPoE ativa. | Encaminhar ao provedor a lista de PPPoEs afetados para validação. | Provedor |
| ❌ Erro | No open ports found for this IP |
Cliente possui IP ativo, porém nenhuma das portas WEB configuradas está acessível externamente. | Validar firewall, NAT, CGNAT ou políticas de bloqueio. | Provedor |
| ⚠️ Atenção | Unable to correctly identify AP through webpage |
Equipamento acessível, porém modelo não reconhecido pelo qualificador. | Abrir demanda para a INT6 para homologação de novo modelo. | INT6 |
| ✅ Sucesso | Router found |
Equipamento identificado com sucesso e compatível com os qualificadores existentes. | Confirmar modelo e credenciais e preparar para robôs TR-069. | INT6 + Provedor |
¶ 🛠️ 4️⃣ Trabalhando nos Resultados
Após a execução da Qualificação da Rede, a análise dos resultados é obrigatória antes de qualquer automação.
¶ 📥 Acesso ao arquivo de resultados
- Acesse Sistema → Automações
- Selecione a qualificação executada
- Clique em Download CSV
O arquivo é disponibilizado em formato CSV/XLSX, contendo o detalhamento completo da execução.
¶ 📂 Estrutura do arquivo de resultados
| Aba | Conteúdo | Uso Prático |
|---|---|---|
| Tasks | Log completo de todas as tarefas executadas. | Base principal para análise geral e consolidação. |
| Erro ao obter o IP do cliente | Clientes sem IP ativo. | Encaminhar lista ao provedor. |
| Nenhuma porta aberta encontrada | Portas WEB inacessíveis. | Ajuste de firewall/NAT. |
| Incapaz de identificar corretamente | Modelo não reconhecido. | Homologação INT6. |
| Roteador encontrado | Equipamentos válidos. | Execução TR-069. |
| Erros internos | Falhas inesperadas. | Análise pontual. |
¶ 🔎 Como utilizar o arquivo na prática
- Analisar a aba Tasks
- Tratar erros com o provedor e INT6
- Validar modelos identificados
- Consolidar clientes aptos
Quando necessário, o provedor pode executar novas tasks de qualificação após realizar ajustes.
¶ 🚦 Regra de continuidade do processo
Somente após o tratamento e consolidação dos resultados:
Quando cerca de 40% da planta estiver qualificada, o processo pode avançar para a execução dos robôs TR-069.