Intégrer des événements CatchPoint

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • 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 Now Platform .

    Rôle requis : evt_mgmt_integration

    Pourquoi et quand exécuter cette tâche

    Configurez l'environnement Gestion des événements pour la collecte d'événements à partir de CatchPoint en authentifiant CatchPoint en tant que source de données. Dans la plateforme CatchPoint, définissez votre Now Platform en tant que 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 Le format par défaut de l'URL pour transmettre par Push les événements de CatchPoint à l'instance Now Platform est le suivant : 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 cette option en fonction de vos besoins. La valeur par défaut est de 3.
        Ajouter les en-têtes suivants
        • Autorisation : De base {Base64 | nom d'utilisateur:mot de passe}
        • Type de contenu : application/json
        Format Sélectionnez 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, etc. 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, puis recherchez le 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 dans la table [cmdb_ci_endpoint_http]. En outre, le point de terminaison manuel doit être supprimé avant la détection automatique des services. Pour d'autres types de tests 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 Event Management commence. La table suivante montre comment le mappage de gravité CatchPoint se traduit dans le mappage ServiceNow.

    Tableau 2. Niveaux de gravité entre CatchPoint et ServiceNow
    Gravité CatchPoint Gravité ServiceNow
    0 Warning
    1 Critique
    2/3 Effacer