Intégrer des événements CatchPoint

Intégrez Catchpoint à Gestion des événements en ajoutant un webhook d’alerte dans la plateforme Catchpoint.

Avant de commencer

Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance ServiceNow AI Platform .

Rôle requis : evt_mgmt_admin

Pourquoi et quand exécuter cette tâche

Configurez l’environnement Gestion des événements pour la collecte des événements à partir de Catchpoint en authentifiant Catchpoint comme source de données. Dans la plateforme Catchpoint, définissez votre ServiceNow AI Platform point de terminaison REST à l’aide d’un webhook.

Procédure

1. Dans la plateforme CatchPoint, créez une destination webhook d'alerte.
   1. Connectez-vous à la plateforme CatchPoint.
   2. Accédez à la CatchPoint > Paramètre > API > Webhook de données d’alerte pour définir le point de terminaison du webhook.
   3. Dans le webhook d'alerte d'API, fournissez les détails suivants.

      Tableau 1. Formulaire Webhook d'alerte d'API

      Champ	Valeur
      Nom	Spécifiez le nom de votre choix, en fonction de vos besoins.
      URL	Format par défaut de l’URL pour transmettre par push les événements du point de capture à l’instance ServiceNow AI Platform , https://<nom d’utilisateur> :<mot de passe>@<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=catchpoint.
      Alerte en cas d'échec	Adresse e-mail du webhook d'alerte d'API.
      Déclencheur de notification	Sélectionnez en fonction de vos besoins. La valeur par défaut est de 3.
      Ajouter les en-têtes suivants	Autorisation : basique {Base 64 | username :password} Type de contenu : application/json
      Format	Sélectionnez un modèle et ajoutez le modèle suivant : { "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. Pour les tests de surveillance du point de terminaison HTTP, dans l’instance ServiceNow , créez un CI.
   Remarque :

   Le connecteur Catchpoint prend en charge plusieurs types de tests de surveillance, notamment Point de terminaison, Mise en réseau, entre autres. Les étapes suivantes s’appliquent uniquement aux tests de surveillance du point de terminaison HTTP.
   1. Accédez à la Configuration > Gestionnaire de classe de CI.
   2. Cliquez sur Hiérarchie et recherchez Point de terminaison HTTP(S).
   3. Dans le champ Type de CI, sélectionnez cmdb_ci_endpoint_http.
   Si les services ne sont pas modélisés, vous devez ajouter manuellement les CI sous la table [cmdb_ci_endpoint_http]. En outre, le point de terminaison manuel doit être supprimé avant la découverte automatique des services. Pour d’autres types de test de liaisons de CI, vous pouvez créer des règles d’événements en fonction de leurs besoins.

Résultats

L’envoi des alertes du connecteur Catchpoint au module d’extension Gestion des événements commence. La table suivante montre comment le mappage de gravité CatchPoint se traduit dans le ServiceNow mappage.

Tableau 2. Niveaux de gravité entre CatchPoint et ServiceNow

Gravité CatchPoint	Gravité ServiceNow
0	Warning
1	Critique
2/3	Effacer