The platform supports application-level settings for user-defined data. When reporting metrics or issues, obtain the custom data configured at the application level to facilitate custom analysis. Currently, two types of custom data are supported: custom fields and custom dimensions.
Custom fields
Custom fields are custom data with freely definable keys. Keys and values are both of the String type, and the specific values are freely defined by the application. Currently, only issues support configuring custom fields, while performance metrics are not currently supported.
View custom fields
Users can view the custom fields of the current case in Issue Details > Message Details > on-site data.
Search Custom Fields
Users can also search for cases containing specified custom fields in the search criteria.
custom dimension
Custom dimensions are user-defined data with constrained keys. Keys are defined by the SDK, and applications can set values with different meanings based on actual needs. Values currently support three types: Number, String, and String Array, with each type supporting ten keys.
Values of the Number type correspond to dimension keys n1 - n10.
Values of the String type correspond to dimension keys s1 - s10.
Values of the String Array type correspond to dimension keys a1 - a10.
The purpose of introducing custom dimensions:
RUM Pro introduced custom dimensions after balancing search efficiency, analytical capabilities, storage costs, and computational costs. While the usage remains similar with a Key/Value configuration approach, custom dimensions employ SDK-predefined keys. Upon receiving data, backend processing parses and stores this information in a highly optimized format. Crucially, this storage optimization enables the platform to deliver robust custom analytical capabilities in future releases.
View custom dimension
Users can view the custom dimensions of the current case in Issue Details > Message Details > on-site data.
Set dimension alias
After updating dimension aliases, refresh the page in Issue Details > Message Details > on-site data to view the dimension aliases set for the corresponding custom dimensions.
Search by dimension alias
After setting dimension aliases, users can directly search for custom dimensions via these aliases.
Note:
The example shows that custom dimensions of the Number type offer enhanced search capabilities, currently supporting exact Match, equal to, greater than, greater than or equal to, less than, less than or equal to, and range-based searches.