セルフサービスポータルを使用したデバイス問題の改善
始めるにあたり、一般的なセルフサービスのユースケースに対するNQL例を確認ください。
従業員にデバイスに関連する基本的な情報やトラブルシューティングオプションを提供するために、Nexthinkデータを活用してデバイス情報を取得し、以下のリモーションを開始します:
リモートアクションを使用してディスク容量の問題を修正します。
Workflowsを使用したMicrosoft Teamsのトラブルシューティング。
バッテリーヘルスが低い場合に備えて、新しいバッテリーを注文します。

前提条件
Nexthinkとセルフサービスポータルの統合を始める前に、以下の要件を整えてください:
Nexthinkライセンス
管理者権限
セルフサービスポータルのインタラクション設計
Step 1: Authenticate communication
Configure API credentials and collect a token via the API.
Step 2: Identify the device
NQL API を使用して、セルフサービスポータルウィジェットが username
に基づいてデバイスを識別できるようにします。 または、大規模な組織の場合、Nexthinkはこの情報をキャッシュするためにData Exporterの使用を強く推奨します。
Step 3: Diagnose the device
Use NQL API (or Data Exporter) to retrieve device performance data and outputs of the Get Startup Impact and Get Battery Status remote actions.
Step 4: Remediate the issue
Remote Actions API を使用して、ユーザーのデバイスで Disk Cleanup リモートアクションをトリガーします。
ステップ5:修正のフォローアップ
NQL APIを使用して修正状態と詳細を取得し、修正結果をユーザーに通知します。
Nexthinkで
Nexthink web インターフェースでAPI機能を設定します。 Nexthinkは、いくつかの機能が相互依存しているため、リストされている順序に従うことを推奨します。 それでもなお、必要に応じて異なるソリューション間をナビゲートする自由があります。
データ収集リモートアクションの設定
次のリモートアクションをNexthink Libraryからインストールしてください:
スタートアップインパクトを得る
Get Battery Status
毎日実行されるようにスケジュールを設定します。 詳細については、 リモートアクションの管理 を参照してください
このステップを完了したら、後のステップで使用するために両方のリモートアクションのNQL IDを保存します。
NQL ID's:
get_startup_impact_windows
get_battery_status
修正リモートアクションの設定
Nexthink Libraryからリモートアクションのディスククリーンアップをインストールします。 既にインストールしている場合は、次のようにコピーして設定してください:
リモートアクショントリガーにAPIを選択します。
入力パラメータのデフォルト値を設定し、自分のセルフサービスポータルのニーズに合わせます。 下記のディスククリーンアップリモートアクションの入力パラメータテーブルを参照してください。
ディスククリーンアップリモートアクションの入力パラメータ
DiskCleanupCampaignId
キャンペーンを表示したい場合は、Nexthink Library キャンペーン disk_cleanup_invoke
を使用してください。
キャンペーン確認ポップアップを表示したくない場合は、値00000000-0000-0000-0000-000000000000を入力してください。
CleanupCompletedCampaignId
キャンペーンを表示したい場合は、Nexthink Library キャンペーン disk_cleanup_completed
を使用してください。
キャンペーン通知ポップアップを表示したくない場合は、値00000000-0000-0000-0000-000000000000を入力してください。
RemoveFilesNotModifiedInDays
Nexthink Library からのデフォルト値 (7)
MaximumDelayInSeconds
Nexthink Library からのデフォルト値 (30)
CleanupLevel
クリーンアップレベルを選択してください。Light または Deep。
このフィールドは、キャンペーンを使用せず、従業員にクリーンアップレベルを選ばせる場合にのみ機能します。 それ以外の場合、従業員の選択が優先されます。
このステップを完了したら、次のステップで使用するためにリモートアクションのNQL IDを保存します。
NQL ID: disk_cleanup
NQL APIクエリの作成
設計されたシナリオに従い、3つのNQL APIクエリを作成する必要があります:
ユーザーの
username
に基づいてユーザーのデバイスを取得する—ステージ1:デバイスを特定する。現在のトピックの診断を実行するためにデバイスデータを取得する—ステージ2:デバイスを診断する。
リモートアクションのステータスと結果を取得する—ステージ4:修正のフォローアップ。
各NQL APIクエリの詳細を参照してください。
このステップを完了したら、次のステップで使用するためにすべてのNQL APIクエリのNQL IDを保存します。
NQL ID's:
#get_device_basic_infos
#diagnose_device_bad_health
#get_remote_action_result
APIクレデンシャルの作成
Nexthink web インターフェースでAPIクレデンシャルを作成し、Nexthinkとセルフサービスポータル間の安全な通信を確立します。 Permissions セクションで、Remote Actions API と NQL API を選択します。 詳細については、 APIクレデンシャル ドキュメントを参照してください。
セルフサービスポータルで
Nexthink内のすべての必要なAPI機能を構成した後、API呼び出しの実装に進みます。
ステップ1:通信を認証する
次のAPI呼び出しを実行する前に、有効な認証トークンを取得する必要があります。 生成した APIクレデンシャル を使用して有効なOAuthトークンを取得する方法については、 Nexthink Developer ドキュメントを参照してください。
ステップ2:デバイスを特定する
デバイスを特定するには、 ユーザー名に基づいてユーザーのデバイスを取得する で作成した NQL API クエリ #get_device_basic_infos
を使用します。
大規模な組織の場合、どのデバイスがどの従業員によって使用されているかを特定するためにCMDBを頼ることをNexthinkは推奨します。 Data Exporterを使用してCMDBデータを補強および修正するためにNexthinkデータを活用してください。 Set upする方法については、エクスポート via SFTP または エクスポート via HTTP for ServiceNow のドキュメントを参照してください。
主要なユーザー情報を抽出するために定期的にNQLクエリに基づいたデータエクスポートを検討してください。
session.events past 30d
| summarize last_event = time.max() by collector.uid, device.name, operating_system.platform, operating_system.name,
hardware.type, hardware.manufacturer, last_seen
ステップ3:特定のデバイスを診断する
ユーザーがデバイスを選択した後にデバイス情報を取得するには、 現在のトピックの診断を実行するためにデバイスデータを取得する で以前に作成した NQL API クエリ #diagnose_device_bad_health
を使用します。
ステップ4:問題を修正する
リモートアクションAPIを使用して、前のステップで構成したディスククリーンアップリモートアクションを実行し、 従業員がセルフサービスウィジェットのボタンをクリックした後に問題を解決します。詳細はリモートアクションの構成を参照してください。
手順5:修正状況をフォローアップ
リモートアクションのステータスと結果を取得するために、事前に作成した #get_remote_action_result
NQL API クエリを使用します。
Nexthink は、APIでリモートアクションをトリガーした後、少なくとも1分経過してからリモートアクションの結果を取得するための呼び出しを行うことを推奨します。
リアルタイムのフィードバックを受ける場合、セルフサービスポータルの開発がそれをサポートしている場合は、リモートアクションが完了した際に通知を受けるためのwebhookの使用を検討してください。
あらかじめ構築されたコンテンツ
セルフサービスポータルの統合を始めるのに役立つように、一般的なチャットボット会話で使用できるトピックの例を見つけてください。 各トピックには以下が含まれます:
前提条件データ収集リモートアクション。 このセクションで参照するすべてのリモートアクションはNexthinkライブラリーに存在し、事前に構成する必要があります。
データ収集リモートアクションのトリガータイプスケジュールを選択し、必要な頻度に応じてスケジュールを毎時または毎日に設定します。
トリガータイプAPIを選択して、リメディエーションリモートアクションをアクティブにします。 詳細についてはリモートアクションの管理文書を参照してください。
診断NQLクエリ。
診断クエリ結果を解釈するロジック。
各診断のための可能な修正方法。
デバイス名を事前に特定していることを前提に、エンドツーエンドのユースケースと同様のフローを使用して例を実装します。
一般的なクエリ
エンドツーエンドのユースケースで示されているように、すべてのユースケースで役立つ基本的なタスクを実行するために一般的なクエリを構成します。
ユーザーのデバイスの取得
クエリID: #get_device_basic_infos - username
に基づくマッチング
過去7日間のデバイス
| session.events(過去7日間)とともに
| user.name == $username
| list collector.uid, device.name,
operating_system.platform, operating_system.name,
hardware.type, hardware.manufacturer, last_seen
| sort last_seen desc
代替のアプローチで使用するために| where user.name == $username
句を調整できます。例えば:
ユーザーのUPNを知っている場合:
| where user.upn == $upn
(コレクターレベルでUPNを有効にする必要があります)ユーザーのメールアドレスを知っている場合:
| where user.ad.email_address == $email
(Azure ADコネクターを有効にし、メールフィールドが同期されている必要があります)デバイス名を知っている場合:
| where device.name == $device_name
ユーザーがアクティブだった7日間以外の期間についてデバイスを考慮したい場合は、期間を調整してください。
保持期間のデフォルト設定は30日であるため、最大データ保有期間まで期間を調整できます。
リモートアクションのステータスと出力を取得します
クエリID: #get_remote_action_result
過去24時間のリモートアクション実行
| request_id == $request_id
| list request_id, device.name, remote_action.name,
status, status_details, outputs
関連トピック
Last updated
Was this helpful?