L’échange de données à l’aide de la commande Service de messagerie Hermes

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

    • Vous pouvez produire et utiliser des messages Kafka dans votre ServiceNow instance à l’aide de .Service de messagerie Hermes

    Il existe plusieurs méthodes d’échange de données entre votre ServiceNow instance et votre environnement Kafka à l’aide du Service de messagerie Hermes . Dans tous les cas, les données sont produites par une entité et consommées par une autre.

    • À l’aide Connexion au fluxde , vous pouvez produire des messages à partir de votre ServiceNow instance à l’aide d’une étape de créateur à partir d’une action de flux ou de l’API Producer, puis utiliser les messages dans votre application externe.
      Vous pouvez également produire des messages à partir d’une application externe, puis utiliser les messages dans votre ServiceNow instance via l’une des méthodes suivantes :
      • Déclencheur de flux Kafka
      • Consommateur RTE
      • Consommateur de carte de transformation
      • Consommateur de script

      Pour plus d’informations, consultez Stream Connect pour Apache Kafka .

    • À l’aide de , Service d'exportation de journalvous pouvez produire des journaux à partir de votre ServiceNow instance, puis utiliser les journaux dans votre application externe. Pour plus d’informations sur la production et l’utilisation de journaux pour , reportez-vous à Service d'exportation de journalla section Log Export Service (LES).
    • En utilisant le protocole standard Kafka, vous pouvez échanger des messages avec n’importe quelle application qui produit des messages. Par exemple, vous pouvez produire des messages à partir d’une application Java à l’aide du protocole Kafka standard, puis les utiliser dans votre ServiceNow instance et vice versa.

    Production et consommation de messages

    Pour commencer à échanger des messages, créez une rubrique dans le Hermes cluster Kafka. Une fois la rubrique créée, vous créez un total de trois processus pour communiquer avec la Hermes grappe Kafka.

    • Un processus est nécessaire pour produire des messages à Hermes.
    • Deux processus sont requis pour consommer les messages provenant de 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 pour l’autre Hermes cluster Kafka.

    Lors de l’utilisation de la commande list pour afficher une liste de rubriques, une liste des rubriques actuelles est renvoyée par l’une ou les deux grappes. Les rubriques peuvent être renvoyées à partir d’une seule grappe, en fonction de la date de la dernière synchronisation. Les rubriques créées à des fins de basculement sont différenciées par un préfixe d’identification de grappe à trois lettres.

    Vous ne pouvez pas supprimer une rubrique des deux clusters Kafka à l’aide d’une seule commande dans l’interface de ligne de commande (CLI). Toutefois, vous pouvez supprimer la rubrique des deux clusters en supprimant l’enregistrement de rubrique dans votre instance. Consultez Supprimer une rubrique dans Hermes.

    Plages de ports requises

    Collaborez avec votre administrateur réseau pour vous assurer que les plages de ports suivantes sont ouvertes avant de commencer à échanger des messages à l’aide Hermesde :
    • Producteur : 4000-4050
    • Consommateur1 : 4100-4150
    • Consommateur2 : 4200 à 4250

    Adresses d’amorce

    Utilisez les mappages de ports suivants pour connecter les producteurs et les consommateurs aux adresses d’amorce de la grappe Kafka. Tous les Application Delivery Controllers utilisés par Hermes suivent cette même convention.

    Important :
    Les exemples d’adresses d’amorce suivants Hermes utilisent les ports 4000-4003, 4100-4103 et 4200-4203. Toutefois, vous devez ouvrir les plages de ports suivantes pour garantir la connectivité à mesure que des clusters supplémentaires sont ajoutés au Service de messagerie Hermes .
    • Producteur : 4000-4050
    • Consommateur1 : 4100-4150
    • Consommateur2 : 4200 à 4250

    Les clients producteurs utilisent des ports allant de 4 000 à 4 050. Par exemple :

    Producers = "<instance_name>.service-now.com:4000,<instance_name>.service-now.com:4001,<instance_name>.service-now.com:4002,<instance_name>.service-now.com:4003"

    Étant donné qu’il Hermes utilise une paire de clusters Kafka, vous devez configurer deux clients consommateurs avec des adresses d’amorce de consommateur distinctes.

    Important :
    Vous devez configurer deux adresses d’amorce de consommateur distinctes, une pour chaque client de consommateur.
    • Le premier client grand public utilise des ports allant de 4100 à 4150. Par exemple :
      Consumer A = "<instance_name>.service-now.com:4100,<instance_name>.service-now.com:4101,<instance_name>.service-now.com:4102,<instance_name>.service-now.com:4103"
    • Le deuxième client grand public utilise des ports allant de 4200 à 4250. Par exemple :
      Consumer B = "<instance_name>.service-now.com:4200,<instance_name>.service-now.com:4201,<instance_name>.service-now.com:4202,<instance_name>.service-now.com:4203"

    Lorsque vous configurez les propriétés du producteur et du consommateur pour votre propre client Kafka, utilisez ce modèle de chaîne.