

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Dashboards no Grafana versão 10
<a name="v10-dashboards"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

 Um dashboard é um conjunto de um ou mais [painéis](v10-panels.md) organizados e organizados em uma ou mais linhas. O Grafana vem com uma variedade de painéis, facilitando a criação das consultas certas e a personalização da visualização para que você possa criar o dashboard perfeito para as suas necessidades. Cada painel pode interagir com dados de qualquer [Conectar-se à fonte de dados](AMG-data-sources.md) configurada. 

 Os snapshots do dashboard são estáticos. Consultas e expressões não podem ser reexecutadas de snapshots. Como resultado, se você atualizar qualquer variável em sua consulta ou expressão, isso não alterará os dados do dashboard. 

**Topics**
+ [Usar painéis](v10-dash-using-dashboards.md)
+ [Criar dashboards](v10-dash-building-dashboards.md)
+ [Gerenciar dashboards](v10-dash-managing-dashboards.md)
+ [Gerenciar listas de reprodução](v10-dash-managing-playlists.md)
+ [Compartilhar dashboards e painéis](v10-dash-sharing.md)
+ [Variáveis](v10-dash-variables.md)
+ [Avaliar uso do dashboard](v10-dash-assess-dashboard-usage.md)
+ [Solucionar problemas dos dashboards](v10-dash-troubleshoot.md)
+ [Pesquisar dashboards no Grafana versão 10](v10-search.md)

# Usar painéis
<a name="v10-dash-using-dashboards"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Este tópico fornece uma visão geral dos recursos e atalhos do dashboard e descreve como usar a pesquisa nele.

## Recursos
<a name="v10-dash-features"></a>

Você pode usar dashboards para personalizar a apresentação dos seus dados. A imagem a seguir mostra a interface do dashboard no espaço de trabalho do Amazon Managed Grafana.

