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

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

始める前に

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

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

  

  重要:

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

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

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

  MID サーバー クライアントと外部クライアントが同じネットワーク上にある場合、パブリック IP は必要なく、プライベート IP アドレスを使用して接続を確立できます。

注:

REST API 統合では、受信データに対して UTF-8 エンコードのみがサポートされています。

必要なロール：evt_mgmt_admin

手順

1. 移動先 ワークスペース > サービスオペレーションワークスペース.
2. 左側のペインで、[統合ランチパッド] アイコン ( ) を選択します。
3. [ 統合を参照 (Browse integrations )] タブで、検索フィールドに 「REST 」と入力します。
4. REST API 統合タイルを選択します。
   注:

   すべての前提条件を満たす前に統合セットアップを開始すると、メッセージが表示されます。セットアップをキャンセルして前の要件を先に完了するか、ドラフトモードで続行して後で完了することができます。すべての前提条件が満たされるまで、統合をアクティブ化できないことに注意してください。
5. [ 詳細を入力 ] フォームのフィールドに入力します。
   フィールドの説明については、「REST API 統合構成フィールド」を参照してください。
6. [Next (次へ)] をクリックします。
7. [設定手順] 画面で、指定された 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) が、[ 詳細を入力 ] フォームで設定した値に置き換えられました。

8. [ ドラフトを保存] を選択します。
9. [アクティブ化] を選択して統合をアクティブ化します。
   注:

   すべての統合の前提条件を満たしている場合にのみ、構成された統合をアクティブ化できます。
10. オプション: 統合をドラフトモードでインストールした場合は、後で次の手順を実行してアクティブ化します。
    1. 統合の前提条件を満たします。
    2. [ 統合ランチパッド インストール済み統合 (Installed integrations )] タブの [アクションを待機中 (Waiting for your action)] で、統合を見つけて選択します。
    3. [セットアップ手順 (Set up instructions)] 画面で、[アクティブ化 (Activate)] を選択して統合をアクティブ化します。

タスクの結果

統合が有効になり、[ 概要 ] 画面が表示されます。統合のタイルは、統合ランチパッドの [インストール済み統合 (Installed integrations)] タブで使用できます。

次のタスク

ログメッセージを MID サーバーに送信するように API クライアントに指示します。

1. API クライアントで、次のパラメーターを使用して要求を構成します。
   • HTTP メソッド:POST。
   • URL: 設定手順 画面でコピーした URL です。
   • 認証:必要な認証情報。たとえば、ベーシック認証 (ユーザー名とパスワード) などです。
     注:

     認証方法は、MID Web サーバーで設定されている方法と同じである必要があります。
   • ヘッダー:ペイロード形式と一致するように Content-Type ヘッダーを設定します。
     • JSON の場合: application/json。
     • 生のテキストの場合: text/plain。
   • 本文:JSON または生のテキストのログペイロード。
2. 要求を送信します。

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