REST API データ入力の構成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:2分
  • ServiceNow インスタンスに JSON 形式でログデータをストリーミングできるように REST API データ入力を構成します。

    始める前に

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

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

      重要:
      ヘルスログアナリティクス は IPv6 をサポートしていません。アプリケーションを操作するには、MID サーバーを IPv4 に設定します。

      MID Web Server コンテキストフォームの [実行サーバー] フィールドで、クラスターオプションではなく [特定の MID サーバー] を選択します。[MID サーバー] フィールドで、ログデータをプルする特定の MID サーバーを選択します。

    • MID サーバークライアントと外部クライアントが同じネットワーク上にある場合を除き、MID サーバーにはパブリック IP アドレスが必要です。これは、ネットワークアドレス変換 (NAT)、ロードバランサー、または同様のデバイスを介して IP が公開される場合に必要です。パブリック IP アドレスを使用すると、ネットワーク外に Filebeat エージェントなどの外部クライアントが MID サーバーに到達できます。プライベート IP アドレスは、インターネット経由でルーティングできません。パブリック IP がないと、外部クライアントは、そのアドレスが設定されていても、その MID サーバー に接続できません。MID サーバー プロパティで、パブリック IP アドレスを値として指定する mid.public_ip というプロパティを追加します。詳細については、「MID サーバープロパティの作成」を参照してください。MID サーバークライアントと外部クライアントが同じネットワーク上にある場合は、プライベート IP アドレスを使用して接続できます。

    必要なロール:evt_mgmt_admin

    このタスクについて

    この拡張は、外部ログソースによって MID サーバー に送信されるログメッセージを処理します。MID サーバー はメッセージを処理し、インスタンスに渡します。

    ログメッセージを MID サーバー にストリーミングするには、URL の形式を http://{MID_SERVER_IP}:{MID_WEB_SERVER_PORT}/api/mid/hla/raw にする必要があります (/api/mid/hla/raw はエンドポイント)。

    手順

    1. 移動先 すべて > ヘルスログアナリティクス > データ入力 > データ入力.
    2. [データ入力 (Data Inputs)] ページで、[新規] を選択します。
    3. REST API データ入力を選択します。
    4. フォームで、フィールドに入力します。
      フィールドの説明については、「REST API データ入力構成フィールド」を参照してください。
      注:
      REST API 統合は、受信データの UTF-8 エンコーディングのみをサポートしています。
    5. [送信] を選択します。

    タスクの結果

    データ入力構成プロセスが完了しました。ヘルスログアナリティクスは、データ入力レコードを [データ入力] テーブルに追加し、構成ファイルをデータ入力レコードに添付します。データ入力により、 ServiceNow インスタンスへの JSON 形式のログデータのストリーミングが開始されます。

    次のタスク

    データ入力がストリーミングデータであることを確認します。