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á.
Configurar pontos de contato
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.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
Use pontos de contato para definir como seus contatos são notificados quando uma regra de alerta é disparada.
nota
Você pode criar e editar pontos de contato para alertas gerenciados pelo Grafana. Os pontos de contato para alertas gerenciados por fontes de dados são somente para leitura.
Trabalhar com pontos de contato
Os procedimentos a seguir mostram como adicionar, editar, excluir e testar um ponto de contato.
Para adicionar um ponto de contato
-
No menu à esquerda, selecione Alertas.
-
Escolha Pontos de contato.
-
No menu suspenso Escolher Alertmanager, selecione um Alertmanager. O Grafana Alertmanager é selecionado por padrão.
-
Na guia Pontos de contato, escolha + Adicionar ponto de contato.
-
Insira um Nome para o ponto de contato.
-
Em Integração, escolha um tipo e preencha os campos obrigatórios com base nesse tipo. Por exemplo, se você escolher o Slack, insira os canais e os usuários do Slack que devem ser contatados.
-
Se disponível para o ponto de contato selecionado, escolha as configurações opcionais desejadas para especificar configurações adicionais.
-
Em Configurações de notificação, selecione opcionalmente Desabilitar mensagem resolvida se não quiser ser notificado quando um alerta for resolvido.
-
Para adicionar outra integração de ponto de contato, escolha Adicionar integração de ponto de contato e repita as etapas para cada tipo de ponto de contato necessário.
-
Salve as alterações.
Para editar um ponto de contato
-
No menu à esquerda, selecione Alertas.
-
Escolha Pontos de contato para ver uma lista dos pontos de contato existentes.
-
Selecione o ponto de contato a ser editado e escolha Editar.
-
Atualize o ponto de contato e salve as alterações.
Você pode excluir pontos de contato que não estão sendo usados por uma política de notificação.
Para excluir um ponto de contato
-
No menu à esquerda, selecione Alertas.
-
Escolha Pontos de contato para abrir a lista de pontos de contato existentes.
-
Em Pontos de contato, selecione o ponto de contato a ser excluído e escolha Mais, Excluir.
-
Na caixa de diálogo de confirmação, escolha Sim, excluir.
nota
Se o ponto de contato estiver sendo usado por uma política de notificação, você deverá excluir ou editar a política de notificação para usar outro ponto de contato antes de excluí-lo.
Depois que seu ponto de contato for criado, você poderá enviar uma notificação de teste para verificar se ele está configurado corretamente.
Para enviar uma notificação de teste
-
No menu à esquerda, selecione Alertas.
-
Escolha Pontos de contato para abrir a lista de pontos de contato existentes.
-
Em Pontos de contato, selecione o ponto de contato a ser testado e escolha Editar. Se necessário, você pode criar um ponto de contato.
-
Escolha Testar para abrir a caixa de diálogo de teste de ponto de contato.
-
Escolha se deseja enviar uma notificação de teste predefinida ou escolha Personalizado para adicionar suas próprias anotações e rótulos personalizados na notificação de teste.
-
Escolha Enviar notificação de teste para testar o alerta com os pontos de contato fornecidos.
Configurar integrações de pontos de contato
Configure as integrações de pontos de contato no Grafana para selecionar seu canal de comunicação preferencial para receber notificações quando suas regras de alerta estiverem sendo disparadas. Cada integração tem suas próprias opções e processo de configuração. Na maioria dos casos, isso envolve fornecer uma chave de API ou um URL do webhook.
Depois de configurado, você pode usar integrações como parte de seus pontos de contato para receber notificações sempre que o alerta mudar de estado. Nesta seção, abordaremos as etapas básicas para configurar uma integração, usando o PagerDuty como exemplo, para que você possa começar a receber alertas em tempo real e controlar os dados de monitoramento.
Lista de integrações compatíveis
A tabela a seguir lista os tipos de ponto de contato compatíveis com o Grafana.
| Nome | Tipo |
|---|---|
Amazon SNS |
|
OpsGenie |
|
PagerDuty |
|
Slack |
|
VictorOps |
|
Configurar o PagerDuty para alertas
Para configurar o PagerDuty, você deve fornecer uma chave de integração. Forneça os detalhes a seguir.
| 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. |
| Detalhes personalizados | Detalhes adicionais sobre o evento |
O campo CustomDetails é um objeto contendo pares arbitrários de chave/valor. Os detalhes definidos pelo usuário são mesclados com os usados por padrão.
Os valores padrão para CustomDetails são:
{ "firing": `{{ template "__text_alert_list" .Alerts.Firing }}`, "resolved": `{{ template "__text_alert_list" .Alerts.Resolved }}`, "num_firing": `{{ .Alerts.Firing | len }}`, "num_resolved": `{{ .Alerts.Resolved | len }}`, }
No caso de chaves duplicadas, os detalhes definidos pelo usuário substituem os padrões.
