Etiquetas em Grafana Alerting

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

Este tópico explica por que os rótulos são um componente fundamental dos alertas.

• O conjunto completo de rótulos para um alerta é o que identifica exclusivamente um alerta nos alertas da Grafana.

• O Alertmanager usa rótulos para combinar alertas para silêncios e grupos de alertas nas políticas de notificação.

• A interface de alerta mostra rótulos para cada instância de alerta gerada durante a avaliação dessa regra.

• Os pontos de contato podem acessar etiquetas para gerar dinamicamente notificações que contêm informações específicas do alerta que está resultando em uma notificação.

• Você pode adicionar rótulos a uma regra de alerta. Os rótulos são configuráveis manualmente, usam funções de modelo e podem fazer referência a outros rótulos. Os rótulos adicionados a uma regra de alerta têm precedência no caso de uma colisão entre os rótulos (exceto no caso dos rótulos reservados da Grafana, veja abaixo para obter mais informações).

Compatibilidade com o Alertmanager externo

O Alertmanager integrado do Grafana suporta chaves e valores de etiquetas Unicode. Se você estiver usando um Prometheus Alertmanager externo, as chaves de etiqueta devem ser compatíveis com seu modelo de dados. Isso significa que as chaves do rótulo devem conter apenas letras, números e sublinhados ASCII e corresponder ao regex. [a-zA-Z_][a-zA-Z0-9_]* Quaisquer caracteres inválidos serão removidos ou substituídos pelo mecanismo de alerta da Grafana antes de serem enviados ao Alertmanager externo de acordo com as seguintes regras:

• Whitespaceserá removido.

• ASCII charactersserá substituído por_.

• All other charactersserão substituídos por sua representação hexadecimal em minúsculas. Se esse for o primeiro caractere, ele será prefixado com_.

nota

Se várias chaves de rótulo forem higienizadas com o mesmo valor, as duplicatas terão um hash curto da etiqueta original anexado como sufixo.

Etiquetas reservadas Grafana

nota

As etiquetas prefixadas com grafana_ são reservadas pela Grafana para uso especial. Se uma etiqueta configurada manualmente for adicionada, começando por grafana_ ela, ela será substituída em caso de colisão.

Os rótulos reservados da Grafana podem ser usados da mesma forma que os rótulos configurados manualmente. A lista atual de etiquetas reservadas disponíveis é:

Rótulo	Descrição
pasta_grafana	Título da pasta que contém o alerta.