

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

# Anotar as visualizações
<a name="v9-panels-annotate-visualizations"></a>

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

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

**Anotações nativas**

O Grafana vem com um armazenamento de anotações nativas e a capacidade de adicionar eventos de anotação diretamente no painel do grafo ou por meio da API HTTP.

**Adicionar uma anotação**

1. No dashboard, clique no painel **Séries temporais**. Um menu de contexto aparecerá.

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

1. Adicione uma descrição da anotação e, opcionalmente, tags.

1. Clique em **Salvar**.

Como alternativa, para adicionar uma anotação, `Ctrl+Click` ou `Cmd+Click` no painel **Séries temporais**, o pop-over **Adicionar anotação** aparecerá.

**Adicionar anotação de região**

1. No dashboard, `Ctrl+Click` ou `Cmd+Click` no painel **Séries temporais**.

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

1. Adicione uma descrição da anotação e, opcionalmente, tags.

1. Clique em **Salvar**.

**Editar uma anotação**

1. No dashboard, passe o mouse sobre um indicador de anotação no painel **Séries temporais**.

1. Clique no ícone de edição (lápis) na dica de ferramenta de anotação.

1. Modifique a descrição e, opcionalmente, as tags.

1. Clique em **Salvar**.

**Excluir uma anotação**

1. No dashboard, passe o mouse sobre um indicador de anotação no painel **Séries temporais**.

1. Clique no ícone da lixeira na dica de ferramenta de anotação.

**Consulta integrada**

Depois de adicionar uma anotação, elas ainda estarão visíveis. Isso se deve à consulta de anotação integrada que existe em todos os dashboards. Essa consulta de anotação buscará todos os eventos de anotação originários do dashboard atual e os mostrará 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 extraídas abrindo as configurações de **Anotações** (por meio do menu de engrenagem do dashboard) e modificando a consulta denominada `Annotations & Alerts (Built-in)`.

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

**Consultar por tag**

Você pode criar consultas para buscar anotações do armazenamento de anotações nativas por meio da fonte de dados do `-- Grafana --` definindo **Filtrar por** como `Tags`.

O Grafana v8.1 e versões posteriores também são compatíveis com a digitação antecipada de tags existentes, fornecendo pelo menos uma tag.

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

No Grafana v5.3\$1 é possível usar variáveis de modelo na consulta de tags. Então, se você tem um dashboard mostrando estatísticas de diferentes serviços e uma variável de modelo que determina quais serviços mostrar, agora você pode usar a mesma variável de modelo na consulta de anotação para mostrar apenas anotações para esses serviços.

**Consultar outras fontes de dados**

Os eventos de anotação são obtidos por meio de consultas de anotação. Para adicionar uma nova consulta de anotação a um dashboard, abra o menu de configurações do dashboard e selecione **Anotações**. Isso abrirá a visualização das configurações das anotações do dashboard. Para criar uma consulta de anotação, clique no botão **Novo**.

Especifique um nome para a consulta de anotação. Esse nome é dado ao botão de alternância (caixa de seleção) que permitirá habilitar ou desabilitar a exibição de eventos de anotação dessa consulta. Por exemplo, você pode ter duas consultas de anotação denominadas `Deploys` e `Outages`. A botão de alternância permitirá que você decida quais anotações mostrar.

**Detalhes da consulta de anotação**

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