

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

# Trabalhar no Grafana versão 8
<a name="using-grafana-v8"></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).

Ao criar o espaço de trabalho do Grafana, você tem a opção de qual versão do Grafana usar. Os tópicos a seguir descrevem como usar um espaço de trabalho do Grafana que usa a versão 8 do Grafana.

**Topics**
+ [Painéis](Grafana-panels.md)
+ [Painéis](dashboard-overview.md)
+ [Explore](explore.md)
+ [Linking (Vinculando)](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [Modelos e variáveis](templates-and-variables.md)
+ [Grafana Alerting](alerts-overview.md)

# Painéis
<a name="Grafana-panels"></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 painel é o bloco básico de criação da visualização em um servidor Grafana. Um painel é uma representação visual de uma ou mais consultas, exceto alguns painéis de uso especial. As consultas exibem dados ao longo do tempo. Isso pode variar de flutuações de temperatura ao status atual do servidor a uma lista de logs ou alertas.

Cada painel tem um editor de consultas específico para a fonte de dados selecionada no painel. O editor de consultas permite que você extraia uma visualização para ser exibida no painel.



Para exibir dados, você deve ter pelo menos uma fonte de dados adicionada ao seu espaço de trabalho. Para obter mais informações sobre fontes de dados, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).

Há uma grande variedade de opções de estilo e formatação para cada painel. Os painéis podem ser arrastados, reorganizados e redimensionados.

**Topics**
+ [Adicionar um painel](add-a-panel-to-a-dashboard.md)
+ [Excluir um painel](Deleting-a-panel.md)
+ [Consultas](panel-queries.md)
+ [Consultas gravadas](recorded-queries.md)
+ [Transformações](panel-transformations.md)
+ [Opções de campo e substituições](field-options-overrides.md)
+ [Editor de painel](AMG-panel-editor.md)
+ [Painéis de biblioteca](AMG-library-panel.md)
+ [Visualizações](AMG-visualizations.md)

# Adicionar um painel
<a name="add-a-panel-to-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).

 Você pode usar painéis para mostrar os dados de forma visual. Este tópico guia você pelas etapas básicas para criar um painel. 

**Para adicionar um painel a um dashboard**

1.  Escolha o dashboard ao qual você deseja adicionar um painel. 

1.  Escolha o ícone **Adicionar painel**. 

1.  Escolha **Adicionar novo painel**. 

    O espaço de trabalho do Grafana cria um painel de grafo vazio com a fonte de dados padrão selecionada. 

1.  Embora não seja obrigatório, recomendamos que você adicione um título e uma descrição úteis ao painel. Opcionalmente, você pode usar variáveis que você definiu em qualquer campo, mas não variáveis globais. Para obter mais informações, consulte [Modelos e variáveis](templates-and-variables.md).
   + **Título do painel**: o texto inserido neste campo é exibido na parte superior do painel no editor dele e no dashboard.
   + **Descrição**: o texto inserido neste campo é exibido em uma dica de ferramenta no canto superior esquerdo do painel. Escreva uma descrição do painel e dos dados que você está exibindo.

1. Escreva uma consulta para o painel. Para exibir uma visualização, cada painel precisa de pelo menos uma consulta. Você escreve consultas na guia **Consulta** do editor do painel. Para obter mais informações, consulte [Consultas](panel-queries.md).

   1. Escolha uma fonte de dados. Na primeira linha da guia **Consulta**, escolha a lista suspensa para ver todas as fontes de dados disponíveis. Essa lista inclui todas as fontes de dados que você adicionou. Para obter mais informações sobre fontes de dados, consulte [Conectar-se à fonte de dados](AMG-data-sources.md). 

   1. Escreva ou crie uma consulta na linguagem de consulta da sua fonte de dados. As opções podem variar. Consulte a documentação específica da fonte de dados para obter diretrizes específicas. 

1.  Na seção **Visualização** da guia **Painel**, escolha um tipo de visualização. O espaço de trabalho do Grafana exibe uma pré-visualização dos resultados da consulta com essa visualização aplicada. 

1. Recomendamos que você adicione uma observação para descrever as alterações antes de escolher **Salvar**. As observações serão úteis se você precisar reverter o dashboard para uma versão anterior. 

1.  Para salvar o dashboard, escolha **Salvar** no canto superior direito da tela. 

# Excluir um painel
<a name="Deleting-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).

Para excluir um painel no Grafana, conclua as seguintes etapas:
+  Escolha o menu suspenso ao lado do título do painel e selecione **Remover painel**. 

or
+ Passe o ponteiro sobre o painel e use a sequência de atalhos do teclado “p r”.

# Consultas
<a name="panel-queries"></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 painéis do espaço de trabalho do Grafana usam *consultas* para se comunicar com fontes de dados e obter dados para a visualização. Uma consulta é uma pergunta escrita na linguagem de consulta usada pela fonte de dados. Se a consulta for formulada corretamente, a fonte de dados responderá. Nas opções da fonte de dados do painel, você pode ajustar a frequência com que a consulta é enviada à fonte de dados e quantos pontos de dados serão coletados. 

 O espaço de trabalho do Grafana é compatível com até 26 consultas por painel. 

## Editores de consultas
<a name="query-editors"></a>

 Editores de consultas são formulários que ajudam você a escrever consultas. Dependendo da fonte de dados, o editor de consultas pode fornecer preenchimento automático, nomes de métricas ou sugestão de variáveis. 

 Devido às diferenças entre as linguagens de consulta, as fontes de dados podem ter editores de consultas que tenham uma apresentação diferente.

## Sintaxe de consulta
<a name="query-syntax"></a>

 As fontes de dados têm linguagens de consulta e sintaxes diferentes para solicitar os dados. Veja dois exemplos de consulta.

 **PostgreSQL** 

```
SELECT hostname FROM host WHERE region IN($region)
```

 **PromQL** 

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

 Para obter mais informações sobre como escrever uma consulta para a fonte de dados, consulte a documentação da fonte de dados específica. As fontes de dados estão listadas em [Conectar-se à fonte de dados](AMG-data-sources.md).

## Interface do usuário da guia Consulta
<a name="query-tab-ui"></a>

 A guia **Consulta** consiste nos seguintes elementos: 
+  Seletor de fonte de dados 
+  Opções de consulta 
+  Botão do Inspetor de consultas 
+  Lista do editor de consultas 

### Seletor de fonte de dados
<a name="data-source-selector"></a>

 O seletor da fonte de dados é uma lista suspensa. Escolha-a para selecionar uma fonte de dados que você adicionou. Quando você cria um painel, o Amazon Managed Grafana seleciona automaticamente a fonte de dados padrão. Para obter mais informações sobre fontes de dados, consulte [Conectar-se à fonte de dados](AMG-data-sources.md). 

 Além das fontes de dados que você configurou no espaço de trabalho do Grafana, três fontes de dados especiais estão disponíveis. 
+ **TestDataDB** — Uma fonte de dados integrada que gera dados de caminhada aleatórios. A fonte de dados Grafana é útil para testar visualizações e executar experimentos.
+  **Mista**: uma fonte de dados para consultar várias fontes de dados no mesmo painel. Quando esta fonte de dados é selecionada, você pode selecionar uma fonte de dados para cada nova consulta adicionada.
  +  A primeira consulta usará a fonte de dados selecionada antes de você selecionar **Mista**. 
  +  Você não pode alterar uma consulta existente para usar a fonte de dados mista. 
+ **Painel**: uma fonte de dados para usar um conjunto de resultados de outro painel no mesmo dashboard. 

### Opções de consulta
<a name="query-options"></a>

 Para ver as configurações da fonte de dados selecionada, escolha **Opções de consulta** ao lado do seletor de fonte de dados. As alterações feitas aqui afetam somente as consultas realizadas neste painel. 

 O Amazon Managed Grafana define padrões que são mostrados em texto cinza escuro. As alterações são exibidas em texto na cor branca. Para retornar um campo à configuração padrão, exclua o texto na cor branca do campo. 

 Você pode usar as seguintes opções de consulta de fonte de dados do painel: 
+  **Máximo de pontos de dados**: se a fonte de dados for compatível, isso definirá o número máximo de pontos de dados para cada série retornada. Se a consulta retornar mais pontos de dados do que a configuração de máximo de pontos de dados, a fonte de dados os consolidará (reduzirá o número de pontos retornados ao agregá-los por média, máximo ou outra função). 

   Há duas razões principais para limitar o número de pontos: performance e atenuação da linha. O valor padrão é a largura (ou o número de pixels) do grafo, o que evita ter mais pontos de dados do que o painel de grafo pode exibir. 

   Com dados de streaming, o valor máximo de pontos de dados é usado para o buffer contínuo. (O streaming é um fluxo contínuo de dados, e o armazenamento em buffer é uma forma de dividir o fluxo em blocos.) 
