ヘルスログアナリティクスでの REST API データ入力の手動構成

ログデータを ServiceNow インスタンスにストリーミングするための REST API データ入力を設定します。

始める前に

• 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 アドレスを使用して接続を確立できます。

必要なロール：evt_mgmt_admin

手順

1. 移動先 すべて > ヘルスログアナリティクス > データ入力 > データ入力.
2. [データ入力 (Data Inputs)] ページで、[新規] を選択します。
3. REST API データ入力を選択します。
4. フォームのフィールドに入力します。
   フィールドの説明については、「REST API データ入力構成フィールド」を参照してください。
5. [保存] を選択します。
   • ヘルスログアナリティクス でデータ入力レコードが データ入力 テーブルに追加されます。
   • ログを MID サーバーに送信するための REST API データ入力 URL がシステムによって自動的に生成されます。生成される URL は、 http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw の形式になります。 HLAは、(MID_SERVER_IP) と (MID_WEB_SERVER_PORT) を設定した値に置き換えます。
6. 生成された URL をコピーします。
7. ログメッセージを MID サーバーに送信するように API クライアントに指示します。
   1. API クライアントで、次のパラメーターを使用して要求を構成します。
      • HTTP メソッド:POST。
      • URL:前の手順でコピーした URL。
      • 認証:必要な認証情報。たとえば、ベーシック認証 (ユーザー名とパスワード) などです。
        注:

        認証方法は、MID Web サーバーで設定されている方法と同じである必要があります。
      • ヘッダー:ペイロード形式と一致するように Content-Type ヘッダーを設定します。
        • JSON の場合: application/json。
        • 生のテキストの場合: text/plain。
      • 本文:JSON または生のテキストのログペイロード。
   2. 要求を送信します。
      正常な応答は、 MID サーバー がペイロードを受信したことを示します。MID サーバー がログメッセージを処理すると、データ入力は REST プロトコルを使用してログメッセージを ServiceNow インスタンスにストリーミングします。