# 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="/files/jWnGafbQH88S6JICJzPn" 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](/platform/user-guide/administration/account-management/roles.md) 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="/files/O7MbYO9UbOf2mYc38KRk" alt="" data-size="original"> | <img src="/files/O7MbYO9UbOf2mYc38KRk" alt="" data-size="original"> |

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

1. Select the [Search](/platform/user-guide/search-and-workspace.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="/files/sRWxqlCLuvrPOX4rbjOo" 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="/files/gCORnYmkHVha1HYMRVPw" 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/understanding-key-data-platform-concepts/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>

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](/platform/user-guide/device-view/timeline.md) 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](/platform/user-guide/device-view/executions.md) 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](/platform/user-guide/network-view.md) 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](/platform/user-guide/device-view/packages.md) 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](/platform/user-guide/device-view/user-overview.md) 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="/files/kq1MAgnzeqvJxHo0JdDI" 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](/platform/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 %}

<figure><img src="/files/kiqpY5zdxrzAkru8Ue1f" alt=""><figcaption></figcaption></figure>

RELATED TOPICS:

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


---

# Agent Instructions: 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:

```
GET https://docs.nexthink.com/platform/user-guide/device-view.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.