Error¶

View front-end errors generated by the browser during user application usage, including error types, error content, etc.

In the Error Explorer, you can:

• View all error types centrally and their related error details;

• Use Sourcemap conversion to restore obfuscated code, making it easier to locate source code during error troubleshooting and helping users solve problems faster.

Explorer List¶

All Errors¶

In the Error Explorer, you can quickly view the page URL, code error type, error content, etc., when the user accessed.

• Error content "Load failed": errors without a response, defaults to "Load failed" in the SDK;

• Error content "Network request failed": errors where the response returns an error.

Pattern¶

If you need to view errors with high frequency, go to TrueWatch workspace > RUM > Explorer > Error and select the Pattern list.

Pattern performs similarity calculation and analysis on all error trace data based on clustering fields. It fixes the current time range according to the time range selected in the upper right corner, retrieves 10,000 data entries within that time range for clustering analysis, aggregates error traces with high similarity, extracts and counts common Pattern clusters, helping you quickly discover abnormal traces and locate problems.

By default, aggregation is based on the error_message field. You can customize the clustering fields, with a maximum of 3 fields.

• In the Pattern list, you can click any error to view all associated Errors. Click the trace to enter the detail page for analysis;

• On the Pattern page, click the sort icon & to sort the document count in ascending/descending order (default descending).

Detail Page¶

Click the data detail page you want to view in the list to see the error details, including error details, extended fields, associated traces, etc.

Source¶

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

Error Distribution Chart¶

The Error Distribution Chart aggregates errors with high similarity, automatically selects the appropriate time interval based on the time range selected in the Explorer, and displays the error distribution trend, helping you intuitively see the time points or time ranges where errors occur frequently and quickly locate error problems.

Error Details¶

In Error Details, you can view the specific content of the error.

Sourcemap Conversion¶

When applications are released in a production environment, to prevent code leakage and other security issues, files are usually converted, compressed, etc. during the packaging process. While these measures ensure code security, they also cause the collected error stack information to be obfuscated, making it impossible to directly locate the problem, which brings inconvenience to subsequent bug troubleshooting.

TrueWatch provides Sourcemap functionality for applications, supporting the restoration of obfuscated code, making it easier to locate source code during error troubleshooting and helping users solve problems faster.

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

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

Parsed Code Example¶

Configure Sourcemap conversion in RUM, parsed code example:

Original Code Example¶

Configure Sourcemap conversion using the Datakit Collector, parsed code example:

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

Extended Fields¶

In the search bar, you can enter a field name or value to quickly search and locate;

After selecting a field alias, it can be viewed after the field name; you can choose as needed.

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

Toby AI TruePilot Error Analysis¶

TrueWatch provides the ability to parse error data in one click. It uses a large model to automatically extract key information from the data, combined with online search engines and operations knowledge bases, to quickly analyze possible fault causes and provide initial solutions.

1. Click a single data entry to expand the detail page;
2. Click "Error Analysis" by Toby AI TruePilot in the upper right corner;
3. Start anomaly analysis.

More Reading¶