> 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 uma tela, configure consultas SQL e organize layouts para monitoramento em tempo real da Frota e tomada de decisão operacional

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

{% hint style="info" %}
**Prefere descrever o painel em vez de criá-lo?** Veja [Criar painéis 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 um canvas antes de você salvá-lo.
{% endhint %}

Painéis personalizados oferecem visibilidade operacional em tempo real ao consolidar métricas-chave, KPIs e fluxos de dados ao vivo em um único espaço de trabalho unificado.<br>

* **Consciência situacional instantânea** é alcançada por meio de widgets ao vivo que se atualizam automaticamente, ajudando as equipes a monitorar o desempenho da Frota, os ativos e as operações sem gerar relatórios manuais.
* **Tomada de decisão orientada à 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 painel personalizado de Frota:

{% embed url="<https://youtu.be/dyBk7XAZsWs?si=RIaMyZBXO1Gdl817>" %}
Interface do aplicativo Dashboard Studio, modelos de painel integrados, criação de painel personalizado.
{% endembed %}

## O que são painéis

Os painéis de controle contêm painéis que exibem visualizações de dados. Cada painel executa uma consulta SQL no seu banco de dados do IoT Query, nas mesmas camadas Raw data, Transformation e Insight que você acessa por clientes SQL. Você organiza os painéis em um canvas, 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 requer acesso ao IoT Query para funcionar. Ative o IoT Query antes de criar relatórios. Se você ainda não tem acesso, entre em contato conosco para ativação em <iotquery@navixy.com>.
{% endhint %}

### Painéis vs. relatórios

O Dashboard Studio oferece duas formas de criar análises com 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.

|               | Painéis                                      | Relatórios                                          |
| ------------- | -------------------------------------------- | --------------------------------------------------- |
| Consultas SQL | Cada painel tem sua própria consulta         | Uma consulta alimenta todas as visualizações        |
| Disposição    | Canvas de arrastar e soltar                  | Fixo: tabela de dados, gráfico, mapa de localização |
| Exportar      | 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 painéis quando você precisar de várias visualizações independentes em um único canvas, por exemplo: combinando um bloco de estatísticas de resumo de 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 [Criar 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í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 acompanhar Trajetos 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 a distribuição de Alertas por gravidade.
* **Tabelas** apresentam registros detalhados com vários atributos. Elas 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í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 em Markdown, HTML ou texto simples.
* **Mapas** traçam dados de localização como pontos em um mapa interativo. Use-os para mostrar posições atuais de 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 cabeçalhos de seção aos seus relatórios. Mapas mostram onde sua Frota está ou onde os eventos aconteceram.

Os painéis importados também podem conter tipos adicionais de painel, como gráficos de séries temporais, que são renderizados corretamente, mas não podem ser adicionados a partir da galeria de painéis.

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-46013db8fc1e093ca6a87fdca253a0674d15eb6c%2Fdashboard_example.webp?alt=media" alt=""><figcaption></figcaption></figure>

Os requisitos da 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 requisitos completos de consulta e exemplos, veja [Escrevendo 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 de um canvas vazio até um painel estruturado e informativo.

### Como criar seu primeiro painel

{% stepper %}
{% step %}
**Criar um novo painel**

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-39c139dab466c5412b557b08e1c90e7375e56a59%2Fimage%20(6).png?alt=media" alt=""><figcaption></figcaption></figure>

* Clique em <img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-61e501903eae308393e8a556371277de8c591659%2Fimage%20(1).png?alt=media" alt="" data-size="line"> no canto inferior esquerdo do aplicativo e selecione **Novo painel**.
* Adicione **Título**.
* Clique em **Criar painel**, uma **Começar** mensagem aparece.
* Selecione **Começar com painel em branco** para abrir um canvas vazio.
  {% endstep %}

{% step %}
**Adicionar um painel**

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-2cd84e12f590252f8a9cf58ab0fc152f77d8bb63%2Fimage%20(7).png?alt=media" alt=""><figcaption></figcaption></figure>

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

1. Selecione <img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-849931c5ee09346eef83cb446ca5c8dbb1ff7fbf%2Fimage%20(2).png?alt=media" alt="" data-size="line"> na barra de ferramentas de edição.
2. Escolha **Tipo de painel** e clique em **Adicionar painel**. O novo painel aparece no canvas.
   {% endstep %}

{% step %}
**Configurar a visualização**

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-f0d6d461b3c5a4faf9850c0d8ca580578621b26f%2Fimage%20(5).png?alt=media" alt=""><figcaption></figcaption></figure>

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

1. Passe o mouse sobre o bloco e clique em <img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-40078e957cb2cab6455e8c3bb944214a877af060%2Fimage%20(3).png?alt=media" alt="" data-size="line">.
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 busca 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 ao seu canvas.
   {% endstep %}
   {% endstepper %}

### Como escrever consultas SQL eficazes

Agora que você entende o fluxo básico, vamos explorar as consultas SQL em detalhes. Escreva consultas PostgreSQL que façam referência às tabelas do IoT Query na aba Consulta SQL. 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.

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-e0648cf843ae5d39993031c1d6f2cb81f594ba03%2Fimage%20(8).png?alt=media" alt=""><figcaption></figcaption></figure>

Os resultados da consulta devem corresponder aos requisitos da visualização. A aba Consulta SQL inclui uma seção "Dataset Requirements" que explica o que a visualização escolhida espera. Use Common Table Expressions (CTEs) para definir parâmetros no início da consulta com flexibilidade. Essa abordagem mantém suas consultas mantíveis 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](/docs/analytics/pt-br/dashboard-studio/writing-sql-queries.md).

### Como organizar 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.

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

### Como personalizar a aparência da visualização

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

* **Gráficos de barras:** orientação horizontal ou vertical
* **Gráficos de pizza:** modos padrão ou rosquinha
* **Tabelas:** colunas classificá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.

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-ff4741adba540ac0842755fcd7b144aff7168938%2Fimage%20(9).png?alt=media" alt=""><figcaption><p>Exemplo de configurações de visualização de tabela</p></figcaption></figure>

### 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%" %}

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-9756cbcaa4eed09ed1a97be5b017133f0fe43c07%2Fimage%20(10).png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Como salvar e compartilhar painéis

Salve seu painel 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.

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 em <img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-4699d8b12a00990018b1bb3891dc331e5429dafb%2Fimage%20(11).png?alt=media" alt="" data-size="line"> para entrar no modo de edição.
2. Clique em <img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-616617b07777c04bd6902392858b9cb2f6a0900a%2Fimage%20(12).png?alt=media" alt="" data-size="line"> para abrir a janela Full Schema.
3. Selecione **Exportar**.

O Dashboard Studio baixa 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.

<figure><img src="https://2166907186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoFNFEIINiGFbhi3Px3dE%2Fuploads%2Fgit-blob-12f60c5716859d9f755a5905073ba81b3841c37d%2Fimage%20(13).png?alt=media" alt=""><figcaption></figcaption></figure>

**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. Aguarde o painel terminar de carregar e, em seguida, clique em **Exportar PDF** na barra de ferramentas.

O Dashboard Studio renderiza o layout atual do painel 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 cada vez que você abre um relatório. A atualidade dos dados acompanha suas 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 do painel podem ficar em cache por até cinco minutos, então os valores podem ficar brevemente atrás dos dados subjacentes. Consultas com falha nunca são armazenadas 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/analytics/pt-br/dashboard-studio/creating-dashboards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
