Relatórios
Gere relatórios das CPEs TR-069 (sinal RX, clientes sem TR-069, quantidade de CPEs, dispositivos conectados e score), com download em PDF e CSV.
Relatórios
Menu: TR069 → Relatórios
Gera relatórios analíticos sobre as CPEs TR-069. Cada relatório é processado em segundo plano e fica disponível para visualização e download em PDF e CSV assim que concluído.

A tela tem dois cartões:
- Gerar relatório — um cartão por tipo de relatório, cada um com o botão Gerar.
- Relatórios gerados — o histórico dos relatórios já processados.
Tipos de relatório
| Tipo | Parâmetro | O que contém |
|---|---|---|
| CPEs com sinal RX acima de X | Sinal RX maior que (dBm) — padrão -25 | CPEs ópticas com a leitura de sinal RX: Serial, PPPoE, Fabricante, Modelo, IP WAN, Sinal RX (dBm) e Último inform. Ordenado do melhor para o pior sinal. |
| Clientes sem TR-069 | Integração (banco RADIUS) — padrão Todas as integrações | Clientes com sessão online no RADIUS que não têm CPE gerenciada por TR-069. Colunas: Usuário PPPoE, IP da sessão, MAC, NAS, Conectado desde e Integração. |
| Quantidade de CPEs | Agrupar por — Fabricante e modelo (padrão), Fabricante ou Modelo | Quantidade de CPEs da base por grupo e o % do total, do grupo mais numeroso para o menor. O cabeçalho do PDF mostra o total de CPEs e o total de grupos. |
| Clientes com mais dispositivos conectados | Quantidade de clientes (top N) — padrão 50, máximo 1000 | Ranking dos clientes pelo número de dispositivos conectados na CPE: PPPoE, Serial, Fabricante, Modelo, Dispositivos conectados, Cabeados, Wi-Fi e Analisado em. |
| Clientes com score abaixo de X | Score abaixo de — padrão 60 | Clientes cuja última análise de saúde ficou abaixo do valor: PPPoE, Serial, Fabricante, Modelo, IP WAN, Score, Saúde e Analisado em. Do pior score para o melhor. |
No relatório CPEs com sinal RX acima de X, o filtro devolve as CPEs cujo RX é menor que o valor informado, ou seja, com sinal mais fraco. Com -25, por exemplo, o relatório lista as CPEs com RX abaixo de -25 dBm (-26, -28…). Use o relatório para encontrar clientes com sinal óptico ruim.
Como funciona o relatório "Clientes sem TR-069"
O relatório cruza as sessões online das integrações RADIUS do Graph (veja Integrações RADIUS) com a base do ACS. Uma sessão é considerada com TR-069 quando o IP da sessão coincide com o IP WAN de uma CPE ou quando o usuário PPPoE coincide com o PPPoE de uma CPE. As demais entram no relatório, uma linha por cliente.
- Escolha uma integração específica ou Todas as integrações.
- Se o ACS não retornar nenhuma CPE, ou se a integração não tiver nenhuma sessão online, o relatório falha em vez de gerar uma lista falsa.
De onde vêm os dados
| Relatório | Fonte |
|---|---|
| Sinal RX, Clientes sem TR-069, Quantidade de CPEs | Base de CPEs do ACS (GenieACS). A contagem por fabricante e modelo usa a mesma regra do Dashboard. |
| Dispositivos conectados, Score abaixo de X | Última análise de saúde de cada CPE, a mesma exibida no detalhe do CPE. CPEs nunca analisadas não aparecem. |
Como gerar um relatório

- No cartão do tipo desejado, clique em Gerar.
- Confira o Nome do relatório. O nome vem preenchido com o tipo e a data, e pode ser alterado.
- Preencha os parâmetros do tipo.
- Clique em Gerar. O relatório entra na fila e a lista é atualizada sozinha enquanto ele é processado.
Relatórios gerados

| Coluna | Descrição |
|---|---|
| Nome | Nome dado na geração. |
| Tipo | Tipo de relatório. |
| Status | Situação do processamento. |
| Registros | Quantidade de linhas do relatório. |
| Criado em | Data e hora da criação. |
| Ações | Visualizar PDF, Baixar PDF, Baixar CSV e Excluir. |
| Status | Significado |
|---|---|
| Na fila | Aguardando processamento. |
| Processando | Em geração, com barra de progresso. |
| Concluído | Pronto para visualizar e baixar. |
| Falhou | Não foi possível gerar. O motivo aparece logo abaixo do status. |
| Parcial (só CSV) | O CSV foi gerado, mas o PDF não. |
Use os filtros de status e de tipo e o botão Atualizar para localizar um relatório.
Visualizar e baixar
Clique em um relatório concluído (ou no ícone de olho) para abrir a prévia do PDF, com o botão Baixar PDF.

- PDF — cabeçalho com totais e parâmetros usados, e a tabela do relatório.
- CSV — separado por
;, para abrir em planilha.
Os títulos das colunas do PDF e do CSV saem no idioma da interface no momento da geração.
Permissões necessárias
| Ação | Permissão |
|---|---|
| Acessar a tela, gerar, visualizar, baixar e excluir relatórios | cpe.reports.view |
cpe.reports.view é independente de cpe.view: um usuário pode ter acesso só aos relatórios, sem acesso à lista de dispositivos.