HTTP API エクスポーター

HTTP APIエクスポーターは、Nexthinkから生データやインサイトを、CMDBのようなサードパーティーツールやSIEM、IT Ops、AI Ops、ロギング、監視などのオペレーションツールにエクスポートすることにより、職場の技術体験を向上させます。

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

• 特定の指標の時間経過による進化を表示する強力な最新のビジュアライゼーションを作成する。

• データの粒度の一貫性を確保する。

• コンプライアンスおよびセキュリティ基準を満たすために、複数のソースからデータを結合する。

• 変更時および変更後の構成アイテムのシステマティックな更新を自動化する。

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

前提条件

この統合には次のものが必要です：

• システムがJSONペイロード経由で複数のレコードを送信できる公的APIのあるサードパーティーツール。

• サードパーティーツールAPIに接続するための認証メカニズムは、BASIC、ベアラートークン、または（クライアント資格情報）OAuth 2.0のいずれかでなければなりません。

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

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

    Copy

    {"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データエクスポーターを作成する

Data Exportにアクセスするには:

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

2. ナビゲーションパネルの Integrations セクションから Outbound connectors を選択します。

1. Outbound connectorsのリストから Data Exporter を選択します。 Data Exporterのページには、作成されたデータエクスポーターの合計数が一覧表示されます。

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

1. 新しいエクスポーターのページで Generalタブ と Dataタブ に記入します。

2. テストを実行して最大20レコードをロードする ボタンをクリックして、Dataタブの NQLクエリ を実行します。

3. ページの下部にある Save ボタンをクリックして、新しいデータエクスポーターを検証して作成します。

Generalタブ

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

• Description (任意): データエクスポーターのために有意義な目的を入力します。

• Credentials: Nexthinkデータのエクスポートを可能にする第三者ツールの認証情報を定義します。 詳細については Connector credentials ドキュメントを参照してください。

• Method: データ送信をサポートするパブリックAPIのメソッドを定義します。例えば、POST、PUT、PATCHです。

• Resource: プロトコルとインスタンスを除いたパブリックAPIエンドポイント名を以下の表に従って入力します。

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

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

  • 毎日: システムは、Nexthink cloudインスタンスのあるタイムゾーンの0:00に毎日データエクスポートをトリガーします。

  • 毎週: システムは、選択した日の0:00にNexthink cloudインスタンスのあるタイムゾーンで毎週データエクスポートをトリガーします。

毎時 と 毎日 のスケジューリング頻度では、データの完全性を確保するために、前のバケットが正しく閉じるまで20分待ってからデータエクスポーターが実行されます。

Dataタブ

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

• ペイロード構造: サードパーティのツールAPIに送信するペイロード構造を選択します。 ターゲットとしているパブリックAPIがこのページに説明されているペイロード構造の1つをサポートしていることを事前に確認してください。

• ペイロード (JSON): サードパーティーツールに送信するペイロード構造をJSON形式で記述します。 1つのオブジェクトだけのペイロードを指定します。

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

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

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

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

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

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

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

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

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

制限

最新の上限のリストについては、Nexthink Infinity のしきい値と上限の概要を参照してください。&#x20

よくある質問 (F.A.Q.)