![\[Uma imagem mostrando a interface para dashboards em um espaço de trabalho do Amazon Managed Grafana, com destaques para os botões de diferentes recursos.\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Recurso  |  Description  | 
| --- | --- | 
| **1. Início** | Clique no ícone de início do Grafana para ser redirecionado para a página inicial configurada na instância do Grafana. | 
| **2. Título** | Ao selecionar o título do dashboard, você pode pesquisar os dashboards contidos na pasta atual. | 
| **3. Compartilhar um dashboard** | Use essa opção para compartilhar o dashboard atual por link ou snapshot. Você também pode exportar a definição do dashboard do modal de compartilhamento. | 
| **4. Adicionar um novo painel** | Use esta opção para adicionar um painel, uma linha do dashboard ou um painel da biblioteca ao dashboard atual. | 
| **5. Salvar dashboard** | Escolha o ícone de Salvar para salvar as alterações no dashboard. | 
| **6. Insights do dashboard** | Escolha visualizar o analytics sobre o dashboard, incluindo informações sobre usuários, atividades e contagens de consultas. Para obter mais informações, consulte [Avaliar uso do dashboard](v10-dash-assess-dashboard-usage.md). | 
| **7. Configurações do dashboard** | Use esta opção para alterar o nome, a pasta ou as tags do dashboard e gerenciar variáveis e consultas de anotações. Para obter mais informações sobre dashboards, consulte [Modificar as configurações do dashboard](v10-dash-modify-settings.md). | 
| **8. Lista suspensa do seletor de tempo** |  Use para selecionar opções de intervalo de tempo relativo e definir intervalos de tempo absolutos personalizados. Você pode alterar as configurações de **fuso horário** e **ano fiscal** nos controles de intervalo de tempo clicando no botão **Alterar configurações de horário**. As configurações de hora são salvas por dashboard.  | 
| **9. Reduzir intervalo de tempo** |  Use para reduzir o intervalo de tempo. Para obter mais informações sobre como usar controles de intervalo de tempo, consulte [Configurar o intervalo de tempo do dashboard](#v10-dash-setting-dashboard-time-range).  | 
| **10. Atualizar o dashboard** | Selecione para acionar consultas imediatamente e atualizar os dados do dashboard. | 
| **11. Atualizar intervalo de tempo do dashboard** | Selecione um intervalo de tempo de atualização automática do dashboard. | 
| **12. Modo de visualização**  | Selecione para exibir o dashboard em uma tela grande, como uma TV ou um quiosque. O modo de visualização oculta as informações irrelevantes, como menus de navegação.  | 
| **13. Painel do dashboard** |  O principal bloco de criação de um dashboard é o painel. Para adicionar um novo painel, linha do dashboard ou painel da biblioteca, selecione **Adicionar painel**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Legenda do grafo** | Altere as cores da série, o eixo y e a visibilidade da série diretamente na legenda. | 
| **15. Linha do dashboard** | Uma linha do dashboard é um divisor lógico dentro de um dashboard que agrupa os painéis. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 

## Atalhos de teclado
<a name="v10-dash-keyboard-shortcuts"></a>

O Grafana tem vários atalhos de teclado disponíveis. Para exibir todos os atalhos de teclado disponíveis para você, pressione **?** ou **h** no teclado.
+ `Ctrl+S` salva o dashboard atual. 
+ `f` abre o localizador e a pesquisa do dashboard. 
+  `d+k` alterna o modo de quiosque (oculta o menu). 
+ `d+e` expande todas as linhas. 
+ `d+s` abre as configurações do dashboard. 
+ `Ctrl+K` abra a paleta de comandos.
+ `Esc` sai do painel quando está na visualização em tela cheia ou no modo de edição. Você também pode retornar ao dashboard nas configurações do dashboard.

**Painel focado**

Para usar atalhos direcionados a um painel específico, passe o ponteiro do mouse sobre um painel.
+ `e` alterna a visualização de edição do painel 
+ `v` alterna a visualização em tela cheia do painel 
+ `ps` abre o recurso de compartilhamento do painel 
+ `pd` duplica o painel 
+ `pr` remove o painel 
+ `pl` alterna a legenda do painel 

## Configurar o intervalo de tempo do dashboard
<a name="v10-dash-setting-dashboard-time-range"></a>

O Grafana fornece diversas maneiras de gerenciar os intervalos de tempo dos dados que estão sendo visualizados para dashboards, painéis e também alertas.

Esta seção descreve as unidades de tempo e intervalos relativos compatíveis, os controles de tempo comuns, as configurações de tempo em todo o dashboard e as configurações de tempo específicas do painel.

**Unidades de tempo e intervalos relativos**

O Grafana é compatível com as seguintes unidades de tempo: `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)`, `Q (quarters)` e `y (years)`. 

O operador de menos permite que você volte no tempo, em relação à data e hora atuais, ou `now`. Se você quiser exibir o período completo da unidade (dia, semana ou mês), anexe `/<time unit>` ao final. Para visualizar períodos fiscais, use `fQ (fiscal quarter)` e unidades de tempo `fy (fiscal year)`.

O operador de mais permite que você avance no tempo, em relação ao agora. Por exemplo, você pode usar esse recurso para analisar dados previstos no futuro.

A tabela a seguir fornece exemplos de intervalos relativos.


| Exemplo de intervalo relativo | De | Para | 
| --- | --- | --- | 
| Últimos 5 minutos |  `now-5m`  |  `now`  | 
| O dia até o momento |  `now/d`  |  `now`  | 
| Esta semana |  `now/w`  |  `now/w`  | 
| Esta semana até o momento |  `now/w`  |  `now`  | 
| Este mês |  `now/M`  |  `now/M`  | 
| Este mês até o momento |  `now/M`  |  `now`  | 
| Mês anterior |  `now-1M/M`  |  `now-1M/M`  | 
| Este ano até o momento |  `now/Y`  |  `now`  | 
| Este ano |  `now/Y`  |  `now/Y`  | 
| Ano fiscal anterior |  `now-1y/fy`  |  `now-1y/fy`  | 

**nota**  
 O Grafana Alerting não é compatível com as seguintes sintaxes:  
`now+n` para carimbos de data e hora futuros.
`now-1n/n` para o *início de n até o final de n*, porque este é um carimbo de data e hora absoluto.

**Controles de intervalo de tempo comuns**

Os controles de tempo do painel e do dashboard têm uma interface de usuário comum. A seguir, descrevemos os controles comuns de intervalo de tempo.
+ O intervalo de tempo atual, também chamado de *seletor de tempo*, mostra o intervalo de tempo atualmente exibido no dashboard ou painel que você está visualizando. Passe o cursor sobre o campo para ver os carimbos de data e hora exatos no intervalo e sua origem (como a hora do navegador local). Clique no *intervalo de tempo atual* para alterá-lo. Você pode alterar a hora atual usando um *intervalo de tempo relativo*, como os últimos 15 minutos ou um intervalo de tempo absoluto, como `2020-05-14 00:00:00` a `2020-05-15 23:59:59`.
+ O **intervalo de tempo relativo** pode ser selecionado na lista **Intervalos de tempo relativos**. Você pode filtrar a lista usando o campo de entrada na parte superior. Alguns exemplos de intervalos de tempo incluem: *Últimos 30 minutos*, *Últimas 12 horas*, *Últimos 7 dias*, *Últimos 2 anos*, *Ontem**, Anteontem*, *Este mesmo dia na semana passada*, *Hoje até o momento*, *Esta semana até o momento* e *Este mês até o momento*.
+ O **intervalo de tempo absoluto** pode ser definido de duas maneiras: digitando valores de tempo exatos ou valores de tempo relativo nos campos **De** e **Para** e clicando em **Aplicar intervalo de tempo**, ou clicando em uma data ou intervalo de datas no calendário exibido quando você clicar no campo **De** ou **Para**. Para aplicar suas seleções, clique em **Aplicar intervalo de tempo**. Você também pode escolher em uma lista de intervalos de tempo absolutos usados recentemente.
+ O **intervalo de tempo semirrelativo** pode ser selecionado nas configurações do intervalo de tempo absoluto. Por exemplo, para mostrar a atividade desde uma data específica, você pode escolher uma hora absoluta para a hora de início e uma hora relativa (como `now`) para a hora de término.

  Usando um intervalo de tempo semirrelativo, à medida que o tempo avança, seu dashboard diminuirá automática e progressivamente para mostrar mais histórico e menos detalhes. Na mesma proporção, à medida que a alta resolução de dados diminui, as tendências históricas de todo o período se tornarão mais claras.
**nota**  
Os alertas não são compatíveis com intervalos de tempo semirrelativos.
+ **Reduza** selecionando o ícone de redução (ou usando Cmd\$1Z ou Ctrl\$1Z como atalho de teclado). Isso aumenta a visualização, mostrando um intervalo de tempo maior na visualização do painel ou dashboard.
+ **Aumente** selecionando um intervalo de tempo que você deseja visualizar no grafo na visualização.
**nota**  
O aumento é aplicável somente para visualizações de grafos. 

**Atualizar dashboards**

Clique no ícone de **Atualizar dashboard** para executar imediatamente todas as consultas no dashboard e atualizar as visualizações. O Grafana cancela todas as solicitações pendentes quando você aciona uma atualização.

Por padrão, o Grafana não atualiza automaticamente o dashboard. As consultas são executadas em sua própria programação, de acordo com as configurações do painel. No entanto, se você quiser atualizar regularmente o dashboard, clique na seta para baixo ao lado do ícone **Atualizar dashboard** e selecione um intervalo de atualização.

**Controlar o intervalo de tempo usando um URL**

Você pode controlar o intervalo de tempo de um dashboard fornecendo os parâmetros de consulta a seguir no URL do dashboard.
+ `from` define o limite mínimo do intervalo de tempo, especificado em ms epoch, ou o [tempo relativo](#v10-dash-setting-dashboard-time-range).
+ `to` define o limite máximo do intervalo de tempo, especificado em ms epoch, ou o tempo relativo.
+ `time` e `time.window` definem um intervalo de tempo de `time-time.window/2` a `time+time.window/2`. Ambos os parâmetros devem ser especificados em ms. Por exemplo, `?time=1500000000000&time.window=10000` resultará em um intervalo de tempo de 10s de 1499999995000 a 1500000005000.

# Criar dashboards
<a name="v10-dash-building-dashboards"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Depois de criar um espaço de trabalho do Grafana e entrar, você pode criar dashboards e modificar as configurações de acordo com suas necessidades. Um dashboard é composto por [painéis com visualizações](v10-panels-viz.md). Cada painel tem uma consulta associada a ele para extrair dados de uma das [Conectar-se à fonte de dados](AMG-data-sources.md).

Você pode criar dashboards mais interativos e dinâmicos adicionando e usando [variáveis](v10-dash-variables.md). Em vez da codificação rígida do servidor, da aplicação ou de outros nomes em suas consultas de métricas, você pode usar variáveis em seu lugar.

**Topics**
+ [Criando painéis](v10-dash-creating.md)
+ [Importar dashboards](v10-dash-importing.md)
+ [Exportar painéis](v10-dash-exporting.md)
+ [Modificar as configurações do dashboard](v10-dash-modify-settings.md)
+ [Variáveis de URL do dashboard](v10-dash-dashboard-url-variables.md)
+ [Gerenciar painéis de biblioteca](v10-dash-manage-library-panels.md)
+ [Gerenciar o histórico de versões do dashboard](v10-dash-manage-version-history.md)
+ [Gerenciar links do dashboard](v10-dash-manage-dashboard-links.md)
+ [Anotar visualizações](v10-dash-annotations.md)
+ [Modelo JSON do dashboard](v10-dash-dashboard-json-model.md)
+ [Práticas recomendadas para dashboards](v10-dash-bestpractices.md)

# Criando painéis
<a name="v10-dash-creating"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

**Criar um dashboard**

Dashboards e painéis permitem que você mostre os dados de forma visual usando o Grafana. Cada painel precisa de pelo menos uma consulta para exibir uma visualização. Conclua os pré-requisitos a seguir antes de começar.
+ Certifique-se de que você tenha as permissões necessárias. Para obter mais informações sobre permissões, consulte [Usuários, equipes e permissões](Grafana-administration-authorization.md).
+ Identifique o dashboard ao qual você deseja adicionar o painel.
+ Entenda a linguagem de consulta da fonte de dados de destino.
+ Verifique se a fonte de dados para a qual você está escrevendo uma consulta foi adicionada. Para obter mais informações, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).

 Para criar um dashboard:

1. Faça login no Grafana e selecione **Dashboards** no menu à esquerda.

1. Selecione **Novo** e, em seguida, **Novo dashboard**.

1. No dashboard vazio, selecione **\$1 Adicionar visualização**. Isso abre a nova caixa de diálogo de visualização.

1. Selecione uma fonte de dados. Você pode escolher uma fonte de dados existente, uma das fontes de dados integradas do Grafana para teste, ou escolher **Configurar uma nova fonte de dados** para configurar uma nova (somente usuários com permissões de administrador podem configurar novas fontes de dados).

   A exibição do **painel Editar** é aberta, com a fonte de dados selecionada. Você pode alterar a fonte de dados do painel posteriormente, usando a guia **Consulta** do editor do painel, se necessário.

1. Escreva ou crie uma consulta na linguagem de consulta da sua fonte de dados. Escolha o ícone de atualização do dashboard para realizar uma consulta na fonte de dados, vendo os resultados à medida que você avança.

1. Na lista **Visualização**, selecione um tipo de visualização. O Grafana exibe uma pré-visualização dos resultados da consulta com a visualização aplicada. Para obter mais informações, consulte [Opções de visualizações](v10-panels-viz.md).

1. Em **Opções do painel**, você pode inserir um título e uma descrição para o painel. 

1. A maioria das visualizações precisa de alguns ajustes antes de exibir as informações exatas de que você precisa. Você pode ajustar as configurações do painel das maneiras a seguir.
   + [Configurar mapeamentos de valores](v10-panels-configure-value-mappings.md)
   + [Opções específicas de visualização](v10-panels-viz.md)
   + [Substituir valores de campo](v10-panels-configure-overrides.md)
   + [Configurar limites](v10-panels-configure-thresholds.md)
   + [Configurar opções padrão](v10-panels-configure-standard-options.md)

1. Quando terminar de configurar o painel, escolha **Salvar** para salvar o dashboard.

   Como alternativa, selecione **Aplicar** para ver as alterações sem sair do editor do painel.

1. Adicione uma observação para descrever a visualização (ou descrever as alterações) e clique em **Salvar** no canto superior direito da página.
**nota**  
As observações serão úteis se você precisar reverter o dashboard para uma versão anterior.

1. Escolha **Salvar**.

1. Opcionalmente, você pode adicionar mais painéis ao dashboard escolhendo **Adicionar** no cabeçalho do dashboard e selecionando **Visualização** no menu suspenso.

**Copiar um dashboard existente**

Você pode copiar rapidamente um dashboard existente para começar a criar um novo.

**Para copiar um dashboard existente**

1. Selecione **Dashboards** no menu à esquerda.

1. Escolha o dashboard que você deseja copiar para abri-lo.

1. Selecione **Configurações** (ícone de engrenagem) no canto superior direito do dashboard.

1. Selecione **Salvar como** no canto superior direito do dashboard.

1. (Opcional) Especifique o nome, a pasta, a descrição e se deseja ou não copiar as tags originais do dashboard para o dashboard copiado.

1. Selecione **Salvar**.

**Configurar linhas repetidas**

Você pode configurar o Grafana para adicionar dinamicamente painéis ou linhas a um dashboard com base no valor de uma variável. As variáveis alteram dinamicamente as consultas em todas as linhas em um dashboard. Para obter mais informações sobre painéis repetidos, consulte [Configurar painéis repetidos]().

Você também pode repetir as linhas se tiver variáveis definidas com `Multi-value` ou `Include all values` selecionadas.

Antes de começar, certifique-se de que a consulta inclua uma variável de vários valores e, em seguida, conclua as etapas a seguir.

**Para configurar linhas repetidas**

1. Selecione **Dashboards** no menu à esquerda e escolha o dashboard que você deseja modificar.

1. Na parte superior do dashboard, selecione **Adicionar** e, em seguida, selecione **Linha** no menu suspenso.

   Se o dashboard estiver vazio, você poderá selecionar alternativamente o botão **\$1 Adicionar linha** no meio do dashboard.

1. Passe o mouse sobre o título da linha e selecione o ícone de **Configurações** (engrenagem) que aparece.

1. Na caixa de diálogo **Opções de linha**, adicione um título e selecione a variável para a qual você deseja adicionar linhas repetidas.
**nota**  
 Para fornecer contexto aos usuários do dashboard, adicione a variável ao título da linha. 

1. Selecione **Atualizar**.

**Linhas repetidas e a fonte de dados especial do dashboard**

Se uma linha incluir painéis usando a fonte de dados [Dashboard](AMG-data-sources.md#AMG-data-sources-special) especial (a fonte de dados que usa um conjunto de resultados de outro painel no mesmo dashboard), os painéis correspondentes em linhas repetidas farão referência ao painel na linha original, não aos das linhas repetidas.

Por exemplo, em um dashboard:
+ `Row 1` inclui `Panel 1A` e `Panel 1B`.
+ `Panel 1B` usa os resultados de `Panel 1A` usando a fonte de dados `Dashboard`.
+ A repetição `Row 2` inclui `Panel 2A` e `Panel 2B`.
+ `Panel 2B` referencia `Panel 1A`, não `Panel 2A`.

**Para mover um painel**

1. Abra o painel do .

1. Selecione o título do painel e arraste o painel até o novo local. Você pode colocar um painel em um dashboard em qualquer local.

**Para redimensionar um painel**

1. Abra o painel do .

1. Para ajustar o tamanho do painel, arraste o canto inferior direito do painel. Você pode dimensionar um painel de dashboard para atender às suas necessidades.

# Importar dashboards
<a name="v10-dash-importing"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Você pode importar dashboards pré-configurados para o espaço de trabalho do Amazon Managed Grafana.

**Para importar um dashboard**

1. Faça login no espaço de trabalho do Amazon Managed Grafana.

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Novo** e escolha **Importar** no menu suspenso.

1. Em seguida, você precisa escolher a definição do JSON do dashboard a ser importada. Você tem três opções para importar o JSON:
   + Faça upload de um arquivo contendo o JSON do dashboard.
   + Copie diretamente o texto JSON na área de texto.
   + Cole o URL ou o ID do dashboard da Grafana Labs no campo. Para obter mais informações sobre o painel grafana.com URLs, consulte a próxima seção.
   + (Opcional) Altere os detalhes do dashboard que você deseja alterar.
   + Selecione uma fonte de dados, se necessário.
   + Escolha **Importar**.
   + Salve o painel.

## Encontrar dashboards em grafana.com
<a name="v10-dash-import-from-grafana"></a>

A página [Dashboards](https://grafana.com/grafana/dashboards/) em grafana.com fornece dashboards para aplicações comuns de servidor. Navegue por uma biblioteca de dashboards oficiais e criados pela comunidade e importe-os para colocá-los em operação rapidamente.

**nota**  
Para importar dashboards de grafana.com, seu espaço de trabalho do Amazon Managed Grafana deve ter acesso à internet.

# Exportar painéis
<a name="v10-dash-exporting"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Você pode usar a interface de usuário do Grafana ou a API HTTP para exportar dashboards.

A ação de exportação do dashboard cria um arquivo JSON do Grafana que contém tudo o que você precisa, incluindo layout, variáveis, estilos, fontes de dados, consultas, e assim por diante, para que você possa importar o dashboard posteriormente.

**Tornar um dashboard portátil**

Se quiser exportar um dashboard para outros usarem, você pode adicionar variáveis de modelo para coisas como um prefixo de métrica (use uma variável constante) e nome de servidor.

Uma variável de modelo do tipo `Constant` será automaticamente ocultada no dashboard, e também será adicionada como uma entrada obrigatória quando o dashboard for importado.

**Para exportar um dashboard**

1. Abra o painel que você deseja exportar.

1. Selecione o ícone de compartilhamento.

1. Escolha **Exportar**.

1. Escolha **Salvar arquivo.**

**nota**  
O Grafana faz download de um arquivo JSON na sua máquina local. 

# Modificar as configurações do dashboard
<a name="v10-dash-modify-settings"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

A página de configurações do dashboard permite que você:
+ Edite as propriedades gerais do dashboard, incluindo as configurações de horário.
+ Adicione consultas de anotação.
+ Adicione variáveis de dashboard.
+ Adicione links.
+ Visualizar o modelo JSON do dashboard

**Para acessar a página de configurações do dashboard**

1. Abra um dashboard no modo de edição.

1. Clique em **Configurações do dashboard** (ícone de engrenagem) localizado na parte superior da página.

**Modificar as configurações de horário do dashboard**

Ajuste as configurações de horário do dashboard quando quiser alterar o fuso horário do dashboard, a hora do navegador local e especificar intervalos de tempo de atualização automática.

**Para modificar as configurações de horário do dashboard**

1. Na página de configurações do **Dashboard**, selecione **Geral**.

1. Navegue até a seção **Opções de horário**.

1. Especifique as configurações de horário de acordo com as descrições a seguir.

1. 
   + **Fuso horário**: especifique o fuso horário local do serviço ou sistema que você está monitorando. Isso pode ser útil ao monitorar um sistema ou serviço que opera em vários fusos horários.
     + **Padrão**: o Grafana usa o fuso horário padrão selecionado para o perfil do usuário, uma equipe ou uma organização. Se nenhum fuso horário for especificado para o perfil do usuário, uma equipe da qual o usuário seja membro ou a organização, o Grafana usará o horário local do navegador.
     + **Hora local do navegador**: o fuso horário configurado para o navegador do usuário que está visualizando é usado. Geralmente, é o mesmo fuso horário definido no computador.
     + Use [fusos horários padrão ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), incluindo UTC.
   + **Atualização automática**: personalize as opções exibidas para o tempo relativo e as opções de atualização automática. As entradas são separadas por vírgula e aceitam qualquer unidade de tempo válida.
   + **Atraso agora**: substitui o tempo `now` ao inserir um atraso de tempo. Use essa opção para acomodar atrasos conhecidos na agregação de dados para evitar valores nulos.
   + **Ocultar seletor de tempo**: selecione esta opção se você não quiser que o dashboard exiba o seletor de tempo.

**nota**  
Para ter controles de tempo, seus dados devem incluir uma coluna de tempo. Consulte a documentação da [fonte de dados](AMG-data-sources.md) específica para obter mais informações sobre a inclusão de uma coluna de tempo.

**Adicionar uma consulta de anotação**

Uma consulta de anotação consulta eventos. Esses eventos podem ser visualizados em grafos no dashboard como linhas verticais junto com um pequeno ícone sobre o qual você pode passar o mouse para ver as informações do evento.

**Para adicionar uma consulta de anotação**

1. Na página **Configurações do dashboard**, selecione **Anotações**.

1. Selecione **Adicionar consulta de anotação**. 

1. Insira um nome e selecione uma fonte de dados.

1. Preencha o restante do formulário para criar uma consulta e uma anotação.

A interface do usuário do editor de consultas muda com base na fonte de dados que você seleciona. Consulte a documentação da [fonte de dados](AMG-data-sources.md) para obter detalhes sobre como criar uma consulta. Ou, para plug-ins de fonte de dados que você instala do [Encontre plug-ins com o catálogo de plug-ins](grafana-plugins.md#plugin-catalog), você pode usar a [documentação no site da Grafana Labs](https://grafana.com/docs/grafana/v10.3/datasources/).

**Adicionar uma variável**

As variáveis permitem que você crie dashboards mais interativos e dinâmicos. Em vez da codificação rígida do servidor, da aplicação ou de outros nomes de sensor em suas consultas de métricas, você pode usar variáveis em seu lugar. As variáveis são exibidas como listas suspensas na parte superior do dashboard. Essas listas suspensas facilitam a alteração dos dados exibidos no dashboard.

Para obter mais informações sobre variáveis, consulte [Variáveis](v10-dash-variables.md).

**Para adicionar uma variável**

1. Na página **Configurações do dashboard**, clique em **Variável** no menu da seção do lado esquerdo e depois no botão **Adicionar variável**.

1. Na seção **Geral**, adicione o nome da variável. Esse é o nome que você usará posteriormente em consultas.

1. Selecione uma variável de **Tipo**.
**nota**  
O tipo de variável que você seleciona afeta os campos que você preenche na página.

1. Defina a variável e clique em **Atualizar**.

**Adicionar um link**

Os links do dashboard permitem que você coloque links para outros dashboards e sites diretamente abaixo do cabeçalho do dashboard. Os links facilitam a navegação para outros dashboards e tipos de conteúdo relacionados. 

**Para adicionar um link**

1. Na página **Configurações do dashboard**, clique em **Links** no menu da seção do lado esquerdo e depois no botão **Adicionar link**.

1. Insira o título e, no campo **Tipo**, selecione **Dashboard** ou **Link**.

1. Para adicionar um link de dashboard, adicione uma tag opcional, selecione qualquer uma das opções do link do dashboard e clique em **Aplicar**.
**nota**  
O uso de tags cria um menu suspenso dinâmico de dashboards, todos com uma tag específica.

1. Para adicionar um link da Web, adicione um URL e um texto de dica de ferramenta que apareça quando o usuário passar o mouse sobre o link, selecione um ícone que apareça ao lado do link e, então, qualquer uma das opções de links de dashboard. 

**Visualizar o modelo JSON do dashboard**

Um dashboard no Grafana é representado por um objeto JSON, que armazena os metadados de um dashboard. Os metadados do dashboard incluem propriedades do dashboard, metadados dos painéis, variáveis de modelo, consultas do painel e assim por diante. Os metadados JSON definem o dashboard.

Para visualizar um modelo JSON do dashboard, na página **Configurações do dashboard**, clique em **JSON**.

Para obter mais informações sobre os campos JSON, consulte [Campos JSON](v10-dash-dashboard-json-model.md).

# Variáveis de URL do dashboard
<a name="v10-dash-dashboard-url-variables"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Grafana pode aplicar valores variáveis passados como parâmetros de consulta no painel. URLs Para obter mais informações, consulte [Gerenciar links do dashboard](v10-dash-manage-dashboard-links.md) e [Modelos e variáveis](v10-dash-variables.md).

**Passar variáveis como parâmetros de consulta**

O Grafana interpreta os parâmetros da string de consulta prefixados com `var-` como variáveis no dashboard fornecido.

Por exemplo, neste URL: 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

O parâmetro de consulta `var-example=value` representa o exemplo da variável do dashboard com um valor de `value`.

**Passar vários valores para uma variável**

Para passar vários valores, repita o parâmetro da variável uma vez para cada valor.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

O Grafana interpreta `var-example=value1&var-example=value2` como o exemplo de variável do dashboard com dois valores: `value1` e `value2`.

**Adicionar variáveis aos links do dashboard**

O Grafana pode adicionar variáveis aos links do dashboard quando você as gera das configurações de um dashboard. Para obter mais informações e as etapas para adicionar variáveis, consulte [Gerenciar links do dashboard](v10-dash-manage-dashboard-links.md).

**Passar filtros ad hoc**

Os filtros ad hoc aplicam filtros de chave ou valor a todas as consultas de métricas que usam uma fonte de dados específica. Para obter mais informações, consulte [Filtros ad hoc](v10-dash-variable-add.md#v10-dash-variable-add-adhoc).

Para passar um filtro ad hoc como parâmetro de consulta, use a sintaxe da variável para passar a variável do filtro ad hoc e também forneça a chave, o operador como valor e o valor como uma lista separada por barras verticais.

Por exemplo, neste URL:

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

O parâmetro de consulta `var-adhoc=key|=|value` aplica o filtro ad hoc configurado como a variável ad hoc do dashboard usando a chave `example_key`, o operador `=` e o valor `example_value`.

**nota**  
Ao compartilhar URLs com filtros ad hoc, lembre-se de codificar o URL. No exemplo acima, substitua as barras verticais (`|`) por `%7C` e o operador de igualdade (`=`) por `%3D`.

**Controlar o intervalo de tempo usando o URL**

Para definir o intervalo de tempo de um dashboard, use os parâmetros de consulta `from`, `to`, `time` e `time.window`. Como não são variáveis, elas não exigem o prefixo `var-`.

# Gerenciar painéis de biblioteca
<a name="v10-dash-manage-library-panels"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Um painel de biblioteca é um painel reutilizável que você pode usar em qualquer dashboard. Quando você altera um painel da biblioteca, a alteração se propaga para todas as instâncias em que o painel é usado. Os painéis da biblioteca simplificam a reutilização de painéis em vários dashboards.

Você pode salvar um painel de biblioteca em uma pasta junto com os dashboards salvos.

**Criar um painel de biblioteca**

Quando você cria um painel de biblioteca, o painel no dashboard de origem também é convertido em um painel de biblioteca. Você precisa salvar o dashboard original após a conversão de um painel.

**Para criar um painel de biblioteca**

1. Abra o painel que você deseja converter em um painel de biblioteca no modo de edição.

1. Nas opções de exibição do painel, clique na opção de seta para baixo para iniciar as alterações na visualização.

1. Selecione **Painéis de biblioteca** e, em seguida, **\$1 Criar painel de biblioteca**. Isso abre a caixa de diálogo de criação.

1. Em **Nome do painel da biblioteca**, insira o nome que você deseja para o painel.

1. Em **Salvar na pasta**, selecione a pasta para salvar o painel da biblioteca.

1. Selecione **Criar painel de biblioteca** para salvar as alterações na biblioteca.

1. Salve o painel.

Depois que um painel de biblioteca é criado, você pode modificá-lo usando qualquer dashboard em que ele apareça. Depois de salvar as alterações, todas as instâncias do painel da biblioteca refletirão essas modificações.

Você também pode criar um painel de biblioteca diretamente do menu de edição de qualquer painel, selecionando **Mais...** e depois **Criar um painel de biblioteca**.

**Adicionar um painel de biblioteca a um dashboard**

Adicione um painel da biblioteca do Grafana a um dashboard quando quiser fornecer visualizações para outros usuários do dashboard.

**Para adicionar um painel de biblioteca a um dashboard**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Novo** e, em seguida, escolha **Novo dashboard** no menu suspenso.

1. No dashboard vazio, selecione **\$1 Importar painel de biblioteca**. Você verá uma lista dos painéis de biblioteca.

1. Filtre a lista ou pesquise para encontrar o painel que você deseja adicionar.

1. Clique em um painel para adicioná-lo ao dashboard.

**Desvincular um painel de biblioteca**

Desvincule um painel de biblioteca quando quiser fazer uma alteração no painel e não for afetar outras instâncias do painel de biblioteca.

**Para desvincular um painel de biblioteca**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Painéis de biblioteca**.

1. Selecione um painel de biblioteca que está sendo usado em diferentes dashboards.

1. Selecione o painel que deseja desvincular.

1. Selecione o título do painel (ou passe o ponteiro em qualquer lugar sobre o painel) para exibir o menu de ações no canto superior direito do painel.

1. Selecione **Editar**. O painel será aberto no modo de edição.

1. Selecione **Desvincular** no canto superior direito da página.

1. Escolha **Sim, desvincular**.

**Visualizar uma lista de painéis da biblioteca**

Você pode visualizar uma lista dos painéis de biblioteca disponíveis e pesquisar um painel de biblioteca.

**Para visualizar uma lista de painéis de biblioteca**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Painéis de biblioteca**. Você pode ver uma lista de painéis de biblioteca definidos anteriormente.

1. Procure um painel de biblioteca específico se você souber o nome. Você também pode filtrar os painéis por pasta ou tipo.

**Excluir um painel de biblioteca**

Exclua um painel de biblioteca quando não precisar mais dele.

**Para excluir um painel de biblioteca**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Painéis de biblioteca**.

1. Selecione o ícone de exclusão ao lado do nome do painel da biblioteca que deseja excluir.

# Gerenciar o histórico de versões do dashboard
<a name="v10-dash-manage-version-history"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Sempre que você salva uma versão do dashboard, uma cópia dessa versão é salva para que as versões anteriores do dashboard não sejam perdidas. Uma lista dessas versões está disponível inserindo as configurações do dashboard e selecionando **Versões** no menu do lado esquerdo.

**nota**  
As 20 versões mais recentes de um dashboard ficam salvas.

O recurso de histórico de versões do dashboard permite comparar e restaurar as versões do painel salvas anteriormente.

**Comparar duas versões do dashboard**

Para comparar duas versões do dashboard, selecione as duas versões da lista que você deseja comparar. Clique em **Comparar versões** para ver as diferenças entre as duas versões. Isso abre a visualização de diferenças das versões. Por padrão, você verá um resumo em texto das alterações.

Caso deseje ver as diferenças do JSON bruto que representa o dashboard, é possível fazê-lo clicando no botão **Visualizar diferenças do JSON** na parte inferior.

**Restaurar para uma versão do dashboard salva anteriormente**

Se precisar restaurar para uma versão do dashboard salva anteriormente, você pode selecionar o botão **Restaurar** à direita de uma linha na lista de versões do dashboard ou selecionar o botão **Restaurar para a versão *<x>*** na visualização de diferenças. Selecionar qualquer opção solicitará que você confirme a restauração.

Depois de restaurar para uma versão anterior, uma nova versão será criada contendo exatamente os mesmos dados da versão anterior, somente com um número de versão diferente. Essa informação encontra-se na **coluna Notas** da linha na nova versão do dashboard. Isso garantirá que suas versões anteriores do dashboard não sejam afetadas pela alteração.

# Gerenciar links do dashboard
<a name="v10-dash-manage-dashboard-links"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Você pode usar links para navegar entre dashboards comumente usados ou para conectar outras pessoas às suas visualizações. Os links permitem criar atalhos para outros dashboards, painéis e até sites externos.

O Grafana é compatível com links de dashboard, links de painéis e links de dados. Os links do dashboard são exibidos na parte superior do dashboard. Os links do painel podem ser acessados clicando em um ícone no canto superior esquerdo do painel.

**Escolher qual link usar**

Comece descobrindo como você está navegando atualmente entre os dashboards. Se você costuma alternar entre um conjunto de dashboards e tem dificuldades para encontrar o mesmo contexto em cada um, os links podem ajudar a otimizar seu fluxo de trabalho.

A próxima etapa é descobrir qual tipo de link é adequado para seu fluxo de trabalho. Embora todos os tipos de links no Grafana sejam usados para criar atalhos para outros dashboards ou sites externos, eles funcionam em contextos diferentes.
+ Se o link estiver relacionado à maioria, se não a todos, dos painéis no dashboard, use os links do dashboard.
+ Se você quiser detalhar para acessar painéis específicos, use os links do painel.
+ Se quiser um link para um site externo, você pode usar um link de dashboard ou um link de painel.
+ Se você quiser detalhar para acessar uma série específica, ou até mesmo uma única medição, use links de dados.

**Controlar o intervalo de tempo usando um URL**

Para controlar o intervalo de tempo de um painel ou dashboard, você pode fornecer parâmetros de consulta no URL do dashboard:
+ `from` define o limite mínimo do intervalo de tempo, especificado em ms epoch.
+ `to` define o limite máximo do intervalo de tempo, especificado em ms epoch.
+ `time` e `time.window` definem um intervalo de tempo de `time-time.window/2` a `time+time.window/2`. Ambos os parâmetros devem ser especificados em ms. Por exemplo, `?time=1500000000000&time.window=10000` resultará em um intervalo de tempo de 10s de 1499999995000 a 1500000005000.

**Links do Dashboard**

Ao criar um link para do dashboard, você pode incluir o intervalo de tempo e as variáveis atuais do modelo para ir diretamente para o mesmo contexto em outro dashboard. Dessa forma, você não precisa se preocupar se a pessoa para quem você enviou o link está vendo os dados corretos. Para outros tipos de links, consulte [Variáveis de links de dados]().

Os links do painel também podem ser usados como atalhos para sistemas externos, como enviar um GitHub problema com o nome atual do painel.

Depois de adicionar um link do dashboard, ele aparecerá no canto superior direito do dashboard.

**Adicionar links aos dashboards**

Adicione links para outros dashboards na parte superior do seu dashboard atual.

**Para adicionar um link a um dashboard**

1. Ao visualizar o dashboard que você deseja vincular, clique na engrenagem na parte superior da tela para abrir **Configurações do dashboard**.

1. Selecione **Links** e depois **Adicionar link do dashboard** ou **Novo**.

1. Em **Tipo**, selecione **dashboards**.

1. Selecione uma das opções de links a seguir.
   + **Com tags**: insira tags para limitar os dashboards vinculados somente àqueles com as tags inseridas. Caso contrário, o Grafana incluirá links para todos os outros dashboards.
   + **Como menu suspenso** — Se você estiver vinculando vários painéis, por padrão, o Grafana os side-by-side exibe na parte superior do painel. Selecionar essa opção e adicionar um título opcional exibirá os links em uma lista suspensa.
   + **Intervalo de tempo**: selecione esta opção para incluir o intervalo de tempo do dashboard no link. Quando o usuário clicar no link, o dashboard vinculado será aberto com o intervalo de tempo indicado já definido.
   + **Valores de variáveis**: selecione esta opção para incluir as variáveis de modelo usadas atualmente como parâmetros de consulta no link. Quando o usuário clica no link, todos os modelos correspondentes no dashboard vinculado são definidos para os valores do link. Para obter mais informações, consulte [Variáveis do URL do dashboard](v10-dash-dashboard-url-variables.md).
   + **Abrir em uma nova guia**: selecione esta opção se quiser que o link do dashboard seja aberto em uma nova guia ou janela.

1. Clique em **Add (Adicionar)**.

**Adicionar um link de URL a um dashboard**

Adicione um link para um URL na parte superior do dashboard atual. Você pode vincular a qualquer URL disponível, incluindo dashboards, painéis ou sites externos. Você pode até mesmo controlar o intervalo de tempo para garantir que o usuário amplie os dados corretos no Grafana.

**Para adicionar um link de URL a um dashboard**

1. Ao visualizar o dashboard que você deseja vincular, selecione a engrenagem na parte superior da tela para abrir **Configurações do dashboard**.

1. Selecione **Links** e depois **Adicionar link do dashboard** ou **Novo**.

1. Em **Tipo**, selecione**Link**.

1. Selecione uma das opções de links a seguir.
   + **URL**: insira o URL ao qual você deseja vincular. Dependendo do destino, talvez você queira incluir valores de campo.
   + **Título**: insira o título que você deseja que o link exiba.
   + **Dica de ferramenta**: insira a dica de ferramenta que você deseja que o link exiba.
   + **Ícone**: escolha o ícone que você deseja exibir com o link.
   + **Intervalo de tempo**: selecione esta opção para incluir o intervalo de tempo do dashboard no link. Quando o usuário clica no link, o dashboard vinculado é aberto com o intervalo de tempo indicado definido.
     + `from`: define o limite mínimo do intervalo de tempo, especificado em ms epoch.
     + `to`: define o limite máximo do intervalo de tempo, especificado em ms epoch.
     + `time` e `time.window`: definem um intervalo de tempo de `time-time.window/2` a `time+time.window/2`. Ambos os parâmetros devem ser especificados em ms. Por exemplo, `?time=1500000000000&time.window=10000` resultará em um intervalo de tempo de 10s de 1499999995000 a 1500000005000.
   + **Valores de variáveis**: selecione esta opção para incluir as variáveis de modelo usadas atualmente como parâmetros de consulta no link. Quando o usuário clica no link, todos os modelos correspondentes no dashboard vinculado são definidos para os valores do link.

     O formato variável é o seguinte:

     ```
     https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
     ```
   + **Abrir em uma nova guia**: selecione esta opção se quiser que o link do dashboard seja aberto em uma nova guia ou janela

1. Selecione **Adicionar**.

**Atualizar um link do dashboard**

Para alterar ou atualizar um link existente do dashboard, siga este procedimento.

**Para atualizar um link do dashboard**

1. Em **Configurações do dashboard,** na guia **Links**, selecione o link existente que você deseja editar.

1. Altere as configurações e escolha **Atualizar**.

**Duplicar um link do dashboard**

Para duplicar um link existente do dashboard, selecione o ícone de duplicar ao lado do link existente que você deseja duplicar.

**Excluir um link do dashboard**

Para excluir um link existente do dashboard, clique no ícone de lixeira ao lado do link que você deseja excluir.

**Links do painel**

Cada painel pode ter seu próprio conjunto de links que são mostrados no canto superior esquerdo do painel. Você pode vincular a qualquer URL disponível, incluindo dashboards, painéis ou sites externos. Você pode até mesmo controlar o intervalo de tempo para garantir que o usuário amplie os dados corretos no Grafana.

Para ver os links disponíveis do dashboard, selecione o ícone à direita do título do painel.
+ **Adicionar um link de painel**: cada painel pode ter seu próprio conjunto de links que são mostrados no canto superior esquerdo do painel. Você pode vincular a qualquer URL disponível, incluindo dashboards, painéis ou sites externos. Você pode até mesmo controlar o intervalo de tempo para garantir que o usuário amplie os dados corretos no Grafana. Clique no ícone no canto superior esquerdo de um painel para ver os links disponíveis.

  1. Passe o cursor sobre o painel ao qual você deseja adicionar um link.

  1. Selecione o menu e escolha **Editar**, ou você pode usar o atalho de teclado `e`.

  1. Expanda a seção **Opções do painel** e role para baixo até **Links do painel**.

  1. Selecione **Adicionar link**.

  1. Insira um **Título**. Este é um rótulo legível para o link que será exibido na interface do usuário.

  1. Insira o **URL** ao qual você deseja vincular. Pressione `Ctrl+Space` (ou `Cmd+Space`) e selecione o campo do URL para ver as variáveis disponíveis. Ao adicionar variáveis de modelo ao link do painel, o link direcionará o usuário para o contexto correto, com as variáveis relevantes já definidas.

     Você também pode usar variáveis de tempo.
     + `from` define o limite mínimo do intervalo de tempo, especificado em ms epoch.
     + `to` define o limite máximo do intervalo de tempo, especificado em ms epoch.
     + `time` e `time.window` definem um intervalo de tempo de `time-time.window/2` a `time+time.window/2`. Ambos os parâmetros devem ser especificados em ms. Por exemplo, `?time=1500000000000&time.window=10000` resultará em um intervalo de tempo de 10s de 1499999995000 a 1500000005000.
+ **Atualizar um link do painel**

  1. Selecione um painel (ou coloque o cursor sobre o painel) para exibir um menu de ações no canto superior direito do painel.

  1. No menu, selecione **Editar**.

     Você também pode usar o atalho do teclado `e`.

  1. Expanda a seção **Opções do painel** e role para baixo até **Links do painel**.

  1. Encontre o link que você deseja alterar e selecione o ícone de **Editar** (lápis) ao lado dele.

  1. Faça alterações se for necessário.

  1. Selecione **Salvar** para salvar as alterações e feche a janela.

  1. Selecione **Salvar** no canto superior direito para salvar as alterações no dashboard.
+ **Excluir um link do painel**

  1. Selecione um painel (ou coloque o cursor sobre o painel) para exibir um menu de ações no canto superior direito do painel.

  1. No menu, selecione **Editar**.

     Você também pode usar o atalho do teclado `e`.

  1. Expanda a seção **Opções do painel** e role para baixo até **Links do painel**.

  1. Encontre o link que você deseja excluir e selecione o ícone **X** ao lado dele.

  1. Selecione **Salvar** no canto superior direito para salvar as alterações no dashboard.

# Anotar visualizações
<a name="v10-dash-annotations"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

As anotações fornecem uma forma de marcar pontos em uma visualização com eventos importantes. Eles são visualizados como linhas verticais e ícones em todos os painéis de grafos. Ao passar o mouse sobre uma anotação, você pode obter a descrição e as tags do evento. O campo de texto pode incluir links para outros sistemas com mais detalhes.

Você pode anotar visualizações de três formas:
+ Diretamente no painel, usando a [consulta integrada de anotações](#v10-dash-built-in-query).
+ Usar a API HTTP do Grafana.
+ Configurando consultas de anotação nas configurações do dashboard.

Nos dois primeiros casos, você está criando anotações, enquanto no último você está consultando anotações existentes de fontes de dados. A consulta integrada de anotações também é compatível com isso.

Esta seção explica a primeira e terceira opções. Para obter informações sobre como usar a API HTTP do Grafana, consulte [API de anotações](Grafana-API-Annotations.md).

As anotações são compatíveis com os seguintes tipos de visualização:
+ Séries temporais 
+ Linha do tempo dos estados
+ Candlestick

## Criar anotações em painéis
<a name="v10-dash-create-annotations-in-panels"></a>

O Grafana vem com a capacidade de adicionar eventos de anotação diretamente de um painel usando a [consulta integrada de anotações](#v10-dash-built-in-query) que existe em todos os dashboards. As anotações que você cria dessa forma são armazenadas no Grafana.

Para adicionar anotações diretamente no painel:
+ O dashboard já deve estar salvo.
+ A consulta integrada deve estar habilitada.

**Para adicionar uma anotação**

1. No dashboard, selecione o painel ao qual você está adicionando a anotação. Um menu de contexto aparecerá. 

1. No menu de contexto, selecione **Adicionar anotação**.

1. (Opcional) Adicione uma descrição da anotação e tags.

1. Selecione **Salvar**.

Como alternativa, para adicionar uma anotação, pressione `Ctrl` (ou `Cmd`) ao selecionar o painel, e o pop-over **Adicionar anotação** aparecerá.

**Anotações de regiões**

Você também pode criar anotações que cubram uma região ou um período de tempo em uma visualização.

**Para adicionar uma anotação de região**

1. No dashboard, pressione `Ctrl` (ou `Cmd`) enquanto seleciona uma área do painel.

1.  Adicione uma descrição da anotação e tags (opcional). 

1.  Clique em **Salvar**. 

**Para editar uma anotação**

1. No dashboard, passe o mouse sobre um indicador de anotação em um painel.

1. Selecione o ícone de **Editar** (lápis) na dica de ferramenta de anotação.

1. Modifique as and/or tags de descrição.

1. Selecione **Salvar**.

**Para excluir uma anotação**

1. No dashboard, passe o mouse sobre um indicador de anotação em um painel.

1. Selecione o ícone de **Excluir** (lixeira) na dica de ferramenta Delete anotação.

## Busque anotações por meio das configurações do dashboard
<a name="v10-dash-fetch-annotations"></a>

Nas configurações do dashboard, em **Anotações**, você pode adicionar novas consultas para buscar anotações usando qualquer fonte de dados, incluindo a fonte de dados integrada de anotações de dados. As consultas de anotações retornam eventos que podem ser visualizados como marcadores de eventos em grafos em todo o dashboard. 

**Para adicionar uma nova consulta de anotação**

1. Selecione o ícone de **Configurações** (engrenagem) no cabeçalho do dashboard para abrir o menu de configurações.

1. Selecione **Anotações**.

1. Clique em **Adicionar consulta de anotação.**

1. Insira um nome para a consulta de anotação.

   Esse nome é dado ao botão de alternância (caixa de seleção) que permitirá que você habilite a exibição de eventos de anotação dessa consulta. 

1. Selecione a fonte de dados para as anotações.

   Você também pode escolher **Abrir seletor avançado de fonte de dados** para ver mais opções, incluindo a adição de uma nova fonte de dados (disponível somente para administradores).

1. Se você não quiser usar a consulta de anotação de imediato, desmarque a caixa de seleção **Habilitado**.

1. Se você não quiser que o botão de alternância de consulta de anotação seja exibido no dashboard, marque a caixa de seleção **Oculto**.

1. Selecione uma cor para os marcadores de eventos.

1. No menu suspenso **Mostrar em**, escolha uma das seguintes opções:
   + **Todos os painéis**: as anotações são exibidas em todos os painéis compatíveis com anotações.
   + **Painéis selecionados**: as anotações são exibidas em todos os painéis selecionados.
   + **Todos os painéis, exceto**: as anotações são exibidas em todos os painéis, exceto nos que você selecionar.

1. Configure a consulta.

   As opções de consulta de anotação são diferentes para cada fonte de dados. Para obter informações sobre anotações em uma fonte de dados específica, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).

## Consulta integrada
<a name="v10-dash-built-in-query"></a>

Depois de adicionar uma anotação, elas ainda estarão visíveis. Isso se deve à consulta de anotação integrada que existe em todos os dashboards. Essa consulta de anotação buscará todos os eventos de anotação originários do dashboard atual, armazenados no Grafana, e os mostrará no painel em que foram criados. Isso inclui anotações do histórico dos estados dos alertas.

Por padrão, a consulta integrada de anotação usa a fonte de dados especial do `Grafana`, e as anotações manuais só são compatíveis usando essa fonte de dados. Você pode usar outra fonte de dados na consulta integrada de anotação, mas só poderá criar anotações automatizadas usando o editor de consultas dessa fonte de dados.

Para adicionar anotações diretamente ao dashboard, essa consulta deve estar habilitada.

**Para confirmar se a consulta integrada está habilitada**

1. Selecione o ícone de **configurações** (engrenagem) do dashboard no cabeçalho do dashboard para abrir o menu de configurações.

1. Selecione **Anotações**. 

1. Encontre a consulta **Anotações e alertas (integrado)**.

   Se mostrar **Desabilitado** antes do nome da consulta, você precisará selecionar o nome da consulta para abri-la e atualizar a configuração.

**Para impedir que as anotações sejam buscadas e extraídas**

1. Selecione o ícone de **configurações** (engrenagem) do dashboard no cabeçalho do dashboard para abrir o menu de configurações.

1. Selecione **Anotações**. 

1. Selecione a consulta **Anotações e alertas (integrado)**.

1. Selecione o botão de alternância **Habilitado** para desativá-lo.

Quando você copia um dashboard usando o recurso **Salvar como**, ele recebe um novo ID de dashboard, portanto, as anotações criadas no dashboard de origem não estarão mais visíveis na cópia. Você ainda poderá mostrá-las se adicionar uma nova **Consulta de anotação** e filtrar por tags. No entanto, isso só funcionará se as anotações no dashboard de origem tiverem tags pelas quais filtrar.

**Filtrar consultas por tag**

Você pode criar novas consultas para buscar anotações da consulta de anotação integrada usando a fonte de dados `Grafana` ao definir **Filtrar por** para `Tags`.

Por exemplo, crie um nome de consulta de anotação `outages` e especifique uma tag `outage`. Essa consulta mostrará todas as anotações (de qualquer dashboard ou via API) com a tag `outage`. Se várias tags forem definidas em uma consulta de anotação, o Grafana mostrará apenas as anotações que correspondam a todas as tags. Para modificar o comportamento, habilite **Corresponder qualquer** e o Grafana mostrará anotações que contêm qualquer uma das tags que você forneceu.

 Você também pode usar variáveis de modelo na consulta de tag. Isso significa que se você tiver um dashboard mostrando estatísticas de diferentes serviços e uma variável de modelo que determina quais serviços mostrar, você pode usar a mesma variável de modelo em sua consulta de anotação para mostrar apenas anotações para esses serviços. 

# Modelo JSON do dashboard
<a name="v10-dash-dashboard-json-model"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Um dashboard no Grafana é representado por um objeto JSON, que armazena metadados de seu dashboard. Os metadados do dashboard incluem propriedades do dashboard, metadados dos painéis, variáveis do modelo e consultas do painel.

**Para visualizar o JSON de um dashboard**

1. Navegue até um dashboard.

1. No menu de navegação superior, selecione o ícone de **Configurações do dashboard** (engrenagem).

1. Selecione o **modelo JSON**.

## Campos JSON
<a name="v10-dash-json-fields"></a>

Quando um usuário cria um novo dashboard, um novo objeto JSON do dashboard é inicializado com os campos a seguir.

**nota**  
No JSON a seguir, o ID é mostrado como nulo, que é o valor padrão atribuído a ele até que um dashboard seja salvo. Depois que um dashboard é salvo, um valor inteiro é atribuído ao campo `id`.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

A seguir, descrevemos cada campo no JSON do dashboard.


| Nome | Usage | 
| --- | --- | 
| `id` | identificador numérico exclusivo para o dashboard (gerado pelo banco de dados) | 
| `uid` | identificador de dashboard exclusivo que pode ser gerado por qualquer pessoa. string (8-40) | 
| `title` | título atual do dashboard | 
| `tags` | tags associadas ao dashboard, uma matriz de strings | 
| `style` | tema do dashboard, como `dark` ou `light` | 
| `timezone` | fuso horário do dashboard, como `utc` ou `browser` | 
| `editable` | se um dashboard é editável ou não | 
| `graphTooltip` | 0 para nenhuma dica de ferramenta ou crosshair compartilhado (padrão), 1 para crosshair compartilhado, 2 para crosshair e dica de ferramenta compartilhados | 
| `time` | intervalo de tempo para o dashboard, como `last 6 hours` ou `last 7 days` | 
| `timepicker` | metadados do timepicker, consulte a [seção timepicker](#v10-dash-json-panels) para obter detalhes | 
| `templating` | metadados de modelos, consulte a [seção de modelos](#v10-dash-json-panels) para obter detalhes | 
| `annotations` | metadados de anotações, consulte as [anotações](v10-dash-annotations.md) para saber como adicioná-los | 
| `refresh` | intervalo de atualização automática | 
| `schemaVersion` | versão do esquema JSON (inteiro), incrementada toda vez que uma atualização do Grafana traz alterações para esse esquema | 
| `version` | versão do dashboard (inteiro), incrementada toda vez que o dashboard é atualizado | 
| `panels` | matriz de painéis (consulte a próxima seção para obter detalhes) | 

## Painéis
<a name="v10-dash-json-panels"></a>

Os painéis são os blocos de criação de um dashboard. Ele consiste em consultas de fontes de dados, tipos de grafos, aliases e muito mais. O painel JSON consiste em uma matriz de objetos JSON, cada um representando um painel diferente. A maioria dos campos é comum a todos os painéis, mas alguns campos dependem do tipo de painel. Veja a seguir um exemplo de painel JSON de um painel de texto.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Tamanho e posição do painel**

A propriedade gridPos descreve o tamanho e a posição do painel nas coordenadas da grade.
+ `w`: 1 a 24 (a largura do dashboard é dividida em 24 colunas).
+ `h`: em unidades de altura da grade, cada uma representa 30 pixels.
+ `x`: a posição x, na mesma unidade que `w`.
+ `y`: a posição y, na mesma unidade que `h`.

A grade tem uma gravidade negativa que moverá os painéis para cima se houver espaço vazio acima de um painel.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Modelos **

O campo `templating` contém uma matriz de variáveis de modelos com os valores salvos junto com alguns outros metadados.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

A tabela a seguir descreve o uso dos campos de modelos.


| Nome | Usage | 
| --- | --- | 
|  `enable`  |  se modelos está habilitado ou não  | 
|  `list`  |  uma matriz de objetos, cada um representando uma variável de modelo  | 
|  `allFormat`  |  formato a ser usado ao buscar todos os valores da fonte de dados, incluindo `wildcard`, `glob`, `regex` e `pipe`.  | 
|  `current`  |  mostra a variável selecionada atualmente text/value no painel  | 
|  `datasource`  |  mostra a fonte de dados para as variáveis  | 
|  `includeAll`  |  se todas as opções de valor estão disponíveis ou não  | 
|  `multi`  |  se vários valores podem ser selecionados ou não na lista de valores de variáveis  | 
|  `multiFormat`  |  formato a ser usado ao buscar séries temporais da fonte de dados  | 
|  `name`  |  nome da variável  | 
|  `options`  |  matriz de text/value pares de variáveis disponíveis para seleção no painel  | 
|  `query`  |  consulta de fonte de dados usada para buscar valores para uma variável  | 
|  `refresh`  |  configura quando atualizar uma variável  | 
|  `regex`  |  extrai parte do nome de uma série ou segmento do nó de métricas  | 
|  `type`  |  tipo de variável, `custom`, `query` ou `interval`  | 

# Práticas recomendadas para dashboards
<a name="v10-dash-bestpractices"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Esta seção fornece informações sobre as práticas recomendadas para administradores e usuários do Grafana sobre como criar e manter dashboards do Grafana.

Para obter informações sobre os diferentes tipos de dashboards que você pode criar, consulte a postagem do blog [Grafana dashboards: A complete guide to all the different types you can build](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) no site da Grafana Labs.

**nota**  
Esta seção pode ajudar a criar uma estratégia para o monitoramento e a manutenção do dashboard. Você conhece melhor seus sistemas e deve usar esta seção para ajudar na sua compreensão. Em última análise, é sua responsabilidade criar a melhor estratégia para o seu sistema.

## Estratégias comuns de observabilidade
<a name="v10-dash-common-observability-strategies"></a>

Quando você tem muito a monitorar, como um parque de servidores, precisa de uma estratégia para decidir o que é realmente importante para monitorar. Esta página descreve vários métodos comuns para escolher o que monitorar.

Uma estratégia lógica permite criar dashboards uniformes e escalar a plataforma de observabilidade com mais facilidade.

**Diretrizes para estratégias**
+ O método USE mostra o quanto as máquinas estão satisfeitas, o método RED mostra o quanto os usuários estão satisfeitos.
+ Relatórios USE sobre as causas dos problemas.
+ O RED relata a experiência do usuário e é mais provável de relatar os sintomas de problemas.
+ O monitoramento de ambos é importante para entender o sistema. Como prática recomendada, alerte sobre os sintomas em vez das causas. Normalmente, os alertas são configurados em dashboards RED.

**Método USE**

USE significa:
+ **Utilização**: a porcentagem de tempo em que o recurso está ocupado, como o uso do nó da CPU.
+ **Saturação**: a quantidade de trabalho que um recurso precisa realizar, geralmente o tamanho da fila ou a carga do nó.
+ **Erros**: a contagem de eventos de erros.

Esse método é melhor para recursos de hardware em infraestrutura, como CPU, memória e dispositivos de rede. Para obter mais informações, consulte a postagem do blog de Brendan Gregg, [The USE Method](http://www.brendangregg.com/usemethod.html).

**Método RED**

RED significa:
+ **Taxa**: solicitações por segundo.
+ **Erros**: número de solicitações que estão falhando.
+ **Duração**: período de tempo que essas solicitações levam, distribuição das medições de latência.

Esse método é mais aplicável a serviços, especialmente a um ambiente de microsserviços. Para cada um dos seus serviços, instrumente o código para expor essas métricas para cada componente. Os painéis RED são bons para alertar e. SLAs Um dashboard RED bem projetado é um proxy para a experiência do usuário.

Para obter mais informações, consulte a postagem do blog de Tom Wilkie [The RED method: How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**Os quatro sinais dourados**

De acordo com o [Manual do SRE do Google](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), se você puder avaliar apenas quatro métricas do seu sistema voltado para o usuário, concentre-se nestas quatro.

Esse método é semelhante ao método RED, mas inclui saturação.
+ **Latência**: tempo gasto para atender a uma solicitação.
+ **Tráfego**: a previsão de demanda para seu sistema.
+ **Erros**: taxa de solicitações que estão falhando.
+ **Saturação**: o quão “cheio” seu sistema está.

## Modelo de maturidade do gerenciamento de dashboards
<a name="v10-dash-management-maturity-model"></a>

A *maturidade do gerenciamento de dashboards* refere-se ao quão bem projetado e eficiente é o ecossistema de dashboards. Recomendamos revisar periodicamente a configuração do dashboard para avaliar onde você está e como você pode melhorar.

Em termos gerais, a maturidade do dashboard pode ser definida como baixa, média ou alta. 

 Muito do conteúdo desse tópico foi retirado da palestra [Fool-Proof Kubernetes Dashboards for Sleep-Prived Oncalls](https://www.youtube.com/watch?v=YE2aQFiMGfY) de KubeCon 2019. 

**Baixa: estado padrão**

Neste estágio, você não tem uma estratégia coerente de gerenciamento de dashboards. Quase todo mundo começa aqui.

Como você pode saber que está aqui?
+ Todos podem modificar seus dashboards.
+ Muitos dashboards copiados, pouca ou nenhuma reutilização do dashboard.
+ Dashboards únicos que duram para sempre.
+ Nenhum controle de versão (JSON do dashboard com controle de versão).
+ Muita navegação por dashboards, busca pelo dashboard certo. Isso significa muito tempo perdido tentando encontrar o dashboard de que você precisa.
+ Não há nenhum alerta para direcionar você para o dashboard certo.

**Média: dashboards metódicos**

Neste estágio, você está começando a gerenciar o uso do dashboard com dashboards metódicos. Você pode ter traçado uma estratégia, mas há algumas coisas que você poderia melhorar.

 Como você pode saber que está aqui? 
+ Evite a dispersão usando variáveis de modelo. Por exemplo, você não precisa de um dashboard separado para cada nó. Você pode usar variáveis de consulta. Melhor ainda, você também pode tornar a fonte de dados uma variável de modelo para poder reutilizar o mesmo dashboard em diferentes clusters e backends de monitoramento.

  Consulte a lista de exemplos em [Variáveis](v10-dash-variables.md) para obter ideias.
+ Dashboards metódicos de acordo com uma [estratégia de observabilidade](#v10-dash-common-observability-strategies).
+ Dashboards hierárquicos com opções para acessar o próximo nível.
+ O design do dashboard reflete as hierarquias de serviços. Por exemplo, é possível usar o método RED com uma linha por serviço. A ordem das linhas pode refletir o fluxo de dados à medida que você rola para baixo no dashboard.
+ Compare coisas semelhantes: divida os dashboards de serviços quando a magnitude for diferente. Certifique-se de que as métricas agregadas não ocultem informações importantes.
+ Gráficos expressivos com uso significativo de cores e eixos de normalização sempre que possível.
  + Exemplo de cor significativa: azul significa que é bom, vermelho significa que é ruim. Os [limites](v10-panels-configure-thresholds.md) podem ajudar com isso.
  + Exemplo de eixos de normalização: ao comparar o uso da CPU, avalie por porcentagem em vez de pelo número bruto, pois as máquinas podem ter um número diferente de núcleos. Normalizar o uso da CPU pelo número de núcleos reduz a carga cognitiva porque o espectador pode confiar que, em 100%, todos os núcleos estão sendo usados, sem precisar saber o número deles CPUs.
+ A navegação direcionada reduz a suposição.
  + As variáveis do modelo dificultam a navegação aleatória ou sem propósito.
  + A maioria dos dashboards deve ser vinculada por alertas.
  + A navegação é direcionada com links. Para obter mais informações, consulte [Gerenciar links do dashboard](v10-dash-manage-dashboard-links.md).
+  JSON do dashboard com controle de versão. 

**Alta: uso otimizado**

Neste estágio, você otimizou o uso do gerenciamento do dashboard com uma estratégia consistente e cuidadosa. Requer manutenção, mas os resultados valem a pena.
+ Redução ativa da dispersão.
  + Analise regularmente os dashboards existentes para garantir que sejam relevantes.
  + Somente dashboards aprovados foram adicionados à lista de dashboards principais.
  + Rastreamento do uso do dashboard. Você pode aproveitar os [Insights de uso](v10-dash-assess-dashboard-usage.md).
+ Consistência por projeto.
+ Use bibliotecas de scripts para gerar dashboards e garantir a consistência no padrão e no estilo.
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ Nenhuma edição no navegador. Os visualizadores do dashboard alteram as visualizações com variáveis.
+ Procurar dashboards é a exceção, não a regra.
+ Faça experiências e testes em uma instância separada do Grafana dedicada a esse propósito, não em sua instância de produção. Quando um dashboard no ambiente de teste for comprovadamente útil, adicione-o à instância principal do Grafana.

## Práticas recomendadas para criar dashboards
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

Esta seção descreve algumas práticas recomendadas a serem seguidas ao criar dashboards do Grafana.

**Antes de começar**

 Aqui estão alguns princípios a serem considerados antes de criar um dashboard. 

**Um dashboard deve contar uma história ou responder a uma pergunta**

Que história você está tentando contar com seu dashboard? Tente criar uma progressão lógica de dados, como de grandes para pequenos ou de gerais para específicos. Qual é o objetivo desse dashboard? (Dica: se o dashboard não tiver um objetivo, pergunte a si mesmo se realmente precisa dele.)

Mantenha seus grafos simples e focados em responder à pergunta que você está fazendo. Por exemplo, se a pergunta for “quais servidores estão com problemas?”, então talvez você não precise mostrar todos os dados de servidores. Basta mostrar os dados dos que estão com problemas.

**Os dashboards devem reduzir a carga cognitiva, não aumentá-la**

A *carga cognitiva* é basicamente a dificuldade que existe para se pensar sobre algo a fim de poder entendê-lo. Facilite a interpretação do dashboard. Outros usuários e você no futuro (quando estiver tentando descobrir o que se rompeu às 2h da manhã) agradecerão.

 Pergunte a si mesmo: 
+ Posso dizer exatamente o que cada grafo representa? Está óbvio ou eu tenho de pensar sobre ele?
+ Se eu mostrar isso para outra pessoa, quanto tempo ela levará para descobrir? Eles vão se perder?

**Tenha uma estratégia de monitoramento**

É fácil criar dashboards. É mais difícil otimizar a criação de dashboards e seguir um plano, mas vale a pena. Essa estratégia deve orientar o esquema geral do dashboard e garantir a consistência no design individual do dashboard.

Consulte [Estratégias comuns de observabilidade](#v10-dash-common-observability-strategies) e [Níveis de maturidade do gerenciamento de dashboards](#v10-dash-management-maturity-model) para obter mais informações.

**Anote isto**

Depois de ter uma estratégia ou as diretrizes do projeto, anote-as para ajudar a manter a consistência ao longo do tempo.

**Práticas recomendadas a serem seguidas**
+ Ao criar um novo dashboard, verifique se ele tem um nome significativo.
  + Se estiver criando um dashboard para jogar ou experimentar, coloque a palavra `TEST` ou `TMP` no nome.
  + Considere incluir seu nome ou iniciais no nome do dashboard ou como uma tag para que as pessoas saibam quem é o proprietário do dashboard.
  + Remova os dashboards temporários do experimento quando terminar de usá-los.
+ Se você criar muitos dashboards relacionados, pense em como fazer uma referência cruzada para facilitar a navegação. Para obter mais informações, consulte [Práticas recomendadas para gerenciamento de dashboards](#v10-dash-best-practices-for-managing-dashboards), posteriormente nesta seção.
+ O Grafana recupera dados de uma fonte de dados. Uma compreensão básica de [Conectar-se à fonte de dados](AMG-data-sources.md) em geral, e de suas fontes de dados específicas, é importante.
+ Evite a atualização desnecessária do dashboard para reduzir a carga na rede ou no backend. Por exemplo, se seus dados mudarem a cada hora, então não precisará definir a taxa de atualização do dashboard para 30 segundos.
+ Use os eixos Y esquerdo e direito ao exibir séries temporais com unidades ou intervalos diferentes.
+ Adicione documentação aos dashboards e painéis.
  + Para adicionar documentação a um dashboard, adicione uma [Visualização do painel de texto](v10-panels-text.md) ao dashboard. Registre coisas como a finalidade do dashboard, links de recursos úteis e quaisquer instruções de que os usuários possam precisar para interagir com o dashboard.
  + Para adicionar documentação a um painel, edite as configurações do painel e adicione uma descrição. Qualquer texto que você adicionar aparecerá se você passar o cursor sobre o pequeno `i` no canto superior esquerdo do painel.
+ Reutilize seus dashboards e garanta a consistência usando [modelos e variáveis](v10-dash-variables.md).
+ Tenha cuidado ao empilhar dados de grafos. As visualizações podem ser enganosas e ocultar dados importantes. Recomendamos desativá-lo na maioria dos casos.

## Práticas recomendadas para gerenciamento de dashboards
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 Esta página descreve algumas práticas recomendadas a serem seguidas durante o gerenciamento dos dashboards do Grafana. 

**Antes de começar**

Aqui estão alguns princípios a serem considerados antes de começar a gerenciar dashboards.

**Observabilidade estratégica**

Existem várias [estratégias comuns de observabilidade](#v10-dash-common-observability-strategies). Você deve pesquisá-las e decidir se uma delas funciona para você ou se deseja criar a sua própria. De qualquer forma, tenha um plano, anote-o e cumpra-o.

Adapte sua estratégia às necessidades dinâmicas, conforme necessário.

**Nível de maturidade**

Qual é o nível de maturidade do dashboard? Analise a configuração atual do dashboard e compare-a com o [Modelo de maturidade do gerenciamento do dashboard](#v10-dash-management-maturity-model). Entender onde você está pode ajudar a decidir como chegar aonde você deseja.

**Práticas recomendadas a serem seguidas**
+ Evite a dispersão de dashboards, ou seja, o crescimento descontrolado dos dashboards. A dispersão de dashboards afeta negativamente o tempo necessário para encontrar o dashboard certo. Duplicar dashboards e alterar “uma coisa” (pior: manter as tags originais) é o tipo de dispersão mais fácil.
  + Revise periodicamente os dashboards e remova os desnecessários.
  + Se você criar um dashboard temporário, talvez para testar algo, coloque o nome com o prefixo `TEST:`. Exclua o dashboard quando terminar.
+ Copiar dashboards sem alterações significativas não é uma boa ideia.
  + Você perde atualizações no dashboard original, como alterações na documentação, correções de bugs ou adições às métricas.
  + Em muitos casos, as cópias estão sendo feitas para simplesmente personalizar a visualização definindo os parâmetros do modelo. Em vez disso, isso deve ser feito mantendo um link para o dashboard principal e personalizando a visualização com [parâmetros de URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables).
+ Quando precisar copiar um dashboard, renomeie-o claramente e *não* copie as tags dele. As tags são metadados importantes para dashboards usados durante a pesquisa. Copiar tags pode resultar em correspondências falsas.
+ Mantenha um dashboard de dashboards ou dashboards com referência cruzada. Isso pode ser feito de diversas formas: 
  + Crie links de dashboards, painéis ou links de dados. Os links podem levar para outros dashboards ou para sistemas externos. Para obter mais informações, consulte [Gerenciar links de dashboard](v10-dash-manage-dashboard-links.md).
  +  Adicione um [Painel de lista de dashboards](v10-panels-dashboard-list.md). Em seguida, você pode personalizar o que visualiza fazendo pesquisas por tags ou pastas.
  + Adicione um [painel de texto](v10-panels-dashboard-list.md) e use o markdown para personalizar a exibição. 

# Gerenciar dashboards
<a name="v10-dash-managing-dashboards"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Na página **Dashboards** do espaço de trabalho (disponível ao selecionar **Dashboards** no menu à esquerda), você pode realizar tarefas de gerenciamento de dashboards, incluindo organizá-los em pastas.

Para obter mais informações sobre criar dashboards, consulte [Criar dashboards](v10-dash-building-dashboards.md).

## Navegar nos dashboards
<a name="v10-dash-browse-dashboards"></a>

Na página **Dashboards**, você pode navegar e gerenciar pastas e dashboards. Isso inclui opções para:
+ Criar pastas e dashboards.
+ Mover dashboards entre pastas.
+ Excluir vários dashboards e pastas.
+ Navegar para uma pasta.
+ Gerenciar as permissões da pasta. Para obter mais informações, consulte [Permissões de dashboards e pastas](dashboard-and-folder-permissions.md).

## Criar pastas de dashboards
<a name="v10-dash-create-dashboard-folder"></a>

As pastas ajudam você a organizar e agrupar dashboards, o que é útil quando você tem muitos dashboards ou várias equipes usando a mesma instância do Grafana. As subpastas permitem que você crie uma hierarquia aninhada na organização do dashboard.

**Pré-requisitos**

Certifique-se de ter as permissões de administrador do Grafana. Para obter mais informações sobre permissões de dashboard, consulte [Permissões de dashboards e pastas](dashboard-and-folder-permissions.md).

**Para criar uma pasta de dashboards**

1. Fazer login no Grafana. 

1. Selecione **Dashboards** no menu à esquerda.

1. Na página **Dashboards**, selecione **Novo** e escolha **Nova pasta** no menu suspenso.

1. Insira um nome exclusivo e clique em **Criar**.

**nota**  
Ao salvar um dashboard, você pode selecionar uma pasta para salvar o dashboard ou criar uma pasta para salvá-lo.

**Para editar o nome de uma pasta**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione a pasta a ser renomeada

1. Selecione o ícone de **Editar título** (lápis) no cabeçalho e atualize o nome da pasta.

   O novo nome da pasta é salvo automaticamente.

**Permissões da pasta**

Você pode atribuir permissões a uma pasta. O dashboard na pasta herda todas as permissões que você atribuiu à pasta. Você pode atribuir permissões aos perfis, às equipes e aos usuários da organização.

**Para modificar as permissões de uma pasta**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione a pasta na lista.

1. Na página de detalhes da pasta, selecione **Ações da pasta** e depois **Gerenciar permissões** na lista suspensa.

1. Atualize as permissões conforme desejado.

Suas alterações serão salvas automaticamente.

# Gerenciar listas de reprodução
<a name="v10-dash-managing-playlists"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Uma *lista de reprodução* é uma lista de dashboards que são exibidos em uma sequência. Você pode usar uma lista de reprodução para criar consciência situacional ou apresentar as métricas para sua equipe ou visitantes. O Grafana escala automaticamente os dashboards para qualquer resolução, o que os torna perfeitos para telas grandes. Você pode acessar o recurso de lista de reprodução no menu lateral do Grafana no submenu **Dashboards**.

## Acessar, compartilhar e controlar uma lista de reprodução
<a name="v10-dash-access-share-control-playlist"></a>

Use as informações desta seção para acessar as listas de reprodução existentes. Inicie e controle a exibição de uma lista de reprodução usando um dos cinco modos disponíveis.

**Para acessar uma lista de reprodução**

1. Selecione **Listas de reprodução** no menu à esquerda.

1. Escolha uma lista de reprodução na relação de listas de reprodução existentes.

**Iniciar uma lista de reprodução**

Você pode iniciar uma lista de reprodução em cinco modos de visualização diferentes. O modo de visualização determina como os menus e a barra de navegação aparecem nos dashboards.

Por padrão, cada dashboard é exibido pelo período de tempo inserido no campo **Intervalo**, que você define ao criar ou editar uma lista de reprodução. Depois de iniciar uma lista de reprodução, você pode controlá-la com a barra de navegação na parte superior da página.

**Para iniciar uma lista de reprodução**

1. Acesse a página de lista de reprodução para ver uma relação das listas de reprodução existentes.

1. Encontre a lista de reprodução que você deseja iniciar e clique em **Iniciar lista de reprodução**.

   A caixa de diálogo para iniciar a lista de reprodução será aberta.

1. Selecione um dos cinco modos de lista de reprodução disponíveis com base nas informações na tabela a seguir.

1. Clique em **Iniciar <nome da lista de reprodução>**.

A lista de reprodução exibe cada dashboard pelo tempo especificado no campo `Interval`, definido ao criar ou editar uma lista de reprodução. Depois de iniciar uma lista de reprodução, você pode controlá-la com a barra de navegação na parte superior da tela.


| Modo | Description | 
| --- | --- | 
| Modo normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modo TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modo TV (com painéis de ajuste automático) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modo de quiosque |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Modo de quiosque (com painéis de ajuste automático) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 

**Controlar uma lista de reprodução**

Você pode controlar uma lista de reprodução no modo **Normal** ou **TV** depois de iniciada usando a barra de navegação na parte superior da tela. Pressione a tecla `Esc` no teclado para interromper a lista de reprodução.


| Button | Ação | 
| --- | --- | 
| Próximo (seta dupla para a direita) | Avança para o próximo dashboard. | 
| Voltar (seta para a esquerda) | Retorna ao dashboard anterior. | 
| Parar (quadrado) | Encerra a lista de reprodução e vai para o dashboard atual. | 
| Modo de visualização Ciclo (ícone do monitor) | Gira a exibição dos dashboards em diferentes modos de exibição. | 
| Intervalo de tempo | Exibe dados dentro de um intervalo de tempo. Pode ser configurado para exibir desde os últimos cinco minutos até os últimos cinco anos, ou um intervalo de tempo personalizado, usando a seta para baixo. | 
| Atualizar (seta circular) | Recarrega o dashboard para exibir os dados atuais. Pode ser configurado para recarregar automaticamente desde a cada cinco segundos até um dia, usando a seta suspensa. | 

## Criar uma lista de reprodução
<a name="v10-dash-create-playlist"></a>

Você pode criar uma lista de reprodução para apresentar dashboards em uma sequência com uma ordem e intervalo de tempo definidos entre os dashboards.

**Para criar uma lista de reprodução**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Listas de reprodução** na página de listas de reprodução.

1. Selecione **Nova lista de reprodução**.

1. Insira um nome descritivo na caixa de texto **Nome**.

1. Insira um intervalo de tempo na caixa de texto **Intervalo**. Os dashboards que você adicionar serão listados em uma ordem sequencial.

1. Em **Dashboards**, adicione dashboards existentes à lista de reprodução usando as opções suspensas **Adicionar por título** e **Adicionar por tag**.

1. Opcionalmente:
   + Pesquise um dashboard pelo nome ou por uma expressão regular ou uma tag.
   + Filtre os resultados por status ou tags com estrela.
   + Reorganize a ordem dos dashboards que você adicionou usando o ícone de seta para cima e para baixo.
   + Remova um dashboard da lista de reprodução clicando no ícone **x** ao lado dele.

1. Para salvar suas alterações, selecione **Salvar**.

## Salvar uma lista de reprodução
<a name="v10-dash-save-playlist"></a>

Você pode salvar uma lista de reprodução e adicioná-la à página **Listas de reprodução**, na qual você pode iniciá-la.

**Importante**  
Certifique-se de que todos os dashboards que você deseja que apareçam na sua lista de reprodução sejam adicionados ao criar ou editar a lista de reprodução antes de salvá-la.

**Para salvar uma lista de reprodução**

1. Selecione **Dashboards** no menu à esquerda.

1. Selecione **Listas de reprodução** para ver as que estão disponíveis para você.

1. Selecione a lista de reprodução de sua escolha.

1. Edite a lista de reprodução.

1. Verifique se a lista de reprodução tem um **Nome**, **Intervalo** e pelo menos um **Dashboard** adicionado a ela.

1. Para salvar suas alterações, selecione **Salvar**.

## Editar ou excluir uma lista de reprodução
<a name="v10-dash-edit-delete-playlist"></a>

Você pode editar uma lista de reprodução atualizando seu nome e intervalo de tempo e adicionando, removendo e reorganizando a ordem dos dashboards, ou você pode excluí-la.

**Para editar uma lista de reprodução**

1. Selecione **Editar lista de reprodução** na página de listas de reprodução.

1. Atualize o nome e o intervalo de tempo e, em seguida, adicione ou remova dashboards da lista de reprodução usando as instruções acima em Criar uma lista de reprodução.

1. Para salvar suas alterações, selecione **Salvar**.

**Para excluir uma lista de reprodução**

1. Selecione **Listas de reprodução**.

1. Selecione **Remover** ao lado da lista de reprodução que você deseja excluir.

**Para reorganizar a ordem do dashboard em uma lista de reprodução**

1. Ao lado do dashboard que você deseja mover, clique na seta para cima ou para baixo.

1. Para salvar suas alterações, selecione **Salvar**.

**Para remover um dashboard**

1. Selecione **Remover** para remover um dashboard da lista de reprodução.

1. Para salvar suas alterações, selecione **Salvar**.

## Compartilhar uma lista de reprodução no modo de visualização
<a name="v10-dash-share-playlist-view-mode"></a>

Você pode compartilhar uma lista de reprodução copiando o endereço do link no modo de visualização de sua preferência e colando o URL no seu destino.

**Para compartilhar uma lista de reprodução no modo de visualização**

1. No menu lateral esquerdo dos **Dashboards**, escolha **Listas de reprodução**.

1. Selecione **Iniciar lista de reprodução** ao lado da lista de reprodução que você deseja compartilhar.

1. No menu suspenso, clique com o botão direito do mouse no modo de visualização de sua preferência.

1. Selecione **Copiar endereço do link** para copiar o URL para a área de transferência.

1. Cole o URL no destino.

# Compartilhar dashboards e painéis
<a name="v10-dash-sharing"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

O Grafana permite que você compartilhe dashboards e painéis com outros usuários dentro de uma organização e, em determinadas situações, publicamente na Web. Você pode compartilhar usando:
+ Um link direto
+ Um snapshot
+ Um link de exportação (somente para dashboards)

Você deve ter uma permissão de visualizador autorizado para ver uma imagem renderizada por um link direto.

Quando você compartilha um painel ou dashboard como um snapshot, um snapshot (que é um painel ou dashboard no momento em que você tira o snapshot) fica disponível publicamente na Web. Qualquer pessoa com um link para ele pode acessá-lo. Como os snapshots não exigem nenhuma autorização para serem visualizados, o Grafana remove as informações relacionadas à conta de onde vieram, bem como quaisquer dados confidenciais dele.

## Compartilhar um dashboard
<a name="v10-dash-share-dashboard"></a>

Você pode compartilhar um dashboard como um link direto ou como um snapshot. Você também pode exportar um dashboard.

**nota**  
Se você alterar um dashboard, certifique-se de salvar as alterações antes de compartilhar.

**Para compartilhar um dashboard**

1. Selecione **Dashboards** no menu à esquerda no espaço de trabalho.

1. Escolha o tipo de dashboard que deseja compartilhar.

1. Selecione o ícone de compartilhamento na parte superior da tela.

   A caixa de diálogo de compartilhamento será aberta e mostrará a guia **Link**.

**Compartilhar um link direto**

A guia **Link** mostra o intervalo de tempo atual, as variáveis de modelo e o tema padrão. Você pode também compartilhar um URL encurtado.

**Para compartilhar um link direto**

1. Selecione **Copiar**. Essa ação copia o URL padrão ou encurtado para a área de transferência.

1. Envie o URL copiado para um usuário do Grafana com autorização para visualizar o link.

**Publicar um snapshot**

Um snapshot do dashboard compartilha um dashboard interativo publicamente. O Grafana remove dados confidenciais, como consultas (métrica, modelo e anotação) e links de painéis, deixando apenas os dados de métricas visíveis e os nomes das séries incorporados no dashboard. Os snapshots do dashboard podem ser acessados por qualquer pessoa com o link.

Você pode publicar snapshots na sua instância local.

**Para publicar um snapshot**

1. Selecione a guia **Snapshot**.

1. Selecione o **Snapshot local**.

1. O Grafana gera um link do snapshot. Copie o link do snapshot e compartilhe-o na sua organização ou publicamente na Web.

**Exportar um dashboard**

Os dashboards do Grafana podem ser facilmente exportados e importados. Para obter mais informações, consulte as seções de importar e exportar em [Criar dashboards](v10-dash-building-dashboards.md).

## Compartilhar um painel
<a name="v10-dash-share-panel"></a>

Você pode compartilhar um painel como um link direto ou como um snapshot. Você também pode criar painéis de biblioteca usando a opção **Compartilhar** em qualquer painel.

**Para compartilhar um painel**

1. Selecione o título do painel que você deseja compartilhar. O menu de painéis é aberto.

1. Selecione **Compartilhar**. A caixa de diálogo de compartilhamento será aberta e mostrará a guia **Link**.

**Usar um link direto**

A guia **Link** mostra o intervalo de tempo atual, as variáveis de modelo e o tema padrão. Opcionalmente, você pode habilitar um URL encurtado para compartilhar.

**Para usar um link direto**

1. Selecione **Copiar** para copiar o URL padrão ou encurtado para a área de transferência. 

1. Envie o URL copiado para um usuário do Grafana com autorização para visualizar o link.

**Publicar um snapshot de um painel**

Um snapshot de painel é o compartilhamento de um painel interativo publicamente. O Grafana retira os dados confidenciais, deixando apenas os dados de métricas visíveis e os nomes das séries incorporados no dashboard. Os snapshots do painel podem ser acessados por qualquer pessoa com o link.

Você pode publicar snapshots na sua instância local.

**Para publicar um snapshot de um painel**

1. Na caixa de diálogo **Painel de compartilhamento**, selecione a guia **Snapshot**.

1. Selecione **Snapshot local**. O Grafana gera o link do snapshot.

1. Copie o link do snapshot e compartilhe-o na sua organização ou publicamente na Web.

Se você criou um snapshot por engano, clique em **Excluir snapshot** para removê-lo da instância do Grafana.

**Criar um painel de biblioteca**

Para criar um painel de biblioteca da caixa de diálogo **Compartilhar painel**.

**Para criar um painel de biblioteca**

1. Selecione **Painel de biblioteca**.

1. Em **Nome do painel da biblioteca**, insira o nome.

1. Em **Salvar na pasta**, selecione a pasta na qual salvar o painel da biblioteca. Por padrão, a pasta raiz é selecionada.

1. Selecione **Criar painel de biblioteca** para salvar as alterações.

1. Salve o painel.

# Variáveis
<a name="v10-dash-variables"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Uma variável é um espaço reservado para um valor. Você pode usar variáveis em consultas de métricas e em títulos de painéis. Então, quando você altera o valor, usando o menu suspenso na parte superior do dashboard, as consultas de métricas do painel mudam para refletir o novo valor.

As variáveis permitem que você crie dashboards mais interativos e dinâmicos. Em vez da codificação rígida do servidor, da aplicação ou de outros nomes de sensor em suas consultas de métricas, você pode usar variáveis em seu lugar. As variáveis são exibidas como listas suspensas na parte superior do dashboard. Essas listas suspensas facilitam a alteração dos dados exibidos no dashboard.

Isso pode ser especialmente útil para administradores que desejam permitir que os visualizadores do Grafana ajustem rapidamente as visualizações, mas que não desejam conceder a eles permissões completas de edição. Os visualizadores do Grafana podem usar variáveis.

Variáveis e modelos também permitem que você crie dashboards de fonte única. Se você tiver várias fontes de dados ou servidores idênticos, poderá criar um dashboard e usar variáveis para alterar o que está visualizando. Isso simplifica consideravelmente a manutenção e a conservação.

**Modelos**

Um modelo é qualquer consulta que contém uma variável. Por exemplo, se você estivesse administrando um dashboard para monitorar vários servidores, você poderia criar um dashboard para cada servidor ou poderia criar um dashboard e usar painéis com consultas de modelo, como as a seguir.

```
wmi_system_threads{instance=~"$server"}
```

Os valores das variáveis são sempre sincronizados com o URL usando a sintaxe var-<varname>=value.

**Exemplos**

As variáveis são listadas em listas suspensas na parte superior da tela. Selecione variáveis diferentes para ver como as visualizações mudam.

Para ver as configurações das variáveis, navegue até **Configurações do dashboard > Variáveis**. Clique em uma variável na lista para ver as configurações.

As variáveis podem ser usadas em títulos, descrições, painéis de texto e consultas. As consultas com texto que começam com `$` são modelos. Nem todos os painéis terão consultas de modelo.

**Práticas recomendadas de variáveis**
+ As listas suspensas de variáveis são exibidas na ordem em que estão listadas na lista de variáveis em **Configurações do dashboard**.
+ Coloque as variáveis que você alterará com frequência na parte superior, para que elas sejam mostradas primeiro (à esquerda no dashboard).
+ Por padrão, as variáveis pré-selecionam o valor mais alto na lista suspensa. Se você quiser escolher um valor vazio em vez disso, altere as configurações da variável, da seguinte forma:

  1. Marque a caixa de seleção **Incluir todas as opções**.

  1. No campo **Personalizar todos os valores**, insira o valor `+`.

**Topics**
+ [Adicionar e gerenciar variáveis](v10-dash-variable-add.md)
+ [Inspecionar variáveis](v10-dash-variable-add-inspect.md)
+ [Sintaxe da variável](v10-dash-variable-syntax.md)

# Adicionar e gerenciar variáveis
<a name="v10-dash-variable-add"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

A tabela a seguir lista os tipos de variáveis no Grafana.


| Tipo de variável | Description | 
| --- | --- | 
| Consulta | Lista de valores gerada por consulta, como nomes de métricas, nomes de servidores, sensores IDs, data centers e assim por diante. | 
| Personalizada | Defina as opções de variáveis manualmente usando uma lista separada por vírgulas. | 
| Text box (Caixa de texto) | Exiba um campo de entrada de texto livre com um valor padrão opcional. | 
| Constante | Defina uma constante oculta. | 
| Fonte de dados | Altere rapidamente a fonte de dados de todo um dashboard. | 
| Intervalo | As variáveis de intervalo representam intervalos de tempo. | 
| Filtros ad hoc | Filtros de chave/valor que são adicionados automaticamente a todas as consultas de métricas de uma fonte de dados (somente Prometheus, Loki, InfluxDB e Elasticsearch). | 
| Variáveis globais | Variáveis internas que podem ser usadas em expressões no editor de consultas. | 
| Variáveis encadeadas | As consultas de variáveis podem conter outras variáveis. | 

**Topics**
+ [Inserir opções gerais](#v10-dash-variable-options)
+ [Adicionar uma variável de consulta.](#v10-dash-variable-add-query)
+ [Adicionar uma variável personalizada](#v10-dash-variable-add-custom)
+ [Adicionar uma variável de caixa de texto](#v10-dash-variable-add-text)
+ [Adicionar uma variável constante](#v10-dash-variable-add-constant)
+ [Adicionar uma variável de fonte de dados](#v10-dash-variable-add-datasource)
+ [Adicionar uma variável de intervalo](#v10-dash-variable-add-internal)
+ [Adicionar filtros ad hoc](#v10-dash-variable-add-adhoc)
+ [Configurar opções de seleção de variáveis](#v10-dash-variable-add-selection)
+ [Variáveis globais](#v10-dash-variable-add-global)
+ [Variáveis encadeadas](#v10-dash-variable-add-chained)
+ [Gerenciar variáveis](#v10-dash-variable-add-manage)
+ [Filtrar variáveis com regex](#v10-dash-variable-add-filter)

## Inserir opções gerais
<a name="v10-dash-variable-options"></a>

Você deve inserir opções gerais para qualquer tipo de variável que você criar.

**Para inserir opções gerais**

1. Navegue até o dashboard para o qual você deseja criar uma variável e selecione o ícone de **Configurações do dashboard** (engrenagem) na parte superior da página.

1. Na guia **Variáveis**, selecione **Nova variável**.

1. Insira um **Nome** para a variável.

1. Na lista **Tipo**, selecione **Consulta**.

1. (Opcional) Em **Rótulo**, insira o nome de exibição do menu suspenso de variáveis.

   Se você não inserir um nome de exibição, o rótulo suspenso será o nome da variável.

1. Escolha uma opção **Ocultar**:
   + **Nenhuma seleção (em branco)**: o menu suspenso de variáveis exibe o valor do **Nome** ou **Rótulo** da variável.
   + **Rótulo:** o menu suspenso de variáveis exibe somente o valor da variável selecionada e uma seta para baixo.
   + **Variável:** nenhum menu suspenso de variáveis é exibido no dashboard.

## Adicionar uma variável de consulta.
<a name="v10-dash-variable-add-query"></a>

As variáveis de consulta permitem que você escreva uma consulta de fonte de dados que pode retornar uma lista de nomes de métricas, valores de tags ou chaves. Por exemplo, uma variável de consulta pode retornar uma lista de nomes de servidores IDs, sensores ou data centers. Os valores das variáveis mudam à medida que elas buscam opções dinamicamente com uma consulta à fonte de dados.

Geralmente, as variáveis de consulta são compatíveis apenas com strings. Se sua consulta retornar números ou qualquer outro tipo de dados, talvez seja necessário convertê-los em strings para usá-los como variáveis. Para a fonte de dados Azure, por exemplo, você pode usar a função [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) para essa finalidade.

As expressões de consulta podem conter referências a outras variáveis e, na verdade, criar variáveis vinculadas. O Grafana detecta isso e atualiza automaticamente uma variável quando uma de suas variáveis vinculadas é alterada.

**nota**  
As expressões de consulta são diferentes para cada fonte de dados. Para obter mais informações, consulte a documentação da [fonte de dados](AMG-data-sources.md).

**Para adicionar uma variável de consulta**

1. Insira as opções gerais, conforme descrito acima.

1. Na lista **Fonte de dados**, selecione a fonte de dados de destino para a consulta.

1. Na lista **Atualizar**, selecione quando a variável deve atualizar as opções.
   + **No carregamento do dashboard**: consultas a fontes de dados sempre que o dashboard é carregado. Isso retarda o carregamento do dashboard, porque a consulta da variável precisa ser concluída antes que o dashboard possa ser inicializado.
   + **Na alteração de intervalo de tempo**: consultas a fonte de dados quando o intervalo de tempo do dashboard é alterado. Use esta opção somente se a consulta de opções variáveis contiver um filtro de intervalo de tempo ou depender do intervalo de tempo do dashboard.

1. No campo **Consulta**, insira uma consulta.
   + O campo de consulta varia de acordo com a fonte dos dados. Algumas fontes de dados têm editores de consulta personalizados.
   + A consulta deve retornar valores denominados `__text` e `__value`. Por exemplo, em SQL, você pode usar uma consulta como `SELECT hostname AS __text, id AS __value from MyTable`. As consultas para outras linguagens variam de acordo com a sintaxe.
   + Se você precisar de mais espaço em um único editor de consulta de campo de entrada, passe o cursor sobre as linhas no canto inferior direito do campo e arraste para baixo para expandir.

1. (Opcional) No campo **Regex**, digite uma expressão regex para filtrar ou capturar partes específicas dos nomes retornados pela consulta da fonte de dados. Para ver exemplos, consulte [Filtrar variáveis com regex](#v10-dash-variable-add-filter).

1. Na lista **Classificar**, selecione a ordem de classificação dos valores a serem exibidos na lista suspensa. A opção padrão, **Desabilitado**, significa que a ordem das opções retornadas pela consulta da fonte de dados será usada.

1. (Opcional) Insira as [Opções de seleção](#v10-dash-variable-add-selection).

1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera.

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

## Adicionar uma variável personalizada
<a name="v10-dash-variable-add-custom"></a>

Use uma variável *personalizada* para um valor que não muda, como um número ou uma string.

Por exemplo, se você tiver nomes de servidores ou nomes de regiões que nunca mudam, talvez queira criá-los como variáveis personalizadas em vez de variáveis de consulta. Como elas não mudam, você pode usá-las em [variáveis encadeadas](#v10-dash-variable-add-chained) em vez de outras variáveis de consulta. Isso reduziria o número de consultas que o Grafana deve enviar quando as variáveis encadeadas são atualizadas.

**Para adicionar uma variável personalizada**

1. Insira as opções gerais, conforme descrito acima.

1. Na lista **Valores separados por vírgula**, insira os valores dessa variável em uma lista separada por vírgula. Você pode incluir números, strings ou pares de chave/valor separados por um espaço e dois pontos. Por exemplo, .`key1 : value1,key2 : value2`

1. (Opcional) Insira as [Opções de seleção](#v10-dash-variable-add-selection).

1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera.

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

## Adicionar uma variável de caixa de texto
<a name="v10-dash-variable-add-text"></a>

As variáveis da *caixa de texto* exibem um campo de entrada de texto livre com um valor padrão opcional. Esta é a variável mais flexível, pois você pode inserir qualquer valor. Use esse tipo de variável se você tiver métricas com alta cardinalidade ou se quiser atualizar vários painéis em um dashboard ao mesmo tempo.

**Para adicionar uma variável de caixa de texto**

1. Insira as opções gerais, conforme descrito acima.

1. (Opcional) No campo **Valor padrão**, selecione o valor padrão para a variável. Se você não inserir nada nesse campo, o Grafana exibirá uma caixa de texto vazia para os usuários digitarem texto.

1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera.

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

## Adicionar uma variável constante
<a name="v10-dash-variable-add-constant"></a>

Variáveis *constantes* permitem que você defina uma constante oculta. Isso é útil para prefixos de caminhos de métricas para dashboards que você deseja compartilhar. Quando você exporta um dashboard, as variáveis constantes são convertidas em opções de importação.

Variáveis constantes *não* são flexíveis. Cada variável constante contém apenas um valor e não pode ser atualizada a menos que você atualize as configurações da variável.

Variáveis constantes são úteis quando você tem valores complexos que precisa incluir nas consultas, mas não quer digitar novamente em todas as consultas. Por exemplo, se você tivesse um caminho de servidor chamado `i-0b6a61efe2ab843gg`, você poderia substituí-lo por uma variável chamada `$path_gg`.

**Para adicionar uma variável constante**

1. Insira as opções gerais, conforme descrito acima.

1. Insira o valor da variável no campo **Valor**. É possível inserir letras, números e símbolos. Você pode até usar curingas se usar o [formato bruto](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera.

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

## Adicionar uma variável de fonte de dados
<a name="v10-dash-variable-add-datasource"></a>

As variáveis da *fonte de dados* permitem que você altere rapidamente a fonte de dados de todo um dashboard. Elas serão úteis se você tiver várias instâncias de uma fonte de dados, talvez em ambientes diferentes.

**Para adicionar uma variável de fonte de dados.**

1. Insira as opções gerais, conforme descrito acima.

1. Na lista **Tipo**, selecione a fonte de dados de destino para a variável.

   Você também pode escolher **Abrir seletor de fonte de dados avançado** para ver mais opções, incluindo adicionar uma fonte de dados (somente administradores). Para obter mais informações, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).

1. (Opcional) Em **Filtro de nome de instância**, insira um filtro regex para quais instâncias de fonte de dados escolher na lista suspensa de valores de variáveis. Deixe esse campo vazio para exibir todas as instâncias.

1. (Opcional) Insira as [Opções de seleção](#v10-dash-variable-add-selection).

1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera.

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

## Adicionar uma variável de intervalo
<a name="v10-dash-variable-add-internal"></a>

Use uma variável de *intervalo* para representar períodos de tempo como `1m`,`1h` ou `1d`. Você pode pensar neles como um comando abrangente do dashboard de *agrupar por hora*. As variáveis de intervalo mudam a forma como os dados são agrupados na visualização. Você também pode usar a opção Automático para retornar um número definido de pontos de dados por período de tempo.

Você pode usar uma variável de intervalo como parâmetro para agrupar por hora (para InfluxDB), intervalo do histograma de datas (para Elasticsearch) ou como um parâmetro de função de resumo (para Graphite).

**Para adicionar uma variável de intervalo**

1. Insira as opções gerais, conforme descrito acima.

1. No campo **Valores**, insira os intervalos de tempo que você deseja que apareçam na lista suspensa de variáveis. As seguintes unidades de tempo são compatíveis: `s (seconds)`, `m (minutes)`, `h (hours)`, `d (days)`, `w (weeks)`, `M (months)` e `y (years)`. Você também pode aceitar ou editar os valores padrão: `1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.

1. (Opcional) Ative a **Opção automática** se quiser adicionar a opção `auto` à lista. Essa opção permite especificar quantas vezes o intervalo de tempo atual deve ser dividido para calcular o período de tempo `auto` atual. Se você ativá-lo, mais duas opções aparecerão:
   + **Contagem de etapas**: selecione o número de vezes que o intervalo de tempo atual será dividido para calcular o valor, semelhante à opção de consulta **Máximo de pontos de dados**. Por exemplo, se o intervalo de tempo visível atual for de 30 minutos, então o intervalo `auto` agrupará os dados em 30 incrementos de um minuto. O valor padrão é 30 etapas.
   + **Intervalo mínimo**: o limite mínimo abaixo do qual os intervalos de contagem de etapas não dividirão o tempo. Para continuar o exemplo de 30 minutos, se o intervalo mínimo for definido como 2 minutos, o Grafana agrupará os dados em 15 incrementos de dois minutos.

1. Na **Pré-visualização de valores**, o Grafana exibe uma lista dos valores das variáveis atuais. Revise-os para garantir que correspondam ao que você espera.

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

**Exemplos de variáveis de intervalo**

O exemplo a seguir mostra uma variável de modelo `myinterval` em uma função do Graphite:

```
summarize($myinterval, sum, false)
```

## Adicionar filtros ad hoc
<a name="v10-dash-variable-add-adhoc"></a>

Os *filtros ad hoc* permitem que você adicione filtros de valor/chave que são adicionados automaticamente a todas as consultas de métricas que usam a fonte de dados especificada. Ao contrário de outras variáveis, você não usa filtros ad hoc nas consultas. Em vez disso, você usa filtros ad hoc para gravar filtros para consultas existentes.

**nota**  
Variáveis de filtro ad hoc só funcionam com fontes de dados Prometheus, Loki, InfluxDB e Elasticsearch.

1. Insira as opções gerais, conforme descrito acima.

1. Na lista **Fonte de dados**, selecione a fonte de dados de destino.

   Você também pode escolher **Abrir seletor de fonte de dados avançado** para ver mais opções, incluindo adicionar uma fonte de dados (somente administradores). Para obter mais informações, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).

1. Selecione **Adicionar** para adicionar a variável ao dashboard.

**Criar filtros ad hoc**

Os filtros ad hoc são uma das opções de variáveis mais complexas e flexíveis disponíveis. Em vez de uma lista regular de opções de variáveis, essa variável permite criar uma consulta ad hoc em todo o dashboard. Os filtros que você aplica dessa maneira são aplicados a todos os painéis no dashboard.

## Configurar opções de seleção de variáveis
<a name="v10-dash-variable-add-selection"></a>

As *opções de seleção* são um recurso que você pode usar para gerenciar seleções de opções variáveis. Todas as opções de seleção são opcionais e estão desativadas por padrão.

### Variáveis de vários valores
<a name="v10-dash-variable-add-selection-multi"></a>

Interpolar uma variável com vários valores selecionados é complicado, pois não é simples formatar os vários valores em uma string válida no contexto em que a variável é usada. O Grafana tenta resolver isso permitindo que cada plug-in de fonte de dados informe ao mecanismo de interpolação de modelos qual formato usar para vários valores.

**nota**  
A opção **Personalizar todos os valores** na variável deve estar em branco para que o Grafana formate todos os valores em uma única string. Se for deixado em branco, o Grafana concatenará (somará) todos os valores na consulta. Por exemplo, .`value1,value2,value3` Se, em vez disso, um valor `all` personalizado for usado, o valor será `*` ou `all`.

**Variáveis de vários valores com uma fonte de dados Graphite**

O Graphite usa expressões globais. Uma variável com vários valores deve, nesse caso, ser interpolada como `{host1,host2,host3}` se o valor da variável atual fosse *host1*, *host2* e *host3*.

**Variáveis de vários valores com uma fonte de dados Prometheus ou InfluxDB**

O InfluxDB e o Prometheus usam expressões regex, então a mesma variável é interpolada como `(host1|host2|host3)`. Todo valor também tem escape regex. Do contrário, um valor com um caractere de controle regex dividiria a expressão regex.

**Variáveis de vários valores com uma fonte de dados elástica**

O Elasticsearch usa a sintaxe de consulta do Lucene, então a mesma variável é formatada como `("host1" OR "host2" OR "host3")`. Nesse caso, todo valor deve ser de escape para que o valor contenha apenas palavras de controle e aspas do Lucene.

**Solucionar problemas de variáveis de vários valores**

O escape e a formatação automáticos podem causar problemas e pode ser difícil entender a lógica por trás disso. Especialmente para InfluxDB e Prometheus, em que o uso da sintaxe regex requer que a variável seja usada no contexto do operador regex.

Se você não quiser que o Grafana faça esse escape e formatação automáticos de regex, faça o seguinte:
+ Desative as opções **Multivalor** ou **Incluir todas as opções**.
+ Use o [formato bruto](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Incluir todas as opções
<a name="v10-dash-variable-add-multi-all"></a>

O Grafana adiciona uma opção `All` à lista suspensa de variáveis. Se um usuário selecionar essa opção, então todas as opções de variáveis serão selecionadas.

### Personalizar todos os valores
<a name="v10-dash-variable-add-multi-custom"></a>

Essa opção só estará visível se **Incluir todas as opções** estiver selecionado.

Insira a sintaxe regex, globs ou lucene no campo **Personalizar todos os valores** para definir o valor da opção `All`.

Por padrão, o valor `All` inclui todas as opções em uma expressão combinada. Isso pode se tornar muito longo e causar problemas de performance. Às vezes, pode ser melhor especificar um valor personalizado para todos, como um regex curinga.

Para ter uma sintaxe personalizada de regex, globs ou lucene na opção **Personalizar todos os valores**, ela nunca é de escape, então você terá que pensar sobre qual será um valor válido para a fonte de dados.

## Variáveis globais
<a name="v10-dash-variable-add-global"></a>

O Grafana tem variáveis globais integradas que podem ser usadas em expressões no editor de consultas. Este tópico as lista em ordem alfabética e as define. Essas variáveis são úteis em consultas, links de dashboards, links de painéis e links de dados.

**\$1\$1\$1dashboard**

Esta variável é o nome do dashboard atual.

**\$1\$1\$1from e \$1\$1\$1to**

O Grafana tem duas variáveis de intervalo de tempo integradas: `$__from` e `$__to`. Atualmente, elas são sempre interpoladas como milissegundos epoch por padrão, mas você pode controlar a formatação da data.


| Sintaxe | Exemplo de resultado | Description | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Unix milissegundos epoch  | 
|  `${__from:date}`  |  2020-07-13T20:19:09.254Z  |  Nenhum argumento, o padrão é ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Unix segundos epoch  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  Qualquer formato de data personalizado que não inclua o caractere :  | 

A sintaxe acima também funciona com `${__to}`.

**\$1\$1\$1interval**

Você pode usar a variável `$__interval` como um parâmetro para agrupar por hora (para InfluxDB, MySQL, Postgres, MSSQL), intervalo do histograma de datas (para Elasticsearch) ou como um parâmetro de função de *resumo* (para Graphite).

O Grafana calcula automaticamente um intervalo que pode ser usado para agrupar por hora nas consultas. Quando há mais pontos de dados do que os mostrados em um grafo, as consultas podem ser mais eficientes agrupando por um intervalo maior. Por exemplo, se você estiver vendo um grafo de três meses de dados, talvez não consiga ver os detalhes no nível de minutos. O agrupamento por hora ou dia torna a consulta mais eficiente sem afetar o que o grafo mostra. O `$__interval` é calculado usando o intervalo de tempo e a largura do grafo (o número de pixels).

Cálculo aproximado: `(to - from) / resolution`

Por exemplo, quando o intervalo de tempo é de uma hora e o grafo está em tela cheia, então o intervalo pode ser calculado em `2m`. Os pontos são agrupados em intervalos de dois minutos. Se o intervalo de tempo for de seis meses e o grafo estiver em tela cheia, o intervalo poderá ser `1d` (1 dia). Os pontos são agrupados por dia.

Na fonte de dados InfluxDB, a variável legada `$interval` é a mesma variável. `$__interval`deve ser usado em vez disso.

As fontes de dados InfluxDB e Elasticsearch têm os campos `Group by time interval` que são usados para codificar de forma rígida o intervalo ou definir o limite mínimo para a variável `$__interval` (usando a sintaxe `>`, por exemplo `>10m`).

**\$1\$1\$1interval\$1ms**

Essa variável é a variável `$__interval` em milissegundos, não uma string formatada com intervalo de tempo. Por exemplo, se `$__interval` for `20m` então `$__interval_ms` será `1200000`.

**\$1\$1\$1org**

Essa variável é o ID da organização atual. `${__org.name}` é o nome da organização atual.

**\$1\$1\$1user**

`${__user.id}` é o ID do usuário atual. `${__user.login}` é o identificador de login do usuário atual. `${__user.email}`é o e-mail do usuário atual.

**\$1\$1\$1range**

Compatível apenas com as fontes de dados Prometheus e Loki. Essa variável representa o intervalo do dashboard atual. É calculado por `to - from`. Tem um milissegundo e uma segunda representação chamada `$__range_ms` e `$__range_s`.

**\$1\$1\$1rate\$1interval**

Compatível somente com as fontes de dados Prometheus. A variável `$__rate_interval` deve ser usada na função de taxa.

**\$1timeFilter ou \$1\$1\$1timeFilter**

A variável `$timeFilter` retorna o intervalo de tempo atualmente selecionado como uma expressão. Por exemplo, a expressão `Last 7 days` do intervalo de tempo é `time > now() - 7d`.

Isso é usado em vários lugares, incluindo:
+ A cláusula WHERE para a fonte de dados InfluxDB. O Grafana a adiciona automaticamente às consultas do InfluxDB quando está no modo Editor de consultas. Você pode adicioná-la manualmente no modo Editor de texto: `WHERE $timeFilter`.
+ Consultas de analytics de logs na fonte de dados Azure Monitor.
+ Consultas SQL em MySQL, Postgres e MSSQL.
+ A variável `$__timeFilter` é usada na fonte de dados MySQL.

**\$1\$1\$1timezone**

A variável `$__timezone` retorna o fuso horário atualmente selecionado, ou `utc` ou uma entrada do banco de dados de fuso horário do IANA (por exemplo, `America/New_York`).

Se o fuso horário atualmente selecionado for *Hora do navegador*, o Grafana tentará determinar o fuso horário do seu navegador.

## Variáveis encadeadas
<a name="v10-dash-variable-add-chained"></a>

*Variáveis encadeadas*, também chamadas de *variáveis vinculadas* ou *variáveis aninhadas*, são variáveis de consulta outras variáveis na consulta de variável.

As consultas de variáveis encadeadas são diferentes para cada fonte de dados, mas a premissa é a mesma para todas. Você pode usar consultas variáveis encadeadas em qualquer fonte de dados que as permita.

Dashboards com modelos vinculados extremamente complexos são possíveis, com cinco ou dez níveis de profundidade. Tecnicamente, não há limite para o quão profundo ou complexo você pode ir, mas quanto mais links você tiver, maior será a carga de consultas.

**Dicas e práticas recomendadas**

As práticas a seguir facilitarão o uso dos dashboards e variáveis.

**Criar novas variáveis vinculadas**
+ O encadeamento de variáveis cria parent/child dependências. Você pode imaginá-las como uma escada ou uma árvore.
+ A maneira mais fácil de criar uma variável encadeada é copiar a variável na qual você deseja basear a nova. Na lista de variáveis, clique no ícone de **Duplicar variável** à direita da entrada da variável para criar uma cópia. Você pode então adicionar à consulta a variável principal.
+ As variáveis criadas dessa forma aparecerão na parte inferior da lista. Talvez seja necessário arrastá-las para uma posição diferente na lista para colocá-las em uma ordem lógica.

**Ordem das variáveis**

Você pode alterar a ordem das variáveis na lista de variáveis do dashboard clicando nas setas para cima e para baixo no lado direito de cada entrada. O Grafana lista os menus suspensos de variáveis da esquerda para a direita de acordo com essa lista, com a variável na parte superior, na extrema esquerda.
+ Liste as variáveis que não têm dependências na parte superior, antes das variáveis secundárias.
+ Cada variável deve seguir aquela da qual depende.
+ Lembre-se de que não há indicação na interface de usuário de quais variáveis têm relações de dependência. Liste as variáveis em uma ordem lógica para tornar mais fácil para os outros usuários (e para você).

**Considerações sobre complexidade**

Quanto mais camadas de dependência você tiver nas variáveis, mais tempo será necessário para atualizar os dashboards após a alteração das variáveis.

Por exemplo, se você tiver uma série de quatro variáveis vinculadas (país, região, servidor, métrica) e alterar o valor da variável raiz (país), o Grafana então deverá executar consultas para todas as variáveis dependentes antes de atualizar as visualizações no dashboard.

## Gerenciar variáveis
<a name="v10-dash-variable-add-manage"></a>

A página de variáveis permite adicionar variáveis e gerenciar as variáveis existentes. Também permite [inspecionar](v10-dash-variable-add-inspect.md) variáveis e identificar se uma variável está sendo referenciada (ou usada) em outras variáveis ou no dashboard.

**Mover**: você pode mover uma variável para cima ou para baixo na lista usando arrastar e soltar.

**Clonar:** para clonar uma variável, clique no ícone de clonar no conjunto de ícones à direita. Isso cria uma cópia da variável com o nome da variável original prefixada com `copy_of_`.

**Excluir:** para excluir uma variável, clique no ícone da lixeira no conjunto de ícones à direita.

## Filtrar variáveis com regex
<a name="v10-dash-variable-add-filter"></a>

Usando a opção de consulta regex, você filtra a lista de opções retornadas pela consulta da variável ou modifica as opções retornadas.

Esta página mostra como usar regex para filter/modify valores na lista suspensa de variáveis.

Usando a opção de consulta regex, você filtra a lista de opções retornadas pela consulta da variável ou modifica as opções retornadas. Para obter mais informações, consulte o guia do Mozilla sobre [expressões regulares](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Os exemplos a seguir mostram a filtragem na seguinte lista de opções

```
backend_01
backend_02
backend_03
backend_04
```

**Filtrar para que somente as opções que terminam com `01` ou `02` sejam retornadas**

Regex:

```
/
(
01|02 
) 
$/
```

Resultado:

```
backend_01
backend_02
```

**Filtrar e modificar as opções usando um grupo de captura regex para retornar parte do texto**

Regex:

```
/.* 
(
01|02 
)
/
```

Resultado:

```
01
02
```

**Filtrar e modificar: exemplo do Prometheus**

Para esta lista de opções:

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

Este regex:

```
/. *instance="
(
[^"]*
)
.*/
```

Retorna estes resultados:

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filtrar e modificar usando grupos nomeados de captura de texto e valor**

Usando grupos de captura nomeados, você pode capturar partes separadas de “texto” e “valor” das opções retornadas pela consulta da variável. Isso permite que a lista suspensa de variáveis contenha um nome amigável para cada valor que possa ser selecionado.

Por exemplo, ao consultar a métrica `node_hwmon_chip_names` do Prometheus, o `chip_name` é muito mais amigável do que o valor `chip`. Portanto, o seguinte resultado da consulta de variável:

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

Passou pelo seguinte regex:

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Produziria a seguinte lista suspensa:

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

Somente nomes de grupos de captura `text` e `value` são compatíveis.

# Inspecionar variáveis
<a name="v10-dash-variable-add-inspect"></a>

A página de variáveis permite identificar facilmente se uma variável está sendo referenciada (ou usada) em outras variáveis ou no dashboard.

Qualquer variável referenciada ou usada tem uma marca de seleção verde ao lado, enquanto as variáveis não referenciadas têm um ícone de advertência laranja ao lado delas. Além disso, todas as variáveis referenciadas têm um ícone de dependência ao lado da marca de seleção verde. É possível selecionar o ícone para visualizar o mapa de dependências. O mapa de dependências pode ser movido. Você pode aumentar ou diminuir o zoom com a roda do mouse ou equivalente.

# Sintaxe da variável
<a name="v10-dash-variable-syntax"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Títulos de painéis e consultas de métricas podem se referir a variáveis usando duas sintaxes diferentes.
+ `$varname`: esta sintaxe é fácil de ler, mas não permite que você use uma variável no meio de uma palavra.

  **Exemplo**: `apps.frontend.$server.requests.count`
+ `${var_name}`: use esta sintaxe quando quiser usar uma variável no meio de uma expressão.
+ `${var_name:<format>}`: este formato lhe dá mais controle de como o Grafana interpreta valores. Para obter mais informações, consulte *Opções avançadas de formato de variáveis*, após esta lista.
+ `[[varname]]`: não use. Esta sintaxe é antiga e foi descontinuada. Ela será removida em uma versão futura.

Antes de as consultas serem enviadas à fonte de dados, a consulta é *interpolada*, o que significa que a variável é substituída por seu valor atual. Durante a interpolação, o valor da variável pode ser de *escape* para se adequar à sintaxe da linguagem de consulta e onde ela é usada. Por exemplo, uma variável usada em uma expressão regex em uma consulta do InfluxDB ou Prometheus terá escape regex.

**Opções avançadas de formato de variáveis**

A formatação da interpolação de variável depende da fonte de dados, mas há algumas situações em que talvez você queira alterar a formatação padrão.

Por exemplo, o padrão para a fonte de dados MySQL é unir vários valores separados por vírgula com aspas: `'server01','server02'`. Em alguns casos, você pode desejar ter uma string separada por vírgulas sem aspas: `server01,server02`. Você pode fazer isso acontecer com as opções avançadas de formatação de variáveis listadas abaixo.

**Sintaxe geral**

Sintaxe: `${var_name:option}`

Se alguma opção de formatação inválida for especificada, então será `glob` a default/fallback opção.

**CSV**

Formata variáveis com vários valores como uma string separada por vírgulas.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**Distribuído - OpenTSDB**

Formata variáveis com vários valores em formato personalizado para OpenTSDB.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**Doublequote**

Formata variáveis de valor único e vários valores em uma string separada por vírgula, faz o escape de `"` em cada valor por `\"` e cita cada valor com `"`.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - Graphite**

Formata variáveis com vários valores em um glob (para consultas do Graphite).

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

Formata variáveis com vários valores como uma string separada por vírgulas.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

Formata variáveis com vários valores no formato Lucene para Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Percentencode**

Formata variáveis de valor único e de vários valores para uso em parâmetros de URL.

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**Barra vertical**

Formata variáveis com vários valores como uma string separada por barras verticais.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**Bruto**

Desativa a formatação específica da fonte de dados, como aspas simples em uma consulta SQL.

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

Formata variáveis com vários valores como uma string regex.

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**Singlequote**

Formata variáveis de valor único e vários valores em uma string separada por vírgula, faz o escape de `'` em cada valor por `\'` e cita cada valor com `'`.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

Formata variáveis de valor único e vários valores em uma string separada por vírgula, faz o escape de `'` em cada valor por `''` e cita cada valor com `'`.

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Texto**

Formata variáveis de valor único e de vários valores em sua representação de texto. Para uma única variável, ele retornará apenas a representação do texto. Para variáveis de vários valores, ele retornará a representação de texto combinada com `+`.

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**Parâmetros de consulta**

Formata variáveis de valor único e de vários valores como a representação de parâmetro de consulta. Exemplo: `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Avaliar uso do dashboard
<a name="v10-dash-assess-dashboard-usage"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Para cada dashboard e fonte de dados, você pode acessar as informações de uso.

**Insights do dashboard**

Para ver as informações de uso do dashboard, selecione **Insights do dashboard** na barra superior.

Os insights do dashboard mostrarão as informações a seguir.
+ **Estatísticas**: o número de consultas e erros diários dos últimos 30 dias.
+ **Usuários e atividade**: a contagem de visualizações diárias dos últimos 30 dias; as últimas atividades no dashboard e os usuários recentes (com um limite de 20).

**Insights de fontes de dados**

Os insights de fontes de dados fornecem informações sobre como uma fonte de dados foi usada nos últimos 30 dias, como:
+ Consultas por dia
+ Erros por dia
+ Tempo de carregamento da consulta por dia (média em ms)

**Para encontrar insights da fonte de dados**

1. Selecione **Conexões** na navegação principal do seu espaço de trabalho.

1. Selecione as **Fontes de dados**.

1. Escolha uma fonte de dados.

1. Selecione a guia **Insights**.

## Indicador de presença
<a name="v10-dash-presence-indicator"></a>

Quando você está conectado e visualiza um dashboard, você pode saber quem está vendo o mesmo dashboard que você por meio de um indicador de presença, que exibe avatares de usuários que interagiram recentemente com o dashboard. O valor do período padrão é de dez minutos. Para ver o nome do usuário, passe o mouse sobre o avatar dele. Os avatares vêm do [Gravatar](https://gravatar.com/) com base no e-mail do usuário.

Quando houver mais usuários ativos em um dashboard do que o indicador de presença comporta, clique no ícone **\$1X**. Isso abrirá os insights do dashboard, que contêm mais detalhes sobre a atividade recente do usuário.

## Classificar dashboards usando dados de insights
<a name="v10-dash-sort-dashboards"></a>

Na visualização de pesquisa, você pode usar os dados de insights para ajudar a encontrar os dashboards mais usados, danificados e não utilizados. Você pode classificar os dashboards pelo seguinte:
+ Visualizações
+ Erros
+ Visualizações
+ Hora da criação
+ Hora da atualização

# Solucionar problemas dos dashboards
<a name="v10-dash-troubleshoot"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

 Use as estratégias a seguir para obter ajuda sobre como solucionar problemas comuns do dashboard. 

## O dashboard está lento
<a name="v10-dash-dashboard-is-slow"></a>
+ Você está tentando renderizar dezenas (ou centenas ou milhares) de séries temporais em um grafo? Isso pode causar atrasos no navegador. Tente usar funções como `highestMax` (em Graphite) para reduzir o número de séries retornadas.
+ Às vezes, os nomes das séries podem ser muito grandes. Isso gera respostas maiores. Tente usar `alias` para reduzir o tamanho dos nomes das séries retornados.
+ Você está consultando muitas séries temporais ou um longo intervalo de tempo? Ambas as condições podem fazer com que o Grafana ou a fonte de dados extraiam muitos dados, o que pode tornar o dashboard mais lento. Tente reduzir uma das duas.
+ Pode haver uma carga alta na infraestrutura de rede. Se a lentidão não for consistente, esse pode ser o problema.

## Problemas com a taxa de atualização do dashboard
<a name="v10-dash-refresh-rate-issues"></a>

Por padrão, o Grafana consulta a fonte de dados a cada 30 segundos. No entanto, definir uma baixa taxa de atualização nos dashboards coloca um estresse desnecessário no backend. Em muitos casos, consultar isso com frequência não é necessário porque a fonte de dados não está enviando dados com frequência suficiente para que haja alterações a cada 30 segundos.

Recomendamos o seguinte:
+ Só habilite a atualização automática em dashboards, painéis ou variáveis, se necessário. Os usuários podem atualizar o navegador manualmente.
+ Se você precisar de atualização automática, defina a taxa de atualização para um período mais longo que seja aceitável, como a cada minuto, a cada dez minutos ou a cada hora.
+ Verifique o intervalo de tempo do dashboard. Se o dashboard tiver um intervalo de tempo maior, como uma semana, você realmente não precisa de atualização automática e deve desativá-la.

## Manipular ou renderizar dados nulos é errado ou confuso
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

Algumas aplicações publicam dados de forma intermitente. Por exemplo, elas só publicam uma métrica quando ocorre um evento. Por padrão, os grafos do Grafana conectam as linhas entre os pontos de dados, mas isso pode ser enganoso.

Grafos que têm a opção **Conectar valores nulos** definida como **Sempre** conectarão linhas onde houver valores ausentes.

Uma forma de corrigir isso é usar barras em vez de linhas e definir a opção **Nenhum valor** (em **Opções padrão**) como `0`. Nesse caso, os dados ausentes aparecerão como áreas do grafo sem nenhum dado.

# Pesquisar dashboards no Grafana versão 10
<a name="v10-search"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Você pode pesquisar dashboards pelo nome do dashboard e pelo título do painel. Quando você pesquisa dashboards, o sistema retorna todos os dashboards disponíveis na instância do Grafana, mesmo que você não tenha permissão para visualizar o conteúdo do dashboard.

## Pesquisar dashboards usando o nome do dashboard
<a name="v10-search-by-name"></a>

Insira qualquer parte do nome do dashboard na barra de pesquisa. A pesquisa retorna resultados para qualquer correspondência parcial de string em tempo real, enquanto você digita.

A pesquisa do dashboard é:
+ Tempo real
+ *Não* diferencia maiúsculas de minúsculas.
+ Funcional em dashboards armazenados e baseados em arquivos.

**dica**  
Você pode usar as teclas de seta do teclado para navegar pelos resultados e pressionar `Enter` para abrir o dashboard selecionado.

## Pesquisar dashboards usando o título do painel
<a name="v10-search-by-title"></a>

Você pode pesquisar um dashboard pelo título de um painel que aparece em um dashboard. Se o título de um painel corresponder à consulta de pesquisa, o dashboard aparecerá nos resultados da pesquisa.

## Filtrar os resultados da pesquisa do dashboard por tags
<a name="v10-search-by-tag"></a>

As tags são uma ótima maneira de organizar os dashboards, especialmente à medida que o número de dashboards aumenta. Você pode adicionar e gerenciar tags nas **Configurações** do dashboard.

Quando você seleciona várias tags, o Grafana mostra dashboards que incluem todas as tags selecionadas.

Para filtrar o resultado de pesquisa de dashboard por uma tag, conclua uma das seguintes etapas:
+ Para filtrar os resultados da pesquisa de dashboard por tag, escolha uma tag que apareça na coluna à direita dos resultados da pesquisa.

  Você pode continuar a filtrar escolhendo tags adicionais.
+ Para ver uma lista de todas as tags disponíveis, clique no menu suspenso **Filtrar por tags** e selecione uma tag.

  Todas as tags serão mostradas e, quando você selecionar uma tag, a pesquisa de dashboard será filtrada instantaneamente.

**dica**  
Quando estiver usando somente um teclado, pressione a tecla `tab` e navegue até o menu suspenso **Filtrar por tag**, pressione a tecla de seta para baixo para ativar o menu e localizar uma tag e pressione `Enter` para selecionar a tag.

## Paleta de comandos
<a name="v10-search-palette"></a>

Você pode usar esta paleta de comandos para fazer o seguinte:
+ Pesquise e abra dashboards e pastas.
+ Crie dashboards e regras de alerta.
+ Localize páginas no Grafana.
+ Mude o tema para escuro ou claro.

Abra a paleta de comandos e insira `ctrl+k` (`cmd+k` no macOS). Você também pode selecionar a entrada de pesquisa na barra de navegação do Grafana.

**nota**  
Para ir para a etapa anterior, pressione `backspace` com a paleta de comandos vazia.