Verwalten von Themen in Hermes

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Verwalten Sie Themendatensätze in Ihrer -Instanz und Kafka-Themen im Kafka-Cluster [ Hermes mit Hermes Messaging-Service.

    Themendatensätze

    Nachrichten werden in Kafka-Themen im Kafka-Cluster Hermes organisiert und gespeichert. Themendatensätze werden in der Tabelle „Kafka-Themen“ [sys_kafka_topic] in Ihrer -Instanz gespeichert. Diese Tabelle zeigt eine Liste von Themendatensätzen mit einem Verweis auf den Namespace jedes Themas. Jeder Themendatensatz verfügt über ein Feld für den Namen des Themas, den zugehörigen Namespace und die Aktivität des Themas.

    Eine regelmäßige Aufgabe wird regelmäßig ausgeführt, um die Themendatensätze mit den in Hermesgefundenen Themen zu synchronisieren. Dieser Auftrag führt die folgenden Funktionen aus:
    • Erstellt Themendatensätze für alle erkannten Themen und weist sie basierend auf dem Präfix für den Themennamen dem entsprechenden Namespace zu.
    • Synchronisiert Themen, die aus externen Quellen erstellt wurden, z. B. die Kafka-Befehlszeilenschnittstelle (CLI). Wenn beispielsweise ein Thema aus einer externen Quelle im nahen Cluster erstellt wird, wird die Aufgabe ausgeführt und erstellt das Thema auch im entfernten Cluster.
    • Protokolliert eine Warnmeldung, wenn ein Thema keinem Namespace zugeordnet werden kann. Wenn ein Thema keinem Namespace zugeordnet werden kann, wird der Themendatensatz nicht erstellt. Es gibt einen standardmäßigen Namespace ohne Präfix, den Standard-Namespace, der allen Themen entspricht. Ein Thema stimmt nur dann mit keinem Namespace überein, wenn der Standard-Namespace gelöscht oder geändert wurde.
    • Markiert Themen als inaktiv, wenn für sie kein Kafka-Thema gefunden wurde.

    Sie können Themen im Kafka-Cluster Hermes mit dem Themeninspektor überwachen und anzeigen. Weitere Informationen finden Sie unter Überwachungsthemen im Kafka-Cluster Hermes.

    Erstellung von Themen

    Sie können Themen im Kafka-Cluster Hermes mit einer der folgenden Methoden erstellen:
    • Erstellen Sie das Thema von Ihrer -Instanz aus. Dadurch wird ein Datensatz in der Tabelle „Kafka-Themen“ [sys_kafka_topic] erstellt, und im Kafka-Cluster Hermes wird ein Kafka-Thema erstellt. Weitere Informationen finden Sie unter Erstellen Sie ein Thema in Hermes.
    • Erstellen Sie das Thema extern. Erstellen Sie das Thema beispielsweise mit der Kafka-Befehlszeilenschnittstelle (CLI).
      Hinweis:
      Um Synchronisierungsprobleme zwischen dem Cluster und Ihrer Instanz zu vermeiden, fügen Sie bei der externen Erstellung von Themen die Anwendungs-ID hinzu. Ohne die Anwendungs-ID wird beispielsweise ein über die CLI erstelltes Thema mit einem Namen wie „snc.instancename.fulfillment.topicname“ im Standard-Namespace anstelle im Erfüllung -Namespace erstellt. Um sicherzustellen, dass das Thema im Erfüllungs -Namespace erstellt wird, fügen Sie die Anwendungs-ID in den Namen ein, indem Sie das Formatnc.instancename.fulfillment.app_id.topicname verwenden. Ersetzen Sie app_id durch die ID der Anwendung Ihrer Wahl.

    Wenn ein Thema aus irgendeinem Grund nicht im Kafka-Cluster Hermes erstellt werden kann, wird es auch nicht in der Tabelle „Kafka-Themen“ [sys_kafka_topic] erstellt.

    Themen werden aktualisiert

    Bei Bedarf können Sie die Anzahl der Partitionen in einem Thema ändern. Beachten Sie, dass Sie nur die Anzahl der Partitionen in einem Thema erhöhen können. Weitere Informationen finden Sie unter Aktualisieren Sie ein Thema in Hermes.

    Nach der Erstellung ist der einem Themendatensatz zugewiesene Namespace dauerhaft. Wenn Sie einen Namespace-Datensatz erstellen und vorhandene Themen dorthin verschieben möchten, müssen Sie die Themen löschen und im Kafka-Cluster Hermes mit dem neuen Namespace-Präfix neu erstellen. Wenn die Themen nicht über die Instanz erstellt wurden, werden neue Themendatensätze erstellt und nach einem erneuten Scan dem entsprechenden Namespace-Datensatz zugewiesen.

    Themen werden gelöscht

    Sie können Themen mit einer der folgenden Methoden aus dem Kafka-Cluster Hermes löschen:
    • Löschen Sie das Thema direkt aus der Tabelle „Kafka-Themen“ [sys_kafka_topic] in Ihrer -Instanz. Mit dieser Methode wird das Thema automatisch aus allen Hermes Kafka-Clustern in einer Aktion gelöscht. Siehe Löschen Sie ein Thema in Hermes
    • Löschen Sie das Thema extern. Löschen Sie beispielsweise das -Thema mit der Kafka-Befehlszeilenschnittstelle (CLI).
      Wichtig:
      Wenn Sie das Thema extern löschen möchten, müssen Sie das Thema manuell aus beiden Hermes -Clustern löschen, indem Sie die einzelnen Portsätze (410x und 420x) angeben. Löschen Sie das Thema nach Möglichkeit stattdessen über die Instanz von.

    Sie können kein Thema löschen, wenn es Abonnements in Stream Connecthat.

    Themen werden erneut gescannt

    Beim erneuten Scannen werden Themendatensätze für alle Themen im Kafka-Cluster Hermes erstellt, für die noch keine entsprechenden Themendatensätze vorhanden sind. Wenn Sie beispielsweise Themen in Hermes mit der CLI erstellen, können Sie sofort einen erneuten Scan durchführen, um entsprechende Themendatensätze in der Tabelle „Kafka-Themen“ [sys_kafka_topic] zu erstellen, anstatt darauf zu warten, dass die geplante Aufgabe sie erstellt.

    • Der erneute Scan erfolgt automatisch alle zehn Minuten.
    • Erstellte Themendatensätze werden vorhandenen Namespaces basierend auf Präfix-Übereinstimmungsregeln zugewiesen.
    Manchmal stimmen Themendatensätze in Ihrer -Instanz nicht mit dem Inhalt in Hermesüberein. Diese Situation kann in den folgenden Fällen eintreten:
    • Wenn das Plugin ServiceNow IntegrationHub Kafka Consumer (com.glide.hub.kafka_consumer) aktiviert ist, nachdem bereits Themen in Hermesvorhanden sind.
    • Wenn Themendatensätze versehentlich gelöscht werden.
    • Wenn Namespace-Definitionen geändert werden und Sie den neuen Namespaces vorhandene Themen zuweisen möchten.