Rótulos e anotaçõ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á.

Rótulos e anotaçõ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 10.x do Grafana, consulte. Trabalhando na versão 10 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

Rótulos e anotações contêm informações sobre um alerta. Tanto os rótulos quanto as anotações têm a mesma estrutura: um conjunto de valores nomeados; no entanto, seus usos pretendidos são diferentes. Um exemplo de rótulo, ou anotação equivalente, pode ser. alertname="test"

A principal diferença entre um rótulo e uma anotação é que os rótulos são usados para diferenciar um alerta de todos os outros alertas, enquanto as anotações são usadas para adicionar informações adicionais a um alerta existente.

Por exemplo, considere dois alertas altos de CPU: um para server1 e outro paraserver2. Nesse exemplo, podemos ter um rótulo chamado server onde o primeiro alerta tem o rótulo server="server1" e o segundo alerta tem o rótuloserver="server2". No entanto, talvez também queiramos adicionar uma descrição a cada alerta"The CPU usage for server1 is above 75%.", como onde server1 e onde 75% são substituídos pelo nome e pelo uso da CPU do servidor (consulte a documentação Modelagem de rótulos e anotações para saber como fazer isso). Esse tipo de descrição seria mais adequado como uma anotação.

Rótulos

Os rótulos contêm informações que identificam um alerta. Um exemplo de rótulo pode serserver=server1. Cada alerta pode ter mais de um rótulo, e o conjunto completo de rótulos de um alerta é chamado de conjunto de rótulos. É esse conjunto de rótulos que identifica o alerta.

Por exemplo, um alerta pode ter o rótulo definido, {alertname="High CPU usage",server="server1"} enquanto outro alerta pode ter o rótulo definido{alertname="High CPU usage",server="server2"}. Esses são dois alertas separados porque, embora seus alertname rótulos sejam os mesmos, seus server rótulos são diferentes.

O rótulo definido para um alerta é uma combinação de rótulos da fonte de dados, rótulos personalizados da regra de alerta e vários rótulos reservados, como. alertname

Etiquetas personalizadas

Os rótulos personalizados são rótulos adicionais da regra de alerta. Assim como as anotações, os rótulos personalizados devem ter um nome e seu valor pode conter uma combinação de texto e código de modelo que é avaliada quando um alerta é acionado. A documentação sobre como criar modelos de etiquetas personalizadas pode ser encontrada aqui.

Ao usar rótulos personalizados com modelos, é importante garantir que o valor do rótulo não mude entre avaliações consecutivas da regra de alerta, pois isso acabará criando um grande número de alertas distintos. No entanto, não há problema em que o modelo produza valores de rótulo diferentes para alertas diferentes. Por exemplo, não coloque o valor da consulta em um rótulo personalizado, pois isso acabará criando um novo conjunto de alertas sempre que o valor for alterado. Em vez disso, use anotações.

Também é importante garantir que o rótulo definido para um alerta não tenha dois ou mais rótulos com o mesmo nome. Se um rótulo personalizado tiver o mesmo nome de um rótulo da fonte de dados, ele substituirá esse rótulo. No entanto, se uma etiqueta personalizada tiver o mesmo nome de uma etiqueta reservada, a etiqueta personalizada será omitida do alerta.

Anotações

As anotações são pares nomeados que adicionam informações adicionais aos alertas existentes. Há várias anotações sugeridas na Grafanadescription, como,, e. summary runbook_url dashboardUId panelId Assim como os rótulos personalizados, as anotações devem ter um nome e seu valor pode conter uma combinação de texto e código de modelo que é avaliada quando um alerta é acionado. Se uma anotação contiver código de modelo, o modelo será avaliado uma vez quando o alerta for disparado. Ele não é reavaliado, mesmo quando o alerta é resolvido. A documentação sobre como criar modelos de anotações pode ser encontrada aqui.