Kafka クライアントを使用した Hermes でのテストトピックの作成

Hermes Kafka クラスターでテストメッセージを送受信するためのトピックを作成します。

始める前に

• ServiceNow® インスタンス署名証明書とキーストアを生成して Kafka トピックを保護します。Hermes でトピックを作成するプロデューサーを構成するときは、トラストストアとキーストアの詳細を指定する必要があります。「Hermes メッセージングサービス への安全な接続の設定」を参照してください。
• Apache Kafka をダウンロードしてインストールします。「Apache Kafka クライアント環境の準備」を参照してください。

必要なロール：admin

このタスクについて

完全な Hermes Kafka トピック名は、次の要素で構成されます。

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

この構文では、

• <instance_name> はインスタンスの名前
• <namespace> は Kafka トピックが属するドメインの名前空間 (オプション)
• <app_id> はアプリケーション ID

  作成するトピックはこのアプリケーションに属しています。次のいずれかを指定します。

  • ログエクスポートサービス トピックのsn_logstoanalytics
  • ストリームコネクト トピックのsn_streamconnect
• <topic_name> はトピックの一意の名前

注:

完全なトピック名では大文字と小文字が区別され、200 文字の制限があります。

手順

1. Kafka を展開した config ディレクトリに移動します。
   • Unix の場合の例：

     cd /home/user/Software/kafka/config

   • Windows の場合の例：

     cd C:\Software\kafka\config

2. プロデューサーを構成します。
   1. producer.properties ファイルを開きます。
   2. 次の 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>

      次のプレースホルダー変数を置き換えます。

      • <truststore password> - トラストストアパスワードで
      • <path to truststore.p12> - トラストストアファイルへのパスで
      • <keystore password> - キーストアパスワードで
      • <path to keystore.p12> - キーストアファイルへのパスで
   3. 変更内容をプレーンテキストで保存します。
3. Kafka ディレクトリに移動します。
4. 次のコマンドを実行して、送信するテストトピックを作成します。
   • 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

   次のプレースホルダー変数を置き換えます。

   • <instance_name> - インスタンス名で (大文字と小文字を区別)
   • <namespace> Kafka トピックが属するドメインの名前空間で (オプション)
   • <app_id>アプリケーション ID で (大文字と小文字を区別)
   • <topic_name> - テストトピック名で (大文字と小文字を区別)

タスクの結果

Hermes Kafka クラスターにテストトピックが作成されます。

次のタスク

Kafka クライアントを使用した Hermes トピックへのテストメッセージの生成