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

# 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 que suportam a versão 12.x do Grafana, consulte. [Trabalhando na versão 12 do Grafana](using-grafana-v12.md)  
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. 

### Built-in consulta
<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)