---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Criar um tópico de teste em Hermes usando o cliente Kafka

# Criar um tópico de teste em Hermes usando o cliente Kafka {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Crie um tópico para enviar e receber mensagens de teste no cluster do Kafka da Hermes.

## Antes de Iniciar

* Proteja os tópicos do Kafka gerando um certificado assinado pela instância ServiceNow® e um repositório de chaves. Você deve fornecer detalhes do armazenamento confiável e do armazenamento de chaves ao configurar um produtor a criar um tópico no Hermes. Consulte [Configurar uma conexão segura com o Serviço de envio de mensagens Hermes](https://servicenow-prod.fluidtopics.net/kTM~Ng68dwyVrFj0aWeRyA "Proteja os tópicos do Kafka gerando um certificado assinado pela instância ServiceNow.").
* Baixe e instale Apache Kafka. Consulte [Preparação do ambiente do cliente Apache Kafka](https://servicenow-prod.fluidtopics.net/gG8k5HTxjAijVV6tDYHdjA "Instale os binários do Apache Kafka na sua máquina cliente Unix ou Windows.").
{#create-hermes-topic__ul_ryb_fwk_w1c}

Função necessária: administrador

## Por Que e Quando Desempenhar Esta Tarefa

O completo HermesO nome do tópico do Kafka é composto pelos seguintes elementos:

    snc.<instance_name>.<namespace>.<app_id>.<topic_name>

em que:

* `<instance_name>` é o nome da sua instância
* `<namespace>` é o namespace do domínio ao qual seu tópico Kafka pertence (opcional)
* `<app_id>` é o ID da sua aplicação

  O tópico que você cria pertence a esta aplicação. Especifique um dos seguintes:
  * `sn_logstoanalytics` para tópicos da Log de serviço de exportação
  * `sn_streamconnect` para tópicos da Stream Connect
  {#create-hermes-topic__ul_nf4_hch_1xb}
* `<topic_name>` é o nome exclusivo do seu tópico
{#create-hermes-topic__ul_nyw_fch_1xb}  
Nota:  
O nome completo do tópico faz distinção entre maiúsculas e minúsculas e é limitado a 200 caracteres.

## Procedimento

1. Navegue até o diretório de configuração onde você extraiu o Kafka.
   * Por exemplo, no Unix:

         cd /home/user/Software/kafka/config

   * Por exemplo, no Windows:

         cd C:\Software\kafka\config

   {#create-hermes-topic__choices_fgv_zqt_w1c}
2. Configure um produtor.
   1. Abra o arquivo producer.properties.
   2. Configure as seguintes propriedades de SSL:  

          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>

      Substitua as seguintes variáveis de espaço reservado:
      * `<truststore password>` com a senha do seu repositório de confiança
      * `<path to truststore.p12>` com o caminho para o seu arquivo do repositório de confiança
      * `<keystore password>` com a senha do seu repositório de chaves
      * `<path to keystore.p12>` com o caminho para o arquivo do seu repositório de chaves
      {#create-hermes-topic__ul_tvh_twp_twb}
   3. Salve as mudanças em texto sem formatação.
   {#create-hermes-topic__substeps_jt5_lwp_twb}
3. Navegue até o diretório do Kafka.
4. Crie um tópico de teste executando o seguinte comando:
   * Unix:

         ./bin/kafka-topics.sh --create --topic snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name> --command-config ./config/producer.properties --bootstrap-server <instance_name>.service-now.com:4000,<instance_name>.service-now.com:4001,<instance_name>.service-now.com:4002,<instance_name>.service-now.com:4003

   * Windows:

         bin/windows/kafka-topics.bat --create --topic snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name> --command-config config/producer.properties --bootstrap-server <instance_name>.service-now.com:4000,<instance_name>.service-now.com:4001,<instance_name>.service-now.com:4002,<instance_name>.service-now.com:4003

   {#create-hermes-topic__choices_tvp_w3b_mxb}  
   Substitua as seguintes variáveis de espaço reservado:
   * `<instance_name>` com o nome da sua instância (diferencia maiúsculas de minúsculas)
   * `<namespace>` com o namespace do domínio ao qual seu tópico Kafka pertence (opcional)
   * `<app_id>` com o ID da aplicação (diferencia maiúsculas de minúsculas)
   * `<topic_name>` com o nome exclusivo do tópico que você deseja usar (diferencia maiúsculas de minúsculas)
   {#create-hermes-topic__ul_ogc_zch_1xb}

## Resultado

Um tópico de teste é criado no cluster Kafka da Hermes.

## O que Fazer Depois

[Produzir mensagens de teste para um tópico Hermes usando o cliente Kafka](https://servicenow-prod.fluidtopics.net/qtSyaLe90X3IO8Y0i2wjqw "Produza mensagens de teste para um tópico Hermes configurando um cliente produtor.")
**Tarefas relacionadas**   

* [Preparação do ambiente do cliente Apache Kafka](https://servicenow-prod.fluidtopics.net/gG8k5HTxjAijVV6tDYHdjA "Instale os binários do Apache Kafka na sua máquina cliente Unix ou Windows.")
* [Produzir mensagens de teste para um tópico Hermes usando o cliente Kafka](https://servicenow-prod.fluidtopics.net/qtSyaLe90X3IO8Y0i2wjqw "Produza mensagens de teste para um tópico Hermes configurando um cliente produtor.")
* [Consumir mensagens de teste de um tópico Hermes usando o cliente Kafka](https://servicenow-prod.fluidtopics.net/KgAqFR83uWIemjdo74~aoQ "Consuma mensagens de teste de um tópico Hermes configurando dois clientes consumidores.")