---
sourceDocument: Australia ServiceNow AI Platform Capabilities
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/servicenow-platform

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Consume test messages

# Consume test messages from a Hermes topic using the Kafka client {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Consume test messages from a Hermes topic by configuring two consumer clients.

## Vorbereitungen

* Secure your Kafka topics by generating a ServiceNow® instance-signed certificate and keystore. You must provide truststore and keystore details when you configure the Hermes consumers. See [Set up a secure connection to the Hermes Messaging Service](https://servicenow-prod.fluidtopics.net/E9eFecp0xYW~Av3YxMUT9w "Secure your Kafka topics by generating a ServiceNow instance-signed certificate.").
* Download and install Apache Kafka. See [Prepare your Apache Kafka client environment](https://servicenow-prod.fluidtopics.net/ZYiWlqUuWuaSEoXKY4w3kg "Install the Apache Kafka binaries on your Unix or Windows client machine.").
* Create a topic and produce test messages in the Hermes Kafka cluster before you can consume messages. For details, see [Create a test topic in Hermes using the Kafka client](https://servicenow-prod.fluidtopics.net/yRi94EGo~4Y5VlscX_qriQ "Create a topic for sending and receiving test messages in the Hermes Kafka cluster.") and [Produce test messages to a Hermes topic using the Kafka client](https://servicenow-prod.fluidtopics.net/Z1US2uFaPjqGrMMt7EVNQw "Produce test messages to a Hermes topic by configuring a producer client.").

{#consume-messages-hermes__ul_krd_qg3_1xb}

Role required: admin

## Warum und wann dieser Vorgang ausgeführt wird

The following steps describe how to configure two consumer clients and receive test messages from the Hermes Kafka cluster. Because Hermes uses a pair of Kafka clusters, you must configure two consumer clients with separate consumer bootstrap addresses. This ensures messages are consumed from both clusters without dropping any
messages.  
Wichtig:  
You must configure two distinct consumer bootstrap addresses, one for each consumer client.

Refer to these steps when you are ready to consume messages from Hermes for business or production purposes.

## Prozedur

1. Navigate to the config directory where you extracted Kafka.
   * For example, on Unix:

         cd /home/user/Software/kafka/config

   * For example, on Windows:

         cd C:\Software\kafka\config

   {#consume-messages-hermes__choices_fgv_zqt_w1c}
2. Configure the consumers.
   1. Open the consumer.properties file.
   2. Configure the following SSL properties:  

          security.protocol=SSL

          ssl.truststore.password=<truststore password>

          ssl.truststore.location=<path to truststore.p12>

          ssl.truststore.type=PKCS12

          ssl.keystore.password=<keystore password>

          ssl.keystore.location=<path to keystore.p12>

          ssl.keystore.type=PKCS12

          ssl.key.password=<keystore password>

      Replace the following placeholder variables:
      * `<truststore password>` with your truststore password
      * `<path to truststore.p12>` with the path to your truststore file
      * `<keystore password>` with your keystore password
      * `<path to keystore.p12>` with the path to your keystore file
      {#consume-messages-hermes__ul_tvh_twp_twb}
   3. Save your changes in plain text.
   {#consume-messages-hermes__substeps_jwh_tgt_5wb}
3. Consume a message using each consumer.
   1. Run the following command for the first consumer client:  
      Unix:

          ./bin/kafka-console-consumer.sh --consumer.config ./config/consumer.properties --topic snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name> --group snc.<instance_name>.<consumer_group_id> --from-beginning --bootstrap-server <instance_name>.service-now.com:4100,<instance_name>.service-now.com:4101,<instance_name>.service-now.com:4102,<instance_name>.service-now.com:4103

      Windows:

          bin\windows\kafka-console-consumer.bat --consumer.config config\consumer.properties --topic snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name> --group snc.<instance_name>.<consumer_group_id> --from-beginning --bootstrap-server <instance_name>.service-now.com:4100,<instance_name>.service-now.com:4101,<instance_name>.service-now.com:4102,<instance_name>.service-now.com:4103

      Replace the following placeholder variables:
      * `<instance_name>` with your instance name
      * `<namespace>` with the namespace of the domain your Kafka topic belongs to (optional)
      * `<app_id>` with the application ID
      * `<topic_name>` with a test topic name
      * `<consumer_group_id>` with a label of your choice for the group that the consumer belongs to
      {#consume-messages-hermes__ul_tjk_zxp_twb}  
      Hinweis:  
      Each part of the topic name is case-sensitive.
   2. Open a new terminal window.
   3. Navigate to the Kafka directory.
   4. Run the following command for the second consumer client:  
      Unix:

          ./bin/kafka-console-consumer.sh --consumer.config ./config/consumer.properties --topic snc.<instance_name>.<namespace>.<topic_name> --group snc.<instance_name>.<consumer_group_id> --from-beginning --bootstrap-server <instance_name>.service-now.com:4200,<instance_name>.service-now.com:4201,<instance_name>.service-now.com:4202,<instance_name>.service-now.com:4203

      Windows:

          bin\windows\kafka-console-consumer.bat --consumer.config config\consumer.properties --topic snc.<instance_name>.<namespace>.<topic_name> --group snc.<instance_name>.<consumer_group_id> --from-beginning --bootstrap-server <instance_name>.service-now.com:4200,<instance_name>.service-now.com:4201,<instance_name>.service-now.com:4202,<instance_name>.service-now.com:4203

      Replace the following placeholder variables:
      * `<instance_name>` with your instance name
      * `<namespace>` with the namespace of the domain your Kafka topic belongs to (optional)
      * `<topic_name>` with a test topic name
      * `<consumer_group_id>` with a label of your choice for the group that the consumer belongs to
      {#consume-messages-hermes__ul_pfj_vqq_twb}  
      Hinweis:  
      Each part of the topic name is case-sensitive.
   {#consume-messages-hermes__substeps_nfg_npq_twb}

## Ergebnisse

Test messages are consumed from the Hermes Kafka cluster.