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 que suportam a versão 12.x do Grafana, consulte. [Trabalhando na versão 12 do Grafana](using-grafana-v12.md)
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).
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**
1. No menu à esquerda, selecione **Alertas**.
1. Escolha **Pontos de contato**.
1. No menu suspenso **Escolher Alertmanager**, selecione um Alertmanager. O Grafana Alertmanager é selecionado por padrão.
1. Na guia **Pontos de contato**, escolha **\+ Adicionar ponto de contato**.
1. Insira um **Nome** para o ponto de contato.
1. 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.
1. Se disponível para o ponto de contato selecionado, escolha as ** configurações opcionais** desejadas para especificar configurações adicionais.
1. Em **Configurações de notificação**, selecione opcionalmente **Desabilitar mensagem resolvida** se não quiser ser notificado quando um alerta for resolvido.
1. 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.
1. Salve as alterações.
**Para editar um ponto de contato**
1. No menu à esquerda, selecione **Alertas**.
1. Escolha **Pontos de contato** para ver uma lista dos pontos de contato existentes.
1. Selecione o ponto de contato a ser editado e escolha **Editar**.
1. 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**
1. No menu à esquerda, selecione **Alertas**.
1. Escolha **Pontos de contato** para abrir a lista de pontos de contato existentes.
1. Em **Pontos de contato**, selecione o ponto de contato a ser excluído e escolha **Mais**, **Excluir**.
1. 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**
1. No menu à esquerda, selecione **Alertas**.
1. Escolha **Pontos de contato** para abrir a lista de pontos de contato existentes.
1. 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.
1. Escolha **Testar** para abrir a caixa de diálogo de teste de ponto de contato.
1. 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.
1. 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 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 compatíveis**
A tabela a seguir lista os tipos de ponto de contato compatíveis com o Grafana.
| Nome | Tipo |
| --- | --- |
| Amazon SNS | `sns` |
| OpsGenie | `opsgenie` |
| PagerDuty | `pagerduty` |
| Slack | `slack` |
| VictorOps | `victorops` |
**Configurando PagerDuty para alertas**
Para configurar PagerDuty, você deve fornecer uma chave de integração. Forneça os detalhes a seguir.
| Configuração | Description |
| --- | --- |
| 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 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.