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á.
Faça anotações nas visualizações
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.
Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana
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 em uma visualização com eventos avançados. Eles são visualizados como linhas verticais e ícones em todos os painéis gráficos. 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.
Você pode fazer anotações nas visualizações de três maneiras:
-
Diretamente no painel, usando a consulta de anotações integrada.
-
Usando a API HTTP da Grafana.
-
Configurando consultas de anotação nas configurações do painel.
Nos dois primeiros casos, você está criando novas anotações, enquanto no último você está consultando anotações existentes de fontes de dados. A consulta de anotação integrada também oferece suporte a isso.
Esta seção explica a primeira e a terceira opções; para obter informações sobre como usar a API HTTP da Grafana, consulte. API de anotações
As anotações são compatíveis com os seguintes tipos de visualização:
-
Séries temporais
-
Cronograma estadual
-
Vela
Crie anotações em painéis
O Grafana vem com a capacidade de adicionar eventos de anotação diretamente de um painel usando a consulta de anotações integrada que existe em todos os painéis. As anotações que você cria dessa forma são armazenadas no Grafana.
Para adicionar anotações diretamente no painel:
-
O painel já deve estar salvo.
-
A consulta integrada deve estar ativada.
Para adicionar uma anotação
-
No painel, selecione o painel ao qual você está adicionando a anotação. Um menu de contexto aparecerá.
-
No menu de contexto, selecione Adicionar anotação.
-
(Opcional) Adicione uma descrição de anotação e tags.
-
Selecione Save (Salvar).
Como alternativa, para adicionar uma anotação, pressione Ctrl (ouCmd) ao selecionar o painel e o popover Adicionar anotação aparecerá.
Anotações de região
Você também pode criar anotações que cubram uma região ou um período de tempo em uma visualização.
Para adicionar uma anotação de região
-
No painel, pressione
Ctrl(ouCmd) enquanto seleciona uma área do painel. -
Adicione uma descrição de anotação e tags (opcional).
-
Clique em Salvar.
Para editar uma anotação
-
No painel, passe o mouse sobre um indicador de anotação em um painel.
-
Selecione o ícone Editar (lápis) na dica de ferramenta de anotação.
-
Modifique a descrição e/ou as tags.
-
Selecione Save (Salvar).
Para excluir uma anotação
-
No painel, passe o mouse sobre um indicador de anotação em um painel.
-
Selecione o ícone Excluir (lixeira) na dica de ferramenta de anotação.
Busque anotações por meio das configurações do painel
Nas configurações do painel, em Anotações, você pode adicionar novas consultas para buscar anotações usando qualquer fonte de dados, incluindo a fonte de dados de anotação de dados integrada. As consultas de anotação retornam eventos que podem ser visualizados como marcadores de eventos em gráficos em todo o painel.
Para adicionar uma nova consulta de anotação
-
Selecione o ícone Configurações (engrenagem) no cabeçalho do painel para abrir o menu de configurações.
-
Selecione Anotações.
-
Clique em Adicionar consulta de anotação.
-
Insira um nome para a consulta de anotação.
Esse nome é dado ao botão (caixa de seleção) que permitirá que você habilite a exibição de eventos de anotação dessa consulta.
-
Selecione a fonte de dados para as anotações.
Você também pode escolher Abrir seletor de fonte de dados avançado para ver mais opções, incluindo adicionar uma nova fonte de dados (disponível somente para administradores).
-
Se você não quiser usar a consulta de anotação imediatamente, desmarque a caixa de seleção Ativado.
-
Se você não quiser que a opção de consulta de anotação seja exibida no painel, marque a caixa de seleção Oculto.
-
Selecione uma cor para os marcadores do evento.
-
No menu suspenso Mostrar em, escolha uma das seguintes opções:
-
Todos os painéis — As anotações são exibidas em todos os painéis que suportam anotações.
-
Painéis selecionados — As anotações são exibidas em todos os painéis selecionados.
-
Todos os painéis, exceto — As anotações são exibidas em todos os painéis, exceto nos que você selecionar.
-
-
Configure a consulta.
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. Conectar-se à fonte de dados
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 painéis. Essa consulta de anotação buscará todos os eventos de anotação originários do painel atual, armazenados no Grafana, e os mostrará no painel em que foram criados. Isso inclui anotações do histórico do estado de alerta.
Por padrão, a consulta de anotação integrada usa a fonte de dados Grafana especial, e as anotações manuais só são suportadas usando essa fonte de dados. Você pode usar outra fonte de dados na consulta de anotação integrada, mas só poderá criar anotações automatizadas usando o editor de consultas dessa fonte de dados.
Para adicionar anotações diretamente ao painel, essa consulta deve estar habilitada.
Para confirmar se a consulta integrada está ativada
-
Selecione o ícone de configurações do painel (engrenagem) no cabeçalho do painel para abrir o menu de configurações do painel.
-
Selecione Anotações.
-
Encontre a consulta Anotações e alertas (incorporada).
Se aparecer Desativado antes do nome da consulta, você precisará selecionar o nome da consulta para abri-la e atualizar a configuração.
Para impedir que as anotações sejam buscadas e desenhadas
-
Selecione o ícone de configurações do painel (engrenagem) no cabeçalho do painel para abrir o menu de configurações do painel.
-
Selecione Anotações.
-
Selecione a consulta Anotações e alertas (incorporada).
-
Selecione o botão Ativado para desativá-lo.
Quando você copia um painel usando o recurso Salvar como, ele recebe um novo ID do painel, portanto, as anotações criadas no painel de origem não estarão mais visíveis na cópia. Você ainda pode mostrá-los se adicionar uma nova consulta de anotação e filtrar por tags. No entanto, isso só funciona se as anotações no painel de origem tiverem tags pelas quais filtrar.
Filtrando consultas por tag
Você pode criar novas consultas para buscar anotações da consulta de anotação integrada usando a fonte de Grafana dados definindo Filtrar por para. Tags
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 via API) com a outage tag. 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.
Você também pode usar variáveis de modelo na consulta de tag. Isso significa que se você tiver um painel mostrando estatísticas de diferentes serviços e uma variável de modelo que determina quais serviços mostrar, você pode usar a mesma variável de modelo em sua consulta de anotação para mostrar apenas anotações para esses serviços.
