KEPLIN Docs

O que o Radar mede

O minitab Radar de cada app, a árvore de Ecrãs, APIs e scripts e Sessões, a janela de tempo, e a Observabilidade que junta todas as apps.

O Radar é a app vista de dentro, enquanto está a ser usada. Não é um relatório que se corre no fim do mês: é o que a aplicação está a fazer agora — que APIs foram chamadas, quanto tempo demoraram, que ecrãs rebentaram, que pessoas entraram e o que fizeram até ao ponto onde alguma coisa correu mal.

Existe em dois sítios, e a diferença entre eles é só de altitude:

Onde O que responde
O minitab Radar, dentro de uma app "O que se passa nesta app?"
O menu Observabilidade, na barra lateral "O que se passa em todas as apps, e na plataforma?"

O minitab Radar

Abre uma app, no Dashboard ou na barra lateral, e clica em Radar, o último dos minitabs da barra da app (a seguir a UI, Código, Dados e Testes). A barra passa a mostrar a árvore do Radar; o espaço à direita mostra o painel do que escolheres.

O minitab Radar, com a árvore de Ecrãs, APIs e scripts e Sessões
O minitab Radar, com a árvore de Ecrãs, APIs e scripts e Sessões

No topo da árvore há dois controlos que valem para tudo o que está abaixo:

  • O selector de período — Última hora, Últimas 24 horas, Últimos 7 dias ou Tudo. É ele que decide o que a árvore conta.
  • O botão Actualizar, que relê sem mudar o período.

O selector de período e o botão Actualizar, no topo da árvore do Radar
O selector de período e o botão Actualizar, no topo da árvore do Radar

Por baixo, a caixa Filtrar… reduz a árvore ao que corresponder ao que escreveres.

Nota

Uma secção vazia diz sempre porquê. "Nada no período escolhido." é o período a apertar, não uma avaria — alarga para Tudo antes de concluir que não há dados.

Todas as versões da app

O Radar mostra o que aconteceu em todas as versões da app que têm dados, e não só na versão em que estás a trabalhar. Os erros das pessoas que usam a app acontecem na versão publicada, e é aí que quem a corrige os tem de ver.

  • Na árvore, um problema, uma API, um script ou uma sessão de outra versão leva o nome dela no fim, por exemplo Gravar encomenda · 1.2.
  • Ao abrir um desses itens, o painel abre nessa versão, com o crachá Versão 1.2.
  • O que acontece na tua versão de trabalho aparece sem nome de versão.

As três secções da árvore

Ecrãs

Os erros que nasceram no código que tu escreveste nos eventos dos ecrãs e dos widgets. É a secção onde há alguma coisa a corrigir do teu lado, e por isso vem primeiro.

Cada linha é um ecrã; abre-o e vês os erros dele, agrupados pela causa, com o número de vezes que aconteceram. Sem erros nenhuns, a secção diz "Nenhum erro no código que escreveste."

A secção Ecrãs da árvore do Radar, sem erros no código da app
A secção Ecrãs da árvore do Radar, sem erros no código da app

O ⓘ ao lado do título repete o critério: "Erros que nasceram no código que escreveste nos eventos dos widgets e dos ecrãs. Estes podes corrigir."

APIs e scripts

As chamadas às APIs da app e as execuções dos scripts, com as falhas agrupadas pela causa. Cada linha traz o nome e um resumo — quantas chamadas, e a média de tempo. Um número a vermelho ao fim da linha são falhas.

Clica numa linha para abrir o painel dela (é o assunto da página seguinte deste capítulo).

Sessões

Cada visita à app: quem entrou, quando, e o que correu mal. As linhas são as sessões, identificadas pela hora e por quem entrou — 23:11 · demo —, ou só pela hora quando a visita foi anónima.

A secção Sessões expandida, com uma linha por visita à app
A secção Sessões expandida, com uma linha por visita à app

É o eixo temporal do Radar: as outras secções contam o quê, as sessões contam por que ordem.

Da plataforma

Existe uma quarta secção, que só aparece quando há o que mostrar: Da plataforma. São erros internos do runtime — "não vêm do teu código", diz a ajuda. Aparecem recolhidos, no fim, porque não há nada a corrigir do teu lado; vale a pena reportá-los com a Referência que o painel mostra.

A Observabilidade: todas as apps de uma vez

Clica em Observabilidade na barra lateral esquerda, na zona de administração. É a mesma matéria vista de cima, com uma barra de secções por baixo do cabeçalho: Visão geral, Problemas, Eventos, Estado e Auditoria.

A Visão geral da Observabilidade: pedidos, taxa de erro, resposta e problemas abertos
A Visão geral da Observabilidade: pedidos, taxa de erro, resposta e problemas abertos

O topo tem um selector de período comum a todas as secções — 1h, 6h, 24h, 7d, 30d e Tudo — mais Exportar (em CSV ou JSON) e Actualizar.

A Visão geral abre com cinco números:

Cartão O que conta
Pedidos Quantas chamadas houve no período, e o ritmo por minuto.
Taxa de erro A percentagem de chamadas falhadas, e quantas falhas foram.
Resposta (p95) O tempo abaixo do qual ficaram 95% das chamadas, com a mediana ao lado.
Problemas abertos Erros agrupados que ainda ninguém resolveu.
Scripts Execuções de scripts, e quantas falharam.

Por baixo, o gráfico Actividade operacional e a tabela Apps — uma linha por app, com tráfego, pedidos, erros, mediana, p95, problemas por resolver e scripts. Clica no nome de uma app para ver só os eventos dela.

As outras secções da Observabilidade

Secção O que lá está
Problemas Erros de runtime agrupados: um problema, com todas as ocorrências dele. Cada um tem estado — aberto, resolvido, ignorado.
Eventos Uma linha por execução — APIs, scripts e sistema —, incluindo as que correram bem.
Estado A saúde da instalação: fila do índice, agendador, notificações, retenção, disco livre e as ligações a bases de dados de cada app.
Auditoria As alterações administrativas e de configuração: quem criou, alterou, apagou ou executou o quê.

A secção Estado: fila, agendador, notificações, retenção e espaço, por app
A secção Estado: fila, agendador, notificações, retenção e espaço, por app

Dica

Quando alguém diz "a aplicação está lenta", começa pela Visão geral com o período em 24h: se a Resposta (p95) está alta e a Taxa de erro baixa, o problema é de desempenho e não de avaria — e a tabela Apps diz-te logo qual delas.

Quanto tempo os registos ficam

Os registos não crescem para sempre: cada app tem uma rotação de registos nas definições dela, que diz quantos dias guardar de cada tipo. A secção Estado mostra se a rotação está ligada e em quantas apps.

Atenção

Um problema que já não aparece pode ter sido levado pela rotação. O painel dele di-lo com todas as letras: "Este problema já não existe — a rotação de registos pode tê-lo levado." Se precisas de guardar mais tempo, é nas definições da app que se muda.

Porque não vejo…?

  • …nada na árvore do Radar? O período. Passa o selector para Tudo — uma app pouco usada não tem tráfego na última hora.
  • …o minitab Radar? Estás fora de uma app. O Radar é por app; a versão global é o menu Observabilidade.
  • …números na Visão geral, mesmo com a app a ser usada? O índice de observabilidade pode estar desligado nas Definições da plataforma — nesse caso, a secção Estado avisa que "os ecrãs mostram dados velhos".
  • …o menu Observabilidade? É um menu de administração. Com perfil de developer não aparece.