Gestion des rubriques dans Hermes

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture

    • Gérez les enregistrements de rubriques de votre instance et les rubriques Kafka de la grappe Kafka à l’aide Hermes de l’option Service de messagerie Hermes .

    Enregistrements de rubriques

    Les messages sont organisés et stockés dans des Hermes rubriques Kafka du 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 comporte un champ pour le nom de la rubrique, l’espace de noms connexe et si la rubrique est active.

    Les valeurs de la colonne Nom de la table Rubriques Kafka [sys_kakfa_topic] ne sont pas uniques en soi. Par exemple, les enregistrements de rubriques peuvent avoir la même valeur Nom lorsqu’ils appartiennent à des espaces de noms différents ou existent dans des grappes différentes. Toutefois, les valeurs de la colonne Nom complet sont toujours uniques.

    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 le cluster proche, le travail s’exécute et crée également la rubrique sur le cluster distant.
    • Consigne un message d’avertissement si une rubrique ne peut pas correspondre à un 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. Une rubrique ne correspond à aucun espace de noms 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 rubriques du cluster Kafka à l’aide de Hermes l’inspecteur de rubriques. Pour plus d'informations, consultez Surveillance des rubriques dans la Hermes grappe Kafka.

    Les rubriques Kafka sont spécifiques à une instance particulière. Cela signifie que vous ne pouvez pas migrer un enregistrement de rubrique de la table Rubriques Kafka [sys_kafka_topic] vers une autre instance à l’aide d’un ensemble de mises à jour. Au lieu de cela, vous devez créer manuellement la rubrique dans l’instance cible.

    Création de rubriques

    Vous pouvez créer des rubriques dans le cluster Kafka à l’aide Hermes 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éez 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 de l’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 avec 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 d’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 le Hermes cluster 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 pouvez uniquement augmenter le nombre de partitions dans 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 devient permanent. Si vous créez un enregistrement d’espace de noms et que vous souhaitez y déplacer les rubriques existantes, vous devez supprimer les rubriques et les recréer dans le Hermes cluster Kafka avec le nouveau préfixe d’espace 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 rubriques du cluster Kafka à l’aide Hermes de l’une des méthodes suivantes :
    • Supprimez la rubrique directement de 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.
    • Supprimez la rubrique en externe. Par exemple, supprimez la rubrique à l’aide de l’interface de ligne de commande (CLI) Kafka.
      Important :
      La suppression de la rubrique en externe nécessite la suppression manuelle de 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 dispose d’abonnements dans Connexion au flux.

    Nouvelle analyse des rubriques

    La nouvelle analyse crée des enregistrements de rubriques pour toutes les rubriques de la Hermes grappe Kafka qui n’ont pas déjà d’enregistrements 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 rubriques correspondants dans la table Rubriques Kafka [sys_kafka_topic] au lieu d’attendre que la tâche planifiée 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 rubrique 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é après qu’il y ait déjà des rubriques dans .Hermes
    • Lorsque les enregistrements de rubrique 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.