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 que oferecem suporte à versão 10.x do Grafana.
Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana
Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana
Use pontos de contato para definir como seus contatos são notificados quando uma regra de alerta é acionada.
nota
Você pode criar e editar pontos de contato para alertas gerenciados pela Grafana. Os pontos de contato para alertas gerenciados por fontes de dados são somente para leitura.
Trabalhando 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 do lado esquerdo, escolha Alertas.
-
Escolha Pontos de contato.
-
No menu suspenso Escolher gerenciador de alertas, selecione um gerenciador de alertas. 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 qualquer configuração opcional desejada para especificar configurações adicionais.
-
Em Configurações de notificação, selecione opcionalmente Desativar 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 do lado esquerdo, escolha 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 suas 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 do lado esquerdo, escolha 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 a política de notificação ou editá-la para usar um ponto de contato diferente antes de excluir o ponto de contato.
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 do lado esquerdo, escolha 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. Você também pode criar um novo ponto de contato, se necessário.
-
Escolha Testar para abrir a caixa de diálogo de teste do 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 preferido para receber notificações quando suas regras de alerta estiverem sendo acionadas. Cada integração tem suas próprias opções de configuração e processo de configuração. Na maioria dos casos, isso envolve fornecer uma API chave ou um webhookURL.
Depois de configurado, você pode usar integrações como parte de seus pontos de contato para receber notificações sempre que seu alerta mudar de estado. Nesta seção, abordaremos as etapas básicas para configurar uma integração, usando PagerDuty como exemplo, para que você possa começar a receber alertas em tempo real e ficar por dentro de seus dados de monitoramento.
Lista de integrações suportadas
A tabela a seguir lista os tipos de pontos de contato suportados pela Grafana.
| Nome | Tipo |
|---|---|
Amazon SNS |
|
OpsGenie |
|
Dever do pager |
|
Slack |
|
VictorOps |
|
Configurando PagerDuty para alertas
Para configurar 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 PagerDuty |
| Gravidade | Nível para notificações dinâmicas. O padrão é critical. |
| Detalhes personalizados | Detalhes adicionais sobre o evento |
O CustomDetails campo é um objeto que contém pares arbitrários de valores-chave. 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.
