データエクスポーターの管理

コネクタ認証情報

Nexthink がデータをサポートされているサードパーティのツールにエクスポートするには、接続とその通信を有効にするために新しい認証情報を作成および定義し、データエクスポーターを設定する際にその認証情報を適用しなければなりません。詳細については、コネクタ認証情報ドキュメントを参照してください。

Nexthink は、サードパーティツールに送信されるメッセージの配信を調整するメカニズムを使用しており、これによってデータで過負荷になることを防ぎます。これにより、情報の配信が即時ではなく、遅延が発生する場合があります。

データエクスポーターへのアクセス

Nexthink Web インターフェースのメインメニューから：

Administration > アウトバウンドコネクタ > Data Exporter をクリックして、管理ページを開きます。

すべてのデータエクスポーターは、データエクスポーター管理ページで一覧表示されます。表示されるフィールドは以下の通りです:

データエクスポーターを有効/無効にするためのアクティブトグル。
データエクスポーターの名前。
データエクスポーターのタイプ。
NQL の時間間隔に一致するスケジュール頻度: 毎時、毎日 = 1日、毎週 = 7日です。
データエクスポーターの最終更新日。
データエクスポーター実行の成功または失敗を示す最後の実行。このページのデータエクスポーターのトラブルシューティングセクションを参照してください。

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

データエクスポーター管理ページから：

ページの右上隅にある新しいエクスポーターボタンをクリックして、データエクスポーターの設定ページを開きます。

ポップアップからデータエクスポーターのタイプを選択します。データエクスポーターに応じて、以下のリンクを参照してください：

データエクスポーターの編集/削除

選択した項目の右側にアイコンを表示するには、データエクスポーター管理ページに一覧表示されているデータエクスポーターの上にカーソルを置いてください。

鉛筆のアイコンをクリックして、データエクスポーターの設定ページを開きます。
ゴミ箱のアイコンをクリックしてデータエクスポーターを削除します。

データエクスポーターの削除は元に戻せません。

データエクスポーターのログ調査

データエクスポーターは、認証情報の期限切れやリソースの利用不可など、さまざまな理由で失敗する可能性があります。これらの失敗は、データレイクにデータが欠ける結果をもたらす可能性があります。これらの失敗を理解することは、問題を迅速に解決し、ダッシュボードに表示されるデータの問題を把握するために重要です。

システムは、platform.date_exporter_logs テーブルに、エクスポートの期間、ステータス、データエクスポートNQL IDなどの詳細とともに、各バルクデータエクスポートイベントを保存します。特定のデータエクスポーター失敗の原因を調査するには、次のNQLクエリを使用してください：

platform.data_export_logs during past 30d
| where status = failure
| where details.nql_id ="#my_data_export_ID"
| list data_export_log.status , data_export_log.time , details.description , details.number_of_retries , details.nql_id

Nexthinkは、すべてのデータエクスポーターの失敗を検出するモニターを設定することをお勧めします。これにより、情報を把握し、迅速に対応できます。次のモニターNQLクエリと設定を使用する:

platform.data_export_logs during past 24h
| where status = failure
| summarize failing_computations = count() by details.nql_id

実行が失敗すると、データエクスポーター設定ページの最後の実行試行日付の隣に、赤いアイコンが表示されます。失敗のステータスの上にカーソルを置くと、詳細なエラー情報を含むポップアップが表示されます。

日々の制限の監視

Nexthinkは従業員が特定の使用ケースに基づいてグローバル制限と日々のデータエクスポート消費を監視することを可能にします。

NQLクエリを使用したデータエクスポート使用量の監視

次のNQLクエリを実行して、データ一括エクスポートの使用状況を調査します。

platform.data_export_logs 過去1日間
| summarize exportedRows = details.number_of_rows.sum()

これにより、過去24時間にエクスポートされた総行数が返されます。

データエクスポート使用状況のNQL分析APIでの監視

日々の消費量をクエリするためのGETステータスリクエストを送信します。 APIは応答に以下のヘッダーを含んでいます：

x-nexthink-daily-record-consumption: 消費されたグローバル日々の制限。
x-nexthink-daily-record-limit: デフォルトの1日あたりのエクスポート全体の上限。この上限は毎日00:00 UTCにリセットされます。
x-nexthink-individual-query-record-limit: 単一のエクスポーターでエクスポートできる行数の上限。

NQL API ドキュメントを参照してください。

カスタムダッシュボードの作成

あなたのニーズと具体的な使用ケースに応じて、バルクデータ使用量を積極的に監視するためにカスタムのダッシュボードをゼロから作成します。

ダッシュボードを作成するには：

メインメニューからLive Dashboardsを選択します。
空のダッシュボードページの右上隅にあるダッシュボードを作成をクリックしてください。
ダッシュボードに意味のある名前を入力し、保存をクリックしてください。

ウィジェットの追加

ダッシュボードを保存した後、編集モードでウィジェットを追加します：

新しいウィジェットを追加するには、ウィジェットを追加をクリックしてください。

追加したいウィジェットのタイプを選択します。
- Visualizationsを使用して、データを線グラフ、棒グラフ、ゲージチャート、テーブルまたはその他の視覚化タイプとして提示します。
- ダッシュボードに新しいセクションやウィジェットのグループ名を入力するには、見出し。
視覚化フィールドをウィジェットを追加ポップアップに入力します。
ウィジェットを保存をクリックしてください。

ダッシュボード作成のドキュメントを参照してください。

上限超過による失敗のトラブルシューティング

制限が超過すると、バルクデータエクスポートログが失敗をお客様に通知します。ログには、問題を引き起こしたレコード数を含む詳細情報が提供されます。

次のNQLクエリを実行して、上限超過によるエクスポートの失敗を特定します。

platform.data_export_logs
| where status == failure
| where details.description in ["*Limit exceeded*"]
| list details.nql_id