Notificação de alerta - Amazon Managed Grafana

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ção de alerta

Este tópico da documentação discute alertas legados no Grafana. Isso não será mais compatível em versões futuras do Amazon Managed Grafana. Você pode migrar para o Grafana Alerting 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 compatíveis com o Grafana versão 10.x, consulte Alertas no Grafana versão 10.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Alertas no Grafana versão 9.

Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Grafana Alerting.

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 canal de notification.

Isso é feito na página de canais de notificação.

Adicionar um canal de notificação

  1. Na barra lateral, pause no ícone de Alertas (sino) e escolha Canais de notificação.

  2. Escolha Add channel (Adicionar canal).

  3. 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 este 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, esta opção envia uma notificação nesse canal para todas as regras de alerta.

  • Desabilitar mensagem de resolução: quando selecionada, esta opção desabilita a mensagem de resolução [OK] que é enviada quando o estado de alerta retorna para false.

  • Enviar lembretes: quando esta opção é selecionada, notificações adicionais (lembretes) serão enviadas para os 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, 5m ou 1h.

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 Enviar 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 Imagens compatíveis Compatível com 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 por serviço e incluiu o Amazon SNS como um canal de notificação para o espaço de trabalho, você só precisará fornecer o ARN do tópico do SNS ao criar o 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 por serviço, o nome do tópico do SNS deverá ser prefixado com 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 de 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 do Grafana no corpo da mensagem.

Se você usa permissões gerenciadas pelo cliente para o local de trabalho, o perfil do IAM que você fornece deve incluir permissões de publicação do SNS para o 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 Sending messages using incoming webhooks.

Para incluir capturas de tela dos alertas disparados nas mensagens do Slack, você deve configurar o destino externo da imagem no Grafana ou uma integração de bots por meio das aplicações do Slack. Para obter mais informações sobre como configurar uma integração com bots do Slack, consulte o guia do Slack para configurar uma integração com bots. Use o token fornecido, que começa com “xoxb”.

Configuração Descrição
Url URL de entrada do webhook do Slack ou, por fim, o endpoint da API chat.postMessage do Slack.
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 de canal do Slack, um ID de usuário do Slack, 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). Caso use o endpoint da API chat.postMessage Slack, isso é obrigatório.
Ícone de emoji Forneça um emoji para usar como ícone da mensagem do bot. Por exemplo, :smile:
URL do ícone Forneça o URL de uma imagem para usar como ícone da mensagem do bot.
Mencionar usuários Opcionalmente, mencione um ou mais usuários na notificação do Slack enviada pelo Grafana. Para ver os usuários separados por vírgula, por meio dos IDs do Slack correspondentes, escolha o botão de alternativas no perfil do Slack de cada usuário.
Mencionar grupos Opcionalmente, mencione um ou mais grupos na notificação do Slack enviada pelo Grafana. Você pode ver grupos separados por vírgulas por meio dos IDs do Slack correspondentes (que você pode obter no URL do perfil do Slack de cada grupo).
Mencionar canal 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 file.upload do Slack, não do destino externo da imagem. Caso use 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 o PagerDuty, forneça uma chave de integração.

Configuração Descrição
Chave de integração Chave de integração para o PagerDuty.
Gravidade Nível para notificações dinâmicas; o padrão é critical (1).
Incidentes resolvidos automaticamente Resolva incidentes no PagerDuty depois que o alerta voltar para ok.
Detalhes da mensagem Remove a mensagem de alerta do campo de resumo do PD e a coloque em detalhes personalizados (2).
nota

As tags Severity, Class, Group, dedup_key e Component têm um significado especial no Formato de evento comum do PagerDuty, PD-CEF. Se um painel de alerta definir essas chaves de tag, elas serão transpostas para a raiz do evento enviado ao PagerDuty. Isso significa que elas estarão disponíveis na interface de usuário e nas ferramentas de filtragem do PagerDuty. Uma tag de severidade definida em um alerta substitui a severidade global definida no canal de notificação, caso seja um nível válido.

nota

Usar Detalhes da mensagem mudará a estrutura do campo custom_details no evento do PagerDuty. Isso poderá violar as regras de eventos personalizados nas regras do PagerDuty se você confiar nos campos em payload.custom_details. Mova todas as regras existentes que usam custom_details.myMetric para custom_details.queries.myMetric.

nota

O uso da tag dedup_key substituirá a dedup_key gerada pelo Grafana por uma chave personalizada.

Todas as notificações de alerta contêm um link de volta para o alerta acionado no espaço de trabalho do Grafana.