Configurer une intégration de REST API pour Analyse de l'intégrité des journaux

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

    • Configurez une intégration pour diffuser les données du journal vers votre instance afin qu’elles ServiceNow soient traitées par Analyse de l'intégrité des journaux.

    Avant de commencer

    • Vérifiez que l’application Analyse de l'intégrité des journaux est installée et mise en service sur votre instance. Pour plus d'informations, consultez Installation Analyse de l'intégrité des journaux (HLA).
    • Vérifiez qu’une instance de service est disponible.
    • Vérifiez que le moteur d’IA Analyse de l'intégrité des journaux est opérationnel.
    • Vérifiez qu’un Serveur MID est installé et configuré avec l’aptitude d’ingestion de journal activée. Pour plus d'informations, consultez MID Server system requirements.

      Configuration du Serveur MID avec l’aptitude d’ingestion de journaux activée.

      Important :
      Analyse de l'intégrité des journaux ne prend pas en charge IPv6. Pour utiliser l'application, configurez le Serveur MID sur IPv4.

      Dans le formulaire Contexte du serveur Web MID, dans le champ Exécuter sur , sélectionnez Serveur MID spécifique et non l’option de grappe. Dans le champ Serveur MID , sélectionnez le serveur spécifique Serveur MID vers lequel les données de journal sont extraites.

    • À moins que les Serveur MID clients externes ne se trouvent sur le même réseau, ils Serveur MID doivent avoir une adresse IP publique. Cela est nécessaire lorsque son adresse IP est exposée via la traduction d’adresses réseau (NAT), un équilibreur de charge ou un appareil similaire. L’adresse IP publique permet aux clients externes, tels que les Filebeat agents situés en dehors de son réseau, d’atteindre le Serveur MID. Les adresses IP privées ne sont pas routables sur Internet. Sans adresse IP publique, les clients externes ne peuvent pas se connecter au Serveur MID même s’ils sont configurés avec son adresse. Dans les propriétés Serveur MID, ajoutez une propriété nommée mid.public_ip avec l'adresse IP publique comme valeur. Pour plus d'informations, voir Créer une propriété de MID Server. Si les clients et les Serveur MID clients externes se trouvent sur le même réseau, les connexions peuvent être établies à l’aide de l’adresse IP privée.
    Remarque :
    Les intégrations d’API REST prennent uniquement en charge le codage UTF-8 pour les données entrantes.

    Rôle requis : evt_mgmt_admin

    Pourquoi et quand exécuter cette tâche

    Vous configurez les intégrations via la zone de lancement des intégrations dans Espace de travail pour l'exploitation des services, à laquelle vous accédez à partir du centre de configuration ITOM AIOps. Le centre de configuration AIOps est un espace de travail centralisé permettant de configurer et de gérer les fonctionnalités AIOps à partir d’un seul endroit. Le processus de configuration des intégrations réduit le temps d’implémentation par rapport à la configuration manuelle des entrées de données dans l’interface classique dans Analyse de l'intégrité des journaux. Pour plus d'informations, consultez Lanceur d'intégrations dans Espace de travail pour l'exploitation des services pour ITOM.

    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. Dans la section Intégrer, sous Intégrations, sélectionnez Ajouter une intégration.
      La zone de lancement des intégrations s’affiche.
    4. Dans l’onglet Parcourir les intégrations , entrez REST dans le champ de recherche.
    5. Sélectionnez la vignette d’intégration de l’API REST.
      Remarque :
      Si vous démarrez une configuration d’intégration avant de remplir toutes les conditions préalables, un message s’affiche. Vous pouvez annuler la configuration et remplir d’abord les exigences précédentes. Vous pouvez également continuer en mode brouillon et remplir les besoins ultérieurement. Notez que vous ne pouvez pas activer l’intégration tant que vous n’avez pas rempli toutes les conditions préalables.
    6. Renseignez les champs du formulaire Fournir des détails .
      Pour obtenir une description des champs, consultez la rubrique Champs de configuration de l’intégration de REST API.
    7. Sélectionnez Suivant.
    8. Dans l’écran Instructions de configuration , copiez l’URL fournie dans le presse-papiers.

      Le format de l’URL est le suivant : http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw, où /aps/mid/hla/raw est le point de terminaison. HLA a remplacé (MID_SERVER_IP) et (MID_WEB_SERVER_PORT) par les valeurs que vous avez configurées dans le formulaire Fournir des détails .

    9. Effectuez l'une des actions suivantes :
      • Si vous avez rempli toutes les conditions préalables avant de commencer la configuration, sélectionnez Activer.

        Lorsque l’intégration est activée avec succès, l’onglet Vue d’ensemble s’affiche. Lanceur d'intégrations Le , la vignette d’intégration est disponible dans l’onglet Intégrations installées.

      • Si vous n’avez pas rempli toutes les conditions préalables, sélectionnez Enregistrer le brouillon.

        Le système enregistre l’intégration sous forme de brouillon dans le Lanceur d'intégrations. Il s’affiche dans l’onglet Intégrations installées , sous En attente de votre action. Vous pouvez remplir les conditions préalables et activer l’intégration ultérieurement. Pour plus d'informations, consultez Activer une intégration de brouillon dans Analyse de l'intégrité des journaux.

    Que faire ensuite

    Demandez à votre client API d’envoyer des messages de journal au Serveur MID.
    1. Dans le client de l’API, configurez une demande avec les paramètres suivants :
      • Méthode HTTP : POST.
      • URL : URL que vous avez copiée dans l’écran d’instructions de configuration .
      • Authentification : les informations d’identification d’authentification requises. Par exemple, Authentification de base (nom d’utilisateur et mot de passe).
        Remarque :
        La méthode d’authentification doit être la même que celle configurée sur le serveur Web MID.
      • En-têtes : définissez l’en-tête Content-Type pour qu’il corresponde au format de votre charge utile.
        • Pour JSON : application/json.
        • Pour le texte brut : text/plain.
      • Corps : la charge utile des journaux au format JSON ou en texte brut.
    2. Envoyez la demande.

      Une réponse réussie indique que le Serveur MID a reçu la charge utile. Lorsque le Serveur MID a traité les messages du journal, l’entrée de données les transmet à votre instance à l’aide ServiceNow du protocole REST.