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á.

# Painéis
<a name="dashboard-overview"></a>

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

 Um *dashboard* é um conjunto de um ou mais painéis organizados e organizados em uma ou mais linhas. O Amazon Managed Grafana é fornecido com uma variedade de painéis. O Amazon Managed Grafana facilita a criação de consultas certas e a personalização das propriedades de exibição para que você possa criar o dashboard de controle de que precisa. Cada painel pode interagir com dados de qualquer fonte de dados configurada. 

## Gerenciar dashboards
<a name="manage-dashboards"></a>

 Para controlar o período de tempo do dashboard, você pode usar os [Controles de intervalo de tempo](dashboard-time-range-controls.md) no canto superior direito do dashboard. 

 Os dashboards podem usar modelos e variáveis para torná-los mais dinâmicos e interativos. Para obter mais informações, consulte [Modelos e variáveis](templates-and-variables.md). 

 Os dashboards podem usar [Anotações](dashboard-annotations.md) para exibir dados de eventos nos painéis. Isso pode ajudar a correlacionar os dados de séries temporais no painel com outros eventos. 

 Os dashboards podem ser compartilhados facilmente de várias maneiras. Para obter mais informações, consulte [Compartilhar um dashboard](share-a-dashboard.md). 

 Os dashboards podem ser marcados, e o seletor de dashboards fornece acesso rápido e pesquisável a todos os dashboards de uma organização específica. 

## Linhas
<a name="dashboard-rows"></a>

 Uma *linha* é um divisor lógico em um dashboard. Ele é usado para agrupar dashboards. 

 As linhas têm sempre 12 *unidades* de largura. Essas unidades são dimensionadas automaticamente com base na resolução horizontal do navegador. Você pode controlar a largura relativa de painéis em uma linha definindo a largura específica. 

 O Amazon Managed Grafana usa uma abstração unitária para otimizar a aparência em todos os tamanhos de tela. 

**nota**  
 Com MaxDataPoint a funcionalidade, o Amazon Managed Grafana pode exibir o número necessário de pontos de dados, independentemente da resolução ou do intervalo de tempo. 

 Para recolher uma linha, escolha o título da linha. Se você salvar um dashboard com uma linha recolhida, ele será salvo nesse estado e os grafos não serão carregados até que você expanda a linha. 

 Use a funcionalidade de linhas repetidas para criar ou remover dinamicamente linhas inteiras de painéis, com base nas variáveis de modelo selecionadas. 

# Anotações
<a name="dashboard-annotations"></a>

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

 As anotações fornecem uma forma de marcar pontos no grafo com eventos importantes. Ao pausar uma anotação, você pode ver a descrição e as tags do evento. O campo de texto pode incluir links para outros sistemas para obter mais detalhes. 

## Anotações nativas
<a name="native-annotations"></a>

 O Amazon Managed Grafana vem com um armazenamento de anotações nativas e a capacidade de adicionar eventos de anotação diretamente do painel de grafo. 

## Adicionar anotações
<a name="adding-annotations"></a>

 Para adicionar uma anotação, pressione **Ctrl** ou **Cmd** e escolha onde você deseja adicionar a anotação. Para tornar a anotação pesquisável em outros dashboards, adicione tags a ela. 

### Adicionar anotações da região
<a name="adding-regions-events"></a>

 Para criar uma anotação para uma região, pressione **Ctrl** ou **Cmd** ao escolher a região. 

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

 Depois de adicionar uma anotação, ela permanece visível. Isso ocorre porque existe uma consulta de anotação integrada em todos os dashboards. Essa consulta de anotação busca todos os eventos de anotação que se originam do dashboard atual e os exibe no painel em que foram criados. Isso inclui anotações do histórico dos estados dos alertas. Você pode impedir que as anotações sejam buscadas e exibidas escolhendo o ícone de **Configurações do dashboard** (engrenagem), **Anotações** e depois modificando a consulta denominada `Annotations & Alerts (Built-in)`. 

 Quando você copia um dashboard usando o recurso **Salvar como**, o novo dashboard tem um novo ID de painel, portanto, as anotações criadas no dashboard de origem não ficam visíveis na cópia. Se as anotações do dashboard de origem tiverem tags pelas quais filtrar, você poderá mostrar as anotações na cópia adicionando uma nova **Consulta de anotação** e filtrando pelas tags. 

