Criando painéis

Adicione painéis de visualização a um canvas, configure consultas SQL e organize layouts para monitoramento em tempo real da Frota e tomada de decisão operacional

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.

Prefere descrever o dashboard em vez de construí-lo? Veja Criando dashboards com IA: o Assistente de IA gera os painéis e o SQL a partir de uma descrição em linguagem natural, e o resultado é executado em uma tela antes de você salvá-lo.

Os Dashboards personalizados oferecem visibilidade operacional em tempo real ao consolidar métricas-chave, KPIs e fluxos de dados em tempo real em um único espaço de trabalho unificado.

• Consciência situacional instantânea é obtida por meio de widgets em tempo real que se atualizam automaticamente, ajudando as equipes a monitorar o desempenho da frota, os ativos e as operações sem executar relatórios manuais.

• Tomada de decisão orientada para a ação é apoiada por filtros interativos, recursos de detalhamento e componentes dinâmicos que permitem aos usuários identificar rapidamente tendências, anomalias e gargalos.

• Configuração personalizada do espaço de trabalho permite que as equipes adaptem layouts, widgets e métricas a funções, Departamentos ou objetivos de negócio específicos.

• Monitoramento contínuo de desempenho garante que as partes interessadas sempre tenham insights atualizados, transformando dados em uma ferramenta de gestão proativa em vez de uma análise retrospectiva.

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

Interface do aplicativo Dashboard Studio, modelos de dashboard integrados, criação de dashboards personalizados.

O que são dashboards

Os dashboards contêm painéis que exibem visualizações de dados. Cada painel executa uma consulta SQL no seu banco de dados IoT Query, nas mesmas camadas de Dados brutos, Transformação e Insight que você acessa por meio de clientes SQL. Você organiza os painéis em uma tela, configura a aparência deles 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 exige acesso ao IoT Query para funcionar. Ative o IoT Query antes de criar relatórios. Se você ainda não tiver acesso, entre em contato conosco para ativação em [e-mail].

Dashboards vs. relatórios

O Dashboard Studio oferece duas formas de criar análises a partir de dados do IoT Query. A escolha da opção certa depende de como os resultados da sua consulta estão estruturados e de como você pretende compartilhar a saída.

	Dashboards	Relatórios
Consultas SQL	Cada painel tem sua própria consulta	Uma consulta alimenta todas as visualizações
Layout	Tela de arrastar e soltar	Fixo: tabela de dados, gráfico, mapa de localização
Exportação	Esquema JSON, PDF	HTML, Excel, PDF
Caso de uso	Monitoramento operacional com vários painéis	Análise exportável de um único conjunto de dados

Use dashboards quando você precisar de várias visualizações independentes em uma única tela, por exemplo: combinando um bloco de estatística de resumo do trajeto, um gráfico de consumo de combustível e uma tabela de visitas à zona em uma única visualização. Use relatórios quando um único conjunto de dados precisar ser explorado como tabela, visualizado como gráfico e mapeado simultaneamente, ou quando a saída precisar ser exportada e compartilhada fora do Dashboard Studio.

Para detalhes sobre como configurar relatórios, veja Criando relatórios.

O que você pode criar?

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

• Blocos de estatística exibem métricas-chave individuais como distância total ou quantidade 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. Funcionam bem para comparar a utilização da frota entre regiões ou rastrear trajetos por dia.

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

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

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

• Mapas plote dados de localização como pontos em um mapa interativo. Use-os para mostrar as posições atuais dos veículos ou atividade de Geocerca.

Cada tipo de visualização atende a propósitos analíticos específicos. Blocos de estatísticas funcionam bem para KPIs como o tamanho total da Frota ou a utilização média. Gráficos de barras ajudam você a comparar o desempenho entre regiões ou acompanhar métricas ao longo do tempo. Gráficos de pizza mostram como os 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 títulos de seção aos seus Relatórios. Mapas mostram onde sua Frota está ou onde eventos aconteceram.

Painéis importados também podem conter tipos adicionais de painel, como gráficos de série temporal, que são renderizados corretamente, mas não podem ser adicionados da galeria de painéis.

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 de pizza exigem exatamente duas colunas: categorias e valores. Tabelas aceitam qualquer número de colunas. Painéis de texto não consultam dados. Mapas precisam de colunas de latitude e longitude. Para ver os requisitos completos de consulta e exemplos, consulte Escrever consultas SQL.

