Integrar eventos Grafana

Integre Grafana com Gestão de eventosAdicionando um webhook padrão no console do Grafana.

Antes de Iniciar

• Certifique-se de que Gestão de eventosO plug-in Conectores (sn_em_connector) está instalado no Now Platforminstância.
• . Gestão de eventoso plug-in deve ser instalado no Now Platforminstância.
• A vinculação de IC acontece por meio do IP, as instâncias devem ser descobertas como servidores para iniciar a vinculação. ICs descobertos por meio de nuvem ou ICs em cmdb_ci_vm_object Não fique limitado, pois o Grafana não fornece nenhuma informação para IDs de objeto.
• Função necessária: evt_mgmt_integration

Por Que e Quando Desempenhar Esta Tarefa

Configure o. Gestão de eventosAmbiente para coleta de eventos de Grafana. No seu console Grafana, defina seu Now Platforminstância como endpoint rest usando um webhook padrão.

Nota:

Execute as etapas 1 e 2 para Grafana v7.4.3. Para Grafana v9.3.2. vá para a etapa 3.

Procedimento

Grafana v7.4.3

1. No console do Grafana, crie um canal de notificação:
   1. Navegar até Alerta > Canais de Notificação.
   2. Clique em Novo canal e selecione o tipo como Webhook .
   3. Insira um URL.
      Por exemplo, use https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana .
   4. Em Webhook opcional , selecione o método HTTP, PUBLICAÇÃO e insira o nome de usuário e a senha do relevante ServiceNowusuário.
      Nota:

      Certifique-se de que a função evt_mgmt_integration seja atribuída ao usuário selecionado. Para garantir a autenticação adequada, use o usuário menos privilegiado com a função evt_mgmt_integration, em vez de um usuário com alto privilégio.
   5. Clique em Teste para verificar a conexão.
2. No console do Grafana, crie regras de alerta.
   1. Clique em Editar no painel necessário e, em seguida Criar alerta .
   2. Em Alerta adicione os seguintes marcadores:

      Marcadores	Descrição
      Gravidade	(Este marcador é opcional e precisa estar em minúsculas.) Gravidade com a qual o alerta deve ser criado.
      Contagem	(Este marcador é obrigatório, caso contrário, os alertas não serão encerrados automaticamente em ServiceNow.) O número de dispositivos, hosts ou servidores monitorados por esta regra de alerta.

   3. Adicione o canal de notificação em Notificações na regra de alerta.
   4. Clique em Salvar.
   5. Navegar até Alerta > Regras de Alerta para acessar a regra criada.

Grafana v9.3.2.

3. No console do Grafana, crie um ponto de contato.
   1. Navegar até Alerta > Pontos de contato.
   2. Clique em Novo ponto de contato , insira um nome e selecione o tipo como Webhook .
   3. Insira um URL.
      Por exemplo, use https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana .
   4. Em Webhook opcional , selecione o método HTTP, PUBLICAÇÃO e insira o nome de usuário e a senha do relevante ServiceNowusuário.
      Nota:

      Certifique-se de que a função evt_mgmt_integration seja atribuída ao usuário selecionado. Para garantir a autenticação adequada, use o usuário menos privilegiado com a função evt_mgmt_integration, em vez de um usuário com alto privilégio.
   5. Clique em Salvar e. Teste para verificar a conexão.
4. No console do Grafana, crie uma política de notificação.
   1. Navegar até Alerta > Políticas de notificação.
   2. Selecione Nova política , adicione combinadores.
      Os combinadores são rótulos que direcionam regras de alerta para o ponto de contato.
   3. Selecione seu ponto de contato.
   4. Selecione Salvar política .
5. No console do Grafana, crie regras de alerta.
   1. Navegar até Alerta > Regra de Alerta.
   2. Selecione Nova regra .
   3. Defina a condição Consulta e alerta.
   4. Defina a fonte de dados, as métricas e os filtros necessários.
   5. Defina o comportamento de avaliação do alerta.
   6. Insira o nome da regra.
   7. Na seção Resumo e anotações, adicione um resumo ou uma descrição.
   8. Na rolagem para baixo, selecione Adicionar novo .
   9. Insira o nó, o recurso e as informações da métrica.
      Essas informações são necessárias para os campos node, resource e metric_name do evento.

      Nota:

      Use a cadeia de caracteres de valor para passar esses valores. Por exemplo, um nó pode ser values.C0.Labels.instance.
   10. Em Rótulos personalizados, forneça os rótulos necessários para direcionar suas notificações para o ponto de contato apropriado.
       Nota:

       Você também pode passar a gravidade em rótulos personalizados. O mesmo é usado para eventos. As opções de gravidade disponíveis são: Crítica, grave, secundária, aviso.
   11. Clique em Salvar.

Resultado

Os alertas começam a fluir do Grafana para o plug-in Gestão de eventos. O plug-in extrai informações da mensagem de alerta original do Grafana para preencher os campos de evento obrigatórios e insere o evento no banco de dados. Em seu Now Platforminstância, navegue até Todos os eventos para ver os eventos.

Nota:

• Para Grafana v7.4.3, você pode ver eventos extra claros entrando ServiceNowque não estão vinculados a um alerta. Ignore-os, pois eles foram criados para superar o problema de Grafana não enviar informações na notificação clara.
• Um parâmetro de gravidade é adicionado, que é usado somente para Grafana 8 e superior. O valor fornecido será usado como uma gravidade para um evento se a gravidade não for passada em rótulos personalizados.

• Integre o Grafana com o token de chave da REST API
  Integre usando uma chave de API para estabelecer comunicação segura e automatizar a troca de dados por meio da REST API. Isso simplifica a integração, permitindo o acesso contínuo aos serviços e aumentando a eficiência operacional.