Anotando visualizações - Amazon Managed Grafana

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

Anotando visualizações

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte ao Grafana versão 9.x.

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

As anotações fornecem uma forma de marcar pontos no gráfico com eventos avançados. Ao passar o mouse sobre uma anotação, você pode obter a descrição do evento 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 nativo e a capacidade de adicionar eventos de anotação diretamente do painel gráfico ou por meio da API HTTP.

Adicionando uma anotação

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

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

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

  4. Clique em Salvar.

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

Adicionando anotação de região

  1. No painel Ctrl+Click ou Cmd+Click no painel Séries temporais.

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

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

  4. Clique em Salvar.

Editando uma anotação

  1. No painel, passe o mouse sobre um indicador de anotação no painel Série temporal.

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

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

  4. Clique em Salvar.

Excluindo uma anotação

  1. No painel, passe o mouse sobre um indicador de anotação no painel Série temporal.

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

Consulta integrada

Depois de adicionar uma anotação, elas ainda estarão visíveis. Isso se deve à consulta de anotação incorporada que existe em todos os painéis. Essa consulta de anotação buscará todos os eventos de anotação originários do painel atual e os mostrará no painel em que foram criados. Isso inclui anotações do histórico do estado de alerta. Você pode impedir que as anotações sejam buscadas e desenhadas abrindo as configurações de Anotações (por meio do menu de engrenagens do Dashboard) e modificando a consulta nomeada. Annotations & Alerts (Built-in)

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

Consultando por tag

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

O Grafana v8.1 e versões posteriores também oferecem suporte à 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 painel 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 comportamentoMatch any, ative e o Grafana mostrará anotações que contêm qualquer uma das tags que você forneceu.

No Grafana v5.3+, é possível usar variáveis de modelo na consulta de tags. Então, se você tem um painel 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 em sua consulta de anotação para mostrar apenas anotações para esses serviços.

Consultando 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 painel, abra o menu de configurações do painel e selecione Anotações. Isso abrirá a visualização das configurações das anotações do painel. Para criar uma nova consulta de anotação, clique no botão Novo.

Especifique um nome para a consulta de anotação. Esse nome é dado ao botão (caixa de seleção) que permitirá ativar ou desativar a exibição de eventos de anotação dessa consulta. Por exemplo, você pode ter duas consultas de anotação chamadas e. Deploys Outages A opção 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 fonte de dados específica, consulte o tópico da fonte de dados específica.