Create a topic in Hermes

  • Release version: Xanadu
  • Updated August 1, 2024
  • 1 minute to read
  • Create a topic from within ServiceNow. Creating a topic from your instance adds a topic record to the Kafka Topics [sys_kafka_topic] table and adds a Kafka topic to Hermes.

    Before you begin

    Role required: kafka_admin

    Procedure

    1. Navigate to All > Hermes Messaging Service > Topics.
    2. Select New.
    3. On the form, fill in the fields.
      Table 1. Kafka Topic Form
      Field Description
      Name Name of the topic.

      The string that you enter is combined with the application ID and namespace to create the full Kafka topic name.

      Note:
      Don't include the snc.<instance_name> prefix with the topic name.
      Application ID Application associated with the topic. Default is Stream Connect.
      Namespace

      Namespace associated with the topic.

      You can either select a namespace created by the Kafka namespace administrator or select the Default Namespace if separate namespaces aren't configured for your instance.

      In ServiceNow, all Kafka topics link to a namespace. Namespaces are used to organize topics and, on a domain-separated instance, for domain separation. When a namespace is assigned to a particular domain, all the topics created in that namespace have the same domain.

      Partitions

      Number of partitions to create for the topic.

      • Minimum value: 1
      • Maximum value: 32
      • Default value: 1
      Active Option to activate the topic.
    4. Select Submit.

    Result

    The topic appears in both the Kafka Topics [sys_kafka_topic] table and in Hermes. If, for some reason, a topic can't be created in Hermes, it won't be created in the Kafka Topics [sys_kafka_topic] table either.