+  **Intervalo mínimo**: define um limite mínimo para o intervalo calculado automaticamente, normalmente o intervalo mínimo de extração. Se um ponto de dados for salvo a cada 15 segundos, você não precisará ter um intervalo menor do que isso. Outro caso de uso é definir para um mínimo maior do que o intervalo de extração para recuperar consultas mais simplificadas e funcionais. 
+  **Intervalo**: um intervalo de tempo que você pode usar ao agregar ou agrupar pontos de dados por tempo. 

   O Amazon Managed Grafana calcula automaticamente um intervalo apropriado que pode ser usado como uma variável em consultas modeladas. A variável está em segundos: `$__interval`; ou em milissegundos: `$__interval_ms`. Normalmente é usada em funções de agregação como `sum` ou `average`. Por exemplo, esta é uma consulta do Prometheus usando a variável de intervalo: `rate(http_requests_total[$__interval])`. 

   Esse intervalo automático é calculado com base na largura do grafo. Se o usuário diminuir muito o zoom, o intervalo torna-se maior, resultando em uma agregação mais simplificada. Se o usuário aumentar o zoom, o intervalo diminuirá, resultando em uma agregação mais refinada. 

   Para obter mais informações, consulte [Variáveis globais](variables-types.md#global-variables). 
+  **Tempo relativo**: substitui o intervalo de tempo relativo para painéis individuais, o que faz com que eles sejam diferentes do que está selecionado no seletor de tempo do dashboard no canto superior direito do dashboard. Isso permite que você mostre métricas de diferentes períodos ou dias no mesmo dashboard. 
+  **Mudança de tempo**: fornece outra maneira de substituir o intervalo de tempo para painéis individuais. Essa função funciona somente com intervalos de tempo relativos, e você pode ajustar o intervalo de tempo. 

   Por exemplo, você pode alterar o intervalo de tempo do painel para duas horas antes do seletor de tempo do painel. Para obter mais informações, consulte [Controles de intervalo de tempo](dashboard-time-range-controls.md). 
+  **Tempo limite do cache**: (este campo só será visível se estiver disponível na fonte de dados.) Substituirá o tempo limite de cache padrão se o armazenamento de séries temporais tiver um cache de consulta. Ele é especificado como um valor numérico em segundos. 

### Botão do Inspetor de consultas
<a name="query-inspector-button"></a>

 Você pode escolher **Inspetor de consultas** para abrir a guia **Consulta** do inspetor do painel. Na guia **Consulta**, você pode ver a solicitação de consulta enviada pelo painel e a resposta. 

 Escolha **Atualizar** para ver o texto completo da solicitação enviada por esse painel ao servidor. 

**nota**  
 Você precisa adicionar pelo menos uma consulta para que o Inspetor de consultas possa retornar os resultados. 

 Para obter mais informações sobre o inspetor do painel, consulte [Inspecionar um painel](inspect-a-panel.md). 

### Lista do editor de consultas
<a name="query-editor-list"></a>

 Na interface do usuário, as consultas são organizadas em linhas de consulta recolhíveis. Cada linha de consulta contém um editor de consultas e é identificada com uma letra (A, B, C e assim por diante). 

## Compartilhar resultados de consultas entre painéis
<a name="share-query-results-between-panels"></a>

 Com o Amazon Managed Grafana, você pode usar o resultado da consulta de um painel para qualquer outro painel no dashboard. Compartilhar os resultados da consulta entre painéis reduz o número de consultas feitas à fonte de dados, o que pode melhorar a performance do dashboard. 

 A fonte de dados Dashboard permite que você selecione um painel no dashboard que contém as consultas para as quais você deseja compartilhar os resultados. Em vez de enviar uma consulta separada para cada painel, o Amazon Managed Grafana envia uma consulta, e os outros painéis usam os resultados da consulta para criar visualizações. 

 Essa estratégia pode reduzir significativamente o número de consultas feitas quando, por exemplo, você tem vários painéis visualizando os mesmos dados. 

**Para compartilhar consultas de fontes de dados com outro painel**

1.  Crie um dashboard. Para obter mais informações, consulte [Criação de um painel](getting-started-grafanaui.md#create-a-dashboard). 

1.  Adicione um painel. Para obter mais informações, consulte [Adicionar um painel](add-a-panel-to-a-dashboard.md). 

1.  Altere o título para **Source panel**. Você usará esse painel como fonte para os outros painéis. Defina a consulta ou as consultas que serão compartilhadas. Se você não tiver uma fonte de dados disponível no momento, poderá usar a fonte de dados **Grafana**, que retorna uma série temporal aleatória que você pode usar para testes. 

1.  Adicione um segundo painel e selecione a fonte de dados **Dashboard** no editor de consultas. 

1.  Em **Usar resultados da lista de painéis**, selecione o primeiro painel que você criou. 

 Todas as consultas definidas no painel de origem agora estão disponíveis para o novo painel. As consultas feitas no painel de origem podem ser compartilhadas com vários painéis. 

 Para acessar um painel em que uma consulta está definida, escolha essa consulta. 

# Consultas gravadas
<a name="recorded-queries"></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).

Você pode ver tendências ao longo do tempo tirando um snapshot de um ponto de dados em um intervalo definido usando consultas registradas. Isso pode lhe dar um insight das tendências históricas.

Para os plug-ins que não retornam séries temporais, pode ser útil traçar dados históricos. Por exemplo, talvez você queira **ServiceNow**consultar um histórico dos tempos de resposta da solicitação, mas ela só pode retornar point-in-time métricas atuais.

## Como funcionam as consultas gravadas
<a name="how-recorded-queries-work"></a>

As consultas gravadas só funcionam com plug-ins de fonte de dados de backend. Para obter mais informações, consulte [Plug-in de fonte de dados de backend](https://grafana.com/tutorials/build-a-data-source-backend-plugin/). Você pode registrar três tipos de consultas:
+ linha e coluna únicas: uma consulta que retorna uma única linha e coluna.
+ contagem de linhas: uma consulta que retorna linhas significativas a serem contadas.
+ expressão: qualquer expressão. Para saber mais sobre como criar e usar expressões, consulte [Expressões](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

Depois que uma consulta gravada é criada ou habilitada, ela cria imediatamente um snapshot e continua a criar snapshots no intervalo definido. A consulta gravada para de tirar snapshots quando é desabilitada, excluída ou quando o Grafana não está em execução. Os pontos de dados são coletados no backend executando a consulta gravada e encaminhando cada resultado para uma instância do Prometheus habilitada para gravação remota.

**nota**  
Você deve configurar uma fonte de dados Prometheus e associá-la a um destino de gravação remota antes que as consultas gravadas possam ser usadas.

## Criar uma consulta gravada
<a name="create-a-recorded-query"></a>

Para criar uma consulta gravada, conclua as seguintes etapas:

1. Encontre ou crie uma consulta que você deseja gravar em um dashboard em um painel de edição. A consulta deve retornar somente uma linha e coluna. Se retornar mais, você ainda poderá registrar o número de resultados retornados usando a opção de *contagem*. A fonte de dados da consulta deve ser uma fonte de dados de backend. As expressões podem ser usadas para agregar dados de uma consulta de série temporal. Para saber mais sobre como criar e usar expressões, consulte [Expressões](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

1. Escolha o menu de **consulta de registro** localizado no editor de consultas.

1. Insira as informações da consulta gravada. Todos os campos são obrigatórios, caso não indiquem o contrário. 
   + Nome: nome da consulta gravada.
   + Descrição: (opcional) descreva a consulta gravada como você deseja que ela apareça na lista de consultas gravadas.
   + Intervalo: o intervalo no qual o snapshot será tirado. O intervalo começa quando você cria a consulta gravada e termina se você pausar ou excluir a consulta gravada. Para obter mais informações sobre como pausar e excluir consultas gravadas, consulte [Gerenciar consultas gravadas](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries).
   + Intervalo: o intervalo de tempo relativo da consulta. Se você selecionar um intervalo de 30 minutos e um intervalo de 1 hora, a consulta vai tirar um snapshot a cada hora dos últimos 30 minutos.
   + Contar resultados da consulta: se quiser contar as linhas retornadas da consulta, ative esta opção. Se esta opção estiver desativada, a consulta deverá retornar uma linha com um valor.

1. Teste sua consulta gravada escolhendo o botão Testar consulta gravada.

1. Escolha **Iniciar gravação da consulta**.

## Adicionar uma consulta gravada
<a name="Adding-a-recorded-query"></a>

Você pode adicionar consultas gravadas existentes aos painéis em um dashboard. Para cada consulta gravada que você adiciona, uma consulta do Prometheus é criada: `generated_recorded_query_name{id="generated_id", name="recorded query name"}`. A consulta criada do Prometheus retorna todos os snapshots coletados da consulta registrada.

1. Navegue até um painel em um dashboard em que você deseja adicionar uma consulta gravada.

1. Escolha o menu **\$1 Consulta gravada**.

1. Se você quiser filtrar as consultas gravadas por fonte de dados, selecione uma fonte de dados no menu suspenso Filtrar por fonte de dados.

1. Escolha o menu **Adicionar** na consulta gravada para adicioná-la ao painel.

Depois de adicionar a consulta gravada ao painel, a fonte de dados do painel ficará `-- Mixed --`. A consulta registrada é representada por uma consulta do `Prometheus` com um rótulo de nome correspondente ao nome da consulta registrada. Consulte [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) para saber mais sobre a fonte de dados Prometheus.

Se, depois de adicionar uma consulta gravada, aparecer uma consulta com uma fonte de dados `-- Mixed --` em vez da fonte de dados Prometheus, isso pode significar que um destino de gravação remota do `Prometheus ` não foi configurado para consultas gravadas. Consulte [Destino de gravação remota](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target) para configurar um ponto de gravação remota.

## Usar uma consulta gravada
<a name="using-a-recorded-query"></a>

Para usar uma consulta registrada, crie uma e adicione-a a um dashboard. Depois disso, ela pode ser gerenciada em **Preferências** na guia **Consultas gravadas**.

## Gerenciar consultas gravadas
<a name="managing-recorded-queries"></a>

As consultas gravadas podem ser pausadas ou ativadas e excluídas da guia Consultas gravadas em Preferências. A exclusão de uma consulta gravada a removerá do Grafana, mas as informações coletadas no Prometheus ainda estarão lá. Pausar uma consulta gravada fará com que novos pontos de dados não sejam mais coletados até que ela seja retomada.

## Destino de gravação remota
<a name="remote_write_target"></a>

O destino de gravação remota é a fonte de dados **Prometheus** na qual os pontos de dados de consulta gravada são registrados. Você precisará de um Prometheus com gravação remota habilitado e precisará criar uma fonte de dados para esse Prometheus.

Para editar o destino de gravação remota, escolha **Editar destino de gravação remota** no menu do console na guia **Consultas gravadas** em **Preferências**. Selecione a fonte de dados **Prometheus** que tem a gravação remota habilitada e insira o caminho da gravação remota.

# Transformações
<a name="panel-transformations"></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 transformações processam o conjunto de resultados antes de passá-lo para a visualização. Você acessa as transformações na guia **Transformar** do editor de painéis do Amazon Managed Grafana.

Você pode usar as transformações para renomear campos, unir séries temporais separadas, fazer cálculos em consultas e muito mais. Se você tiver dashboards grandes ou consultas pesadas, poder reutilizar o resultado da consulta de um painel para outro pode proporcionar um grande ganho de performance.

**nota**  
Às vezes, as transformações resultam em dados que não podem ser representados graficamente. Quando isso acontece, o Amazon Managed Grafana exibe uma sugestão sobre a visualização. Escolha a sugestão para mudar para a visualização de tabela. Isso geralmente ajuda você a entender melhor o que a transformação está fazendo com os dados. 

O Amazon Managed Grafana aplica transformações na sequência em que elas são listadas na tela. Cada transformação cria um novo conjunto de resultados que é passado para a próxima transformação no pipeline. 

A ordem pode fazer uma grande diferença em com os resultados são exibidos. Por exemplo, caso use a transformação de redução para condensar todos os resultados de uma coluna em um único valor, você poderá aplicar transformações somente a esse valor único. 

**Pré-requisitos**

Antes de aplicar transformações, todas as seguintes opções devem ser verdadeiras:
+ Você inseriu uma consulta e retornou dados de uma fonte de dados. Para obter mais informações sobre consultas, confira [Consultas](panel-queries.md).
+ Você aplicou uma visualização compatível com consultas, como uma das seguintes visualizações:
  + Medidor em barras
  + Medidor
  + Gráfico
  + Mapa de calor
  + Logs
  + Stat
  + Tabela

## Aplicar uma transformação
<a name="apply-a-transformation"></a>

 As transformações estão disponíveis na guia **Transformar**, no painel inferior do editor de painéis, próximo à guia **Consultas**. 

**Para aplicar uma transformação**

1.  No painel ao qual você deseja adicionar transformações, escolha o título do painel e depois **Editar**. 

1.  Escolha a guia **Transform** (Transformação). 

1.  Selecione uma transformação. 

    Na linha de transformação exibida, você pode configurar as opções de transformação. 

1.  Para aplicar outra transformação, escolha **Adicionar transformação**. Lembre-se de que a próxima transformação atua no conjunto de resultados retornado pela transformação anterior. 

 Se você tiver problemas, escolha o ícone de bug para [depurar as transformações](#debug-transformations). 

 Para remover uma transformação, escolha o ícone de lixeira. 

## Tipos e opções de transformação
<a name="transformation-types-and-options"></a>

 Os espaços de trabalho do Grafana incluem as transformações a seguir. 

**Topics**
+ [Reduzir](#reduce)
+ [Mesclar](#merge)
+ [Filtrar por nome](#filter-by-name)
+ [Filtrar dados por consulta](#filter-data-by-query)
+ [Organizar campos](#organize-fields)
+ [Unir por campo (junção externa)](#join-by-field-outer-join)
+ [Adicionar campo do cálculo](#add-field-from-calculation)
+ [Rótulos para campos](#labels-to-fields)
+ [Agrupar por](#sort-by)
+ [Agrupar por](#group-by)
+ [Séries para linhas](#series-to-rows)
+ [Filtrar dados por valor](#filter-data-by-value)
+ [Depurar transformações](#debug-transformations)

### Reduzir
<a name="reduce"></a>

 Aplique uma transformação **Reduzir** quando quiser simplificar os resultados em um único valor. Reduzir basicamente remove o componente de tempo. Se visualizada como uma tabela, reduz uma coluna a uma linha (valor). 

 No campo **Cálculos**, insira um ou mais tipos de cálculos. Escolha para ver uma lista de opções de cálculos. Para obter informações sobre os cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md).

Depois de selecionar pelo menos um cálculo, o Amazon Managed Grafana exibe um valor usando o cálculo selecionado. Se você selecionar mais de um cálculo, mais de um valor será exibido. 

### Mesclar
<a name="merge"></a>

 Use esta transformação para combinar os resultados de várias consultas em um único resultado. Isso é útil ao usar a visualização do painel de tabela. Os valores que podem ser mesclados são combinados na mesma linha. Os valores poderão ser mesclados se os campos compartilhados contiverem os mesmos dados. 

 No exemplo a seguir, duas consultas retornam dados de tabela. Os dados são visualizados como duas tabelas separadas antes de aplicar a transformação. 

Consulta A


|  Hora  |  Trabalho  |  Tempo de atividade  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nó  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  123001233  | 

Consulta B


|  Hora  |  Trabalho  |  Erros  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nó  |  15  | 
|  2020-07-07 11:24:20  |  postgre  |  5  | 

 Veja abaixo o resultado depois de aplicar a transformação de **mesclagem**. 


|  Hora  |  Trabalho  |  Erros  |  Tempo de atividade  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  nó  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  5  |  123001233  | 

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

 Use esta transformação para remover partes dos resultados da consulta. 

 O Amazon Managed Grafana exibe o campo **Identificador**, seguido pelos campos retornados pela consulta. 

 Você pode aplicar filtros de duas formas: 
+  Insira uma expressão regex. 
+  Escolha um campo para alternar a filtragem nesse campo. Os campos filtrados são exibidos com texto na cor cinza escuro, e os campos não filtrados têm texto na cor branca. 

### Filtrar dados por consulta
<a name="filter-data-by-query"></a>

 Use esta transformação em painéis que tenham várias consultas, caso queira ocultar uma ou mais das consultas. 

 O Amazon Managed Grafana exibe as letras de identificação da consulta em texto cinza escuro. Para alternar a filtragem, escolha um identificador de consulta. Se a letra da consulta for branca, os resultados serão exibidos. Se a letra da consulta for escura, os resultados serão ocultados. 

### Organizar campos
<a name="organize-fields"></a>

 Use esta transformação para renomear, reordenar ou ocultar campos retornados pela consulta. 

**nota**  
 Esta transformação funciona somente em painéis que têm uma única consulta. Se o painel tiver várias consultas, você deverá aplicar uma transformação **Unir por campo (junção externa)** ou remover as consultas extras. 

 O Amazon Managed Grafana exibe uma lista de campos retornados pela consulta. Você pode fazer as seguintes alterações: 
+  Altere a ordem dos campos ao pausar sobre um campo. O cursor vira uma mão e, em seguida, você pode arrastar o campo para o novo local. 
+  Ocultar ou mostrar um campo ao selecionar o ícone do olho próximo do nome do campo. 
+  Renomeie os campos digitando um novo nome na caixa **Renomear**. 

### Unir por campo (junção externa)
<a name="join-by-field-outer-join"></a>

 Use esta transformação para unir várias séries temporais de um conjunto de resultados por campo. 

 Esta transformação será útil se você quiser combinar consultas para poder calcular os resultados dos campos. 

### Adicionar campo do cálculo
<a name="add-field-from-calculation"></a>

 Use esta transformação para adicionar um novo campo calculado de dois outros campos. Cada transformação permite que você adicione um novo campo. 
+  **Modo**: selecione um modo: 
  +  **Reduzir linha**: aplique o cálculo selecionado em cada linha dos campos selecionados de forma independente. 
  +  **Opção binária**: aplique uma operação matemática básica (`sum`, `multiply` etc.) em valores em uma única linha de dois campos selecionados. 
+  **Nome do campo**: selecione os nomes dos campos que você deseja usar no cálculo do novo campo. 
+  **Cálculo**: selecione um cálculo para usar quando o Amazon Managed Grafana criar o campo. Escolha o campo para ver uma lista de opções de cálculo. Para obter informações sobre os cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md). 
+  **Alias**: (opcional) insira o nome do novo campo. Se estiver em branco, o campo será nomeado para corresponder ao cálculo. 
+  **Substituir todos os campos**: (opcional) use esta opção se quiser ocultar todos os outros campos e exibir somente o campo calculado na visualização. 

### Rótulos para campos
<a name="labels-to-fields"></a>

**nota**  
 Para aplicar esta transformação, a consulta precisa retornar campos rotulados. 

 Quando você seleciona esta transformação, o Amazon Managed Grafana transforma automaticamente todos os dados rotulados em campos. 

 Por exemplo, considere o resultado da consulta de duas séries temporais. 

 1: rótulos Servidor = Servidor A, Data center = UE 2: rótulos Servidor = Servidor B, Data center = UE 

 Essa transformação vai resultar na seguinte tabela: 


|  Hora  |  Servidor  |  Datacenter  |  Valor  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  Servidor A  |  UE  |  1  | 
|  2020-07-07 11:34:20  |  Servidor B  |  UE  |  2  | 

 **Nome do campo de valor**; se você selecionou `Server` como o **nome do campo Valor**, vai obter um campo para cada valor do rótulo `Server`. 


|  Hora  |  Datacenter  |  Servidor A  |  Servidor B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  UE  |  1  |  2  | 

### Agrupar por
<a name="sort-by"></a>

Esta transformação classifica cada quadro pelo campo configurado. Quando `reverse` está marcado, os valores são retornados na ordem inversa.

### Agrupar por
<a name="group-by"></a>

 Esta transformação agrupa os dados por um valor de campo (coluna) especificado e processa os cálculos em cada grupo. Os cálculos disponíveis são os mesmos da transformação Reduzir. 

 Veja a seguir um exemplo de dados originais. 


|  Hora  |  ID do servidor  |  Temperatura da CPU  |  Status do servidor  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  servidor 1  |  80  |  Desligado  | 
|  2020-07-07 11:34:20  |  servidor 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  servidor 2  |  90  |  Sobrecarregado  | 
|  2020-07-07 10:31:22  |  servidor 3  |  55  |  OK  | 
|  2020-07-07 09:30:57  |  servidor 3  |  62  |  Rebooting  | 
|  2020-07-07 09:30:05  |  servidor 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  servidor 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  servidor 2  |  88  |  OK  | 
|  2020-07-07 09:23:07  |  servidor 1  |  86  |  OK  | 

 Esta transformação tem duas etapas. Primeiro, você especifica um ou vários campos pelos quais agrupar os dados. Isso agrupará todos os mesmos valores desses campos, como se você os tivesse classificado. Por exemplo, se você **Agrupar por** o campo `Server ID`, ele agrupará os dados desta forma: 


|  Hora  |  ID do servidor  |  Temperatura da CPU  |  Status do servidor  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  servidor 1  |  80  |  Desligado  | 
|  2020-07-07 09:28:06  |  servidor 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  servidor 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

Todas as linhas com o mesmo valor de `Server ID` são agrupadas. 

Depois de escolher em qual campo deseja agrupar seus dados, você pode adicionar vários cálculos nos outros campos, e o cálculo será aplicado em cada grupo de linhas. Por exemplo, talvez você queira calcular a média de `CPU temperature` para cada um desses servidores. Você pode adicionar o cálculo da *média* aplicado no campo `CPU Temperature` para obter o seguinte:


|  ID do servidor  |  Temperatura da CPU (média)  | 
| --- | --- | 
|  servidor 1  |  82  | 
|  servidor 2  |  88,6  | 
|  servidor 3  |  59,6  | 

E você pode adicionar mais de um desses cálculos. Por exemplo, você pode usar os cálculos a seguir. 
+  Para o campo `Time`, você pode calcular o *Último* valor para saber quando o último ponto de dados foi recebido de cada servidor. 
+  Para o campo `Server Status`, você pode calcular o *Último* valor para saber o último valor do estado de cada servidor. 
+  Para o campo `Temperature`, você também pode calcular o *Último* valor para saber a última temperatura monitorada de cada servidor. 

 A transformação Agrupar por produz os resultados a seguir. 


|  ID do servidor  |  Temperatura da CPU (média)  |  Temperatura da CPU (última)  |  Tempo (último)  |  Status do servidor (último)  | 
| --- | --- | --- | --- | --- | 
|  servidor 1  |  82  |  80  |  2020-07-07 11:34:20  |  Desligado  | 
|  servidor 2  |  88,6  |  90  |  2020-07-07 10:32:20  |  Sobrecarregado  | 
|  servidor 3  |  59,6  |  62  |  2020-07-07 11:34:20  |  OK  | 

Usando esta transformação, você pode extrair algumas informações importantes da série temporal e exibi-las de forma conveniente. 

### Séries para linhas
<a name="series-to-rows"></a>

Use esta transformação para combinar os resultados de várias consultas de dados de séries temporais em um único resultado. Isso é útil ao usar a visualização do painel de tabela. 

O resultado dessa transformação conterá três colunas: `Time`, `Metric` e `Value`. A coluna `Metric` é adicionada para que você possa ver de qual consulta a métrica se origina. Personalize esse valor definindo o `Label` na consulta de origem. 

No exemplo abaixo, duas consultas retornam dados de séries temporais. Elas são visualizadas como duas tabelas separadas antes da aplicação da transformação. 

 Consulta A 


|  Hora  |  Temperatura  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  25  | 
|  2020-07-07 10:31:22  |  22  | 
|  2020-07-07 09:30:05  |  19  | 

 Consulta B 


|  Hora  |  Umidade  | 
| --- | --- | 
|  2020-07-07 11:34:20  |  24  | 
|  2020-07-07 10:32:20  |  29  | 
|  2020-07-07 09:30:57  |  33  | 

 A aplicação da transformação `Series to rows` produz os resultados a seguir. 


|  Hora  |  Métrica  |  Valor  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  Temperatura  |  25  | 
|  2020-07-07 11:34:20  |  Umidade  |  22  | 
|  2020-07-07 10:32:20  |  Umidade  |  29  | 
|  2020-07-07 10:31:22  |  Temperatura  |  22  | 
|  2020-07-07 09:30:57  |  Umidade  |  33  | 
|  2020-07-07 09:30:05  |  Temperatura  |  19  | 

### Filtrar dados por valor
<a name="filter-data-by-value"></a>

Esta transformação permite filtrar os dados diretamente no espaço de trabalho da Grafana e remover alguns pontos de dados do resultado da consulta. Você tem a opção de incluir ou excluir dados que correspondam a uma ou mais condições definidas por você. As condições são aplicadas a um campo selecionado.

Esta transformação será útil se a fonte de dados não filtrar nativamente por valores. Você também pode usá-la para restringir os valores a serem exibidos se estiver usando uma consulta compartilhada.

 As condições disponíveis para todos os campos são as seguintes:
+  **Regex**: corresponde a uma expressão regex. 
+  **É nulo**: corresponde se o valor for nulo.
+  **Não é nulo**: corresponde se o valor não for nulo.
+  **Igual**: corresponde se o valor for igual ao valor especificado. 
+  **Diferente**: corresponde se o valor for diferente do valor especificado. 

As condições disponíveis para campos numéricos são as seguintes:
+  **Maior**: corresponde se o valor for maior que o valor especificado. 
+  **Inferior**: corresponde se o valor for menor que o valor especificado. 
+  **Maior ou igual**: corresponde se o valor for maior que ou igual ao valor especificado. 
+  **Menor ou igual**: corresponde se o valor for menor que ou igual ao valor especificado. 
+  **Intervalo**: corresponda um intervalo entre um mínimo e um máximo especificados. O mínimo e o máximo estão incluídos no intervalo.

Você pode adicionar mais de uma condição ao filtro. Quando você tem mais de uma condição, é possível escolher se deseja que a ação de inclusão ou exclusão seja aplicada às linhas que correspondam a todas ou a qualquer uma das condições adicionadas.

As condições que não são válidas ou estão configuradas de forma incompleta são ignoradas.

### Depurar transformações
<a name="debug-transformations"></a>

Para ver os conjuntos de resultados de entrada e saída da transformação, escolha o ícone de bug no lado direito da linha de transformação. 

 O Amazon Managed Grafana exibe a visualização da depuração da transformação abaixo da linha de transformação. 

# Opções de campo e substituições
<a name="field-options-overrides"></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).

 Esta seção explica quais são as opções e substituições de campo no Amazon Managed Grafana e como usá-las. 

 O modelo de dados usado nos espaços de trabalho do Grafana, um quadro de dados, é uma estrutura de tabela orientada por colunas que unifica as séries temporais e os resultados da tabela da consulta. Cada coluna dentro dessa estrutura é chamada de *campo*. Um campo pode representar uma única série temporal ou coluna de tabela. 

 As opções de campo permitem que você altere a forma como os dados são exibidos nas visualizações. As opções e substituições que você aplica não alteram os dados, elas alteram a forma como o Amazon Managed Grafana exibe os dados. 

## Opções de campo
<a name="field-options-overview"></a>

 As *opções de campo*, tanto padrão quanto personalizadas, podem ser encontradas na guia **Campo** no editor do painéis. As alterações feitas nessa guia se aplicam a todos os campos (ou seja, séries e colunas). Por exemplo, se você alterar a unidade para porcentagem, então todos os campos com valores numéricos serão exibidos em porcentagens. Saiba como aplicar uma opção de campo em [Configurar todos os campos](#configure-all-fields). 

## Substituições de campo
<a name="field-overrides-overview"></a>

 As *substituições de campo* podem ser adicionadas na guia **Substituições** no editor de painéis. Nele, você pode adicionar as mesmas opções encontradas na guia **Campo**, mas elas são aplicadas somente a campos específicos. Saiba como aplicar uma substituição em [Configurar campos específicos](#configure-specific-fields).

## Opções de campo disponíveis e substituições
<a name="available-field-options-and-overrides"></a>

 Os tipos de opção de campo são comuns às opções de campo e às substituições de campo. A única diferença é se a alteração será aplicada a todos os campos (aplicada na guia **Campo**) ou a um subconjunto de campos (aplicada na guia **Substituições**). 
+  [Opções de campo padrão](#standard-field-options) aplicam-se a todas as visualizações de painel que permitem transformações. 
+  [Opções de campo de tabelas](table-panel.md#table-field-options) aplicam-se somente às visualizações do painel de tabela. 

### Configurar todos os campos
<a name="configure-all-fields"></a>

 Para alterar a forma como todos os campos exibem dados, você pode alterar uma opção na guia **Campo**. Na guia **Substituições**, você pode então substituir as opções de campo para campos específicos. Para obter mais informações, consulte [Configurar campos específicos](#configure-specific-fields). 

 Por exemplo, você pode alterar o número de casas decimais mostradas em todos os campos alterando a opção **Decimais**. Para obter mais informações sobre as opções, consulte [Opções de campo padrão](#standard-field-options) e [Opções de campo de tabelas](table-panel.md#table-field-options). 

#### Alterar uma opção de campo
<a name="change-a-field-option"></a>

 Você pode alterar quantas opções quiser. 

**Para alterar uma opção de campo**

1.  Escolha o painel que você deseja editar, escolha o título e, em seguida, escolha **Editar**. 

1.  Escolha a guia **Campo**. 

1.  Encontre a opção que você deseja alterar. Você pode definir o seguinte: 
   +  [Opções de campo padrão](#standard-field-options), que se aplicam a todas as visualizações de painel que permitem transformações. 
   +  [Opções de campo de tabelas](table-panel.md#table-field-options), que se aplicam somente às visualizações do painel de tabela. 

1.  Adicione opções acrescentando valores nos campos. Para retornar as opções aos valores padrão, exclua o texto em branco nos campos. 

1.  Ao terminar de fazer edições no dashboard, escolha **Salvar**. 

#### Exemplo de opção de campo
<a name="field-option-example"></a>

 Vamos supor que o conjunto de resultados seja um quadro de dados que consiste em dois campos: tempo e temperatura. 


|  horário  |  temperatura  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45.0  | 
|  2020-01-02 03:05:00  |  47,0  | 
|  2020-01-02 03:06:00  |  48,0  | 

 Cada campo (coluna) dessa estrutura pode ter opções de campo aplicadas de uma forma que altere o modo como seus valores são exibidos. Por exemplo, você pode definir a Unidade como Temperatura > Celsius, resultando na tabela a seguir. 


|  horário  |  temperatura  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45,0 °C  | 
|  2020-01-02 03:05:00  |  47,0 °C  | 
|  2020-01-02 03:06:00  |  48,0 °C  | 

 A casa decimal não significa nada nesse caso. Você pode alterar os decimais de `auto` para zero (`0`), resultando na tabela a seguir. 


|  horário  |  temperatura  | 
| --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  | 
|  2020-01-02 03:05:00  |  47 °C  | 
|  2020-01-02 03:06:00  |  48 °C  | 

### Configurar campos específicos
<a name="configure-specific-fields"></a>

 Você pode usar substituições para alterar as configurações de um ou mais campos. As opções de campo para substituições são exatamente iguais às opções de campo que estão disponíveis em uma visualização específica. A única diferença é que você escolhe em quais campos aplicá-las. 

 Por exemplo, você pode alterar o número de casas decimais mostradas em todos os campos ou colunas numéricos alterando a opção **Decimais** para **Campos com tipo** que corresponda a **Numérico**. Para obter mais informações sobre as opções, consulte [Opções de campo padrão](#standard-field-options), que se aplicam a todas as visualizações de painel que permitem transformações, e [Opções de campo de tabelas](table-panel.md#table-field-options) que se aplicam somente às visualizações de painel de tabela. 

#### Adicionar uma substituição de campo
<a name="add-a-field-override"></a>

 Você pode substituir quantas opções de campo quiser. 

**Para adicionar uma substituição de campo**

1.  Escolha o painel que você deseja editar, escolha o título e, em seguida, escolha **Editar**. 

1.  Escolha a guia **Substituições**. 

1.  Escolha **Adicionar uma substituição para**. 

1.  Selecione os campos aos quais você deseja aplicar uma regra de substituição. 
   +  **Campos com nome**: use esta opção para selecionar um campo na lista de todos os campos disponíveis. As propriedades que você adiciona a uma regra com esse seletor são aplicadas somente a esse único campo. 
   +  **Campos com regex de correspondência de nome**: use para especificar os campos a serem substituídos por uma expressão regular. As propriedades que você adiciona a uma regra usando esse seletor são aplicadas a todos os campos em que os nomes dos campos correspondem ao regex. 
   +  **Campos com tipo**: use para selecionar campos por tipo, como string, numérico e assim por diante. As propriedades que você adiciona a uma regra com esse seletor são aplicadas a todos os campos que correspondem ao tipo selecionado. 

1.  Escolha **Adicionar propriedade de substituição**. 

1.  Selecione a opção de campo que você deseja aplicar. 

1.  Insira as opções adicionando valores nos campos. Para retornar as opções aos valores padrão, exclua o texto em branco nos campos. 

1. Continue adicionando substituições a esse campo escolhendo **Adicionar propriedade de substituição**, ou você pode escolher **Adicionar substituição** e selecionar outro campo ao qual adicionar substituições.

1.  Quando terminar, escolha **Save (Salvar)**. 

#### Excluir uma substituição de campo
<a name="delete-a-field-override"></a>

1.  Escolha a guia Substituições que contém a substituição que você deseja excluir. 

1.  Escolha o ícone da lixeira ao lado da substituição. 

#### Exemplo de substituição de campo
<a name="field-override-example"></a>

Vamos supor que nosso conjunto de resultados seja um quadro de dados que consiste em quatro campos: tempo, alta temperatura, baixa temperatura e umidade. 


|  horário  |  alta temperatura  |  baixa temperatura  |  umidade  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45.0  |  30.0  |  67  | 
|  2020-01-02 03:05:00  |  47,0  |  34,0  |  68  | 
|  2020-01-02 03:06:00  |  48,0  |  31,0  |  68  | 

 Vamos aplicar as opções de campo de [Exemplo de opção de campo](#field-option-example) para aplicar a unidade Celsius e eliminar a casa decimal. Isso resulta na tabela a seguir. 


|  horário  |  alta temperatura  |  baixa temperatura  |  umidade  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67 °C  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68 °C  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68 °C  | 

 Os campos de temperatura parecem bons, mas a umidade está disparatada. Você pode corrigir essa questão aplicando uma substituição de opção de campo ao campo de umidade e alterando a unidade para Misc > por cento (0 a 100). Isso resulta em uma tabela que faz muito mais sentido. 


|  horário  |  alta temperatura  |  baixa temperatura  |  umidade  | 
| --- | --- | --- | --- | 
|  2020-01-02 03:04:00  |  45 °C  |  30 °C  |  67%  | 
|  2020-01-02 03:05:00  |  47 °C  |  34 °C  |  68%  | 
|  2020-01-02 03:06:00  |  48 °C  |  31 °C  |  68%  | 

### Opções de campo padrão
<a name="standard-field-options"></a>

 Esta seção explica as opções de campo disponíveis. Elas são listadas em ordem alfabética. 

 Você pode aplicar as opções de campo padrão à maioria dos painéis integrados da área de trabalho do Grafana. Alguns painéis antigos e painéis comunitários que não foram atualizados para o novo painel e modelo de dados perderão todas ou algumas dessas opções de campo. 

 A maioria das opções de campo não afetará a visualização até que você escolha fora da caixa de opções de campo que você está editando ou pressione Enter. 

 Para obter mais informações sobre como aplicar essas opções, consulte as seguintes seções: 
+  [Configurar todos os campos](#configure-all-fields) 
+  [Configurar campos específicos](#configure-specific-fields) 

#### Decimais
<a name="decimals"></a>

 Esta opção define o número de decimais a serem incluídos ao renderizar um valor. Deixe em branco para que o Amazon Managed Grafana use o número de decimais fornecido pela fonte de dados. 

 Para alterar essa configuração, insira um número no campo. 

#### Links de dados
<a name="data-links-overview"></a>

 Esta opção controla o URL ao qual um valor ou visualização está vinculado. Para obter mais informações e instruções, consulte [Links de dados](data-links.md). 

#### Nome de exibição
<a name="display-name"></a>

 Esta opção define o título de exibição de todos os campos. Você pode usar variáveis no título do campo. Para obter mais informações sobre modelos e variáveis de modelos, consulte [Modelos e variáveis](templates-and-variables.md). 

 Quando várias estatísticas, campos ou séries são mostrados, esse campo controla o título em cada estatística. Você pode usar expressões como `${__field.name}` para usar somente o nome da série ou o nome do campo no título. 

 Fornecido um campo com o nome Temp e rótulos de \$1"Loc"="PBI", "Sensor"="3"\$1 


|  Sintaxe da expressão  |  Exemplo  |  Renderiza para  |  Explicação  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  O mesmo que a sintaxe  |  Temp \$1Loc="PBI", Sensor="3"\$1  |  Exibe o nome do campo e os rótulos entre \$1\$1, se estiverem presentes. Se houver apenas uma chave de rótulo na resposta, então, para a parte do rótulo, o Amazon Managed Grafana exibirá o valor do rótulo sem os colchetes.  | 
|  \$1\$1\$1\$1field.name\$1  |  O mesmo que a sintaxe  |  Temp  |  Exibe o nome do campo (sem rótulos).  | 
|  \$1\$1\$1\$1field.labels\$1  |  O mesmo que a sintaxe  |  Loc="PBI", Sensor="3"  |  Exibe os rótulos sem o nome.  | 
|  \$1\$1\$1\$1field.labels.X\$1  |  \$1\$1\$1\$1field.labels.Loc\$1  |  PBI  |  Exibe o valor da chave de rótulo especificada.  | 
|  \$1\$1\$1\$1field.labels.\$1\$1values\$1  |  O mesmo que a sintaxe  |  PBI, 3  |  Exibe os valores dos rótulos separados por uma vírgula (sem as chaves do rótulo).  | 

 Se o valor for uma string vazia após renderizar a expressão para um campo específico, o método de exibição padrão será usado. 

#### Máx
<a name="max"></a>

 Esta opção define o valor máximo usado nos cálculos do limite percentual. Para o cálculo automático com base em todas as séries e campos, deixe esta configuração em branco. 

#### Mín.
<a name="min"></a>

 Esta opção define o valor mínimo usado nos cálculos do limite percentual. Para o cálculo automático com base em todas as séries e campos, deixe esta configuração em branco. 

#### Nenhum valor
<a name="no-value"></a>

 Insira o que o Amazon Managed Grafana deve exibir se o valor do campo estiver vazio ou nulo. 

#### Unidade
<a name="unit"></a>

 Esta opção especifica a unidade que um campo deve usar. Escolha o campo **Unidade** e, em seguida, faça uma busca detalhada até encontrar a unidade desejada. A unidade selecionada será aplicada a todos os campos, exceto a hora. 

##### Unidades personalizadas
<a name="custom-units"></a>

 Você também pode usar a lista suspensa de unidades para especificar unidades personalizadas, prefixo ou sufixo personalizado e formatos. date/time 

 Para selecionar uma unidade personalizada, insira a unidade e selecione a última opção `Custom: xxx` na lista suspensa. 
+  `suffix:<suffix>` para uma unidade personalizada que deve ficar depois do valor. 
+  `time:<format>`para date/time formatos personalizados; por exemplo,`time:YYYY-MM-DD`. Para obter a sintaxe e as opções de formato, consulte [Exibir](https://momentjs.com/docs/#/displaying/). 
+  `si:<base scale><unit characters>` para unidades personalizadas do SI; por exemplo, `si: mF`. Esta opção é um pouco mais avançada porque você pode especificar uma unidade e a escala de dados de origem. Por exemplo, se os dados de origem forem representados como uma unidade mili (milhares de), prefixe a unidade com o caractere da escala do SI. 
+  `count:<unit>` para uma unidade de contagem personalizada. 
+  `currency:<unit>` para personalizar uma unidade monetária. 

 Você também pode colar um emoji nativo no seletor de unidades e selecioná-lo como uma unidade personalizada. 

##### Unidades de string
<a name="string-units"></a>

 Às vezes, o Amazon Managed Grafana pode analisar strings e mostrá-las como números. Para fazer com que o Amazon Managed Grafana mostre a string original, crie uma substituição de campo e adicione uma propriedade de unidade com a unidade da `string`. 

#### Esquema de cores
<a name="color-scheme"></a>

 A opção de cor do campo define como o Amazon Managed Grafana aplica cores a séries ou campos. Há vários modos aqui que funcionam de forma diferente, e sua utilidade depende muito da visualização atualmente selecionada. 

 Os modos de cores contínuas usam a porcentagem de um valor em relação ao mínimo e ao máximo para interpolar uma cor. 
+  **Cor única**: cor específica definida usando o seletor de cores. Isto é mais útil em uma regra de substituição. 
+  **Nos limites**: cor derivada do limite correspondente. Isto é útil para medidores, estatísticas e visualizações de tabelas. 

##### Aplicar cor por série
<a name="color-by-series"></a>

 O Amazon Managed Grafana inclui esquemas de cores que definem a cor por série. Isso é útil para grafos e diagramas de pizza, por exemplo. 

##### Cor por valor
<a name="color-by-value"></a>

 O Amazon Managed Grafana também inclui esquemas de cores contínuas (gradiente). Isto é útil para visualizações que aplicam cores a valores individuais, por exemplo, painéis de estatísticas e o painel de tabela. 

#### Limites
<a name="thresholds-overview"></a>

 Você pode usar limites para alterar a cor de um campo com base no valor. Para obter mais informações e instruções, consulte [Limites](thresholds.md). 

#### Mapeamento de valores
<a name="value-mapping"></a>

 Você pode usar esta opção para definir regras que traduzem um valor de campo ou um intervalo de valores em texto explícito. Você pode adicionar mais de um mapeamento de valores. 
+  **Tipo de mapeamento**: escolha uma opção. 
  +  **Valor**: insira um valor. Se o valor do campo for maior que ou igual ao valor, o **Texto** será exibido. 
  +  **De** e **Até**: insira um intervalo. Se o valor do campo estiver entre os valores no intervalo, ou igual a eles, o **Texto** será exibido. 
+  **Texto**: o texto exibido se as condições forem atendidas em um campo. Este campo aceita variáveis. 

# Editor de painel
<a name="AMG-panel-editor"></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).

 Este tópico descreve as partes do editor de painéis do Amazon Managed Grafana e inclui links para onde você pode encontrar mais informações. 

## Abrir o editor do painéis
<a name="open-the-panel-editor"></a>

 Há várias maneiras de acessar o editor de painéis, também chamado de tela **Editar painéis**, *modo de edição* ou *modo de edição de painéis*. 
+  Escolha o ícone **Adicionar painel** na parte superior da tela e escolha **Adicionar novo painel**. O novo painel é aberto no editor de painéis. Para obter mais informações sobre como adicionar um painel, consulte [Adicionar um painel](add-a-panel-to-a-dashboard.md). 
+  Escolha o título de um painel existente e depois **Editar**. O painel será aberto no modo de edição. 
+  Escolha qualquer lugar em um painel existente e pressione **e** no teclado. O painel será aberto no modo de edição. 

## Redimensionar seções do editor de painéis
<a name="resize-panel-editor-sections"></a>

 Arraste para redimensionar as seções do editor de painéis. Se o painel lateral ficar muito estreito, as guias **Painel**, **Campo** e **Substituições** mudarão para uma lista suspensa. 

## Partes do editor de painéis
<a name="parts-of-the-panel-editor"></a>

 Esta seção descreve as partes da tela do editor de painéis, com informações sobre campos, opções ou tarefas associadas a cada parte. 

### Cabeçalho
<a name="header"></a>

 A seção do cabeçalho lista o nome do dashboard em que o painel está e alguns comandos do dashboard. Você também pode escolher a seta de **Voltar** para retornar ao dashboard. 

 No lado direito do cabeçalho estão as seguintes opções: 
+  **Ícone de configurações (engrenagem) do dashboard**: escolha para acessar as configurações do dashboard. 
+  **Descartar**: escolha para descartar todas as alterações que você fez no painel desde a última vez que salvou o dashboard. 
+  **Salvar**: escolha salvar o dashboard, incluindo todas as alterações feitas no editor do painéis. 
+  **Aplicar**: escolha para aplicar as alterações que você fez e, em seguida, feche o editor do painéis, retornando ao dashboard. Além disso, salve o dashboard para manter as alterações aplicadas. 

### Pré-visualizar
<a name="visualization-preview"></a>

 A seção de pré-visualização contém opções de visualização, controles de intervalo de tempo, a pré-visualização e (se aplicável) o título, os eixos e a legenda do painel. 
+  **Preencher**: a pré-visualização preenche o espaço disponível na parte de pré-visualização. Se você alterar a largura do painel lateral ou a altura do painel inferior, a visualização se adaptará para preencher qualquer espaço disponível. 
+  **Ajustar**: a pré-visualização preenche o espaço disponível, mas preserva a proporção do painel. 
+  **Exato**: a pré-visualização tem o tamanho exato do tamanho do dashboard. Se não houver espaço suficiente disponível, a visualização será reduzida, preservando a proporção. 
+  **Controles de intervalo de tempo**: para obter mais informações, consulte[Controles de intervalo de tempo](dashboard-time-range-controls.md).

### Seção de dados (painel inferior)
<a name="data-section-bottom-pane"></a>

 A seção de dados contém guias em que você insere consultas, transforma os dados e cria regras de alerta (se aplicável). 
+  **Guia Consulta**: selecione a fonte de dados e insira as consultas aqui. Para obter mais informações, consulte [Consultas](panel-queries.md). 
+  **Aba Transformar**: aplique transformações de dados. Para obter mais informações, consulte [Transformações](panel-transformations.md). 
+  **Aba Alerta**: escreva regras de alerta. Para obter mais informações, consulte [Grafana Alerting](alerts-overview.md). 

### Opções de painel e campo (painel lateral)
<a name="panel-and-field-options-side-pane"></a>

 Esta seção contém guias em que você controla quase todos os aspectos de como os dados são visualizados. Nem todas as guias estão disponíveis para cada visualização. 

 Os recursos dessas guias são documentados nos seguintes tópicos: 
+  [Adicionar um painel](add-a-panel-to-a-dashboard.md) 
+  [Visualizações](AMG-visualizations.md) 
+  [Opções de campo e substituições](field-options-overrides.md) 
+  [Links do painel](panel-links.md) e [Links de dados](data-links.md), que ajudam você a conectar a visualização a outros recursos 

# Painéis de biblioteca
<a name="AMG-library-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).

 Os painéis da biblioteca permitem que os usuários criem painéis reutilizáveis em que todas as alterações feitas em uma instância do painel da biblioteca sejam refletidas em cada dashboard, afetando todas as outras instâncias em que o painel é usado. Esses painéis podem ser salvos em pastas em conjunto com os dashboards e podem simplificar a reutilização de painéis em vários dashboards. 

## Criar um painel de biblioteca
<a name="library-panel-create"></a>

**nota**  
Quando você cria painéis de biblioteca, o painel no dashboard de origem também é convertido em um painel de biblioteca. Você precisará salvar o dashboard original depois que um painel for convertido.

**Para criar um painel de biblioteca**

1. Crie um painel como faria normalmente. Você também pode usar um painel existente.

1. Escolha o título do painel e depois **Editar**.

1. No painel lateral das opções de exibição do painel, escolha a opção de seta para baixo para fazer alterações na visualização.

1. Escolha **Painéis de biblioteca** e depois **Criar novo painel de biblioteca**. 

1. Insira um nome para o painel de biblioteca e selecione a pasta na qual salvá-lo.

1. Escolha **Criar painel de biblioteca** e salve o dashboard.

Você também pode criar painéis de biblioteca usando a opção **Compartilhar** em qualquer painel.

Depois de criado, você pode modificar o painel da biblioteca usando qualquer dashboard em que ele apareça. Depois que as alterações do painel da biblioteca forem salvas, todas as instâncias do painel da biblioteca refletirão essas modificações.

## Adicionar um painel de biblioteca
<a name="library-panel-add"></a>

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

1. Pause na opção \$1 no menu à esquerda e escolha **Criar**.

1. Escolha **Adicionar um painel da biblioteca de painéis**.

1. Filtre a lista de painéis de biblioteca para encontrar o painel que você deseja.

1. Escolha esse painel e adicione-o ao dashboard. 

## Desvincular um painel de biblioteca
<a name="library-panel-unlink"></a>

Se você tiver um painel de biblioteca no dashboard que deseja modificar sem afetar todas as outras instâncias do painel de biblioteca, você poderá desvincular o painel de biblioteca.

**Para desvincular um painel de biblioteca de um dashboard**

1. Pause no **Dashboard** no menu à esquerda e escolha **Painéis de biblioteca**.

1. Selecione um painel de biblioteca. Você verá uma lista de todos os dashboards em que o painel da biblioteca é usado.

1. Selecione o painel que você deseja desvincular e atualizar.

1. Escolha o título do painel e depois **Editar**. 

1. Selecione **Desvincular**. 

## Excluir um painel de biblioteca
<a name="library-panel-delete"></a>

Antes de excluir um painel da biblioteca, verifique se ele não está mais em uso em nenhum dashboard.

**Para excluir um painel de biblioteca**

1. Pause no **Dashboard** no menu à esquerda e escolha **Painéis de biblioteca**.

1. Selecione um painel de biblioteca. Você verá uma lista de todos os dashboards em que o painel da biblioteca é usado.

1. Selecione o painel que deseja excluir.

1. Escolha o ícone de excluir ao lado do nome do painel. 

## Partes do editor de painéis
<a name="parts-of-the-panel-editor"></a>

 Esta seção descreve as partes da tela do editor de painéis, com informações sobre campos, opções ou tarefas associadas a cada parte. 

### Cabeçalho
<a name="header"></a>

 A seção do cabeçalho lista o nome do dashboard em que o painel está e alguns comandos do dashboard. Você também pode escolher a seta de **Voltar** para retornar ao dashboard. 

 No lado direito do cabeçalho estão as seguintes opções: 
+  **Ícone de configurações (engrenagem) do dashboard**: escolha para acessar as configurações do dashboard. 
+  **Descartar**: escolha para descartar todas as alterações que você fez no painel desde a última vez que salvou o dashboard. 
+  **Salvar**: escolha para salvar o dashboard, incluindo todas as alterações que você fez no editor do painéis. 
+  **Aplicar**: escolha para aplicar as alterações que você fez e, em seguida, feche o editor do painéis, retornando ao dashboard. Além disso, salve o dashboard para manter as alterações aplicadas. 

### Pré-visualizar
<a name="visualization-preview"></a>

 A seção de pré-visualização contém opções de visualização, controles de intervalo de tempo, a pré-visualização e (se aplicável) o título, os eixos e a legenda do painel. 
+  **Preencher**: a pré-visualização preenche o espaço disponível na parte de pré-visualização. Se você alterar a largura do painel lateral ou a altura do painel inferior, a visualização se adaptará para preencher qualquer espaço disponível. 
+  **Ajustar**: a pré-visualização preenche o espaço disponível, mas preserva a proporção do painel. 
+  **Exato**: a pré-visualização tem o tamanho exato do tamanho do dashboard. Se não houver espaço suficiente disponível, a visualização será reduzida, preservando a proporção. 
+  **Controles de intervalo de tempo**: para obter mais informações, consulte[Controles de intervalo de tempo](dashboard-time-range-controls.md).

### Seção de dados (painel inferior)
<a name="data-section-bottom-pane"></a>

 A seção de dados contém guias em que você insere consultas, transforma os dados e cria regras de alerta (se aplicável). 
+  **Guia Consulta**: selecione a fonte de dados e insira as consultas aqui. Para obter mais informações, consulte [Consultas](panel-queries.md). 
+  **Aba Transformar**: aplique transformações de dados. Para obter mais informações, consulte [Transformações](panel-transformations.md). 
+  **Aba Alerta**: escreva regras de alerta. Para obter mais informações, consulte [Grafana Alerting](alerts-overview.md). 

### Opções de painel e campo (painel lateral)
<a name="panel-and-field-options-side-pane"></a>

 Esta seção contém guias em que você controla quase todos os aspectos de como os dados são visualizados. Nem todas as guias estão disponíveis para cada visualização. 

 Os recursos dessas guias são documentados nos seguintes tópicos: 
+  [Adicionar um painel](add-a-panel-to-a-dashboard.md) 
+  [Visualizações](AMG-visualizations.md) 
+  [Opções de campo e substituições](field-options-overrides.md) 
+  [Links do painel](panel-links.md) e [Links de dados](data-links.md), que ajudam você a conectar a visualização a outros recursos 

# Visualizações
<a name="AMG-visualizations"></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 oferece uma variedade de visualizações para atender a diferentes casos de uso. As seções a seguir listam as visualizações que estão disponíveis no Amazon Managed Grafana e suas configurações de exibição.

**Topics**
+ [Painel da lista de alertas](alert-list-panel.md)
+ [Painel de gráfico de barras](bar-chart-panel.md)
+ [Painel de medidor em barras](alert-panel-bar-gauge-panel.md)
+ [Painel de relógio](clock-panel.md)
+ [Painel da lista de dashboards](dashboard-list-panel.md)
+ [Painel do medidor](gauge-panel.md)
+ [Painel Mapa geográfico](AMG-Geomap.md)
+ [Painel de grafo](graph-panel.md)
+ [Mapa de calor](visualization-heatmap.md)
+ [Painel de histograma](histogram-panel.md)
+ [Painel de logs](logs-panel.md)
+ [Painel de notícias](news-panel.md)
+ [Painel do grafo de nós (Beta)](node-graph-panel.md)
+ [Painel de gráfico de pizza](pie-chart-panel.md)
+ [Painel Plotly](plotly-panel.md)
+ [Painel Sankey](sankey-panel.md)
+ [Painel de dispersão](scatter-panel.md)
+ [Painel de estatísticas](stat-panel.md)
+ [Painel da linha do tempo do estado](state-timeline-panel.md)
+ [Painel de histórico de status](status-history-panel.md)
+ [Painel de tabela](table-panel.md)
+ [Painel de texto](text-panel.md)
+ [Painel de séries temporais](time-series-panel.md)
+ [Limites](thresholds.md)
+ [WindRose](windrose.md)
+ [Inspecionar um painel](inspect-a-panel.md)
+ [Lista de cálculos](list-of-calculations.md)

# Painel da lista de alertas
<a name="alert-list-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).

O painel da lista de alertas exibe os alertas do dashboard. Você pode configurar a lista para mostrar o estado atual ou as mudanças de estado recentes. Para obter mais informações sobre alertas, consulte [Grafana Alerting](alerts-overview.md).

Use essas configurações para refinar sua visualização.

## Opções
<a name="alert-list-panel-options"></a>
+  **Mostrar**: escolha se o painel deve exibir o estado do alerta atual ou as alterações recentes do estado do alerta.
+  **Máximo de itens**: defina o número máximo de alertas a serem listados.
+  **Ordem de classificação**: selecione como ordenar os alertas exibidos.
  +  **Alfabético (asc.)**: ordem alfabética
  +  **Alfabético (desc.)**: ordem alfabética inversa
  +  **Importância**: por importância, de acordo com os seguintes valores, sendo 1 o mais alto:
    + alerta: 1
    + no\$1data: 2
    + pendente: 3
    + ok: 4
    + pausado: 5
+  **Alertas desse dashboard**: mostre alertas somente do dashboard em que a lista de alertas se encontra.

## Filtro
<a name="alerts-panel-filter"></a>

Use as seguintes opções para filtrar os alertas de acordo com a consulta, a pasta ou as tags que você escolher:
+  **Nome do alerta**: insira uma consulta de nome de alerta. 
+  **Título do dashboard**: insira uma consulta de título do dashboard.
+  **Pasta**: selecione uma pasta. Somente alertas de dashboards na pasta selecionada serão exibidos.
+  **Tags do dashboard**: selecione uma ou mais tags. Somente alertas de dashboards com uma ou mais das tags serão exibidos. 

## Filtro de estados
<a name="alert-panel-state-filter"></a>

Escolha quais estados de alerta serão exibidos nesse painel.
+ Ok
+ Paused
+ Nenhum dado
+ Erro de execução
+ Geração de alertas
+ Pendente

# Painel de gráfico de barras
<a name="bar-chart-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).

Essa visualização em painel permite representar em grafos dados categóricos.

## Formatos de dados compatíveis
<a name="bar-chart-formats"></a>

Somente um quadro de dados é compatível e ele precisa ter pelo menos um campo de string que será usado como categoria para um eixo X ou Y e um ou mais campos numéricos. Veja abaixo um exemplo de formatos de dados:


|  Navegador  |  Participação no mercado  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17,5  | 

Se você tiver mais de um campo numérico, o painel mostrará barras agrupadas.

### Visualizar séries temporais ou vários conjuntos de resultados
<a name="bar-chart-visualization"></a>

Se você tiver várias séries temporais ou tabelas, primeiro precisará juntá-las usando uma associação ou a transformação de redução. Por exemplo, se você tiver várias séries temporais e quiser comparar o último valor e o valor máximo, adicione a transformação Reduzir e especifique Máximo e Último como opções em Cálculos.

## Opções do gráfico de barras
<a name="bar-chart-options"></a>

Use estas opções para refinar as visualizações:

**Orientation (Orientação)**
+  **Automático**: o Grafana decide a orientação da barra com base nas dimensões do painel.
+  **Horizontal**: torna o eixo X o eixo da categoria.
+  **Vertical**: torna o eixo Y o eixo da categoria.

**Mostrar valores**

Controla se os valores são mostrados na parte superior ou à esquerda das barras.
+  **Automático**: os valores serão mostrados se houver espaço.
+  **Sempre**: sempre mostra valores.
+  **Nunca**: nunca mostra valores.

**Largura do grupo** controla a largura dos grupos. 0 = mín. e 1 = largura máx.

**Largura da barra** controla a largura das barras. 0 = mín. e 1 = largura máx.

**Largura da linha** controla a largura da linha das barras.

**Opacidade de preenchimento** controla a opacidade de preenchimento das barras.

**Modo gradiente** define o modo de preenchimento gradiente. O gradiente de preenchimento é baseado na cor da linha. Para alterar a cor, use a opção de campo padrão do esquema de cores. A aparência do gradiente é influenciada pela configuração de Opacidade de preenchimento.
+  **Nenhum**: sem preenchimento gradiente; esta é a configuração padrão.
+  **Opacidade**: a transparência do gradiente é calculada com base nos valores no eixo y. A opacidade do preenchimento está aumentando com os valores no eixo Y.
+  **Matiz**: a cor do gradiente é gerada com base na matiz da cor da linha.

**Modo de dica de ferramenta**: quando você passa o cursor sobre a visualização, o Grafana pode exibir dicas de ferramentas. Escolha como as dicas de ferramentas se comportam.
+  **Único**: a dica de ferramenta ao passar o cursor mostra somente uma única série, aquela sobre a qual você está passando o mouse na visualização.
+  **Tudo**: a dica de ferramenta ao passar o cursor mostra todas as séries na visualização. O Grafana destaca a série sobre a qual você está passando o mouse em negrito na lista de séries na dica de ferramenta.
+  **Oculto**: não exibe a dica de ferramenta quando você interage com a visualização.

**nota**  
Use uma substituição para ocultar séries individuais da dica de ferramenta.

**Modo de legenda**: use estas configurações para refinar como a legenda aparecerá na sua visualização.
+  **Lista**: exibe a legenda como uma lista. Este é um modo de exibição padrão da legenda.
+  **Tabela**: exibe a legenda como uma tabela.
+  **Oculto**: oculta a legenda.

**Posicionamento da legenda**: escolha onde posicionar a legenda.
+  **Parte inferior**: abaixo do grafo.
+  **Direita**: à direita do grafo.

**Cálculos da legenda**: escolha quais dos cálculos padrão serão exibidos na legenda. Você pode ter mais de um.

**Tamanho do texto**: insira um valor para alterar o tamanho do texto no gráfico de barras.

**Eixo**: use as seguintes configurações de campo para refinar a exibição dos eixos. Algumas opções de campo não afetarão a visualização até você clicar fora da caixa de opções do campo que você está editando, ou pressionar Enter.
+  **Posicionamento**: define o posicionamento do eixo Y.
+  **Automático**: o Grafana atribui automaticamente o eixo Y à série. Quando há duas ou mais séries com unidades diferentes, o Grafana atribui o eixo esquerdo à primeira unidade e o direito às unidades seguintes.
+  **Esquerda**: exibe todos os eixos Y no lado esquerdo.
+  **Direita**: exibe todos os eixos Y no lado direito.
+  **Oculto**: oculta todos os eixos Y.
+  **Rótulo**: defina um rótulo de texto no eixo Y. Caso tenha mais de um eixo Y, você poderá atribuir diferentes rótulos com uma substituição.
+  **Largura**: defina uma largura fixa do eixo. Por padrão, o Grafana calcula dinamicamente a largura de um eixo.

  Ao definir a largura do eixo, os dados com diferentes tipos de eixos podem compartilhar as mesmas proporções de exibição. Isso facilita a comparação de dados de mais de um grafo porque os eixos não são deslocados ou estendidos dentro da proximidade visual um do outro.
+  **Mín. e máx. flexíveis**: defina uma opção de mín. e máx. flexíveis para melhor controle dos limites do eixo Y. Por padrão, o Grafana define o intervalo do eixo Y automaticamente com base no conjunto de dados.

  As configurações de mínimo e máximo flexíveis podem evitar que os blips se transformem em montanhas quando os dados estão praticamente nivelados, e as opções de mínimo e máximo rígidos derivados das opções do campo mínimo e máximo padrão podem evitar que picos intermitentes nivelem detalhes úteis ao cortar os picos além de um ponto definido.

  Você pode definir min/max opções padrão para definir limites rígidos do eixo Y.

# Painel de medidor em barras
<a name="alert-panel-bar-gauge-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).

O medidor em barras simplifica seus dados reduzindo cada campo a um único valor. Você escolhe como o Amazon Managed Grafana calcula a redução.

Esse painel pode mostrar um ou mais medidores em barras, dependendo de quantas séries, linhas ou colunas sua consulta retorna.

## Opções de dados e campos
<a name="bar-gauge-data-and-field-options"></a>

Com as visualizações do Medidor em barras, você pode aplicar as seguintes opções:
+  [Transformações](panel-transformations.md) 
+  [Opções de campo e substituições](field-options-overrides.md) 
+  [Limites](thresholds.md) 

## Opções de exibição
<a name="bar-gauge-display-options"></a>

Use as seguintes opções para refinar a visualização:
+  **Mostrar**: escolha como o Amazon Managed Grafana exibirá os dados.
  +  **Calcular**: mostra um valor calculado com base em todas as linhas. Para obter uma lista dos cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md).
  +  **Todos os valores**: mostre uma estatística separada para cada linha. Se você selecionar esta opção, também poderá selecionar um **Limite** ou o número máximo de linhas a serem exibidas.
+  **Valor**: selecione uma função de redução que o Amazon Managed Grafana usará para reduzir vários campos a um único valor. Escolha a lista **Valor** para ver as funções e breves descrições. 
+  **Orientação**: escolha uma direção de empilhamento.
  +  **Automático**: o Amazon Managed Grafana seleciona a orientação que considera mais adequada.
  +  **Horizontal**: as barras se estendem horizontalmente, da esquerda para a direita.
  +  **Vertical**: as barras se estendem verticalmente, de cima para baixo.
+  **Modo de exibição**: escolha um modo de exibição.
  +  **Gradiente**: escolha um nível limite para definir um gradiente.
  +  **Retro LCD**: exibe o medidor dividido em pequenas células que estão acesas ou apagadas.
  +  **Básico**: use uma única cor com base no limite correspondente.
+  **Mostrar área não preenchida**: selecione esta opção se quiser renderizar a região não preenchida das barras como cinza escuro. Esta opção não está disponível para o modo de exibição Retro LCD.

# Painel de relógio
<a name="clock-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).

O painel de relógio mostra a hora atual ou uma contagem regressiva. Ele é atualizado a cada segundo.
+ **Modo**: o padrão é **hora**. Se você escolher **contagem regressiva**, defina o **Prazo de contagem regressiva** para iniciar a contagem regressiva.
+ **12 ou 24 horas**: as opções para mostrar a hora são no formato de 12 horas e 24 horas.
+ **Fuso horário**: os fusos horários são fornecidos pela biblioteca moment-timezone. O padrão é o fuso horário do computador.
+ **Prazo de contagem regressiva**: especifique a hora e a data para a contagem regressiva, se você tiver definido o **Modo** para **contagem regressiva**.
+ **Texto final da contagem regressiva**: especifique o texto a ser exibido quando a contagem regressiva terminar.
+ **Opções de formatação de data/hora** — Personalize o tamanho, o peso e a formatação da fonte. date/time Se você estiver mostrando uma contagem regressiva e não quiser ver os segundos passando, altere o formato da hora para `hh:mm` para o relógio de 24 horas ou `h:mm A` para o relógio de 12 horas. Para obter uma lista completa de opções, consulte [Exibição](https://momentjs.com/docs/#/displaying/).
+ **Cor de fundo**: selecione uma cor de fundo para o relógio.

# Painel da lista de dashboards
<a name="dashboard-list-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).

O painel da lista de dashboards exibe links dinâmicos para outros dashboards. A lista pode ser configurada para usar dashboards com estrela, dashboards visualizados recentemente, uma consulta de pesquisa e tags de dashboard.

Em cada carregamento do painel, esse painel consulta a lista do painel, sempre fornecendo o máximo de up-to-date resultados.

## Opções
<a name="options-1"></a>

Use as seguintes opções para refinar a visualização:
+  **Com estrela**: exiba dashboards com estrela em ordem alfabética.
+  **Visualizados recentemente**: exiba dashboards visualizados recentemente em ordem alfabética.
+  **Pesquisar**: exiba dashboards por tags ou consulta de pesquisa. Esta opção exige que você insira pelo menos um valor em **Consulta** ou **Tags**.
+  **Mostrar cabeçalhos**: mostra a seleção da lista escolhida (Com estrela, Visualizada recentemente, Pesquisa) como um título.
+  **Máximo de itens**: defina o número máximo de itens a serem listados por seção. Por exemplo, no valor padrão de 10, se optar por exibir dashboards com estrela e visualizados recentemente, o painel exibirá até 20 dashboards no total, dez em cada seção.

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

As opções a seguir se aplicarão somente se a opção **Pesquisar** estiver selecionada.
+  **Consulta**: insira a consulta que você deseja pesquisar. As consultas não diferenciam maiúsculas de minúsculas e valores parciais são aceitos.
+  **Pasta**: selecione as pastas do dashboard que você deseja exibir.
+  **Tags**: insira as tags que você deseja pesquisar. Observe que as tags existentes não aparecerão enquanto você digita, e elas *diferenciam* maiúsculas de minúsculas.

**nota**  
Quando várias tags e strings aparecem, a dashboard exibe aquelas que correspondem a *todas* as condições.

# Painel do medidor
<a name="gauge-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).

 **Medidor** é um painel de valor único que pode repetir um medidor para cada série, coluna ou linha.

## Opções de dados e campos
<a name="gauge-panel-data-and-field-options"></a>

As visualizações de medidor permitem aplicar as seguintes opções:
+  [Transformações](panel-transformations.md) 
+  [Opções de campo e substituições](field-options-overrides.md) 
+  [Limites](thresholds.md) 

## Opções de exibição
<a name="gauge-panel-display-options-2"></a>

Para refinar a visualização, use as seguintes opções:
+  **Mostrar**: escolha como o Amazon Managed Grafana exibirá os dados.
  +  **Calcular**: mostra um **valor** calculado com base em todas as linhas. Para obter uma lista dos cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md).
  +  **Todos os valores**: mostre uma estatística separada para cada linha. Se você selecionar esta opção, também poderá selecionar um **Limite** ou o número máximo de linhas a serem exibidas.
+  **Orientação**: escolha uma direção de empilhamento.
  +  **Automático**: o Amazon Managed Grafana seleciona o que considera ser a melhor orientação.
  +  **Horizontal**: as barras se estendem horizontalmente, da esquerda para a direita.
  +  **Vertical**: as barras se estendem verticalmente, de cima para baixo.
+  **Mostrar rótulos de limite**: escolha se deseja mostrar valores de limite.
+  **Mostrar marcadores de limite**: escolha se uma faixa de limite será mostrada fora da faixa interna de valores do medidor.

# Painel Mapa geográfico
<a name="AMG-Geomap"></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).

A visualização do painel **Mapa geográfico** permite que você visualize e personalize o mapa-múndi usando dados geoespaciais. Para se concentrar facilmente nas características importantes dos dados com base na localização, você pode definir vários estilos de sobreposição e configurações de visualização do mapa.

## Camada de dados
<a name="Data-Layer"></a>

A camada de dados no plug-in do Mapa geográfico determina como você visualiza os dados geoespaciais por cima do mapa base.

### Local
<a name="Location"></a>

O painel **Mapa geográfico** precisa de uma fonte de dados geográficos. Esses dados vêm de uma consulta ao banco de dados, e há quatro opções de mapeamento para seus dados.
+ **Automático** pesquisa automaticamente os dados de localização. Use esta opção quando sua consulta for baseada em um dos nomes a seguir para campos de dados.
  + geohash: “geohash”
  + latitude: “latitude”, “lat”
  + longitude: “longitude”, “lng”, “long”
  + pesquisa: “pesquisa”
+  **Coords** especifica que sua consulta contém dados de coordenadas. Você será solicitado a selecionar campos de dados numéricos para latitude e longitude na consulta do banco de dados.
+  **Geohash** especifica que sua consulta contém dados de geohash. Você será solicitado a selecionar um campo de dados de string para o geohash em sua consulta de banco de dados.
+  **Pesquisa** especifica que sua consulta contém dados do nome do local que precisam ser mapeados para um valor. Você será solicitado a selecionar o campo de pesquisa da consulta do banco de dados e um ` gazetteer`. O ` gazetteer ` é o diretório usado para mapear os dados consultados para um ponto geográfico.

## Camada de marcadores
<a name="Markers-Layer"></a>

A camada **Marcadores** permite que você exiba pontos de dados em diferentes formas de marcadores, como círculos, quadrados, triângulos, estrelas e muito mais.
+ **Cor do marcador** configura a cor do marcador. O tamanho fixo padrão mantém todos os pontos em uma única cor. Há uma opção alternativa para ter várias cores, dependendo dos valores dos pontos de dados e do limite definido na seção **Limites**.
+  **Tamanho do marcador** configura o tamanho do marcador. O padrão é ` Fixed size`, fazendo com que o tamanho de todos os marcadores seja o mesmo, independentemente dos pontos de dados. No entanto, também existe a opção de dimensionar os círculos para os pontos de dados correspondentes. O tamanho do marcador ` Min` e `Max ` deve ser definido de forma que a camada do marcador possa ser dimensionada dentro desses intervalos.
+  O **Tamanho do marcador** oferece a flexibilidade de visualizar os pontos de dados de forma diferente.
  + Circle (Círculo)
  + Square (Quadrado)
  + Triângulo
  + Cruz
  + X
+  **Opacidade de preenchimento** configura a transparência de cada marcador.

## Camada do mapa de calor
<a name="Heatmap-layer"></a>

A camada **Mapa de calor** agrupa vários pontos de dados para visualizar locais com densidades diferentes. Para adicionar uma camada de mapa de calor, em **Camada de dados**, escolha **Mapa de calor**.



Semelhante aos **marcadores**, você recebe várias opções para determinar quais pontos de dados visualizar e como.
+ **Valores de ponderação** configuram a intensidade dos clusters de mapas de calor. O valor fixo mantém um valor de ponderação constante em todos os pontos de dados. Este valor deve estar entre 0 e 1. Semelhante aos **marcadores**, há uma opção alternativa na lista suspensa para dimensionar automaticamente os valores de ponderação, dependendo dos valores dos dados. 
+  **Raio** configura o tamanho dos clusters de mapas de calor.
+  **Desfoque** configura a quantidade de desfoque em cada cluster.

# Painel de grafo
<a name="graph-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).

Um painel de grafo pode ser renderizado como uma linha, um caminho de pontos ou uma série de barras. Esse tipo de grafo é versátil o suficiente para exibir quase todos os dados de séries temporais.

## Opções de dados e campos
<a name="graph-panel-data-and-field-options"></a>

Ao usar visualizações de grafos, você pode aplicar as seguintes opções:
+  [Transformações](panel-transformations.md) 
+ Alertas. Este é o único tipo de visualização que permite definir alertas. Para obter mais informações, consulte [Grafana Alerting](alerts-overview.md).
+  [Limites](thresholds.md) 

## Opções de exibição
<a name="graph-panel-display-options"></a>

Para refinar a visualização, use as seguintes configurações:
+  **Barras**: exiba valores como um gráfico de barras. 
+  **Linhas**: exiba valores como um grafo de linhas. 
+  **Largura da linha**: especifique a largura da linha para uma série. O padrão é um.
+  **Escada**: desenhe pontos adjacentes como uma escada.
+  **Preenchimento de área**: especifique a quantidade de preenchimento de cores para uma série. O padrão é 1; 0 é nenhum.
+  **Gradiente de preenchimento**: especifique o grau de gradiente no preenchimento da área. O padrão é 0, que é nenhum gradiente; 10 é um gradiente acentuado.
+  **Pontos**: exibe pontos para valores. 
+  **Raio do ponto**: controle o tamanho dos pontos.
+  **Limites de alerta**: exiba limites e regiões de alerta no painel.

### Empilhamento e valor nulo
<a name="stacking-and-null-value"></a>
+  **Pilha**: cada série é empilhada em cima da outra.
+  **Porcentagem**: cada série é desenhada como uma porcentagem do total de todas as séries. Esta opção está disponível quando a opção **Pilha** é selecionada.
+  **Valor nulo**: especifique como os valores nulos são exibidos. *Esta é uma configuração importante.* Verifique a observação abaixo.
  +  **conectado**: se houver uma lacuna na série, ou seja, um ou mais valores nulos, a linha pulará a lacuna e se conectará ao próximo valor não nulo. 
  +  **nulo**: se houver uma lacuna na série, ou seja, um valor nulo, a linha no grafo será quebrada e mostrará a lacuna. Essa é a configuração padrão.
  +  **nulo como zero**: se houver uma lacuna na série, ou seja, um valor nulo, ela será exibida como um valor zero no painel de grafo.

**Importante**  
Se você estiver monitorando a carga da CPU de um servidor e ela atingir 100%, o servidor travará e o agente que envia as estatísticas não poderá coletar a estatística da carga. Isso leva a uma lacuna nas métricas, e usar a configuração *null* padrão significa que o Amazon Managed Grafana mostrará as lacunas e indicará que algo está errado. Se estiver configurado como *conectado*, será fácil perder esse sinal. 

### Dica de ferramenta ao passar o cursor
<a name="graph-panel-hover-tooltip"></a>

Use essas configurações para alterar a aparência da dica de ferramenta que aparece quando você pausa sobre a visualização do grafo.
+  **Modo**: determina quantas séries a dica de ferramenta ao passar o cursor mostra.
  +  **Todas as séries**: a dica de ferramenta ao passar o cursor mostra todas as séries no grafo. Na lista de séries na dica de ferramenta, o espaço de trabalho do Grafana destaca a série na qual você está pausando em negrito.
  +  **Único**: a dica de ferramenta ao passar o cursor mostra somente uma única série, aquela em que você está pausando no grafo.
+  **Ordem de classificação**: classificará a ordem das séries na dica de ferramenta ao passar o cursor se você tiver selecionado o modo **Todas as séries**. Quando você pausa em um grafo, o Amazon Managed Grafana exibe os valores associados às linhas. Geralmente, os usuários estão mais interessados nos valores mais altos ou mais baixos. A classificação desses valores pode facilitar muito a localização dos dados que você deseja.
  +  **Nenhuma**: a ordem da série na dica de ferramenta é determinada pela ordem de classificação em sua consulta. Por exemplo, você pode classificar a série em ordem alfabética pelo nome da série.
  +  **Crescente**: as séries na dica de ferramenta ao passar o cursor são classificadas por valor e em ordem crescente, com o valor mais baixo no topo da lista.
  +  **Decrescente**: as séries na dica de ferramenta ao passar o cursor são classificadas por valor e em ordem decrescente, com o valor mais alto no topo da lista.

## Substituições de séries
<a name="graph-panel-series-overrides"></a>

As substituições de séries permitem que uma série em um painel de grafo seja renderizada de forma diferente das outras. Você pode personalizar as opções de exibição por série ou usando regras de regex. Por exemplo, uma série pode ter uma largura de linha mais grossa para destacá-la ou ser movida para o eixo Y direito.

Você pode adicionar várias substituições de séries.

**Para adicionar uma substituição de série**

1. Escolha **Adicionar substituição de série**.

1. Em **Alias ou regex**, digite ou selecione uma série. Selecione o campo para ver uma lista das séries disponíveis.

   Por exemplo, `/Network.*/` corresponderia a duas séries chamadas `Network out` e `Network in`.

1. Escolha **\$1** e, em seguida, selecione um estilo para aplicar à série. Você pode adicionar vários estilos a cada entrada.
+  **Barras**: mostre séries como um grafo de barras. 
+  **Linhas**: mostre séries como um grafo de linhas. 
+  **Preenchimento de linha**: mostre um grafo de linhas com preenchimento de área. 
+  **Gradiente de preenchimento**: especifique a quantidade do gradiente de preenchimento da área.
+  **Largura da linha**: defina a largura da linha.
+  **Modo de ponto nulo**: use esta opção para ignorar valores nulos ou substituí-los por zero. Isso será importante se você quiser ignorar lacunas nos dados.
+  **Preencher abaixo até**: preenche a área entre duas séries.
+  **Linha de escada**: mostra a série como uma linha de escada.
+  **Traços**: mostra uma linha com traços. 
+  **Série oculta**: oculta a série. 
+  **Comprimento do traço**: defina o comprimento dos traços na linha.
+  **Espaço do traço**: defina o comprimento dos espaços entre os traços na linha.
+  **Pontos**: mostra as séries como pontos separados.
+  **Raio do ponto**: defina o raio para a renderização de pontos.
+  **Pilha**: defina o grupo de pilhas para a série.
+  **Cor**: defina a cor da série.
+  **Eixo Y**: defina o eixo y da série.
+  **Índice Z**: defina o índice z da série (ordem de renderização). Esta opção é importante quando você sobrepõe estilos diferentes, como gráficos de barras e gráficos de áreas.
+  Transformar: transforme o valor em negativo para renderizar abaixo do eixo y.
+  **Legenda**: controle se uma série é mostrada na legenda.
+  **Ocultar na dica de ferramenta**: controle se uma série é mostrada em uma dica de ferramenta de grafo.

## Axes (Eixos)
<a name="graph-panel-axes"></a>

Use estas opções para controlar a exibição dos eixos na visualização.

### Y/Right Y esquerdo
<a name="left-yright-y"></a>

As opções são idênticas para os dois eixos y.
+  **Mostrar**: escolha mostrar ou ocultar o eixo.
+  **Unidade**: escolha a unidade de exibição para o valor y.
+  **Escala**: escolha a escala a ser usada para o valor y: **linear** ou **logarítmico**. O padrão é **linear**.
+  **Y-Mín.**: o valor mínimo de y. O padrão é **auto**.
+  **Y-Máx.**: o valor máximo de Y. O padrão é **auto**.
+  **Decimais**: defina quantos decimais são exibidos para o valor y. O padrão é **auto**. 
+  **Rótulo**: especifique o rótulo do eixo y. O padrão é “”.

### Eixos Y
<a name="y-axes"></a>
+  **Alinhar**: alinha os eixos y esquerdo e direito por valor. O padrão é desmarcado e false.
+  **Nível**: insira o valor a ser usado para o alinhamento dos eixos y esquerdo e direito, começando em Y = 0. O padrão é 0. Esta opção está disponível quando **Alinhar** está selecionado. 

### Eixo x
<a name="x-axis"></a>
+  **Mostrar**: escolha mostrar ou ocultar o eixo.
+  **Modo**: o modo de exibição altera completamente a visualização do painel de grafo. É como três painéis em um. O modo principal é o modo de série temporal com o tempo no eixo x. Os outros dois modos são um modo básico de gráfico de barras com séries no eixo x em vez de tempo e um modo de histograma.
  +  **Hora** (padrão): o eixo x representa a hora e os dados são agrupados por hora (por exemplo, por hora ou por minuto).
  +  **Séries**: os dados são agrupados por série e não por hora. O eixo y ainda representa o valor.
    +  **Valor**: este é o tipo de agregação a ser usado para os valores. O padrão é **total** (somando os valores).
  +  **Histograma**: esta opção converte o grafo em um histograma. Um histograma é um tipo de gráfico de barras que agrupa números em intervalos, geralmente chamados de buckets ou compartimentos. Barras mais altas mostram que mais dados estão nessa faixa.

    Para obter mais informações sobre histogramas, consulte [Introdução aos histogramas e mapas de calor](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).
    +  **Buckets**: define o número de buckets pelos quais agrupar os valores. Se deixado vazio, o Amazon Managed Grafana tenta calcular um número adequado de buckets.
    +  **X-Mín.**: filtra valores do histograma que são menores que esse limite mínimo.
    +  **X-Máx.**: filtra valores que são maiores que esse limite máximo.

## Legenda
<a name="graph-panel-legend"></a>

Use estas configurações para refinar a forma como a legenda aparece na visualização.

### Opções
<a name="graph-panel-legends-options"></a>
+  **Mostrar**: limpe para ocultar a legenda. O padrão é selecionado (true).
+  **Como tabela**: selecione para exibir a legenda na tabela. O padrão é marcado (true).
+  **À direita**: selecione para exibir a legenda à direita.
+  Largura: insira a largura mínima da legenda em pixels. Esta opção está disponível quando a opção **Para a direita** está selecionada.

### Valores
<a name="graph-panel-values"></a>

Valores adicionais podem ser mostrados ao lado dos nomes das legendas.
+  **Mín.**: o valor mínimo retornado da consulta de métricas.
+  **Máx.**: o valor máximo retornado da consulta de métricas.
+  **Méd.**: o valor médio retornado da consulta de métricas.
+  **Atual**: o valor atual retornado da consulta de métricas.
+  **Total**: a soma de todos os valores retornados da consulta de métricas.
+  **Decimais**: quantos decimais são exibidos para valores de legenda e dicas de ferramentas ao passar o cursor sobre o grafo.

O Amazon Managed Grafana calcula os valores das legendas no lado do cliente. Esses valores de legenda dependem do tipo de agregação ou da consolidação de pontos que sua consulta métrica está usando. Todos os valores da legenda acima não podem estar corretos ao mesmo tempo.

Por exemplo, se você traçar uma taxa como solicitações por segundo, que provavelmente está usando a média como um agregador, o Total na legenda não representará o número total de solicitações. É apenas a soma de todos os pontos de dados recebidos pelo Amazon Managed Grafana. 

### Ocultar as séries
<a name="graph-panel-hide-series"></a>

Oculte séries quando todos os valores de uma série de uma consulta de métricas tiverem um valor específico.
+  **Com apenas nulos**: valor = nulo (padrão não marcado)
+  **Com apenas zeros**: valor = zero (padrão não marcado)

### Regiões de tempo
<a name="graph-panel-time-regions"></a>

Você pode destacar regiões de tempo específicas no grafo para facilitar a visualização. Por exemplo, fins de semana, horário comercial e horário de folga. Todas as regiões de tempo configuradas referem-se ao horário UTC.

# Mapa de calor
<a name="visualization-heatmap"></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).

A visualização do painel Mapa de calor permite que você visualize histogramas ao longo do tempo. Para obter mais informações sobre histogramas, consulte [Introdução aos histogramas e mapas de calor](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).

## Opções de eixos
<a name="heatmap-axes-options"></a>

Use essas configurações para ajustar a forma como os eixos são exibidos na visualização.

### Eixo Y
<a name="heatmap-y-axis"></a>
+  **Unidade**: a unidade de exibição para o valor do eixo y
+  **Escala**: a escala a ser usada para o valor do eixo y
  +  **Linear**: escala linear 
  +  **log (base 2)**: escala logarítmica com base 2
  +  **log (base 10)**: escala logarítmica com base 10
  +  **log (base 32)**: escala logarítmica com base 32
  +  **log (base 1024)**: escala logarítmica com base 1024
+  **Y-Min**: o valor mínimo de y (o padrão é automático)
+  **Y-Max**: o valor máximo de y (o padrão é automático)
+  **Decimais**: número de decimais com os quais renderizar valores do eixo y (o padrão é automático)

### Buckets
<a name="heatmap-buckets"></a>

**nota**  
Se o formato dos dados for **Buckets de séries temporais**, esta seção não estará disponível.
+  **Buckets do eixo Y**: o número de buckets em que o eixo y será dividido.
+  **Tamanho**: o tamanho de cada bucket do eixo y (visível somente se **Escala** for *linear*). Essa opção tem prioridade sobre os **Buckets do eixo Y**.
+  **Fator de divisão**: (visível somente se **Escala** for *log [base 2]* ou maior). Por padrão, o Amazon Managed Grafana divide os valores de y por base de log. Com essa opção, você pode dividir cada bucket padrão em um número especificado de buckets.
+  **Buckets do eixo X**: o número de buckets em que o eixo x será dividido.
+  **Tamanho**: o tamanho de cada bucket do eixo x. Número ou intervalo de tempo (10s, 5m, 1h etc.). Intervalos compatíveis: ms, s, m, h, d, w, M, y. Essa opção tem prioridade sobre os **Buckets do eixo x**.

#### Limite do bucket
<a name="heatmap-bucket-bound"></a>

Quando o formato de dados é Buckets de séries temporais, a fonte de dados retorna séries com nomes representando o limite de buckets. Mas, dependendo da fonte de dados, um limite pode ser mais alto ou mais baixo. Você pode usar essa opção para ajustar um tipo de limite. Se **Automático** estiver definido, uma opção vinculada será escolhida com base no tipo de fonte de dados dos painéis.

#### Tamanho do bucket
<a name="heatmap-bucket-size"></a>

As opções de contagem e tamanho do bucket são usadas pelo Amazon Managed Grafana para calcular o tamanho de cada célula no mapa de calor. Você pode definir o tamanho do bucket por contagem (a primeira caixa de entrada) ou especificando um intervalo de tamanho. Para o eixo y, o intervalo de tamanho é apenas um valor. Para o bucket de x, você pode especificar um intervalo de tempo na entrada **Tamanho**. Por exemplo, você pode definir o intervalo de tempo como `1h`. Isso fará com que as células tenham 1h de largura no eixo x.

#### Formato de dados
<a name="heatmap-data-format"></a>

Escolha uma opção na lista **Formato**.
+ **Séries temporais**: o Amazon Managed Grafana faz o bucketing analisando todos os valores das séries temporais. Os tamanhos e intervalos dos buckets são definidos nas opções de **Buckets**.
+ **Buckets de séries temporais**: cada série temporal já representa um bucket do eixo y. O nome da série temporal (alias) deve ser um valor numérico representando o intervalo superior ou inferior do bucket. O espaço de trabalho do Grafana não tem bucketing, então as opções de tamanho do bucket estão ocultas.

## Opções de exibição
<a name="heatmap-display-options"></a>

Use essas configurações para refinar sua visualização.

### Cores
<a name="heatmap-colors"></a>

O espectro de cores controla o mapeamento entre a contagem de valores (em cada bucket) e a cor atribuída a cada bucket. A cor no lado esquerdo do espectro representa a contagem mínima, e a cor no lado direito representa a contagem máxima. Alguns esquemas de cores são automaticamente invertidos ao usar o tema claro.

Você também pode alterar o modo de cor para **Opacidade**. Nesse caso, a cor não mudará, mas o nível de opacidade mudará com a contagem de buckets.
+  **Mode** 
  +  **Opacidade**: valor do bucket representado pela opacidade da célula. Uma célula opaca significa o valor máximo.
    +  **Cor**: cor base da célula.
    +  **Escala**: escala para mapear os valores de buckets quanto à opacidade.
      +  **linear**: escala linear. O valor do bucket é mapeado linearmente quanto à opacidade.
      +  **sqrt**: escala de potência. A opacidade da célula é calculada como `value ^ k`, em que `k` é um valor configurado de **Expoente**. Se o expoente for menor que `1`, você obterá uma escala logarítmica. Se o expoente for maior que `1`, você obterá uma escala exponencial. No caso de `1`, a escala será igual à linear.
    +  **Expoente**: valor do expoente, maior que `0`.
  +  **Espectro**: valor do bucket representado pela cor da célula.
    +  **Esquema**: se o modo for **espectro**, selecione um esquema de cores.

### Escala de cores
<a name="heatmap-color-scale"></a>

Por padrão, o Amazon Managed Grafana calcula as cores das células com base nos valores mínimo e máximo dos buckets. Com **Mín.** e **Máx.**, você pode sobrescrever esses valores. Pense em um valor de bucket como um eixo z e Mín. e Máx. como Z-Min e Z-Max, respectivamente.
+  **Mín.**: valor mínimo usado para o cálculo da cor da célula. Se o valor do bucket for menor que Mín., ele será mapeado para a cor mínima. O padrão é `series min value`.
+  **Máx.**: valor máximo usado para o cálculo da cor da célula. Se o valor do bucket for maior que Máx., ele será mapeado para a cor máxima. O padrão é `series max value`. 

### Legenda
<a name="heatmap-legend"></a>

Escolha se deseja exibir a legenda do mapa de calor na visualização ou não. 

### Buckets
<a name="heatmap-legend-buckets"></a>
+  **Ocultar zero**: não desenhe células que tenham valores zero.
+  **Espaço**: defina o espaço entre as células em pixels. O padrão é 1 pixel.
+  **Arredondar**: defina o arredondamento da célula em pixels. O padrão é 0.

### Dica de ferramenta
<a name="heatmap-tooltip"></a>
+  **Mostrar dica de ferramenta**: mostra a dica de ferramenta do mapa de calor.
+  **Histograma**: mostra o histograma do eixo y na dica de ferramenta. O histograma representa a distribuição dos valores do bucket para o carimbo de data e hora específico.
+  **Decimais**: defina o número de decimais com os quais renderizar o valor do bucket (o padrão é automático).

# Painel de histograma
<a name="histogram-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).

A visualização do histograma calcula a distribuição de valores e os apresenta como um gráfico de barras. O eixo Y e a altura de cada barra representam a contagem de valores que correspondem a cada faixa, enquanto o eixo X representa a faixa de valores.

A visualização do histograma é compatível com séries temporais e qualquer resultado de tabela com um ou mais campos numéricos.

## Opções de exibição
<a name="histogram-options"></a>

Use estas opções para refinar as visualizações:

**Tamanho do bucket**

O tamanho dos buckets. Deixe vazio para o dimensionamento automático do bucket (\$1 10% da faixa total).

**Compensação do bucket**

Se o primeiro bucket não começar do zero. Um deslocamento diferente de zero muda a janela de agregação. Por exemplo, buckets de cinco tamanhos que são 0–5, 5–10, 10–15 com um deslocamento padrão de 0 se tornariam 2–7, 7–12, 12–17 com um deslocamento de 2; deslocamentos de 0, 5 ou 10, nesse caso, efetivamente não fariam nada. Normalmente, essa opção seria usada com um tamanho de bucket explicitamente definido, em vez de automático. Para que essa configuração seja afetada, o valor da compensação deve ser maior que 0 e menor que o tamanho do bucket; valores fora desse intervalo terão o mesmo efeito que valores dentro desse intervalo.

**Associar séries**

Isso mesclará todas as séries e campos em um histograma combinado.

**Largura da linha** controla a largura da linha das barras.

**Opacidade de preenchimento** controla a opacidade de preenchimento das barras.

**Modo gradiente** define o modo de preenchimento gradiente. O gradiente de preenchimento é baseado na cor da linha. Para alterar a cor, use a opção de campo padrão do esquema de cores. A aparência do gradiente é influenciada pela configuração de Opacidade de preenchimento.
+  **Nenhum**: sem preenchimento gradiente; esta é a configuração padrão.
+  **Opacidade**: a transparência do gradiente é calculada com base nos valores no eixo Y. A opacidade do preenchimento está aumentando com os valores no eixo Y.
+  **Matiz**: a cor do gradiente é gerada com base na matiz da cor da linha.

**Modo de dica de ferramenta** Quando você passa o cursor sobre o grafo, o Grafana pode exibir dicas de ferramentas. Escolha como as dicas de ferramentas se comportam:
+  **Única**: a dica de ferramenta ao passar o cursor mostra somente a série sobre a qual você está passando o mouse.
+  **Todas**: a dica de ferramenta ao passar o cursor mostra todas as séries na visualização. O Grafana destaca a série sobre a qual você está passando o mouse em negrito na lista de séries na dica de ferramenta.
+  **Oculto**: não exiba a dica de ferramenta. 

**nota**  
Use uma substituição para ocultar séries individuais da dica de ferramenta.

## Opções de legenda
<a name="histogram-legend"></a>

Quando a opção de legenda está habilitada, ela pode mostrar os mapeamentos de valores ou os colchetes de limites. Para mostrar os mapeamentos de valores na legenda, é importante que a opção Esquema de cores nas opções padrão esteja definida como Cor única ou Paleta clássica. Para ver os colchetes de limites na legenda, defina o Esquema de cores como Nos limites.

**Modo de legenda** Use estas configurações para refinar como a legenda aparecerá na visualização.
+  **Lista**: exibe a legenda como uma lista. Este é um modo de exibição padrão da legenda.
+  **Tabela**: exibe a legenda como uma tabela.
+  **Oculto**: oculta a legenda.

**Posicionamento da legenda** Escolha onde posicionar a legenda.
+  **Parte inferior**: abaixo do grafo.
+  **Direita**: à direita do grafo.

**Cálculos da legenda**

Escolha quais cálculos serão exibidos na legenda. Para obter mais informações, consulte [Lista de cálculos](list-of-calculations.md).

# Painel de logs
<a name="logs-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).

A visualização do painel de logs mostra linhas de logs de fontes de dados que são compatíveis com logs, como Elastic, Influx e Loki. Normalmente, você usaria esse painel ao lado de um painel de grafo para exibir a saída de logs de um processo relacionado.

O painel de logs mostra o resultado das consultas que foram inseridas na guia **Consulta**. Os resultados de várias consultas são mesclados e classificados por hora. Você pode rolar para dentro do painel se a fonte de dados retornar mais linhas do que as que podem ser exibidas.

Para limitar o número de linhas renderizadas, você pode usar a configuração **Máximo de pontos de dados** nas **Opções de consulta**. Se não estiver definido, a fonte de dados geralmente aplicará um limite padrão.

## Opções de exibição
<a name="logs-panel-display-options"></a>

Use as seguintes configurações para refinar a visualização:
+  **Hora**: mostre ou oculte a coluna da hora. Este é o carimbo de data e hora associado à linha de log, conforme relatado pela fonte de dados.
+  **Rótulos exclusivos**: mostre ou oculte a coluna de rótulos exclusivos, que mostra somente rótulos não comuns.
+  **Quebrar linhas**: alterne a quebra de linhas. 
+  **Ordem**: exibe os resultados em ordem de tempo decrescente ou ascendente. O padrão é **Decrescente**, mostrando primeiro os registros mais recentes. Defina como **Crescente** para mostrar primeiro as linhas de registro mais antigas.

# Painel de notícias
<a name="news-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).

Este painel exibe um feed RSS. Por padrão, ele exibe artigos do blog da Grafana Labs.

Na seção **Exibir**, no campo **URL**, insira o URL de um feed RSS. Este tipo de painel não aceita nenhuma outra consulta.

# Painel do grafo de nós (Beta)
<a name="node-graph-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).

O painel do grafo de nós visualiza redes ou grafos direcionados. Ele usa o layout de força direcionada para posicionar os nós de forma eficaz, de forma que possa ajudar na exibição diagramas de execução, hierarquias ou mapas de infraestrutura complexos.

## Requisitos de dados
<a name="node-graph-panel-requirements"></a>

O painel do grafo de nós requer uma forma específica dos dados para poder exibir os nós e bordas. Nem toda fonte de dados ou consulta pode ser visualizada nesse painel.

A visualização do grafo de nós consiste em *nós* e *bordas*.
+ Um *nó* é exibido como um círculo. Um nó pode representar uma aplicação, um serviço ou qualquer outra coisa que seja relevante sob a perspectiva da aplicação.
+ Uma *borda* é exibida como uma linha que conecta dois nós. A conexão pode ser uma solicitação, uma execução ou alguma outra relação entre os dois nós.

## Nodes
<a name="node-graph-panel-nodes"></a>

Normalmente, os nós mostram dois valores estatísticos dentro do nó e dois identificadores logo abaixo do nó, geralmente nome e tipo. Os nós também podem mostrar outro conjunto de valores como um círculo colorido ao redor do nó, com seções de cores diferentes representando valores diferentes que devem somar até um. Por exemplo, você pode ter a porcentagem de erros representada pela parte vermelha do círculo.

Detalhes adicionais podem ser exibidos em um menu de contexto, que é exibido quando você escolhe o nó. Também pode haver links adicionais no menu de contexto que podem ser direcionados para outras partes do espaço de trabalho do Grafana ou qualquer link externo.

## Edges (Bordas)
<a name="node-graph-panel-edges"></a>

As bordas também podem mostrar estatísticas ao passar o mouse sobre a borda. Semelhante aos nós, você pode abrir um menu de contexto com detalhes e links adicionais escolhendo a borda.

A primeira fonte de dados que suporta essa visualização é a fonte de AWS X-Ray dados de seu recurso de mapa de serviços. Para obter mais informações, consulte [Conecte-se a uma fonte AWS X-Ray de dados](x-ray-data-source.md).

Detalhes adicionais podem ser exibidos em um menu de contexto, que é exibido quando você escolhe o nó. Também pode haver links adicionais no menu de contexto que podem ser direcionados para outras partes do espaço de trabalho do Grafana ou qualquer link externo.

## Navegar pelo grafo de nós
<a name="node-graph-panel-navigation"></a>

Você pode fazer uma panorâmica no grafo do nós escolhendo fora de qualquer nó ou borda e arrastando o mouse.

Você pode aumentar o zoom usando os botões no canto superior esquerdo do grafo de nós.

# Painel de gráfico de pizza
<a name="pie-chart-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).

O gráfico de pizza exibe séries reduzidas, ou os valores em uma série, de uma ou mais consultas, conforme elas se relacionam entre si, como fatias de uma pizza. O comprimento do arco, a área e o ângulo central de uma fatia são todos proporcionais ao valor das fatias, pois se relacionam com a soma de todos os valores. Esse tipo de gráfico é melhor usado quando você deseja uma comparação rápida de um pequeno conjunto de valores em uma forma esteticamente agradável.

As visualizações de gráficos de pizza permitem aplicar as seguintes opções:
+  [Transformações](panel-transformations.md). 
+  [Opções de campo e substituições](field-options-overrides.md). 
+  [Limites](thresholds.md).

## Opções
<a name="pie-chart-panel-options"></a>

Você pode usar as opções a seguir para refinar a visualização.
+  **Mostrar**: escolha a quantidade de informações a serem mostradas. **Calcular**: reduz cada valor para um único valor por série. **Todos os valores**: exibe todos os valores de uma única série.
+  **Cálculo**: selecione um cálculo para reduzir cada série quando **Calcular** tiver sido selecionado. Para obter informações sobre os cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md).
+  **Limite**: ao exibir todos os valores de uma única série, isso limita o número de valores exibidos.
+  **Campos**: selecione quais campos serão exibidos na visualização.
  + **Campos numéricos**: todos os campos com valores numéricos.
  + **Todos os campos**: todos os campos que não são removidos por transformações.
  + **Hora**: todos os campos com valores de hora.

## Rótulos
<a name="pie-charts-panel-labels"></a>

Selecione os rótulos a serem exibidos no gráfico de pizza. Você pode selecionar mais de um.
+  **Nome**: o nome da série ou do campo. 
+  **Porcentagem**: a porcentagem do todo. 
+  **Valor**: o valor numérico bruto. 

Os rótulos são exibidos em branco sobre o corpo do gráfico. Talvez seja necessário selecionar cores mais escuras no gráfico para torná-los mais visíveis. Nomes ou números longos podem ser cortados.

## Valores e posicionamento da legenda
<a name="pie-charts-panel-legend"></a>

Escolha onde exibir a legenda.
+  **Parte inferior**: abaixo do gráfico.
+  **Direita**: à direita do gráfico. 

Você pode selecionar mais de um valor para exibir na legenda. **Porcentagem** é a porcentagem do todo e **Valor** é o valor numérico bruto.

# Painel Plotly
<a name="plotly-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).

O painel Plotly renderiza gráficos usando o [Plotly](https://plotly.com/javascript/), uma biblioteca gráfica javascript de código aberto.

Os campos **Dados**, **Layout** e **Configuração** correspondem aos parâmetros comuns descritos na [documentação do Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Eles devem estar no formato JSON.

Os dados fornecidos pela fonte de dados podem ser transformados por meio de um script definido pelo usuário antes de serem injetados no gráfico Plotly. O script inclui dois argumentos.
+ `data`: dados retornados pela fonte de dados.
+ `variables`: um objeto que contém [variáveis do Grafana](templates-and-variables.md) no dashboard atual (variáveis do usuário e estas poucas variáveis globais: `__from`, `__to`, `__interval` e `__interval_ms`).

O script deve retornar um objeto com uma ou mais das seguintes propriedades: `data`, `layout`, `config` e `frames`. Veja um exemplo do a seguir:

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

O objeto retornado pelo script e pelo JSON fornecidos nos campos *Dados*, *Layout* e *Configuração* será mesclado (mesclagem profunda).

Se nenhum script for fornecido, o painel usará somente os campos *Dados*, *Layout* e *Configuração*.

# Painel Sankey
<a name="sankey-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).

O painel Sankey mostra diagramas de Sankey, que são bons para visualizar dados de fluxo, com a largura do fluxo sendo proporcional à métrica selecionada. A imagem a seguir mostra um diagrama de Sankey com dois grupos de origem e destinos.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/images/sankey-panel.png)


**Como funciona**

O painel Sankey requer pelo menos duas colunas de dados, uma fonte e um destino para os fluxos. Sua consulta deve agrupar os dados em pelo menos dois grupos. O painel desenhará links da primeira coluna de pontos de dados até a última na ordem da consulta. A espessura dos links será proporcional ao valor atribuído pela métrica na consulta.

**Personalizar**
+ **Links**: atualmente, há duas opções de cor do link: múltipla ou única. Por padrão, é multicolorido. Para escolher uma única cor para os links, alterne para a opção **Somente link de cor única** e escolha a cor no seletor de cores do Grafana.
+ **Nós**: você pode alterar a cor dos nós retangulares alterando a opção de **Cor dos nós**.
+ **Largura do nó**: a largura dos nós pode ser ajustada com o controle deslizante **Largura do nó** ou inserindo um número na caixa de entrada. Esse número deve ser um número inteiro.
+ **Preenchimento de nós**: o preenchimento vertical entre os nós pode ser ajustado com o controle deslizante **Preenchimento de nós** ou inserindo um número na caixa de entrada. Esse número deve ser um número inteiro. Se os links estiverem muito finos, tente ajustar esse número
+ **Cabeçalhos**: os cabeçalhos das colunas podem ser alterados usando a substituição **Nome de exibição** no painel do editor. Eles serão da mesma cor que você escolher para a **Cor do texto**
+ **Layout de Sankey**: o layout dos links de Sankey pode ser ligeiramente ajustado usando o controle deslizante **Iteração do layout**. Esse número deve ser um número inteiro e é o número de iterações de relaxamento usadas para gerar o layout.

# Painel de dispersão
<a name="scatter-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).

O painel de dispersão mostra um gráfico de X/Y dispersão para dados da tabela com uma interface mais simples do que outros painéis gráficos. Ao contrário do painel de grafo, o painel de dispersão não exige que os dados estejam em uma série temporal. O painel de dispersão requer um conjunto de dados formatado em uma tabela com duas ou mais colunas numéricas de dados.

Um deles pode ser atribuído ao eixo X. Um ou mais podem ser atribuídos a uma série de valores do eixo Y, e os dados resultantes podem ser plotados como uma série de pontos. Opcionalmente, cada série também pode mostrar uma linha de regressão usando a estatística mais adequada.

**Criar um painel de dispersão**

O procedimento a seguir descreve como criar um gráfico de dispersão usando o painel de dispersão. Neste exemplo, assumiremos que há dados, como na tabela a seguir denominada `HEIGHT`, com três colunas de valores numéricos, `Age`, `Boys` e `Girls`, mostrando a altura média de meninos e meninas por idade.


| Idade | Altura de meninos | Altura de meninas | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121.1  |  120,8  | 
|  8  |  126,3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136,2  |  137.1  | 
|  11  |  141.2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152,6  | 
|  14  |  159,9  |  155.1  | 
|  15  |  164,4  |  156,7  | 
|  16  |  167,3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Para criar o gráfico de dispersão com o painel de dispersão**

1. No dashboard do Grafana, escolha **Adicionar painel**. Para obter mais detalhes sobre como adicionar painéis, consulte [Adicionar um painel](add-a-panel-to-a-dashboard.md).

1. Para a consulta, escreva uma consulta que retornará os dados necessários. Nesse caso, você usaria uma consulta como `SELECT * FROM HEIGHT`.

1. Selecione a visualização **Dispersão**.

Isso criará um gráfico de dispersão, usando a primeira coluna como o eixo X e as outras colunas numéricas como eixos Y.

**Opções de configuração**

O painel de dispersão fornece as quatro opções de configuração personalizada a seguir.
+ **Eixo X**: você pode escolher qual campo usar como eixo X, bem como extensões e título e exibir informações do eixo.
+ **Eixo Y**: você pode escolher quais campos exibir no eixo Y, incluindo opções de exibição para cada campo e extensões e informações de título para o eixo. Você também pode optar por exibir uma linha de regressão para cada campo. Consulte as informações a seguir para obter mais detalhes sobre a configuração da linha de regressão.
+ **Legenda**: você pode ativar ou desativar uma legenda para o painel, bem como escolher o tamanho do texto na legenda.
+ **Exibição**: você pode definir outras opções para o gráfico, incluindo a cor da grade e o estilo da borda.

**Configuração da linha de regressão**

Cada conjunto de dados do eixo Y pode exibir uma linha, além dos pontos individuais. Há cinco opções para o tipo de linha.
+ **Nenhuma**: não exibe uma linha de regressão.
+ **Simples**: exibe uma linha de regressão que conecta os pontos do conjunto de dados.
+ **Linear**: exibe uma linha reta, usando o método mais adequado de mínimos quadrados.
+ **Exponencial**: exibe a linha de regressão exponencial mais adequada.
+ **Potência**: exibe a linha de regressão de potência mais adequada.

# Painel de estatísticas
<a name="stat-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).

O painel de estatísticas mostra um valor estatístico grande com um sparkline de grafo opcional. Você pode controlar a cor de fundo ou do valor usando limites.

Por padrão, o painel de estatísticas mostra uma das seguintes exibições:
+ Somente o valor de uma única série ou campo.
+ Tanto o valor quanto o nome de várias séries ou campos.

Você pode usar a opção **Modo de texto** para controlar se o texto é exibido ou não.

## Opções de dados e campos
<a name="stat-panel-data-and-field-options"></a>

As visualizações de estatísticas permitem aplicar as seguintes opções:
+  [Transformações](panel-transformations.md).
+  [Opções de campo e substituições](field-options-overrides.md).
+  [Limites](thresholds.md).

## Ajuste automático do layout
<a name="stat-panel-automatic-layout-adjustment"></a>

O painel ajusta automaticamente o layout dependendo da largura e altura disponíveis no dashboard. Ele ocultará automaticamente o grafo (sparkline) se o painel ficar muito pequeno.

## Opções de exibição
<a name="stat-panel-display-options"></a>

Use as seguintes opções para refinar a visualização:
+  **Mostrar**: escolha como o Amazon Managed Grafana exibirá os dados.
  +  **Calcular**: mostra um valor calculado com base em todas as linhas.
    +  **Cálculo**: selecione um cálculo a ser aplicado. Para obter informações sobre os cálculos disponíveis, consulte [Lista de cálculos](list-of-calculations.md).
  +  **Todos os valores**: mostra uma estatística separada para cada linha.
    +  **Limite**: especifique o número máximo de linhas a serem exibidas.
+  **Campos**: selecione um nome de campo ou um tipo de campo (incluindo **Todos os campos** ou **Campos numéricos**) para incluir nesse painel.
+  **Valor**: selecione uma função de redução que o Amazon Managed Grafana usará para reduzir vários campos a um único valor. Escolha a lista **Valor** para ver as funções e breves descrições. 
+  **Orientação**: escolha uma direção de empilhamento.
  +  **Automático**: o Amazon Managed Grafana seleciona o que considera ser a melhor orientação.
  +  **Horizontal**: as barras se estendem horizontalmente, da esquerda para a direita.
  +  **Vertical**: as barras se estendem verticalmente, de cima para baixo.
+  **Modo de texto**: você pode usar a opção **Modo de texto** para controlar qual texto o painel exibe. Se somente o nome e a cor forem importantes, e o valor não, altere o **Modo de texto** para **Nome**. O valor ainda é usado para determinar a cor e é exibido em uma dica de ferramenta.
  +  **Automático**: se os dados contiverem várias séries ou campos, mostre o nome e o valor.
  +  **Valor**: mostra somente o valor, nunca o nome. O nome é exibido na dica de ferramenta.
  +  **Valor e nome**: sempre mostra o valor e o nome.
  +  **Nome**: mostra o nome em vez do valor. O valor é exibido na dica de ferramenta.
  +  **Nenhum**: não mostra nada (vazio). O nome e o valor são exibidos na dica de ferramenta.
+  **Modo de cor**: escolha um modo de cor.
  +  **Valor**: aplica cores somente ao valor e à área do grafo.
  +  **Plano de fundo**: aplica cores ao fundo também.
+  **Modo de grafo**: escolha um modo de grafo.
  +  **Nenhum**: oculta o grafo e mostra somente o valor.
  +  **Área**: mostra o grafo da área abaixo do valor. Essa opção exige que a consulta retorne uma coluna de tempo.
+  **Modo de alinhamento**: escolha um modo de alinhamento.
  +  **Automático**: se somente um único valor for mostrado (sem repetição), o valor será centralizado. Se várias séries ou linhas forem mostradas, o valor será alinhado à esquerda.
  +  **Centro**: o valor estatístico é centralizado.

# Painel da linha do tempo do estado
<a name="state-timeline-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).

A visualização do painel da linha do tempo do estado mostra as mudanças específicas de estado ao longo do tempo. Cada campo ou série é renderizado como sua faixa horizontal exclusiva. As regiões de estado podem ser renderizadas com ou sem valores. Esse painel funciona bem com estados de string ou booleanos, mas também pode ser usado com séries temporais. Quando usado com séries temporais, os limites são usados para transformar os valores numéricos em regiões específicas de estado.

## Opções da linha do tempo de estado
<a name="state-timeline-options"></a>

Use estas opções para refinar as visualizações:

**Mesclar valores consecutivos iguais**

Controla se o Grafana mesclará valores idênticos se eles estiverem próximos uns dos outros.

**Mostrar valores**

Controla se os valores serão renderizados dentro das regiões de estado. Automático renderizará valores se houver espaço suficiente.

**Alinhar valores**

Controla o alinhamento de valores nas regiões de estado.

**Altura da linha**

Controla o espaço entre as linhas. 1 = sem espaço = 0,5 = 50% de espaço.

**Largura da linha**

Controla a largura da linha das regiões de estado.

**Opacidade de preenchimento**

Controla a opacidade das regiões de estado.

## Mapeamentos de valores
<a name="state-timeline-valuemap"></a>

Para atribuir cores a valores booleanos ou de string, use [Mapeamento de valores](field-options-overrides.md#value-mapping).

## Dados de séries temporais com limites
<a name="state-timeline-threshold"></a>

O painel também pode ser usado com dados de séries temporais. Nesse caso, os limites são usados para transformar as séries temporais em regiões estaduais de cores distintas.

## Opções de legenda
<a name="state-timeline-legend"></a>

Quando a opção de legenda está habilitada, ela pode mostrar os mapeamentos de valores ou os colchetes de limites. Para mostrar os mapeamentos de valores na legenda, é importante que a opção Esquema de cores em Opções padrão esteja definida como Cor única ou Paleta clássica. Para ver os colchetes de limites na legenda, defina o Esquema de cores como Nos limites.

**Modo de legenda** Use estas configurações para refinar como a legenda aparecerá na visualização.
+  **Lista**: exibe a legenda como uma lista. Este é um modo de exibição padrão da legenda.
+  **Tabela**: exibe a legenda como uma tabela.
+  **Oculto**: oculta a legenda.

**Posicionamento da legenda** Escolha onde posicionar a legenda.
+  **Parte inferior**: abaixo do grafo.
+  **Direita**: à direita do grafo.

# Painel de histórico de status
<a name="status-history-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).

A visualização do histórico de status mostra estados periódicos ao longo do tempo. Cada campo ou série é renderizado como uma linha horizontal. As caixas são renderizadas e centralizadas em torno de cada valor.

A visualização do histórico de status funciona com campos de strings, booleanos, numéricos ou séries temporais. O campo da hora é obrigatório. Você pode usar mapeamentos de valores para aplicar cor nas strings ou atribuir valores de texto a intervalos numéricos.

## Opções de exibição
<a name="status-timeline-options"></a>

Use estas opções para refinar as visualizações:

**Mostrar valores**

Controla se os valores são renderizados dentro das caixas de valor. Automático renderizará valores se houver espaço suficiente.

**Largura da coluna** controla a largura das caixas. 1 = máx. e 0 = largura mínima.

**Largura da linha** controla a largura da linha das regiões de estados.

**Opacidade de preenchimento** controla a opacidade de preenchimento das regiões de estados.

## Mapeamentos de valores
<a name="status-history-valuemap"></a>

Para atribuir cores a valores booleanos ou de string, use [Mapeamento de valores](field-options-overrides.md#value-mapping).

## Dados de séries temporais com limites
<a name="status-history-threshold"></a>

O painel também pode ser usado com dados de séries temporais. Nesse caso, os limites são usados para aplicar cor nas caixas. Você também pode usar esquemas de cores de gradiente para aplicar cor nos valores.

## Opções de legenda
<a name="status-history-legend"></a>

Quando a opção de legenda está habilitada, ela pode mostrar os mapeamentos de valores ou os colchetes de limites. Para mostrar os mapeamentos de valores na legenda, é importante que a opção Esquema de cores nas opções Padrão esteja definida como Cor única ou Paleta clássica. Para ver os colchetes de limite na legenda, defina o esquema de cores como Nos limites.

**Modo de legenda** Use estas configurações para refinar como a legenda aparecerá na visualização.
+  **Lista**: exibe a legenda como uma lista. Este é um modo de exibição padrão da legenda.
+  **Tabela**: exibe a legenda como uma tabela.
+  **Oculto**: oculta a legenda.

**Posicionamento da legenda** Escolha onde posicionar a legenda.
+  **Parte inferior**: abaixo do grafo.
+  **Direita**: à direita do grafo.

# Painel de tabela
<a name="table-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).

O painel de tabela é compatível com vários modos para séries temporais e tabelas, anotações e dados JSON brutos. Esse painel também fornece opções de formatação de data, formatação de valores e cores.

## Opções de dados e campos
<a name="data-and-field-options"></a>

Com as visualizações de tabelas, você pode aplicar as seguintes opções:
+  [Transformações](panel-transformations.md).
+  [Opções de campo e substituições](field-options-overrides.md).
+  [Limites](thresholds.md).

## Opções de exibição
<a name="display-options"></a>
+  **Mostrar cabeçalho**: mostra ou oculta os nomes das colunas importados da fonte de dados.
+  **Classificar em ordem crescente ou decrescente**: escolha um título de coluna para alterar a ordem de classificação do padrão para decrescente ou crescente. Cada vez que você escolhe, a ordem de classificação muda para a próxima opção no ciclo. É possível classificar apenas por uma coluna de cada vez.
+  [Opções de campo de tabelas](#table-field-options): altera as opções de campo, como largura da coluna, alinhamento e modo de exibição da célula.
+  [Filtrar colunas da tabela](#filter-table-columns): altera temporariamente a forma como os dados da coluna são exibidos. Por exemplo, você pode ordenar valores do maior para o menor ou ocultar valores específicos.

## Compatibilidade com anotações
<a name="annotation-support"></a>

Atualmente, as anotações não são compatíveis com o novo painel de tabelas.

## Opções de campo de tabelas
<a name="table-field-options"></a>

Esta seção explica todas as opções de campos de tabela disponíveis. As opções são listadas na mesma ordem como no Amazon Managed Grafana. As opções listadas neste tópico se aplicam somente às visualizações do painel de tabela.

A maioria das opções de campos não afetará a visualização até que você escolha fora da caixa de opções de campo que você está editando ou pressione Enter.

Para obter mais informações sobre como aplicar essas opções, consulte [Configurar todos os campos](field-options-overrides.md#configure-all-fields) e [Configurar campos específicos](field-options-overrides.md#configure-specific-fields).

### Alinhamento de colunas
<a name="column-alignment"></a>

Escolha como o Amazon Managed Grafana deve alinhar o conteúdo das células:
+ Auto (padrão)
+ Esquerdo
+ Center
+ Direita

### Largura da coluna
<a name="column-width"></a>

Por padrão, o Amazon Managed Grafana calcula automaticamente a largura da coluna com base no conteúdo da célula. Nessa opção de campo, você pode substituir a configuração e definir a largura de todas as colunas em pixels.

Por exemplo, se você inserir `100` no campo, todas as colunas serão definidas com 100 pixels de largura quando você escolher fora do campo.

### Modo de exibição das células
<a name="cell-display-mode"></a>

Por padrão, o Amazon Managed Grafana escolhe automaticamente as configurações de exibição. Para substituir as configurações, escolha uma das opções a seguir para alterar todos os campos.

**nota**  
Se você defini-los na guia **Campo**, os modos de exibição se aplicarão a todos os campos, incluindo o campo de hora. Muitas opções funcionarão melhor se você defini-las na guia **Substituir**.

#### Cor do texto
<a name="color-text"></a>

Se os limites forem definidos, o texto do campo será exibido na cor de limite apropriada.

#### Cor de fundo
<a name="color-background"></a>

Se os limites forem definidos, o plano de fundo do campo será exibido na cor de limite apropriada.

#### Medidor de gradiente
<a name="gradient-gauge"></a>

Os níveis de limite definem um gradiente.

#### Medidor do LCD
<a name="lcd-gauge"></a>

O medidor é dividido em pequenas células que estão acesas ou apagadas.

#### Visualização JSON
<a name="json-view"></a>

O valor é mostrado formatado como código. Se um valor for um objeto, a visualização JSON que permite que você navegue pelo objeto JSON aparecerá quando você pausar no valor.

### Filtro de colunas
<a name="column-filter"></a>

## Filtrar colunas da tabela
<a name="filter-table-columns"></a>

Se você ativar o **Filtro de colunas** nas opções da tabela, poderá filtrar as opções da tabela. Para obter mais informações, consulte [Opções de campo de tabelas](#table-field-options).

### Ativar a filtragem de colunas
<a name="turn-on-column-filtering"></a>

1. No Amazon Managed Grafana, escolha o dashboard que mostra a tabela com as colunas que você deseja filtrar.

1. No painel da tabela que você deseja filtrar, [Abrir o editor do painéis](AMG-panel-editor.md#open-the-panel-editor).

1. Escolha a guia **Campo**.

1. Nas opções de **Tabela**, ative a opção **Filtro de colunas**.

Um ícone de filtro aparece ao lado do título de cada coluna.

### Filtrar valores de colunas
<a name="filter-column-values"></a>

Para filtrar os valores das colunas, escolha o ícone de filtro (funil) ao lado do título da coluna. O espaço de trabalho do Grafana exibe as opções de filtro para essa coluna.

Marque as caixas de seleção ao lado dos valores que você deseja exibir. Insira o texto no campo de pesquisa na parte superior para mostrar esses valores na tela para que possa selecioná-los em vez de rolar para encontrá-los.

### Limpar filtros de coluna
<a name="clear-column-filters"></a>

As colunas com filtros aplicados têm um funil azul exibido ao lado do título.

Para remover o filtro, escolha o ícone azul de funil e, em seguida, escolha **Limpar filtro**.

# Painel de texto
<a name="text-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).

Você pode usar o painel de texto para criar painéis de informações e descrições para seus dashboards.

Em **Modo**, selecione se você deseja usar markdown ou HTML para estilizar o texto e, em seguida, insira o conteúdo na caixa abaixo. O espaço de trabalho do Grafana inclui um título e um parágrafo para ajudar você a começar, ou você pode colar conteúdo de outro editor.

# Painel de séries temporais
<a name="time-series-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).

O painel de séries temporais pode renderizar uma série temporal como uma linha, um caminho de pontos ou uma série de barras. Esse tipo de grafo é versátil o suficiente para exibir quase todos os dados de séries temporais.

**nota**  
Você pode migrar visualizações do painel de Grafo para visualizações de Séries temporais. Para migrar, na guia **Painel**, escolha **Visualização de séries temporais**. O Grafana transfere todas as configurações aplicáveis.

As visualizações de séries temporais permitem aplicar as seguintes opções:
+  [Transformações](panel-transformations.md) 
+  [Opções de campo e substituições](field-options-overrides.md) 
+  [Limites](thresholds.md) 

Você também pode usar as opções de campo para criar diferentes tipos de grafos ou ajustar os eixos.

Use essas configurações para refinar sua visualização.

## Modo de dica de ferramenta
<a name="time-series-panel-tooltip"></a>

Quando você passa o cursor sobre o grafo, o Grafana pode exibir dicas de ferramentas. Escolha como as dicas de ferramentas se comportam:
+  **Única**: a dica de ferramenta ao passar o cursor mostra somente a série sobre a qual você está passando o mouse.
+  **Todas**: a dica de ferramenta ao passar o cursor mostra todas as séries no grafo. O Grafana destaca a série sobre a qual você está passando o mouse em negrito na lista de séries na dica de ferramenta.
+  **Oculto**: não exiba a dica de ferramenta. 

## Modo de legenda e posicionamento
<a name="time-series-panel-legend"></a>

Escolha como a legenda aparece.
+  **Lista**: exibe a legenda como uma lista. Esse é o padrão.
+  **Tabela**: exibe a legenda como uma tabela. 
+  **Oculto**: oculta a legenda.

Escolha onde exibir a legenda.
+  **Parte inferior**: abaixo do grafo.
+  **Direita**: à direita do grafo. 

## Cálculos da legenda
<a name="time-series-panel-legend-calculations"></a>

Escolha quais cálculos serão exibidos na legenda. Para obter mais informações, consulte [Lista de cálculos](list-of-calculations.md).

# Grafo de séries temporais como linhas
<a name="time-series-graph-lines"></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).

Esta seção explica como usar as opções do campo Séries temporais para visualizar dados de séries temporais como linhas e ilustra o que as opções fazem.

**Criar o painel**

1. Crie um painel selecionando a visualização **Séries temporais**. Para obter mais informações, consulte [Adicionar um painel](add-a-panel-to-a-dashboard.md).

1. No **Editor de painel**, escolha **Campo**.

1. Em **Estilo**, escolha **Linhas**.

## Estilizar as linhas
<a name="time-series-graph-lines-style"></a>

Há uma variedade de opções para estilizar as linhas.
+ **Interpolação de linhas**: escolha como o Grafana interpola a linha da série. As opções são **Linear**, **Uniforme**, **Etapa anterior** e **Etapa posterior**.
+ **Largura da linha**: defina a espessura da linha entre 0 e 10 pixels.
+ **Opacidade de preenchimento**: defina a opacidade do preenchimento da série, de 0 a 100%.
+ **Modo gradiente**: defina o modo de preenchimento gradiente. O gradiente de preenchimento é baseado na cor da linha. Para alterar a cor, use a opção de campo padrão do esquema de cores.

  A aparência do gradiente é influenciada pela configuração de **Opacidade de preenchimento**.

  As opções para preenchimento gradiente são **Nenhum**, **Opacidade** e **Matiz**. Com a **Opacidade**, a transparência do gradiente é calculada com base nos valores no eixo y. A opacidade do preenchimento está aumentando com os valores no eixo Y. Com a **Matiz**, a cor do gradiente é gerada com base na matiz da cor da linha.
+ **Estilo da linha**: defina o estilo da linha. Para alterar a cor, use a opção de campo padrão do esquema de cores.

  A aparência do estilo de linha é influenciada pelas configurações de **Largura da linha** e **Opacidade de preenchimento**.

  As opções de estilo de linha são **Sólida**, **Tracejada** e **Pontilhada**.
+ **Valores nulos**: escolha como as lacunas nos dados são exibidas. Valores nulos podem ser conectados para formar uma linha contínua ou, opcionalmente, definir um limite acima do qual as lacunas nos dados não devem mais ser conectadas. Você pode escolher **Nunca** conectar pontos de dados com lacunas, **Sempre** conectar pontos de dados com lacunas ou definir um **Limite** no qual as lacunas nos dados não devem mais ser conectadas.
+ **Mostrar pontos**: escolha quando os pontos devem ser mostrados no grafo. As opções são **Automático**, **Sempre** e **Nunca**.

## Preencher abaixo até
<a name="time-series-panel-legend-fillbelow"></a>

Esta opção só está disponível na guia de substituições.

**Para preencher a área entre duas séries**

1. Selecione os campos a serem preenchidos abaixo.

1. Em **Adicionar propriedade de substituição**, escolha **Preencher abaixo até**.

1. Selecione a série em que você deseja que o preenchimento pare.

# Grafo de séries temporais como barras
<a name="time-series-graph-bars"></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).

Esta seção explica como usar as opções de campo de séries temporais para visualizar dados de séries temporais como barras e ilustra o que as opções fazem.

**Criar o painel**

1. Crie um painel selecionando a visualização **Séries temporais**. Para obter mais informações, consulte [Adicionar um painel](add-a-panel-to-a-dashboard.md).

1. No **Editor de painel**, escolha **Campo**.

1. Em **Estilo**, escolha **Barras**.

## Estilizar as barras
<a name="time-series-graph-bars-style"></a>

Há uma variedade de opções para estilizar as barras.
+ **Alinhamento da barra**: defina a posição da barra em relação a um ponto de dados. As opções são **Antes**, **Centro** e **Depois**.
+ **Largura da linha**: defina a espessura dos contornos da barra entre 0 e 10 pixels.
+ **Opacidade de preenchimento**: defina a opacidade do preenchimento das barras, de 0 a 100%.
+ **Modo gradiente**: defina o modo de preenchimento gradiente. O gradiente de preenchimento é baseado na cor da linha. Para alterar a cor, use a opção de campo padrão do esquema de cores.

  A aparência do gradiente é influenciada pela configuração de **Opacidade de preenchimento**.

  As opções para preenchimento gradiente são **Nenhum**, **Opacidade** e **Matiz**. Com a **Opacidade**, a transparência do gradiente é calculada com base nos valores no eixo y. A opacidade do preenchimento está aumentando com os valores no eixo Y. Com a **Matiz**, a cor do gradiente é gerada com base na matiz da cor da linha.
+ **Mostrar pontos**: escolha quando os pontos devem ser mostrados no grafo. As opções são **Automático**, **Sempre** e **Nunca**.

# Grafo de séries temporais como pontos
<a name="time-series-graph-points"></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).

Esta seção explica como usar as opções de campo Séries temporais para visualizar dados de séries temporais como pontos e ilustra o que as opções fazem.

**Criar o painel**

1. Crie um painel selecionando a visualização **Séries temporais**. Para obter mais informações, consulte [Adicionar um painel](add-a-panel-to-a-dashboard.md).

1. No **Editor de painel**, escolha **Campo**.

1. Em **Estilo**, escolha **Pontos**.

## Estilizar os pontos
<a name="time-series-graph-points-style"></a>

Ao representar graficamente como pontos, você pode escolher o tamanho do ponto.
+ **Tamanho do ponto**: escolha o tamanho do ponto, entre 1 e 40 pixels de diâmetro.

# Mudar a exibição do eixo
<a name="time-series-change-axis"></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).

Esta seção explica como usar as opções de campo de séries temporais para controlar a exibição de eixos na visualização e ilustra o que as opções de eixo fazem.

Há uma variedade de opções para os eixos.
+ **Posicionamento do eixo Y**: defina o posicionamento do eixo y. As opções são **Esquerda**, **Direita** e **Oculta**.
+ **Rótulo do eixo Y**: defina um rótulo de texto para o eixo y. Caso tenha mais de um eixo y, você poderá usar a guia **Substituir** para atribuir rótulos diferentes a eles.
+ **Largura**: defina a largura fixa do eixo. Por padrão, a área de trabalho do Grafana calcula dinamicamente a largura do eixo. Ao definir a largura do eixo, os dados cujos tipos de eixos são diferentes podem compartilhar as mesmas proporções de exibição. Isso facilita a comparação de dados de mais de um grafo porque os eixos não são deslocados ou estendidos dentro da proximidade visual um do outro.
+ **Mín. e máx. flexíveis**: defina um **Mín. flexível** ou **Máx. flexível** para melhor controle dos limites do eixo Y. Por padrão, o espaço de trabalho do Grafana define o intervalo do eixo y automaticamente com base nos dados.

  As configurações de **Mín. flexível** ou **Máx. flexível** podem evitar que os blips se transformem em montanhas quando os dados estão praticamente nivelados, e as opções de mínimo e máximo rígidos derivados das opções do campo mínimo e máximo padrão podem evitar que picos intermitentes nivelem detalhes úteis ao cortar os picos além de um ponto definido.
+ **Escala**: defina a escala a ser usada para valores do eixo y. As opções são **Linear** e **Logarítmico**.

# Grafo de séries temporais empilhadas
<a name="time-series-stacked"></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).

Esta seção explica como usar as opções de campo do painel Séries temporais para controlar o empilhamento das séries e ilustra o que as opções de empilhamento fazem. O empilhamento permite que o Grafana exiba séries umas sobre as outras. Tenha cuidado ao usar o empilhamento na visualização, pois isso pode facilmente criar grafos enganosos. Você pode ler mais sobre por que o empilhamento pode não ser a melhor abordagem aqui: [The Issue with Stacking](https://www.data-to-viz.com/caveat/stacking.html).

# Empilhar séries em grupos
<a name="time-series-stacked-groups"></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).

A opção de grupo de empilhamento só está disponível como uma substituição.

**Para empilhar séries no mesmo grupo**

1. Na seção Substituições, crie uma substituição de campo para a opção **Empilhar séries**.

1. Escolha o modo de empilhamento **Normal**.

1. Nomeie o grupo de empilhamento no qual você deseja que a série apareça. A opção de nome do grupo de empilhamento só estará disponível ao criar uma substituição.

# Limites
<a name="thresholds"></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 limites definem a cor do texto do valor ou de fundo, dependendo das condições que você definir.

Você pode definir limites de duas maneiras:
+ Os limites **absolutos** são definidos com base em um número. Por exemplo, 80 em uma escala de 1 a 150.
+ Os limites **percentuais** são definidos em relação ao mínimo ou máximo. Por exemplo, 80%.

Você pode aplicar limites às seguintes visualizações:
+ [Painel de medidor em barras](alert-panel-bar-gauge-panel.md) 
+  [Painel do medidor](gauge-panel.md) 
+  [Painel de grafo](graph-panel.md)
+  [Painel de estatísticas](stat-panel.md)
+  [Painel de tabela](table-panel.md)

## Limites padrão
<a name="default-thresholds"></a>

Nas visualizações que são compatíveis, o Amazon Managed Grafana define o seguinte valor limite padrão: 80 = vermelho; Base = verde; Modo = absoluto.

O valor **Base** representa menos o infinito. Geralmente é a cor *boa*.

## Adicionar um limite
<a name="add-a-threshold"></a>

Você pode adicionar ao painel quantos limites desejar. O espaço de trabalho do Grafana classifica automaticamente os limites do valor mais alto para o mais baixo.

**nota**  
Essas instruções se aplicam somente às visualizações de estatísticas, medidores, medidores em barras e tabelas.

1. Escolha o painel ao qual você deseja adicionar um limite.

1. Escolha a guia **Campo**.

1. Escolha **Adicionar limite**.

   O Amazon Managed Grafana adiciona um limite com valores numéricos e de cor sugeridos. 

1. Aceite as recomendações ou edite o novo limite.
   +  **Editar cor**: escolha o ponto de cor que você deseja alterar e, em seguida, selecione uma nova cor.
   +  **Editar número**: escolha o número que você deseja alterar e, em seguida, insira um novo número.
   +  **Modo de limites**: escolha o modo para alterá-lo para todos os limites no painel.

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

## Adicionar um limite a um painel de grafo
<a name="add-a-threshold-to-a-graph-panel"></a>

Na visualização do painel de grafo, você pode usar limites para adicionar linhas ou seções arbitrárias ao grafo para facilitar a visualização de quando o grafo ultrapassa um determinado limite.

1. Escolha o painel de grafo ao qual você deseja adicionar um limite.

1. Na guia **Painel**, escolha **Limites**.

1. Escolha **Adicionar limite**.

1. Preencha quantos campos você quiser. Somente os campos **T1** são obrigatórios.
   +  **T1**: ambos os valores são necessários para exibir um limite.
     +  **lt** ou **gt**: selecione **lt** para menor que ou **gt** para maior que para indicar a que o limite se aplica.
     +  **Valor**: insira um valor limite. O espaço de trabalho do Grafana desenha uma linha limite ao longo do eixo y nesse valor.
   +  **Cor**: escolha uma condição que corresponda a uma cor, ou defina sua própria cor.
     +  **personalizado**: você define a cor de preenchimento e a cor da linha.
     +  **crítico**: a cor do preenchimento e da linha é vermelha.
     +  **aviso**: a cor do preenchimento e da linha é amarela.
     +  **ok**: a cor do preenchimento e da linha é verde.
   +  **Preenchimento**: escolha se o preenchimento do limite será exibido.
   +  **Linha**: escolha se a linha limite será exibida.
   +  **Eixo Y**: escolha **esquerda** ou **direita**.

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

## Excluir um limite
<a name="delete-a-threshold"></a>

1. Escolha o painel do qual você deseja remover um limite.

1. Escolha a guia **Campo**. (Ou, para um painel de grafo, escolha a guia **Painel**.)

1. Selecione o ícone de lixeira próximo do limite que você deseja remover. 

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

# WindRose
<a name="windrose"></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 WindRose painel recebe dados brutos de séries temporais, converte os dados e os mapeia em um WindRose gráfico.

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/images/windrose.png)


## Opções
<a name="windrose-options"></a>

O WindRose painel suporta as seguintes opções:
+ Frequência de eixos
+ Estilo de eixo (graus ou bússola)
+ Escala (linear, quadrada, logarítmica)

# Inspecionar um painel
<a name="inspect-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).

O inspetor do painel ajuda você a entender e solucionar problemas nos painéis. Você pode inspecionar os dados brutos de qualquer painel do espaço de trabalho do Grafana, exportar esses dados para um arquivo de valores separados por vírgula (CSV), visualizar solicitações de consulta e exportar painéis e dados JSON. 

## Interface de usuário do inspetor do painel
<a name="panel-inspector-ui"></a>

O inspetor do painel exibe **Inspecionar: < NameOfPanelBeingInspected >** na parte superior do painel. Escolha a seta no canto superior direito para expandir ou reduzir o painel.

O inspetor do painel consiste em quatro guias:
+  **Guia Dados**: mostra os dados brutos retornados pela consulta com as transformações aplicadas. As opções de campo, como substituições e mapeamentos de valores, não são aplicadas por padrão.
+  **Aba Estatísticas**: mostra quanto tempo a consulta leva e o quanto ela retorna.
+  **Aba JSON**: permite que você visualize e copie o painel JSON, dados do painel JSON e a estrutura de quadros de dados JSON. Isso será útil se você estiver provisionando ou administrando o Amazon Managed Grafana.
+  **Guia Consulta**: mostra as solicitações enviadas ao servidor quando o Amazon Managed Grafana consulta a fonte de dados.

**nota**  
Nem todos os tipos de painel incluem todas as quatro guias. Por exemplo, os painéis da lista de dashboards não têm dados brutos para inspecionar e, portanto, não exibem as guias Estatísticas, Dados ou Consulta.

## Tarefas do inspetor do painel
<a name="panel-inspector-tasks"></a>

No inspetor do painel, você pode inspecionar painéis, inspecionar e fazer download de resultados brutos da consulta, inspecionar a performance da consulta, visualizar modelos JSON do painel e visualizar a solicitação e a resposta brutas à fonte de dados.

### Abrir o inspetor do painel
<a name="open-the-panel-inspector"></a>

Você pode inspecionar qualquer painel que você possa visualizar.

1. No console do espaço de trabalho do Grafana, escolha o dashboard que contém o painel que você deseja inspecionar.

1. Escolha o título do painel que você deseja inspecionar e, em seguida, escolha **Inspecionar**. Ou pause sobre o título do painel e pressione **i**.

O painel do inspetor do painel abre no lado direito da tela.

### Inspecionar os resultados brutos da consulta
<a name="inspect-raw-query-results"></a>

Visualize os resultados brutos da consulta em uma tabela. Estes são os dados retornados pela consulta com as transformações aplicadas e antes que o painel aplique as opções de campo ou as substituições das opções de campo.

1. Abra o inspetor do painel e escolha a guia **Dados**. Ou, no menu do painel, escolha **Inspecionar**, **Dados**.

1. Se o painel contiver várias consultas ou nós de várias consultas, você terá opções adicionais.
+  **Selecionar resultado**: escolha quais dados do conjunto de resultados você deseja visualizar.
+  **Transformar dados** 
  +  **Associadas por tempo**: visualize os dados brutos de todas as suas consultas de uma só vez, com um conjunto de resultados por coluna. Escolha um título de coluna para reordenar os dados.

  Visualize os resultados brutos da consulta em uma tabela com as opções de campo e substituições de opções aplicadas.

  1. Abra a guia **Dados** no inspetor do painel.

  1. Acima da tabela, escolha **Opções de exibição de dados**.

  1. Escolha o botão de alternância **Aplicar configuração de campo**.

### Fazer download dos resultados brutos da consulta como um arquivo CSV
<a name="download-raw-query-results-as-csv"></a>

O Amazon Managed Grafana gera um arquivo CSV no local padrão de download do navegador. Você pode abri-lo no visualizador de sua escolha.

1. Abra o inspetor do painel.

1. Inspecione os resultados brutos da consulta conforme descrito acima. Ajuste as configurações até ver os dados brutos que deseja exportar.

1. Escolha **Fazer download do CSV**.

Para fazer o download de um arquivo CSV formatado para Excel, expanda o painel das **opções de Dados** e ative a opção **Fazer download para o Excel** antes de selecionar **Fazer download do CSV**. 

### Inspecionar a performance da consulta
<a name="inspect-query-performance"></a>

A guia **Estatísticas** exibe estatísticas que informam quanto tempo a consulta leva, quantas consultas você envia e o número de linhas retornadas. Essas informações podem ajudar a solucionar suas dúvidas, especialmente se algum dos números for inesperadamente alto ou baixo.

1. Abra o inspetor do painel.

1. Escolha a guia **Estatísticas**.

As estatísticas são exibidas em formato somente leitura.

### Exibir modelos do painel JSON
<a name="view-panel-json-model"></a>

Explore e exporte modelos JSON de painel, dados de painel e quadro de dados.

1. Abra o inspetor do painel e escolha a guia **JSON**. Ou, no menu do painel, escolha **Inspecionar**, **Painel JSON**. 

1. Em **Selecionar fonte**, escolha uma das seguintes opções:
   +  **Painel JSON**: exibe um objeto JSON representando o painel.
   +  **Dados do painel**: exibe um objeto JSON representando os dados que foram passados para o painel. 
   +  **DataFrame estrutura** — Exibe o conjunto de resultados brutos com suas transformações, configuração de campo e substituições aplicadas.

1. Você pode expandir ou recolher partes do JSON para explorá-lo, ou pode escolher **Copiar para a área de transferência** e colar o JSON em outra aplicação.

### Visualizar a resposta e a solicitação brutas à fonte de dados
<a name="view-raw-request-and-response-to-data-source"></a>

1. Abra o inspetor do painel e escolha a guia **Consulta**. Ou, no menu do painel, escolha **Inspecionar**, **Consulta**.

1. Escolha **Refresh**.

O Amazon Managed Grafana envia uma consulta ao servidor para coletar informações e, em seguida, exibe o resultado. Você pode ter opções para acessar partes específicas da consulta, expandir ou recolher todas elas ou copiar os dados na área de transferência para usar em outras aplicações.

# Lista de cálculos
<a name="list-of-calculations"></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).

Este tópico lista e define os cálculos usados no Amazon Managed Grafana.

Esses cálculos são usados na guia **Transformar** e nas visualizações de medidor em barras, medidor e estatísticas, entre outros lugares.


|  Cálculo  |  Description  | 
| --- | --- | 
|  Todos nulos  |  True quando todos os valores são nulos  | 
|  Todos zeros  |  True quando todos os valores são 0  | 
|  Contagem das alterações  |  Número de vezes que o valor do campo é alterado  | 
|  Contagem  |  Número de valores em um campo  | 
|  Delta  |  Alteração cumulativa no valor  | 
|  Diferença  |  Diferença entre o primeiro e o último valor de um campo  | 
|  Contagem diferenciada  |  Número de valores exclusivos em um campo  | 
|  Primeiro (não nulo)  |  Primeiro, não é um valor nulo em um campo  | 
|  Máx  |  Valor máximo de um campo  | 
|  Média  |  Valor médio de todos os valores em um campo  | 
|  Mín.  |  Valor mínimo de um campo  | 
|  Mín. (acima de zero)  |  Valor mínimo positivo de um campo  | 
|  Intervalo  |  Diferença entre os valores máximo e mínimo de um campo  | 
|  Etapa  |  Intervalo mínimo entre os valores de um campo  | 
|  Total  |  Soma de todos os valores em um campo  | 

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

# Explore
<a name="explore"></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).

 Em um espaço de trabalho do Grafana, a interface de usuário do dashboard fornece ferramentas para criar dashboards para visualização. O *Explore* remove todas as opções do dashboard e painel para que você possa se concentrar na consulta. Itere até que você tenha uma consulta funcional e, em seguida, planeje e crie um dashboard. 

 Para monitoramento da infraestrutura e resposta a incidentes, você não precisa mais mudar para outras ferramentas para depurar o que deu errado. Você pode usar o Explore para se aprofundar nas métricas e logs para encontrar a causa.

 O Explore facilita a visualização dos dados sem criar um dashboard. Se a fonte de dados for compatível com dados de grafos e tabelas, o Explore mostrará os resultados como um grafo e uma tabela. Isso permite que você veja tendências nos dados e mais detalhes ao mesmo tempo. 

## Começar a explorar
<a name="start-exploring"></a>

**nota**  
 Por padrão, os usuários com o perfil Visualizador não podem editar e não têm acesso ao Explore. 

 O ícone do **Explore** no menu do lado esquerdo abre uma guia do Explore vazia. 

 Para começar com uma consulta existente em um painel, escolha a opção **Explore** no menu **Painel**. Isso abre uma guia do Explore que contém a consulta do painel. Você pode então ajustar ou iterar a consulta fora do dashboard. 

 Escolha a fonte de dados na lista suspensa no canto superior esquerdo. O Prometheus tem uma implementação personalizada do Explore. As outras fontes de dados usam o editor de consultas padrão. 

 No campo de consulta, você pode escrever a consulta para explorar os dados. Há três botões ao lado do campo de consulta: um botão para limpar (X), um botão para adicionar consulta (\$1) e o botão para remover consulta (-). Como no editor de consultas do painel, você pode adicionar e remover várias consultas. 

## Dividir e comparar
<a name="split-and-compare"></a>

 O recurso de visualização dividida é uma forma de comparar gráficos e tabelas side-by-side ou de analisar dados relacionados juntos em uma página. Escolha **Dividir** para duplicar a consulta atual e dividir a página em duas side-by-side consultas. Você tem a opção de selecionar uma fonte de dados diferente para a nova consulta. Isso lhe dá a oportunidade de comparar a mesma consulta para dois servidores diferentes, ou comparar o ambiente de preparação com o ambiente de produção. 

 Na visualização dividida, os seletores de tempo dos dois painéis podem ser vinculados (se você alterar um, o outro também será alterado) ao escolher um dos botões de sincronização de tempo anexados aos seletores de tempo. Vincular os seletores de tempo ajuda a manter sincronizados as horas de início e término das consultas de visualização dividida para que você veja o mesmo intervalo de tempo nos dois painéis divididos. 

 Você pode fechar a consulta recém-criada escolhendo **Fechar divisão**.

## Compartilhar um link encurtado
<a name="share-shortened-link"></a>

 Use o recurso **Compartilhar link encurtado** para criar um formato menor e mais simples, `/goto/:uid` em vez URLs de compartilhar um formato mais longo URLs que contenha parâmetros de consulta complexos. Você pode criar um link encurtado escolhendo a opção **Compartilhar** na barra de ferramentas do Explore. Todos os links encurtados que nunca são usados são excluídos automaticamente após sete dias. 

## Histórico de consultas
<a name="query-history"></a>

 O histórico de consultas é uma lista de consultas que você usou no Explore. O histórico é local no seu navegador e não é compartilhado. Para abrir e interagir com o histórico, escolha **Histórico de consultas** no Explore. 

### Visualizar o histórico de consultas
<a name="view-query-history"></a>

 FIn o histórico de consultas, você pode fazer o seguinte: 
+  Execute uma consulta. 
+  Criar ou editar um comentário. 
+  Copiar uma consulta para a área de transferência. 
+  Copiar um link encurtado com a consulta para a área de transferência. 
+  Marque uma consulta com favorita. 

### Gerenciar consultas marcadas como favoritas
<a name="manage-favorite-queries"></a>

 Todas as consultas que foram marcadas com estrela na guia Histórico de consultas são exibidas na guia Com estrela. Você pode acessar as consultas marcadas como favoritas com mais rapidez e reutilizá-las sem precisar digitá-las novamente. 

### Classificar o histórico de consultas
<a name="sort-query-history"></a>

 Por padrão, o histórico de consultas mostra as consultas mais recentes. Você pode classificar seu histórico por data ou nome de fonte de dados em ordem crescente ou decrescente. 

No lado direito do histórico de consultas, na lista suspensa, escolha uma das seguintes opções de campo:
+  Mais recente primeiro 
+  Mais antigo primeiro 
+  Fonte de dados A-Z 
+  Fonte de dados Z-A 

**nota**  
 Se você estiver na visualização dividida, o modo de classificação se aplicará somente ao painel ativo. 

### Filtrar o histórico de consultas
<a name="filter-query-history"></a>

 Nas guias **Histórico de consultas** e **Com estrela**, você pode filtrar o histórico de consultas pelo nome da fonte de dados. 

1. Escolha **Filtrar consultas para fontes de dados específicas**.

1. Selecione a fonte de dados que você deseja usar para filtrar o histórico. Você também pode selecionar várias fontes de dados.

Na guia **Histórico de consultas**, você pode usar o controle deslizante vertical para filtrar as consultas por data:
+ Arraste a alça inferior para ajustar a data de início.
+ Arraste a alça superior para ajustar a data de término. 

**nota**  
Se você estiver na visualização dividida, os filtros serão aplicados somente ao painel ativo. 

### Pesquisar no histórico de consultas
<a name="search-in-query-history"></a>

 Você pode pesquisar nas consultas e comentários do histórico. É possível pesquisar consultas nas guias **Histórico de consultas** e **Com estrela**. 

1.  Escolha o campo **Pesquisar consultas**. 

1.  No campo de pesquisa, insira o termo de pesquisa. 

### Configurações do histórico de consultas
<a name="query-history-settings"></a>

 Você pode personalizar o histórico de consultas na guia **Configurações**. A tabela a seguir lista as opções disponíveis. 


|  Configuração  |  Valor padrão  | 
| --- | --- | 
|  Especifique por quanto tempo o Grafana salvará o histórico de consultas.  |  1 semana  | 
|  Altere a guia ativa padrão. |  Guia Histórico de consultas  | 
|  Mostre consultas somente para a fonte de dados atualmente ativa no Explore.  |  Verdadeiro  | 
|  Limpar o histórico de consultas.  |  (Escolha Limpar histórico de consultas para excluir permanentemente todas as consultas armazenadas.)  | 

**nota**  
As configurações do histórico de consultas são globais e aplicadas aos dois painéis no modo de divisão.

## Recursos específicos do Prometheus
<a name="prometheus-specific-features"></a>

 A primeira versão do Explore apresenta uma experiência de consulta personalizada para o Prometheus. Quando você executa uma consulta, o Grafana na verdade executa duas consultas: uma consulta normal do Prometheus para o grafo e uma consulta instantânea para a tabela. Uma consulta instantânea retorna o último valor de cada série temporal, o que mostra um bom resumo dos dados apresentados no grafo. 

### Explorador de Métricas
<a name="metrics-explorer"></a>

 No lado esquerdo do campo de consulta, escolha **Métricas** para abrir o Explorador de métricas. Ele mostra um menu hierárquico com métricas agrupadas pelo prefixo. Por exemplo, todas as métricas do Alertmanager são agrupadas no prefixo `alertmanager`. Este é um bom ponto de partida para explorar quais métricas estão disponíveis. 

### Campo Consulta
<a name="query-field"></a>

 O campo Consulta é compatível com o preenchimento automático para nomes de métricas e funções e funciona basicamente da mesma forma que o editor de consultas padrão do Prometheus. Pressione **Enter** para executar uma consulta. 

 O menu Preenchimento automático pode ser acessado pressionando **Ctrl\$1Espaço**. O menu Preenchimento automático contém uma nova seção Histórico com uma lista das consultas executadas recentemente. 

 As sugestões podem aparecer no campo Consulta. Escolha uma sugestão para atualizar a consulta com a alteração sugerida. 
+  Para contadores (métricas que aumentam monotonicamente), uma função de taxa será sugerida. 
+  Para buckets, uma função de histograma será sugerida. 
+  Para regras de gravação, é possível expandir as regras.

### Filtros de tabela
<a name="table-filters"></a>

 Escolha o botão **Filtrar** na coluna de **rótulo** de um painel de tabela para adicionar filtros à expressão de consulta. Você também pode adicionar filtros para várias consultas. O filtro é adicionado para todas as consultas. 

## Integração com logs
<a name="logs-integration"></a>

 Você também pode usar o Explore para investigar os logs com as seguintes fontes de dados: 
+  InfluxDB 
+  Elasticsearch 

### Visualização de logs
<a name="logs-visualization"></a>

 Os resultados das consultas de logs são mostrados como histogramas no grafo, e os registros individuais são exibidos abaixo. Se a fonte de dados não enviar dados do histograma para o intervalo de tempo solicitado, o modelo de logs calculará uma série temporal com base nas contagens de linhas de logs agrupadas por um intervalo de tempo calculado automaticamente. O início do histograma é então ancorado pelo carimbo de data e hora da primeira linha de log do resultado. O final da série temporal está ancorado no intervalo **Até** do seletor de tempo. 

#### Nível de log
<a name="log-level"></a>

 Para logs em que um rótulo de **nível** é especificado, o Grafana usa o valor do rótulo para determinar o nível do log e atualizar a cor de acordo. Se o log não tiver um rótulo de nível especificado, o Grafana analisará o log para descobrir se seu conteúdo corresponde a alguma das expressões compatíveis. O nível do log é sempre determinado pela primeira correspondência. Se o Grafana não conseguir determinar um nível de log, ele será visualizado com o nível de log **desconhecido**. A tabela a seguir lista os níveis de logs e o mapeamento de abreviações e expressões de níveis de logs. 


|  Expressões compatíveis  |  Nível de log  |  Cor  | 
| --- | --- | --- | 
|  emerg  |  crítico  |  roxo  | 
|  fatal  |  crítico  |  roxo  | 
|  alerta  |  crítico  |  roxo  | 
|  crit  |  crítico  |  roxo  | 
|  crítico  |  crítico  |  roxo  | 
|  err  |  erro  |  vermelho  | 
|  eror  |  erro  |  vermelho  | 
|  erro  |  erro  |  vermelho  | 
|  warn  |  aviso  |  amarelo  | 
|  aviso  |  aviso  |  amarelo  | 
|  info  |  info  |  verde  | 
|  informações  |  info  |  verde  | 
|  notice  |  info  |  verde  | 
|  dbug  |  depurar  |  azul  | 
|  depurar  |  depurar  |  azul  | 
|  rastreamento  |  rastreamento  |  azul claro  | 
|  \$1  |  desconhecido  |  cinza  | 

### Opções de visualização
<a name="visualization-options"></a>

 Você pode personalizar a forma como os logs são exibidos e selecionar quais colunas são mostradas. 

#### Hora
<a name="visualization-options-time"></a>

 Esta opção mostra ou oculta a coluna de tempo. Este é o carimbo de data e hora associado à linha de log, conforme relatado pela fonte de dados. 

#### Rótulos exclusivos
<a name="visualization-options-unique-labels"></a>

 Esta opção mostra ou oculta a coluna de rótulos exclusivos, que inclui somente rótulos não comuns. Todos os rótulos comuns são exibidos acima.

#### Quebrar linhas
<a name="visualization-options-wrap-lines"></a>

 Para usar a quebra de linha na exibição, defina esta opção como **True**. Defini-la como **False** resulta em rolagem horizontal. 

#### Desduplicação
<a name="visualization-options-deduping"></a>

 Os dados de logs podem ser muito repetitivos. O Explore pode ajudar ocultando linhas de logs duplicadas. É possível escolher entre diferentes algoritmos de desduplicação: 
+  **Exato**: são feitas correspondências exatas em toda a linha, exceto nos campos de data. 
+  **Números**: as correspondências são feitas na linha após a remoção de números, como durações, endereços IP e assim por diante. 
+  **Assinatura**: a desduplicação mais radical, que remove todas as letras e números. As correspondências são feitas nos espaços em branco e na pontuação restantes. 

#### Inverter a ordem dos resultados
<a name="visualization-options-flip-results-order"></a>

 Você pode alterar a ordem dos logs recebidos da ordem decrescente padrão (os mais recentes primeiro) para a ordem crescente (os mais antigos primeiro). 

### Rótulos e campos detectados
<a name="labels-and-detected-fields"></a>

 Cada linha de log tem uma área extensível com seus rótulos e campos detectados para uma interação mais robusta. Para todos os rótulos, você pode filtrar por (filtro positivo) e filtrar excluindo (filtro negativo) os rótulos selecionados. Cada campo ou rótulo também tem um ícone de estatísticas para exibir estatísticas únicas em relação a todos os logs exibidos. 

### Alternar campos detectados
<a name="toggle-detected-fields"></a>

 Se os logs estiverem estruturados em JSON ou logfmt, você poderá mostrar ou ocultar os campos detectados. Expanda uma linha de log e escolha o ícone de olho para mostrar ou ocultar campos. 

 \$1\$1< docs-imagebox img=”/img/docs/explore/parsed-fields-7-2.gif "max-width="800px” caption="Alternando campos detectados no Explore” >\$1\$1 

## Integração de rastreamento
<a name="tracing-integration"></a>

 Você pode visualizar os rastreamentos de fontes de dados de rastreamento no Explore. Fontes de dados atualmente compatíveis: 
+ [Conectar-se a uma fonte de dados Jaeger](jaeger-data-source.md) 
+ [Conectar-se a uma fonte de dados Tempo](tempo-data-source.md) 
+ [Conecte-se a uma fonte AWS X-Ray de dados](x-ray-data-source.md) 
+ [Conectar-se a uma fonte de dados Zipkin](zipkin-data-source.md) 

 Para obter informações sobre como usar o editor de consultas, consulte a documentação da fonte de dados específica. 

### Cabeçalho
<a name="explore-header"></a>

O cabeçalho inclui os seguintes itens:
+  Título do cabeçalho, que mostra o nome da extensão raiz e o ID de rastreamento 
+  Pesquisa, que destaca as extensões que contêm o texto pesquisado 
+  Metadados sobre o rastreamento 

### Minimapa
<a name="explore-minimap"></a>

 O minimapa mostra uma visão condensada da linha do tempo do rastreamento. Arraste o ponteiro do mouse sobre o minimapa para ampliar para um intervalo de tempo menor. O zoom também atualizará a linha do tempo principal, para que seja fácil ver extensões mais curtas. Se você pausar no minimapa, quando ampliado, poderá ver o botão **Redefinir seleção**, que redefine o zoom. 

### Linha do tempo
<a name="explore-timeline"></a>

 A linha do tempo mostra uma lista de extensões dentro do rastreamento. Cada linha de extensão consiste nos seguintes componentes: 
+ Botão **Expandir secundárias**: expande ou contrai todas as extensões secundárias da extensão selecionada 
+ Nome do serviço: nome do serviço que registrou em log a extensão
+ Nome da operação: nome da operação que essa extensão representa
+ Barra de duração da extensão: representação visual da duração da operação no rastreamento

Escolher qualquer lugar na linha da extensão mostra os detalhes dela. 

### Detalhes da extensão
<a name="explore-span-details"></a>

Os detalhes da extensão incluem os seguintes itens:
+  Nome da operação 
+  Metadados da extensão 
+  Tags (quaisquer tags associadas a essa extensão) 
+  Metadados do processo (metadados sobre o processo que registrou em log essa extensão) 
+  Logs: lista de logs registrados por essa extensão e valores de chave associados. No caso de logs do Zipkin, a seção mostra as anotações do Zipkin. 

## Navegar entre o Explore e um dashboard
<a name="navigating-between-explore-and-a-dashboard"></a>

 Para ajudar a acelerar os fluxos de trabalho que envolvem a mudança regular do Explore para um dashboard e vice-versa, adicionamos a capacidade de retornar ao dashboard de origem depois de navegar até o Explore na lista suspensa do painel. 

 Depois de navegar até o Explore, você verá o botão “Voltar” na barra de ferramentas do Explore. 

 Ao escolher o botão para retornar ao dashboard de origem ou, se quiser levar as alterações feitas no Explore de volta para o dashboard, basta escolher a seta ao lado do botão para revelar o item de menu “Retornar ao painel com alterações”. 

## Inspetor de consultas
<a name="query-inspector"></a>

 Para ajudar na depuração de consultas, o Explore permite que você investigue solicitações e respostas de consultas, bem como as estatísticas de consultas, por meio do Inspetor de consultas. Essa funcionalidade é semelhante à guia **Estatísticas** do inspetor do painel e à guia **Consulta**. Para obter mais informações, consulte [Inspecionar a performance da consulta](inspect-a-panel.md#inspect-query-performance) e [Visualizar a resposta e a solicitação brutas à fonte de dados](inspect-a-panel.md#view-raw-request-and-response-to-data-source). 

# Linking (Vinculando)
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></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).

 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 Amazon Managed Grafana é compatível com links de dashboards, 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 ao escolher um ícone no canto superior esquerdo do painel. 

## Qual link você deve usar?
<a name="which-link-should-you-use"></a>

 Comece ao examinar 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. 
+  Para adicionar links relacionados à maioria ou a todos os painéis no dashboard, use [Links do dashboard](dashboard-links.md). 
+  Para detalhar e acessar painéis específicos, use [Links do painel](panel-links.md).
+  Para vincular a sites externos, 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](data-links.md). 

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

 Você pode controlar o intervalo de tempo de um painel ou 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. 
+  `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 milissegundos. Por exemplo, `?time=1500000000000&time.window=10000` resultará em um intervalo de tempo de dez segundos de 1499999995000 a 1500000005000 

# Links do dashboard
<a name="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 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).

 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. Isso ajuda a garantir que a pessoa para quem você envia o link esteja vendo os dados corretos. Para outros tipos de links, consulte [Variáveis de links de dados](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

 Depois que você adiciona um link a um dashboard, ele aparece no canto superior direito do dashboard. 

## Adicionar links aos dashboards
<a name="add-links-to-dashboards"></a>

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

1.  Ao visualizar o dashboard ao qual você deseja adicionar um link, escolha o ícone de engrenagem na parte superior da tela para abrir **Configurações do dashboard**. 

1.  Escolha **Links** e depois **Adicionar link ao painel** ou **Novo**. 

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

1.  Selecione as opções de link: 
   +  **Com tags**: insira tags para limitar os dashboards vinculados somente àqueles com as tags inseridas. Do contrário, o espaço de trabalho do Grafana incluirá links para todos os outros dashboards. 
   +  **Como lista suspensa**: selecione esta opção se estiver vinculando vários dashboards e adicione um título opcional à lista suspensa. Se esta opção não for selecionada, o espaço de trabalho do Grafana exibirá os links do dashboard lado a lado na parte superior dele. 
   +  **Intervalo de tempo**: selecione esta opção para incluir o intervalo de tempo do dashboard no link. Quando o usuário escolhe o link, o dashboard vinculado é aberto com o intervalo de tempo indicado já definido.
   +  **Valores de variável**: selecione esta opção para incluir as variáveis do modelo que são usadas atualmente como parâmetros de consulta no link. Quando o usuário escolhe o link, todos os modelos correspondentes no dashboard vinculado são definidos com os valores do link.
   +  **Abrir em uma nova guia**: selecione esta opção para abrir o link do dashboard em uma nova guia ou janela. 

1.  Escolha **Adicionar**. 

## Adicionar um link de URL a um dashboard
<a name="add-a-url-link-to-a-dashboard"></a>

 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 veja os dados específicos no espaço de trabalho do Grafana. 

1.  Ao visualizar o dashboard ao qual você deseja vincular, escolha o ícone de engrenagem na parte superior da tela para abrir **Configurações do dashboard**. 

1.  Escolha **Links** e depois **Adicionar link ao painel** ou **Novo**. 

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

1.  Selecione as opções de link: 
   +  **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 quando o usuário pausar sobre ele. 
   +  **Í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 escolhe o link, o dashboard vinculado é aberto com o intervalo de tempo indicado já 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 milissegundos. Por exemplo, `?time=1500000000000&time.window=10000` resulta em um intervalo de tempo de dez segundos de 1499999995000 a 1500000005000. 
   +  **Valores de variável**: selecione esta opção para incluir as variáveis do modelo que são usadas atualmente como parâmetros de consulta no link. Quando o usuário escolhe o link, todos os modelos correspondentes no painel vinculado são definidos com os valores do link; por exemplo, https://play.grafana. org/d/000000074/alerting? var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval=1h 
   +  **Abrir em uma nova guia**: selecione esta opção para abrir o link do dashboard em uma nova guia ou janela. 

1.  Escolha **Adicionar**. 

## Atualizar um link do dashboard
<a name="update-a-dashboard-link"></a>

 Para alterar ou atualizar um link de dashboard existente, use o procedimento a seguir. 

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

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

## Duplicar um link do dashboard
<a name="duplicate-a-dashboard-link"></a>

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

## Excluir um link do dashboard
<a name="delete-a-dashboard-link"></a>

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

# Links do painel
<a name="panel-links"></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).

 Cada painel pode ter seu próprio conjunto de links que são mostrados no canto superior esquerdo do painel. Você pode criar links para qualquer um disponível URLs, incluindo painéis, painéis ou sites externos. Você pode até mesmo controlar o intervalo de tempo para garantir que o usuário veja os dados específicos no espaço de trabalho do Grafana. 

Escolha o ícone no canto superior esquerdo de um painel para ver os links disponíveis do painel. 

## Adicionar um link ao painel
<a name="add-a-panel-link"></a>

1.  Pause no painel ao qual você deseja adicionar um link e pressione **e**. Ou escolha a seta suspensa ao lado do título do painel e escolha **Editar**. 

1.  Na guia **Painel**, role para baixo até a seção **Links**. 

1.  Expanda **Links** e escolha **Adicionar link**. 

1.  Insira um **Título** para o link. O título será exibido na interface do usuário. 

1.  Insira o **URL** ao qual você deseja vincular. Você pode incluir uma das variáveis do modelo definidas no dashboard. Pressione **Ctrl\$1Espaço** ou **Cmd\$1Espaço** e escolha o campo **URL** para ver as variáveis disponíveis. Quando você adiciona variáveis de modelo ao link do painel, o link envia o usuário para o contexto certo, 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 milissegundos. Por exemplo, `?time=1500000000000&time.window=10000` resulta em um intervalo de tempo de dez segundos de 1499999995000 a 1500000005000. 

1.  Para abrir em uma nova guia, selecione **Abrir em uma nova guia**. 

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

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

## Atualizar um link do painel
<a name="update-a-panel-link"></a>

1.  Na guia **Painel**, encontre o link em que você deseja fazer alterações. 

1.  Escolha o ícone de **Editar** (lápis) para abrir a janela **Editar link**. 

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

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

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

## Excluir um link do painel
<a name="delete-a-panel-link"></a>

1.  Na guia **Painel**, localize o link que deseja excluir. 

1.  Escolha o ícone **X** ao lado do link que você deseja excluir. 

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

# Links de dados
<a name="data-links"></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 links de dados fornecem um contexto mais granular para os links. Você pode criar links que incluam o nome da série ou até mesmo o valor. Por exemplo, se a visualização mostrar quatro servidores, você poderá adicionar um link de dados a um ou dois deles. 

 O link pode ser acessado de maneiras diferentes, dependendo da visualização. Para o painel de grafo, você precisa escolher um ponto de dados ou uma linha. Para um painel como estatísticas, medidor ou medidor em barras, você pode escolher qualquer lugar na visualização para abrir o menu de contexto. 

 Você pode usar variáveis nos links de dados para enviar as pessoas para um dashboard detalhado com filtros de dados preservados. Por exemplo, você pode usar variáveis para especificar um intervalo de tempo, uma série e uma seleção de variáveis. Para obter mais informações, consulte [Variáveis de links de dados](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

## Sugestões de digitação antecipada
<a name="typeahead-suggestions"></a>

 Ao criar ou atualizar um link de dados, pressione **Ctrl\$1Espaço** ou **Cmd\$1Espaço** no teclado para abrir as sugestões de digitação antecipada e adicionar variáveis ao URL com mais facilidade. 

## Adicionar um link de dados
<a name="add-a-data-link"></a>

1.  Pause no painel ao qual você deseja adicionar um link e pressione **e**. Ou escolha a seta suspensa ao lado do título do painel e escolha **Editar**. 

1.  Na guia **Campo**, role para baixo até a seção **Links de dados**. 

1.  Expanda **Links de dados** e escolha **Adicionar link**. 

1.  Insira um **Título** para o link. O título será exibido na interface do usuário. 

1.  Insira o **URL** ao qual você deseja vincular. 

    Você pode adicionar uma das variáveis do modelo definidas no dashboard. Escolha o campo **URL** e digite **\$1** ou pressione ****Ctrl\$1Espaço ou **Cmd\$1Espaço** para ver uma lista das variáveis disponíveis. Quando você adiciona variáveis de modelo ao link do painel, o link envia o usuário para o contexto certo, com as variáveis relevantes já definidas. Para obter mais informações, consulte [Variáveis de links de dados](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

1.  Para abrir em uma nova guia, selecione **Abrir em uma nova guia**. 

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

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

## Atualizar um link de dados
<a name="update-a-data-link"></a>

1.  Na guia **Campo**, encontre o link no qual deseja fazer alterações. 

1.  Escolha o ícone de **Editar** (lápis) para abrir a janela **Editar link**. 

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

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

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

## Excluir um link de dados
<a name="delete-a-data-link"></a>

1.  Na guia **Campo**, localize o link que deseja excluir. 

1.  Escolha o ícone **X** ao lado do link que você deseja excluir. 

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

## Variáveis de links de dados
<a name="data-link-variables"></a>

 Você pode usar variáveis em links de dados para ver campos, rótulos e valores de séries. Para obter mais informações sobre links de dados, consulte [Links de dados](data-links.md). 

 Para ver uma lista das variáveis disponíveis, insira **\$1** no campo **URL** do link de dados. 

 Você também pode usar variáveis de modelo em seus links de dados URLs. Para obter mais informações, consulte [Modelos e variáveis](templates-and-variables.md). 

### Variáveis do painel de intervalo de tempo
<a name="time-range-panel-variables"></a>

 Você pode usar as seguintes variáveis para incluir o intervalo de tempo atual no URL do link de dados: 
+  `__url_time_range`: o intervalo de tempo atual do dashboard, por exemplo, `?from=now-6h&to=now`. 
+  `$__from and $__to`— Para obter mais informações, consulte [Variáveis globais] (\$1\$1< relref “.. /variables/variable-types/global-variables.md \$1\$1\$1from -and-\$1\$1to” >\$1\$1). 

### Variáveis de séries
<a name="series-variables"></a>

 Variáveis específicas da série estão disponíveis no namespace `__series`: 
+  `__series.name`: adiciona o nome da série ao URL. 
+  `__series.labels.<LABEL>`: adiciona o valor do rótulo ao URL. Se seu rótulo contiver pontos, use a sintaxe `__series.labels["<LABEL>"]`. 

### Variáveis de campo
<a name="field-variables"></a>

 As variáveis específicas de campo estão disponíveis no namespace `__field`: 
+  `__field.name`: o nome do campo. 

### Variáveis de valor
<a name="value-variables"></a>

 Variáveis específicas de valor estão disponíveis no namespace `__value`: 
+  `__value.time`: o carimbo de data e hora do valor (Unix ms epoch) para o URL, por exemplo, `?time=1560268814105`. 
+  `__value.raw`: o valor bruto. 
+  `__value.numeric`: a representação numérica de um valor. 
+  `__value.text`: a representação de texto de um valor. 
+  `__value.calc`: o nome do cálculo se o valor for um resultado do cálculo. 

### Variáveis de modelo
<a name="template-variables"></a>

 Ao vincular a outro dashboard que usa variáveis de modelo, selecione valores de variáveis para quem escolher o link. 

 Use `var-myvar=${myvar}`, em que `myvar` é o nome da variável de modelo que corresponde a uma no dashboard atual que você deseja usar. 

 Para adicionar todas as variáveis do dashboard atual ao URL, use `__all_variables`. 

# Modelos e variáveis
<a name="templates-and-variables"></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 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. As variáveis permitem criar dashboards mais interativos e dinâmicos. Em vez da codificação rígida dos nomes de servidores, das aplicações e dos sensores em suas consultas de métricas, você pode usar variáveis no lugar deles. 

As variáveis são exibidas como listas suspensas na parte superior do dashboard. Quando você altera o valor usando a lista suspensa na parte superior do dashboard, as consultas de métricas do seu painel refletem o novo valor. 

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

Ao usar variáveis e modelos, você pode criar dashboards de origem ú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 a manutenção e conservação. 

Para obter uma lista dos tipos de variáveis compatíveis e instruções para adicionar cada tipo de variável, consulte [Tipos de variáveis](variables-types.md).

## Modelos
<a name="templates"></a>

 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 você poderia criar um dashboard e usar painéis com consultas de modelos, como mostrado no exemplo 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`. 

## Práticas recomendadas de variáveis
<a name="variable-best-practices"></a>

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ê vai alterar com frequência na parte superior para que elas sejam mostradas primeiro, na extremidade esquerda do dashboard.

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

 Os títulos dos painéis e as consultas métricas podem ver variáveis usando duas sintaxes diferentes: 
+  `$varname` Esta sintaxe é mais fácil de ler, como no seguinte exemplo: `apps.frontend.$server.requests.count`. No entanto, você não pode usar uma variável no meio de uma palavra. 
+  `${var_name}` Use esta sintaxe quando quiser interpolar uma variável no meio de uma expressão. 
+  `${var_name:<format>}` Este formato lhe dá mais controle de como o Grafana interpola valores. Para obter mais informações, consulte [Opções avançadas de formato de variáveis](#advanced-variable-format-options). 

 Antes que as consultas sejam enviadas à fonte de dados, a consulta é *interpolada*, o que significa que a variável é substituída pelo 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 Prometheus terá escape de regex. Leia o tópico da documentação específica da fonte de dados para obter detalhes sobre o escape de valor durante a interpolação. 

 Para obter informações sobre a sintaxe avançada para substituir a formatação padrão da fonte de dados, consulte [Opções avançadas de formato de variáveis](#advanced-variable-format-options). 

# Tipos de variáveis
<a name="variables-types"></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 Grafana usa vários tipos de variáveis. 


|  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. Para obter mais informações, consulte [Adicionar uma variável de consulta.](#add-a-query-variable).  | 
|  Personalizada  |  Defina as opções de variáveis manualmente usando uma lista separada por vírgulas. Para obter mais informações, consulte [Adicionar uma variável personalizada](#add-a-custom-variable).  | 
|  Text box (Caixa de texto)  |  Exibir um campo de entrada de texto com um valor padrão opcional. Para obter mais informações, consulte [Adicionar uma variável de caixa de texto](#add-a-text-box-variable).  | 
|  Constante  |  Defina uma constante oculta. Para obter mais informações, consulte [Adicionar uma variável constante](#add-a-constant-variable).  | 
|  Fonte de dados  |  Altere rapidamente a fonte de dados de todo um dashboard. Para obter mais informações, consulte [Adicionar uma variável de fonte de dados](#add-a-data-source-variable).  | 
|  Intervalo  |  As variáveis de intervalo representam intervalos de tempo. Para obter mais informações, consulte [Adicionar uma variável de intervalo](#add-an-interval-variable).  | 
|  Filtros ad hoc  |  Key/value filtros que são adicionados automaticamente a todas as consultas métricas de uma fonte de dados (InfluxDB, Prometheus e somente). OpenSearch Para obter mais informações, consulte [Adicionar filtros ad hoc](#add-ad-hoc-filters).  | 
|  Variáveis globais  |  Variáveis internas que podem ser usadas em expressões no editor de consultas. Para obter mais informações, consulte [Variáveis globais](#global-variables).  | 
|  Variáveis encadeadas  |  As consultas de variáveis podem conter outras variáveis. Para obter mais informações, consulte [Variáveis encadeadas](#chained-variables).  | 

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

 Ao usar variáveis de consulta, você pode escrever uma consulta de fonte de dados que retorne uma lista de nomes de métricas, valores de tag 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. 

 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. 

### Expressões de consulta.
<a name="query-expressions"></a>

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 em [Conectar-se à fonte de dados](AMG-data-sources.md).

### Inserir opções gerais
<a name="enter-general-options"></a>

**Para inserir opções gerais para uma variável de consulta**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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 da lista suspensa 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)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. Esse é o padrão. 
   +  **Rótulo:** a lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. 

### Inserir opções de consulta
<a name="enter-query-options"></a>

**Para inserir opções de consulta para uma variável de consulta**

1. Na lista **Fonte de dados**, selecione a fonte de dados de destino para a consulta. Para obter mais informações sobre fontes de dados, consulte [Conectar-se à fonte de dados](AMG-data-sources.md).

1.  Na lista **Atualizar**, selecione quando a variável deve atualizar as opções. 
   +  **Nunca**: armazena em cache as consultas de variáveis, e os valores não são atualizados. Isso será bom se os valores nunca mudarem, mas problemático se forem dinâmicos e mudarem muito. 
   +  **No carregamento do dashboard**: consultas a fontes de dados sempre que o dashboard é carregado. Isso retarda o carregamento do dashboard, pois 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 sua 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. 
   + Se você precisar de mais espaço em um único editor de consulta de campo de entrada, pause nas 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 obter exemplos, consulte [Filtrar variáveis com regex](templates-and-variables.md#filter-variables-with-regex). 

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**. Para obter mais informações, consulte [Inserir opções de seleção de variáveis](templates-and-variables.md#enter-variable-selection-options). 

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

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

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

 Use uma variável *personalizada* para valores que não mudam. Pode ser números, strings ou até mesmo outras variáveis. 

Por exemplo, se você tiver nomes de servidores ou nomes de regiões que não mudam, você pode criá-los como variáveis personalizadas em vez de variáveis de consulta. Como eles não mudam, você pode usá-los em variáveis encadeadas 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 obter mais informações sobre variáveis encadeadas, consulte [Variáveis encadeadas](#chained-variables). 

### Inserir opções gerais
<a name="variables-enter-general-options"></a>

**Para inserir opções de consulta para uma variável personalizada**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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

1.  Na lista **Tipo**, escolha **Personalizada**. 

1. (Opcional) Em **Rótulo**, insira o nome de exibição da lista suspensa 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)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. Esse é o padrão. 
   +  **Rótulo**: o menu suspenso da lista de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. 

### Inserir opções personalizadas
<a name="enter-custom-options"></a>

**Para inserir opções personalizadas para uma variável personalizada**

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, outras variáveis ou pares de chave/valor separados por dois pontos. 

1.  (Opcional) Insira as **Opções de seleção**. Para obter mais informações, consulte [Inserir opções de seleção de variáveis](templates-and-variables.md#enter-variable-selection-options). 

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

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

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

 As variáveis da *caixa de texto* exibem um campo de entrada de texto 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. 

### Inserir opções gerais
<a name="text-box-enter-general-options"></a>

**Para inserir opções gerais para uma variável de caixa de texto**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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

1.  Na lista **Tipo**, selecione **Caixa de texto**. 

1. (Opcional) Em **Rótulo**, insira o nome de exibição da lista suspensa 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)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. Esse é o padrão. 
   +  **Rótulo:** a lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. 

### Inserir opções de texto
<a name="enter-text-options"></a>

**Para inserir opções de texto para uma variável de caixa de texto**

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 em que você pode digitar 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. Escolha **Adicionar** para adicionar a variável ao dashboard. 

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

Para definir uma constante oculta, use variáveis *constantes*. Variáveis constantes são úteis 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 somente um valor. Para atualizá-lo, você deve atualizar as configurações da variável. 

Variáveis constantes são úteis quando você tem valores complexos que devem ser incluídos nas consultas, mas não quer digitar novamente em cada consulta. Por exemplo, se você tivesse um caminho de servidor denominado `i-0b6a61efe2ab843gg`, você poderia substituí-lo por uma variável denominada `$path_gg`. 

### Inserir opções gerais
<a name="constant-variable-enter-general-options"></a>

**Para inserir opções gerais para uma variável constante**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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

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

1. (Opcional) Em **Rótulo**, insira o nome de exibição da lista suspensa 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**: 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. Esse é o padrão. 
   +  **Nenhuma seleção (em branco)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. 
   +  **Rótulo:** a lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 

### Inserir opções constantes
<a name="enter-constant-options"></a>

**Para inserir opções constantes para uma variável constante**

1. Insira o valor da variável no campo **Valor**. É possível inserir letras, números e símbolos. Caso use opções avançadas de formato de variáveis, você poderá até usar curingas. Para obter mais informações, consulte [Opções avançadas de formato de variáveis](templates-and-variables.md#advanced-variable-format-options). 

1. Na **Pré-visualização de valores**, o espaço de trabalho do Grafana exibe o valor da variável atual. Revise-o para garantir que corresponda ao que você espera. 

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

## Adicionar uma variável de fonte de dados
<a name="add-a-data-source-variable"></a>

Para alterar rapidamente a fonte de dados de um dashboard inteiro, você pode usar variáveis da *fonte de dados*. Elas serão úteis se você tiver várias instâncias de uma fonte de dados, talvez em ambientes diferentes. 

### Inserir opções gerais
<a name="data-source-enter-general-options"></a>

**Para inserir opções gerais para uma variável de fonte de dados**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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

1.  Na lista **Tipo**, selecione **Fonte de dados**. 

1. (Opcional) Em **Rótulo**, insira o nome de exibição da lista suspensa 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)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. Esse é o padrão. 
   +  **Rótulo:** a lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. 

### Inserir opções de fonte de dados
<a name="enter-data-source-options"></a>

**Para inserir opções de fonte de dados para uma variável de fonte de dados**

1.  Na lista **Tipo**, selecione a fonte de dados de destino para a variável. Para obter mais informações sobre fontes de dados, 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. Mantenha este campo vazio para exibir todas as instâncias. 

1.  (Opcional) Insira as **Opções de seleção**. Para obter mais informações, consulte [Inserir opções de seleção de variáveis](templates-and-variables.md#enter-variable-selection-options). 

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. Escolha **Adicionar** para adicionar a variável ao dashboard. 

## Adicionar uma variável de intervalo
<a name="add-an-interval-variable"></a>

Use uma variável de *intervalo* para representar períodos de tempo como `1m`, `1h`, `1d`. Você pode pensar neles como um comando em todo o painel group-by-time. 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 data (para OpenSearch) ou como um parâmetro de função de resumo (para Graphite). 

### Inserir opções gerais
<a name="interval-variable-enter-general-options"></a>

**Para inserir opções gerais para uma variável de intervalo**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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

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

1. (Opcional) Em **Rótulo**, insira o nome de exibição da lista suspensa 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)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. Esse é o padrão. 
   +  **Rótulo:** a lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. 

### Inserir opções de intervalo
<a name="enter-interval-options"></a>

**Para inserir opções de intervalo para uma variável de intervalo**

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. Use essa opção para especificar quantas vezes o intervalo de tempo atual deve ser dividido para calcular o intervalo 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 `2m`, 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. Escolha **Adicionar** para adicionar a variável ao dashboard. 

### Exemplos de variáveis de intervalo
<a name="interval-variable-examples"></a>

 Exemplo de uso da variável `myinterval` de modelo em uma função do Graphite: 

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

 Um exemplo mais complexo do Graphite: 

```
groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')
```

## Adicionar filtros ad hoc
<a name="add-ad-hoc-filters"></a>

Você pode usar filtros únicos ou *ad hoc* para adicionar filtros de chave/valor 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 únicos nas consultas. Em vez disso, você os usa para escrever filtros para consultas existentes. 

**nota**  
**Observação:** variáveis de filtro únicas ou ad hoc funcionam somente com InfluxDB, Prometheus e fontes de dados. OpenSearch 

### Inserir opções gerais
<a name="ad-hoc-filters-enter-general-options"></a>

**Para inserir opções gerais para um filtro ad hoc**

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

1.  Na guia **Variáveis**, escolha **Nova**. 

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

1.  Na lista **Tipo**, selecione **Filtros ad hoc**. 

1. (Opcional) Em **Rótulo**, insira o nome de exibição da lista suspensa 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)**: a lista suspensa de variáveis exibe o valor de **Nome** ou **Rótulo** da variável. Esse é o padrão. 
   +  **Rótulo:** a lista suspensa de variáveis exibe somente o valor da variável selecionada e uma seta para baixo. 
   +  **Variável**: nenhuma lista suspensa de variáveis é exibida no dashboard. 

### Inserir opções
<a name="ad-hoc-enter-options"></a>

**Para inserir opções para um filtro ad hoc**

1.  Na lista **Fonte de dados**, selecione a fonte de dados de destino. Para obter mais informações sobre fontes de dados, consulte [Conectar-se à fonte de dados](AMG-data-sources.md). 

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

### Criar de filtros ad hoc
<a name="create-ad-hoc-filters"></a>

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 a criação de 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. 

## Variáveis encadeadas
<a name="chained-variables"></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. Esta seção explica como as variáveis encadeadas funcionam e fornece links para exemplos de dashboards que usam variáveis encadeadas. 

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 de variáveis encadeadas em qualquer fonte de dados que as suporte. 

Você pode criar dashboards complexos vinculados e modelados, 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
<a name="variables-best-practices-and-tips"></a>

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

#### Criar novas variáveis encadeadas
<a name="creating-new-linked-variables"></a>
+  O encadeamento de variáveis cria dependências entre primárias e secundárias. Você pode imaginá-las como uma escada ou uma árvore. 
+ A maneira mais rápida de criar uma nova variável encadeada é copiar a variável em que você deseja basear a nova. Na lista de variáveis, escolha o í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 novas variáveis encadeadas que você cria dessa forma aparecem na parte inferior da lista. Para dar à lista uma ordem lógica, arraste a variável para uma posição diferente na lista. 

#### Ordem das variáveis
<a name="variable-order"></a>

Para alterar a ordem das variáveis na lista de variáveis do dashboard, escolha as setas para cima e para baixo no lado direito de cada entrada. O espaço de trabalho do Grafana lista as listas suspensas de variáveis da esquerda para a direita de acordo com essa lista, exibindo a variável no topo da lista, 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. 
+ A interface de usuário não indica quais variáveis têm relações de dependência. Liste as variáveis em uma ordem lógica para torná-las mais claras para os usuários finais (e para você mesmo). 

#### Considerações sobre complexidade
<a name="complexity-consideration"></a>

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 espaço de trabalho do Grafana deverá executar consultas para todas as variáveis dependentes antes de atualizar as visualizações no dashboard. 

## Variáveis globais
<a name="global-variables"></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
<a name="global-variable-dashboard"></a>

Esta variável é o nome do dashboard atual. 

### \$1\$1\$1from e \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

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  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Unix milissegundos epoch  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T20:19:09.254Z  |  Nenhum argumento, o padrão é ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T20:19:09.254Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Unix segundos epoch  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  Qualquer formato de dados personalizado. Para obter mais informações, consulte [Exibir](https://momentjs.com/docs/#/displaying/).  | 

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

Você também pode usar essa variável em URLs . Por exemplo, para enviar um usuário final para um painel que mostra um intervalo de tempo de seis horas atrás até agora, use o seguinte URL: https://play.grafana. org/d/000000012/grafana- Jogar em casa? Painel de visualização = 2 e orgid = 1? de=agora-6h¶=agora 

### \$1\$1\$1interval
<a name="global-variable-interval"></a>

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

O espaço de trabalho do Grafana calcula automaticamente um intervalo que pode ser usado para agrupar por tempo 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, é mais eficiente agrupar por um dia do que por dez segundos ao analisar três meses de dados. O grafo terá a mesma aparência e a consulta será mais rápida. O `$__interval` é calculado usando o intervalo de tempo e a largura do grafo (o número de pixels). 

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

Por exemplo, quando o intervalo de tempo é de uma hora e o grafo está em tela cheia, o intervalo pode ser calculado para `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` (um dia); os pontos serão agrupados por dia. 

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

 O InfluxDB e as fontes de OpenSearch dados têm `Group by time interval` campos que são usados para codificar o intervalo ou definir o limite mínimo para a `$__interval` variável usando a `>` sintaxe ->. `>10m` 

### \$1\$1\$1interval\$1ms
<a name="global-variable-interval_ms"></a>

 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\$1name
<a name="global-variable-name"></a>

 Esta variável só está disponível no painel Singlestat e pode ser usada nos campos de prefixo ou sufixo na guia **Opções**. A variável será substituída pelo nome ou alias da série. 

### \$1\$1\$1org
<a name="global-variable-org"></a>

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

### \$1\$1\$1user
<a name="global-variable-user"></a>

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

### \$1\$1\$1range
<a name="global-variable-range"></a>

No momento, esta variável é compatível somente com fontes de dados Prometheus. Essa variável representa o intervalo do dashboard atual. É calculado por `to - from`. Tem representações de milissegundos e segundos denominadas `$__range_ms` e `$__range_s`. 

### \$1timeFilter ou \$1\$1\$1timeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

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

 Esta variável é usada 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. 

## Outras opções de variáveis
<a name="other-variable-options"></a>

Esta seção explica as outras opções de variáveis disponíveis.

### Inserir opções de seleção de variáveis
<a name="enter-variable-selection-options"></a>

Você pode usar as **Opções de seleção** para gerenciar as seleções de opções variáveis. Todas as opções de seleção são opcionais e estão desativadas por padrão. 

#### Vários valores
<a name="multi-value"></a>

Se você ativar esta opção, a lista suspensa de variáveis será compatível com a seleção de várias opções ao mesmo tempo. Para obter mais informações, consulte [Formatação de variáveis de vários valores](#formatting-multi-value-variables). 

#### Incluir todas as opções
<a name="include-all-option"></a>

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

#### Personalizar todos os valores
<a name="custom-all-value"></a>

Esta opção estará visível somente se a **opção Incluir tudo** estiver selecionada. 

Para definir o valor da opção `All`, insira a sintaxe regex, glob ou Lucene no campo **Personalizar todos os valores**. 

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. 

Quando você usa a sintaxe personalizada regex, glob ou Lucene na opção **Personalizar todos os valores**, ela nunca é de escape, então você deve considerar qual é um valor válido para a fonte de dados. 

### Opções avançadas de formato de variáveis
<a name="advanced-variable-format-options"></a>

 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`. Para fazer isso, use as opções avançadas de formatação de variáveis a seguir. 

#### Sintaxe geral
<a name="general-syntax"></a>

 Sintaxe: `${var_name:option}` 

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

#### CSV
<a name="variables-csv"></a>

 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
<a name="distributed---opentsdb"></a>

 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
<a name="doublequote"></a>

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

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

#### Glob - Graphite
<a name="glob---graphite"></a>

 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
<a name="json"></a>

 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 - OpenSearch
<a name="lucene---opensearch"></a>

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

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

#### Percentencode
<a name="percentencode"></a>

 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
<a name="pipe"></a>

 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
<a name="raw"></a>

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

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

#### Regex
<a name="regex"></a>

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

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

#### Singlequote
<a name="singlequote"></a>

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

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

#### Sqlstring
<a name="sqlstring"></a>

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

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

#### Texto
<a name="text"></a>

 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"
```

### Formatação de variáveis de vários valores
<a name="formatting-multi-value-variables"></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 deixar em branco, o Grafana então concatena (soma) todos os valores na consulta. Algo parecido com `value1,value2,value3`. Se um valor `all` personalizado for usado, em vez disso, o valor será algo como `*` ou `all`. 

#### Variáveis de vários valores com uma fonte de dados Graphite
<a name="multi-value-variables-with-a-graphite-data-source"></a>

 O Graphite usa expressões globais. Uma variável com vários valores seria, nesse caso, 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
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

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

#### Variáveis de vários valores com uma fonte de dados elástica
<a name="multi-value-variables-with-an-elastic-data-source"></a>

A Amazon OpenSearch usa a sintaxe de consulta do Lucene, então a mesma variável seria 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 formatação
<a name="formatting-troubles"></a>

 O escape e a formatação automáticos podem causar problemas. Pode ser difícil entender a lógica por trás de um problema, especialmente para InfluxDB e Prometheus, em que o uso da sintaxe regex exige 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, você pode fazer uma das seguintes opções:
+ Desative as opções **Incluir todas as opções** e **Vários valores**.
+ Use o [formato de variável bruta] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1).

### Filtrar variáveis com regex
<a name="filter-variables-with-regex"></a>

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

Esta seção mostra como usar o regex para filtrar e modificar 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 [Expressões regulares](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). 

 Exemplos de filtragem na seguinte lista de opções: 

```
backend_01
backend_02
backend_03
backend_04
```

#### Filtragem para que somente as opções que terminam com `01` ou `02` sejam retornadas
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 Regex: 

```
/.*[01|02]/
```

 Resultado: 

```
backend_01
backend_02
```

#### Filtrar e modificar as opções usando um grupo de captura de regex para retornar parte do texto
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 Regex: 

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

 Resultado: 

```
01
02
```

#### Filtrar e modificar \$1 Exemplo do Prometheus
<a name="filter-and-modify---prometheus-example"></a>

 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
```

 Regex: 

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

 Resultado: 

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

#### Filtrar e modificar usando grupos nomeados de captura de texto e valor
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

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

 Por exemplo, ao consultar a métrica `node_hwmon_chip_names` do Prometheus, `chip_name` é mais amigável do que o valor `chip`. Comece com o resultado da consulta da variável a seguir. 

```
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 regex a seguir. 

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

 A lista suspensa a seguir é produzida. 

```
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
```

 **Observação:** somente nomes de grupos de captura de `text` e `value` são compatíveis. 

### Painéis ou linhas repetidos
<a name="repeat-panels-or-rows"></a>

 Você pode criar dashboards dinâmicos usando *variáveis de modelo*. Todas as variáveis em suas consultas se expandem para o valor atual da variável antes que a consulta seja enviada ao banco de dados. Com variáveis, você pode reutilizar um único dashboard para todos os serviços. 

 Variáveis de modelo podem ser muito úteis para alterar dinamicamente suas consultas em um dashboard inteiro. Se você quiser que o Grafana crie dinamicamente novos painéis ou linhas com base nos valores que você selecionou, você pode usar o recurso *Repetir*. 

#### Painéis repetidos
<a name="repeating-panels"></a>

 Caso tenha uma variável com as opções `Multi-value` ou `Include all value` ativadas, você poderá escolher um painel e fazer com que o Grafana repita esse painel para cada valor selecionado. Você pode encontrar o recurso *Repetir* na *guia Geral* no modo de edição do painel. 

 O `direction` controla como os painéis são organizados. 

Se você escolher`horizontal`, os painéis são organizados side-by-side. O Grafana ajusta automaticamente a largura de cada painel repetido para que toda a linha seja preenchida. Atualmente, você não pode misturar outros painéis em uma linha com um painel repetido. 

 Configure `Max per row` para informar ao Grafana quantos painéis por linha você deseja no máximo. Ele assume *4* como padrão. 

Se você escolher `vertical`, os painéis serão organizados de cima para baixo em uma coluna. A largura dos painéis repetidos é a mesma do primeiro painel (o modelo original) que está sendo repetido. 

Faça alterações somente no primeiro painel (o modelo original). Para que as alterações sejam efetivas em todos os painéis, você precisa iniciar uma reconstrução dinâmica do dashboard. Você pode fazer isso alterando o valor da variável (ou seja, a base para a repetição) ou recarregando o dashboard. 

**nota**  
Painéis repetidos exigem que as variáveis tenham um ou mais itens selecionados. Você não pode repetir um painel zero vez para ocultá-lo.

#### Linhas repetidas
<a name="repeating-rows"></a>

 Conforme visto acima com os painéis, você também poderá repetir as linhas se tiver variáveis definidas com uma opção de seleção `Multi-value` ou `Include all value`. 

 Para ativar esse recurso, você deve primeiro adicionar uma nova *Linha* usando o menu *Adicionar painel*. Em seguida, pause no título da linha e escolha o botão de engrenagem para acessar o painel de configuração `Row Options`. Em seguida, você pode selecionar a variável para a qual deseja repetir a linha. 

 A prática recomendada é usar também uma variável no título da linha. 

# Grafana Alerting
<a name="alerts-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).

O Grafana Alerting fornece alertas robustos e acionáveis que ajudam você a saber mais sobre problemas nos sistemas momentos após a ocorrência, minimizando a interrupção dos serviços.

O Amazon Managed Grafana inclui acesso a um sistema de alertas atualizado, o *Grafana Alerting*, que centraliza as informações dos alertas em uma única visualização pesquisável. Ele inclui os seguintes recursos:
+ Crie e gerencie alertas do Grafana em uma visão centralizada.
+ Crie e gerencie alertas gerenciados pelo Cortex e Loki por meio de uma única interface. Para obter mais informações, consulte [Gerenciar as regras de alertas](v9-alerting-managerules.md).
+ Veja informações de alertas do Prometheus, do Amazon Managed Service for Prometheus e de outras fontes de dados compatíveis com o Alertmanager.
+ Crie várias instâncias de alerta de uma única regra de alerta. Para obter mais informações, consulte [Regras únicas e multidimensionais](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Gerencie seus recursos de alerta com terraform ou provisionamento. APIs Para obter mais informações, consulte [Provisionar recursos do Grafana Alerting](v9-alerting-setup-provision.md).

Para um espaço de trabalho existente do Amazon Managed Grafana, o padrão é [Alertas clássicos do dashboard](old-alerts-overview.md). Para migrar para o Grafana Alerting, você deve [migrar para o Grafana Alerting](alert-opt-in.md).

Para saber mais sobre o Grafana Alerting, consulte [Novidades do Grafana Alerting](alerts-whats-new.md).

O Grafana Alerting tem quatro componentes principais:
+ [Regra de alerta](alert-rules.md): critérios de avaliação que determinam se um alerta é iniciado. Consiste em uma ou mais consultas e expressões, uma condição, a frequência da avaliação e, opcionalmente, a duração durante a qual a condição é atendida.
+ [Ponto de contato](alert-contact-points.md): canal para enviar notificações quando as condições de uma regra de alerta são atendidas. 
+ [Política de notificação](alert-notifications.md): conjunto de critérios de correspondência e agrupamento usado para determinar a frequência das notificações.
+ [Silêncios](alert-silences.md): data e critérios de correspondência usados para silenciar as notificações.

Quando o Grafana Alerting está habilitado, você pode:
+ [Criar regras de alerta gerenciadas pelo Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Criar regras de alerta gerenciadas pelo Cortex ou Loki](alert-rules.md#create-alert-rule)
+ [Visualizar as regras de alerta existentes e gerenciar seu estado atual](alert-rules.md#manage-alert-rules)
+ [Visualizar o estado e a integridade das regras de alerta](alert-fundamentals.md#alerts-state)
+ [Adicionar ou editar um ponto de contato de alerta](alert-contact-points.md#alert-working-contact-points)
+ [Adicionar ou editar políticas de notificação](alert-notifications.md#alert-notifications-working)
+ [Adicionar ou editar silêncios](alert-silences.md)

## Limitações
<a name="alert-limitations"></a>
+ O sistema do Grafana Alerting pode recuperar regras de todas as fontes de dados disponíveis do Amazon Managed Service for Prometheus, Prometheus, Loki e Alertmanager. Talvez não seja possível buscar regras de outras fontes de dados compatíveis.
+ As regras de alerta definidas no Grafana, em vez de no Prometheus, enviam várias notificações ao ponto de contato. Se você estiver usando alertas nativos do Grafana, recomendamos que continue usando os alertas clássicos do dashboard e não habilite o novo recurso de alerta do Grafana. Se você quiser visualizar os alertas definidos na fonte de dados Prometheus, recomendamos que você habilite o Grafana Alerting, que envia somente uma única notificação para alertas criados no Alertmanager do Prometheus.
**nota**  
Essa limitação não é mais uma limitação nos espaços de trabalho do Amazon Managed Grafana compatíveis com o Grafana v10.4 e versões posteriores.

**Topics**
+ [Limitações](#alert-limitations)
+ [Novidades do Grafana Alerting](alerts-whats-new.md)
+ [Migrar alertas clássicos do dashboard para o Grafana Alerting](alert-opt-in.md)
+ [Conceitos básicos do alerta](alert-fundamentals.md)
+ [Criar e gerenciar regras do Grafana Alerting](alert-rules.md)
+ [Grupos de alertas](alert-groups.md)
+ [Silenciar notificações de alerta de fontes de dados do Prometheus](alert-silences.md)
+ [Trabalhar com pontos de contato](alert-contact-points.md)
+ [Usar modelos de mensagens](alert-message-templates.md)
+ [Trabalhar com políticas de notificação](alert-notifications.md)

# Novidades do Grafana Alerting
<a name="alerts-whats-new"></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 Grafana Alerting tem vários aprimoramentos em relação ao alerta clássico do dashboard.

## Criar alertas multidimensionais
<a name="alerts-new-dimensional"></a>

Agora você pode criar uma única regra de alerta que oferece visibilidade em todo o sistema, gerando várias instâncias de alerta de uma única regra de alerta. Por exemplo, você pode criar uma regra para monitorar o uso do disco de vários pontos de montagem em um único host. O mecanismo de avaliação retorna várias séries temporais de uma única consulta, com cada série temporal identificada pelo seu conjunto de rótulos.

**nota**  
Cada instância de alerta conta para a cota de alertas. As regras multidimensionais que criam mais instâncias do que as que podem ser acomodadas na cota de alertas não são avaliadas e retornam um erro de cota. Para obter mais informações, consulte [Cota alcançada de erros](alert-rules.md#rule-quota-reached).

## Criar alertas fora dos dashboards
<a name="alerts-new-not-dashboard"></a>

Ao contrário dos alertas clássicos do dashboard, com o Grafana Alerting, você pode criar consultas e expressões que combinam dados de várias fontes de maneiras exclusivas. Você ainda pode vincular dashboards e painéis às regras de alerta usando seu ID e pode solucionar rapidamente os problemas do sistema sob observação.

Como os alertas unificados não estão mais diretamente vinculados às consultas do painel, eles não incluem imagens ou valores de consulta no e-mail de notificação. Você pode usar modelos de notificação personalizados para visualizar os valores da consulta.

## Criar regras de alerta do Loki e do Cortex
<a name="alerts-new-loki-cortex"></a>

No Grafana Alerting, você pode gerenciar as regras de alerta do Loki e do Cortex usando a mesma interface de usuário e API dos alertas gerenciados pelo Grafana.

## Visualizar e pesquisar alertas do Amazon Managed Service for Prometheus e outras fontes de dados Prometheus compatíveis
<a name="alerts-new-prometheus"></a>

Os alertas das fontes de dados Amazon Managed Service for Prometheus e Prometheus compatíveis agora estão listados na interface de alertas. Você pode pesquisar rótulos em várias fontes de dados para encontrar rapidamente alertas relevantes.

## Alertas especiais para estado de alerta NoData e erro
<a name="alerts-new-error"></a>

O Grafana Alerting gera alertas especiais que têm os seguintes rótulos, quando a avaliação de uma regra de alerta produz um estado `NoData` ou `Error`:
+ `alertname` com o valor `DatasourceNoData` ou `DatasourceError`, dependendo do estado.
+ `rulename` com o nome da regra de alerta à qual o alerta especial pertence.
+ `datasource_uid` tem o UID da fonte de dados que causou o estado.
+ Todos os rótulos e anotações da regra original.

Você pode lidar com esses alertas da mesma forma como lida com os alertas regulares, por exemplo, adicionando um silêncio ou roteamento para um ponto de contato.

**nota**  
Se a regra usar várias fontes de dados e uma ou mais não retornarem dados, o alerta especial será criado para cada fonte de dados que causou o estado de alerta.

# Migrar alertas clássicos do dashboard para o Grafana Alerting
<a name="alert-opt-in"></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).

Espaços de trabalho existentes, ou espaços de trabalho que optam por não usar o Grafana Alerting, usam o alerta clássico do dashboard. Para migrar para o novo Grafana Alerting, primeiro é necessário escolher o recurso.

Você pode configurar sua instância do Amazon Managed Grafana para usar alertas do Grafana usando o Console de gerenciamento da AWS, o AWS CLI ou a API Amazon Managed Grafana. Para obter detalhes sobre como configurar o Amazon Managed Grafana, incluindo ativar ou desativar o Grafana Alerting, consulte [Configurar um espaço de trabalho do Amazon Managed Grafana](AMG-configure-workspace.md).

**nota**  
Ao usar o Grafana Alerting, as regras de alerta definidas no Grafana, em vez de no Prometheus, enviam várias notificações para o seu ponto de contato. Se você estiver usando alertas nativos do Grafana, recomendamos que continue usando os alertas clássicos do dashboard e não habilite o novo recurso de alerta do Grafana. Se você quiser visualizar os alertas definidos na fonte de dados Prometheus, recomendamos que você habilite o Grafana Alerting, que envia somente uma única notificação para alertas criados no Alertmanager do Prometheus.  
Essa limitação foi removida dos espaços de trabalho do Amazon Managed Grafana compatíveis com o Grafana v10.4 e versões posteriores.

## Migrar para o sistema do Grafana Alerting
<a name="alert-opt-in-migrating"></a>

Quando o Grafana Alerting está ativado, os alertas clássicos existentes do dashboard migram em um formato compatível com o Grafana Alerting. Na página de alertas da instância do Grafana, você pode visualizar os alertas migrados junto com os novos alertas. Com o Grafana Alerting, as regras de alerta gerenciadas pelo Grafana enviam várias notificações em vez de um único alerta quando são correspondidas.

O acesso de leitura e gravação aos alertas clássicos do dashboard e aos alertas do Grafana é regido pelas permissões das pastas que os armazenam. Durante a migração, as permissões clássicas de alerta do dashboard são correspondidas com as novas permissões de regras da seguinte forma:
+ Se o dashboard do alerta original tiver permissões, a migração criará uma pasta nomeada com este formato `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` para corresponder às permissões do dashboard original (incluindo as permissões herdadas da pasta).
+ Se não houver permissões no dashboard e ele estiver em uma pasta, a regra será vinculada a essa pasta e herdará suas permissões.
+ Se não houver permissões no dashboard e ele estiver na pasta Geral, a regra será vinculada à pasta Alertas gerais e ela herdará as permissões padrão.

**nota**  
Como não há a opção de `Keep Last State` para alertas `NoData` no Grafana, essa opção passa a ser `NoData` durante a migração das regras clássicas. A opção `Keep Last State` de tratamento de `Error` é migrada para uma nova opção `Error`. Para corresponder ao comportamento do `Keep Last State`, em ambos os casos, durante a migração, o Amazon Managed Grafana cria automaticamente um silêncio para cada regra de alerta com duração de um ano.

Os canais de notificação são migrados para uma configuração do Alertmanager com as rotas e os receptores apropriados. Os canais de notificação padrão são adicionados como pontos de contato à rota padrão. Canais de notificação não associados a nenhum alerta do dashboard seguem a rota `autogen-unlinked-channel-recv`.

### Limitações
<a name="alert-migration-limitations"></a>
+ O sistema do Grafana Alerting pode recuperar regras de todas as fontes de dados disponíveis do Prometheus, Loki e Alertmanager. Talvez não seja possível obter regras de alerta de outras fontes de dados compatíveis.
+ A migração de ida e volta entre os alertas do Grafana e o alerta clássico do dashboard pode resultar na perda de dados dos recursos compatíveis em um sistema, mas não no outro.
**nota**  
Caso migre de volta para o alerta clássico do dashboard, você perderá todas as alterações realizadas na configuração de alertas definida enquanto o Grafana Alerting estava ativado, incluindo todas as novas regras de alerta criadas.

# Conceitos básicos do alerta
<a name="alert-fundamentals"></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).

Esta seção fornece informações sobre os conceitos básicos do Grafana Alerting.

## Conceitos de alertas
<a name="alert-fundamentals-terms"></a>

A tabela a seguir descreve os principais conceitos do Grafana Alerting.


| Principal conceito ou recurso | Definição | 
| --- | --- | 
|  Fontes de dados para alertas  |  Selecione as fontes de dados das quais você deseja consultar e visualizar métricas, logs e rastreamentos.  | 
|  Agendador  |  Avalia as regras de alerta; o componente que periodicamente executa consultas em fontes de dados. É aplicável apenas às regras gerenciadas pelo Grafana.  | 
|  Alertmanager  |  Gerencia o roteamento e o agrupamento de instâncias de alertas.  | 
|  Regra de alerta  |  Um conjunto de critérios de avaliação para quando uma regra de alerta deve ser acionada. Uma regra de alerta consiste em uma ou mais consultas e expressões, uma condição, a frequência da avaliação e a duração em que a condição é atendida. Uma regra de alerta pode produzir várias instâncias de alertas.  | 
|  Instância de alerta  |  Uma instância de alerta é uma instância de uma regra de alerta. Uma regra de alerta unidimensional tem uma instância de alerta. Uma regra de alerta multidimensional tem uma ou mais instâncias de alertas. Uma única regra de alerta que corresponda a vários resultados, como CPU contra 10 VMs, é contabilizada como várias (neste caso, 10) instâncias de alerta. Esse número pode variar com o tempo. Por exemplo, uma regra de alerta que monitora o uso da CPU para todos VMs em um sistema tem mais instâncias de alerta à medida que VMs são adicionadas. Para obter mais informações sobre cotas de instâncias de alertas, consulte [Cota alcançada de erros](alert-rules.md#rule-quota-reached).  | 
|  Grupo de alertas  |  O Alertmanager agrupa instâncias de alertas por padrão usando os rótulos da política de notificação raiz. Isso controla a eliminação de duplicação e os grupos de instâncias de alertas que são enviadas aos pontos de contato.  | 
|  Ponto de contato  |  Defina como seus contatos são notificados quando uma regra de alerta é acionada.  | 
|  Modelos de mensagens  |  Crie modelos personalizados reutilizáveis e use-os em pontos de contato.  | 
|  Política de notificação  |  Conjunto de regras para onde, quando e como os alertas são agrupados e roteados para os pontos de contato.  | 
|  Rótulos e matchers de rótulos  |  Os rótulos identificam de forma exclusiva as regras de alertas. Eles vinculam as regras de alertas a silêncios e políticas de notificação, determinando qual política deve lidar com eles e quais regras de alerta devem ser silenciadas.  | 
|  Silêncios  |  Interrompa as notificações de uma ou mais instâncias de alerta. A diferença entre tempo de silêncio e de desativação de áudio é que o silêncio dura por uma janela de tempo específica, e a desativação de áudio acontece em uma programação recorrente. Usa matcher de rótulos para silenciar instâncias de alertas.  | 
|  Tempos de desativação de áudio  |  Especifique um intervalo de tempo em que você não deseja que novas notificações sejam geradas ou enviadas. Você pode congelar as notificações de alerta por períodos recorrentes, como durante um período de manutenção. Deve estar vinculado a uma política de notificação existente.  | 

## Fontes de dados de alertas
<a name="alert-sources"></a>

Os alertas gerenciados pelo Grafana consultam as fontes de dados de backend a seguir que têm os alertas habilitados.
+ Fontes de dados integradas ou desenvolvidas e mantidas pelo Grafana: `Alertmanager`, `Graphite`, `Prometheus` (incluindo o Amazon Managed Service for Prometheus), `Loki`, `InfluxDB`, `Amazon OpenSearch Service`, `Google Cloud Monitoring`, `Amazon CloudWatch`, `Azure Monitor`, `MySQL`, `PostgreSQL`, `MSSQL`, `OpenTSDB`, `Oracle` e `Azure Monitor`.

## Alertas sobre dados numéricos
<a name="alert-numeric"></a>

Os dados numéricos que não estão em um formato de série temporal podem ser alertados diretamente ou passados para as expressões do servidor. Isso permite mais processamento e eficiência resultante na fonte de dados, além de simplificar as regras de alertas. Ao alertar sobre dados numéricos em vez de dados de séries temporais, não há necessidade de reduzir cada série temporal rotulada em um único número. Em vez disso, os números rotulados são retornados para o Grafana.

### Dados tabulares
<a name="alert-tabular-data"></a>

Esse recurso é compatível com fontes de dados de backend que consultam dados tabulares, incluindo fontes de dados de SQL, como MySQL, Postgres, MSSQL e Oracle.

Uma consulta com alertas gerenciados pelo Grafana ou expressões do servidor é considerada numérica com estas fontes de dados:
+ Se a opção `Format AS` estiver definida como `Table` na consulta da fonte de dados.
+ Se a resposta da tabela retornada ao Grafana da consulta incluir apenas uma coluna numérica (por exemplo, int, double ou float) e, opcionalmente, colunas de string adicionais.

Se houver colunas de string, essas colunas se tornarão rótulos. O nome da coluna torna-se o nome do rótulo, e o valor de cada linha torna-se o valor do rótulo correspondente. Se várias linhas forem retornadas, cada linha deverá ser identificada exclusivamente por seus rótulos.

### Exemplo
<a name="alert-tabular-example"></a>

Se você tiver uma tabela MySQL chamada Diskspace, como a seguir.


| Hora | Host | Disk | PercentFree | 
| --- | --- | --- | --- | 
|  7 de junho de 2021  |  web1  |  /etc  |  3  | 
|  7 de junho de 2021  |  web2  |  /var  |  4  | 
|  7 de junho de 2021  |  web3  |  /var  |  8  | 
|  …  |  …  |  …  |  …  | 

Você pode consultar a filtragem de dados a tempo, mas sem retornar a série temporal ao Grafana. Por exemplo, veja abaixo um alerta que seria iniciado por host, disco quando houvesse menos de 5% de espaço livre.

```
SELECT Host, Disk, CASE WHEN PercentFree < 5.0 THEN PercentFree ELSE 0 END FROM (
  SELECT
      Host,
      Disk,
      Avg(PercentFree)
  FROM DiskSpace
  Group By
    Host,
    Disk
  Where __timeFilter(Time)
```

Essa consulta retorna a resposta de tabela a seguir ao Grafana.


| Host | Disk | PercentFree | 
| --- | --- | --- | 
|  web1  |  /etc  |  3  | 
|  web2  |  /var  |  4  | 
|  web3  |  /var  |  0  | 

Quando essa consulta é usada como **condição** em uma regra de alerta, então os casos em que o valor for diferente de zero alertarão. Como resultado, três instâncias de alerta são produzidas, conforme a tabela a seguir.


| Rótulos | Status | 
| --- | --- | 
|  \$1Host=web1,disk=/etc\$1  |  Geração de alertas  | 
|  \$1Host=web2,disk=/var\$1  |  Geração de alertas  | 
|  \$1Host=web3,disk=/var\$1  |  Normal  | 

## Alertmanager
<a name="alert-alertmanager"></a>

O Grafana inclui suporte integrado para o Alertmanager do Prometheus. O Alertmanager ajuda a agrupar e gerenciar as regras de alertas, adicionando uma camada de orquestração sobre os mecanismos de alertas. Por padrão, as notificações dos alertas gerenciados pelo Grafana são executados pelo Alertmanager incorporado, que faz parte do núcleo do Grafana. Você pode configurar os pontos de contato, as políticas de notificação e os modelos do Alertmanager na interface de usuário do Grafana Alerting selecionando a opção Grafana no menu suspenso do Alertmanager.

O Grafana Alerting é compatível com a configuração externa do Alertmanager (para obter mais informações sobre o Alertmanager como fonte de dados externa, consulte [Conectar-se a uma fonte de dados Alertmanager](data-source-alertmanager.md)). Quando você adiciona um Alertmanager externo, o menu suspenso dele mostra uma lista de fontes de dados externas disponíveis do Alertmanager. Selecione uma fonte de dados para criar e gerenciar alertas para fontes de dados autônomas do Cortex ou Loki.

## Estado e integridade das regras de alertas
<a name="alerts-state"></a>

O estado e a integridade das regras de alertas ajudam você a entender vários indicadores-chave de status sobre os alertas. Há três componentes principais: estado do alerta, estado da regra do alerta e integridade da regra do alerta. Embora estejam relacionados, cada componente fornece informações ligeiramente diferentes.

**Estado da regra do alerta**
+ **Normal**: nenhuma das séries temporais retornadas pelo mecanismo de avaliação está em um estado `Pending` ou `Firing`.
+ **Pendente**: pelo menos uma das séries temporais retornadas pelo mecanismo de avaliação está no estado `Pending`.
+ **Disparado**: pelo menos uma das séries temporais retornadas pelo mecanismo de avaliação está no estado `Firing`.

**Estado do alerta**
+ **Normal**: a condição da regra do alerta é **false** para cada série temporal retornada pelo mecanismo de avaliação.
+ **Alerta**: a condição da regra do alerta é **true** para pelo menos uma série temporal retornada pelo mecanismo de avaliação. A duração durante a qual a condição deve ser true antes que um alerta seja iniciado, se a definição tiver sido atendida ou excedido.
+ **Pendente**: a condição da regra do alerta é **true** para pelo menos uma série temporal retornada pelo mecanismo de avaliação. A duração durante a qual a condição deve ser true antes que um alerta seja iniciado, se a definição não tiver sido atendida.
+ **NoData**— A regra de alerta não retornou uma série temporal, todos os valores da série temporal são nulos ou todos os valores da série temporal são zero.
+ **Erro**: erro ao tentar avaliar uma regra do alerta.

**Integridade da regra do alerta**
+ **Ok**: nenhum erro ao avaliar uma regra do alerta.
+ **Erro**: erro ao avaliar uma regra do alerta.
+ **NoData**— A ausência de dados em pelo menos uma série temporal retornada durante a avaliação de uma regra.

# Criar e gerenciar regras do Grafana Alerting
<a name="alert-rules"></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 regra de alerta é um conjunto de critérios de avaliação que determina se um alerta é iniciado. A regra consiste em uma ou mais consultas e expressões, uma condição, a frequência da avaliação e, opcionalmente, a duração durante a qual a condição é atendida.

Enquanto consultas e expressões selecionam o conjunto de dados a ser avaliado, uma condição define o limite que um alerta deve atingir ou exceder para criar um alerta. Um intervalo especifica com que frequência uma regra de alerta é avaliada. A duração, quando configurada, indica por quanto tempo uma condição deve ser atendida. As regras também podem definir o comportamento de alertas na ausência de dados.

As seções a seguir descrevem a criação e o gerenciamento de diferentes tipos de regras de alerta do Grafana.

**Topics**
+ [Criar regras de alerta gerenciadas pelo Cortex ou Loki](#create-alert-rule)
+ [Criar regras de gravação gerenciadas pelo Cortex ou Loki](#create-alert-recording-rule)
+ [Criar regras de alertas gerenciadas pelo Grafana](#create-grafana-alert-rule)
+ [Anotações e rótulos para regras de alerta](#alert-rule-labels)
+ [Gerenciar regras de alertas](#manage-alert-rules)
+ [Namespaces e grupos de regras do Cortex ou Loki](#alert-rule-groups)

## Criar regras de alerta gerenciadas pelo Cortex ou Loki
<a name="create-alert-rule"></a>

Usando o Grafana, você pode criar regras de alerta para uma instância externa do Cortex ou do Loki.

**nota**  
O Cortex é o banco de dados de séries temporais usado pelas fontes de dados Amazon Managed Service for Prometheus e Prometheus.

**Pré-requisitos**
+ Verifique se você tem permissões de escrita na fonte de dados Prometheus. Do contrário, você não poderá criar ou atualizar as regras de alerta gerenciadas do Cortex.
+ Para as fontes de dados Cortex e Loki, ative a API Ruler configurando seus respectivos serviços.
  + **Loki**: o tipo de armazenamento `local` de regras, padrão para a fonte de dados Loki, é compatível apenas com a visualização de regras. Para editar regras, configure um dos outros tipos de armazenamento.
  + **Cortex**: use o prefixo `/api/prom` legado, não `/prometheus`. A fonte de dados Prometheus é compatível com o Cortex e o Prometheus, e o Grafana espera que a API Query e a API Ruler estejam no mesmo URL. Você não pode fornecer um URL separado para a API Ruler.

**nota**  
Se você não quiser gerenciar as regras de alerta para uma fonte de dados Loki ou Prometheus específica, acesse as configurações e desmarque a caixa de seleção **Gerenciar alertas por meio da interface de usuário de alertas**.

**Para adicionar uma regra de alerta gerenciada pelo Cortex ou Loki**

1. No console do Grafana, no menu Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas** listando os existentes.

1. Escolha **Nova regra de alerta**.

1. Na **Etapa 1**, adicione o nome, o tipo e o local de armazenamento da regra, da seguinte forma:
   + Em **Nome da regra**, adicione um nome descritivo. Esse nome é exibido na lista de regras de alerta. Também é o rótulo `alertname` de cada instância de alerta criada dessa regra.
   + No menu suspenso **Tipo de regra**, selecione **Alerta gerenciado pelo Cortex ou Loki**.
   + No menu suspenso **Selecionar fonte de dados**, selecione uma fonte de dados Prometheus ou Loki.
   + No menu suspenso **Namespace**, selecione um namespace de regra existente. Do contrário, escolha **Adicionar novo** e insira um nome para criar um. Os namespaces podem conter um ou mais grupos de regras e ter apenas uma finalidade organizacional. Para obter mais informações, consulte [Namespaces e grupos de regras do Cortex ou Loki](#alert-rule-groups).
   + No menu suspenso **Grupo**, selecione um grupo existente no namespace selecionado. Do contrário, escolha **Adicionar novo** e insira um nome para criar um. As regras recém-criadas são anexadas ao final do grupo. As regras em um grupo são executadas sequencialmente em intervalos regulares, com o mesmo tempo de avaliação.

1. Na **Etapa 2**, adicione a consulta a ser avaliada.

   O valor pode ser uma expressão PromQL ou LogQL. A regra iniciará um alerta se o resultado da avaliação tiver pelo menos uma série com um valor maior que 0. Um alerta é criado para cada série.

1. Na **Etapa 3**, adicione as condições.

   Na caixa de texto Por da condição, especifique por quanto tempo a condição deve ser true antes que o alerta seja iniciado. Se você especificar `5m`, as condições deverão ser true por cinco minutos antes que o alerta seja iniciado.
**nota**  
Depois que uma condição é atendida, o alerta entra no estado `Pending`. Se a condição permanecer ativa pelo período especificado, o alerta mudará para o estado `Firing`. Se não for mais satisfeito, ele reverterá para o estado `Normal`.

1. Na **Etapa 4**, adicione outros metadados associados à regra.
   + Adicione uma descrição e um resumo para personalizar as mensagens de alerta. Use as diretrizes em [Anotações e rótulos para regras de alerta](#alert-rule-labels).
   + Adicione URL, painel, painel e alerta IDs do Runbook.
   + Adicione rótulos personalizados.

1. Escolha **Pré-visualizar alertas** para avaliar a regra e ver quais alertas ela vai produzir. Essa opção vai exibir uma lista de alertas com o estado e o valor de cada um.

1. Escolha **Salvar** para salvar a regra, ou **Salvar e sair** para salvar a regra e voltar para a página **Alertas**.

## Criar regras de gravação gerenciadas pelo Cortex ou Loki
<a name="create-alert-recording-rule"></a>

Você pode criar e gerenciar regras de gravação para uma instância externa do Cortex ou do Loki. As regras de gravação calculam expressões frequentemente necessárias ou computacionalmente caras e salvam os resultados como um novo conjunto de séries temporais. Consultar essa nova série temporal é mais rápida, especialmente para dashboards, pois eles consultam a mesma expressão toda vez que os dashboards são atualizados.

**Pré-requisitos**

Para as fontes de dados Cortex e Loki, ative a API Ruler configurando seus respectivos serviços.
+ **Loki**: o tipo de armazenamento `local` de regras, padrão para a fonte de dados Loki, é compatível apenas com a visualização de regras. Para editar regras, configure um dos outros tipos de armazenamento.
+ **Córtex**: ao configurar uma fonte de dados Prometheus do Grafana para apontar para o Cortex, use o prefixo `/api/prom` legado, não `/prometheus`. A fonte de dados Prometheus é compatível com o Cortex e o Prometheus, e o Grafana espera que a API Query e a API Ruler estejam no mesmo URL. Você não pode fornecer um URL separado para a API Ruler.

**nota**  
Se você não quiser gerenciar as regras de alertas para uma fonte de dados Loki ou Prometheus específica, acesse as configurações e desmarque a caixa de seleção **Gerenciar alertas por meio da interface de usuário de alertas**.

**Para adicionar uma regra de gravação gerenciada pelo Cortex ou Loki**

1. No console do Grafana, no menu Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas** listando os existentes.

1. Escolha **Nova regra de alerta**.

1. Na **Etapa 1**, adicione o nome, o tipo e o local de armazenamento da regra, conforme a seguir.
   + Em **Nome da regra**, adicione um nome descritivo. Esse nome é exibido na lista de regras de alerta. Também é o rótulo `alertname` de cada instância de alerta criada dessa regra.
   + No menu suspenso **Tipo de regra**, selecione **Alerta gerenciado pelo Cortex ou Loki**.
   + No menu suspenso **Selecionar fonte de dados**, selecione uma fonte de dados Prometheus ou Loki.
   + No menu suspenso **Namespace**, selecione um namespace de regra existente. Do contrário, escolha **Adicionar novo** e insira um nome para criar um. Os namespaces podem conter um ou mais grupos de regras e ter apenas uma finalidade organizacional. Para obter mais informações, consulte [Namespaces e grupos de regras do Cortex ou Loki](#alert-rule-groups).
   + No menu suspenso **Grupo**, selecione um grupo existente no namespace selecionado. Do contrário, escolha **Adicionar novo** e insira um nome para criar um. As regras recém-criadas são anexadas ao final do grupo. As regras em um grupo são executadas sequencialmente em intervalos regulares, com o mesmo tempo de avaliação.

1. Na **Etapa 2**, adicione a consulta a ser avaliada.

   O valor pode ser uma expressão PromQL ou LogQL. A regra iniciará um alerta se o resultado da avaliação tiver pelo menos uma série com um valor maior que 0. Um alerta é criado para cada série.

1. Na **Etapa 3**, adicione outros metadados associados à regra.
   + Adicione uma descrição e um resumo para personalizar as mensagens de alerta. Use as diretrizes em [Anotações e rótulos para regras de alerta](#alert-rule-labels).
   + Adicione URL, painel, painel e alerta IDs do Runbook.
   + Adicione rótulos personalizados.

1. Escolha **Salvar** para salvar a regra, ou **Salvar e sair** para salvar a regra e voltar para a página **Alertas**.

## Criar regras de alertas gerenciadas pelo Grafana
<a name="create-grafana-alert-rule"></a>

O Grafana permite criar regras de alertas que consultam uma ou mais fontes de dados, reduzem ou transformam os resultados e os comparam ou fixam limites. Quando eles são processados, o Grafana envia notificações para o ponto de contato.

**nota**  
Criar regras de alerta gerenciadas do Grafana ao usar o Grafana Alerting faz com que várias notificações sejam enviadas quando a regra é correspondida. Alguns provedores de pontos de contato podem ter opções configuráveis para desduplicar as notificações.

**Para adicionar uma regra gerenciada do Grafana**

1. No console do Grafana, no menu Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas** listando os existentes.

1. Escolha **Nova regra de alerta**.

1. Na **Etapa 1**, adicione o nome, o tipo e o local de armazenamento da regra, da seguinte forma:
   + Em **Nome da regra**, adicione um nome descritivo. Esse nome é exibido na lista de regras de alerta. Também é o rótulo `alertname` de cada instância de alerta criada dessa regra.
   + No menu suspenso **Tipo de regra**, selecione **Alerta gerenciado pelo Grafana**.
   + No menu suspenso **Pasta**, selecione a pasta em que você deseja armazenar a regra. Se você não selecionar uma pasta, a regra será armazenada na pasta `General`. Para criar uma pasta, selecione a lista suspensa e insira um nome para a pasta.

1. Na **Etapa 2**, adicione as consultas e expressões a serem avaliadas.
   + Mantenha o nome padrão ou passe o mouse sobre ele e escolha o ícone de edição para alterar o nome.
   + Para consultas, selecione uma fonte de dados no menu suspenso.
   + Adicione uma ou mais [consultas](panel-queries.md) ou expressões (para obter detalhes sobre expressões, consulte [Expressões](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) na *documentação do Grafana*.
   + Para cada expressão, selecione a **condição Clássica** para criar uma única regra de alerta, ou escolha entre as opções **Matemática**, **Redução** e **Reamostragem** para gerar alertas separados para cada série. Para obter detalhes sobre essas opções, consulte [Regras únicas e multidimensionais](#single-multi-rule).
   + Escolha **Executar consultas** para verificar se a consulta teve êxito.

1. Na **Etapa 3**, adicione as condições.
   + No menu suspenso **Condição**, selecione a consulta ou a expressão para iniciar a regra de alerta.
   + Em **Avaliar a cada**, especifique a frequência da avaliação. Deve ser um múltiplo de dez segundos. Por exemplo, `1m`, `30s`.
   + Em **Avaliar por**, especifique por quanto tempo a condição deve ser true antes que um alerta seja iniciado.
**nota**  
Depois que uma condição é violada, o alerta entra no estado `Pending`. Se a condição permanecer violada pelo período especificado, o alerta mudará para o estado `Firing`. Se não for mais satisfeito, ele reverterá para o estado `Normal`.
   + Em **Configurar tratamento de erros e ausência de dados**, configure o comportamento dos alertas na ausência de dados. Use as diretrizes em [Lidar com casos de erro e ausência de dados](#rule-no-data-error).
   + Escolha **Pré-visualizar alertas** para verificar o resultado da execução da consulta no momento. A pré-visualização exclui as condições de tratamento de erros e ausência de dados.

1. Na **Etapa 4**, adicione outros metadados associados à regra.
   + Adicione uma descrição e um resumo para personalizar as mensagens de alerta. Use as diretrizes em [Anotações e rótulos para regras de alerta](#alert-rule-labels).
   + Adicione URL, painel, painel e alerta IDs do Runbook.
   + Adicione rótulos personalizados.

1. Escolha **Salvar** para salvar a regra, ou **Salvar e sair** para salvar a regra e voltar para a página **Alertas**.

### Regras únicas e multidimensionais
<a name="single-multi-rule"></a>

Para as regras de alerta gerenciadas pelo Grafana, você pode criar uma regra com uma condição clássica ou uma regra multidimensional.

**Regra unidimensional (condição clássica)**

Use uma expressão de condição clássica para criar uma regra que inicia um único alerta quando sua condição é atendida. Para uma consulta que retorna várias séries, o Grafana não rastreia o estado de alerta de cada série. Como resultado, o Grafana envia apenas um único alerta, mesmo quando as condições de alerta são atendidas para várias séries.

Para obter mais informações sobre como formatar expressões, consulte [Expressões](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) na *documentação do Grafana*.

**Regra multidimensional**

Para gerar uma instância de alerta separada para cada série retornada na consulta, crie uma regra multidimensional.

**nota**  
Cada instância de alerta gerada por uma regra multidimensional conta para sua cota total de alertas. As regras não são avaliadas quando você atinge sua cota de alertas. Para obter mais informações sobre cotas para regras multidimensionais, consulte [Cota alcançada de erros](#rule-quota-reached).

Para criar várias instâncias de uma única regra, use as expressões `Math`, `Reduce` ou `Resample` para criar uma regra multidimensional. Por exemplo, você pode:
+ Adicione uma expressão `Reduce` para cada consulta para agregar valores no intervalo de tempo selecionado em um único valor. (não é necessário para [regras que usam dados numéricos](alert-fundamentals.md#alert-numeric)).
+ Adicione uma expressão `Math` com a condição para a regra. Isso não é necessário no caso de uma consulta ou uma expressão de redução já retornar 0 se a regra não iniciar um alerta, ou um número positivo se ela precisar iniciar um alerta. 

  Alguns exemplos: 
  + `$B > 70`se ele deve iniciar um alerta caso o valor de B query/expression seja maior que 70. 
  + `$B < $C * 100` caso deva iniciar um alerta se o valor de B for menor que o valor de C multiplicado por 100. Se as consultas que estão sendo comparadas tiverem várias séries em seus resultados, as séries de consultas diferentes serão correspondidas se tiverem os mesmos rótulos, ou se uma for um subconjunto da outra.

**nota**  
O Grafana não é compatível com consultas de alerta com variáveis de modelo. Mais informações estão disponíveis na página [Template variables are not supported in alert queries while setting up Alert](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) da comunidade.



**Considerações de performance para regras multidimensionais**

Cada instância de alerta conta para a cota de alertas. As regras multidimensionais que criam mais instâncias do que as que podem ser acomodadas na cota de alertas não são avaliadas e retornam um erro de cota. Para obter mais informações, consulte [Cota alcançada de erros](#rule-quota-reached).

Os alertas multidimensionais podem ter um alto impacto na performance do espaço de trabalho do Grafana, bem como na performance das fontes de dados, pois o Grafana os consulta para avaliar as regras de alertas. As considerações a seguir podem ser úteis quando você está tentando otimizar a performance do sistema de monitoramento.
+ **Frequência da avaliação da regra**: a propriedade **Avaliar a cada** de uma regra de alerta controla a frequência da avaliação da regra. Recomendamos usar a menor frequência de avaliação aceitável. 
+ **Cardinalidade do conjunto de resultados**: o número de instâncias de alerta que você cria com uma regra afeta a performance. Suponha que você esteja monitorando os erros de resposta da API para cada caminho de API, em cada VM na sua frota. Esse conjunto tem uma cardinalidade do número de caminhos multiplicado pelo número de. VMs Você pode reduzir a cardinalidade do conjunto de resultados, por exemplo, monitorando o total de erros por VM em vez de por caminho por VM.
+ **Complexidade da consulta**: consultas que as fontes de dados podem processar e responder rapidamente consomem menos recursos. Embora essa consideração seja menos importante do que as outras listadas acima, se você as reduziu ao máximo, observar a performance de consultas individuais pode fazer a diferença. Você também deve estar ciente do impacto na performance que a avaliação dessas regras tem nas fontes de dados. As consultas de alerta geralmente são a grande maioria das consultas tratadas pelos bancos de dados de monitoramento, portanto, os mesmos fatores de carga que afetam a instância do Grafana também as afetam.

### Cota alcançada de erros
<a name="rule-quota-reached"></a>

Há uma cota para o número de instâncias de alerta que você pode ter em um único espaço de trabalho. Ao atingir esse número, você não poderá mais criar regras de alerta nesse espaço de trabalho. Com alertas multidimensionais, o número de instâncias de alerta pode variar com o tempo.

É importante lembrar os aspectos a seguir ao trabalhar com instâncias de alerta.
+ Se você criar somente regras unidimensionais, cada regra será uma única instância de alerta. Você pode criar, no máximo, o mesmo número de regras em um único espaço de trabalho que sua cota de instâncias de alerta.
+ Regras multidimensionais criam várias instâncias de alerta, no entanto, o número não é conhecido até que sejam avaliadas. Por exemplo, se você criar uma regra de alerta que rastreia o uso da CPU de suas instâncias do Amazon EC2, poderá haver 50 instâncias do EC2 quando você a criar (e, portanto, 50 instâncias de alerta), mas se você adicionar mais 10 instâncias do EC2 uma semana depois, a próxima avaliação terá 60 instâncias de alerta.

  O número de instâncias de alerta é avaliado quando você cria um alerta multidimensional, e você não pode criar um que coloque você logo acima da cota de instâncias de alerta. Como o número de instâncias de alerta pode mudar, sua cota é verificada sempre que as regras são avaliadas.
+ No momento da avaliação da regra, se uma regra fizer com que você ultrapasse sua cota para instâncias de alerta, essa regra não será avaliada até que uma atualização seja feita na regra de alerta que coloque a contagem total de instâncias de alerta abaixo da cota de serviço. Quando isso acontece, você recebe uma notificação de alerta informando que sua cota foi atingida (a notificação usa a política de notificação da regra que está sendo avaliada). A notificação inclui uma anotação de `Error` com o valor `QuotaReachedError`.
+ Uma regra que faz com que um `QuotaReachedError` pare de ser avaliado. A avaliação só é retomada quando uma atualização é feita e a avaliação após a atualização não causa, por si só, um `QuotaReachedError`. Uma regra que não está sendo avaliada mostra o erro de **Cota atingida** no console do Grafana.
+ Você pode reduzir o número de instâncias de alerta removendo as regras de alerta ou editando alertas multidimensionais para ter menos instâncias de alerta (por exemplo, ter um alerta sobre erros por VM, em vez de um alerta sobre erros por API em uma VM).
+ Para retomar as avaliações, atualize o alerta e salve-o. Você pode atualizá-lo para diminuir o número de instâncias de alerta ou, se tiver feito outras alterações para diminuir o número de instâncias de alerta, poderá salvá-lo sem alterações. Se puder ser retomado, ele será. Se isso causar outro `QuotaReachedError`, você não poderá salvá-lo.
+ Quando um alerta é salvo e retoma a avaliação sem ultrapassar a cota de alertas, o erro **Cota atingida** pode continuar sendo exibido no console do Grafana por algum tempo (até o intervalo de avaliação). No entanto, a avaliação da regra de alerta é iniciada e os alertas serão enviados se o limite da regra for atingido.
+ Para obter detalhes sobre a cota de alertas, bem como outras cotas, consulte [Cotas de serviço do Amazon Managed Grafana](AMG_quotas.md).

### Lidar com casos de erro e ausência de dados
<a name="rule-no-data-error"></a>

Escolha opções de como lidar com o comportamento de alertas na ausência de dados ou quando há erros.

As opções para lidar com a ausência de dados são listadas na tabela a seguir.


| Opção de ausência de dados | Comportamento | 
| --- | --- | 
|  Nenhum dado  |  Crie um alerta `DatasourceNoData` com o nome e o UID da regra de alerta e o UID da fonte de dados que não retornou dados como rótulos.  | 
|  Geração de alertas  |  Defina o estado da regra do alerta como `Alerting`.  | 
|  OK  |  Defina o estado da regra do alerta como `Normal`.  | 

As opções para lidar com casos de erro são listadas na tabela a seguir.


| Opção de erro ou tempo limite | Comportamento | 
| --- | --- | 
|  Geração de alertas  |  Defina o estado da regra do alerta como `Alerting`  | 
|  OK  |  Defina o estado da regra do alerta como `Normal`  | 
|  Erro  |  Crie um alerta `DatasourceError` com o nome e o UID da regra de alerta e o UID da fonte de dados que não retornou dados como rótulos.  | 

## Anotações e rótulos para regras de alerta
<a name="alert-rule-labels"></a>

Anotações e rótulos são pares de chave/valor associados a alertas provenientes da regra de alerta, da resposta da fonte de dados e como resultado da avaliação da regra de alerta. Eles podem ser usados diretamente em notificações de alerta ou em [modelos](alert-message-templates.md) e [funções de modelo](alert-message-templates.md#alert-template-functions) para criar contatos de notificação dinamicamente.

**Anotações**

As anotações são pares de chave/valor que fornecem informações adicionais sobre um alerta. Você pode usar as seguintes anotações: `description`, `summary`, `runbook_url`, `alertId`, `dashboardUid` e `panelId`. Elas são exibidas em detalhes de regras e alertas na interface do usuário e podem ser usadas em modelos de mensagens de pontos de contato.

**Rótulos**

Os rótulos são pares de chave/valor que contêm informações sobre um alerta. O rótulo definido para um alerta é gerado e adicionado em todo o processo de avaliação e notificação de alertas. Eles são usados das formas a seguir.
+ O conjunto completo de rótulos para um alerta identifica exclusivamente esse alerta nos alertas do Grafana.
+ O Alertmanager usa rótulos para corresponder alertas a [silêncios](alert-silences.md) e [grupos de alertas](alert-groups.md) nas [políticas de notificação](alert-notifications.md).
+ A interface do usuário de alertas exibe rótulos para cada instância de alerta gerada pela avaliação dessa regra.
+ Os pontos de contato podem acessar rótulos para gerar notificações dinamicamente que contêm informações específicas do alerta que está resultando em uma notificação.
+ Os rótulos podem ser adicionados a uma [regra de alerta](#alert-rules). Esses rótulos configurados manualmente podem usar funções de modelo e referenciar outros rótulos. Os rótulos adicionados a uma regra de alerta aqui têm precedência no caso de um conflito entre os rótulos.

As variáveis de modelo a seguir estão disponíveis ao expandir anotações e rótulos.


| Name (Nome) | Description | 
| --- | --- | 
|  `$labels`  |  Os rótulos da consulta ou condição. Por exemplo, `{{ $labels.instance }}` e `{{ $labels.job }}`. Isso não está disponível quando a regra usa uma condição clássica.  | 
|  `$values`  |  Os valores de todas as expressões de redução e matemáticas que foram avaliadas para essa regra de alerta. Por exemplo, `{{ $values.A }}`, `{{ $values.A.Labels }}` e `{{ $values.A.Value }}`, em que `A` é o `refID` da expressão. Isso não está disponível quando a regra usa uma condição clássica.  | 
|  `$value`  |  A string valores da instância de alerta. Por exemplo, .`[ var='A' labels={instance=foo} value=10 ]`  | 

## Gerenciar regras de alertas
<a name="manage-alert-rules"></a>



A página **Alertas** lista as regras de alerta. Por padrão, as regras são agrupadas por tipos de fontes de dados. A seção **Grafana** lista as regras gerenciadas pelo Grafana, e a seção **Cortex/Loki** lista as regras para fontes de dados compatíveis com o Prometheus. Você pode visualizar as regras de alerta para fontes de dados compatíveis com o Prometheus, mas não pode editá-las.

### Visualizar regras de alertas
<a name="manage-alerts-view"></a>

Ao usar o Grafana Alerting, você pode visualizar todos os alertas em uma página.

**Para visualizar detalhes de alertas**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**. Por padrão, as regras são exibidas em grupos por tipo de fonte de dados. Você também pode visualizar pelo estado atual de cada alerta (eles são descritos com mais detalhes no texto a seguir).

1. Em **Visualizar como**, você pode alternar entre as visualizações de grupo e estado escolhendo a opção de sua preferência.

1. Escolha a seta ao lado de uma linha para exibir mais detalhes dessa linha. Os detalhes de uma regra incluem anotações, fontes de dados, consultas e rótulos de regras, bem como uma lista de instâncias de alerta resultantes da regra.

**Visualização Grupo**

A visualização Grupo mostra as regras de alerta do Grafana agrupadas por pasta e as regras de alerta do Loki ou Prometheus agrupadas por `namespace` \$1 `group`. Esta é a visualização padrão da lista de regras, destinada ao gerenciamento de regras. Você pode expandir cada grupo para ver uma lista de regras dele. Expanda ainda mais uma regra para visualizar os detalhes. Você também pode expandir os botões de ação e os alertas resultantes da regra para ver os detalhes.

**Visualização Estado**

A visualização Estado mostra as regras de alerta agrupadas por estado. Use essa visualização para ter uma visão geral de quais regras estão em qual estado. Cada regra pode ser expandida para visualizar seus detalhes. Botões de ação e quaisquer alertas gerados por essa regra, e cada alerta pode ser expandido ainda mais para exibir seus detalhes.

**Filtrar regras de alerta**

Você pode filtrar as regras de alerta que aparecem na página **Alertas** de diversas formas.
+ Você pode filtrar para exibir as regras que consultam uma fonte de dados específica escolhendo **Selecionar fontes de dados** e selecionando uma fonte de dados para a qual filtrar.
+ Você pode filtrar por rótulos escolhendo os critérios de pesquisa em **Pesquisar por rótulo**. Alguns critérios de amostra incluem `environment=production`, `region=~US|EU`, `severity!=warning`.
+ Você pode filtrar para exibir as regras em um estado específico escolhendo **Filtrar alertas por estado**, e depois selecionando o estado que deseja visualizar.

### Editar ou excluir regras de alerta
<a name="manage-alerts-edit"></a>

As regras de alerta gerenciadas do Grafana só podem ser editadas ou excluídas por usuários com permissões de edição para a pasta que armazena as regras. As regras de alerta para uma instância externa do Cortex ou do Loki podem ser editadas ou excluídas por usuários com funções de editor ou administrador.

**Para editar ou excluir uma regra**

1. Expanda uma regra até ver os controles de regra para **Visualizar**, **Editar** e **Excluir**.

1. Escolha **Editar** para abrir a página de criação de regras. Faça atualizações da mesma forma como ao criar uma regra. Para obter detalhes, consulte as instruções em [Criar regras de alertas gerenciadas pelo Grafana](#create-grafana-alert-rule) ou [Criar regras de alerta gerenciadas pelo Cortex ou Loki](#create-alert-rule).

1. Opcionalmente, escolha **Excluir** para excluir uma regra.

## Namespaces e grupos de regras do Cortex ou Loki
<a name="alert-rule-groups"></a>

Você pode organizar as regras. As regras são criadas dentro de grupos de regras, e os grupos de regras são organizados em namespaces. As regras dentro de um grupo de regras são executadas sequencialmente em intervalos regulares. O intervalo padrão é de um minuto. Você pode renomear namespaces e grupos de regras do Cortex ou Loki e editar intervalos de avaliação de grupos de regras.

**Para editar um namespace ou grupo de regras**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Navegue até uma regra no namespace ou no grupo de regras que você deseja editar.

1. Selecione o ícone de **Editar** (caneta).

1. Faça alterações no grupo de regras ou no namespace.
**nota**  
Para namespaces, você só pode editar o nome. Para grupos de regras, você altera o nome ou o intervalo de avaliação das regras no grupo. Por exemplo, você pode escolher `1m` para avaliar as regras a cada minuto ou `30s` para avaliar a cada 30 segundos.

1. Escolha **Salvar alterações**.

# Grupos de alertas
<a name="alert-groups"></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 grupos de alertas mostram alertas agrupados de uma instância do Alertmanager. Por padrão, os alertas são agrupados pelas chaves de rótulo da política raiz em [Trabalhar com políticas de notificação](alert-notifications.md). O agrupamento de alertas comuns em um único grupo de alertas evita que alertas duplicados sejam iniciados.

**Para visualizar agrupamentos de alertas**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) e depois o item de **Agrupamento de alertas** para abrir a página que lista os grupos existentes.

1. No menu suspenso do **Alertmanager**, selecione um Alertmanager externo como a fonte de dados. Por padrão, o Alertmanager do `Grafana` está selecionado.

1. No menu suspenso de **grupo personalizado por**, selecione uma combinação de rótulos para visualizar um agrupamento diferente do padrão. Você pode usar essa visualização para depurar ou verificar o agrupamento de políticas de notificação.

Alertas sem rótulos especificados no agrupamento da política raiz ou no agrupamento personalizado são adicionados a um grupo com um cabeçalho de `No grouping`.

**Filtrar alertas**

Você pode usar os seguintes filtros para visualizar alertas que correspondam a critérios específicos:
+ **Pesquisar por rótulo**: em **Pesquisar**, insira uma rótulo existente para ver alertas que correspondam ao rótulo. Por exemplo, `environment=production`, `region=~US|EU`, `severity!=warning`.
+ **Filtrar alertas por estado**: em **Estados**, selecione dos estados `Active`, `Suppressed` ou `Unprocessed` para visualizar alertas neles.

# Silenciar notificações de alerta de fontes de dados do Prometheus
<a name="alert-silences"></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 fontes de dados externas do Alertmanager (incluindo o Amazon Managed Service for Prometheus), você pode suprimir as notificações de alerta com um *silêncio*. Um silêncio só impede a criação de notificações: os silêncios não impedem que as regras de alerta sejam avaliadas e não impedem que as instâncias de alerta sejam mostradas na interface do usuário. Ao silenciar um alerta, você especifica uma janela de tempo para que ele seja suprimido.

Você pode configurar silêncios para uma fonte de dados externa do Alertmanager.

**nota**  
Para suprimir as notificações de alerta em intervalos regulares (por exemplo, durante períodos regulares de manutenção), use [Tempos de desativação de áudio](alert-notifications.md#alert-notification-muting) em vez de silêncios.

**Para adicionar um silêncio**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Escolha **Silêncios** para abrir uma página listando os [pontos de contato](alert-contact-points.md) existentes.

1. Escolha o Alertmanager externo no menu suspenso **Alertmanager**.

1. Selecione **Novo silêncio**.

1. Selecione a data de início e de término em **Início e término do silêncio** para indicar quando o silêncio deve entrar em vigor e quando deve terminar.

   Como alternativa à definição de um horário de término, em **Duração**, especifique por quanto tempo o silêncio será aplicado. Isso atualiza automaticamente a hora de término no campo **Início e término do silêncio**.

1. Nos campos **Nome** e **Valor**, insira um ou mais *rótulos correspondentes*. Os matchers determinam a quais regras o silêncio se aplica. A correspondência do rótulo é discutida em mais detalhes após este procedimento.

1. Opcionalmente, adicione um **comentário** ou modifique o **Criador** para definir o proprietário do silêncio.

**Correspondência de rótulos para supressão de alertas**

Ao criar um silêncio, você cria um conjunto de *rótulos correspondentes* como parte do silêncio. Esse é um conjunto de regras sobre rótulos que devem corresponder para que o alerta seja suprimido. Os rótulos correspondentes consistem em três partes:
+ **Rótulo**: o nome do rótulo correspondente. Ele deve corresponder exatamente ao nome do rótulo do alerta.
+ **Operador**: o operador usado para comparar o valor do rótulo com o valor do rótulo correspondente. Os operadores disponíveis são:
  + `=` Selecione rótulos cujo valor corresponda exatamente à string fornecida.
  + `!=` Selecione rótulos cujo valor não corresponda à string fornecida.
  + `=~` Selecione rótulos cujo valor corresponda ao valor interpretado pelo regex da string fornecida (a string fornecida é interpretada como uma expressão regular).
  + `!=` Selecione rótulos que não correspondam à expressão regular fornecida.
+ **Valor**: o valor ao qual corresponder ao valor do rótulo. Pode corresponder como uma string ou como uma expressão regular, dependendo do operador escolhido.

O silêncio termina na data de término indicada, mas você pode encerrar manualmente a supressão a qualquer momento.

**Para finalizar um silêncio manualmente**

1. Na página **Alertas**, escolha **Silêncios** para ver a lista de silêncios existentes.

1. Selecione o silêncio que você deseja encerrar e escolha **Cancelar silêncio**. Isso encerra a supressão do alerta.
**nota**  
O cancelamento do silêncio encerra a supressão do alerta, como se o horário de término estivesse definido para o horário atual. Os silêncios que terminaram (automática ou manualmente) são retidos e listados por cinco dias. Você não pode remover um silêncio da lista manualmente.

**Criar um link para o formulário de criação de silêncio**

Você pode criar uma URL para o formulário de criação de silêncio com os detalhes já preenchidos. Os operadores podem usar isso para suprimir rapidamente um alarme durante um evento operacional.

Ao criar um link para um formulário de silêncio, use um parâmetro de consulta `matchers` para especificar os rótulos correspondentes e um parâmetro de consulta `comment` para especificar um comentário. O parâmetro `matchers` requer um ou mais valores no formulário `[label][operator][value]`, separados por vírgulas.

**Exemplo de URL**

Para criar um link para um formulário de silêncio, com os rótulos correspondentes `severity=critical` e`cluster!~europe-.*`, com um comentário que diga `Silencing critical EU alerts`, use um URL como a seguir. *mygrafana*Substitua pelo nome do host da sua instância Grafana.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Para vincular a uma nova página de silêncio para um Alertmanager externo, adicione um parâmetro de consulta `alertmanager` com o nome da fonte de dados Alertmanager, como `alertmanager=myAlertmanagerdatasource`.

# Trabalhar com pontos de contato
<a name="alert-contact-points"></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).

Use pontos de contato para definir como os contatos serão notificados quando um alerta for iniciado. Um ponto de contato pode ter um ou mais tipos de pontos de contato, por exemplo, Amazon Simple Notification Service ou Slack. Quando um alerta é iniciado, uma notificação é enviada para todos os tipos de pontos de contato listados para um ponto de contato. Opcionalmente, use [Usar modelos de mensagens](alert-message-templates.md) para personalizar as mensagens de notificação para os tipos de ponto de contato.

**nota**  
Você pode criar e editar pontos de contato para alertas gerenciados pelo Grafana. Os pontos de contato dos alertas do Alertmanager são somente leitura.

## Trabalhar com pontos de contato
<a name="alert-working-contact-points"></a>

Os procedimentos a seguir detalham como adicionar, editar, testar e excluir pontos de contato.

**Para adicionar um ponto de contato**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Escolha **Pontos de contato** e, em seguida, **Novo ponto de contato**.

1. No menu suspenso do **Alertmanager**, selecione um Alertmanager. O Grafana Alertmanager é selecionado por padrão.

1. Insira um **Nome** para o ponto de contato.

1. Em **Tipo de ponto de contato**, escolha um tipo e os campos obrigatórios com base nesse tipo. Por exemplo, se você escolher o Slack, insira os canais e os usuários do Slack que devem ser contatados.

1. Se disponível para o ponto de contato selecionado, opcionalmente, escolha as **configurações opcionais** para especificar configurações adicionais.

1. Em **Configurações de notificação**, selecione opcionalmente **Desabilitar mensagem resolvida** se não quiser ser notificado quando um alerta for resolvido.

1. Se o seu ponto de contato precisar de mais tipos de pontos de contato, você pode escolher **Novo tipo de ponto de contato** e repetir as etapas para cada tipo de ponto de contato necessário.

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

**Para editar um ponto de contato**

1. Escolha **Pontos de contato** para ver uma lista dos pontos de contato existentes.

1. Selecione o ponto de contato a ser editado e, em seguida, escolha o ícone de **Editar** (caneta).

1. Faça as alterações necessárias e escolha **Salvar ponto de contato** para salvar as alterações.

Depois que seu ponto de contato for criado, você poderá enviar uma notificação de teste para verificar se ele está configurado corretamente.

**Para enviar uma notificação de teste**

1. Escolha **Pontos de contato** para abrir a lista de pontos de contato existentes.

1. Selecione o ponto de contato a ser testado e, em seguida, escolha o ícone de **Editar** (caneta).

1. Selecione o ícone de **Teste** (avião de papel).

1. Escolha se deseja enviar uma notificação de teste predefinida ou escolha **Personalizado** para adicionar suas próprias anotações e rótulos personalizados na notificação de teste.

1. Escolha **Enviar notificação de teste** para testar o alerta com os pontos de contato fornecidos.

Você pode excluir pontos de contato que não estão sendo usados por uma política de notificação.

**Para excluir um ponto de contato**

1. Escolha **Pontos de contato** para abrir a lista de pontos de contato existentes.

1. Selecione o ponto de contato a ser excluído e escolha o ícone de **Excluir** (lixeira).

1. Na caixa de diálogo de confirmação, escolha **Sim, excluir**.

**nota**  
Se o ponto de contato estiver sendo usado por uma política de notificação, você deverá excluir ou editar a política de notificação para usar outro ponto de contato antes de excluí-lo.

## Lista de notificadores compatíveis
<a name="alert-supported-notifiers"></a>


|  Nome  |  Tipo  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| PagerDuty  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Usar modelos de mensagens
<a name="alert-message-templates"></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 notificações enviadas via [Trabalhar com pontos de contato](alert-contact-points.md) são criadas usando *modelos de mensagens*. Os modelos padrão do Grafana são baseados no [sistema de modelos do Go](https://golang.org/pkg/text/template), em que alguns campos são avaliados como texto, enquanto outros são avaliados como HTML (o que pode afetar o escape).

Como a maioria dos campos de ponto de contato pode ser modelada, você pode criar modelos personalizados reutilizáveis e usá-los em vários pontos de contato. O tópico [Dados do modelo](#alert-template-data) lista as variáveis que estão disponíveis para modelos.

**Usar modelos**

Os modelos são usados para criar uma mensagem. Por exemplo, com uma mensagem de alerta do Slack, você pode definir o título e o corpo no ponto de contato. O exemplo a seguir mostra como usar modelos padrão para criar um título que contém uma contagem de alertas disparados e resolvidos e um corpo que lista os alertas e seus status.
+ **Título**:

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **Corpo do texto**: 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

Você pode criar seus próprios modelos personalizados, como no exemplo a seguir.
+ **Título**:

  ```
  {{ template "slack.default.title" .}}
  ```
+ **Corpo do texto**: 

  ```
  {{ template "mymessage" .}}
  ```

Veja a seguir um modelo de exemplo.

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Os procedimentos a seguir mostram como criar, editar e excluir modelos personalizados de mensagens.

**Para criar um modelo de mensagem**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Escolha **Pontos de contato**.

1. No menu suspenso do **Alertmanager**, selecione a instância do Alertmanager para a qual você deseja criar um modelo de mensagem. O padrão é o Grafana Alertmanager.

1. Escolha **Adicionar modelo**.

1. Adicione um **Nome** descritivo.

1. Adicione o **Conteúdo** do modelo, por exemplo:

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   A tag `define` na seção Conteúdo atribui o nome do modelo. Essa tag é opcional e, quando omitida, o nome do modelo é derivado do campo **Nome**. Quando ambos são especificados, é uma prática recomendada mantê-los iguais.

1. Selecione **Salvar modelo**.

**nota**  
O HTML nos modelos de mensagens de alerta é renderizado como texto, com os caracteres de controle de escape. A renderização de HTML na notificação resultante não é compatível com o Grafana.

**Para editar um modelo de mensagem**

1. Na página **Alertas**, escolha **Pontos de contato** para abrir a lista de pontos de contato.

1. Na **tabela Modelo**, encontre o modelo que você deseja editar e escolha o ícone de **Editar** (caneta).

1. Faça suas alterações e escolha **Salvar modelo**.

**Para excluir um modelo de mensagem**

1. Na página **Alertas**, escolha **Pontos de contato** para abrir a lista de pontos de contato.

1. Na **tabela Modelo**, encontre o modelo que você deseja remover e escolha o ícone de **Excluir** (lixeira).

1. Escolha **Sim, excluir** para excluir o modelo.

**Modelos aninhados**

Você pode incorporar modelos em outros modelos.

Por exemplo, você pode definir um fragmento de modelo usando a palavra-chave `define`:

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Você pode então incorporar modelos personalizados nesse fragmento usando a palavra-chave `template`. Por exemplo:

```
Alert summary:
{{ template "mytemplate" . }}
```

Você pode usar as opções a seguir de modelo incorporado para incorporar modelos personalizados.


| Nome | Observações | 
| --- | --- | 
|  `default.title`  |  Exibe informações de status de alto nível.  | 
|  `default.message`  |  Fornece um resumo formatado dos alertas disparados e resolvidos.  | 

**Exemplos de modelos personalizados**

Aqui estão alguns exemplos de como usar modelos personalizados.

Modelo para renderizar um único alerta:

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Modelo para renderizar toda a mensagem de notificação:

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## Dados do modelo
<a name="alert-template-data"></a>

Os dados a seguir são passados para os modelos de mensagem.


| Nome | Tipo | Observações | 
| --- | --- | --- | 
|  `Receiver`  |  string  |  Nome do ponto de contato para o qual a notificação está sendo enviada.  | 
|  `Status`  |  string  |  disparado se pelo menos um alerta estiver sendo disparado, caso contrário, resolvido.  | 
|  `Alerts`  |  Alerta  |  Lista de objetos de alerta incluídos nessa notificação (veja abaixo).  | 
|  `GroupLabels`  |  KeyValue  |  Rótulos pelos quais esses alertas foram agrupados.  | 
|  `CommonLabels`  |  KeyValue  |  Rótulos comuns a todos os alertas incluídos nessa notificação.  | 
|  `CommonAnnotations`  |  KeyValue  |  Anotações comuns a todos os alertas incluídos nessa notificação.  | 
|  `ExternalURL`  |  string  |  Link de retorno para o Grafana que enviou a notificação. Se estiver usando o Alertmanager externo, volte para ele.  | 

O tipo `Alerts` expõe duas funções para filtrar os alertas retornados.
+ `Alerts.Firing`: retorna uma lista de alertas disparados.
+ `Alerts.Resolved`: retorna uma lista de alertas resolvidos.

**Alerta (tipo)**

O tipo de alerta contém os dados a seguir.


| Nome | Tipo | Observações | 
| --- | --- | --- | 
|  Status  |  string  |  `firing` ou `resolved`.  | 
|  Rótulos  |  KeyValue  |  Um conjunto de rótulos anexados ao alerta.  | 
|  Anotações  |  KeyValue  |  Um conjunto de anotações anexadas ao alerta.  | 
|  StartsAt  |  time.Time  |  Hora em que o alerta começou a disparar.  | 
|  EndsAt  |  time.Time  |  Definido somente se a hora de término de um alerta for conhecida. Caso contrário, defina um período de tempo limite configurável a partir do momento em que o último alerta foi recebido.  | 
|  GeneratorURL  |  string  |  Um link de retorno para o Grafana ou para o Alertmanager externo.  | 
|  SilenceURL  |  string  |  Link para a funcionalidade de silêncio por do Grafana com rótulos para esse alerta pré-preenchidos. Somente para alertas gerenciados pelo Grafana.  | 
|  DashboardURL  |  string  |  Link para o dashboard do Grafana, se a regra de alerta pertencer a um. Somente para alertas gerenciados pelo Grafana.  | 
|  PanelURL  |  string  |  Link para o painel do dashboard do Grafana, se a regra de alerta pertencer a um. Somente para alertas gerenciados pelo Grafana.  | 
|  Impressão digital  |  string  |  Impressão digital que pode ser usada para identificar o alerta.  | 
|  ValueString  |  string  |  Uma string que contém os rótulos e o valor de cada expressão reduzida no alerta.  | 

**KeyValue tipo**

O `KeyValue` tipo é um conjunto de pares de key/value strings que representam rótulos e anotações.

Além do acesso direto aos dados armazenados como um `KeyValue`, também existem métodos para classificar, remover e transformar os dados.


| Nome | Argumentos | Retornos | Observações | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  Lista ordenada de pares de strings de chave e valor  |    | 
|  Remover  |  []string  |  KeyValue  |  Retorna uma cópia do Key/Value mapa sem as chaves fornecidas.  | 
|  Nomes  |    |  []string  |  Lista de nomes de rótulos  | 
|  Valores  |    |  []string  |  Lista de valores de rótulos  | 



## Funções de modelo
<a name="alert-template-functions"></a>

Ao usar funções de modelo, você pode processar rótulos e anotações para gerar notificações dinâmicas. As funções a seguir estão disponíveis.


| Nome | Tipo de argumento | Tipo de retorno | Description | 
| --- | --- | --- | --- | 
|  `humanize`  |  número ou string  |  string  |  Converte um número em um formato mais legível, usando prefixos de métricas.  | 
|  `humanize1024`  |  número ou string  |  string  |  Como o humanize, mas usa 1024 como base em vez de 1000.  | 
|  `humanizeDuration`  |  número ou string  |  string  |  Converte uma duração em segundos em um formato mais legível.  | 
|  `humanizePercentage`  |  número ou string  |  string  |  Converte um valor de proporção em uma fração de 100.  | 
|  `humanizeTimestamp`  |  número ou string  |  string  |  Converte um carimbo de data e hora do Unix em segundos em um formato mais legível.  | 
|  `title`  |  string  |  string  |  strings.Title, coloca em maiúscula o primeiro caractere de cada palavra.  | 
|  `toUpper`  |  string  |  string  |  cordas. ToUpper, converte todos os caracteres em maiúsculas.  | 
|  `toLower`  |  string  |  string  |  cordas. ToLower, converte todos os caracteres em minúsculas.  | 
|  `match`  |  padrão, texto  |  booleano  |  regexp. MatchString Testes para uma correspondência de expressão regular não ancorada.  | 
|  `reReplaceAll`  |  padrão, substituição, texto  |  string  |  Regexp. ReplaceAllString Substituição Regexp, não ancorada.  | 
|  `graphLink`  |  string: objeto JSON com os campos `expr` e `datasource`  |  string  |  Retorna o caminho para a visualização gráfica no Explore para a expressão e a fonte de dados fornecidas.  | 
|  `tableLink`  |  string: objeto JSON com os campos `expr` e `datasource`  |  string  |  Retorna o caminho para a visualização tabular no Explore para a expressão e a fonte de dados fornecidas.  | 
|  `args`  |  []interface\$1\$1  |  map[string]interface\$1\$1  |  Converte uma lista de objetos em um mapa com chaves, por exemplo, arg0, arg1. Use essa função para passar vários argumentos para modelos.  | 
|  `externalURL`  |  nothing  |  string  |  Retorna uma string representando o URL externo.  | 
|  `pathPrefix`  |  nothing  |  string  |  Retorna o caminho do URL externo.  | 

A tabela a seguir mostra exemplos do uso de cada função.


| Função | TemplateString | Input | Esperados | 
| --- | --- | --- | --- | 
|  humanize  |  \$1 humanize \$1value \$1  |  1234567,0  |  1,235M  | 
|  humanize1024  |  \$1 humanize1024 \$1value \$1  |  1048576,0  |  1Mi  | 
|  humanizeDuration  |  \$1 humanizeDuration \$1value \$1  |  899,99  |  14m 59s  | 
|  humanizePercentage  |  \$1 humanizePercentage \$1value \$1  |  0,1234567  |  12,35%  | 
|  humanizeTimestamp  |  \$1 humanizeTimestamp \$1value \$1  |  1435065584.128  |  2015-06-23 13:19:44.128 \$10000 UTC  | 
|  título  |  \$1 \$1value \$1 title \$1  |  aa bB CC  |  Aa Bb Cc  | 
|  toUpper  |  \$1 \$1value \$1 toUpper \$1  |  aa bB CC  |  AA BB CC  | 
|  toLower  |  \$1 \$1value \$1 toLower \$1  |  aa bB CC  |  aa bb cc  | 
|  match  |  \$1 match "a\$1" \$1labels.instance \$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll “localhost :( .\$1)” “meu.domínio: \$11" \$1labels.instance\$1\$1  |  localhost:3000  |  my.domain:3000  | 
|  graphLink  |  \$1\$1 graphLink "\$1\$1"expr\$1": \$1"up\$1", \$1"datasource\$1": \$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true\$1]  | 
|  tableLink  |  \$1\$1 tableLink "\$1\$1"expr\$1":\$1"up\$1", \$1"datasource\$1":\$1"gdev-prometheus\$1"\$1" \$1\$1  |    |  /explore?left=["now-1h","now","gdev-prometheus",\$1"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false\$1]  | 
|  args  |  \$1\$1define "x"\$1\$1\$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1\$1\$1end\$1\$1\$1\$1template "x" (args 1 "2")\$1\$1  |    |  1 2  | 
|  externalURL  |  \$1 externalURL \$1  |    |  http://localhost/path/prefix  | 
|  pathPrefix  |  \$1 pathPrefix \$1  |    |  /path/prefix  | 

# Trabalhar com políticas de notificação
<a name="alert-notifications"></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 políticas de notificação determinam como os alertas são roteados para os pontos de contato. As políticas têm uma estrutura em árvore, em que cada política pode ter uma ou mais políticas secundárias. Cada política, exceto a política raiz, também pode corresponder a rótulos de alerta específicos. Cada alerta é avaliado pela política raiz e depois por cada política secundária. Se você habilitar a opção `Continue matching subsequent sibling nodes` para uma política específica, a avaliação continuará mesmo após uma ou mais correspondências. As configurações de uma política principal e as informações do ponto de contato controlam o comportamento de um alerta que não corresponde a nenhuma das políticas secundárias. Uma política raiz controla qualquer alerta que não corresponda a uma política específica.

**nota**  
Você pode criar e editar políticas de notificação para alertas gerenciados pelo Grafana. As políticas de notificação para alertas do Alertmanager são somente leitura.

**Notificações de agrupamento**

O agrupamento categoriza as notificações de alerta de natureza semelhante em um único funil. Isso permite que você controle as notificações de alerta durante interrupções maiores, quando muitas partes de um sistema falham ao mesmo tempo, fazendo com que um grande número de alertas seja iniciado simultaneamente.

**Exemplo de agrupamento**

Suponha que você tenha cem serviços conectados a um banco de dados em diferentes ambientes. Esses serviços são diferenciados pelo rótulo `env=environmentname`. Existe uma regra de alerta para monitorar se os serviços podem acessar o banco de dados. A regra de alerta cria alertas denominados `alertname=DatabaseUnreachable`.

Se ocorrer uma partição de rede, em que metade dos serviços não consiga mais acessar o banco de dados, 50 alertas diferentes serão iniciados. Para essa situação, você deseja receber uma notificação de uma única página (em vez de 50) com uma lista dos ambientes afetados.

Você pode configurar o agrupamento para ser `group_by: [alertname]` (sem usar o rótulo `env`, que é diferente para cada serviço). Com essa configuração em vigor, o Grafana envia uma única notificação compacta que contém todos os ambientes afetados por essa regra de alerta.

**Grupos especiais**

O Grafana tem dois grupos especiais. O grupo padrão, `group_by: null` agrupa *todos* os alertas em um único grupo. Você também pode usar um rótulo especial denominado `...` para agrupar alertas por todos os rótulos, desabilitando efetivamente o agrupamento e enviando cada alerta para seu próprio grupo.

## Trabalhar com notificações
<a name="alert-notifications-working"></a>

Os procedimentos a seguir mostram como criar e gerenciar políticas de notificação.

**Para editar a política de notificação raiz**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Escolha **Políticas de notificação**.

1. No menu suspenso do **Alertmanager**, selecione o Alertmanager que deseja editar.

1. Na seção **Política raiz**, escolha o ícone de **Editar** (caneta).

1. Em **Ponto de contato padrão**, atualize o ponto de contato para o qual as notificações devem ser enviadas para as regras quando as regras de alerta não corresponderem a nenhuma política específica.

1. Em **Agrupar por**, escolha os rótulos (ou grupos especiais) pelos quais agrupar os alertas.

1. Em **Opções de tempo**, selecione uma das opções a seguir.
   + **Espera em grupo**: tempo de espera para armazenar em buffer alertas do mesmo grupo antes de enviar uma notificação inicial. O padrão é 30 segundos.
   + **Intervalo de grupo**: intervalo mínimo de tempo entre duas notificações para um grupo. O padrão é 5 minutos.
   + **Intervalo de repetição**: intervalo mínimo de tempo antes de reenviar uma notificação, caso nenhum novo alerta tenha sido adicionado ao grupo. O padrão é quatro horas.

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

**Para adicionar uma nova política específica de alto nível**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Escolha **Políticas de notificação**.

1. No menu suspenso do **Alertmanager**, selecione o Alertmanager que deseja editar.

1. Na seção **Roteamento específico**, escolha **Nova política específica**.

1. Na seção **Rótulos correspondentes**, adicione um ou mais rótulos de alerta correspondentes. Veja outras informações sobre correspondência de rótulos mais adiante neste tópico.

1. Em **Ponto de contato**, adicione o ponto de contato para o qual enviar notificações se o alerta corresponder a essa política específica. As políticas aninhadas substituem esse ponto de contato.

1. Opcionalmente, selecione **Substituir agrupamento** para especificar um agrupamento diferente da política raiz.

1. Opcionalmente, selecione **Substituir tempos gerais** para substituir as opções de tempo na política de notificação de grupo.

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

**Para adicionar uma política aninhada**

1. Expanda a política específica na qual você deseja criar uma política aninhada.

1. Escolha **Adicionar política aninhada** e, em seguida, adicione os detalhes (como ao adicionar uma política específica de nível superior).

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

**Para editar uma política específica**

1. Na página **Alertas**, escolha **Políticas de notificação** para abrir a página que lista as políticas existentes.

1. Selecione a política que deseja editar e depois escolha o ícone de **Editar** (caneta).

1. Faça qualquer alteração (como ao adicionar uma política específica de nível superior).

1. Escolha **Salvar política**.

**Como funciona a correspondência de rótulos**

Uma política corresponderá a um alerta se os rótulos do alerta corresponderem a todos os *rótulos correspondentes* especificados na política.
+ **Rótulo**: o nome do rótulo correspondente. Ele deve corresponder exatamente ao nome do rótulo do alerta.
+ **Operador**: o operador usado para comparar o valor do rótulo com o valor do rótulo correspondente. Os operadores disponíveis são:
  + `=` Selecione rótulos cujo valor corresponda exatamente à string fornecida.
  + `!=` Selecione rótulos cujo valor não corresponda à string fornecida.
  + `=~` Selecione rótulos cujo valor corresponda ao valor interpretado pelo regex da string fornecida (a string fornecida é interpretada como uma expressão regular).
  + `!=` Selecione rótulos que não correspondam à expressão regular fornecida.
+ **Valor**: o valor ao qual corresponder ao valor do rótulo. Pode corresponder como uma string ou como uma expressão regular, dependendo do operador escolhido.

## Tempos de desativação de áudio
<a name="alert-notification-muting"></a>

O tempo de desativação de áudio é um intervalo de tempo recorrente em que nenhuma nova notificação de uma política é gerada ou enviada. Use-o para evitar que os alertas sejam disparados por um período específico e recorrente, por exemplo, um período de manutenção regular.

Assim como os silêncios, os tempos de desativação de áudio não impedem que as regras de alerta sejam avaliadas nem impedem que as instâncias de alerta sejam mostradas na interface do usuário. Eles apenas impedem que as notificações sejam criadas.

Você pode configurar os tempos de desativação de áudio gerenciados do Grafana bem como os horários de desativação de áudio para uma fonte de dados externa do Alertmanager.

**Tempos de desativação de áudio em comparação com silêncios**

A tabela a seguir destaca as diferenças entre tempos de silêncio e de desativação de áudio.


| Tempo de desativação de áudio | Silêncio | 
| --- | --- | 
|  Usa definições de intervalo de tempo que podem ocorrer novamente  |  Tem um horário de início e término fixo  | 
|  É criado e, em seguida, adicionado às políticas de notificação  |  Usa rótulos para fazer correspondência com um alerta para determinar se deve ser silenciado ou não  | 

**Para criar um tempo de desativação de áudio**

1. No console do Grafana, no menu do Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas**.

1. Escolha **Políticas de notificação**.

1. No menu suspenso do **Alertmanager**, selecione o Alertmanager que deseja editar.

1. Na seção **Tempos de desativação de áudio**, escolha o botão **Adicionar tempo de desativação de áudio**.

1. Escolha o intervalo de tempo para o qual você deseja aplicar o tempo de desativação de áudio.

1. Escolha **Enviar** para criar um tempo de desativação de áudio.

**Para adicionar um tempo de desativação de áudio a uma política de notificação**

1. Selecione a política de notificação à qual você gostaria de adicionar o tempo de desativação de áudio e escolha o botão **Editar**.

1. No menu suspenso **Tempos de desativação de áudio**, selecione os tempos de desativação de áudio que você gostaria de adicionar à política.

   Escolha o botão **Salvar política**.

**Intervalos de tempo**

Um intervalo de tempo é uma definição para um período de tempo. Se um alerta for iniciado durante esse intervalo, ele será suprimido. Os períodos são compatíveis usando `:` (por exemplo, `monday:thursday`). Um tempo de desativação de áudio pode conter vários intervalos de tempo. Um intervalo de tempo consiste em vários campos (detalhes na lista a seguir), todos os quais devem coincidir para suprimir os alertas. Por exemplo, se você especificar os dias da semana `monday:friday` e o intervalo de tempo das 8h às 9h, os alertas serão suprimidos das 8h às 9h, de segunda a sexta-feira, mas não, por exemplo, das 8h às 9h no sábado.
+ **Intervalo de tempo**: a hora do dia para suprimir as notificações. Consiste em dois subcampos, **Hora de início** e **Hora de término**. Um tempo de exemplo é `14:30`. A hora está em notação de 24 horas, em UTC.
+ **Dias da semana**: os dias da semana. Pode ser um único dia, como `monday`, um período, como `monday:friday`, ou uma lista de dias separada por vírgula, como `monday, tuesday, wednesday`.
+ **Meses**: os meses a serem selecionados. Você pode especificar os meses com designações numéricas ou com o nome completo do mês, por exemplo, `1` ou `january`, ambos especificam janeiro. Você pode especificar um único mês, um intervalo de meses ou uma lista de meses separada por vírgula.
+ **Dias do mês**: as datas em um mês. Os valores de podem variar de `1` a `31`. Valores negativos especificam os dias do mês na ordem inversa, então `-1` representa o último dia do mês. Os dias do mês podem ser especificados como um único dia, um intervalo de dias ou uma lista de dias separada por vírgula.