Configurer une Apache Kafka intégration pour Analyse de l'intégrité des journaux

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 5 minutes de lecture

    • Configurez une intégration pour diffuser les données du journal vers Apache Kafka votre ServiceNow instance pour traitement par Analyse de l'intégrité des journaux.

    Avant de commencer

    • 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.
      Important :
      Analyse de l'intégrité des journaux ne prend pas en charge IPv6. Pour utiliser l'application, configurez le Serveur MID sur IPv4.
    • Lorsque l’adresse IP est exposée via la traduction d’adresses Serveur MID réseau (NAT), un équilibreur de charge ou un appareil similaire, elle doit disposer d’une Serveur MID adresse IP publique pour être accessible par des clients externes, tels que Filebeat des agents, situés en dehors de son réseau. Les adresses IP privées ne sont pas routables sur Internet, donc sans adresse IP publique, ces clients externes ne peuvent pas se connecter même Serveur MID 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.
      Remarque :
      Si les clients externes se trouvent sur le même réseau, une adresse IP publique n’est Serveur MID pas nécessaire et les connexions peuvent être établies à l’aide de l’adresse IP privée.
    • Déterminez s’il faut extraire les données du journal vers une seule Serveur MID grappe ou vers une Serveur MID grappe.

      Dans Serveur MID les clusters, plusieurs Serveurs MID sont regroupés pour la protection du basculement. L’intégration active s’exécute sur un seul Serveur MID dans la grappe. Serveur MID En cas d’échec, le système déplace ses tâches vers la prochaine tâche disponible Serveur MID dans la grappe, dans un ordre configuré.

      Si vous décidez d’utiliser une Serveur MID grappe, vérifiez les points suivants :

      • La Serveur MID grappe comprend uniquement ceux qui prennent en Serveurs MID charge l’authentification de base.
        Remarque :
        mTLS n’est pas pris en charge pour l’ingestion de journaux.
      • L’ingestion de journaux est activée pour chaque Serveur MID élément de la grappe.
        Remarque :
        Si l’ingestion de journal n’est pas activée pour l’actif Serveur MID, Analyse de l'intégrité des journaux l’active automatiquement.
      • Pas plus que le maximum par défaut de 10 intégrations n’extraira les journaux à un seul Serveur MID.

        Une grappe réussit la validation de capacité si elle en contient au moins une Serveur MID avec moins de 10 intégrations en cours d’exécution, même en Serveur MID panne.

    Rôle requis : evt_mgmt_admin

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail pour l'exploitation des services.
    2. Dans le volet de gauche, sélectionnez l’icône Zone de lancement des intégrations : icône Zone de lancement de l’intégration.
    3. Dans l’onglet Parcourir les intégrations , recherchez Kafka.
    4. Sélectionnez la vignette d’intégration Kafka.
      Remarque :
      Si vous démarrez une configuration d’intégration avant de remplir toutes les conditions préalables, un message s’affiche. Vous pouvez soit annuler la configuration et remplir d’abord les exigences précédentes, soit continuer en mode brouillon et les terminer ultérieurement. Notez que vous ne pouvez pas activer l’intégration tant que toutes les conditions préalables ne sont pas remplies.
    5. Renseignez les champs du formulaire Fournir des détails .
      Pour obtenir une description des champs, reportez-vous à la table Fournir des détails dans Apache Kafka Champs de configuration d’intégration.
    6. Sélectionnez Suivant.
    7. Renseignez les champs du formulaire Définir la méthode de récupération de données .
      Pour obtenir une description des champs, reportez-vous à la table Définir la méthode d’extraction de données dans Apache Kafka Champs de configuration d’intégration.
    8. Facultatif : Sélectionnez Paramètres avancés , puis remplissez les champs de configuration avancée.
      Pour obtenir une description des champs, reportez-vous au tableau Paramètres avancés dans Apache Kafka Champs de configuration d’intégration.
    9. Effectuez l'une des actions suivantes :
      • Si vous avez rempli toutes les conditions préalables avant de commencer la configuration, sélectionnez Activer.

        Dans l’écran contextuel, sélectionnez Tester et enregistrer pour enregistrer l’intégration dans la base de données et tester la connectivité. Si une erreur est renvoyée, ajustez la configuration comme suggéré dans le message d’erreur, puis essayez d’activer à nouveau l’intégration.

        Une fois le test réussi, l’intégration est activée et 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 en tant que brouillon dans l’onglet Lanceur d'intégrations Intégrations installées , sous En attente de votre action. Vous pouvez remplir les conditions préalables et activer l’installation ultérieurement. Pour plus d’informations, consultez la section Prochaines étapes .

    Que faire ensuite

    Exploitez les informations de l’onglet Vue d’ensemble pour affiner la façon dont la lecture HLA des données du journal. Pour plus d'informations, consultez Examiner les données de streaming de journal et ajuster les paramètres d’intégration dans Analyse de l'intégrité des journaux.
    Conseil :
    Utilisez le menu Autres options () pour ouvrir les pages Mappage d’entrée de données, Structures de type de source ou Sources de journal avec le contexte de l’intégration. Si vos données de journal ne sont pas correctement mappées, structurées ou approvisionnées, revenez en arrière et ajustez la configuration. Si l’application Espace de travail pour l'exploitation des services Analyse du journal est installée, le menu Plus d’options fournit également un accès direct à la visionneuse de journaux, où vous pouvez consulter les messages de journal bruts ingérés par l’intégration.
    Pour en savoir plus, consultez :
    Si vous avez enregistré l’intégration en tant que brouillon, procédez comme suit pour l’activer ultérieurement :
    1. Remplissez toutes les conditions préalables.
    2. Dans l’onglet Lanceur d'intégrations Intégrations installées , sous En attente de votre action, recherchez et sélectionnez la vignette d’intégration.
    3. Sur l’écran de configuration, sélectionnez Activer.

      Sélectionnez Tester et enregistrer pour enregistrer l’intégration dans la base de données et tester la connectivité. Si une erreur est renvoyée, ajustez la configuration comme suggéré dans le message d’erreur, puis essayez d’activer à nouveau l’intégration.

      Une fois le test réussi, l’intégration est activée et l’onglet Vue d’ensemble s’affiche. La vignette d’intégration est disponible dans l’onglet Intégrations installées sur le Lanceur d'intégrations.