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 de alerta
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 8.x do Grafana.
Para espaços de trabalho do Grafana compatíveis com a versão 9.x do Grafana, consulteTrabalhando na versão 9 do Grafana.
Quando um alerta muda de estado, ele envia notificações. Cada regra de alerta pode ter várias notificações. Para adicionar uma notificação a uma regra de alerta, primeiro você deve adicionar e configurar umnotification canal.
Isso é feito na página Canais de notificação.
Adicionar um canal de notificação
-
Na barra lateral, faça uma pausa no ícone de alerta (campainha) e escolha Canais de notificação.
-
Escolha Add channel (Adicionar canal).
-
Preencha os campos ou escolha as opções descritas nas seguintes seções.
Novos campos do canal de notificação
Padrão (enviar todos os alertas)
-
Nome — Insira um nome para esse canal. Ele será exibido quando os usuários adicionarem notificações às regras de alerta.
-
Tipo — Selecione o tipo de canal. Para obter mais informações, consulte Lista de notificadores compatíveis.
-
Padrão (enviar todos os alertas) — Quando selecionada, essa opção envia uma notificação nesse canal para todas as regras de alerta.
-
Desativar mensagem de resolução — Quando selecionada, essa opção desativa a mensagem de resolução [OK] que é enviada quando o estado de alerta retorna para falso.
-
Enviar lembretes — Quando essa opção é selecionada, notificações adicionais (lembretes) serão enviadas para alertas. Você pode especificar com que frequência os lembretes devem ser enviados usando o número de segundos (s), minutos (m) ou horas (h); por exemplo
30s,3m,5mou1h.
Importante
Os lembretes de alerta são enviados após a avaliação das regras. Portanto, um lembrete não pode ser enviado com mais frequência do que um intervalo de avaliação de regras de alerta configurado.
Os exemplos a seguir mostram com que frequência e quando os lembretes são enviados para um alerta acionado.
| Intervalo de avaliação da regra de alerta | Envie lembretes a cada | Lembrete enviado a cada (após a última notificação de alerta) |
|---|---|---|
30s
|
15s
|
~ 30 segundos |
1m
|
5m
|
~5 minutos |
5m
|
15m
|
~15 minutos |
6m
|
20m
|
~24 minutos |
1h
|
15m
|
~1 hora |
1h
|
2h
|
~ 2 horas |
Lista de notificadores compatíveis
| Name (Nome) | Type | Suporta imagens | Suporta etiquetas de regras de alerta |
|---|---|---|---|
| Amazon Simple Notification Service | sns | Não | Sim |
| OpsGenie |
opsgenie
|
Não | Sim |
| PagerDuty |
pagerduty
|
Não | Sim |
| Slack |
slack
|
Não | Não |
| VictorOps |
victorops
|
Não | Não |
Amazon Simple Notification Service
Se você habilitou as permissões gerenciadas pelo serviço e incluiu o Amazon SNS como um canal de notificação para seu espaço de trabalho, você só precisa fornecer o ARN de tópico do SNS ao criar seu canal de notificação. No campo Nome, forneça o nome do tópico do SNS que você criou. Se você criou o espaço de trabalho usando permissões gerenciadas pelo serviço, o nome do tópico do SNS deve ser prefixado com o prefixografana para que as notificações sejam publicadas com êxito no tópico. Se você selecionou permissões gerenciadas pelo cliente ao criar o espaço de trabalho, o nome do tópico do SNS não precisa ser prefixado comgrafana.
No campo Tópico, copie e cole o ARN do tópico do SNS. No formato do corpo da mensagem, você pode escolher a opção JSON ou texto.
No campo Configurações opcionais doAWS SNS, marque a caixa de seleção Incluir todas as tags na mensagem para ver todas as tags do Grafana no corpo da mensagem.
Se você usa permissões gerenciadas pelo cliente para o local de trabalho, a função do IAM que você fornece deve incluir permissões de publicação do SNS para seu tópico do SNS.
Slack
Para configurar o Slack, você deve configurar um URL de webhook do Slack de entrada. Para obter mais informações, consulte Enviar mensagens usando webhooks receitos básicos
Para incluir capturas de tela dos alertas disparados nas mensagens do Slack, você deve configurar o destino da imagem externa no Grafana ou a integração do bot por meio dos aplicativos do Slack. Para obter mais informações sobre como configurar uma integração de bots do Slack, consulte o guia do Slack para configurar uma integração de bots
| Configuração | Descrição |
|---|---|
| Url | URL do webhook de entrada do Slack ou, eventualmente, o endpoint da API chat.postMessage |
| Nome de usuário | Defina o nome de usuário para a mensagem do bot. |
| Recipient | Use isso para substituir o destinatário do Slack. Você deve fornecer um ID do Slack de canal, um ID do Slack de usuário, uma referência de nome de usuário (@<user>, tudo em minúsculas, sem espaço em branco) ou uma referência de canal (#<channel>, tudo em minúsculas, sem espaço em branco). Se você usa o endpoint da APIchat.postMessage Slack, isso é obrigatório. |
| Ícone emoji | Forneça um emoji para usar como ícone da mensagem do bot. Por exemplo, :smile: |
| URL do ícone | Forneça um URL para uma imagem para usar como ícone da mensagem do bot. |
| Mencione usuários | Opcionalmente, mencione um ou mais usuários na notificação do Slack enviada pela Grafana. Para ver os usuários, separados por vírgula, por meio de seus IDs do Slack correspondentes, escolha o botão de sobrecarga no perfil de cada usuário no Slack. |
| Grupos de menção | Opcionalmente, mencione um ou mais grupos na notificação do Slack enviada pela Grafana. Você pode ver grupos, separados por vírgula, por meio de seus IDs do Slack correspondentes (que você pode obter do URL do perfil do Slack de cada grupo). |
| Canal de menção | Opcionalmente, mencione todos os membros do canal ou apenas os ativos. |
| Token | Se fornecido, o Amazon Managed Grafana fará o upload da imagem gerada por meio da operação da API file.upload do Slack, não do destino externo da imagem. Se você usa o endpoint da APIchat.postMessage Slack, isso é obrigatório. |
Se você estiver usando o token de um bot do Slack, precisará convidar o bot para o canal para o qual deseja enviar notificações. Em seguida, adicione o canal ao campo do destinatário.
PagerDuty
Para configurar PagerDuty, forneça uma chave de integração.
| Configuração | Descrição |
|---|---|
| Chave de integração | Chave de integração para PagerDuty. |
| Severidade | Nível para notificações dinâmicas; o padrão écritical (1). |
| Resolver incidentes automaticamente | Resolva os incidentes PagerDuty depois que o alerta voltar para ok. |
| Mensagem em detalhes | Remove a mensagem de alerta do campo de resumo do PD e, em vez disso, a coloca em detalhes personalizados (2). |
nota
As tagsSeverity,Class,Groupdedup_key, eComponent têm um significado especial no FormatoPagerDuty Comum de Eventos — PD-CEF
nota
Usar a mensagem em detalhes mudará a estrutura docustom_details campo no PagerDuty evento. Isso pode violar as regras de eventos personalizadas em suas PagerDuty regras se você confiar nos campos empayload.custom_details. Mova todas as regras existentes quecustom_details.myMetric costumavamcustom_details.queries.myMetric.
nota
O uso dadedup_key tag substituirá o Grafanadedup_key gerado por uma chave personalizada.
Configurando o link de volta para o Grafana a partir das notificações de alerta
Todas as notificações de alerta contêm um link para o alerta acionado no espaço de trabalho do Grafana.
