------------------------------------------------
===== Network Metrics =====
{{:captura_de_tela_2026-08-26_154356.png?1000|}}
A tela **Network Metrics**, disponível no menu **Dashboard**, é utilizada para acompanhar a qualidade das comunicações de rede realizadas pelos dispositivos integrados ao sistema da Megauê.
Por meio dessa tela é possível analisar a quantidade de chamadas realizadas, taxa de sucesso, tempo de resposta, erros registrados e o comportamento das chamadas de acordo com o **provider**, **tipo de rede** e **device**.
A tela auxilia principalmente na identificação de problemas de comunicação, lentidão de rede e falhas recorrentes nos dispositivos.
Para acessá-la, vá em **Dashboard -> Network Metrics**
{{:captura_de_tela_2026-08-26_145455.png?400|}}
------------------------------------------------
==== Regra de Negócio ====
Os indicadores apresentados são calculados considerando a **janela de tempo selecionada** e os **filtros aplicados**.
Ao alterar a janela, device, provider ou tipo de rede, os dados apresentados na tela passam a considerar somente as chamadas que correspondem aos critérios selecionados.
Quando nenhuma chamada é encontrada para os filtros informados, os indicadores permanecem zerados e os gráficos exibem mensagens informando que não existem dados na janela selecionada.
------------------------------------------------
==== Filtros ====
Os **filtros** permitem refinar as informações exibidas na tela de métricas, facilitando a investigação de falhas, lentidão ou problemas de comunicação. Eles englobam:
------------------------------------------------
=== Janela ===
Define o período recente que será considerado para a análise das chamadas. As opções disponíveis são:
| **• 5 min** | {{ :captura_de_tela_2026-09-02_145345.png?450|}} |
| **• 10 min** | ::: |
| **• 20 min** | ::: |
| **• 30 min** | ::: |
| **• 60 min** | ::: |
Exemplo: ao selecionar **30 min**, serão consideradas as chamadas registradas dentro da janela dos últimos 30 minutos.
------------------------------------------------
=== Device (serial) ===
Permite pesquisar um dispositivo específico utilizando o seu **número de série**. Esse filtro é útil para investigar problemas apresentados por uma determinada máquina ou dispositivo.
{{:captura_de_tela_2026-09-02_151000.png?360|}}
Quando preenchido, os indicadores e gráficos passam a considerar somente as chamadas relacionadas ao device **pesquisado**.
------------------------------------------------
=== Provider ===
Permite filtrar as chamadas de acordo com o provider responsável pela integração.
Opções disponíveis: **Todos**; **Stone**; **Megauê**.
Ao selecionar **Todos**, são consideradas chamadas de todos os providers disponíveis.
{{:captura_de_tela_2026-08-26_154451.png?350|}}
------------------------------------------------
=== Tipo de rede ===
Permite analisar as chamadas conforme o tipo de conexão utilizada pelo dispositivo.
Opções disponíveis: **Todos**; **Mobile**; **Wi-Fi**
Esse filtro permite verificar, por exemplo, se determinados problemas estão concentrados em dispositivos utilizando rede móvel ou Wi-Fi.
{{:captura_de_tela_2026-08-26_154459.png?350|}}
------------------------------------------------
==== Indicadores Gerais ====
Na parte superior da tela são apresentados **quatro** indicadores principais:
------------------------------------------------
=== Total de chamadas ===
Apresenta a quantidade total de chamadas encontradas dentro da janela de tempo e dos filtros selecionados.
{{:captura_de_tela_2026-09-02_153845.png?300|}}
------------------------------------------------
=== Taxa de sucesso ===
Apresenta, em percentual, a proporção de chamadas consideradas bem-sucedidas pelo monitoramento. De forma geral:
|Taxa de sucesso = Chamadas com sucesso / Total de chamadas × 100|
Uma redução nesse indicador pode sinalizar problemas de comunicação, integração ou conectividade.
{{:captura_de_tela_2026-09-02_153849.png?300|}}
------------------------------------------------
=== Duração média ===
Apresenta o tempo médio de duração das chamadas realizadas. O valor é apresentado em **milissegundos (ms)**.
Esse indicador permite acompanhar o tempo médio de resposta das comunicações.
{{:captura_de_tela_2026-09-02_153853.png?300|}}
------------------------------------------------
=== P95 de duração ===
Apresenta o **percentil 95 da duração das chamadas**. Isso significa que aproximadamente 95% das chamadas possuem duração igual ou inferior ao valor apresentado.
O P95 é importante para identificar situações em que a média permanece normal, mas parte das chamadas apresenta lentidão elevada. Exemplo:
Se o P95 for **2.000 ms**, significa que aproximadamente 95% das chamadas foram concluídas em até 2 segundos.
{{:captura_de_tela_2026-09-02_153857.png?300|}}
------------------------------------------------
=== Por integração (provider) ===
Essa área apresenta a distribuição das chamadas de acordo com o **provider** utilizado. Permite comparar o comportamento das integrações e identificar se falhas ou alterações na quantidade de chamadas estão relacionadas a um provider específico.
Quando não existem chamadas para os filtros utilizados, é apresentada a mensagem: **Sem chamadas na janela selecionada**.
{{:captura_de_tela_2026-09-02_163802.png?400|}}
------------------------------------------------
=== Por tipo de rede ===
Apresenta a distribuição das chamadas de acordo com o tipo de conexão utilizada pelo dispositivo. Permite comparar principalmente chamadas realizadas através de: **Mobile** ou **Wi-Fi**. Essa informação pode ajudar a identificar se problemas de comunicação estão associados ao tipo de rede utilizado.
Quando não existem registros, é apresentada a mensagem: **Sem chamadas na janela selecionada**.
{{:captura_de_tela_2026-09-02_163809.png?400|}}
------------------------------------------------
=== Erros mais frequentes ===
A seção **Erros mais frequentes** apresenta os erros que mais ocorreram dentro do período e dos filtros selecionados.
São considerados os **10 tipos de erro mais frequentes**, ordenados conforme a quantidade de ocorrências. Essa informação facilita a identificação de falhas recorrentes e ajuda a direcionar a investigação do problema.
Quando nenhum erro é encontrado, é apresentada a mensagem: **Nenhum erro registrado na janela selecionada**
{{:captura_de_tela_2026-09-02_165043.png?450|}}
------------------------------------------------
=== Série temporal ===
A seção **Série temporal** permite acompanhar o comportamento das chamadas ao longo do período selecionado.Os dados são agrupados em intervalos de: **2 minutos** (bucketSeconds = 120)
Dessa forma, cada ponto da série representa as informações consolidadas de um intervalo de 2 minutos. Essa visualização é útil para identificar:
* momentos de aumento ou redução das chamadas;
* períodos com maior ocorrência de falhas;
* alterações na taxa de sucesso;
* possíveis picos de lentidão;
* mudanças de comportamento durante a janela analisada.
Quando não existem informações suficientes, é apresentada a mensagem: **Sem dados na janela selecionada**
{{:captura_de_tela_2026-09-02_165714.png?400|}}
------------------------------------------------
=== Análise por Device ====
A tela também realiza a análise dos devices que possuem quantidade suficiente de chamadas dentro da janela e dos filtros selecionados. Para que um device seja considerado nessa análise, ele deve possuir **pelo menos 3 chamadas** no período analisado.
Caso nenhum dispositivo atenda a esse critério, é apresentada a mensagem: **Nenhum device com pelo menos 3 chamadas nessa janela/filtro** Essa regra evita realizar análises comparativas utilizando dispositivos com quantidade muito pequena de chamadas.
{{:captura_de_tela_2026-09-02_170835.png?600|}}
------------------------------------------------
==== Como utilizar ====
Para realizar uma análise:
* Selecione a **janela de tempo** desejada.
* Caso necessário, informe o **serial do device** que deseja investigar.
* Selecione o **Provider** ou mantenha **Todos**.
* Selecione o **Tipo de rede** ou mantenha **Todos**.
* Analise os indicadores de **Total de chamadas**, **Taxa de sucesso**, **Duração média** e **P95 de duração**.
* Verifique a distribuição por **provider** e **tipo de rede**.
* Consulte os **erros mais frequentes**.
* Utilize a **série temporal** para identificar em qual momento ocorreram alterações ou falhas.
* Caso esteja investigando dispositivos específicos, verifique os devices que possuem quantidade suficiente de chamadas para análise.
------------------------------------------------
==== Exemplo de Investigação ====
Caso um dispositivo esteja apresentando lentidão ou dificuldades de comunicação, uma possível análise é:
* Selecionar uma janela recente, como **30 minutos**;
* Pesquisar o **serial do device**;
* Verificar a **Taxa de sucesso**;
* Analisar a **Duração média** e o **P95**;
* Verificar os **Erros mais frequentes**;
* Comparar o comportamento de acordo com o **Provider**;
* Verificar se a conexão utilizada é **Mobile** ou **Wi-Fi**;
* Consultar a **Série temporal** para identificar quando o problema ocorreu.
------------------------------------------------
==== Atenção ====
* Todos os indicadores dependem da **janela de tempo e dos filtros selecionados**.
* Um valor zerado não significa necessariamente que existe uma falha. Pode significar que **nenhuma chamada foi registrada** para os filtros informados.
* Utilize o filtro de **Device (serial)** quando for necessário investigar uma máquina específica.
* Utilize os filtros de **Provider** e **Tipo de rede** para comparar possíveis diferenças de comportamento entre integrações e conexões.
* A **Duração média** deve ser analisada juntamente com o **P95**, pois chamadas pontualmente lentas podem não causar uma alteração significativa na média.
* A análise específica de devices considera apenas equipamentos com **pelo menos 3 chamadas** dentro da janela e dos filtros utilizados.
------------------------------------------------