### Consulta por tag
<a name="annotation-query-by-tag"></a>

 Você pode criar novas consultas de anotação que buscam anotações do armazenamento de anotações nativas usando a fonte de dados `-- Grafana --` e configurando **Filtrar por** como **Tags**. Especifique pelo menos uma tag. Por exemplo, crie uma consulta de anotação denominada `outages` e especifique uma tag denominada `outage`. Essa consulta mostrará todas as anotações que você criar (de qualquer dashboard ou via API) que tenham a tag `outage`.

Por padrão, se você adicionar várias tags na consulta de anotação, o Amazon Managed Grafana mostrará somente as anotações que tenham todas as tags que você forneceu. Para mostrar anotações que contenham pelo menos uma das tags que você forneceu, ative **Corresponder qualquer**. 

 No Amazon Managed Grafana, é possível usar variáveis de modelo na consulta de tags. Por exemplo, se você tiver um dashboard mostrando estatísticas de diferentes serviços e uma variável de modelo que controla quais serviços mostrar, você pode usar a mesma variável de modelo na consulta de anotação para mostrar anotações somente para esses serviços. 

## Consultar outras fonte de dados
<a name="querying-other-data-sources"></a>

 Os eventos de anotação são obtidos usando consultas de anotação. Para adicionar uma nova consulta de anotação a um dashboard, escolha o ícone de **Configurações do dashboard** (engrenagem), escolha `Annotations` e depois **Nova**. 

 Especifique um nome para a consulta de anotação. Este nome é exibido pela caixa de seleção para mostrar ou ocultar eventos de anotação para essa consulta. Por exemplo, você pode ter duas consultas de anotação denominadas `Deploys` e `Outages`. Você pode marcar ou desmarcar as caixas de seleção para especificar quais anotações mostrar. 

### Detalhes da consulta de anotação
<a name="annotation-query-details"></a>

 As opções de consulta de anotação são diferentes para cada fonte de dados. 
