GCP PubSub データ入力構成フィールド

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

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

    基本構成

    フィールド 説明
    名前 新しいデータ入力の名前。このフィールドは必須です。
    ポート MID サーバー のポート。

    アレイから一意のポートを選択します。このプレースホルダーには、選択するポートの範囲が表示されます。選択したポートが組織のセキュリティチームによって開かれていることを確認してください。

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

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

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

    ログのストリーミング先 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) ログデータの送信に使用されるプロトコル：PubSub。
    ソースの数 このデータ入力によって作成されたログソースの数。
    ステータス データ入力のステータス。
    無効になった時刻 (Disabled since) データ入力が停止または失敗した時刻。
    前回のログ時刻 (Last log time) データ入力で前回のログがストリーミングされた時刻。
    表 : 1. [トランスポート (Transport)] タブ
    フィールド 説明
    プロジェクト ID Google Cloud プロジェクトのプロジェクト ID。例：my-project-id。
    トピック名 ヘルスログアナリティクス に登録する Google Cloud Pub/Sub トピック 。例：my_topic。
    GCP 認証情報エイリアス 使用する認証情報エイリアス。

    虫眼鏡アイコンを選択して 1 つの GCP 認証情報エイリアスを指定し、[接続および資格情報エイリアス] リストから既存の認証情報エイリアスを選択するか、[新規] を選択して新しいレコードを作成します。デフォルトは、sn_occ.HLA_Credential_Alias です。

    認証情報エイリアスの作成の詳細については、「ディスカバリーの認証情報エイリアス」を参照してください。
    サブスクリプション名 ヘルスログアナリティクス へのサブスクリプションは、Google Cloud Pub/Sub トピックで公開されたログデータを受信するために使用します。

    このフィールドを空白のままにすると、ヘルスログアナリティクス は ServiceNow サブスクリプションを使用します。

    詳細構成

    表 : 2. [詳細] タブ
    フィールド 説明 デフォルト値
    サブスクライバースレッドプールのサイズ Google Cloud Pub/Sub トピックからファイルをダウンロードする同時スレッドの数。 1
    デフォルトのタイムゾーン (Default time zone) イベントのデフォルトのタイムゾーン。ログにタイムゾーンが指定されていない場合は、このデフォルト値が使用されます。 GMT
    最大長 (バイト) (Max length in bytes) ログメッセージの最大長 (バイト)。 32766
    文字エンコード (読み取り専用) このデータ入力の文字エンコーディング。 UTF-8
    サブサンプルドロップ率 (Sub sample drop ratio) ドロップするイベントの割合。 -1
    サブサンプル受信率 (Sub sample receive ratio) 受信するイベントの割合。 -1
    レート制限 このデータ入力が処理する 1 秒あたりのイベントの最大数。 -1
    キューが満杯の場合は削除 (Drop if queue is full) 多くのプロセスが MID サーバー へのアクセスをキューで待機している場合にログを破棄することを選択するオプション。 Clear