# Using Live Dashboards

This page explains the key components of live dashboards, as well as their applications and uses.

{% hint style="info" %}
As a user, your ability to access or edit **shared** dashboards created by others depends on:

* Your user [role](https://docs.nexthink.com/platform/administration/account-management/roles#roles-livedashboards) permissions for Live Dashboards.
* Your **View** or **Edit** rights for the specific shared dashboard.

Refer to [Managing Live Dashboards](https://docs.nexthink.com/platform/user-guide/managing-live-dashboards#managinglivedashboards-sharingdashboardssharing) documentation to map user access and actions depending on the aforementioned combination of permissions.
{% endhint %}

## Setting up the timeframe and time granularity <a href="#usinglivedashboards-settingupthetimeframeandtimegranularity" id="usinglivedashboards-settingupthetimeframeandtimegranularity"></a>

Use the timeframe picker in the top-right corner of the Dashboards page to set up the timeframes that apply to all dashboard widgets (updating the corresponding NQL query).

Use one of the predefined timeframes, ranging from **Last hour** to **Last year,** or select a custom timeframe. For **Custom** timeframes, the maximum lookback and maximum selected duration is 395 days.

Depending on the selected timeframe, you can set time granularity to **By 15 min**, **By hour**, **By day**, **By week** or **By month** to identify patterns and troubleshoot issues. Changes in time granularity only update line charts.

{% hint style="info" %}
Refer to the [Timeframe picker](https://docs.nexthink.com/platform/user-guide/live-dashboards/widget-types/timeframe-picker) documentation for details on how the system implements the timeframe picker in the NQL queries for dashboards.
{% endhint %}

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

## Filtering dashboards <a href="#usinglivedashboards-filteringdashboards" id="usinglivedashboards-filteringdashboards"></a>

Filters appear at the top of the Dashboard page, allowing you to filter dashboards by platform, device, location, hardware and other configured parameters.

Refer to the [Managing Live Dashboards](https://docs.nexthink.com/platform/user-guide/live-dashboards/managing-live-dashboards) documentation to add, manage and customize filters.

{% hint style="info" %}
Refer to the [Filter widget](https://docs.nexthink.com/platform/user-guide/live-dashboards/widget-types/filter-widget) documentation to learn how the system implements filters in NQL queries for dashboards.
{% endhint %}

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

Click on the elements of the bar charts to apply filters to the page. This action defines the scope by filtering the targeted objects with a condition on a property.

## Using dashboard widgets <a href="#usinglivedashboards-usingdashboardwidgets" id="usinglivedashboards-usingdashboardwidgets"></a>

{% hint style="info" %}
Refer to the [Managing Live Dashboards](https://docs.nexthink.com/platform/user-guide/managing-live-dashboards#managinglivedashboards-editingdashboardcontenteditmode) documentation to add, manage and customize widgets—subject to user permissions.
{% endhint %}

Right-click on any item or value within a dashboard widget to access a set of options. The available options depend on both the widget type and the data type of the selected item.

* **View investigation** opens the Investigations page for the original NQL of the widget plus any applied filters to the Dashboard page, the time duration and granularity.
* **Drill down to …** opens the Investigation page with the results of the NQL query listing items from one of the following alternatives:

  * The root table of the original query, for example, `execution.crashes`.
  * The associated object tables, for example, `binaries` or `devices`.

  The NQL query from the drill-down retains the context of the original query.
* **Copy** copies the formatted value visible on the widget, including the units, for example `1m 26s`*,* `306 GB` or `32.5%`.
* **Copy raw value** copies the full underlying value, for example:
  * `1m 26s` is copied as `86.42345139288133` (total seconds)
  * `306GB` is copied as `328676378256` (bytes)
  * `32.5%` is copied as `0.325057090224` (decimal form)
* For inventory objects, such as users, devices and binaries:
  * **Open Device View**, **Open user overview**, depending on the case.
  * **Diagnose** issues using dashboards from the [Alerts and Diagnostics](https://docs.nexthink.com/platform/user-guide/alerts-and-diagnostics) module.
  * **Retrieve all** pre-filled investigation queries in a device or binary context.

{% hint style="info" %}
You can obtain [binary contextual descriptions](https://docs.nexthink.com/platform/user-guide/widget-types/table#table-tablespecificfields) directly by hovering binary names in the table-type widget.
{% endhint %}

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-4d42f4efbdef398923ab4bf2cc624d007ca33ec0%2FAction%20menus.jpg?alt=media" alt="Opening Device View from a dashboard widget value."><figcaption></figcaption></figure>

The examples below describe how the system updates the corresponding investigation queries with changes made from the Dashboards page.

<details>

<summary>Example of viewing an investigation from a dashboard</summary>

**View investigation** of a KPI dashboard widget showing the number of devices with crashes over the past 1 day.

The original NQL of the KPI is:

```
devices
| with execution.crashes during past 1d
| summarize devices = count()
```

Apply the following filters to the dashboard:

* **Last hour** from the timeframe picker.
* **Mac** from the OS filter.

The Investigations page shows results using a modified NQL query:

```
devices during past 60min 
| where device.operating_system.platform == macOS 
| with execution.crashes during past 60min 
| where device.operating_system.platform == macOS 
| summarize devices = count()
```

The modified query on the Investigations page includes:

* The filter modification `|where device.operating_system.platform == macOS`
* The timeframe picker modification `during past 60min`

</details>

<details>

<summary>Example of drilling down to an investigation from a dashboard</summary>

**Drill down…** on a KPI dashboard widget showing the number of devices with crashes over the past 1 day.

The original NQL of the KPI is:

```
devices
| with execution.crashes during past 1d
| summarize devices = count()
```

Apply the following filters to the dashboard:

* **Last hour** from the timeframe picker
* **Mac** from the OS filter

The Investigations page shows results using a modified NQL query:

```
devices during past 60min 
| where device.operating_system.platform == macOS 
| include execution.crashes during past 60min 
| where device.operating_system.platform == macOS 
| compute number_of_events_ = crash.number_of_crashes.sum() 
| where number_of_events_ != 0 
| list 
  device.name, 
  device.entity, 
  device.hardware.model, 
  device.hardware.type, 
  device.operating_system.name
```

The modified query on the Investigations page includes:

* The filter modification `where device.operating_system.platform == macOS`
* The timeframe picker modification `during past 60min`
* Transformation of the `summarize` line into the `list` line

The fields that the `list` line returns are:

* Default fields of the root table, for example, the table that you reference in the first line of the query
* If you do an aggregation on a particular field, it returns that specific field:\
  `summarize num_freezes = execution.event.number_of_freezes.sum()` is transformed to\
  `list [default fields], execution.event.number_of_freezes`

From the Investigation page, you can use the action bar on the Investigations page to perform additional operations and drill-downs.

Refer to the *Investigate option in the action bar* section in the investigation [NQL editor](https://docs.nexthink.com/platform/user-guide/investigations/creating-investigations/nql-editor) documentation for more information about investigation drill-downs.

</details>

## Editing and exporting a dashboard <a href="#usinglivedashboards-editingandexportingadashboard" id="usinglivedashboards-editingandexportingadashboard"></a>

Click on the action menu in the top-right corner of the Dashboards page to **Edit** and **Export** live dashboards.

You may **Duplicate** or **Delete** a dashboard using the same action menu from the Dashboard page.

{% hint style="info" %}
Refer to the [Managing Live Dashboards](https://docs.nexthink.com/platform/user-guide/live-dashboards/managing-live-dashboards) documentation to learn how to create, manage and customize dashboards—subject to user permissions.
{% endhint %}

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

## Sharing a dashboard URL <a href="#usinglivedashboards-sharingadashboardurl" id="usinglivedashboards-sharingadashboardurl"></a>

You can copy the URL of your dashboard and share it with other users. However, recipients must have Live Dashboards access to successfully open the URL.

A dashboard URL contains:

* Selected timeframe
* Selected filters and their values
* Currently selected tab

The recipients load the dashboard in the same state as you intended them to see it.

{% hint style="info" %}
Refer to [Managing Live Dashboards](https://docs.nexthink.com/platform/user-guide/managing-live-dashboards#managinglivedashboards-sharingdashboardssharing) documentation to learn more about sharing dashboards and granting permissions.
{% endhint %}

***

RELATED TOPICS

* [Managing Live Dashboards](https://docs.nexthink.com/platform/user-guide/live-dashboards/managing-live-dashboards)
* [Widget types](https://docs.nexthink.com/platform/user-guide/live-dashboards/widget-types)
* [Live Dashboards NQL examples](https://docs.nexthink.com/platform/user-guide/live-dashboards/live-dashboards-nql-examples)


---

# 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/live-dashboards/using-live-dashboards.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.