Criando painéis

Vamos percorrer as etapas desde uma tela em branco até um painel estruturado e informativo.

Como criar seu primeiro painel

1

Criar um novo painel

• Clique no canto inferior esquerdo do aplicativo e selecione New dashboard.

• Add Title.

• Clique Create dashboard, uma Get Started mensagem aparece.

• Selecione Start with a blank dashboard para abrir uma tela em branco no modo de edição.

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 Panel Type e clique em Add panel. O novo painel aparece na área de trabalho.

3

Configurar o visual

Agora é hora de adicionar as configurações do gráfico:

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

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

   1. Panel Properties controla o título e o tipo

   2. SQL Query define quais dados exibir

   3. Visualization Settings ajusta como esses dados aparecem

3. Nomeie seu painel em Panel Properties.

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

5. Ajuste Visualization Settings.

6. Quando estiver satisfeito, salve o painel para adicioná-lo à sua área de trabalho.

Como escrever consultas SQL eficazes

Agora que você entende o fluxo de trabalho básico, vamos explorar consultas SQL em detalhes. Escreva consultas PostgreSQL que façam referência às tabelas do IoT Query na aba SQL Query. Todas as tabelas das camadas Raw data, Transformation e Insight estão disponíveis. Teste as consultas antes de aplicá-las para verificar se os resultados correspondem aos requisitos da sua 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" que explica o que a visualização escolhida espera. Use expressões de tabela comuns (CTEs) para definir parâmetros no início da consulta para ter flexibilidade. Essa abordagem mantém suas consultas fáceis de manter e permite ajustar parâmetros sem reescrever lógica complexa.

Para padrões detalhados de consulta, exemplos e boas práticas, consulte Como escrever consultas SQL.

Como organizar os painéis no canvas

Arraste os painéis para reposicioná-los no canvas. Os painéis se encaixam em uma grade que mantém tudo alinhado. Redimensione os painéis arrastando seus cantos. O canvas usa uma grade de 24 colunas, então os painéis podem ocupar de 1 a 24 colunas de largura.

Grupo de painéis relacionados em linhas para organização. Arraste um painel até a borda do canvas até que uma linha azul apareça, então solte para criar uma nova linha. Adicione mais painéis à linha arrastando-os para ao lado dos existentes. Recolha as linhas usando o ícone de seta na borda esquerda da linha.

Como desfazer alterações no layout

No modo de edição, a barra de ferramentas de edição na borda direita da tela tem Desfazer e Refazer botões, logo abaixo de Sair do modo de edição. Desfazer reverte a última alteração que você fez no layout e Refazer restaura uma alteração que você desfez. Um botão fica esmaecido quando não há nada para desfazer ou refazer.

Você também pode usar atalhos de teclado:

Ação	Windows e Linux	macOS
Desfazer	Ctrl+Z	⌘Z
Refazer	Ctrl+Shift+Z or Ctrl+Y	⇧⌘Z

Os atalhos não funcionam enquanto uma caixa de diálogo está aberta ou enquanto você digita em um campo de texto ou no editor SQL.

Desfazer cobre as alterações que você faz no canvas:

• Em movimento e redimensionamento de painéis e linhas

• Adição de painéis e linhas, incluindo gráficos da Biblioteca de gráficos

• Duplicação e exclusão de painéis

• Renomeação, compactação e exclusão de linhas

• Organizar o layout

Desfazer não cobre alterações que você salva em uma caixa de diálogo: configurações do painel no editor de painéis, Filtros do dashboard, e o título do dashboard. Salvar o editor de painéis ou os filtros do dashboard também limpa o histórico de desfazer. Depois desse salvamento, você não pode desfazer as alterações de layout feitas antes dele.

Dashboard Studio lembra até 50 alterações. O histórico é limpo quando você sai do modo de edição ou recarrega a página.

Dashboard Studio salva cada alteração de layout assim que você a faz, incluindo cada desfazer e refazer. O layout não tem um botão separado de Salvar ou Cancelar então use Desfazer Desfazer

