Integrar eventos Grafana

Integrar Grafana com Gestão de eventos Adicionando um webhook padrão no console do Grafana.

Antes de Iniciar

• Certifique-se de que Gestão de eventos O plug-in Conectores (sn_em_connector) está instalado no ServiceNow AI Platform instância.
• . Gestão de eventos o plug-in deve ser instalado no ServiceNow AI Platform instâ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 informações para IDs de objeto.
• Função necessária: evt_mgmt_integration

Por Que e Quando Desempenhar Esta Tarefa

Configure o. Gestão de eventos Ambiente para coleta de eventos do Grafana. No console Grafana, defina seu ServiceNow AI Platform instância como o endpoint rest usando um webhook padrão.

Nota:

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

Procedimento

Grafana v7.4.3

1. No console do Grafana, crie um canal de notificação.
   1. Navegar até Alertas > 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, PUBLICAR e insira o nome de usuário e a senha do relevante ServiceNow usuário.
      Nota:

      Certifique-se de que o usuário selecionado receba a função evt_mgmt_integration. 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 deve ser em minúsculas.) Gravidade com a qual o alerta deve ser criado.
      Contagem	(Este marcador é necessá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é Alertas > 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é Alertas > 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, PUBLICAR e insira o nome de usuário e a senha do relevante ServiceNow usuário.
      Nota:

      Certifique-se de que o usuário selecionado receba a função evt_mgmt_integration. 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é Alertas > Políticas de notificação.
   2. Selecione Nova política , adicione correspondências.
      Correspondências são rótulos que direcionam regras de alerta para o ponto de contato.
   3. Selecione o seu ponto de contacto.
   4. Selecione Salvar política .
5. No console do Grafana, crie regras de alerta.
   1. Navegar até Alertas > 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 de 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 severidade em rótulos personalizados. O mesmo é usado para eventos. As opções de gravidade disponíveis são: Crítica, grave, secundário, 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 necessários e insere o evento no banco de dados. Em seu ServiceNow AI Platform instância, navegue até Todos os eventos para ver os eventos.

Nota:

• Para Grafana v7.4.3, você pode ver eventos extra claros entrando ServiceNow que 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 severidade é adicionado, que é usado somente para Grafana 8 e superior. O valor fornecido será usado como uma severidade para um evento se a severidade não for passada em rótulos personalizados.

• Integre o Grafana ao token de chave da REST API
  Integre usando uma chave de API para estabelecer uma 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 melhorando a eficiência operacional.