REST API integrations の構成

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:4分
  • ログデータを JSON 形式でServiceNowインスタンスにストリーミングしてヘルスログアナリティクスで処理するための n integration を構成します。

    始める前に

    • ヘルスログアナリティクスアプリケーションがインスタンスにインストールされ、プロビジョニングされていることを確認します。詳細については、「インストール ヘルスログアナリティクス (HLA)」を参照してください。
    • サービスインスタンスが利用可能であることを確認します。
    • ヘルスログアナリティクス AI エンジンが稼働していることを確認します。
    • 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

    手順

    1. 次のように移動する。 ワークスペース > サービスオペレーションワークスペース.
    2. 左側のペインで、[統合ランチパッド] アイコン ([統合ランチパッド] アイコン) を選択します。
    3. [ 統合を参照 (Browse Integrations )] タブで、検索フィールドに 「REST 」と入力します。
    4. REST API 統合タイルを選択します。
      注:
      「事前準備」セクションに記載されているすべての前提条件を満たさずに統合プロセスを開始した場合は、メッセージが表示されます。統合をキャンセルして満たされていない要件を満たすか、ドラフトモードで続行して後で要件を満たすかを選択できます。すべての前提条件が満たされた場合にのみ、構成された 統合 をアクティブ化できることに注意してください。アクティブ化されていない保存済み統合は、統合ランチパッド[インストール済み統合 (Installed integrations)] タブの [アクションを待機中 (Waiting for your action)] で利用できます。
    5. [詳細を入力] を選択します。
    6. フォームのフィールドに入力し、[ 次へ] を選択します。
      フィールドの説明については、「REST API 統合構成フィールド」を参照してください。
      次へ を選択すると、構成が保存され、設定手順 タブが表示されます。
    7. 画面の指示に従って、モニタリングツールに統合をインストールします。
      1. 指定された URL をコピーします。

        URL の形式は http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw で、 /aps/mid/hla/raw がエンドポイントです。

      2. サードパーティコンソールの構成に URL を貼り付けると、ログを MID サーバーにストリーミングするための URL を入力するように求められます。
      注:
      指定された URL でログをプッシュするために使用される認証方法は、選択した MID Web サーバーで設定されている方法と同じである必要があります。
    8. [アクティブ化] を選択して integration をアクティブ化します。
      統合 がアクティブ化されます。その [ 概要 ] タブが表示されます。

    タスクの結果

    Log データServiceNowインスタンスへのストリーミングを開始します。統合 のタイルは、統合ランチパッド[インストール済み統合 (Installed integrations)] タブで利用できます。

    evt_mgmt_user ロールを持つユーザーは、イベント管理を使用してログを監視し、ヘルスログアナリティクスがそれらのログから生成するアラートを表示できます。

    次のタスク

    [概要] タブで、ログデータストリーミングのステータスとソース 統合を確認します。表示された情報を活用して、統合構成を調整しHLAログデータの読み取り方法を絞り込みます。詳細については、「ログデータストリーミングのステータスとソースの確認 統合統合」を参照してください。
    注:
    [ 概要 ] タブから、[表示メニュー] アイコン ( [表示メニュー] アイコン)を選択し、関連するオプションを選択することで、この統合のコンテキストを含む [データ入力マッピング]、[ソースタイプ構造]、および [ログソース] ページに直接移動できます。このメニューでは、この 統合 が取り込む生のログを表示するログビューアーに直接アクセスすることもできます。