Dashboards — painéis, métricas, dimensões e visualizações

Um painel combina um evento, uma métrica, dimensões opcionais e uma visualização. Esta página explica todas as combinações aceitas e como escolher cada parte sem mudar o significado da pergunta.

Cada painel consulta um evento

O painel usa uma única combinação de event_name e event_version. Não é possível combinar eventos ou versões diferentes dentro do mesmo painel.

As propriedades disponíveis vêm de duas fontes:

O contrato atual aceita campos diretos com letras, números ou _, com até 64 caracteres. Caminhos aninhados como address.city não são aceitos pelo painel.

Métodos de agregação

p50 é a mediana aproximada pela função de quantil da engine. p90 e p95 ajudam a observar a parte superior da distribuição. Eles não significam “os 90% maiores” ou “os 95% maiores”.

Como valores numéricos são tratados

Soma, média, mínimo, máximo e percentis tentam interpretar a propriedade como número. Valores ausentes, inválidos ou não finitos não entram no cálculo.

Quando uma métrica numérica é consultada, o resultado informa quantos registros foram encontrados e quantos foram ignorados nessa conversão. Um indicador mostra essa qualidade como “registros considerados”.

Contagem e valores únicos não produzem esse resumo de qualidade numérica.

Dimensões disponíveis

Uma dimensão divide o resultado em grupos. O painel aceita no máximo:

• uma dimensão de tempo;
• uma dimensão de propriedade;
• as duas juntas, nessa combinação.

Sem dimensão, a consulta produz um total para todo o período. Com tempo, produz uma série de intervalos. Com propriedade, produz categorias. Com tempo e propriedade, produz uma série separada por categoria.

Não é permitido repetir uma dimensão. A propriedade usada como métrica também não pode ser usada simultaneamente como dimensão no editor.

Quando uma propriedade pode agrupar

O catálogo marca cada propriedade como agrupável ou não agrupável. O agrupamento é bloqueado quando a propriedade:

• foi classificada como de alta cardinalidade;
• passou do limite de 200 valores distintos catalogados;
• possui tipo JSON;
• usa um caminho incompatível com campos diretos.

Alta cardinalidade significa que o campo tende a criar categorias demais, como identificadores únicos, emails ou timestamps. Esse bloqueio protege a legibilidade e o custo da consulta.

Uma propriedade não agrupável ainda pode ser válida para métrica ou filtro quando seu tipo permitir. A restrição se aplica ao uso como dimensão.

Matriz de visualizações

As regras específicas são:

• um indicador não aceita dimensões;
• uma pizza exige exatamente uma dimensão de propriedade e não aceita tempo;
• uma linha exige a dimensão de tempo;
• barras exigem ao menos uma dimensão;
• tabela aceita qualquer forma de dimensão.

Ao alterar dimensões, o editor troca automaticamente uma visualização que deixou de ser compatível. Ele não oferece combinações inválidas na lista.

Como cada visualização apresenta o resultado

Indicador

Mostra a primeira linha do resultado como um único valor. Se não houver ocorrência no período, mostra estado vazio em vez de fabricar uma linha com zero.

O indicador também apresenta o resumo de qualidade para métricas numéricas.

Linha

Usa os intervalos de tempo no eixo horizontal. Quando há uma dimensão de propriedade, cada valor distinto vira uma série.

Categorias sem valor são apresentadas como Sem valor. Os pontos são ordenados cronologicamente para exibição, mesmo que a resposta tenha outra ordenação.

Barras

Sem dimensão de tempo, compara categorias. Com tempo, usa os intervalos no eixo horizontal. Quando tempo e propriedade estão presentes, as séries são empilhadas.

Pizza

Cria uma fatia por categoria, calcula o total das linhas retornadas e mostra a participação percentual de cada fatia. Uma categoria sem valor aparece como Sem valor.

Tabela

Mostra as colunas que existem na configuração:

• período, quando há dimensão de tempo;
• nome da propriedade, quando há dimensão de propriedade;
• valor da métrica.

A tabela representa linhas agregadas, não eventos individuais.

Formato de exibição do valor

O formato é apresentação. Ele não altera o cálculo, o filtro, a ordenação nem o valor retornado pela engine.

O formato é guardado em metadata.value_format. Quando está ausente ou possui um valor desconhecido, a interface usa automatic.

Atualmente, a escolha é aplicada ao indicador e à prévia de indicador. Linha, barras, pizza e tabela continuam exibindo números no formato compacto. O valor calculado permanece o mesmo em todas as visualizações.

Como escolher a combinação

Assuntos relacionados

• Dashboards — fundamentos, criação e ciclo de vida [blocked]
• Períodos, filtros, ordenação e resultados [blocked]
• Referência do contrato de dashboards [blocked]