Catchpoint-Ereignisse integrieren

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

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

    Vorbereitungen

    Stellen Sie sicher, dass das Plugin Ereignismanagement „ Connectors (sn_em_connector)“ in der Instanz Now Platform installiert ist.

    Erforderliche Rolle: evt_mgmt_integration

    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 Now 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 um den Webhook-Endpunkt festzulegen.
      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 Now 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 Manager.
      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