Criando dashboards

O Dashboard Studio transforma dados do IoT Query em relatórios visuais interativos. Você cria relatórios adicionando painéis a uma tela, escrevendo consultas SQL e organizando os resultados em uma estrutura de menu navegável.

Assista a este vídeo para se familiarizar com a interface do aplicativo Dashboard Studio e aprender como criar seu próprio painel de frota personalizado:

Interface do aplicativo Dashboard Studio, modelos de painel integrados, criação de painéis personalizados.

O que são relatórios

Os relatórios contêm painéis que exibem visualizações de dados. Cada painel executa uma consulta SQL contra seu banco de dados IoT Query, as mesmas camadas Bronze e Silver às quais você acessa por clientes SQL. Você organiza os painéis em uma tela, configura sua aparência e salva o relatório completo no seu menu. O Dashboard Studio atualiza os painéis continuamente para refletir os dados atuais do IoT Query.

Antes de começar

O Dashboard Studio requer acesso ao IoT Query para funcionar. Habilite o IoT Query antes de criar relatórios. Se você ainda não tiver acesso, entre em contato conosco para ativação em [email protected].

O que você pode criar?

O Dashboard Studio fornece cinco tipos de visualização. Cada um funciona melhor para perguntas analíticas específicas.

• Blocos de estatísticas exibem métricas chave únicas, como distância total ou contagem de veículos. Use-os para destacar números críticos no topo do seu relatório.

• Gráficos de barras comparam valores entre categorias ou mostram tendências ao longo do tempo. Eles funcionam bem para comparar a utilização da frota entre regiões ou rastrear viagens por dia.

• Gráficos de pizza mostram como um total se divide em partes. Use-os para exibir consumo de combustível por tipo de veículo ou distribuição de alertas por gravidade.

• Tabelas apresentam registros detalhados com múltiplos atributos. São adequadas para cenários em que os usuários precisam ver registros individuais, como alertas recentes com carimbos de data/hora, IDs de veículos e mensagens.

• Painéis de texto adicionam conteúdo explicativo sem consultar dados. Use-os para instruções, cabeçalhos de seção ou contexto usando formatação Markdown.

Cada tipo de visualização atende a propósitos analíticos específicos. Blocos de estatísticas funcionam bem para KPIs, como tamanho total da frota ou utilização média. Gráficos de barras ajudam a comparar desempenho entre regiões ou rastrear métricas ao longo do tempo. Gráficos de pizza mostram como totais se dividem em categorias, como consumo de combustível por tipo de veículo. Tabelas apresentam registros detalhados quando os usuários precisam ver vários atributos juntos. Painéis de texto adicionam contexto, instruções ou cabeçalhos de seção aos seus relatórios.

Os requisitos de consulta variam conforme o tipo de visualização. Blocos de estatísticas precisam de um valor numérico. Gráficos de barras e pizza exigem exatamente duas colunas: categorias e valores. Tabelas aceitam qualquer número de colunas. Painéis de texto não consultam dados. Para requisitos completos de consulta e exemplos, veja Escrevendo consultas SQL.

Criando relatórios

Vamos percorrer os passos desde uma tela vazia até um painel estruturado e informativo.

Como criar seu primeiro relatório

1

Criar um novo relatório

• Clique no canto inferior esquerdo do aplicativo e selecione Novo relatório.

• Adicionar relatório Título.

• Clique Criar relatório, uma Começar mensagem aparece.

• Selecione Começar com Painel em Branco para abrir uma tela vazia.

2

Adicionar um painel

Agora você pode adicionar seu primeiro painel selecionando um tipo de visualização.

1. Selecione na barra de ferramentas de edição.

2. Escolha Tipo de Painel e clique em Adicionar painel. O novo painel aparece na tela.

3

Configurar o visual

Agora é hora de adicionar as configurações do diagrama:

1. Passe o mouse sobre o bloco e clique em .

2. O Dashboard Studio abre um editor de painel com três abas:

   1. Propriedades do Painel controla o título e o tipo

   2. Consulta SQL define quais dados exibir

   3. Configurações de Visualização ajustam como esses dados aparecem

