New DEX certifications launch at Experience '26. Get certified and learn from experts in your field.
Register now
Ctrlk
学ぶ (英語版)ドキュメント サポート (英語のみ)コミュニティ (英語版)
For the complete documentation index, see llms.txt. This page is also available as Markdown.

HTTP API エクスポーター

HTTP API Exporter は、Nexthink から CMDB や SIEM、IT Ops、AI Ops、ログ、モニタリングなどの運用ツールといったサードパーティツールへ生データとインサイトをエクスポートすることで、職場のテクノロジー Experience を向上させます。

Nexthink の API データエクスポートをサードパーティツールと統合することにより、データを組み合わせ、集約し、操作することが可能になります。

  • 特定の指標の時間の経過に伴う変化を視覚化することで、強力な最新のビューを作成できます。

  • データの粒度を一貫して保持します。

  • 複数のソースからデータを組み合わせて、コンプライアンスとセキュリティ基準を満たします。

  • 変更中および変更後に、構成アイテムの自動システマティックな更新を行います。

HTTP API エクスポーターは、組織内のコスト削減を目指し、例えば、サービスデスクの時間を節約することで、サービス利用の理解を深めることを目的としています。

前提条件

この統合には以下が必要です:

  • 公開 API を備え、JSON ペイロードを使用して複数のレコードをシステムから送信できるサードパーティツール。

  • サードパーティツール API へ接続する認証メカニズムは、BASIC、bearer token、または（クライアントクレデンシャル）OAuth 2.0 のいずれかである必要があります。

  • 公開APIサードパーティツールのJSONペイロードは、以下の形式のいずれかをサポートする必要があります:

    • JSON オブジェクトのコレクション:

      {"property_a":"value_a", "property_b":"value_b"}
{"property_c":"value_c", "property_d":"value_d"}
{"property_e":"value_e", "property_f":"value_f"}

    • 複数のJSONオブジェクトを含む配列:

      [{"property_a":"value_a", "property_b":"value_b"},
{"property_c":"value_c", "property_d":"value_d"},
{"property_e":"value_e", "property_f":"value_f"}]

    • プロパティと1つの配列を持つJSONオブジェクト:

      {
  "property_a": "value_a",
  "property_b": "value_b",
  "records": [
    {
      "property_c": "value_c",
      "property_d": "value_d",
      "property_e": "value_e",
      "property_f": "value_f"
    }
  ]
}

HTTP API データ エクスポーターの作成

データエクスポーターを設定するには、管理者権限が必要です。 ユーザーロールの詳細については、ロールのドキュメントを参照してください。

データエクスポーターにアクセスするには:

  1. メインメニューから管理を選択します。

  2. ナビゲーションパネルの統合セクションからアウトバウンドコネクターを選択します。

  1. アウトバウンド コネクタの一覧からデータ エクスポーターを選択します。データ エクスポーター ページには、作成されたデータ エクスポーターの合計数が記載されています。

最初のデータエクスポーターを作成するまでは、データエクスポートページは空のままです。

  1. ページの右上隅にある新しいエクスポーターボタンをクリックして新しいデータエクスポーターを作成し、HTTP API エクスポーターオプションを選択します。

ExportersList.png

  1. 新しいエクスポーター ページで一般タブおよびデータタブを記入します。

  2. [テスト] セクションで NQL クエリ を実行するために、最大 20 件のレコードをロード ボタンをクリックします。

  3. [保存] ボタンをクリックしてデータエクスポーターを検証して作成します。

一般タブ

メインの詳細

  • 名前: データエクスポーターの名前を入力します。

  • NQL ID：NQL クエリで ServiceNow コネクタを参照する際に使用される、コネクタ固有の識別子です. 提案された NQL ID は最初に変更できますが、コネクタを保存すると以後は変更できなくなります。

  • 説明（任意）: データエクスポーターの目的をわかりやすく入力します。

接続

  • 認証情報: Nexthink データのエクスポートを有効にするために、サードパーティツールの認証情報を定義します。 詳細については、Connector credentials ドキュメントを参照してください。

  • メソッド: データ送信に対して公開 API がサポートするメソッド（POST、PUT、PATCH など）を定義します。

  • リソース: 以下の表に記載されているとおり、プロトコルとインスタンスを除いた公開 API エンドポイント名を入力します。

フル URL
リソース値

https://ven00000.service-now.com/api/now/import/u\_infinity\_file/insertMultiple

api/now/import/u_infinity_file/insertMultiple

https://prd-p-00000.splunkcloud.com:8088/services/collector?index=main

services/collector?index=main

カスタムヘッダー

セキュリティ向上のため、1 つ以上の静的トークンを含むカスタム HTTP ヘッダーを作成します。新しいカスタムヘッダー を選択し、各トークンに対して次の情報を入力します:

  • キー: トークンの名前を入力します。

  • 値: トークンの値を入力します。エクスポーターを保存した後に、トークンを常に表示する（ロック解除アイコン）か、完全に非表示にする（ロックアイコン）かを切り替えるには、南京錠アイコンを選択します。

