Integrar eventos do Grafana

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

Antes de Iniciar

• Certifique-se de que o plug-in Gestão de eventos Connectors (sn_em_connector) esteja instalado na instância Now Platform.
• O plug-in Gestão de eventos deve ser instalado na instância Now Platform.
• A vinculação de IC acontece por meio do IP. As instâncias devem ser descobertas como servidores para iniciar a vinculação. Os ICs descobertos por meio da nuvem ou ICs em cmdb_ci_vm_object não são vinculados, 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 ambiente Gestão de eventos para a coleção de eventos do Grafana. No console do Grafana, defina sua instância Now Platform como o endpoint REST usando um webhook padrão.

Nota:

Execute as etapas 1 e 2 para o 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é 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. Nas configurações opcionais do WebHook, selecione o Método HTTP, POSTe insira o nome de usuário e a senha do usuário ServiceNow relevante.
      Nota:

      Certifique-se de que o usuário selecionado esteja atribuído à função evt_mgmt_integration. Para garantir a autenticação apropriada, use o usuário com menos privilégios com a função evt_mgmt_integration, em vez de um usuário com privilégios altos.
   5. Clique em Testar para verificar a conexão.
2. No console do Grafana, crie regras de alerta.
   1. Clique em Editar no painel necessário e em Criar alerta.
   2. Na guia Alerta, adicione os seguintes marcadores:

      Marcadores	Descrição
      Gravidade	(Este marcador é opcional e deve ser minúsculo.) Severidade 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é 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. Nas configurações opcionais do WebHook, selecione o Método HTTP, POSTe insira o nome de usuário e a senha do usuário ServiceNow relevante.
      Nota:

      Certifique-se de que o usuário selecionado esteja atribuído à função evt_mgmt_integration. Para garantir a autenticação apropriada, use o usuário com menos privilégios com a função evt_mgmt_integration, em vez de um usuário com privilégios altos.
   5. Clique em Salvar e testar 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íticae adicione correspondentes.
      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 de 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 de resumo e anotações, adicione um resumo ou uma descrição.
   8. Na rolagem para baixo, selecione +Adicionar novo.
   9. Insira as informações de nó, recurso e 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 severidade disponíveis são: crítico, principal, 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 obrigatórios e insere o evento no banco de dados. Em sua instância Now Platform, navegue até Todos Eventos para ver os eventos.

Nota:

• Para o Grafana v7.4.3, você pode ver eventos claros extras entrando em ServiceNow que não estão vinculados a um alerta. Ignore-as, pois foram criadas para superar o problema de o Grafana não enviar informações na notificação de limpeza.
• Foi adicionado um parâmetro de severidade que é usado somente para o Grafana 8 e superior. O valor fornecido será usado como severidade para um evento se a severidade não for aprovada em rótulos personalizados.