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 da documentação discute alertas legados no Grafana. Isso não será suportado em versões futuras do Amazon Managed Grafana. Você pode migrar para os alertas da Grafana para usar os recursos de alerta mais recentes. Para obter mais informações, consulte um dos tópicos a seguir.
Para espaços de trabalho do Grafana que suportam a versão 10.x do Grafana, consulte. Alertas na versão 10 da Grafana
Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Alertas na versão 9 da Grafana
Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Alerta 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 um notification 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 (sino) e escolha Canais de notificação.
-
Escolha Add channel (Adicionar canal).
-
Preencha os campos ou selecione as opções descritas nas seções a seguir.
Novos campos do canal de notificação
Padrão (enviar em 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 ter mais informações, consulte Lista de notificadores compatíveis.
-
Padrão (enviar em 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,,
30s3m,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 da regra 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
| Nome | Tipo | Suporta imagens | Suporta tags 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 do tópico do SNS ao criar seu canal de notificação. No campo Nome, forneça o nome do tópico 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 deverá ser prefixado com o prefixo grafana 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 com. grafana
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 do AWS SNS, marque a caixa de seleção Incluir todas as tags na mensagem para ver todas as tags 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 de entrada do Slack. Para obter mais informações, consulte Envio de mensagens usando webhooks de entrada
Para incluir capturas de tela dos alertas de disparo nas mensagens do Slack, você deve configurar o destino externo da imagem no Grafana ou uma integração de bots por meio dos aplicativos do Slack. Para obter mais informações sobre como configurar uma integração com bots do Slack, consulte Siga o guia do Slack para configurar uma integração com bots
| Configuração | Descrição |
|---|---|
| Url | URL de entrada do webhook 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. |
| Destinatário | Use isso para substituir o destinatário do Slack. Você deve fornecer um ID do Slack do canal, um ID do Slack do usuário, uma referência de nome de usuário (@<user>, tudo em minúsculas, sem espaço em branco) ou uma referência do canal (#, <channel>tudo em minúsculas, sem espaço em branco). Se você usa o endpoint da API chat.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 do Slack de cada usuário. |
| Grupos de menções | Opcionalmente, mencione um ou mais grupos na notificação do Slack enviada pela Grafana. Você pode ver grupos separados por vírgulas por meio de seus IDs do Slack correspondentes (que você pode obter na URL do perfil do Slack de cada grupo). |
| Canal de menção | Opcionalmente, mencione todos os membros do canal ou somente os ativos. |
| Token | Se fornecido, o Amazon Managed Grafana fará o upload da imagem gerada por meio da operação da API Slack file.upload, não do destino externo da imagem. Se você usa o endpoint da API chat.postMessage Slack, isso é obrigatório. |
Se você estiver usando o token para 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. |
| Gravidade | 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, e Component têm um significado especial no Formato de Evento PagerDuty Comum — PD-CEF
nota
Usar a mensagem em detalhes mudará a estrutura do custom_details campo no PagerDuty evento. Isso pode violar as regras de eventos personalizados em suas PagerDuty regras se você confiar nos campos empayload.custom_details. Mova todas as regras existentes custom_details.myMetric que usam custom_details.queries.myMetric o.
nota
O uso da dedup_key tag substituirá o Grafana dedup_key gerado por uma chave personalizada.
Configurando o link de volta para o Grafana a partir de notificações de alerta
Todas as notificações de alerta contêm um link para o alerta acionado no espaço de trabalho da Grafana.
