ヘルスログアナリティクスの REST API 統合の設定

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

    • ヘルスログアナリティクスで処理するためにログデータを ServiceNow インスタンスにストリーミングするための統合を設定します。

    始める前に

    • ヘルスログアナリティクスアプリケーションがインスタンスにインストールされ、プロビジョニングされていることを確認します。詳細については、「インストール ヘルスログアナリティクス (HLA)」を参照してください。
    • サービスインスタンスが利用可能であることを確認します。
    • ヘルスログアナリティクス AI エンジンが稼働していることを確認します。
    • 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 アドレスを使用して接続できます。
    注:
    REST API 統合では、受信データに対して UTF-8 エンコードのみがサポートされています。

    必要なロール：evt_mgmt_admin

    このタスクについて

    ITOM AIOps コンフィグレーションセンターからアクセスする サービスオペレーションワークスペース の統合ランチパッドを使用して、統合を設定します。AIOps コンフィグレーションセンターは、AIOps 機能を 1 か所から構成および管理するための一元化されたワークスペースです。統合セットアッププロセスは、 ヘルスログアナリティクス のクラシックインターフェイスでの手動データ入力セットアップと比較して、実装時間を短縮します。詳細については、「サービスオペレーションワークスペース for ITOM での統合ランチパッド」を参照してください。

    手順

    1. 移動先 ワークスペース > サービスオペレーションワークスペース.
    2. ナビゲーションペインの下部にある AIOps コンフィグレーションセンターアイコン ITOM AIOps コンフィグレーションセンターアイコンを選択します。
      [ ITOM AIOps コンフィグレーションセンター] ページが表示されます。構成センターは、一元化されたワークスペースです。これを使用して、AIOps 機能を 1 か所から構成および管理します。
    3. [統合] セクションの [統合] で、[ 統合を追加] を選択します。
      統合ランチパッドが表示されます。
    4. [ 統合を参照 (Browse integrations )] タブで、検索フィールドに 「REST 」と入力します。
    5. REST API 統合タイルを選択します。
      注:
      すべての前提条件を満たす前に統合セットアップを開始すると、メッセージが表示されます。セットアップをキャンセルして、先に前の要件を完了することができます。または、ドラフトモードで続行し、後で要件を完了することもできます。すべての前提条件を完了するまで、統合をアクティブ化できないことに注意してください。
    6. [ 詳細を入力 ] フォームのフィールドに入力します。
      フィールドの説明については、「REST API 統合構成フィールド」を参照してください。
    7. [Next (次へ)] をクリックします。
    8. [設定手順] 画面で、指定された URL をクリップボードにコピーします。

      URL の形式は http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw で、 /aps/mid/hla/raw がエンドポイントです。 HLA(MID_SERVER_IP) と (MID_WEB_SERVER_PORT) が、[ 詳細を入力 ] フォームで設定した値に置き換えられました。

    9. 次のいずれかの操作を行います。
      • 構成を開始する前にすべての前提条件を満たしている場合は、[ アクティブ化] を選択します。

        統合が正常にアクティブ化されると、[ 概要 ] タブが表示されます。統合ランチパッドでは、[インストール済み統合 (Installed integrations)] タブに統合タイルが表示されます。

      • 前のすべての要件を満たしていない場合は、 [ 下書きの保存] を選択します。

        統合はドラフトとして 統合ランチパッドに保存されます。[ インストール済み統合 (Installed integrations )] タブの [アクションを待機中 (Waiting for your action)] の下に表示されます。前提条件を満たし、後で統合をアクティブ化できます。詳細については、「ヘルスログアナリティクスでのドラフト統合のアクティブ化」を参照してください。

    次のタスク

    ログメッセージを MID サーバーに送信するように API クライアントに指示します。
    1. API クライアントで、次のパラメーターを使用して要求を構成します。
      • HTTP メソッド:POST。
      • URL: 設定手順 画面でコピーした URL です。
      • 認証:必要な認証情報。たとえば、ベーシック認証 (ユーザー名とパスワード) などです。
        注:
        認証方法は、MID Web サーバーで設定されている方法と同じである必要があります。
      • ヘッダー:ペイロード形式と一致するように Content-Type ヘッダーを設定します。
        • JSON の場合: application/json。
        • 生のテキストの場合: text/plain。
      • 本文:JSON または生のテキストのログペイロード。
    2. 要求を送信します。

      正常な応答は、 MID サーバー がペイロードを受信したことを示します。MID サーバー がログメッセージを処理すると、データ入力は REST プロトコルを使用してログメッセージを ServiceNow インスタンスにストリーミングします。