> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view.md).

# 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.

## Required permissions for Device view <a href="#deviceview-requiredpermissionsfordeviceview" id="deviceview-requiredpermissionsfordeviceview"></a>

From the Nexthink web interface, go to **Administration >** [Roles](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/administration/account-management/roles.md) in the main menu to configure the role permission settings required by Device View:

1. Tick 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.&#x20;
     * **Manage all checklists** to view all checklists or map specific checklists to the user role.&#x20;
     * **View Diagnostics dashboards**
2. If needed, tick 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.&#x20;
3. If needed, tick the following permission under the **Investigations** drop-down:
   * **Create investigations**
4. If needed, tick the following permission under the **Applications** drop-down:
   * **View all application dashboards** to allow users to access the Applications dashboards.
5. If needed, tick the following permission under the **Collaboration Tools** drop-down (Collaboration Experience license from Nexthink):
   * **View all collaboration tools dashboards** to allow the users to access the Collaboration Tools dashboards.

### View domain <a href="#amplify-dataprivacysettingsforamplify" id="amplify-dataprivacysettingsforamplify"></a>

The table below showcases 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%2Fxe9qrauGrjOJZofKmIuR%2Fimage.png?alt=media&amp;token=9d5e2cb5-213d-4ef7-a437-026ef7ef7bfc" alt="" data-size="original"> | <img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fxe9qrauGrjOJZofKmIuR%2Fimage.png?alt=media&amp;token=9d5e2cb5-213d-4ef7-a437-026ef7ef7bfc" alt="" data-size="original"> |

## Accessing Device view <a href="#deviceview-accessingdeviceview" id="deviceview-accessingdeviceview"></a>

Access Device View depending on your preferences and requirements:

* Access through Search
* Access through Investigations

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

1. Select the [Search](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/search-and-nexthink-assist.md) 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](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/nexthink-query-language-nql.md) documentation for more information about how to write queries.
{% endhint %}

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

Find on the Device View page:

* The **Timeline** tab allows you to explore events in chronological order on the device, with the ability to gain further insights using intuitive tooltips and a right-side panel. Additionally, you can drill down the timeline sections into specific events to gain a detailed view of various activities.
  * Refer to the [Timeline](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view/timeline.md) documentation to learn how to use and interpret the timeline.
* The **Checklists** tab provides you with immediate insights into key device attributes.
  * Refer to the [Checklists](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view/checklists.md) documentation to learn how to use, format and interpret default and custom checklists.
* 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](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/network-view.md) documentation to learn how to use and interpret the network view visualization.

In addition, the Device View allows you to:

* Use the Device View [right-side panel](#deviceview-usingthedeviceviewright-sidepanelright-sidepanel) for insightful information and drill-downs, including a remote action list to execute associated actions on a device.
* Access the **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.
  * Refer to the [User Overview](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view/user-overview.md) documentation for more information

{% hint style="info" %}
The thresholds for the metrics under **Device Performance** within the **Timeline** tab align with the [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.&#x20;
{% endhint %}

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

To access device-specific benchmarks, investigations and dashboards, from the Device View page:

1. Choose one of the options from the action menu next to the device name in the top-left corner to access:
   * **Open device benchmark** dashboard.
   * **Diagnose** for diagnostics dashboards.
   * **Retrieve all** pre-filled investigation queries in a device context.

To access the [User Overview](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view/user-overview.md) dashboard, from the Device View page:

2. Click **Open user overview** from the action menu next to the user name in the top-right corner.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-3d69c026a225f0a45300a1fe5c888c5f7b4c317d%2Fdev-1713780037.png?alt=media" alt="DEV-1713780037.png" width="760"><figcaption></figcaption></figure>

{% hint style="info" %}
You can **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](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view/timeline.md) tab, click the device icon on the right-side panel to view details of selected timeline events.&#x20;
* When you open the **Timeline**, [Checklists](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view/checklists.md), or [Network](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/network-view.md) tab, click the **Actions** icon on the right-side panel to view a list of all [remote actions](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/remote-actions.md) and [workflows](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/workflows.md) available for your user [role](/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/administration/account-management/roles.md).
  * 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.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FYwREzdKny4sAys3y9Dvm%2FDeviceView-17199308334567.png?alt=media&amp;token=932b0a82-e8e2-4430-8255-1f17fe7ed6ac" alt="Device View right-side panel: Actions."><figcaption></figcaption></figure>

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

***

RELATED TOPICS:

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/device-view.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.