> ## Documentation Index
> Fetch the complete documentation index at: https://help.cryptolens.io/llms.txt
> Use this file to discover all available pages before exploring further.

# KPI Dashboards (beta)

> Configure and use Devolens analytics dashboards for license activity and software usage.

<Note>
  **Note:** This article and some of the features it refers to are still in beta. If you find any discrepancies or need help, please reach out to us at [help@devolens.com](mailto:help@devolens.com).
</Note>

The KPI dashboards help you understand how licenses, machines, and users interact with your software. They are intended to replace the older Analytics dashboard at [analytics.cryptolens.io](https://analytics.cryptolens.io/).

Use these dashboards to review recent license activity, spot usage trends, identify heavily used licenses, and decide when to investigate a customer or product configuration.

## Available dashboards

| Dashboard                  | Link                                                                        | Use it for                                                                |
| -------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| Overview                   | [Open dashboard](https://app.cryptolens.io/report/overview)                 | A high-level view of product and license activity.                        |
| Daily report               | [Open dashboard](https://app.cryptolens.io/report/dailyreport)              | Day-by-day activity trends and operational reporting.                     |
| License activity           | [Open dashboard](https://app.cryptolens.io/report/licenseactivity)          | Activity for a specific license key or product.                           |
| License activity dashboard | [Open dashboard](https://app.cryptolens.io/report/licenseactivitydashboard) | Usage-oriented reporting, including how much customers use your software. |

## Before you start

The dashboards are based on activity recorded by Devolens, such as license verification and activation requests. If a dashboard has little or no data, check that your application is calling the Devolens Web API or SDK in production and that you are viewing the correct product and time period.

Data may not appear immediately after a request is made. If the numbers look unexpected, first check the selected product and time period, then confirm that test licenses are excluded. For operational investigations, compare the dashboard with the relevant license, product, or API logs before taking customer-facing action.

## Exclude test licenses

Test, demo, and internal licenses can distort analytics. You can exclude one or more license keys from KPI processing by adding a data object.

1. Visit [https://app.cryptolens.io/Data?refType=0](https://app.cryptolens.io/Data?refType=0).
2. Add a data object named `cryptolens_excludekeys_kpi`.
3. In the `StringValue` field, enter the key IDs to exclude, separated by commas.

For example:

```text theme={null}
12345,67890,13579
```

The key ID is not the same value as the visible license key string. To find it, open the product page, locate the license key, and click the green icon next to the license key to view stats for that key. The page URL will look similar to:

```text theme={null}
https://app.cryptolens.io/report/LicenseActivity?keyId=12345
```

In this example, the key ID is `12345`.

<Note>
  A better way to extract key IDs will be released later. Until then, use the license activity URL as the source of the key ID.
</Note>

## Access analytics through the API

You can access the data used by these dashboards through the [Web API](https://app.cryptolens.io/docs/api/v3/AI) in the Usage Analytics section, or through the [Python SDK](https://github.com/Cryptolens/cryptolens-python#usage-analytics).

This is useful when you want to build custom reports, automate internal reviews, or let an AI-assisted workflow query usage analytics as part of license support and customer-success tasks.

If you use an AI agent or MCP client such as Claude, ChatGPT, or Codex, you can also connect the [Devolens MCP server](/getting-started/mcp), which exposes the same usage analytics together with license and customer management tools. The connection can be restricted to analytics-only permissions.

## Roadmap

We are actively improving these dashboards based on customer feedback. Please email [help@devolens.com](mailto:help@devolens.com) if you notice unexpected results or need a metric that is not available yet.

* ~~Exclude test licenses~~ (implemented)
* Report average seats or machines used for a given license. In the meantime, you can review the [FloatingLicenseAudit script](https://github.com/Cryptolens/reporting-tools/tree/master/FloatingLicenseAudit).
* ~~Show units on hover~~
* Other minor fixes and usability improvements.