Catchpoint-Ereignisse integrieren

Integrieren Sie Catchpoint mit Ereignismanagement, indem Sie auf der Catchpoint-Plattform einen Warnungs-Webhook hinzufügen.

Vorbereitungen

Stellen Sie sicher, dass Ereignismanagement Plugin „Connectors“ (sn_em_Connector) ist auf installiert ServiceNow AI Platform Instanz.

Erforderliche Rolle: evt_mgmt_admin

Warum und wann dieser Vorgang ausgeführt wird

Konfigurieren Sie die Ereignismanagement-Umgebung für die Erfassung von Ereignissen aus Catchpoint, indem Sie Catchpoint als Datenquelle authentifizieren. Legen Sie auf der Catchpoint-Plattform die ServiceNow AI Platform mit einem Webhook als REST-Endpunkt fest.

Prozedur

1. Erstellen Sie auf der Catchpoint-Plattform ein Warnungs-Webhook-Ziel.
   1. Melden Sie sich bei der Catchpoint-Plattform an.
   2. Navigieren zu Catchpoint > Einstellung > API > Warnungsdaten-Webhook Zum Festlegen des Webhook-Endpunkts.
   3. Geben Sie im API Alert Webhook (API-Warnungs-Webhook) die folgenden Details an.

      Tabelle : 1. Formular „API Alert Webhook“ (API-Warnungs-Webhook)

      Feld	Wert
      Name	Beliebiger Name basierend auf Ihren Anforderungen.
      URL	Das Standardformat der URL zum Übertragen von Ereignissen von Catchpoint an die ServiceNow AI Platform-Instanz ist https://<username>:<password>@<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=catchpoint.
      On Failure Alert (Bei Fehlerwarnung)	E-Mail-Adresse für den API-Warnungs-Webhook.
      Notification Trigger (Benachrichtigungsauslöser)	Wählen Sie diesen je nach Ihren Anforderungen aus. Der Standardwert ist 3.
      Add the following headers (Folgende Header hinzufügen)	Autorisierung: Basic {Base 64 | username:password} Inhaltstyp: application/json
      Format	Wählen Sie Vorlage aus, und fügen Sie die folgende Vorlage hinzu: { "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. Erstellen Sie für die Tests zur HTTP-Endpunktüberwachung in der ServiceNow-Instanz ein CI (Configuration Item).
   Hinweis:

   Der Catchpoint-Connector bietet Unterstützung für mehrere Arten von Überwachungstests wie Endpunkt, Netzwerk und andere. Die folgenden Schritte gelten nur für die Tests zur HTTP-Endpunktüberwachung.
   1. Navigieren zu Konfiguration > CI-Klassen Manageran.
   2. Klicken Sie auf Hierarchie und suchen Sie nach HTTP(S)-Endpunkt.
   3. Wählen Sie im Feld „CI-Typ“ cmdb_ci_endpoint_http aus.
   Wenn die Services nicht modelliert werden, sollten Sie die CIs manuell unter der Tabelle [cmdb_ci_endpoint_http] hinzufügen. Außerdem sollte der manuelle Endpunkt vor der automatischen Erkennung von Services entfernt werden. Für CI-Bindungen anderer Typen von Tests können Sie Ereignisregeln basierend auf den jeweiligen Anforderungen erstellen.

Ergebnisse

Die Übertragung von Warnungen vom Catchpoint-Connector in das Plugin „Event Management“ beginnt. Aus folgender Tabelle ist ersichtlich, wie die Zuordnung des Catchpoint-Schweregrads in die Zuordnung im ServiceNow-System übertragen wird.

Tabelle : 2. Vergleich der Schweregradstufen zwischen Catchpoint und ServiceNow

Catchpoint-Schweregrad	ServiceNow-Schweregrad
0	Warnung
1	Kritisch
2/3	Leeren