# Device View

Device View helps IT support teams gain deeper insights into troubleshooting scenarios on a device level. Determine where an issue stems from and get a head start on resolution.

Inspect device properties and activities that span a period of up to 30 days.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FiZDrQXwlMtwK3FJor0Z5%2Fimage.png?alt=media&#x26;token=0abbb62a-cb32-43a9-9746-18f93f5ace25" alt=""><figcaption></figcaption></figure>

## Granting Device View permissions <a href="#deviceview-requiredpermissionsfordeviceview" id="deviceview-requiredpermissionsfordeviceview"></a>

From the Nexthink web interface, go to **Administration >** [Roles](https://docs.nexthink.com/platform/user-guide/administration/account-management/roles) in the main menu:

1. Select the following permissions under the **Diagnostics** drop-down:
   * **View device view** is the only mandatory permission.
   * Optional permissions:
     * **View all checklists** to view all checklists or map specific checklists to the user role.
     * **Manage all checklists** to view all checklists or map specific checklists to the user role.
       * Select **Specific checklists added to this role** to granularly manage or revoke permissions for specific custom checklists.
     * **View Diagnostics dashboards**
2. If needed, select the following permissions under the **Remote Actions** drop-down:
   * **Execute all remote actions** to execute any remote action or map specific remote actions to the user role.
3. If needed, select the following permission under the **Investigations** drop-down:
   * **Create investigations**
4. If needed, select the following permission under the **Applications** drop-down:
   * **View all application dashboards** to allow users to access Applications dashboards.
5. If needed, select the following permission under the **Collaboration Tools** drop-down (Collaboration Experience license from Nexthink):
   * **View all collaboration tools dashboards** to allow users to access Collaboration Tools dashboards.

### View domain impact on Device View related permissions <a href="#amplify-dataprivacysettingsforamplify" id="amplify-dataprivacysettingsforamplify"></a>

The table below shows what users with full and limited View domain access can do, assuming the necessary permissions are enabled.

| Permission       | Full access                                                                                                                                                                                                                                   | Limited access                                                                                                                                                                                                                                |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| View Device View | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-83bdc030baff81adb4e63584454cb0106c4d3a58%2Fimage%20(72).png?alt=media" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-83bdc030baff81adb4e63584454cb0106c4d3a58%2Fimage%20(72).png?alt=media" alt="" data-size="original"> |

## Accessing Device View through Search <a href="#deviceview-accessingdeviceviewthroughsearch" id="deviceview-accessingdeviceviewthroughsearch"></a>

1. Select the [Search](https://docs.nexthink.com/platform/user-guide/search-and-workspace) option from the main menu and start typing the name of the device.
2. Select the device from the results under **Devices**.
3. Click **Open device view** in the right column.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-358afde35bf9ef26f54762503cfcf18c5dd9da92%2Fdeviceview-1710429394.png?alt=media" alt="Accessing Device View through Search." width="760"><figcaption></figcaption></figure>

## Accessing Device View through Investigations <a href="#deviceview-accessingdeviceviewthroughinvestigations" id="deviceview-accessingdeviceviewthroughinvestigations"></a>

1. Select **Investigations** from the main menu to create or edit an existing investigation.
2. Enter an NQL query in the **NQL Editor** to return a device or a list of devices.
3. Click on the device name or click on the action menu next to it and select **Open device view** in a new tab.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-0f02b76bc0a8801cbe4f31fc5302f4f06f0d5900%2Fdv-1700045585.png?alt=media" alt="Accessing device view through Investigations" width="760"><figcaption></figcaption></figure>

**NQL example for a device investigation**

Return a device with the name `"MyDeviceNameExample"`.

```
devices 
| where device.name == "MyDeviceNameExample"
```

{% hint style="info" %}
Refer to the [NQL](https://docs.nexthink.com/platform/understanding-key-data-platform-concepts/nexthink-query-language-nql) documentation for more information about how to write queries.
{% endhint %}

## Using Device View <a href="#deviceview-usingdeviceview" id="deviceview-usingdeviceview"></a>

On the Device View page, use the following tabs:

<details>

<summary>The <strong>Timeline</strong> tab displays events chronologically on the device</summary>

The **Timeline** tab allows you to explore events chronologically on the device. Gain further insights using intuitive tooltips and the right-side panel. Additionally, drill down into specific events within timeline sections to gain a detailed view of various activities.

Refer to the [Timeline](https://docs.nexthink.com/platform/user-guide/device-view/timeline) documentation to learn how to use and interpret the timeline.

{% hint style="info" %}
Thresholds for the metrics under **Device Performance** within the **Timeline** tab align with [DEX score thresholds](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/digital-employee-experience-dex-specifications/list-of-hard-metrics-and-thresholds), meaning you can evaluate how troubleshooting at the device level impacts the DEX score.
{% endhint %}

</details>

<details>

<summary>The <strong>Executions</strong> tab provides data about every binary execution on the device</summary>

The **Executions** tab provides data about every binary execution that occurred on the device in the previous hour. It also allows the execution of **Associated actions** specific to a checklist property, mapped to your user [role](#deviceview-requiredpermissionsfordeviceview) and applicable to the target device.

Refer to the [Executions](https://docs.nexthink.com/platform/user-guide/device-view/executions) documentation to learn how to drill down and interpret the data for investigations.

</details>

<details>

<summary>The <strong>Checklists</strong> tab provides immediate insights into key device attributes</summary>

The **Checklists** tab provides immediate insights into key device attributes. It also allows the execution of **Associated actions**, following the same rules as the **Executions** tab.

Refer to the [Checklists](#deviceview-accessingdeviceviewthroughinvestigations) documentation to learn how to create, use, format and interpret default and custom checklists.

</details>

<details>

<summary>The <strong>Network</strong> tab allows you to visualize and troubleshoot network-related issues on the device</summary>

The **Network** tab allows you to visualize and troubleshoot network-related issues prefiltered to the device in question. The Network tab is aligned to the timeframe selected within the **Timeline** tab.

Refer to the [Network view](https://docs.nexthink.com/platform/user-guide/network-view) documentation to learn how to use and interpret the Network view visualization.

</details>

<details>

<summary>The <strong>Packages</strong> tab provides information about installed programs/updates on the device</summary>

The **Packages** tab provides information on currently installed programs and updates on the selected device. It also allows the execution of **Associated actions**, following the same rules as the **Executions** tab.

Refer to the [Packages](https://docs.nexthink.com/platform/user-guide/device-view/packages) documentation to learn how to interpret the data.

</details>

Regardless of the tab you choose on the Device View page:

* Use the Device View [right-side panel](#deviceview-usingthedeviceviewright-sidepanelright-sidepanel) for insightful information and drill-downs, including a remote action and workflow list to execute **Actions** on a device.
* Access the [User Overview](https://docs.nexthink.com/platform/user-guide/device-view/user-overview) dashboard for a comprehensive overview of a user's digital experience with dedicated tabs for areas like DEX, application usage and virtual session performance.

### Accessing User Overview and device-specific drilldowns <a href="#deviceview-accessinguseroverviewanddevice-specificdrilldowns" id="deviceview-accessinguseroverviewanddevice-specificdrilldowns"></a>

From the Device View page:

1. Choose one of the following options from the action menu next to the device name in the top-left corner to:
   * **Open device benchmark** dashboard.
   * **Diagnose** using diagnostics dashboards.
   * **Retrieve all** pre-filled investigation queries in a device context.
2. Choose the **Open user overview** option from the action menu next to the user name in the top-right corner, to access the **User Overview** dashboard.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-4aab2ecc0262ff644c12e195565986fa9c8059dc%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Copy** the device or user information if needed.
{% endhint %}

### Using the Device View right-side panel <a href="#deviceview-usingthedeviceviewright-sidepanelright-sidepanel" id="deviceview-usingthedeviceviewright-sidepanelright-sidepanel"></a>

Depending on the Device View tab you open, the right-side panel displays different content:

* When you open the **Timeline** tab, click the device icon on the right-side panel to view details of selected timeline events.
* When you open the **Timeline**, **Executions**, **Checklists**, **Network** or **Packages** tab, click the **Actions** icon on the right-side panel to view a list of all remote actions and workflows available for your user role.
  * Hover over a remote action or workflow to reveal the action menu:
    * Select **View results** to navigate to the Investigations page with the remote action or workflow results.
    * Choose **Execute action** to run the remote action or workflow on the selected device.

{% hint style="info" %}
Refer to the [Using Device View for call quality issues](https://docs.nexthink.com/platform/user-guide/collaboration-experience/using-device-view-for-call-quality-issues) documentation to learn how to use the **Timeline** and **Checklists** tabs to troubleshoot collaboration tools.
{% endhint %}

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-0b9f4e2ef03ddf75ad7da2a2b6c7b96d0a1c9754%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

RELATED TOPICS:

* [Checklists](https://docs.nexthink.com/platform/user-guide/administration/content-management/checklists-management)
* [Investigations](https://docs.nexthink.com/platform/user-guide/investigations)
* [Network view](https://docs.nexthink.com/platform/user-guide/network-view)
* [Ratings](https://docs.nexthink.com/platform/user-guide/administration/content-management/ratings-management)
* [Timeline](https://docs.nexthink.com/platform/user-guide/device-view/timeline)
* [Using Device View for call quality issues](https://docs.nexthink.com/platform/user-guide/collaboration-experience/using-device-view-for-call-quality-issues)