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á.
# Criar dashboards
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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.
**Topics**
+ [Criando painéis](v9-dash-creating.md)
+ [Adicionar ou editar painéis](v9-dash-edit-panels.md)
+ [Modificar as configurações do dashboard](v9-dash-modify-settings.md)
+ [Variáveis de URL do dashboard](v9-dash-dashboard-url-variables.md)
+ [Adicionar um painel de biblioteca ao dashboard](v9-dash-manage-library-panels.md)
+ [Gerenciar o histórico de versões do dashboard](v9-dash-manage-version-history.md)
+ [Gerenciar links do dashboard](v9-dash-manage-dashboard-links.md)
+ [Modelo JSON do dashboard](v9-dash-dashboard-json-model.md)
# Criando painéis
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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 criar um dashboard:
1. Faça login no Grafana, passe o cursor sobre o **Dashboard** e clique em **\$1 Novo dashboard**.
1. Clique em **Adicionar um novo painel**.
1. Na primeira linha da guia **Consulta**, clique na lista suspensa e selecione uma fonte de dados.
1. Escreva ou crie uma consulta na linguagem de consulta da sua fonte de dados.
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](v9-panels-viz.md).
1. Ajuste as configurações do painel das maneiras a seguir.
+ [Configurar mapeamentos de valores](v9-panels-configure-value-mappings.md)
+ [Opções específicas de visualização](v9-panels-viz.md)
+ [Substituir valores de campo](v9-panels-configure-overrides.md)
+ [Configurar limites](v9-panels-configure-thresholds.md)
+ [Configurar opções padrão](v9-panels-configure-standard-options.md)
**nota**
A maioria das visualizações precisa de alguns ajustes antes de exibir adequadamente as informações de que você precisa.
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.
**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.
1. Na página inicial do dashboard, clique em **Adicionar painel**.
1. Na caixa de diálogo **Adicionar um painel**, clique em **Adicionar uma nova linha**.
1. Passe o mouse sobre o título da linha e clique no ícone de engrenagem.
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.
**Para mover um painel**
1. Abra o painel do .
1. Clique no título do painel e arraste-o 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, clique e arraste o canto inferior direito do painel. Você pode dimensionar um painel de dashboard para atender às suas necessidades.
# Adicionar ou editar painéis
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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 dashboard, você pode adicionar, editar ou remover painéis a qualquer momento.
+ **Visualizar dashboard**: para visualizar um dashboard, no menu **Início**, selecione **Dashboards** e escolha o dashboard que você deseja visualizar. Talvez seja necessário expandir a pasta que contém o dashboard.
+ **Adicionar painel**: para adicionar um painel a um dashboard, escolha o ícone de **Adicionar painel** na barra de menu na parte superior da página.
+ **Editar painel**: para editar um painel existente em um dashboard, escolha o ícone do menu que aparece quando você passa o mouse sobre o painel e escolha **Editar**.
+ **Remover painel**: para remover um painel existente em um dashboard, escolha o ícone do menu que aparece quando você passa o mouse sobre o painel e escolha **Remover**.
# Modificar as configurações do dashboard
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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 especifica 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.
+ O Grafana usa o fuso horário *padrão* selecionado para o perfil do usuário, a equipe ou a 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.
+ O fuso horário configurado para o navegador do usuário visualizador, a *hora local do navegador*, será 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.
+ A **atualização automática** personaliza 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** remove a exibição do seletor de tempo do Grafana.
**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.
**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](v9-dash-variables.md).
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**, insira 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.
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**
As tags são úteis para criar uma lista suspensa dinâmica de dashboards, todos com uma tag específica.
1. Para adicionar um link, 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 metadados de seu dashboard. Os metadados do dashboard incluem propriedades do dashboard, metadados dos painéis, variáveis de modelo, consultas do painel e assim por diante.
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](v9-dash-dashboard-json-model.md).
# Variáveis de URL do dashboard
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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](v9-dash-manage-dashboard-links.md) e [Modelos e variáveis](v9-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](v9-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]().
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-`.
# Adicionar um painel de biblioteca ao dashboard
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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.
1. Abra um painel no modo de edição.
1. Nas opções de exibição do painel, clique na opção de seta para baixo para fazer alterações na visualização.
1. Para abrir a caixa de diálogo **Criar**, clique na opção **Painéis de biblioteca** e, em seguida, clique em **Criar painel de biblioteca**.
1. Em **Nome do painel da biblioteca**, insira o nome.
1. Em **Salvar na pasta**, selecione a pasta para salvar o painel da biblioteca.
1. Para salvar suas alterações, clique em **Criar painel de biblioteca**.
1. Para salvar o dashboard, clique em **Salvar**.
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.
**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.
1. Passe o mouse sobre a opção **Dashboards** no menu à esquerda e selecione **Novo dashboard** nas opções suspensas. A caixa de diálogo **Adicionar painel** será aberta.
1. Clique na opção **Adicionar um painel** na biblioteca de painéis. 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.
1. Passe o mouse sobre **Dashboard** no menu à esquerda e clique em **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. Clique no título do painel e, em seguida, em **Editar**. O painel será aberto no modo de edição.
1. Clique na opção **Desvincular** no canto superior direito da página.
**Visualizar uma lista de painéis da 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.
1. Passe o mouse sobre a opção **Dashboard** no menu à esquerda e depois clique em **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.
1. Passe o mouse sobre **Dashboard** no menu à esquerda e selecione **Painéis de biblioteca**.
1. Selecione o painel que deseja excluir.
1. Clique no ícone de excluir ao lado do nome da biblioteca.
# Gerenciar o histórico de versões do dashboard
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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 nunca 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.
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.
Ao clicar no botão, você será direcionado para a visualização das diferenças. Por padrão, você verá um resumo em texto das alterações.
Caso deseje ver as diferenças do JSON bruto que representa seu dashboard, também é possível fazer isso clicando no botão **Exibir diferenças do JSON** na parte inferior.
Caso deseje restaurar para a versão com a qual está fazendo a comparação, clique no botão **Restaurar para a versão ** no canto superior direito.
**Restaurar para uma versão do dashboard salva anteriormente**
Caso precise restaurar para uma versão do dashboard salva anteriormente, você pode clicar no botão **Restaurar** à direita de uma linha na lista de versões do dashboard ou clicar no botão **Restaurar para versão ** que aparece na visualização de diferenças. Clicar no botão abrirá o pop-up a seguir solicitando 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 é feito apenas para garantir que as versões anteriores do dashboard não sejam afetadas pela alteração.
# Gerenciar links do dashboard
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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 o 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](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
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.
1. Ao visualizar o dashboard que você deseja vincular, clique na engrenagem na parte superior da tela para abrir **Configurações do dashboard**.
1. Clique em **Links** e, em seguida, clique em **Adicionar link do dashboard** ou em **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 lista suspensa**: caso esteja vinculando vários dashboards, você provavelmente desejará selecionar essa opção e adicionar um título opcional à lista suspensa. Do contrário, o Grafana exibirá os links do dashboard lado a lado na parte superior do dashboard.
+ **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](v9-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.
1. Ao visualizar o dashboard que você deseja vincular, clique na engrenagem na parte superior da tela para abrir **Configurações do dashboard**.
1. Clique em **Links** e, em seguida, clique em **Adicionar link do dashboard** ou em **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. Para obter mais informações, verifique este [Exemplo do GitHub](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests).
+ **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. Clique em **Add (Adicionar)**.
**Atualizar um link do dashboard**
Para alterar ou atualizar um link existente do dashboard, siga este procedimento.
1. Em **Configurações do dashboard,** na guia **Links**, clique no link existente que você deseja editar.
1. Altere as configurações e clique em **Atualizar**.
**Duplicar um link do dashboard**
Para duplicar um link existente do dashboard, clique no í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 ícone de duplicar 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 painel, clique no ícone no canto superior esquerdo de um 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 e pressione `e`. Ou clique na seta suspensa ao lado do título do painel e clique em **Editar**.
1. Na guia **Painel**, role para baixo até a seção **Links**.
1. Expanda **Links** e clique em **Adicionar link**.
1. Insira um **Título**. O **Título** é 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. Você pode até mesmo adicionar uma das variáveis de modelo definidas no dashboard. Pressione `Ctrl+Space` ou `Cmd+Space` e clique no 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. Na guia **Painel**, encontre o link em que você deseja fazer alterações.
1. Clique no ícone de **Editar** (lápis) para abrir a janela Editar link.
1. Faça alterações se for necessário.
1. Clique em **Salvar** para salvar as alterações e feche a janela.
1. Clique em **Salvar** no canto superior direito para salvar as alterações no dashboard.
+ **Excluir um link do painel**
1. Na guia **Painel**, encontre o link em que você deseja fazer alterações.
1. Clique no ícone **X** ao lado do link que você deseja excluir.
1. Clique em **Salvar** no canto superior direito para salvar as alterações no dashboard.
# Modelo JSON do dashboard
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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, clique no ícone de **Configurações do dashboard** (engrenagem).
1. Clique em **Modelo JSON**.
**Campos JSON**
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": [],
"style": "dark",
"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 *escuro* ou *claro* |
| **timezone** | fuso horário do dashboard, como *utc* ou do *navegador* |
| **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 *últimas 6 horas* ou *últimos 7 dias* |
| **timepicker** | metadados do timepicker, consulte a [seção timepicker](#v9-dash-dashboard-json-model) para obter detalhes |
| **templating** | metadados de modelos, consulte a [seção de modelos](#v9-dash-dashboard-json-model) para obter detalhes |
| **anotações** | metadados de anotações, consulte as [anotações](v9-panels-annotate-visualizations.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 no referido esquema |
| **version** | versão do dashboard (inteiro), incrementada toda vez que o dashboard é atualizado |
| **panels** | matriz de painéis (veja abaixo para obter detalhes) |
**Painéis**
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"
}
]
}
```