Skip to main content

View User Activity Records

This article explains how to enable and view user activity records for Guandata Dashboard Insights.

Feature Overview

After the feature is enabled, the system automatically collects and stores key user actions performed in Dashboard Insights and Card Insights, such as generating insights and initiating follow-up questions. The data is synchronized to a built-in dataset, and you can also view a processed dataset that is easier to read.

Enable the Feature

Go to System Operations Page > Advanced Settings > Global Settings and enable the Front-End Tracking Data Reporting switch.

For how to access the operations page, see Introduction to the System Operations Page.

Reported Data

After the feature is enabled, front-end data is automatically reported whenever users interact with the feature. All reported data is ultimately stored in the user_use_information_record dataset.

Below is an example of data automatically reported when a user performs actions in Dashboard Insights or Card Insights, such as generating insights or asking follow-up questions:

{
"deviceId": "xxx",
"product": "guandata-web",
"dataType": "BURIED_POINT_DATA",
"time": "2025-09-26 14:11:11",
"data": [
{
"type": "custom",
"data": {
"type": "dashboardInsight", // Operation type: dashboard or card insight
"pgId": "Page ID", // Related dashboard ID
"operation": "generate", // User action: generate, refresh, and so on
"llm": "deepseek-V3" // Invoked LLM
}
}
]
}

View the Data

View the Raw Dataset (user_use_information_record)

The automatically created user_use_information_record dataset contains the full raw reporting payload.

Field Descriptions for user_use_information_record

Using Dashboard Insights events as an example:

No.Field NameDescriptionSample / Enum Values
1User IDUnique identifier of the operating user-
2DomainEnvironment domain to which the data belongsdemo
3Device IDUnique identifier of the device-
4ProductProduct name that generated the dataguandata-web
5Data TypeType identifier of the payload; here it is tracking dataBURIED_POINT_DATA
6Uploaded DataContains operation type and key action details, including insight type, action, and LLM. See Uploaded Data Field Description{"type":"custom",
"data":
{"type":"dashboardInsight","pgId":"sfc62866c6bd741fbb8928d9",
"operation":"generate",
"llm":"Deepseek-V3"}}
7API Request TimeTime when the interface request was made-
8Front-End Report TimeTime when the front-end reported the data-
9Trace IDUnique identifier used for tracing the request chain-
10Reporter ProgramProgram identifier or name of the reporting process-
11Client OSOperating system used by the clientMac OS X
12Client BrowserBrowser used by the clientChrome
13Client IPIP address of the client192.168.xxx.xxx, 10.xxx.xxx.0

Uploaded Data Field Description

For Dashboard Insights-related operations, the value of Uploaded Data is a JSON string with the following structure:

Field NameDescriptionPossible Values
typeOperation type. All reporting records for Dashboard Insights and Card Insights use customcustom
data.typeDashboard insight or card insightdashboardInsight / cardInsight
data.pgIdDashboard page ID. Present for both Dashboard Insights and Card Insightssfc62866c6bd741fbb8928d9
data.cdIdInsight card ID. Present only when Card Insights is triggeredc5a2a5f879ad24f74b832293
data.operationUser action that triggered the LLM call. See data.operation Field Descriptiongenerate / refresh-data / ...
data.llmName of the currently invoked LLM when multiple models are available in the environmentdeepseek-v3 and so on

data.operation Field Description

Scenario data.type data.operation
Dashboard Insights Automatic generation when opening the sidebar dashboardInsight generate
Click the `Regenerate` button refresh-data
Ask a follow-up question after an insight is generated follow-up
Launch an insight from `Custom Insight Logic` custom-analysis
Click `Preview` while editing Dashboard Insights configuration preview-analysis
Card Insights Card automatically generates insights when the page is opened cardInsight generate
Click the `Re-Insight` button on the card toolbar refresh-data
Regeneration triggered by editing, including
(1) `Preview` after modifying the insight scope or prompt
(2) automatic regeneration after clicking confirm or cancel
modify-content
Automatic re-insight when data in the selected insight scope changes, including
(1) card data updates caused by filters or linked interactions
(2) drill actions on cards
(3) card deletion
refresh-on-source-update

View the ETL-Processed Readable Dataset

The raw dataset is relatively complex, so we provide a preset ETL job that automatically joins and processes the raw data into a more user-friendly and analysis-ready dataset.

ETL download link:Guandata Dashboard Insights Usage Processing ETL

Advantages of the processed dataset:

  • Information is more intuitive: it automatically joins user name, email, page name, and card name.
  • The scenario is clearer: it adds the Insight Operation Scenario field to describe actions in plain language, such as Card automatically generates insights when the page is opened.
  • The data is more focused: it keeps only records related to Guandata Dashboard Insights and filters out basic actions such as page switching.

Create the ETL

  1. On the Data Preparation > Smart ETL page, click Create ETL.

  2. Click Import in the upper-right corner, upload Guandata Dashboard Insights Usage Processing ETL, click Next, and then click Confirm on the next page without making any further changes.


Replace the Input Datasets

After the ETL is imported, you will notice that many datasets show an exclamation mark below them, indicating that the input datasets need to be replaced.

Using user_use_information_record as an example, select user_use_information_record, click Please Select under Select Dataset on the left, search for the user_use_information_record dataset, select it, and then click Confirm.

Note

Use the same procedure to replace the remaining datasets.

|350

Set the Output Dataset Save Path

Select Guandata Dashboard Insights Usage Record Dataset, click Please Select under Save To on the left, choose the save path, and then click Confirm.

Preview and Review the Processed Data

Select Guandata Dashboard Insights Usage Record Dataset. When the Preview icon appears at the bottom, click it to view the processed data.

After ETL processing, the generated dataset contains only usage records reported for Guandata Dashboard Insights and provides more explicit descriptions for several enum values.

The following new fields are added:

Field NameDescriptionExample Value
User NameJoined from the user ID and built-in datasetZhang San
emailUser email addresszhangsan@guandata.com
Uploaded Data TypeThe type value inside Uploaded Datacustom
Uploaded Operation TypeThe data.type value inside Uploaded DataCard Insight / Dashboard Insight
Page NameJoined from the page ID and built-in dataset. It may be null if the draft page has not been published or the page has been deletedStore Manager Dashboard
Card NameJoined from the card ID and built-in dataset. It may be null if the draft page has not been published or the card has been deleted. This field exists only for Card Insights and is null for Dashboard InsightsInsight Card
Insight Operation TypeThe data.operation value inside Uploaded Datarefresh-data
Insight Operation ScenarioDetailed description of data.operationCard automatically generates insights when the page is opened