Como personalizar a aparência da visualização

Configure as opções específicas da visualização na Visualization Settings aba:

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

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

• Tabelas: colunas ordenáveis, paginação, realce de linha, colunas visíveis

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

Para ocultar uma coluna da tabela, desmarque a caixa de seleção em Colunas visíveis, na Configuração da tabela seção. Para exibir a coluna novamente, selecione a caixa de seleção. Uma coluna oculta permanece na consulta, então os filtros do painel ainda podem usá-la. Os visualizadores não veem a coluna na tabela, e os arquivos de Exportar CSV, Exportar Excel, e Exportar como PDF não o inclua. Pelo menos uma coluna continua visível.

Colunas visíveis lista as colunas do último resultado do painel. Para um novo painel, ou depois de você alterar a consulta, clique em Testar consulta na consulta SQL aba primeiro.

Como adicionar filtros do painel

Um filtro do painel permite que os visualizadores do painel refinem os painéis sem editar o painel. Um filtro de data seleciona um período, por exemplo, os últimos 7 dias. Um filtro de valor seleciona valores em uma coluna, por exemplo, alguns veículos. Os visualizadores encontram os filtros em Parâmetros, os alteram e clicam em Aplicar.

Você adiciona, altera e exclui filtros na Filtros do dashboard janela. Abra-a na barra de ferramentas de edição no modo de edição.

Um filtro de data altera apenas os painéis que o usam. Um filtro com o nome de variável period fornece às consultas do painel dois parâmetros: ${period_from} e ${period_to}.

Para adicionar um filtro de data, siga estas etapas:

1. Na barra de ferramentas de edição, clique em Filtros do dashboard.

2. Clique Adicionar filtro de data.

3. Insira um Rótulo e um Nome da variável.

4. Em Intervalo padrão, selecione o período com o qual o painel será aberto. As opções são Hoje, Ontem, Últimos 7 dias, Últimos 30 dias, Últimos 90 dias, e Este mês.

5. Clique Adicionar filtro.

6. Clique Salvar alterações.

Para fazer um painel usar um filtro de data, faça uma das opções a seguir:

• Escreva os parâmetros do filtro na consulta do painel, por exemplo, WHERE trip_start_time BETWEEN ${period_from} AND ${period_to}.

• Abra o editor do painel, vá para a Filtros aba, ative o filtro e selecione a coluna de resultado que ele filtra.

O nome da variável começa com uma letra e contém apenas letras, dígitos e sublinhados. Cada filtro precisa do seu próprio nome de variável. O rótulo pode ter até 120 caracteres, e o nome da variável pode ter até 63 caracteres.

Um filtro de valor se aplica aos painéis cujo resultado contém a coluna do filtro quando você adiciona o filtro. Painéis que mostram um número não recebem filtros de valor. Os visualizadores selecionam um ou mais dos valores que os painéis retornam quando o painel é aberto. Todos, o padrão, mostra todas as linhas.

Para adicionar um filtro de valor, siga estas etapas:

1. Na barra de ferramentas de edição, clique em Filtros do dashboard.

2. Clique Adicionar filtro de valor.

3. Em Coluna, selecione a coluna na qual os visualizadores filtram. O Dashboard Studio preenche Rótulo e Nome da variável a partir do nome da coluna. Você pode alterá-los.

4. Clique Adicionar filtro.

5. Clique Salvar alterações.

Para impedir que um painel use um filtro de valor, abra o editor do painel, vá para a Filtros aba e desative o filtro.

Um painel que você adicionar depois não usa um filtro de valor existente. Para incluir o painel, abra o filtro com o ícone de edição em Filtros do dashboard, clique em Atualizar filtro, e clique em Salvar alterações. Quando você atualiza um filtro de valor dessa forma ou altera a coluna dele, o filtro volta a se aplicar a todos os painéis que têm a coluna, incluindo os painéis em que você o desativou.

Como alterar ou excluir um filtro do painel

Para alterar um filtro, siga estas etapas:

1. Na barra de ferramentas de edição, clique em Filtros do dashboard.

2. Clique no ícone de edição ao lado do filtro.

3. Faça a alteração e clique em Atualizar filtro.

