Etiquetas no Grafana Alerting

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

Para espaços de trabalho do Grafana compatíveis com a versão 8.x do Grafana, consulteTrabalhando na versão 8 do 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 de forma exclusiva um alerta nos alertas do Grafana.

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

• A interface de usuário de alertas 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 do Grafana, veja abaixo para obter mais informações).

Compatibilidade com o Alertmanager externo

O Alertmanager integrado do Grafana suporta chaves e valores de rótulos Unicode. Se você estiver usando um Prometheus Alertmanager externo, as chaves de rótulo devem ser compatíveis com seu modelo de dados. Isso significa que as chaves de rótulo devem conter apenas letras ASCII, números e sublinhados 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 Grafana antes de serem enviados ao Alertmanager externo de acordo com as seguintes regras:

• Whitespaceserão removidos.

• 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 limpas com o mesmo valor, as duplicatas terão um hash curto do rótulo original anexado como sufixo.

Etiquetas reservadas Grafana

nota

As etiquetas prefixadas comgrafana_ são reservadas pela Grafana para uso especial. Se um rótulo configurado manualmente for adicionado, começando comgrafana_ ele, ele poderá ser sobrescrito em caso de colisão.

As etiquetas reservadas do Grafana podem ser usadas da mesma forma que as etiquetas configuradas manualmente. A lista atual de etiquetas reservadas disponíveis é:

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