Apache Kafka 統合構成フィールド

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：5分

    • ヘルスログアナリティクス用の Apache Kafka 統合構成フォームのフィールドについて説明します。

    Apache Kafka統合のセットアップ手順については、「ヘルスログアナリティクス の Apache Kafka統合の設定」を参照してください。

    表 : 1. 詳細を入力
    フィールド 説明
    統合名 この統合の一意の名前。例:自分の Kafka 統合。このフィールドは必須です。
    注:
    このフィールドに入力すると、フォームに表示される一般名が、入力した名前と一致するよう自動的に調整されます。
    実行 特定の MID サーバー または MID サーバー クラスターを使用するかどうかを選択するオプション。このフィールドは必須です。
    MID サーバー名

    ([実行日 (Execute on)] フィールドが [特定の MID サーバー] に設定されている場合のみ)

    Apache Kafka に基づくログデータのプル先の MID サーバー。このフィールドは必須です。
    注:
    • ベーシック認証をサポートする MID サーバー のみを選択できます。mTLS をサポートする MID サーバー は表示されません。
    • 1 つの MID サーバー にログをストリーミングするデータ入力のデフォルトの最大数は 10 です。最大数を変更するには、プロパティ sn.occ.log_ingestion.max_datainputs_per_mid を MID サーバー に追加してから、デフォルト値を変更します。
    • 選択した MID サーバー に対してログの取り込みが有効になっていない場合は、ヘルスログアナリティクス によって自動的に有効になります。
    MID サーバークラスター

    ( [実行日] が [特定のクラスター] に設定されている場合のみ MID サーバー 。)

    ログデータのプル先の MID サーバー クラスター。このフィールドは必須です。

    データ入力はクラスター内の単一の MID サーバー で実行され、その MID サーバー が失敗するまで継続します。次に、構成された順序に従って、クラスター内の次に利用可能な MID サーバーにすべてのデータ入力タスクが移動されます。

    注:
    • ヘルスログアナリティクスはフェイルオーバー MID サーバークラスターのみをサポートします。これらのクラスターでは、複数の MID サーバー がフェイルオーバー保護のためにグループ化されます。データ入力フォームまたは統合フォームからクラスターを選択すると、 MID サーバー クラスターリストにはフェイルオーバークラスターのみが表示されます。
    • MID サーバー クラスターには、ベーシック認証をサポートする MID サーバー のみを含める必要があります。mTLS はログの取り込みではサポートされていません。
    • クラスター内の MID サーバー ごとにログの取り込みを有効にする必要があります。アクティブな MID サーバー に対してログの取り込みが有効になっていない場合は、ヘルスログアナリティクス によって自動的に有効になります。
    • 1 つの MID サーバー にログをストリーミングするデータ入力または統合のデフォルトの最大数は 10 です。クラスターに少なくとも 1 つの MID サーバー が含まれていて、データ入力またはそこで実行されている統合が 10 未満の場合は、その MID サーバー クラスターが停止していても、そのクラスターはキャパシティの検証に合格します。
    MID サーバークラスターの詳細については、「MID サーバークラスターの設定」を参照してください。
    サービスインスタンス ログデータのバインド先のサービスインスタンス (以前のアプリケーションサービス)。このフィールドは必須です。
    データソース 統合によって ServiceNow インスタンスにプルされるログデータのソース:Kafka。このフィールドは読み取り専用です。
    説明 統合の識別に役立つ簡単な説明を追加するオプション。
    表 : 2. データ検索手法を設定
    フィールド 説明
    Kafka ノード名 「<ホスト>:<ポート>,<ホスト>:<ポート>」形式のカンマ区切りリスト。このフィールドは必須です。

    すべての Apache Kafka クラスターサーバーをリストに含める必要はありません。
    トピック データ入力による登録が必要なトピックのカンマ区切りリスト。このフィールドは必須です。
    Kafka 認証情報 Apache Kafka 認証情報。

    既存の Kafka SSL 認証情報を選択するか、ドロップダウンリストから [Kafka 認証情報の作成 (Create Kafka credentials)] を選択して新しい認証情報を作成できます。Kafka SSL 認証情報フォームのフィールドの説明については、「Kafka SSL 認証情報フィールド」を参照してください。
    グループ ID Apache Kafka コンシューマーグループの名前。
    表 : 3. 詳細設定
    フィールド 説明 デフォルト値
    タイムアウト トピックでデータが利用できない場合にポーリングで待機する時間 (ミリ秒)。 500
    デフォルトのタイムゾーン (Default time zone) ログにタイムゾーンが指定されていない場合に使用されるイベントのタイムゾーン。

    このような場合、デフォルトでは GMT が使用されますが、別のタイムゾーンを指定することもできます。

    		 GMT
    サブサンプル受信率 (Sub sample receive ratio) このイベント数に達すると、1 つを除いてすべてのイベントが破棄されます。この設定は、受信するイベントの数を減らすために使用されます。 -1
    文字エンコード このデータ入力の文字エンコード。このフィールドは読み取り専用です。 UTF-8
    ノードディスカバリータイムアウト ノード検出がタイムアウトするまでの時間 (ミリ秒)。 30
    サブサンプルドロップ率 (Sub sample drop ratio) このイベント数に達すると、イベントが 1 つ破棄されます。この設定は、フェッチするイベントの数を減らすために使用されます。 -1
    最大長 (バイト) (Max length in bytes) イベントの最大長 (バイト)。 32766
    キューが満杯の場合は削除 MID サーバーに負荷がかかっている場合にログを破棄するオプション。 False