Configurer un connecteur personnalisé d’événement

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 8 minutes de lecture

    • Authentifiez votre connecteur personnalisé d’événement en tant que source de données pour permettre la transmission par push des informations d’événement à votre ServiceNow instance. Définissez le connecteur personnalisé en fournissant ses détails et ses champs de mappage. Cela permet aux informations extraites des messages d’événement de votre connecteur personnalisé de renseigner les champs d’événement requis. Enfin, créez et fournissez une URL pour le webhook du connecteur personnalisé.

    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 . Pour plus d'informations, consultez Configurer les Gestion des événements connecteurs.
    • Vérifiez que les éléments de configuration relatifs aux hôtes gérés par votre connecteur personnalisé existent dans l’instance ServiceNow AI Platform . Ces CI peuvent être physiques ou virtuels, et peuvent être créés manuellement ou découverts via la découverte d’adresses IP ou Découverte dans le cloud. Pour plus d'informations, consultez Accès aux environnements cloud pour ITOM les produits.

    Rôle requis : evt_mgmt_admin

    Pourquoi et quand exécuter cette tâche

    Pour transmettre par push les informations d’événement à votre ServiceNow instance, vous devez définir votre ServiceNow AI Platform instance en tant que point de terminaison REST à l’aide d’un webhook standard sur votre connecteur personnalisé.

    En fournissant les détails du connecteur et les champs de mappage, vous définissez le connecteur personnalisé. Les informations extraites des messages d’événement du connecteur personnalisé remplissent ensuite les champs d’événement requis et insèrent l’événement dans la base de données.

    L’URL est générée par le code en fonction de l’instance ServiceNow et du connecteur personnalisé. Utilisez cette URL pour créer un webhook qui permet à votre connecteur personnalisé d’envoyer des événements à l’instance ServiceNow .

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail pour l'exploitation des services.
    2. En bas du volet de navigation, sélectionnez l’icône Centre de configuration ITOM AIOps Icône Centre de configuration AIOps.
      La ITOM page Centre de configuration AIOps s’affiche. Le centre de configuration est un espace de travail centralisé. Utilisez-le pour configurer et gérer les fonctionnalités AIOps à partir d’un seul endroit.
    3. Sur la page Centre de configuration ITOM AIOps, sous Configuration > Intégrations , sélectionnez Gérer les intégrations installées.
    4. Dans l’onglet Parcourir les intégrations , sélectionnez la liste déroulante Toutes les intégrations et sélectionnez Personnalisé.
      Seules les tuiles de connecteur personnalisées sont affichées.
      Figure 1. Connecteurs par push
      Filtrage avec des connecteurs personnalisés
    5. Sélectionnez une mosaïque de type de connecteur personnalisée.
    6. Sur la page Fournir les détails , fournissez les détails du connecteur.
      Figure 2. Page des détails des connecteurs personnalisés
      Page des détails du connecteur personnalisé
      1. Dans le champ Nom du connecteur , saisissez un nom d’intégration unique pour le connecteur.
      2. Facultatif : Dans le champ Balises , saisissez des balises pour faciliter la localisation et l’identification des connecteurs de ce type sur le Liste express.
        Pour ajouter des balises supplémentaires, sélectionnez l’icône plus ( signe Plus pour ajouter d’autres balises.) en regard du champ Balises . La fenêtre Ajouter des balises s’ouvre.
        1. Dans le champ Clé , entrez une clé de balise.
        2. Dans le champ Valeur , saisissez une valeur de balise.
        3. Sélectionnez Ajouter.
      3. Facultatif : Dans le champ Description , saisissez de brèves informations sur ce connecteur.
      4. Dans le champ Source , saisissez le fournisseur utilisé pour collecter les événements à partir de la source d’événement externe.

        Le champ Source identifie le connecteur et sert d’identificateur pour reconnaître la source des événements et des alertes une fois que le connecteur est actif.

      5. Facultatif : Dans la liste déroulante Groupe d’affectation , sélectionnez le groupe ou l’équipe responsable de la gestion et de la maintenance du connecteur.
    7. Facultatif : Faites glisser ou chargez une image à afficher dans la vignette de votre connecteur.
      • Faites glisser une image dans la zone.
      • Accédez au fichier image en sélectionnant Charger une image , puis choisissez le fichier.
      La taille maximale du fichier téléchargé est de 1 Mo.
    8. Déterminez si vous souhaitez connecter les événements directement à l’instance ITOM ou via un Serveur MID.

      • Pour envoyer les événements directement à l’instance ITOM , sélectionnez Directement à l’instance ITOM.

      • Pour envoyer des événements via un Serveur MID, qui traite l’événement puis les transmet à l’instance, sélectionnez Via le serveur MID.

        S’il Serveur MID existe, dans le champ Sélectionner un serveur MID , sélectionnez un Serveur MID connecté disponible à un écouteur d’événements.

        Si vous devez créer un , sélectionnez l’une Serveur MID des options suivantes.
        • Configurer l'extension du serveur Web MID
        • Configurer le contexte du collecteur d'événements de service Web du MID
        Pour plus d'informations, consultez Configurer l’extension Serveur Web MID et Configurer le contexte du module de collection d’événements MID WebService.
    9. Sélectionnez Suivant.
      Méthode d’entrée du connecteur personnalisé
    10. Sur la page Configurer la méthode d’entrée , sélectionnez une méthode pour collecter des données d’événement.
      MéthodeDescription
      Collecter des événements sources réels pour définir des champs
      1. Sélectionnez Collecter les événements sources réels pour définir les champs.
        Remarque :
        En collectant des événements sources réels à partir de votre connecteur personnalisé, vous augmentez la précision des événements et des alertes en utilisant plusieurs événements comme référence pour définir les champs.
      2. Sélectionnez Copier dans le presse-papiers et copiez l’URL.
      3. Collez l’URL dans la configuration du webhook de votre connecteur personnalisé pour créer un webhook qui permet à votre connecteur personnalisé d’envoyer des événements à l’instance ServiceNow . Saisissez vos informations d’identification d’authentification de base dans la configuration Webhook du système de surveillance (telles que le nom d’utilisateur et le mot de passe). Le webhook permet à votre connecteur personnalisé d’envoyer des événements à l’instance.
      4. Sélectionnez Rechercher les événements. Nombre d’événements affichés. L’événement crée des fichiers JSON que vous pouvez parcourir après avoir sélectionné Suivant.
      Utiliser un exemple JSON pour mapper les champs
      1. Sélectionnez Use a JSON sample to map fields (Utiliser un exemple JSON pour mapper les champs).
        Remarque :
        Si vous disposez d’un exemple de JSON, sélectionnez cette option.
      2. Dans la boîte de dialogue Entrer la charge utile , copiez et collez votre exemple de charge utile JSON pour créer et afficher le mappage des champs.
        Chargement de la charge utile JSON du connecteur personnalisé
      3. Sélectionnez Charger le JSON.
      4. Sélectionnez Modifier ou collez le nouveau JSON pour modifier le JSON que vous avez chargé ou collez-en un nouveau.
      5. Sélectionnez Copier dans le presse-papiers et copiez l’URL.
      6. Collez l’URL dans la configuration du webhook de votre connecteur personnalisé pour créer un webhook qui permet à votre connecteur personnalisé d’envoyer des événements à l’instance ServiceNow . Saisissez vos informations d’identification d’authentification de base dans la configuration Webhook du système de surveillance (telles que le nom d’utilisateur et le mot de passe). Le webhook permet à votre connecteur personnalisé d’envoyer des événements à l’instance.
    11. Sélectionnez Suivant.
      La page s’ouvre, dans laquelle vous pouvez mapper les champs.
      Page d’option de mappage de champ de connecteur personnalisé.
    12. Sur la page Mapper les champs , dans la colonne Noms de champs de connecteur, entrez au moins une valeur qui correspond aux valeurs de gravité répertoriées dans la colonne ServiceNow Gravité du champ.
    13. Sur la page Mapper les champs , dans la colonne Noms de champs de connecteur, entrez au moins une valeur qui correspond aux valeurs de gravité répertoriées dans la colonne ServiceNow Gravité du champ.

      Vous pouvez entrer la valeur de gravité à partir de l’exemple de code JSON. Pour définir une valeur de gravité, vous devez connaître la charge utile de votre connecteur personnalisé et les types de gravité qu’il prend en charge. Les valeurs de gravité des événements reçus doivent correspondre aux événements générés dans votre système.

      Permettez au système de créer correctement des événements à partir des données entrantes en mappant les champs de votre exemple de code JSON aux ServiceNow champs. Les informations clés de gravité et de message sont automatiquement renseignées pour vous faire gagner du temps et de l’énergie. La clé de message fournit l’identificateur correct pour les événements, ce qui garantit que la déduplication fonctionne correctement et que des alertes redondantes ne sont pas générées.

    14. Facultatif : Pour afficher plusieurs fichiers JSON, sélectionnez la flèche au-dessus de l’exemple JSON.
    15. Facultatif : Dans la section Autres champs, dans la colonne de votre connecteur , spécifiez des paramètres d’événement personnalisés qui sont facultatifs mais fournissent des informations supplémentaires sur l’événement.
      Si vous choisissez de ne pas fournir les informations facultatives, laissez le champ vide.
      1. Dans le champ Description , saisissez une description explicite de l’alerte.
      2. Dans le champ Nom de la mesure , entrez un nom de mesure qui vous permet d’associer des événements aux mesures de performance ou aux KPI ayant déclenché l’alerte.
      3. Dans le champ Nœud , entrez une valeur de nœud à utiliser pour la liaison de CI.
      4. Dans le champ Heure de l’événement , entrez l’heure de création de l’événement du connecteur personnalisé.
        Si l’heure de l’événement n’est pas mappée, le système utilise l’heure de l’événement par défaut.
      5. Dans le champ Paramètres d’heure de l’événement , sélectionnez le format d’heure et le fuseau horaire de l’événement.
        • Format d’heure : champ GlideDateTime au format UTC ou GMT, d’une longueur maximale de 40 caractères.
        • Fuseau horaire : les heures sont stockées en heure universelle coordonnée (UTC) et sont affichées globalement en fonction du fuseau horaire du système.
    16. Activez et enregistrez le connecteur en sélectionnant Activer , puis OK dans la fenêtre contextuelle de confirmation.
      Vous pouvez afficher les détails du connecteur dans l’onglet Détails et vos mappages de champs dans l’onglet Mappage des champs .

    Résultats

    Une fois le connecteur activé, les événements commencent à circuler de la console de votre connecteur personnalisé vers l’instance ServiceNow . Le module d’extension extrait les informations du message d’événement du connecteur personnalisé d’origine pour renseigner les champs d’événement requis et insère l’événement dans la base de données. Pour afficher les événements dans votre ServiceNow AI Platform instance, naviguez vers Tous les événements. Pour plus d'informations, consultez Afficher les événements.

    Que faire ensuite

    Pour vérifier que le processus s’est déroulé avec succès et que les événements circulent dans le système, affichez les événements connexes dans l’onglet Événements connexes . Si la configuration réussit, passez à Ajouter une automatisation pour établir une automatisation d’alerte. Pour en savoir plus sur l’automatisation des alertes, reportez-vous à la section Automatisation des alertes dans Espace de travail pour l'exploitation des services pour ITOM.