UniApp Application Data Collection
Introduction
UniApp data collection depends on the Android iOS Native framework. To compare with Android iOS data collection, the following items marked with strikethrough are parts that have not been implemented.
Data Types
Guance user access monitoring includes six data types.
Type |
Description |
session |
User session information records. During the current session, data related to page views, resources, actions, errors, and long tasks will be recorded based on the session dimension. |
view |
A view record is generated each time a user visits a page in the mobile application. When a user stays on the same page, resource, long task, error, and action records will be linked to the relevant RUM view via the view_id attribute. |
resource |
Records of resources loaded when the user visits a page. |
error |
Exceptions or crashes emitted by the mobile application. |
long_task |
An event is generated for any task in the application that blocks the main thread for longer than a specified duration threshold. |
action |
Records user activities in the mobile application (application launch, clicks, swipes, back, etc.). Each action is attached with a unique action_id . |
Global Attributes
Scenarios for user access monitoring and event alerts can be queried using the following global attributes.
SDK Attributes
Field |
Type |
Description |
sdk_name |
string |
Collector name, fixed names:
df_macos_rum_sdk
df_linux_rum_sdk
df_windows_rum_sdk
df_web_rum_sdk
df_miniapp_rum_sdk
df_ios_rum_sdk
df_android_rum_sdk |
sdk_version |
string |
Collector version information |
Application Attributes
Field |
Type |
Description |
app_id |
string |
Required, unique ID identifier for user access applications. Automatically generated when creating monitoring in the Guance console. |
env |
string |
Required, environment field. Possible values: prod/gray/pre/common/local. Where: prod: production environment gray: gray release environment pre: pre-release environment common: daily environment local: local environment |
version |
string |
Required, version number. |
service |
string |
Optional, name of the associated business or service. Fixed names:
df_rum_ios
df_rum_android
df_rum_windows
df_rum_linux |
User & Session Attributes
Field |
Type |
Description |
userid |
string |
For unlogged users, use a random UUID as userid ; for logged-in users, use the user ID generated by the application backend. |
user_name |
string |
Optional, user name. |
user_email |
string |
Optional, user email. |
session_id |
string |
Session ID; if no operation for more than 15 minutes, a new session_id will be generated. |
session_type |
string |
Session type. Reference values: user & synthetics user: Data generated by RUM functionality; synthetics: Data generated by headless Synthetic Tests. |
is_signin |
boolean |
Whether the user is registered, possible values: T & F. |
Device & Resolution Attributes
Field |
Type |
Description |
device |
string |
Mobile device manufacturer |
model |
string |
Mobile device model |
device_uuid |
string |
Unique ID of the mobile device, generated using Android:ANDROID_ID and iOS:UIDevice.identifierForVendor |
os |
string |
Operating system information |
os_version |
string |
Operating system version |
os_version_major |
string |
Major version of the operating system |
screen_size |
string |
Screen resolution |
Geographic & Network Attributes
Field |
Type |
Description |
ip |
string |
User IP address |
isp |
string |
ISP provider |
network_type |
string |
Network connection type, reference values: |
wifi | 2g | 3g | 4g | 5g | unknown (unknown network) | unreachable (network unavailable) |
|
|
country |
string |
Country |
country_iso_code |
string |
Country ISO code |
province |
string |
Province |
city |
string |
City |
Custom Attributes
In addition to global attributes, custom attributes (SDK supports user-defined tag data) can be used to build scenarios and configure event alerts. Custom attributes are non-global attributes. By using custom attributes, you can track the entire process of user access to the application, locate and identify affected user visits, and monitor user access performance.
Other Data Type Attributes
Session
Properties
Field |
Type |
Description |
session_id |
string |
Session ID |
session_type |
string |
Session type. Reference values: user & test user: Data generated by RUM functionality; test: Data generated by headless Synthetic Tests. |
session_referrer |
string |
Session source, generally recording the URL of the source page. |
session_first_view_id |
string |
view_id of the first page in the current session |
session_first_view_name |
string |
URL of the first page in the current session |
session_last_view_id |
string |
view_id of the last visited page in the current session |
session_last_view_name |
string |
URL of the last page in the current session |
Metrics
Field |
Type |
Description |
time_spent |
number(ns) |
Duration of the current session |
session_view_count |
number |
Number of associated view_id s in the current session |
session_error_count |
number |
Number of errors generated in the current session |
session_resource_count |
number |
Number of resources loaded in the current session |
session_action_count |
number |
Number of user actions in the current session |
session_long_task_count |
number |
Number of long tasks generated in the current session |
View
Properties
Field |
Type |
Description |
view_id |
string |
Unique ID generated each time a page is visited |
view_referrer |
string |
Source page, parent page |
view_name |
string |
Page name |
Metrics
Field |
Type |
Description |
loading_time |
number(ns) |
Loading time of the page |
time_spent |
number(ns) |
Time spent on the page |
is_active |
boolean |
Indicates whether the user is still active, reference values: true & false |
Statistics
Field |
Type |
Description |
view_error_count |
number |
Number of errors that occurred during each page load |
view_resource_count |
number |
Number of resources requested during each page load |
view_long_task_count |
number |
Number of long tasks generated during each page load |
view_action_count |
number |
Number of operations performed during the page view |
Monitoring Metrics
Field |
Type |
Description |
cpu_tick_count |
number |
Optional, CPU tick count for the page |
cpu_tick_count_per_second |
number |
Optional, average CPU ticks per second |
fps_avg |
number |
Optional, average frames per second |
fps_mini |
number |
Optional, minimum frames per second |
memory_avg |
number |
Optional, average memory usage |
memory_max |
number |
Optional, peak memory usage |
Resource
View Properties
Field |
Type |
Description |
view_id |
string |
Unique ID generated each time a page is visited |
view_referrer |
string |
Source page, parent page |
view_name |
string |
Page name |
Action Properties
Field |
Type |
Description |
action_id |
string |
Unique ID generated when a user performs an action on a page |
action_name |
string |
Action name |
action_type |
string |
Action type (cold/hot start, click, etc.) |
Resource Properties
Field |
Type |
Description |
resource_url |
string |
Resource URL |
resource_url_host |
string |
Domain part of the resource URL |
resource_url_path |
string |
Path part of the resource URL |
resource_url_query |
string |
Query part of the resource URL |
resource_url_path_group |
string |
Grouped path part of the resource URL |
resource_type |
string |
Category of the resource |
resource_method |
string |
Resource request method |
resource_status |
string |
Status code returned by the resource request |
resource_status_group |
string |
Grouped status code returned by the resource request |
Metrics
Field |
Type |
Description |
resource_size |
number |
Size of the resource, default unit: byte |
resource_dns |
number(ns) |
DNS lookup time for resource loading Calculated as: domainLookupEnd - domainLookupStart |
resource_tcp |
number(ns) |
TCP connection time for resource loading Calculated as: connectEnd - connectStart |
resource_ssl |
number(ns) |
SSL connection time for resource loading Calculated as: connectEnd - secureConnectStart |
resource_ttfb |
number(ns) |
Time to first byte for resource loading Calculated as: responseStart - requestStart |
resource_trans |
number(ns) |
Content transfer time for resource loading Calculated as: responseEnd - responseStart |
resource_first_byte |
number(ns) |
First byte time for resource loading Calculated as: responseStart - domainLookupStart |
duration |
number(ns) |
Total loading time for resource Calculated as: duration(responseEnd-startTime) |
request_header |
string |
Request headers for the resource |
response_header |
string |
Response headers for the resource |
Error
View Properties
Field |
Type |
Description |
view_id |
string |
Unique ID generated each time a page is visited |
view_referrer |
string |
Source page, parent page |
view_name |
string |
Page name |
Action Properties
Field |
Type |
Description |
action_id |
string |
Unique ID generated when a user performs an action on a page |
action_name |
string |
Action name |
action_type |
string |
Action type (cold/hot start, click, etc.) |
Error Properties
Field |
Type |
Description |
error_source |
string |
Error source, reference values: logger | network |
error_type |
string |
Error type logger error type: java_crash | ios_crash network error type: network_error |
error_situation |
string |
Timing of the error occurrence, reference values: startup (at startup) and run (during runtime) |
When type=network, additional Network Error properties are added.
Field |
Type |
Description |
resource_status |
string |
Status code returned by the resource request |
resource_url |
string |
Resource URL |
resource_url_host |
string |
Domain part of the resource URL |
resource_url_path |
string |
Path part of the resource URL |
resource_url_path_group |
string |
Grouped path part of the resource URL |
resource_method |
string |
Resource request method |
Error Monitoring Properties
Field |
Type |
Description |
memory_total |
string |
Optional, total memory |
memory_use |
number |
Optional, memory usage rate |
cpu_use |
number |
Optional, CPU usage rate |
battery_use |
number |
Optional, current battery level |
locale |
string |
Current system language |
Metrics
Field |
Type |
Description |
error_message |
string |
Error message |
error_stack |
string |
Error stack trace |
Long Task
View Properties
Field |
Type |
Description |
view_id |
string |
Unique ID generated each time a page is visited |
view_referrer |
string |
Source page, parent page |
view_name |
string |
Page name |
Action Properties
Field |
Type |
Description |
action_id |
string |
Unique ID generated when a user performs an action on a page |
action_name |
string |
Action name |
action_type |
string |
Action type (cold/hot start, click, etc.) |
Metrics
Field |
Type |
Description |
duration |
number(ns) |
Duration of the long task |
long_task_message |
string |
Long task message |
long_task_stack |
string |
Long task stack trace |
Action
View Properties
Field |
Type |
Description |
view_id |
string |
Unique ID generated each time a page is visited |
view_referrer |
string |
Source page, parent page |
view_name |
string |
Page name |
Action Properties
Field |
Type |
Description |
action_id |
string |
Unique ID generated when a user performs an action on a page |
action_name |
string |
Action name |
action_type |
string |
Action type (cold/hot start, click, etc.) |
Metrics
Field |
Type |
Description |
duration |
number(ns) |
Time taken for the page action |
Statistics
Field |
Type |
Description |
action_long_task_count |
number |
Number of long tasks associated with the action |
action_resource_count |
number |
Number of resource requests associated with the action |
action_error_count |
number |
Number of errors associated with the action |