Integrar eventos de ponto de encatch

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Integrar Catchpoint com Gestão de eventos Adicionando um webhook de alerta na plataforma Catchpoint.

    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.

    Função necessária: evt_mgmt_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Configure o. Gestão de eventos Ambiente para a coleta de eventos do ponto de enroscamento autenticando o ponto de enroscamento como uma fonte de dados. Na plataforma Catchpoint, defina seu ServiceNow AI Platform como o endpoint rest usando um webhook.

    Procedimento

    1. Na plataforma Catchpoint, crie um destino de webhook de alerta.
      1. Faça login na plataforma do Catchpoint.
      2. Navegar até Catchpoint > Configuração > API > Webhook de dados de alerta para definir o endpoint do webhook.
      3. No Webhook de alerta de API, forneça os seguintes detalhes.
        Tabela 1. Formulário do webhook de alerta de API
        Campo Valor
        Nome Qualquer nome baseado em seu requisito.
        URL O formato padrão da URL para enviar eventos por push do Ponto de captura para ServiceNow AI Platform instância, https://<username>:<password> em <instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=catchpoint .
        No alerta de falha O endereço de e-mail do webhook do alerta de API.
        Gatilho de notificação Selecione com base em seus requisitos. O valor padrão é 3.
        Adicione os seguintes cabeçalhos
        • Autorização: Básico (Base 64 | username:password)
        • Content-Type: aplicação/json
        Formato Selecione Modelo e adicione o seguinte modelo:
        {
        "Source": "CatchPoint",
        "severity": "${notificationLevelId}",
        "alertType": "${AlertType}",
        "time_of_event": "${alertCreateDateUtc(YYYY-MM-DD HH:MI:SS)}",
        "monitorType": "${Switch(${MonitorTypeId},'0', 'IE','2', 'Object','3','Emulated','8', 'Ping','9', 'Tracert','10', 'DNS-Traversal','11', 'Ping-TCP','12', 'DNS-Exp', '13','DNS-Direct', '14','Tracert-UDP', '15', 'Port-TCP','16', 'FTP','17', 'Data-Push-API','18', 'Chrome','19', 'Playback', '20', 'Playback-Mobile', '21', 'SMTP', '22', 'Port-UDP', '23', 'Ping-UDP', '24', 'Streaming', '25', 'API', '26', 'Mobile',
         '27', 'SFTP', '28', 'SSH', '29', 'Tracert-TCP')}",
        "testName": "${TestName}",
        "testId": "${TestId}",
        "testUrl": "${TestUrl}",
        "testPath": "${testPath}",
        "testLink": "${testLink}",
        "productName": "${ProductName}",
        "clientId": "${ClientId}",
        "productId": "${productId}",
        "nodeName":"${nodeDetails("${nodeName}")}",
        "nodeClientServerAddress":"${nodeDetails(\"${NodeClientAddress},\"),}",
        "nodeServerAddress":  "${nodeDetails(\"${nodeServerAddress},\"),}",
        "Labels" : "${testLabels}",
        "addtionalInformation": "Test initial URL: ${testUrl}\n\nAlert type: ${AlertType}\n\nScatter Chart: ${scatterplotChartURL}\n\nWaterfall Chart: ${waterfallChartURL}\n\nTest properties: ${testLink}\n\nTest time of run / Test time of alert (Central Time): ${reportDateLocal(YYYY-MM-DD HH:MI:SS)} / ${alertCreateDateLocal(YYYY-MM-DD HH:MI:SS)}"}
        
    2. Para os testes de monitoramento de endpoint HTTP, em ServiceNow Crie um IC.
      Nota:
      O Conector de ponto de enroscamento oferece suporte a vários tipos de testes de monitoramento, como endpoint, rede e outros. As etapas a seguir se aplicam somente aos testes de monitoramento de endpoint HTTP.
      1. Navegar até Configuração > Gerenciador de Classes de IC.
      2. Clique em Hierarquia e pesquise Endpoint HTTP(S) .
      3. No campo Tipo de IC, selecione cmdb_ci_endpoint_http .
      Se os serviços não forem modelados, você deverá adicionar manualmente os ICs na tabela [cmdb_ci_endpoint_http]. Além disso, o endpoint manual deve ser removido antes da descoberta automática de serviços. Para vinculações de IC de outros testes de tipo, você pode criar regras de evento com base em seus requisitos.

    Resultado

    Os alertas começam a fluir do Conector de ponto de catchpoint para o plug-in Gestão de eventos. A tabela a seguir mostra como o mapeamento de gravidade do ponto de enroscamento se traduz em ServiceNow mapeamento.

    Tabela 2. Níveis de gravidade entre Catchpoint e ServiceNow
    Severidade do Catchpoint Severidade da ServiceNow
    0 Aviso
    1 Crítico
    2/3 Limpar