スケジューリング頻度

  • 繰り返し: システムが NQL クエリーを実行しデータをエクスポートする頻度を定義します。利用可能なオプションは次のとおりです:

    • 毎時: ドロップダウンメニューで選択した値に基づき、システムがデータエクスポートを実行します。例: 1 時間ごと、2 時間ごと、3 時間ごと、4 時間ごと、6 時間ごと、または 12 時間ごと。

    • 毎日: Nexthink クラウドインスタンスが位置するタイムゾーンの 00:00 に、システムが毎日データエクスポートを実行します。

    • 毎週: Nexthink クラウドインスタンスが位置するタイムゾーンの 00:00 に、選択した曜日に毎週データエクスポートを実行します。

毎時および毎日のスケジュール頻度では、前のバケットが適切に閉じられてデータの完全性を確保するために、システムがデータエクスポーターを実行する前に 20 分待機します。

繰り返しオプションの値を選択する必要があります。デフォルトの値を生成しないため、検証プロセスで値が不足していることは示されません。

データ タブ

クエリー

  • NQL クエリー: NQL クエリーを使用して、Nexthink Web インターフェイスから出力先へエクスポートされるデータを定義します。

ペイロード

  • ペイロード構造: サードパーティツール API に送信するペイロード構造を選択します。 対象の公開 API が、このページで説明されているいずれかのペイロード構造をサポートしていることを事前に確認してください。

  • ペイロード（JSON）: サードパーティツールに送信するペイロード構造を JSON 形式で作成します。単一オブジェクトのペイロードのみを指定します。

  • ペイロードコンテンツヘルパー: ペイロード内で使用できる NQL クエリーの変数を一覧表示します。

エクスポーターは、NQL クエリによって生成された結果の数だけオブジェクト構造を繰り返します。

HTTP データ エクスポーターのテスト

最大 20 件のレコードをロードするボタンをクリックして、データ タブで構成されたクエリを実行します。システムは、一般タブに設定した宛先に結果を送信します。

  • NQL クエリと接続が有効な場合、クエリ結果が正常に配信されたことを示すメッセージが表示されます。

  • NQL クエリまたは接続が無効な場合は、エラーの詳細を通知するメッセージが表示されます。

次のスクリーンショットは、データ タブに有効なクエリのさまざまな例を示しています。

有効なクエリの例 (JSON オブジェクト)

JSON_example.png

有効なクエリの例 (配列)

有効なクエリの例 (配列を含む JSON オブジェクト)

データエクスポーターの作成、編集、削除、無効化について詳しくは、データエクスポーターの管理のドキュメントを参照してください。

制限事項

詳細な最新の制限リストについては、Nexthink Infinityのしきい値と制限の概要を参照してください。

FAQ

HTTP API エクスポーターがサポートしていないペイロードを追加できますか?

いいえ、ペイロード構造が Nexthink の3つの選択肢のいずれかと一致しない場合、検証エラーが発生します。

ペイロード メッセージ内のキーは、ServiceNow のインポートセットテーブルに対して検証されますか?

ServiceNow のインポートセットテーブル内の列ではないキーをペイロードに挿入しようとした場合、そのキーは挿入されません。

利用可能でないペイロード フォーマットを使用する必要がある場合はどうすればよいですか?

新しいペイロード形式をサポートするアイデアを提案するために、Nexthink の担当者に連絡してください。

HTTP エクスポーターを通じて Nexthink は大規模な NQL クエリ結果をどのように管理しますか?

Nexthink は、大規模なデータセットを効率的に管理するために HTTP エクスポーターを最適化しました。 NQL クエリが1,000レコードを超える場合、Nexthink はデータを1,000レコードごとの扱いやすいバッチに分割し、最大で合計300万レコードまで処理します。これらのバッチは、組織のエンドポイントに計画的に送信されます。スケジューラーは、さまざまな応答時間とデータ量に適応するように設計されており、バッチごとにシームレスで継続的なデータ配信を保証し、完全な転送が達成されるまで実行されます。

Nexthink は HTTP エクスポーターを通じてデータ配信の信頼性をどのように確保していますか?

Nexthink は、HTTP エクスポーターを通じて信頼性の高いデータ配信を保証するために At-Least-Once Delivery アルゴリズムを採用しています。 特にシステム障害時に有効です。これは、要求されたデータのバッチが少なくとも一度は送信され、システム障害時でもデータが失われないことを保証します。データバッチは複数回配信される可能性がありますが、失われることはありません。

余分に配信されたバッチを検出するために、Nexthink は次のようなカスタム ヘッダーを追加しました:

  • X-Nexthink-Execution-Id: スケジュール イベントの ID (スケジュール イベントが発生するたびに新しい ID が作成されます)

  • X-Nexthink-Records: ページごとのレコード数

  • X-Nexthink-Pages: スケジュール イベントごとのページ数

  • X-Nexthink-Current-Page: 実際のページ

  • X-Nexthink-Timestamp: 送信されたページのタイムスタンプ (エポックタイム)

これらのヘッダーを使用すると、同じ X-Nexthink-Execution-Id に対して、任意の時間枠で X-Nexthink-Current-Page が繰り返される場合に、重複して配信されたデータを特定できます。

HTTPエクスポーターのスロットリングメカニズムはどのように機能しますか?

Nexthinkは、システムの安定性と継続的なサービスを確保するためにHTTPエクスポーターのスロットリングメカニズムを実装しています。このメカニズムは、Nexthinkユーザーのインフラストラクチャのレスポンス速度やクエリ処理時間など、さまざまな要因を考慮しながら、秒あたり最大3.33バッチを処理できます。これにより、システムの最適なパフォーマンスが維持されます。

最終更新

役に立ちましたか？