Dashboards — fundamentos, criação e ciclo de vida

Dashboards transformam eventos do seu app em indicadores, tendências e comparações visuais. Este guia explica como a biblioteca, o editor e os estados de um dashboard se conectam.

Para escolher métricas, dimensões e gráficos, consulte Painéis, métricas, dimensões e visualizações [blocked]. Para períodos, filtros e resultados, consulte Períodos, filtros, ordenação e resultados [blocked].

Dashboard e painel têm responsabilidades diferentes

Um dashboard é uma visão salva. Ele possui nome, descrição, estado e uma coleção ordenada de painéis.

Um painel responde uma pergunta analítica. Cada painel escolhe:

• uma combinação exata de nome e versão de evento;
• uma métrica;
• um período;
• nenhuma, uma ou duas dimensões compatíveis;
• filtros opcionais;
• uma visualização;
• a ordenação e o limite do resultado;
• o formato de exibição do valor e a posição no canvas.

Os painéis são independentes. Um erro ao consultar um deles não transforma automaticamente os demais em erro.

O catálogo orienta a criação

O editor começa pelo catálogo de eventos do app. Os eventos aparecem agrupados por nome, com suas versões, descrição, tags, estado e modo de validação.

Depois da escolha do evento e da versão, o editor carrega as propriedades observadas em properties e context. Para cada propriedade, o catálogo informa o tipo, amostras seguras, quantidade de amostras, período em que foi observada e se pode ser usada em agrupamentos.

O catálogo confirma que um campo foi observado. Ele não garante que o campo estará presente em todas as ocorrências futuras. A definição do evento continua sendo a referência para campos obrigatórios e tipos esperados. Veja Eventos, definições e propriedades.

Como criar um dashboard

1. Abra a biblioteca de dashboards e escolha Criar dashboard.
2. Adicione um painel e selecione o nome e a versão do evento.
3. Escolha a pergunta: contar ocorrências, calcular um valor ou contar valores diferentes.
4. Quando necessário, selecione a propriedade e o método de cálculo.
5. Organize o resultado como total do período ou série temporal. Acrescente uma divisão por propriedade quando o catálogo permitir.
6. Escolha uma visualização compatível e, se fizer sentido, um formato para o valor.
7. Use filtros, ordenação e limite para refinar o resultado.
8. Conclua o painel e confira a prévia.
9. Informe um nome para o dashboard. A descrição é opcional, mas ajuda outras pessoas a entender o objetivo da análise.
10. Salve o dashboard.

O editor exige ao menos um painel e um nome preenchido antes de salvar. O nome pode ter até 120 caracteres. A descrição pode ter até 2.000 caracteres.

Configuração inicial de um painel

Ao escolher um evento, o novo painel começa com:

No visualizador, o período global começa em Últimos 7 dias e substitui o período próprio de todos os painéis naquela consulta.

Trocar o evento revisa o painel

Um campo pertence à combinação de nome e versão do evento. Por isso, trocar o evento reinicia métrica, dimensões, filtros, visualização e ordenação para valores compatíveis.

O editor preserva o período, o limite e o layout do painel. Antes de concluir a configuração, você pode cancelar para recuperar a versão anterior.

Editar, duplicar e organizar painéis

O editor permite:

• abrir e alterar a configuração de um painel;
• duplicar um painel com métrica, dimensões, filtros, visualização e formato;
• remover um painel do rascunho atual;
• reposicionar e redimensionar painéis no canvas;
• mover painéis antes ou depois na ordem do dashboard.

Alterações de layout e formato de valor mudam a apresentação. Elas não mudam quais eventos participam do cálculo.

Ao sair com alterações não salvas, a interface pede confirmação. Remover um painel também só se torna persistente quando o dashboard é salvo.

Estados do dashboard

Um dashboard nasce como rascunho. Somente um rascunho pode ser publicado. Publicar preserva nome, descrição, painéis e layout; apenas muda o estado e a versão do registro.

Arquivar é a remoção observável do produto. Depois do arquivamento, o dashboard deixa de aparecer na biblioteca e passa a responder como não encontrado nas consultas normais. O fluxo atual não oferece restauração pela interface.

Concorrência ao editar

Cada alteração persistida incrementa a versão do dashboard. Ao salvar, publicar ou arquivar, o PrismaFlow confere se a versão aberta ainda é a atual.

Se outra pessoa alterou o dashboard antes, a operação é recusada para não sobrescrever silenciosamente o trabalho mais recente. No editor, você pode carregar a versão atual ou manter seu rascunho local para revisar as diferenças.

Nomes e busca na biblioteca

Dois dashboards não podem ter o mesmo nome no mesmo app enquanto estiverem como rascunho ou ativo. Espaços nas extremidades e diferenças entre maiúsculas e minúsculas não tornam o nome diferente.

A biblioteca:

• não mostra dashboards arquivados;
• ordena os itens pelos atualizados mais recentemente;
• busca por uma parte do nome sem diferenciar maiúsculas de minúsculas;
• mostra estado, última atualização, quantidade de painéis e tipos de visualização.

Acesso por capacidade

O acesso a dashboards é dividido por capacidade. Uma pessoa pode, por exemplo, consultar a biblioteca e os painéis sem poder criar, editar, publicar ou arquivar.

As capacidades são separadas para:

• listar dashboards;
• abrir um dashboard;
• consultar os dados dos painéis;
• consultar o catálogo e validar configurações;
• criar ou editar;
• publicar;
• arquivar.

Quando a consulta de dados não está permitida, a estrutura do dashboard ainda pode estar disponível para quem possui acesso de leitura, mas os painéis não exibem os resultados analíticos.

Assuntos relacionados

• Painéis, métricas, dimensões e visualizações [blocked]
• Períodos, filtros, ordenação e resultados [blocked]
• Referência do contrato de dashboards [blocked]
• Eventos, definições e propriedades