Trabalhando com pontos de contato

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte ao Grafana versão 9.x.

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 um alerta é iniciado. Um ponto de contato pode ter uma ou mais integrações de pontos de contato, por exemplo, Amazon Simple Notification Service ou Slack. Quando um alerta é iniciado, uma notificação é enviada para todas as integrações de pontos de contato listadas para um ponto de contato. Opcionalmente, use modelos de notificação para personalizar as mensagens de notificação para os tipos de pontos de contato.

nota

Você pode criar e editar pontos de contato para alertas gerenciados pela Grafana. Os pontos de contato para alertas do Alertmanager são somente para leitura.

Trabalhando com pontos de contato

Os procedimentos a seguir detalham como adicionar, editar, testar e excluir pontos de contato.

Para adicionar um ponto de contato

1. No console do Grafana, no menu Grafana, escolha o ícone de Alerta (sino) para abrir a página de Alerta.

2. Escolha Pontos de contato e, em seguida, Adicionar ponto de contato.

3. No menu suspenso Alertmanager, selecione um Alertmanager. O Grafana Alertmanager é selecionado por padrão.

4. Insira um nome para o ponto de contato.

5. Em Integração de pontos de contato, escolha um tipo e 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.

6. Se disponível para o ponto de contato selecionado, escolha qualquer configuração opcional desejada para especificar configurações adicionais.

7. Em Configurações de notificação, selecione opcionalmente Desativar mensagem resolvida se não quiser ser notificado quando um alerta for resolvido.

8. Se o seu ponto de contato precisar de mais tipos de pontos de contato, você pode escolher Adicionar integração de pontos de contato e repetir as etapas para cada tipo de ponto de contato necessário.

9. Escolha Salvar ponto de contato para salvar suas alterações.

Para editar um ponto de contato

1. Escolha Pontos de contato para ver uma lista dos pontos de contato existentes.

2. Selecione o ponto de contato a ser editado e, em seguida, escolha o ícone Editar (caneta).

3. Faça as alterações necessárias e escolha Salvar ponto de contato para salvar suas alterações.

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. Escolha Pontos de contato para abrir a lista de pontos de contato existentes.

2. Selecione o ponto de contato a ser testado e, em seguida, escolha o ícone Editar (caneta).

3. Selecione o ícone Teste (avião de papel).

4. 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.

5. Escolha Enviar notificação de teste para testar o alerta com os pontos de contato fornecidos.

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. Escolha Pontos de contato para abrir a lista de pontos de contato existentes.

2. Selecione o ponto de contato a ser excluído e, em seguida, escolha o ícone Excluir (lixeira).

3. 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.

Lista de notificadores compatíveis

Nome	Tipo
Amazon SNS	sns
OpsGenie	opsgenie
Dever do pager	pagerduty
Slack	slack
VictorOps	victorops