📘 i-Lúmen · Manual do Usuário v0.4.0
← App

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).

Anatomia do gráfico de sinal downstream

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.

↑ Voltar ao sumário