Apache Kafka 統合構成フィールド

  • リリースバージョン: Yokohama
  • 更新日 2025年02月23日
  • 所要時間:4分
  • ヘルスログアナリティクスApache Kafka 統合構成フォームのフィールドの説明。

    表 : 1. 詳細を入力
    フィールド 説明
    統合名 この統合の一意の名前。このフィールドは必須です。
    注:
    このフィールドに入力すると、フォームに表示される一般名が、入力した名前と一致するよう自動的に調整されます。
    説明 統合の識別に役立つ簡単な説明を追加するオプション。
    サービスインスタンス ログデータのバインド先のサービスインスタンス。このフィールドは必須です。
    実行 特定の MID サーバーまたは MID サーバークラスターを使用するかどうかを決定するオプション。

    この機能は、ヘルスログアナリティクスアプリケーション (バージョン 26.0.17 - 2023 年 2 月以降、ServiceNow Store から入手可能) でサポートされています。

    MID サーバー名

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

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

    ( [実行] フィールドが MID サーバー に設定されている場合のみクラスター。

    ログデータのプル先の MID サーバー クラスター。

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

    この機能は、ヘルスログアナリティクスアプリケーション (バージョン 26.0.17 - 2023 年 2 月以降、ServiceNow Store から入手可能) でサポートされています。

    注:
    • ヘルスログアナリティクスはフェイルオーバー MID サーバークラスターのみをサポートします。これらのクラスターでは、複数の MID サーバー がフェイルオーバー保護のためにグループ化されます。データ入力フォームからクラスターを選択すると、MID サーバー クラスターリストにフェイルオーバークラスターのみが表示されます。
    • MID サーバー クラスターには、ベーシック認証をサポートする MID サーバー のみを含める必要があります。mTLS はログの取り込みではサポートされていません。
    • クラスター内の MID サーバー ごとにログの取り込みを有効にする必要があります。アクティブな MID サーバー に対してログの取り込みが有効になっていない場合は、ヘルスログアナリティクス によって自動的に有効になります。
    • 1 つの MID サーバー にログをストリーミングするデータ入力のデフォルトの最大数は 10 です。クラスターに少なくとも 1 つの MID サーバー が含まれていて、そこで実行されているデータ入力が 10 未満の場合は、その MID サーバー が停止していても、そのクラスターはキャパシティの検証に合格します。
    MID サーバークラスターの詳細については、「MID サーバークラスターの設定」を参照してください。

    このフィールドは必須です。

    表 : 2. データ検索手法を設定
    フィールド 説明
    Kafka ノード名 「<ホスト>:<ポート>,<ホスト>:<ポート>」形式のカンマ区切りリスト。すべての Apache Kafka クラスターサーバーをリストに含める必要はありません。
    Kafka 認証情報 Apache Kafka認証情報。

    既存の Kafka SSL 認証情報を選択するか、ドロップダウンリストから [Kafka 認証情報の作成 ] を選択して新しい認証情報を作成できます。Kafka SSL 認証情報フォームのフィールドの説明については、「Kafka SSL 認証情報フィールド」を参照してください。

    トピック データ入力による登録が必要なトピックのカンマ区切りリスト。

    このフィールドは必須です。

    グループ ID Apache Kafka コンシューマーグループの名前。
    表 : 3. 詳細設定
    フィールド 説明 デフォルト値
    タイムアウト トピックでデータが利用できない場合にポーリングで待機する時間 (ミリ秒)。 500
    デフォルトのタイムゾーン (Default time zone) ログにタイムゾーン情報が含まれていない場合のデフォルトのタイムゾーン。 GMT
    サブサンプル受信率 このイベント数に達すると、1 つを除いてすべてのイベントが破棄されます。この設定は、受信するイベントの数を減らすために使用されます。 -1
    文字エンコード このデータ入力の文字エンコーディング。 UTF-8
    ノードディスカバリータイムアウト ノード検出がタイムアウトするまでの時間 (ミリ秒)。 30
    サブサンプルドロップ率 (Sub sample drop ratio) このイベント数に達すると、イベントが 1 つ破棄されます。この設定は、フェッチするイベントの数を減らすために使用されます。 -1
    最大長 (バイト) (Max length in bytes) イベントの最大長 (バイト)。 32766
    キューが満杯の場合は削除 MID サーバー に負荷がかかっている場合にログの破棄を選択するオプション。 False