Error¶

You can view frontend errors issued by the browser during user interaction with the application, including error types and error messages.

In the Error Explorer, you can:

• Centrally view all error types and their related error details.
• Restore obfuscated code through Sourcemap conversion, facilitating error troubleshooting and helping users resolve issues faster.

Explorer List¶

All Errors¶

In the Error Explorer, you can quickly view the page address, code error type, and error message during user access.

• Error message "Load failed": Errors without a response, with "Load failed" added by default SDK.
• Error message "Network request failed": Errors where the response returns an error.

Pattern Analysis¶

If you need to view frequently occurring errors, you can go to the TrueWatch workspace User Analysis > Explorer > Error and select the Pattern Analysis list.

Pattern Analysis performs similarity calculation analysis on all error trace data based on clustering fields. It fixes the current time range based on the selected time range in the upper right corner and retrieves 10,000 pieces of data within this range for pattern analysis. It aggregates error traces with high similarity, extracts and counts common pattern clusters, helping to quickly identify abnormal traces and locate issues.

By default, it aggregates based on the error_message field. You can customize input clustering fields, with a maximum of 3 fields.

• In the Pattern Analysis list, you can click on any error to view all associated Errors. Clicking on the trace will take you to the detail page for analysis.
• In the Pattern Analysis page, clicking the sort icons & allows you to sort the document count in ascending/descending order (default is descending).

Detail Page¶

Click on the data in the list to view the error details, including error details, extended fields, and associated traces.

Source¶

In the Source, you can view the Session / View / Action details of the current Error, filter/copy the current Session ID / View ID / Action ID.

Error Distribution Chart¶

The Error Distribution Chart aggregates and counts errors with high similarity. It automatically selects the corresponding time interval based on the selected time range in the explorer, helping you intuitively view the time points or ranges where errors frequently occur, and quickly locate error issues.

Error Details¶

In the error details, you can view the specific content of the error.

Sourcemap Conversion¶

When applications are released in production environments, files are usually transformed and compressed to prevent code leakage and other security issues. While these measures ensure code security, they also result in collected error stack information being obfuscated, making it difficult to directly locate issues and inconvenient for subsequent bug troubleshooting.

TrueWatch provides the Sourcemap feature for applications, supporting the restoration of obfuscated code, facilitating error troubleshooting and helping users resolve issues faster.

You can configure Sourcemap through RUM Sourcemap Configuration or Datakit Collector Sourcemap Conversion. After configuration, you can view the parsed code and the original code in the error details.

Note: Currently, only Web-type applications support Sourcemap configuration in RUM.

Parsed Code Example¶

Example of parsed code after configuring Sourcemap conversion in RUM:

Original Code Example¶

Example of parsed code after configuring Sourcemap conversion with Datakit Collector:

Note: If Sourcemap is configured in both RUM and Datakit Collector, the parsed format from RUM configuration will be displayed.

Extended Fields¶

In the search bar, you can input field names or values to quickly search and locate.

After checking the field alias, you can view it after the field name. You can select as needed.

In the trace detail page, you can view the related field attributes of the current trace in the Extended Fields:

TOBY AI Error Analysis¶

TrueWatch provides the ability to parse error data with one click. It uses large models to automatically extract key information from the data, combines online search engines and operation knowledge bases, quickly analyzes possible fault causes, and provides preliminary solutions.

1. Click on a single piece of data to expand the detail page.
2. Click the "TOBY AI Error Analysis" button in the upper right corner.
3. Start the anomaly analysis.

Issue Auto Discovery¶

Based on TrueWatch's monitoring of RUM Error data, when you enable the Issue Auto Discovery configuration, the system will statistically analyze abnormal data based on different grouping dimensions, track subsequent similar issues, automatically condense them, and finally generate Issues. Issues generated through this entry will help you obtain the context and root cause of the problem, significantly reducing the average time to resolve issues.

Data Source: The activation entry for the current configuration page.

Combination Dimensions: Statistical classification based on the combination of configured field contents, including app_name, env, version, error_type.

Based on combination dimensions, you can add filter conditions. TrueWatch will further query and classify data that meets the conditions.

Detection Frequency: TrueWatch will query the data time range based on the frequency you select, including 5 minutes, 10 minutes, 15 minutes, 30 minutes, and 1 hour.

Issue Definition: After enabling this configuration, Issues will be presented based on the definition here. To avoid missing information, fill in sequentially.

In the Title and Description of the Issue, the following template variables are supported:

View Issue¶

After saving the configuration and enabling it, Issues automatically discovered and generated by the system will be displayed in Console > Incident.

Further Reading¶