Creating a connection to DataLens Usage Analytics
Note
Only a user with the datalens.instances.admin or datalens.admin role can create and use a connection in an organization. The datalens.workbooks.editor workbook admin role is not enough to create a connection.
To allow other users to view a connection and query it, the connection administrator can configure object access permissions.
To create a connection to DataLens Usage Analytics:
-
Open the connection creation page.
-
Under Files and services, select the Usage Analytics connection:
-
Light: Provides aggregated statistics on the DataLens instance usage over a limited period of time (60 days).
-
Detailed: Provides both detailed and aggregated statistics for the DataLens instance over a long period of time (360 days). You can view detailed statistics on dataset queries and dashboard views.
-
Note
Updates as of December 1, 2025:
- Creating new Light connections will no longer be available. Existing connections will continue to work.
- Creating a Detailed connection will be available to all users.
We recommend using Detailed connections.
-
Leave the Automatically create dashboard, charts, and dataset on top of connection option enabled if you need a standard dataset:
For Light connection
- DataLens Usage Analytics Light: Dashboard with preset charts.
- Usage Analytics (light): Dataset with aggregate data on dataset queries.
For Detailed connection
- DataLens Usage Analytics Detailed: Dashboard with preset charts.
- Usage Analytics (light): Dataset with aggregate data on dataset queries.
- Usage Analytics (detailed): Dataset with a complete log of dataset queries.
- Usage Analytics (dashboard views): Dataset with data on the number of dashboard views.
-
Click Create connection.
-
Select the workbook to save your connection to or create a new one. If using legacy folder navigation, select a folder to save the connection to. Click Create.
-
Enter a name for the connection and click Create.
You can use a preset dashboard or create custom charts and dashboards based on specified datasets.