Amazon S3 統合構成フィールド

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

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

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

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

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

    Amazon S3 からのログデータのプル先のMID サーバー。このフィールドは必須です。
    注:
    • ベーシック認証をサポートする MID サーバー のみを選択できます。mTLS をサポートする MID サーバー は表示されません。
    • 1 つの MID サーバー にログをストリーミングするデータ入力のデフォルトの最大数は 10 です。この数字は、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 インスタンスにプルされるログデータのソース:S3。このフィールドは読み取り専用です。
    説明 統合の識別に役立つ簡単な説明を追加するオプション。
    表 : 2. データ検索手法を設定
    フィールド 説明
    バケット名 ストリーミングする Amazon S3 バケット。このフィールドは必須です。
    地域 Amazon CloudWatch クラスターがホストされている AWS リージョン。例:us-east-2。このフィールドは必須です。

    AWS リージョンのリストについては、「https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-regions」を参照してください。
    認証手法 AWS サービスアカウントのリソースにアクセスするために必要な AWS 認証情報。このフィールドは必須です。

    ドロップダウンリストから AWS 認証情報を選択するか、[ 認証情報の管理] を選択し、[ AWS 認証情報] ページで新しい認証情報を定義して、新しい AWS 認証情報をリストに追加します。
    表 : 3. 詳細設定
    フィールド 説明
    インクルード システムがパターンマッチングを実行するときに含めるファイルまたはオブジェクト。
    除外する システムがパターンマッチングを実行するときに除外するファイルまたはオブジェクト。
    バケットプリフィックス フェッチするオブジェクトのプリフィックス。統合は、このプリフィックスを持つオブジェクトのみをフェッチします。
    注:
    通常、このフィールドはバケット内の特定のフォルダーのみをフェッチするために使用されます。
    バッファーサイズ (Buffer size) ダウンロードバッファーのサイズ (バイト単位)。
    スレッドプールサイズ (Threadpool size) バケットからファイルをダウンロードする同時スレッドの数。
    匿名 デフォルトの認証情報が存在する場合は無視し、認証情報なしでバケットに強制的にアクセスするオプション。
    走査 (Traverse) バケット内の各ディレクトリにアクセスするオプション。
    最終変更時間によるオブジェクトのソート バケット内のオブジェクトが時間でソートされている場合にオブジェクトをフェッチするオプション。
    サブサンプルドロップ率 (Sub sample drop ratio) まとめてバッチ処理するログの数。そのうち 1 つが削除されます。デフォルト値は -1 で、ログは削除されません。

    この設定は、フェッチするログの数を減らすために使用されます。たとえば、5 件に 1 回のログアウトをドロップする場合は、値を 5 に変更します。
    スリープ間隔 (秒) (Sleep interval (seconds)) クエリでイベントが返されなかった場合に、クエリを再実行するまで待機する間隔 (秒)。
    最大長 (バイト) (Max length in bytes) イベントの最大長 (バイト)。
    接続タイムアウト (ms) AWS への接続を確立するための試行がタイムアウトするまでの待機時間 (ミリ秒)。
    ファイルあたりの最大再試行回数 失敗した場合にファイル処理を再試行する最大回数。
    ソケットタイムアウト (ms) 確立された接続を介したデータ転送がタイムアウトするまでの待機時間 (ミリ秒)。
    デフォルトのタイムゾーン (Default time zone) ログにタイムゾーン情報が含まれていない場合のデフォルトのタイムゾーン。
    サブサンプル受信率 まとめてバッチ処理するログの数。そのうち 1 つのログが受信され、残りのログは削除されます。デフォルト値は -1 です。ログは受信されません。

    この設定は、受信するログの数を減らすために使用されます。たとえば、5 回に 1 回のログアウトが必要な場合は、値を 5 に変更します。
    ポーリング間隔 新しいイベントをポーリングするまで待機する間隔 (秒単位)。
    文字エンコード この統合に使用される文字エンコード:UTF-8
    キューが満杯の場合は削除 MID サーバーに負荷がかかっている場合にログを破棄することを選択するオプション。