Anotações - Amazon Managed Grafana

Anotações

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.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.

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

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

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

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

Consulta integrada

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

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

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

As opções de consulta de anotação são diferentes para cada fonte de dados.