3. Nomeie seu painel em Propriedades do Painel.

4. Escreva uma consulta SQL que busque dados das tabelas do IoT Query e teste-a para verificar os resultados.

5. Ajuste o Configurações de Visualização.

6. Quando estiver satisfeito, salve o painel para adicioná‑lo à sua tela.

Como escrever consultas SQL eficazes

Agora que você entende o fluxo de trabalho básico, vamos explorar as consultas SQL em detalhe. Escreva consultas PostgreSQL que referenciem as tabelas do IoT Query na aba Consulta SQL. Todas as tabelas das camadas Bronze e Silver estão disponíveis. Teste as consultas antes de aplicá‑las para verificar se os resultados correspondem aos requisitos da visualização.

Os resultados da consulta devem corresponder aos requisitos da visualização. A aba Consulta SQL inclui uma seção "Requisitos do Conjunto de Dados" explicando o que a visualização escolhida espera. Use Expressões de Tabela Comum (CTEs) para definir parâmetros no início da consulta para maior flexibilidade. Essa abordagem mantém suas consultas fáceis de manter e permite ajustar parâmetros sem reescrever lógica complexa.

Para padrões de consulta detalhados, exemplos e melhores práticas, veja Escrevendo consultas SQL.

Como organizar painéis na tela

Arraste os painéis para reposicioná‑los na tela. Os painéis se alinham a uma grade que mantém tudo alinhado. Redimensione os painéis arrastando seus cantos. A tela usa uma grade de 24 colunas, portanto os painéis podem ocupar de 1 a 24 colunas em largura.

Agrupe painéis relacionados em linhas para organização. Arraste um painel até a borda da tela até que apareça uma linha azul e então solte para criar uma nova linha. Adicione mais painéis à linha arrastando‑os ao lado dos existentes. Colapse linhas usando o ícone de seta na borda esquerda da linha.

Como personalizar a aparência da visualização

Configure opções específicas de visualização na aba Configurações de Visualização :

• Gráficos de barras: orientação horizontal ou vertical

• Gráficos de pizza: modos padrão ou donut

• Tabelas: colunas ordenáveis, paginação, destaque de linhas

Essas configurações controlam como os dados aparecem visualmente, mas não alteram quais dados são exibidos. As opções disponíveis dependem do tipo de painel.

Exemplo de Configurações de Visualização de Tabela

Como organizar relatórios em seções

O Dashboard Studio usa um menu hierárquico na barra lateral esquerda. Crie seções para agrupar relatórios relacionados. Por exemplo, crie uma seção "Gestão de Frota" contendo relatórios para status de veículos, utilização e manutenção.

Use o modo de edição do menu para criar seções, arrastar relatórios entre elas e reordenar itens. As seções não podem ser aninhadas. Você tem um nível organizacional: seções contêm relatórios, relatórios contêm painéis.

Como salvar e compartilhar relatórios

Salve seu relatório para armazená‑lo no seu menu. O Dashboard Studio solicita um nome e a localização da seção. Os relatórios são salvos automaticamente enquanto você trabalha.

Exporte relatórios para compartilhá‑los com outros usuários ou criar backups.

Para fazer isso:

1. Clique para entrar no modo de edição.

2. Clique para abrir a janela de Esquema Completo.

3. Selecione Exportar.

O Dashboard Studio baixa um arquivo JSON contendo a estrutura completa do relatório, incluindo painéis, consultas e configurações de visualização. Você também pode importar um esquema existente.

Como funciona a atualização de dados

Os relatórios exibem dados atuais do IoT Query. O Dashboard Studio consulta o banco de dados cada vez que você abre um relatório. A atualidade dos dados corresponde às atualizações do seu IoT Query, que acontecem continuamente à medida que os dispositivos enviam leituras.

Você pode atualizar os relatórios manualmente usando o botão Atualizar na barra de ferramentas superior.

O Dashboard Studio não faz cache dos resultados. Cada painel executa sua consulta de forma independente quando o relatório é carregado ou atualizado.