Configuration guidée pour les consommateurs Kafka

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 6 minutes de lecture
  • Implémentez les étapes suivantes pour une configuration guidée complète pour les consommateurs Kafka.

    Avant de commencer

    Accédez à la Service d’exportation de journaux (LES) > Consommateur Kafka > Configuration guidée. Sélectionnez le type de configuration que vous souhaitez configurer, puis sélectionnez Continuer.
    Remarque :
    Lors de l’installation de l’application Service d'exportation de journal , ServiceNow met en service l’infrastructure sous-jacente Service de messagerie Hermes . Sachez que ce processus peut prendre jusqu’à deux heures à partir du moment où vous demandez l’installation de l’application Service d'exportation de journal .

    Rôle requis : admin

    Procédure

    1. Examinez Service de messagerie Hermes les diagnostics.

      Il est recommandé de vérifier que le Service de messagerie Hermes est opérationnel avec l’outil de diagnostic, qui s’affiche Hermes à l’écran pendant cette étape. Si vous voyez une erreur « Page introuvable » sur cette page, Hermes elle n’est pas installée et vous devez contacter votre administrateur système.

      • Informations sur la Service de messagerie Hermes configuration : Les informations d’amorce suivantes sont utilisées pour se connecter au . L’amorce du créateur est la connexion utilisée pour envoyer des messages dans Hermes et l’amorce de consommateur 1 et 2 est utilisée pour récupérer les messages d’Hermes.
        • Amorce du créateur
        • Amorce de consommateur 1
        • Amorce de consommateur 2
      • PKI d’instance : le composant d’infrastructure de clé publique d’instance (PKI) permet à une instance ServiceNow d’agir en tant qu’émetteur dans une hiérarchie de confiance X.509.
      • Connectivité d’amorce : sélectionnez Exécuter le test pour confirmer que le client externe est en mesure de se connecter aux ports d’instance définis (producteur et consommateur).
      • Connectivité d’instance : sélectionnez Exécuter le test pour confirmer que l’instance est en mesure d’envoyer et de recevoir des messages.
      • Afficher les rubriques : sélectionnez la rubrique répertoriée pour récupérer l’horodatage du dernier message connu.
      Remarque :
      Vous pouvez accéder Hermes à Diagnostics à l’avenir pour résoudre les problèmes de connectivité potentiels en revenant à cette étape de la configuration guidée ou en accédant à Tous > Service de messagerie Hermes > Diagnostics.
    2. Générez des certificats pour une connexion sécurisée et Service de messagerie Hermes extrayez les événements du journal.

      Vous allez utiliser ces certificats lors de la connexion de votre système externe.

      Configurez une connexion sécurisée à Service de messagerie Hermes. Voir Configurer une connexion sécurisée au service de messagerie Hermes pour LES pour plus d’informations . Vous aurez besoin de ces certificats pour l’authentification et l’autorisation dans le client qui extraira les journaux d’Hermes.

      Remarque :
      Les rôles administrateur ou Hermes_admin sont requis pour cette étape.
    3. Configurer le créateur de journaux : choisissez les sources de journaux à exporter et configurez leurs filtres.
      Effectuez les tâches suivantes pour configurer le générateur de journaux.
      • Configurer les sources de journal à exporter : créez un enregistrement source pour chacune des sources de journal que vous souhaitez exporter.
        Remarque :
        Les rôles administrateur ou sn_logstoanalytics.admin sont requis pour terminer cette étape
        1. Sélectionnez Nouveau dans le coin supérieur droit
        2. Sélectionner un type de source
        3. Sélectionner une table
        4. Sélectionner un niveau de journal qui peut être utilisé pour contrôler la sortie de journalisation
        5. Sélectionnez ou créez une rubrique vers laquelle cette source de journal sera exportée. Si vous créez une nouvelle rubrique, renseignez les champs suivants :
          • Nom : nom de la rubrique que vous créez
          • ID d’application : Entrer sn_logstoanalytics
          • Espace de noms : entrer l’espace de noms par défaut
          • Partition : le champ partition d’une rubrique dans Hermes fait référence aux partitions dans lesquelles les données de la rubrique sont divisées. Il joue un rôle clé dans l’évolutivité et le parallélisme.
        6. Sélectionnez une condition de type de filtre pour transférer les journaux de manière sélective.
          Remarque :
          Les filtres sont différents selon le type de source sélectionné
        7. Sélectionner Mettre à jour
        Lorsqu’il est créé avec succès, il affiche le nom de la rubrique Hermes vers laquelle cette source de journal sera exportée. Notez le nom de la rubrique, vous en aurez besoin plus tard lors de la configuration de votre système de consommateur de journaux.

        Le champ Actif contrôle si cette source de journal va être exportée ou non. Si vous voyez des erreurs, revenez à la tâche Vérifier les diagnostics Hermes et vérifiez l’état d’Hermes.

      • Valider le créateur de journaux : une fois que vous avez créé une source à partir de laquelle produire des journaux, vous pouvez afficher les enregistrements de journaux actifs dans la rubrique à l’aide de Service de messagerie Hermes > Inspecteur de rubrique Hermes.
        1. Sélectionner des rubriques externes
        2. Sélectionner les rubriques de la liste
        3. Sélectionnez une ligne avec votre rubrique de l’étape précédente (répertoriée dans Sources)
        4. Ajuster la date de début du message si nécessaire
        5. Sélectionnez Afficher pour afficher un message du journal qui a été exporté vers la rubrique
    4. Connecter le consommateur Kafka : suivez ces tâches pour connecter le consommateur Kafka de votre choix afin d’extraire les événements de journal du Hermes.
      • Identifier le consommateur Kafka : deux options s’offrent à vous en fonction de votre architecture d’analyse de journaux.
        • Si vous disposez de votre propre système Kafka et que vous le choisissez pour l’agrégation des journaux, vous pouvez vous connecter directement au service de messagerie Hermes via le protocole Kafka natif.
        • Si vous choisissez de connecter directement votre outil d’analyse de journaux au service de messagerie Hermes, vous devez déployer un connecteur Kafka pris en charge par votre système d’analyse de journaux (c’est-à-dire Splunk Connect for Kafka).
        Remarque :
        Dans les deux cas, vous devrez travailler avec l’administrateur de ces systèmes pour coordonner la connexion avec le service de messagerie Hermes.
      • Importer des certificats Hermes dans le système de consommateur Kafka : connectez-vous à votre système de consommateur Kafka et assurez-vous de disposer des droits d’administrateur appropriés pour le configurer et le connecter à un système externe. Importez les certificats générés dans la tâche « Configurer une connexion sécurisée à la messagerie Hermes Service » dans votre connecteur Kafka ou votre serveur Kafka. Suivez les instructions de la documentation relative au consommateur Kafka que vous avez choisi.
      • Configurer les processus Kafka : le service de messagerie Hermes est conçu pour la haute disponibilité. Deux processus sont nécessaires pour consommer les messages d’Hermes. Deux processus sont requis, car Hermes utilise une paire de clusters Kafka à des fins de basculement. Si un cluster tombe en panne, des données sont produites vers l’autre cluster Hermes Kafka.
        Dans votre système grand public Kafka, vous devrez créer deux processus consommateur distincts pour vous connecter aux deux clusters Hermes Kafka. Pour les deux processus, vous spécifiez la même rubrique Hermes Kafka, mais vous devez configurer deux adresses d’amorce distinctes :
        • <instance_name>.service-now.com:4100,<instance_name>.service-now.com:4101,<instance_name>.service-now.com:4102,<instance_name>.service-now.com:4103
        • <instance_name>.service-now.com:4200,<instance_name>.service-now.com:4201,<instance_name>.service-now.com:4202,<instance_name>.service-now.com:4203
        Remarque :
        Contactez votre administrateur réseau pour vous assurer que les plages de ports suivantes sont ouvertes avant de commencer :
        • Consommateur1 : 4 100 à 4 150
        • Consommateur2 : 4 200 à 4 250
        Remarques importantes :
        • Lorsque vous accédez à la rubrique Kafka à partir de systèmes externes, vous devez ajouter « snc.<nom d’instance>. » à la rubrique vers laquelle les journaux sont transférés.
        • Configurez chaque consommateur avec le même ID de groupe de consommateurs Kafka.
        • Installez votre magasin de clés et vos fichiers de magasin de confiance dans un emplacement où vos consommateurs peuvent y accéder.
        • Si vos consommateurs le souhaitent, spécifiez les propriétés des convertisseurs JSON Kafka pour désactiver les schémas : « key.converter.schemas.enable=false », « value.converter.schemas.enable=false »
      • Vérifier que le consommateur Kafka extrait les journaux d’Hermes : vérifiez dans le consommateur Kakfa de votre choix que vous pouvez extraire les événements de journal à partir du service de messagerie Hermes.