15. Guia dos Gráficos
Para cada gráfico você verá: (a) o que mostra, (b) como ler eixos/cores, (c) como interpretar na prática e (d) um exemplo com números fictícios.
15.1 Rosca de Saúde da Planta (plantDonut)
Onde: Dashboard (e card de saúde de ONUs). Tipo: gráfico de rosca.
(a) O que mostra: como as ONUs estão distribuídas entre os seis estados de saúde.
(b) Como ler: cada fatia é um estado, com a cor padrão do sistema:
| Cor | Fatia |
|---|---|
| 🟢 Verde | OK |
| 🟡 Âmbar | Atenção |
| 🔴 Vermelho | Crítico |
| ⚪ Cinza | Offline |
| 🟠 Laranja | LOS |
| 🟣 Roxo | DyingGasp |
No centro aparece a Saúde % da planta (percentual de ONUs OK). A legenda abaixo traz contagem e percentual de cada estado.
(c) Como interpretar: quanto mais verde, melhor. Uma fatia vermelha ou laranja crescendo é o primeiro sinal de problema em campo. Cinza grande costuma indicar ONUs desligadas ou sem coleta.
(d) Exemplo:
Total de ONUs: 1.000
🟢 OK: 920 (92%)
🟡 Atenção: 40 (4%)
🔴 Crítico: 20 (2%)
⚪ Offline: 15 (1,5%)
🟠 LOS: 3 (0,3%)
🟣 DyingGasp: 2 (0,2%)
→ Centro mostra: Saúde 92%
Leitura: planta saudável, mas as 20 ONUs críticas + 3 em LOS merecem atenção hoje.
15.2 Histograma de Sinal Óptico (signalHist)
Onde: Dashboard, card "Qualidade óptica (RX)". Tipo: barras (histograma).
(a) O que mostra: quantas ONUs caem em cada faixa de potência de sinal recebido (RX).
(b) Como ler: o eixo X são faixas de dBm; o eixo Y é a quantidade de ONUs. As barras seguem as cores de saúde (verde nas faixas boas, âmbar/vermelho nas ruins, cinza para "sem leitura"):
| Faixa de RX | Classe |
|---|---|
| ≥ −15 dBm | OK |
| −20 a −15 | OK |
| −25 a −20 | OK |
| −27 a −25 | Atenção |
| < −27 | Crítico |
| sem leitura | Offline |
(c) Como interpretar: o "monte" de barras deve ficar do lado bom (esquerda/centro). Se
muitas ONUs aparecem nas faixas < −27 ou −27 a −25, há um problema óptico afetando
vários clientes — possivelmente numa mesma porta PON ou trecho de fibra.
(d) Exemplo:
≥ −15 dBm: 50 ONUs 🟢
−20 a −15: 400 ONUs 🟢
−25 a −20: 480 ONUs 🟢
−27 a −25: 45 ONUs 🟡
< −27: 20 ONUs 🔴
sem leitura: 5 ONUs ⚪
Leitura: a maioria está saudável. As 20 ONUs em < −27 são as candidatas a visita técnica.
15.3 Tráfego Agregado da Planta (trafficChart)
Onde: Dashboard, card "Tráfego agregado da planta (24h)". Tipo: gráfico de área (2 séries).
(a) O que mostra: o tráfego total da planta nas últimas 24 horas, separando download e upload.
(b) Como ler: o eixo X é o tempo (em janelas de 30 minutos); o eixo Y é a taxa em bits por segundo (o sistema formata para Kbps/Mbps/Gbps). Duas áreas preenchidas:
- Download (OUT) — ciano: dados que vão da rede para os clientes.
- Upload (IN) — azul: dados que vão dos clientes para a rede.
O título mostra os picos de download e upload do período.
(c) Como interpretar: procure o formato esperado (mais movimento à noite, no horário de pico residencial). Quedas bruscas a zero podem indicar falha de coleta ou de enlace; um platô reto no topo pode indicar saturação de capacidade.
(d) Exemplo:
Pico de download (OUT): 8,4 Gbps (às 21h30)
Pico de upload (IN): 1,2 Gbps (às 21h00)
Vale de madrugada (03h): ~1,1 Gbps download
Leitura: comportamento típico de planta residencial — pico noturno, vale de madrugada.
Saiba mais: este gráfico soma taxas instantâneas de muitas portas. Ele serve para ver tendência, não para fechar conta de faturamento. Veja o cálculo em Tráfego agregado da planta.
15.4 Saúde do Servidor (serverHealthChart)
Onde: Dashboard, painel "Saúde do servidor". Tipo: linhas.
(a) O que mostra: o uso de CPU, memória e disco do servidor do i‑Lumen ao longo do tempo (cerca da última hora).
(b) Como ler: eixo X = tempo (últimas ~60 leituras, 1 por minuto); eixo Y = percentual (0–100%). Três linhas, identificadas na legenda acima do gráfico por chips coloridos: CPU, MEM (memória) e DISCO. O gráfico ocupa todo o quadro.
(c) Como interpretar: picos ocasionais são normais durante coletas. CPU ou memória presas perto de 100% por muito tempo indicam que o servidor está sobrecarregado — pode atrasar coletas e deixar dados velhos.
(d) Exemplo:
CPU média: 35% (picos de 70% durante a coleta das 14h)
Memória: 58% (estável)
Disco: 61% (estável)
Leitura: servidor folgado, sem sinal de sobrecarga.
Acompanhar as execuções de coleta: para ver o que rodou, quando e se falhou, use o Mapa de Execução de Processos no Monitor Global — ele mostra, por OLT, a linha do tempo das coletas/descobertas das últimas horas.
15.5 Status por ONU (statusChart)
Onde: Estrutura ONU, modal "Status por ONUs". Tipo: barras horizontais.
(a) O que mostra: a contagem de ONUs por estado de saúde, dentro do escopo filtrado (empresa/localidade/OLT selecionada).
(b) Como ler: eixo Y = estados (OK, atenção, crítico, offline, LOS, DyingGasp); eixo X = nº de ONUs. Cores de saúde padrão.
(c) Como interpretar: é o "raio‑x" da OLT escolhida. Barras vermelha/laranja grandes concentradas numa OLT apontam um problema localizado naquela OLT ou porta.
(d) Exemplo:
🟢 OK: 180
🟡 Atenção: 12
🔴 Crítico: 6
⚪ Offline: 4
🟠 LOS: 2
Leitura: nesta OLT, 8 ONUs (crítico + LOS) precisam de ação.
15.6 Tráfego da ONU (onuTrafficChart)
Onde: Estrutura ONU, modal de histórico da ONU. Tipo: linha/área (período configurável).
(a) O que mostra: o tráfego daquela ONU específica no período escolhido (12h a 30d), agregado por hora (janelas ≤48h) ou por dia (janelas maiores).
(b) Como ler: eixo X = tempo (média por balde); eixo Y = bits por segundo. Duas séries: IN (upload, azul) e OUT (download, ciano). O resumo mínimo/médio/máximo abaixo do gráfico acompanha o período selecionado.
(c) Como interpretar: útil para reclamações de cliente. Tráfego que cai a zero num dia e não volta sugere que a ONU ficou offline. Tráfego sempre muito baixo pode indicar que o cliente mal usa o serviço — ou que há um problema de enlace.
(d) Exemplo:
Média OUT (download): ~120 Mbps nos dias úteis
Média IN (upload): ~15 Mbps
Dia 12: caiu a 0 → bateu com um alerta de LOS no mesmo dia
Leitura: a queda do dia 12 confirma o evento de fibra rompida registrado.
15.7 Sinal Downstream (downSignalChart)
Onde: Estrutura ONU, modal de histórico da ONU. Tipo: linha (período configurável).
Figura 6 — Como ler o gráfico: a faixa verde é o sinal saudável; a linha caindo com a atenuação subindo indica fibra degradando.
(a) O que mostra: a potência óptica no sentido OLT → ONU ao longo do período escolhido (12h a 30d), mais a atenuação desse caminho. Abaixo dos gráficos de sinal, a linha do tempo de saúde resume o RX da ONU por intervalo (verde/amarelo/vermelho/cinza).
(b) Como ler: eixo X = tempo (por hora ou por dia, conforme a janela); eixo Y = dBm. Linhas:
- RX da ONU (
down_rx_pwr_onu): o que a ONU recebe. - TX da OLT (
down_tx_pwr_olt): o que a OLT transmite. - Atenuação (
down_tx_pwr_olt − down_rx_pwr_onu): a perda no caminho.
(c) Como interpretar: a linha de RX deve ficar estável na faixa boa (acima de −25 dBm). Uma queda gradual do RX ao longo dos dias (e atenuação subindo) indica fibra degradando — conector sujo, emenda ruim, curvatura. Ótimo para agir antes de o cliente cair.
(d) Exemplo:
Dia 1: RX −22 dBm | TX OLT +3 dBm | Atenuação 25 dB
Dia 15: RX −24 dBm | TX OLT +3 dBm | Atenuação 27 dB
Dia 30: RX −28 dBm | TX OLT +3 dBm | Atenuação 31 dB 🔴
Leitura: perda subindo ~6 dB no mês → degradação progressiva; agendar manutenção preventiva.
15.8 Sinal Upstream (upSignalChart)
Onde: Estrutura ONU, modal de histórico da ONU. Tipo: linha (período configurável).
(a) O que mostra: a potência óptica no sentido ONU → OLT no período escolhido (12h a 30d), mais a atenuação desse caminho.
(b) Como ler: igual ao downstream, mas no outro sentido. Linhas:
- TX da ONU (
up_tx_pwr_onu): o que a ONU transmite. - RX da OLT (
up_rx_pwr_olt): o que a OLT recebe daquela ONU. - Atenuação (
up_tx_pwr_onu − up_rx_pwr_olt).
(c) Como interpretar: se o upstream está ruim mas o downstream está bom (ou vice‑versa), isso ajuda a localizar o problema. Um upstream muito atenuado pode degradar a conexão mesmo com downstream aparentemente ok.
(d) Exemplo:
TX ONU +2 dBm | RX OLT −24 dBm | Atenuação 26 dB
Leitura: dentro do esperado; problema (se houver) não está no caminho de subida.