Gérer les rubriques dans Hermes

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

    • Gérez les enregistrements de rubriques dans votre instance et les rubriques Kafka dans le cluster Kafka à l’aide Hermes de .Service de messagerie Hermes

    Enregistrements de rubriques

    Les messages sont organisés et stockés dans des rubriques Kafka dans le Hermes cluster Kafka. Les enregistrements de rubriques sont stockés dans la table Rubriques Kafka [sys_kafka_topic] de votre instance. Cette table affiche une liste d’enregistrements de rubriques avec une référence à l’espace de noms de chaque rubrique. Chaque enregistrement de rubrique dispose d’un champ pour le nom de la rubrique, l’espace de noms connexe et si la rubrique est active.

    Une tâche planifiée s’exécute régulièrement pour synchroniser les enregistrements de rubriques avec les rubriques trouvées dans Hermes. Cette tâche exécute les fonctions suivantes :
    • Crée des enregistrements de rubriques pour toutes les rubriques détectées, en les affectant à l’espace de noms approprié en fonction du préfixe du nom de la rubrique.
    • Synchronise les rubriques créées à partir de sources externes, telles que l’interface de ligne de commande (CLI) Kafka. Par exemple, lorsqu’une rubrique est créée à partir d’une source externe sur la grappe proche, la tâche s’exécute et crée également la rubrique sur la grappe distante.
    • Consigne un message d’avertissement si une rubrique ne peut correspondre à aucun espace de noms. Si une rubrique ne peut pas correspondre à un espace de noms, l’enregistrement de rubrique n’est pas créé. Il existe un espace de noms par défaut, sans préfixe, appelé Espace de noms par défaut, qui correspond à toutes les rubriques. Le seul moment où une rubrique ne correspond à aucun espace de noms est lorsque l’espace de noms par défaut a été supprimé ou modifié.
    • Marque les rubriques comme inactives si aucune rubrique Kafka n’a été trouvée pour elles.

    Vous pouvez surveiller et afficher les Hermes rubriques du cluster Kafka à l’aide de l’inspecteur de rubriques. Pour plus d'informations, consultez Rubriques de surveillance dans le Hermes cluster Kafka.

    Création de rubriques

    Vous pouvez créer des rubriques dans le Hermes cluster Kafka à l’aide de l’une des méthodes suivantes :
    • Créez la rubrique à partir de votre instance. Cela crée un enregistrement dans la table Rubriques Kafka [sys_kafka_topic] et crée une rubrique Kafka dans la Hermes grappe Kafka. Consultez Créer une rubrique dans Hermes.
    • Créer la rubrique en externe. Par exemple, créez la rubrique à l’aide de l’interface de ligne de commande (CLI) Kafka.
      Remarque :
      Pour éviter les problèmes de synchronisation entre la grappe et votre instance, incluez l’ID d’application lors de la création de rubriques externes. Par exemple, sans l’ID d’application, une rubrique créée à partir de l’interface de ligne de commande portant un nom tel que snc.instancename.fulfillment.topicname est créée dans l’espace de noms par défaut au lieu de l’espace de noms exécution . Pour vous assurer que la rubrique est créée dans l’espace de noms d’exécution , incluez l’ID d’application dans le nom en utilisant le format snc.instancename.fulfillment.app_id.topicname. Remplacez app_id par l’ID d’application de votre choix.

    Si, pour une raison quelconque, une rubrique ne peut pas être créée dans la Hermes grappe Kafka, elle ne sera pas non plus créée dans la table Rubriques Kafka [sys_kafka_topic].

    Mise à jour des rubriques

    Si nécessaire, vous pouvez modifier le nombre de partitions d’une rubrique. Notez que vous ne pouvez augmenter que le nombre de partitions d’une rubrique. Pour plus d'informations, consultez Mettre à jour une rubrique dans Hermes.

    Une fois créé, l’espace de noms affecté à un enregistrement de rubrique est permanent. Si vous créez un enregistrement d’espace de noms et que vous souhaitez y déplacer des rubriques existantes, vous devez supprimer les rubriques et les recréer dans le cluster Kafka avec le nouveau préfixe d’espace Hermes de noms. Si les rubriques n’ont pas été créées via l’instance, de nouveaux enregistrements de rubriques sont créés et affectés à l’enregistrement d’espace de noms correspondant après une nouvelle analyse.

    Suppression des rubriques

    Vous pouvez supprimer des Hermes rubriques du cluster Kafka à l’aide de l’une des méthodes suivantes :
    • Supprimez la rubrique directement depuis la table Rubriques Kafka [sys_kafka_topic] dans votre instance. Cette méthode supprime automatiquement la rubrique de tous les Hermes clusters Kafka en une seule action. Reportez-vous à la rubrique Supprimer une rubrique dans Hermes.
    • Supprimer la rubrique en externe. Par exemple, supprimez la rubrique à l’aide de l’interface de ligne de commande (CLI) Kafka.
      Important :
      La suppression externe de la rubrique nécessite que vous supprimiez manuellement la rubrique des deux Hermes clusters en spécifiant chaque ensemble de ports (410x et 420x). Si possible, supprimez la rubrique via l’instance à la place.

    Vous ne pouvez pas supprimer une rubrique si elle possède des abonnements dans Connexion au flux.

    Nouvelle analyse des rubriques

    La nouvelle analyse crée des enregistrements de rubriques pour toutes les rubriques de la grappe Kafka qui n’ont pas déjà d’enregistrements Hermes de rubriques correspondantes. Par exemple, si vous créez des rubriques à Hermes l’aide de l’interface de ligne de commande, vous pouvez effectuer une nouvelle analyse pour créer immédiatement les enregistrements de rubrique correspondants dans la table Rubriques Kafka [sys_kafka_topic] au lieu d’attendre que le travail planifié les crée.

    • La nouvelle analyse se produit automatiquement toutes les dix minutes.
    • Les enregistrements de rubriques créés sont affectés aux espaces de noms existants en fonction des règles de correspondance des préfixes.
    Parfois, les enregistrements de rubriques de votre instance ne correspondent pas à ce qui se trouve dans Hermes. Cette situation peut se produire dans les cas suivants :
    • Lorsque le module d’extension ServiceNow Hub d'intégration Kafka Consumer (com.glide.hub.kafka_consumer) est activé, alors qu’il existe déjà des rubriques dans Hermes.
    • Lorsque des enregistrements de rubriques sont supprimés accidentellement.
    • Lorsque les définitions d’espace de noms sont modifiées et que vous souhaitez affecter des rubriques existantes aux nouveaux espaces de noms.