GCP PubSub データ入力の構成

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

    • データ入力を構成して、Google Cloud Pub/Sub トピックに公開されたログメッセージを受け取り、それらを ServiceNow インスタンスにストリーミングするようにします。

    始める前に

    • MID サーバーがインストールされ、ログ取り込み機能を有効にして設定されていることを確認します。詳細については、「MID Server system requirements」を参照してください。

      ログ取り込み機能が有効になっている MID サーバー構成。

      重要:
      ヘルスログアナリティクス は IPv6 をサポートしていません。アプリケーションを操作するには、MID サーバーを IPv4 に設定します。
    • MID サーバークライアントと外部クライアントが同じネットワーク上にある場合を除き、MID サーバーにはパブリック IP アドレスが必要です。これは、ネットワークアドレス変換 (NAT)、ロードバランサー、または同様のデバイスを介して IP が公開される場合に必要です。パブリック IP アドレスを使用すると、ネットワーク外に Filebeat エージェントなどの外部クライアントが MID サーバーに到達できます。プライベート IP アドレスは、インターネット経由でルーティングできません。パブリック IP がないと、外部クライアントは、そのアドレスが設定されていても、その MID サーバー に接続できません。MID サーバー プロパティで、パブリック IP アドレスを値として指定する mid.public_ip というプロパティを追加します。詳細については、「MID サーバープロパティの作成」を参照してください。MID サーバークライアントと外部クライアントが同じネットワーク上にある場合は、プライベート IP アドレスを使用して接続できます。
    • SSL TLS を使用して暗号化されたログを送信する方法については、Now Support ナレッジベースの記事「Rsyslog と Filebeat による SSL [KB0866319] を使用したデータのストリーミング」を参照してください。

    必要なロール：evt_mgmt_admin

    手順

    1. 移動先 すべて > ヘルスログアナリティクス > データ入力 > データ入力.
    2. [データ入力 (Data Inputs)] ページで、[新規] を選択します。
    3. GCP PubSub データ入力タイプを選択します。
      注:
      選択したデータ入力タイプは、受動的データ入力 (リスナー) を補完します。詳細については、「ヘルスログアナリティクス でサポートされているデータ入力」を参照してください。
    4. フォームで、フィールドに入力します。
      フィールドの説明については、「GCP PubSub データ入力構成フィールド」を参照してください。
    5. オプション: 追加の構成フィールドを設定するには、[詳細] を選択します。
      フィールドの説明については、「GCP PubSub データ入力構成フィールド」を参照してください。
    6. [保存] を選択します。
      ヘルスログアナリティクス でデータ入力レコードがデータ入力テーブルに追加されます。
    7. [テスト接続] を選択して、データ入力が正しく構成されていることを確認します。

      ヘルスログアナリティクス は MID サーバー をデータリポジトリに接続しようとします。

      データ入力が MID サーバー クラスターで実行されるように構成されている場合、システムはクラスターに含まれるすべての MID サーバー をリポジトリに接続しようとします。少なくとも 1 つの MID サーバー が接続された場合、クラスターはテストに合格します。 この機能は、ヘルスログアナリティクスアプリケーション (バージョン 26.0.17 - 2023 年 2 月以降、ServiceNow Store から入手可能) でサポートされています。

      • 接続が確立された場合、[テスト接続] ボタンがオフになり、[公開 (Publish)] ボタンが有効になります。
      • 接続に失敗した場合は、失敗の理由が [エラーメッセージ] フィールドに表示されます。問題を解決し、構成を変更した場合は [保存] を選択し、[テスト接続] を選択して接続を再度テストします。
        注:
        接続が正常に作成された場合にのみ、データ入力構成を公開できます。
      注:
      [変更を元に戻す] を選択すると、最後に公開された構成に戻すことができます。このオプションは、以前に公開された構成を変更する場合にのみ使用できます。
    8. データ入力を MID サーバー に公開するには、[公開 (Publish)] を選択します。

    タスクの結果

    データ入力構成プロセスが完了しました。ヘルスログアナリティクスは、データ入力レコードを [データ入力] テーブルに追加し、構成ファイルをデータ入力レコードに添付します。データ入力により、Google Cloud Pub/Sub トピックからのログメッセージの受け取りが開始され、ログメッセージが MID サーバー経由で ServiceNow インスタンスにストリーミングされます。