Integrar eventos do Grafana

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura

    • 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.
    1. 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.
    2. 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 correspondências.
        Combinadores são rótulos que direcionam as regras de alerta para o ponto de contato.
      3. Selecione seu ponto de contato.
      4. Selecione Salvar política.
    3. No console do Grafana, crie regras de alerta.
      1. Navegar até Alerta > Regra de Alerta.
      2. Selecione Nova regra.
      3. Defina a consulta e a condição de 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 o nó, o recurso e as informações de métrica.
        Essas informações são necessárias para os campos de nó, recurso 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 severidade disponíveis são: crítica, principal, secundária e aviso.
      11. Clique em Salvar.

    Resultado

    Os alertas começam a fluir do Grafana para o plug-in Event Management. 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. Na instância Now Platform, navegue até Todos os eventos para ver os eventos.

    Nota:
    • Para o Grafana v7.4.3, você pode ver eventos extra claros entrando em ServiceNow que não estão vinculados a um alerta. Ignore-os, pois eles são criados para superar o problema do Grafana que não envia informações na notificação de limpeza.
    • Um parâmetro de severidade é adicionado, que é usado somente para 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.