Notificaçõ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

Escolher como, quando e para onde enviar suas notificações de alerta é uma parte importante da configuração do sistema de alertas. Essas decisões terão um impacto direto em sua capacidade de resolver problemas rapidamente e não perder nada importante.

Como primeira etapa, defina seus pontos de contato, que definem para onde enviar suas notificações de alerta. Um ponto de contato é um conjunto de uma ou mais integrações usadas para enviar notificações. Adicione modelos de notificação aos pontos de contato para reutilização e mensagens consistentes em suas notificações.

Em seguida, crie uma política de notificação que é um conjunto de regras para onde, quando e como seus alertas são encaminhados para os pontos de contato. Em uma política de notificação, você define para onde enviar suas notificações de alerta escolhendo um dos pontos de contato que você criou.

Gerentes de alertas

Grafana usa gerenciadores de alertas para enviar notificações de disparo e alertas resolvidos. O Grafana tem seu próprio gerenciador de alertas, conhecido como Grafana na interface do usuário, mas também suporta o envio de notificações de outros gerenciadores de alertas, como o Prometheus Alertmanager. O Grafana Alertmanager usa políticas de notificação e pontos de contato para configurar como e onde uma notificação é enviada; com que frequência uma notificação deve ser enviada; e se todos os alertas devem ser enviados na mesma notificação, enviados em notificações agrupadas com base em um conjunto de rótulos ou como notificações separadas.

Políticas de notificação

As políticas de notificação controlam quando e para onde as notificações são enviadas. Uma política de notificação pode escolher enviar todos os alertas juntos na mesma notificação, enviar alertas em notificações agrupadas com base em um conjunto de marcadores ou enviar alertas como notificações separadas. Você pode configurar cada política de notificação para controlar a frequência com que as notificações devem ser enviadas, além de ter um ou mais horários de silenciamento para inibir as notificações em determinados horários do dia e em determinados dias da semana.

As políticas de notificação são organizadas em uma estrutura de árvore em que, na raiz da árvore, há uma política de notificação chamada política padrão. Só pode haver uma política padrão e a política padrão não pode ser excluída.

Políticas de roteamento específicas são filhas da política raiz e podem ser usadas para combinar todos os alertas ou um subconjunto de alertas com base em um conjunto de rótulos correspondentes. Uma política de notificação corresponde a um alerta quando seus rótulos correspondentes correspondem aos rótulos do alerta.

Uma política aninhada pode ter suas próprias políticas aninhadas, que permitem uma correspondência adicional de alertas. Um exemplo de política aninhada pode ser enviar alertas de infraestrutura para a equipe de operações; enquanto uma política secundária pode enviar alertas de alta prioridade para o Pagerduty e alertas de baixa prioridade para o Slack.

Todos os alertas, independentemente de seus rótulos, correspondem à política padrão. No entanto, quando a política padrão recebe um alerta, ela examina cada política aninhada e envia o alerta para a primeira política aninhada que corresponda ao alerta. Se a política aninhada tiver outras políticas aninhadas, ela poderá tentar comparar o alerta com uma de suas políticas aninhadas. Se nenhuma política aninhada corresponder ao alerta, a política em si será a política correspondente. Se não houver políticas aninhadas ou nenhuma política aninhada corresponder ao alerta, a política padrão será a política correspondente.

Para obter informações mais detalhadas sobre políticas de notificação, consultePolíticas de notificação.

Modelos de notificação

Você pode personalizar as notificações com modelos. Por exemplo, modelos podem ser usados para alterar o título e a mensagem das notificações enviadas ao Slack.

Os modelos não se limitam a uma integração individual ou ponto de contato, mas podem ser usados em várias integrações no mesmo ponto de contato e até mesmo em integrações em diferentes pontos de contato. Por exemplo, um usuário da Grafana pode criar um modelo chamado custom_subject_or_title e usá-lo para criar modelos de assuntos no Pager Duty e títulos de mensagens do Slack sem precisar criar dois modelos separados.

Todos os modelos de notificações são escritos na linguagem de modelagem do Go e estão na guia Pontos de contato na página de alertas.

Para obter informações mais detalhadas sobre a personalização de notificações, consultePersonalize as notificações.

Silêncios

Você pode usar os silêncios para silenciar as notificações de uma ou mais regras de disparo. Os silêncios não impedem que os alertas sejam disparados ou resolvidos, nem ocultam os alertas de disparo na interface do usuário. Um silêncio dura tanto quanto sua duração, que pode ser configurada em minutos, horas, dias, meses ou anos.

Para obter informações mais detalhadas sobre o uso de silêncios, consulteSilenciando notificações de alerta para fontes de dados do Prometheus.