4. Clique Salvar alterações.

Para excluir um filtro, clique no ícone de exclusão ao lado dele. A linha então informa que o filtro foi excluído e mostra Desfazer, o que traz o filtro de volta ao seu lugar. O da linha Desfazer permanece até que você salve ou feche a janela.

As alterações na Filtros do dashboard janela só chegam ao painel quando você clica em Salvar alterações. O Dashboard Studio as salva imediatamente, e Desfazer na barra de ferramentas de edição não pode revertê-las. Para sair sem salvar, clique em Cancelar e confirme com Descartar. Descartar remove todas as alterações que você fez na janela desde o último salvamento. Os filtros que você excluiu voltam.

Quando você exclui um filtro, os painéis param de usá-lo. O Dashboard Studio não alerta sobre uma consulta de painel que ainda contém os parâmetros do filtro excluído, como ${period_from}. Os visualizadores então veem esse parâmetro em Parâmetros como um campo de texto, e o painel mostra um erro até que alguém insira um valor. Remova o parâmetro de cada consulta que o contém.

Como organizar painéis em seções

O Dashboard Studio usa um menu hierárquico na barra lateral esquerda. Crie seções para agrupar painéis/relatórios relacionados. Por exemplo, crie uma seção "Gestão de Frotas" contendo relatórios de status do veículo, 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: as seções contêm relatórios, os relatórios contêm painéis.

Como encontrar um painel

A caixa de pesquisa no topo do Dashboard Studio encontra painéis e relatórios pelo conteúdo, não apenas pelos nomes. Digite uma ou mais palavras, e a lista mostra até oito painéis e relatórios que contêm todas elas.

A pesquisa busca em:

• Nomes de painéis e relatórios

• Descrições dos painéis

• Títulos dos painéis

• As consultas SQL dos painéis e filtros, se você tiver a função de administrador ou editor

A pesquisa não diferencia maiúsculas de minúsculas, e cada palavra pode corresponder a um lugar diferente do mesmo painel. Por exemplo, combustível também encontra um painel que tem um painel intitulado "Consumo de combustível por veículo". Cada resultado mostra sua seção e o que correspondeu: títulos dos painéis ou uma parte da consulta SQL.

A pesquisa cobre apenas os seus próprios painéis e relatórios, e ignora os que estão na lixeira. Ela não pesquisa os nomes das tabelas e colunas do IoT Query.

Use as teclas de seta para navegar pelos resultados, pressione Enter para abrir um deles e pressione Esc para fechar a lista.

Para filtrar o menu da barra lateral em vez disso, digite no Pesquisar… campo acima do menu. Ele corresponde apenas a nomes de painéis e seções.

Como salvar e compartilhar painéis

O Dashboard Studio adiciona um painel ao seu menu assim que você o cria, com o título e a seção que você escolher. Depois disso, as alterações de layout são salvas automaticamente à medida que você as faz. Alterações no editor de painéis, nos filtros do painel, no título do painel e na janela Full Schema entram em vigor quando você as salva nessa janela. Os relatórios são salvos automaticamente enquanto você trabalha.

O Dashboard Studio oferece duas maneiras de exportar um painel.

Exportar o esquema JSON para compartilhá-lo com outros usuários ou criar um backup:

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

2. Clique para abrir a janela Full Schema.

3. Selecione Exportação.

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

Exportar um PDF para compartilhar uma captura estática fora do Dashboard Studio:

1. Saia do modo de edição se você estiver nele.

2. Espere o painel terminar de carregar, depois clique em Exportar PDF na barra de ferramentas.

O Dashboard Studio renderiza o layout atual dos painéis em um documento PDF paginado.

Como a atualização de dados funciona

Os painéis exibem dados atuais do IoT Query. O Dashboard Studio consulta o banco de dados toda vez que você abre um relatório. A atualização dos dados acompanha as atualizações do IoT Query, que acontecem continuamente à medida que os dispositivos enviam leituras.

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

Os resultados dos painéis podem ficar em cache por até cinco minutos, portanto os valores podem ficar brevemente atrás dos dados subjacentes. Consultas com falha nunca ficam em cache, então um painel que falha ao carregar é sempre executado novamente.