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