> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-dashboards.md). # 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. {% hint style="info" %} **Prefere descrever o dashboard em vez de construí-lo?** Veja [Criando dashboards com IA](/docs/analytics/pt-br/dashboard-studio/creating-dashboards/ai-dashboards.md): 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. {% endhint %} 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: {% embed url="" %} Interface do aplicativo Dashboard Studio, modelos de dashboard integrados, criação de dashboards personalizados. {% endembed %} ## 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. {% hint style="info" %} #### 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 . {% endhint %} ### 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](/docs/analytics/pt-br/dashboard-studio/creating-reports.md). ## 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.](/docs/analytics/pt-br/dashboard-studio/writing-sql-queries.md#how-to-write-sql-for-visualizations) ## Criando painéis Vamos percorrer as etapas desde uma tela em branco até um painel estruturado e informativo. ### Como criar seu primeiro painel {% stepper %} {% step %} **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. {% endstep %} {% step %} **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. {% endstep %} {% step %} **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. {% endstep %} {% endstepper %} ### 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](/docs/analytics/pt-br/dashboard-studio/writing-sql-queries.md). ### 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. {% hint style="info" %} 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 {% endhint %} ### 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. {% hint style="warning" %} 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. {% endhint %} ### 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. {% columns %} {% column width="41.66666666666667%" %} 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. {% endcolumn %} {% column width="58.33333333333333%" %}
{% endcolumn %} {% endcolumns %} ### 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. {% hint style="info" %} 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. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-dashboards.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.