Microsoft Azure Event Hubs データ入力構成フィールド

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：6分

    • Microsoft Azure Event Hubs のデータ入力構成フォームのフィールドについて説明します。

    基本構成

    フィールド 説明
    名前 新しいデータ入力の名前。このフィールドは必須です。
    説明 データ入力の説明。
    実行日 特定の MID サーバーまたは MID サーバークラスターを使用するかどうかを決定するオプション。

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

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

    Microsoft Azure Event Hubs に基づくログデータのプル先の 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 サーバークラスターの設定」を参照してください。

    このフィールドは必須です。
    サービスインスタンス ログデータのバインド先のサービスインスタンス。
    注:
    関連するサービスインスタンスが存在しない場合、 作成： サービスインスタンス CI を追加します。新しいサービスインスタンスのステータスを [運用] に設定します。
    このフィールドは必須です。
    次のフィールドには、読み取り専用の情報が表示されます。
    フィールド 説明
    ステータス データ入力のステータス。
    トランスポート (Transport) ログデータのストリーミングに使用されるプロトコル。

    このデータ入力は Microsoft Azure Event Hubs を使用してログデータをインスタンスにストリーミングします。
    ソースの数 このデータ入力によって作成されたログソースの数。
    無効になった時刻 (Disabled since) データ入力が停止または失敗した時刻。
    前回のログ時刻 (Last log time) データ入力で前回のログがストリーミングされた時刻。
    エラーメッセージ ストリーミングエラー。

    このフィールドは、自動的に入力されます。このフィールドは、ストリーミングエラーが発生した場合にのみ表示されます。
    表 : 1. [クエリ設定] タブ
    フィールド 説明 例
    送信元 データ読み取りの開始日時。この日時より古いデータは読み取られません。
    注:
    この値を過去の日付に設定すると、システムで大量のデータを読み取ることが必要になり、輻輳が生じる可能性があります。

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

    		 Now -1 week
    最大バッチサイズ 単一のプロセスコールに渡されるイベントの最大数。 100
    表 : 2. [トランスポート (Transport)] タブ
    フィールド 説明
    イベントハブ名前空間 (Event Hubs namespace) 1 つまたは複数のイベントハブのスコーピングコンテナ。このフィールドは必須です。
    イベントハブ名 (Event Hub name) ログデータのフェッチ元のイベントハブ。このフィールドは必須です。
    イベントハブ認証情報 (Event Hub credentials) イベントハブへの認証に使用する共有アクセス認証ポリシー。このフィールドは必須です。
    コンシューマーグループ名 (Consumer Group name) 使用するコンシューマーグループ。

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

    詳細構成

    表 : 3. 詳細設定フォーム
    フィールド 説明 デフォルト値
    復元ポイントレート (Restore point rate) 復元ポイントが保存される前にデータ入力が読み取ることができるイベントの数。 100
    プロセッサースレッド数 (Processor threads count) プロセッサースレッドの合計数。 2
    走査タイムアウト (Operation timeout) イベントハブ操作がタイムアウトするまでの待機秒数。 120
    受信タイムアウト 受信動作がタイムアウトするまでの待機秒数。 60
    プリフェッチ数 (Prefetch count) イベントハブ操作の前に受信するイベントの数。 500
    デフォルトのタイムゾーン (Default time zone) ログにタイムゾーン情報が含まれていない場合のデフォルトのタイムゾーン。 GMT
    サブサンプルドロップ率 (Sub sample drop ratio) このイベント数に達すると、イベントが 1 つ破棄されます。この設定は、フェッチするイベントの数を減らすために使用されます。 -1
    サブサンプル受信率 (Sub sample receive ratio) このイベント数に達すると、1 つを除いてすべてのイベントが破棄されます。この設定は、受信するイベントの数を減らすために使用されます。 -1
    最大長 (バイト) (Max length in bytes) イベントの最大長 (バイト)。 32766
    文字エンコード このデータ入力の文字エンコーディング。 UTF-8
    スリープ間隔 クエリーでイベントが返されなかった場合に、クエリーを再実行するまで待機する間隔 (秒)。 60
    ポーリング間隔 新しいイベントをポーリングするまで待機する間隔 (秒単位)。 0
    キューが満杯の場合はドロップ (Drop if queue is full) MID サーバー に負荷がかかっている場合にログの破棄を選択するオプション。 False