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

> Use Devolens dashboards to inspect license activity, floating capacity, and inactive licenses.

<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 show recorded license activity and software usage. They are intended to replace the older Analytics dashboard at [analytics.cryptolens.io](https://analytics.cryptolens.io/).

Use them to investigate license activity, compare floating usage with configured limits, and find inactive licenses.

## 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)  | Inspect activity and estimate usage of your software.                             |
| Floating capacity          | [Open dashboard](https://app.cryptolens.io/report/floatingcapacitydashboard) | Identify licenses that regularly exceed seat allowance or don't use enough seats. |
| License inactivity         | [Open dashboard](https://app.cryptolens.io/report/licenseinactivity)         | Identify licenses that were never activated or are no longer being used.          |

## 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 the average number of seats or machines used for a given license. The Floating Capacity dashboard now provides 30-minute machine-count history; for custom reporting, you can also review the [FloatingLicenseAudit script](https://github.com/Cryptolens/reporting-tools/tree/master/FloatingLicenseAudit).~~
* ~~Show units on hover~~
* Identify licenses that are about to expire
* Other minor fixes and usability improvements.
