> 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/library-packs/nexthink-management/platform-usage-telemetry/configuration-guide-platform-usage-telemetry.md).

# Configuration guide: Platform usage telemetry

{% hint style="warning" %}
The configuration options on this page are only accessible to [administrators](/platform/user-guide/administration/account-management/roles.md#roles-administration).

Refer to the [Usage guide: Nexthink Infinity usage](/platform/library-packs/nexthink-management/platform-usage-telemetry/usage-guide-platform-usage-telemetry.md) to use library content as a standard user.
{% endhint %}

## Prerequisites

This library pack contains content from the following required [expansion products](/platform/overview/products.md):

* [Employee Engagement - Campaigns](/platform/user-guide/campaigns.md)

{% hint style="info" %}
Some of these products offer default access to their respective content and can still be used without [expansion products](https://docs.nexthink.com/platform/overview/products).

To learn more about default thresholds for expansion products, [visit the extended documentation](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-infinity-default-thresholds-overview).
{% endhint %}

## Included content and dependencies

This library pack contains the following content and dependencies:

| Content type    | Name                         | Description                                                               | Dependencies                                     |
| --------------- | ---------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------ |
| Live dashboards | **Platform usage telemetry** | Tracks ongoing usage of dashboards. Highlights team access and frequency. | None                                             |
| Roles           | **Nexthink Usage**           | Enables using NQL to view tracked usage of Nexthink tools.                | Required to access dashboards and investigations |

## Configuring "Platform usage telemetry"

{% hint style="info" %}
Adapt these suggested configuration steps to edit and customize content according to your organizational needs.
{% endhint %}

Follow these steps to install and configure content:

* Before configuration - Install library pack content from [Nexthink Library](https://docs.nexthink.com/platform/user-guide/nexthink-library)
* [Step 1 - Configuring user roles](#step-1-configuring-user-roles)
* [Step 2 - Adjusting time period](#step-2-adjusting-time-period)

### Step 1 - Configuring user roles

1. From the main menu, navigate to **Administration** > **Roles**.
2. Locate the role **Nexthink Usage**.
3. Assign the role to relevant users or groups.
4. Ensure users can access:
   * Investigations
   * Live dashboards

This role enables querying usage data through NQL.

### Step 2 - Adjusting time period

1. Open the **Platform usage telemetry** dashboard.
2. Locate the time selector in the top-right corner.
3. Choose a time range that fits your analysis needs:
   * Last 7 days for recent activity
   * Last 30 days for trends
   * Custom range for deeper analysis

Adjusting the time period helps you:

* Identify usage patterns
* Compare adoption across teams
* Track engagement over time

***

RELATED TOPICS

* [Overview page: Platform usage telemetry](/platform/library-packs/nexthink-management/platform-usage-telemetry.md)
* [Usage guide: Platform usage telemetry](/platform/library-packs/nexthink-management/platform-usage-telemetry/usage-guide-platform-usage-telemetry.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/library-packs/nexthink-management/platform-usage-telemetry/configuration-guide-platform-usage-telemetry.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.