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
-
Na barra lateral, pause no ícone de Alertas (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 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
ou1h
.
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
Configuração | Descrição |
---|---|
Url | URL de entrada do webhook do Slack ou, por fim, 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 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
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.
Configurar o link de volta para o Grafana nas notificações de alerta
Todas as notificações de alerta contêm um link de volta para o alerta acionado no espaço de trabalho do Grafana.