+ [Anotações usando o editor de consultas do Graphite](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [Anotações usando fonte de dados OpenSearch ](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Anotações usando o Prometheus](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [Anotações usando MySQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [Anotações usando PostgreSQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# Pastas de dashboards
<a name="dashboard-folders"></a>

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

 As pastas são uma forma de organizar e agrupar dashboards. Isso será útil se você tiver muitos dashboards ou se várias equipes usarem o mesmo espaço de trabalho do Grafana. 

## Criar uma pasta
<a name="how-to-create-a-folder"></a>

Para criar uma pasta, siga um destes procedimentos:
+  No menu lateral, abaixo do ícone \$1, escolha o link **Criar pasta**. 
+  Na página **Gerenciar dashboards**, escolha o botão **Criar pasta**. 

 Na página **Criar pasta**, insira um nome exclusivo para a pasta e escolha **Criar**. 

Ao salvar um dashboard, você poderá escolher uma pasta existente ou criar uma.

## Gerenciar dashboards
<a name="folders-manage-dashboards"></a>

 Na página **Gerenciar dashboards**, você pode realizar várias tarefas: 
+  Crie uma pasta. 
+  Crie um dashboard. 
+  Mova dashboards para pastas. 
+  Exclua vários dashboards. 
+  Navegue até a página de uma pasta (em que você pode definir permissões para uma pasta ou seus dashboards). 

## Página da pasta do dashboard
<a name="dashboard-folder-page"></a>

 Para abrir uma página de Pasta do dashboard, escolha o ícone de engrenagem que aparece quando você pausa em uma pasta na lista de dashboards nos resultados da pesquisa ou na página Gerenciar dashboards. 

 A página Pasta do dashboard é semelhante à página Gerenciar dashboards. Na página Pasta do dashboard, você pode executar as seguintes tarefas: 
+  Mover ou excluir dashboards em uma pasta. 
+  Renomear uma pasta (na guia **Configurações**). 
+  Definir permissões para a pasta (herdadas pelos dashboards na pasta). 

## Permissões
<a name="folder-permissions"></a>

 As permissões podem ser atribuídas a uma pasta e herdadas pelos dashboards que ela contém. Uma lista de controle de acesso (ACL) é usada onde a **Perfil da organização**, a **Equipe** e o **Usuário** individual podem receber permissões. Para obter mais informações, consulte [Permissões de dashboards e pastas](dashboard-and-folder-permissions.md). 

# Lista de reprodução
<a name="dashboard-playlist"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 8.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 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.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 Amazon Managed Grafana escala automaticamente os dashboards para qualquer resolução, incluindo telas grandes. 

 Você pode acessar o recurso **Lista de reprodução** no menu lateral, no submenu **Dashboards**. 

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

 Uma lista de reprodução apresenta dashboards em uma sequência, com uma ordem e intervalo de tempo definidos entre os dashboards. 

1.  Para acessar o recurso **Lista de reprodução**, pause no menu lateral. 

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

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

1.  Na caixa de texto **Nome**, insira um nome para a lista de reprodução. 

1.  Na caixa de texto **Intervalo**, insira um intervalo de tempo. 

   O intervalo de tempo é a quantidade de tempo em que o Amazon Managed Grafana permanece em um dashboard específico antes de avançar para o próximo na lista de reprodução. 

1.  Ao lado de cada dashboard que você deseja adicionar à lista de reprodução, escolha **Adicionar à lista de reprodução**. 

1.  Escolha **Criar**. 

## Editar uma lista de reprodução
<a name="edit-a-playlist"></a>

 Você pode editar listas de reprodução ao criá-las ou depois de salvá-las. 

1.  Para acessar o recurso Lista de reprodução, pause no menu lateral. 

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

1.  Escolha a lista de reprodução que deseja editar. 

### Editar o nome de uma lista de reprodução
<a name="edit-the-name-of-a-playlist"></a>

1. Escolha a caixa de texto **Nome**.

1.  Edite o nome. 

1.  Escolha **Salvar** para salvar as alterações. 

### Editar o intervalo de uma lista de reprodução
<a name="edit-the-interval-of-a-playlist"></a>

1.  Escolha a caixa de texto **Intervalo**. 

1.  Edite o intervalo. 

1.  Escolha **Salvar** para salvar as alterações. 

### Adicionar um dashboard a uma lista de reprodução
<a name="add-a-dashboard-to-a-playlist"></a>

1.  Ao lado do dashboard que você deseja adicionar, escolha **Adicionar à lista de reprodução**. 

1.  Escolha **Salvar** para salvar as alterações. 

### Procurar um dashboard para adicionar
<a name="search-for-a-dashboard-to-add"></a>

1. Em **Adicionar dashboards**, escolha a caixa de texto **Pesquisar dashboards por nome**. 

1.  Insira um nome ou expressão regular. 

1. Se necessário, filtre seus resultados por tags ou status com estrela. Por padrão, os dashboards com estrela aparecem como opções para adicionar à lista de reprodução.

1.  Escolha **Salvar** para salvar as alterações. 

### Reorganizar a ordem do dashboard
<a name="rearrange-dashboard-order"></a>

1.  Ao lado do dashboard que deseja mover, escolha a seta para cima ou para baixo. 

1.  Escolha **Salvar** para salvar as alterações. 

### Remover um dashboard
<a name="remove-a-dashboard"></a>

1.  Escolha o ícone x para remover um dashboard da lista de reprodução. 

1.  Escolha **Salvar** para salvar as alterações. 

### Excluir uma lista de reprodução
<a name="delete-a-playlist"></a>

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

1.  Escolha o ícone x ao lado da lista de reprodução que você deseja excluir. 

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

 Você pode salvar uma lista de reprodução para adicioná-la à sua página **Listas de reprodução**, na qual você pode iniciá-la. Certifique-se de adicionar todos os dashboards que você deseja que apareçam na sua lista de reprodução antes de salvá-la. 

1.  Para acessar o recurso **Lista de reprodução**, pause no menu lateral. 

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

1.  Escolha a lista de reprodução. 

1.  Edite a lista de reprodução. 

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

1.  Escolha **Salvar**. 

## Iniciar uma lista de reprodução
<a name="start-a-playlist"></a>

 Você pode iniciar uma lista de reprodução em cinco modos de visualização diferentes. O modo determina como os menus e a barra de navegação são exibidos 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 tela. 

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

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

1.  Na lista suspensa, escolha um dos seguintes modos de exibição: 
   +  **Modo normal** 
     +  O menu lateral permanece visível. 
     +  Os controles da barra de navegação, da linha e do painel são exibidos na parte superior da tela. 
   +  **Modo TV** 
     +  O menu lateral está oculto ou foi removido. 
     +  Os controles da barra de navegação, da linha e do painel são exibidos na parte superior da tela. 
     +  O modo TV é ativado automaticamente após um minuto de inatividade do usuário. 
     +  Você pode ativar o modo TV manualmente usando o atalho da sequência **d v** ou anexando o parâmetro `?inactive` ao URL do dashboard. 
     +  Você pode desabilitar o modo TV com qualquer movimento do mouse ou ação do teclado. 
   +  **Modo TV (com painéis de ajuste automático)** 
     +  O menu lateral está oculto ou foi removido. 
     +  Os controles da barra de navegação, da linha e do painel são exibidos na parte superior da tela. 
     +  Os painéis do dashboard se ajustam automaticamente para otimizar o espaço na tela. 
   +  **Modo de quiosque** 
     +  Os controles do menu lateral, da barra de navegação, da linha e do painel estão completamente ocultos ou removidos da visualização. 
     +  Você pode ativar o modo de quiosque manualmente usando o atalho da sequência **d v** após o início da lista de reprodução. 
     +  Você pode desativar o modo de quiosque manualmente usando o mesmo atalho. 
   +  **Modo de quiosque (com painéis de ajuste automático):** 
     +  Os controles do menu lateral, da barra de navegação, da linha e do painel estão completamente ocultos ou removidos da visualização. 
     +  Os painéis do dashboard se ajustam automaticamente para otimizar o espaço na tela. 

## Controlar uma lista de reprodução
<a name="control-a-playlist"></a>

 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. 


|  Button  |  Resultado  | 
| --- | --- | 
|  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)  |  Altera a exibição dos dashboards para diferentes modos de visualização.  | 
|  Intervalo de tempo  | Exibe dados dentro de um intervalo de tempo. Ele pode ser configurado para exibir os últimos cinco minutos ou até cinco anos atrás, ou um intervalo de tempo personalizado, usando a seta suspensa.  | 
|  Atualizar (seta circular)  |  Recarrega o dashboard para exibir os dados atuais. Ele pode ser configurado para recarregar automaticamente, de a cada cinco segundos a um dia, usando a seta suspensa.  | 

 Para interromper a lista de reprodução no seu teclado, pressione **Esc**.

## Compartilhar uma lista de reprodução em um modo de visualização
<a name="share-a-playlist-in-a-view-mode"></a>

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

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

1.  Ao lado da lista de reprodução que você deseja compartilhar, escolha **Iniciar lista de reprodução** e, em seguida, escolha o modo de visualização desejado. 

1.  Para copiar o URL para a área de transferência, escolha **Copiar endereço de link**. 

    Por exemplo, o URL de uma lista de reprodução no site do Grafana Play no modo de quiosque pode ser `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk`. 

1.  Cole o URL no destino. 

# Pesquisa no dashboard
<a name="dashboard-search"></a>

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

 Os dashboards podem ser pesquisados pelo nome do dashboard, filtrados por uma (ou várias) tags ou filtrados pelo status com estrela. A pesquisa do dashboard é acessada por meio do seletor do dashboard, disponível na barra de navegação superior do dashboard. A pesquisa no dashboard também pode ser aberta usando o atalho **F**. 

Ao usar somente um teclado, você pode usar as teclas de seta do teclado para navegar pelos resultados e pressionar **Enter** para abrir o dashboard desejado. 

## Localizar pelo nome do dashboard
<a name="find-by-dashboard-name"></a>

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

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

## Filtrar por tags
<a name="filter-by-tags"></a>

 As tags são uma forma útil de organizar seus dashboards, especialmente à medida que o número de dashboards aumenta. As tags podem ser adicionadas e gerenciadas nas **Configurações** do dashboard. 

 Para filtrar a lista de dashboards por tag, escolha qualquer tag que apareça na coluna da direita. Você pode filtrar ainda mais a lista escolhendo tags adicionais. 

Para ver uma lista de todas as tags disponíveis, escolha o menu suspenso **Filtrar por tags**. Quando você seleciona uma tag, a pesquisa no dashboard é filtrada instantaneamente. 

Ao usar somente um teclado, pressione **Tab** para focar o link das tags, pressione a tecla de seta para baixo para encontrar uma tag e pressione **Enter** para selecionar a tag. 

**nota**  
 Quando várias tags são selecionadas, o Amazon Managed Grafana mostra dashboards que incluem todas as tags. 

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

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

 Para compartilhar um dashboard, escolha **Compartilhar dashboard** (o ícone de compartilhamento) na barra de navegação superior. Isso abre a caixa de diálogo **Compartilhar**, na qual você pode obter um link para o dashboard atual com o intervalo de tempo e as variáveis do modelo atualmente selecionados. Se você tiver feito alterações no dashboard, não se esqueça de salvá-las antes de copiar o link. 

## Snapshot do dashboard
<a name="dashboard-snapshot"></a>

 Um snapshot do dashboard é uma forma instantânea de compartilhar publicamente um dashboard interativo. Ao criar o snapshot, o Amazon Managed Grafana remove dados confidenciais, como consultas (métrica, modelo e anotação) e links de painéis, deixando somente os dados de métricas visíveis e os nomes das séries incorporados ao dashboard. Os snapshots do dashboard podem ser acessados por qualquer pessoa que tenha o link e possa acessar o URL. 

## Publicar snapshots
<a name="publish-snapshots"></a>

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

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

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

 Escolha o título do painel para abrir o menu do painel e, em seguida, escolha **Compartilhar** no menu do painel para abrir a caixa de diálogo **Compartilhar painel**. Você pode copiar o link, que o levará exatamente para esse painel com o intervalo de tempo atual e as variáveis de modelo selecionadas. 

# Controles de intervalo de tempo
<a name="dashboard-time-range-controls"></a>

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

 O Amazon Managed Grafana fornece várias maneiras de gerenciar os intervalos de tempo dos dados que estão sendo visualizados, tanto no nível do dashboard quanto no nível do painel. 

 Este tópico 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. 

**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.

## Unidades de tempo e intervalos relativos
<a name="time-units-and-relative-ranges"></a>

 As seguintes unidades de tempo são compatíveis: 
+ `s` (segundos)
+ `m` (minutos)
+ `h` (horas)
+ `d` (dias)
+ `w` (semanas)
+ `M` (meses)
+ `y` (anos)

 Use o operador de menos para voltar no tempo, em relação ao agora. Para exibir o período completo da unidade (como dia, semana ou mês), anexe `/<time unit>`. 

 Use o operador de adição para avançar no tempo em relação ao agora. Você pode usar esse recurso para analisar dados previstos para o futuro. 

 Veja alguns exemplos: 


|  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  | 
|  Semana até o momento  |  now/w  |  now  | 
|  Mês anterior  |  now-1M/M  |  now-1M/M  | 

## Controles de intervalo de tempo comuns
<a name="common-time-range-controls"></a>

 Os controles de tempo do painel e do dashboard têm uma interface de usuário comum, com as opções a seguir. 

### Intervalo de tempo atual
<a name="current-time-range"></a>

 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. 

 Pause em um campo para ver os registros de data e hora exatos no intervalo e sua origem, como o navegador local. 

 Para alterar o intervalo de tempo, escolha o intervalo de tempo atual. 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 to 2020-05-15 23:59:59`. 

### Intervalo de tempo relativo
<a name="relative-time-range"></a>

 Selecione o intervalo de tempo relativo na lista **Intervalos de tempo relativos**. Estes são alguns exemplos de intervalos de tempo relativos: 
+  Últimos 30 minutos 
+  Últimas 12 horas 
+  Últimos 7 dias 
+  Últimos 2 anos 
+  Ontem 
+  Anteontem 
+  Este dia, na semana passada 
+  Hoje até o momento 
+  Esta semana até o momento 
+  Este mês até o momento 

### Intervalo de tempo absoluto
<a name="absolute-time-range"></a>

 Defina um intervalo de tempo absoluto de duas formas: 
+  Insira valores nos campos **De** e **Até**. Você pode inserir valores de tempo exatos ou valores relativos, como `now-24h`, e, em seguida, escolher **Aplicar intervalo de tempo**. 
+  Escolha o campo **De** ou **Até**. O Amazon Managed Grafana exibe um calendário. Escolha o dia ou os dias que você deseja usar como intervalo de tempo atual e, em seguida, escolha **Aplicar intervalo de tempo**. 

 O Amazon Managed Grafana também exibe intervalos absolutos usados recentemente. 

### Reduzir o zoom (Cmd\$1Z ou Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 Para visualizar um intervalo de tempo maior na visualização do dashboard ou do painel, escolha o ícone de **Redução do zoom do intervalo de tempo**. 

### Aumentar o zoom (somente para visualizações de grafos)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 Na visualização do grafo, arraste para selecionar o intervalo de tempo que você deseja visualizar. 

### Atualizar o dashboard
<a name="refresh-dashboard"></a>

 Escolha o ícone **Atualizar dashboard** para executar todas as consultas no dashboard imediatamente e atualizar as visualizações. O Amazon Managed Grafana cancela todas as solicitações pendentes quando uma nova atualização é iniciada. 

 Por padrão, o Amazon Managed 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 o dashboard regularmente, clique na seta para baixo ao lado do ícone de **Atualizar dashboard** e selecione um intervalo de atualização. 

## Configurações de hora do dashboard
<a name="dashboard-time-settings"></a>

 As configurações de hora são salvas por dashboard. 

 Para acessar as configurações de hora do dashboard, escolha o ícone de **Configurações do dashboard** (engrenagem) na parte superior da tela. As configurações estão na seção **Opções de hora** da guia **Geral**. 
+  **Fuso horário**: 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 fuso horário padrão selecionado para o perfil do usuário, equipe ou organização. Se nenhum fuso horário for especificado para o perfil do usuário, uma equipe da qual o usuário é membro ou a organização, o Amazon Managed Grafana usará o horário local do navegador. 
  +  **Hora do navegador** O fuso horário configurado para o navegador que está sendo usado. Geralmente, este é o fuso horário definido no computador. 
  +  **Horário Universal Coordenado**: fusos horários padrão ISO 8601, incluindo UTC. Para obter mais informações, consulte uma [lista de fusos horários](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). 
+  **Atualização automática**: opções personalizáveis de tempo relativo e configurações de atualização automática. As entradas são separadas por vírgulas e podem ser qualquer unidade de tempo válida. 
+  **Atraso agora, agora**: valor de atraso de tempo que substitui o valor `now`. Geralmente, esse recurso é usado para evitar valores nulos ao acomodar atrasos conhecidos na agregação de dados. 
+  **Ocultar seletor de tempo**: opção para não exibir o seletor de tempo. 

## Substituições de horário do painel e mudança de tempo
<a name="panel-time-overrides-and-timeshift"></a>

 Em [Opções de consulta](panel-queries.md#query-options), você pode substituir o intervalo de tempo relativo de painéis individuais, fazendo com que sejam diferentes do que está selecionado no seletor de tempo do dashboard na barra de navegação superior. Você pode mostrar as métricas de diferentes períodos ou dias ao mesmo tempo. 

## Controlar o intervalo de tempo usando um URL
<a name="control-the-time-range-using-a-url"></a>

 Você pode controlar o intervalo de tempo de um dashboard fornecendo os seguintes parâmetros de consulta no URL do dashboard: 
+  `from`: define o limite mínimo do intervalo de tempo, especificado em ms epoch, ou o tempo relativo. Para obter mais informações, consulte [Intervalo de tempo relativo](#relative-time-range). 
+  `to`: define o limite máximo do intervalo de tempo, especificado em ms epoch, ou o tempo relativo. Para obter mais informações, consulte [Intervalo de tempo relativo](#relative-time-range). 
+  `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 milissegundos. Por exemplo, `?time=1500000000000&time.window=10000` resulta em um intervalo de tempo de dez segundos de 1499999995000 a 1500000005000 

# Exportar e importar dashboards
<a name="dashboard-export-and-import"></a>

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

 Os dashboards do Amazon Managed Grafana podem ser facilmente exportados e importados, seja da interface do usuário, seja da [API HTTP]. 

## Exportar um dashboard
<a name="exporting-a-dashboard"></a>

 Os dashboards são exportados no formato JSON do Amazon Managed Grafana e contêm tudo o que você precisa, incluindo layout, variáveis, estilos, fontes de dados e consultas, para importar o dashboard posteriormente. 

 O recurso de exportação é acessado na janela de compartilhamento, que você abre escolhendo o botão de compartilhamento no menu do dashboard.

### Tornar um dashboard portátil
<a name="making-a-dashboard-portable"></a>

 Ao exportar um dashboard para outras pessoas usarem, é bom adicionar variáveis de modelo para valores como um prefixo de métrica (use uma variável constante) e um nome de servidor. 

 Uma variável de modelo do tipo `Constant` é automaticamente ocultada no dashboard. Ela também é adicionada como uma entrada obrigatória quando o dashboard é importado. Para obter mais informações sobre modelos e variáveis de modelos, consulte [Modelos e variáveis](templates-and-variables.md). 

## Importar um dashboard
<a name="importing-a-dashboard"></a>

 Para importar um dashboard, escolha o ícone \$1 no menu lateral e depois **Importar**. 

 Você pode fazer o upload de um arquivo JSON do dashboard, colar o URL do dashboard ou colar o texto JSON do dashboard diretamente na área de texto. 

 Na etapa 2 do processo de importação, você pode alterar o nome do dashboard, especificar a fonte de dados que você deseja que o dashboard use e especificar quaisquer prefixos de métricas (se o painel usar algum). 

## Descobrir dashboards em Grafana.com
<a name="discover-dashboards-on-grafana.com"></a>

 Encontre dashboards para aplicações comuns de servidor em [Grafana.com/dashboards](https://grafana.com/dashboards). 

# Histórico de versões do dashboard
<a name="dashboard-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 8.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 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.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 ao escolher **Configurações do dashboard** e, em seguida, 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
<a name="comparing-two-dashboard-versions"></a>

 Para comparar duas versões do dashboard, selecione as duas versões da lista que você deseja comparar. Depois de selecionar duas versões, escolha **Comparar versões** para abrir a visualização de diferenças. Por padrão, você verá um resumo textual das alterações, como na imagem a seguir.

 Para visualizar as diferenças do JSON bruto que representa o dashboard, escolha **Visualizar diferenças do JSON**. 

 Para restaurar para a versão anterior com a qual você está comparando, escolha **Restaurar para a versão <x>**.

## Restaurar para uma versão do dashboard salva anteriormente
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 Se precisar restaurar uma versão do dashboard salva anteriormente, você pode fazer isso escolhendo o botão “Restaurar” à direita de uma linha na lista de versões do dashboard ou escolhendo **Restaurar para a versão <x>** que aparece na visualização de diferenças. Depois de escolher restaurar, uma caixa pop-up solicitará que você confirme a restauração. 

 Depois de restaurar para uma versão anterior, será criada uma nova versão contendo exatamente os mesmos dados da versão anterior, mas com um número de versão diferente. Isso é indicado na coluna **Observações**. Isso ajuda a garantir que as versões anteriores do dashboard não sejam afetadas pela alteração. 

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

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

 O Amazon Managed Grafana tem vários atalhos de teclado disponíveis. Para exibir todos os atalhos de teclado disponíveis na sua versão do Amazon Managed Grafana, pressione **Shift \$1 ?** no teclado. 

 **O Amazon Managed Grafana inclui os seguintes atalhos populares:** 
+  **Ctrl\$1S** salva o dashboard atual. 
+  **Ctrl\$1F** abre o localizador e a pesquisa do dashboard. 
+  **Ctrl\$1H** oculta todos os controles (ocultar controles funciona bem para telas de TV). 
+  O **escape** sai de um grafo quando está em tela cheia ou no modo de edição. 

# Modelo JSON do dashboard
<a name="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 8.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 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).

 Um dashboard no Amazon Managed Grafana é representado por um objeto JSON, que armazena metadados do 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.  Abra um dashboard. 

1.  Na barra de navegação superior, escolha **Gerenciar dashboard**. 

1.  Selecione **Visualizar JSON** no menu suspenso. 

## Campos JSON
<a name="dashboard-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 `null`, que é o valor padrão atribuído a ele até que um dashboard seja salvo. Depois de salvar um dashboard, um valor inteiro é atribuído ao campo `id`. 

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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 tabela a seguir fornece os detalhes de uso de cada campo no JJSON do dashboard. 


|  Nome  |  Usage  | 
| --- | --- | 
|  id  |  O identificador numérico exclusivo do dashboard (gerado pelo banco de dados).  | 
|  uid  |  O identificador exclusivo do dashboard que pode ser gerado por qualquer pessoa. O uid é uma string de 8 a 40 caracteres.  | 
|  title  |  O título atual do dashboard.  | 
|  tags  |  As tags associadas ao dashboard. No JSON, as tags são uma matriz de strings.  | 
|  style  |  O tema do dashboard (por exemplo, dark ou light).  | 
|  timezone  |  O fuso horário do dashboard (utc ou browser).  | 
|  editable  |  Se um dashboard pode ser editado.  | 
|  graphTooltip  |  O estilo da dica de ferramenta. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  O intervalo de tempo do dashboard (por exemplo, últimas seis horas, últimos sete dias).  | 
|  timepicker  |  Os metadados do seletor de tempo. Para obter mais informações, consulte [Seletor de horário](#dashboard-json-timepicker).  | 
|  templating  |  Os metadados de modelos. Para obter mais informações, consulte [Modelos e variáveis](templates-and-variables.md).  | 
|  annotations  |  Os metadados e anotações. Para obter mais informações, consulte [Anotações](dashboard-annotations.md).  | 
|  refresh  |  O intervalo de atualização automática.  | 
|  schemaVersion  |  A versão do esquema JSON (número inteiro), que é incrementada sempre que uma atualização do Amazon Managed Grafana altera o esquema.  | 
|  version  |  A versão do dashboard (número inteiro), que é incrementada sempre que o dashboard é atualizado.  | 
|  panels  |  A matriz de painéis. Para obter mais informações, consulte [Painéis](#dashboard-JSON-panels).  | 

## Painéis
<a name="dashboard-JSON-panels"></a>

 Os painéis são os blocos de criação de um dashboard. Consiste em consultas de fontes de dados, tipos de grafos, aliases e outros dados. 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. O exemplo a seguir mostra o 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 name="panel-size-and-position"></a>

 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 unidade de altura da grade representa 30 pixels. 
+  `x`: a posição x. A posição x usa a mesma unidade de coluna que `w`. 
+  `y`: a posição y. A posição y usa a mesma unidade de altura da grade que `h`. 

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

### Seletor de horário
<a name="dashboard-json-timepicker"></a>

O exemplo a seguir mostra as opções do `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"
  }
```

 A tabela a seguir fornece os detalhes padrão do `timepicker`. 


|  Nome  |  Usage  | 
| --- | --- | 
|  collapse  |  Se o timepicker estiver recolhido  | 
|  enable  |  Se o timepicker estiver ativado  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

### Modelos
<a name="json-templating"></a>

 O campo `templating` contém uma matriz de variáveis de modelo com seus valores e outros metadados salvos. O exemplo a seguir mostra metadados de `templating`. 

```
 "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 fornece os detalhes de uso da seção de modelos. 


|  Nome  |  Usage  | 
| --- | --- | 
|  enable  |  Se a modelagem está ativada.  | 
|  list  |  Uma matriz de objetos, cada um representando uma variável de modelo  | 
|  allFormat  |  O formato a ser usado ao buscar todos os valores da fonte de dados (por exemplo, wildcard, glob, regex e pipe).  | 
|  current  |  Mostra o texto ou o valor da variável selecionada atualmente no dashboard  | 
|  fonte de dados  |  Mostra a fonte de dados das variáveis  | 
|  includeAll  |  Se a opção de todos os valores está disponível  | 
|  multi  |  Se vários valores podem ser selecionados na lista de valores de variáveis  | 
|  multiFormat  |  O formato a ser usado ao buscar séries temporais da fonte de dados  | 
|  name  |  O nome de uma variável  | 
|  options  |  A matriz de text/value pares de variáveis disponíveis para seleção no painel  | 
|  query  |  A consulta da fonte de dados usada para buscar valores para uma variável  | 
|  refresh  |  TODO  | 
|  regex  |  TODO  | 
|  tipo  |  O tipo de variável (custom, query ou interval)  | 

# Dashboards com script
<a name="scripted-dashboards"></a>

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

**Atenção**  
 Este recurso está obsoleto e será removido em uma versão futura. 

 Se você tiver muitos nomes de métricas que mudam (por exemplo, novos servidores) em um padrão definido, pode ser demorado criar constantemente novos dashboards. 

 Com painéis com script, você pode criar dinamicamente seus painéis usando o. JavaScript Na pasta de instalação do Grafana, em `public/dashboards/`, há um arquivo chamado `scripted.js`. Esse arquivo contém um exemplo de um dashboard com script. Você pode acessá-lo usando o URL: `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` 

 Ao abrir `scripted.js`, você pode ver como ele lê os parâmetros de URL da variável `ARGS` e, em seguida, adiciona linhas e painéis. 

## Exemplo: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## Mais exemplos de
<a name="more-examples"></a>

 Você pode encontrar mais exemplos no diretório `public/dashboards/` de sua instalação do Grafana.