Integrar eventos do catchpoint

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Integre o Catchpoint ao Gestão de eventos adicionando um webhook de alerta na plataforma do Catchpoint.

    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.

    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 Catchpoint autenticando o Catchpoint como uma fonte de dados. Na plataforma do Catchpoint, defina seu Now Platform como o endpoint REST usando um webhook.

    Procedimento

    1. Na plataforma do 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 do Ponto de Captura para a instância Now Platform, https://<username> :<password> @<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ásica {Base 64 | nome de usuário:senha}
        • Tipo de conteúdo: application/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 do endpoint HTTP, na instância ServiceNow, crie um IC.
      Nota:
      O conector do Catchpoint 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 do 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 outras vinculações de IC de testes de tipo, você pode criar regras de evento com base em seus requisitos.

    Resultado

    Os alertas começam a fluir do conector do Catchpoint para o plug-in Gestão de eventos. A tabela a seguir mostra como o mapeamento de severidade do Catchpoint se traduz no mapeamento ServiceNow.

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