REST API データ入力の構成

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

    始める前に

    • MID サーバーがインストールされ、ログ取り込み機能を有効にして設定されていることを確認します。

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

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

      詳細については、「MID Web サーバー 拡張の設定」を参照してください。

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

    • MID サーバー の IP アドレスがネットワークアドレス変換 (NAT)、ロードバランサー、または同様のデバイスで公開される場合は、パブリック IP アドレスが必要です。MID サーバー プロパティで、パブリック IP アドレスを値として指定する mid.public_ip というプロパティを追加します。詳細については、「MID サーバープロパティの作成」を参照してください。

    必要なロール:evt_mgmt_admin

    このタスクについて

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

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

    手順

    1. 次のように移動する。 All (すべて) > ヘルスログアナリティクス > データ入力 > データ入力.
    2. [データ入力 (Data Inputs)] ページで、[新規] を選択します。
    3. REST API データ入力を選択します。
    4. フォームのフィールドに入力します。
      フィールドの説明については、「REST API データ入力構成フィールド」を参照してください。
    5. [送信] を選択します。

    タスクの結果

    データ入力構成プロセスが完了しました。ヘルスログアナリティクスは、データ入力レコードを [データ入力] テーブルに追加し、構成ファイルをデータ入力レコードに添付します。データ入力により、 ServiceNow インスタンスへの JSON 形式のログデータのストリーミングが開始されます。
    注:
    ヘルスログアナリティクス AI エンジンが停止し、データのストリーミングが停止した場合、データ入力設定ページの上部に通知が表示されます。これが発生した場合は、ServiceNow サポートにお問い合わせください。

    次のタスク

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