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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分

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

    始める前に

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

    必要なロール：admin

    このタスクについて

    Hermes Kafka トピックには、次の規則を使用して名前が付けられます。

    snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name>
    各項目の意味は次のとおりです。
    • <instance_name> はインスタンスの名前
    • <namespace> は Kafka トピックが属するドメインの名前空間 (オプション)
    • <app_id> はアプリケーション ID

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

      • ログエクスポートサービス トピックのsn_logstoanalytics
      • Apache Kafka 向けストリームコネクト トピックのsn_streamconnect
    • <topic_name> はトピックの一意の名前
    注:
    完全なトピック名では大文字と小文字が区別され、200 文字の制限があります。

    手順

    1. Apache Kafka をダウンロードしてインストールします。
      1. をダウンロードする Apache Kafka バイナリ。
      2. 次のコマンドを実行して、Kafka パッケージを展開します。 
        tar -zxvf kafka_2.13-3.1.2.tgz
    2. 次のコマンドを実行して、Kafka ディレクトリに移動します。 
      cd kafka_2.13-3.1.2
    3. プロデューサーを構成します。
      1. config/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> - キーストアファイルへのパスで
    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 テストメッセージの生成