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

1. No menu do lado esquerdo, escolha Portal de gerenciamento de alertas IRM e, em seguida, Alertas.

2. Escolha Pontos de contato.

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

4. Na guia Pontos de contato, escolha + Adicionar ponto de contato.

5. Insira um nome para o ponto de contato.

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

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

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

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

10. Salve as alterações.

Para editar um ponto de contato

1. No menu do lado esquerdo, escolha Portal de gerenciamento de alertas IRM e, em seguida, Alertas.

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

3. Selecione o ponto de contato a ser editado e escolha Editar.

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

1. No menu do lado esquerdo, escolha Portal de gerenciamento de alertas IRM e, em seguida, Alertas.

2. Escolha Pontos de contato para abrir a lista de pontos de contato existentes.

3. Em Pontos de contato, selecione o ponto de contato a ser excluído e escolha Mais, Excluir.

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

1. No menu do lado esquerdo, escolha Portal de gerenciamento de alertas IRM e, em seguida, Alertas.

2. Escolha Pontos de contato para abrir a lista de pontos de contato existentes.

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

4. Escolha Testar para abrir a caixa de diálogo de teste do ponto de contato.

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

6. 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 chave de API ou um URL de webhook.

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	sns
OpsGenie	opsgenie
Dever do pager	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	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.