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á.
# Notificações
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
Escolher como, quando e para onde enviar as notificações de alerta é uma parte importante da configuração do sistema de alertas. Essas decisões terão um impacto direto na capacidade de resolver problemas rapidamente e não perder nada importante.
Como primeira etapa, defina os [pontos de contato](v10-alerting-explore-contacts.md), que definem para onde enviar as 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 nas notificações.
Em seguida, crie uma política de notificação que é um conjunto de regras para onde, quando e como os alertas são roteados para os pontos de contato. Em uma política de notificação, você define para onde enviar as notificações de alerta escolhendo um dos pontos de contato que você criou.
## Alertmanagers
O Grafana usa Alertmanagers para enviar notificações de alertas disparados e resolvidos. O Grafana tem seu próprio Alertmanager, indicado como **Grafana** na interface do usuário, mas também é compatível com o envio de notificações de outros Alertmanagers, como o [Prometheus Alertmanager](https://prometheus.io/docs/alerting/latest/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 ela 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 rótulos 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 tempos de desativação de áudio para impedir 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 denominada política padrão. Só pode haver uma política padrão e ela não pode ser excluída.
Políticas de roteamento específicas são secundárias 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 os rótulos coincidentes correspondem aos rótulos no 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 corresponde a ele. 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, então a própria política 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, consulte [Políticas de notificação](v10-alerting-explore-notifications-policies-details.md).
## 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 entre diferentes pontos de contato. Por exemplo, um usuário do Grafana pode criar um modelo denominado `custom_subject_or_title` e usá-lo para criar modelos de assuntos no PagerDuty 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 modelo do Go](https://pkg.go.dev/text/template) e estão na guia Pontos de contato na página de alertas.
Para obter informações mais detalhadas sobre a personalização das notificações, consulte [Personalizar notificações](v10-alerting-manage-notifications.md).
## Silêncios
Você pode usar silêncios para desativar o áudio das 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 pelo período definido, que pode ser configurado em minutos, horas, dias, meses ou anos.
Para obter informações mais detalhadas sobre como usar os silêncios, consulte [Silenciar notificações de alerta](v10-alerting-silences.md).
# Políticas de notificação
****
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
As políticas de notificação fornecem uma maneira flexível de rotear alertas para vários receptores diferentes. Usando os matchers de rótulos, você pode modificar a entrega da notificação de alertas sem precisar atualizar cada regra de alerta individual.
Nesta seção, você aprenderá mais sobre como as políticas de notificação funcionam e são estruturadas, para que você possa aproveitar ao máximo a configuração das políticas de notificação.
## Árvore de políticas
As políticas de notificação *não* são uma lista. Elas são estruturadas de acordo com uma estrutura em árvore. Isso significa que cada política pode ter políticas secundárias etc. A raiz da árvore de políticas de notificação é chamada de **Política de notificação padrão**.
Cada política consiste em um conjunto de matchers de rótulos (0 ou mais) que especificam quais rótulos eles estão ou não interessados em manipular.
Para obter mais informações sobre como corresponder rótulos, consulte [Como funciona a correspondência de rótulos](v10-alerting-overview-labels-matching.md).
**nota**
Se você não configurou nenhum matcher de rótulo para sua política de notificação, ela fará a correspondência de *todas* as instâncias de alerta. Isso pode impedir que as políticas secundárias sejam avaliadas, a menos que você tenha habilitado a opção **Continuar combinando políticas irmãs** na política de notificação.
## Roteamento
Para determinar qual política de notificação lidará com quais instâncias de alerta, você precisa começar examinando o conjunto existente de políticas de notificação, começando pela política de notificação padrão.
Se nenhuma política além da política padrão estiver configurada, a política padrão tratará da instância de alerta.
Se políticas diferentes da política padrão forem definidas, ela avaliará essas políticas de notificação na ordem em que forem exibidas.
Se uma política de notificação tiver matchers de rótulos que correspondam aos rótulos da instância de alerta, ela passará para suas políticas secundárias e, se houver mais, continuará procurando por políticas secundárias que possam ter matchers que restrinjam ainda mais o conjunto de rótulos, e assim por diante, até que nenhuma outra política secundária seja encontrada.
Se nenhuma política secundária for definida em uma política de notificação, ou se nenhuma das políticas secundárias tiver matchers de rótulos que correspondam aos rótulos da instância de alerta, a política de notificação principal será usada.
Assim que uma política correspondente é encontrada, o sistema não continua procurando outras políticas correspondentes. Se você quiser continuar procurando outras políticas que possam corresponder, habilite **Continuar combinando irmãs** nessa política específica.
Por fim, se nenhuma das políticas de notificação for selecionada, a política de notificação padrão será usada.
### Exemplo de roteamento
Veja abaixo um exemplo de uma árvore de políticas de notificação relativamente simples e algumas instâncias de alerta.
![\[Uma imagem mostrando um conjunto de políticas de notificação em uma estrutura em árvore e um conjunto de instâncias de alerta com rótulos diferentes para corresponder às políticas.\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/images/notification-routing.png)
Veja abaixo um resumo de como essas políticas são selecionadas:
O **pod preso CrashLoop** não tem um `severity` rótulo, então nenhuma de suas políticas secundárias é compatível. Ela tem um rótulo `team=operations`, então a primeira política corresponde.
A política `team=security` não foi avaliada porque já encontramos uma correspondência, e a opção **Continuar combinando irmãs** não foi configurada para essa política.
**Uso do disco: 80%** tem um rótulo `team` e `severity` e corresponde a uma política secundária da equipe de operações.
A **entrada de log não autorizada** tem um rótulo `team`, mas não corresponde à primeira política (`team=operations`), pois os valores não são os mesmos. Portanto, ela continuará pesquisando e corresponderá à política de `team=security`. Ela não tem nenhuma política secundária, portanto, o rótulo `severity=high` adicional é ignorado.
## Herança
Além de as políticas secundárias serem um conceito útil para rotear instâncias de alerta, elas também herdam propriedades da política principal. Isso também se aplica a todas as políticas que sejam políticas secundárias da política de notificação padrão.
As seguintes propriedades são herdadas pelas políticas secundárias:
+ Ponto de contato
+ Opções de agrupamento
+ Opções de tempos
+ Tempos de desativação de áudio
Cada uma dessas propriedades pode ser substituída por uma política individual, caso você deseje substituir as propriedades herdadas.
Para herdar um ponto de contato da política principal, deixe-o em branco. Para substituir as opções de agrupamento herdadas, habilite **Substituir agrupamento**. Para substituir as opções de tempos herdadas, habilite **Substituir tempos gerais**.
### Exemplo de herança
O exemplo abaixo mostra como a árvore de políticas de notificação do nosso exemplo anterior permite que as políticas secundárias de `team=operations` herdem o ponto de contato.
Dessa forma, podemos evitar a necessidade de especificar o mesmo ponto de contato várias vezes para cada política secundária.
![\[Uma imagem mostrando um conjunto de políticas de notificação em uma estrutura de árvore, com pontos de contato atribuídos a algumas das políticas, mas com algumas políticas secundárias herdando os pontos de contato das principais, em vez de definirem os seus próprios.\]](http://docs.aws.amazon.com/pt_br/grafana/latest/userguide/images/notification-inheritance.png)
## Opções de configuração adicionais
### Agrupamento
O agrupamento é um recurso importante do Grafana Alerting, pois permite agrupar alertas relevantes para um número menor de notificações. Isso será particularmente importante se as notificações forem entregues aos primeiros respondentes, como engenheiros de plantão, em que receber muitas notificações em um curto período de tempo pode ser cansativo e, em alguns casos, pode afetar negativamente a capacidade deles de responder a um incidente. Por exemplo, considere uma grande interrupção em que muitos de seus sistemas estejam inativos. Nesse caso, o agrupamento pode ser a diferença entre receber uma chamada telefônica e cem chamadas telefônicas.
Você escolhe como os alertas serão agrupados usando a opção Agrupar por em uma política de notificação. Por padrão, as políticas de notificação no Grafana agrupam alertas por regra de alerta usando os rótulos `alertname` e `grafana_folder` (já que os nomes dos alertas não são exclusivos entre várias pastas). Se você quiser agrupar alertas por algo diferente da regra de alerta, altere o agrupamento para qualquer outra combinação de rótulos.
#### Desabilitar um agrupamento
Caso deseje receber cada alerta como uma notificação separada, você pode fazer isso agrupando por um rótulo especial denominado `...`. Isso é útil quando os alertas estão sendo enviados para um sistema automatizado em vez de para um primeiro respondente.
#### Um único grupo para todos os alertas
Caso deseje receber todos os alertas juntos em uma única notificação, você pode fazer isso deixando Agrupar por vazio.
### Opções de tempos
As opções de tempo decidem com que frequência as notificações são enviadas para cada grupo de alertas. Há três temporizadores que você precisa conhecer: Espera do grupo, Intervalo do grupo e Intervalo de repetição.
#### Espera do grupo
A espera do grupo é o período de tempo que o Grafana espera antes de enviar a primeira notificação para um novo grupo de alertas. Quanto maior for a espera do grupo, mais tempo você terá para que outros alertas cheguem. Quanto menor for a espera do grupo, mais cedo a primeira notificação será enviada, mas correndo o risco de enviar notificações incompletas. Você deve sempre escolher uma espera do grupo que seja a mais adequada para o seu caso de uso.
**Padrão** 30 segundos
#### Intervalo do grupo
Depois que a primeira notificação é enviada para um novo grupo de alertas, o Grafana inicia o temporizador de intervalo do grupo. Este é o período de tempo que o Grafana espera antes de enviar notificações sobre alterações no grupo. Por exemplo, outro alerta disparado pode ter acabado de ser adicionado ao grupo, enquanto um alerta existente pode ter sido resolvido. Se um alerta chegar tarde demais para ser incluído na primeira notificação devido à espera do grupo, ele será incluído nas notificações subsequentes após o intervalo do grupo. Depois de decorrido o intervalo do grupo, o Grafana redefine o temporizador do intervalo do grupo. Isso se repete até que não haja mais alertas no grupo, após o qual o grupo é excluído.
**Padrão** 5 minutos
#### Intervalo de repetição
O intervalo de repetição decide com que frequência as notificações serão repetidas se o grupo não tiver sido alterado desde a última notificação. Você pode pensar nisso como lembretes de que alguns alertas ainda estão sendo disparados. O intervalo de repetição está intimamente relacionado ao intervalo do grupo, o que significa que seu intervalo de repetição não deve ser apenas maior ou igual ao intervalo do grupo, mas também deve ser um múltiplo do intervalo do grupo. Se o intervalo de repetição não for um múltiplo do intervalo de grupo, ele será obrigado a formar um. Por exemplo, se o intervalo de grupo for de cinco minutos e o intervalo de repetição for de nove minutos, o intervalo de repetição será arredondado para o múltiplo de cinco mais próximo, que é de dez minutos.
**Padrão** 4 horas