search
サポート (英語のみ)

HTTP API エクスポーター

HTTP API エクスポーターは、Nexthink から構成管理データベース (CMDB) や SIEM、IT Ops、AI Ops、ロギング、モニタリングなどのオペレーション ツールに生のデータとインサイトをエクスポートすることによって、職場の技術体験を向上させます。

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

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

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

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

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

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

hashtag
前提条件

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

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

  • サードパーティツール API に接続するための認証メカニズムは、BASIC、ベアラートークンまたは (クライアントクレデンシャル) 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"
    }
  ]
}

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

circle-info

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

データエクスポートにアクセス:

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

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

Location of the Outbound connectors on the Navigation panel

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

circle-info

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

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

ExportersList.png

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

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

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

hashtag
一般タブ

HTTPAPIExporter-GeneralTab-1 (1).png

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

  • 説明 (任意): データエクスポーターの意味のある目標を入力します。

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

  • メソッド: データの送信をサポートする公開 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

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

    • 時間単位: ドロップダウンメニューで選択された値に基づいてデータエクスポートをトリガーします。 たとえば、1h、2h、3h、4h、6h、12hごと。

    • 毎日: Nexthink クラウド インスタンスが所在するタイムゾーンでの 00:00 に毎日データ エクスポートをトリガーします。

    • 毎週: Nexthink クラウド インスタンスが所在するタイムゾーンでの 00:00 に、選択された日にデータ エクスポートを毎週トリガーします。

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

circle-info

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

hashtag
データ タブ

HTTPAPIExporter-DataTab-1.png

  • NQL クエリ: Nexthink ウェブ インターフェイスからエクスポートされたデータを NQL クエリを使用して宛先に定義します。

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

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

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

circle-info

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

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

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

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

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

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

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

JSON_example.png

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

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

circle-info

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

hashtag
制限事項

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

hashtag
FAQ

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

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

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

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

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

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

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

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

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

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 が繰り返される場合に、重複して配信されたデータを特定できます。

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

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

Last updated

Was this helpful?