Tracking Amplify usage

Understanding how support agents use Amplify is key to maximizing its value. Nexthink provides data on actions taken in Amplify through the NQL data model, allowing you to build dashboards, run reports, and identify gaps in adoption.

Examples of tracked data include:

• The number of total active users.

• Active users per feature:

  • Properties

  • Actions

  • Checklists

  • Search

  • Packages

• Number of actions per feature.

• Checklist usage, measured in events per checklist.

• Remote action and workflow usage, measured in events per remote action and workflow.

• Timestamped instances of which feature and which action were used, broken down by user.

To give you control over whether you want to capture this detailed usage data, this feature is opt-in.

Getting started with Amplify usage tracking

To start tracking Amplify usage data, you must first enable the relevant settings.

Enabling Amplify usage data collection from Nexthink Administration

From the sidebar on the Nexthink platform:

1. Navigate to Administration > Amplify.

2. Under Product usage, check the Enable usage data collection box.

3. Save your settings.

Defining role permissions

From the Main menu of the Nexthink web interface:

1. Navigate to Administration > Roles.

2. Select the role you intend to see Amplify-tracked data and Edit.

3. Under Data model visibility, set Nexthink Usage to Visible.

4. Save your settings.

Accessing the data

You can access the tracked data using NQL queries, enabling you to consult it via investigations or aggregate it in a dashboard. As the specific data to track is based on your organizational needs, below are some example queries on the most common data types.

Total users in the last 30 days

usage.account_actions during past 30d
| summarize active_user = account.name.count()

Users and number of actions per feature

usage.account_actions during past 90d
| summarize active_users = platform.account.account_uuid.count(), actions_per_feature = count() by feature
| sort active_users desc

Checklist usage in events per checklist

usage.account_actions during past 90d
| where feature == "checklists" and action in ['open_tab', 'open_checklist']
| summarize events = count() by action_target
| sort events desc

Remote action and workflow usage in events per remote action and workflow

usage.account_actions during past 90d
| where action in ['trigger_remote_action', 'trigger_workflow']
| summarize triggered_from_actions = countif( feature == 'actions' ), triggered_from_checklists = countif( feature == 'checklists' ) by action, action_target
| sort triggered_from_actions desc

Usage of the packages tab use for L1 and L2 roles

usage.account_actions during past 90d
| where feature == 'packages'
| summarize l1_active_users = countif( platform.account.roles contains "L1 Agents" ), l2_active_users = countif( platform.account.roles contains "L2 Agents" )

List of actions tracked in NQL

Amplify usage data is tracked through the actions in the table below:

Feature	Action	Action target	Description
search	search	-	A search was triggered in Amplify
search	open_device_view	-	Device view is opened from Amplify
properties	view_user	-	Properties of a user are opened after a search
properties	copy_user_properties	-	Properties of the user were copied
properties	open_device_of_user	-	Open the device from the user properties
properties	view_device	-	Properties of a device are opened after a search
properties	copy_device_properties	-	Properties of the device were copied
properties	open_user_of_device	-	Open the user from the device properties
checklists	open_tab	Checklist name	Go to the checklist tab
checklist	copy_properties	Checklist name	Copy properties from a checklist
checklists	open_checklist	Checklist name	Switch to a checklist from the checklist tab
checklists	trigger_remote_action	Remote action name	Trigger a remote action from the checklists tab
checklists	trigger_workflow	Workflow name	Trigger a workflow from the checklists tab
checklists	copy_remote_action_results	Remote action name	Copy remote action results from the checklists tab
checklists	copy_workflow_results	Workflow name	Copy workflow results from the checklists tab
actions	open_tab	-	Open the actions tab
actions	trigger_remote_action	Remote action name	Trigger a remote action from the actions tab
actions	trigger_workflow	Workflow name	Trigger a workflow from the actions tab
actions	copy_remote_actions_results	Remote action name	Copy remote action results from the actions tab
actions	copy_workflow_results	Workflow name	Copy workflow results from the actions tab
packages	open_tab	-	Open the packages tab