Error¶

You can view frontend errors issued by the browser during user application usage, including error types and error content.

In the Error Explorer, you can:

• Centrally view all error types and their related error details.
• Restore obfuscated code through Sourcemap conversion, facilitating source code location during 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, error content, etc., during user access.

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

Pattern¶

If you need to view errors with high frequency, you can go to the Guance 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 period according to the selected time range in the upper right corner, retrieves 10,000 data points within that period for pattern analysis, aggregates error traces with high similarity, extracts and counts common pattern clusters, helping to quickly discover abnormal traces and locate problems.

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

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

Details Page¶

Click on the data detail page you need to view in the list. You can view error details of user access, including error details, extended fields, associated traces, etc.

Source¶

In Source, you can view the Session / View / Action details of the current Error, and filter/copy to view 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 time range selected in the Explorer to display the distribution trend of errors, helping you intuitively view time points or ranges where errors occur frequently 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 a production environment, to prevent code leakage and other security issues, files are typically transformed, compressed, etc., during the packaging process. While these measures ensure code security, they also result in collected error stack information being obfuscated, making it impossible to directly locate problems and complicating subsequent bug troubleshooting.

Guance provides a Sourcemap feature for applications, supporting the restoration of obfuscated code. This facilitates source code location during error troubleshooting and helps users resolve issues faster.

You can configure it via RUM Sourcemap Configuration or Datakit Collector Sourcemap Conversion. After configuration is complete, 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¶

Example of parsed code after configuring Sourcemap conversion in RUM:

Original Code Example¶

Example of parsed code after configuring Sourcemap conversion using the Datakit collector:

Note: If a user configures Sourcemap in both RUM and the Datakit collector, the parsing format configured in RUM will be displayed.

Extended Fields¶

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

After checking the field alias, you can view it after the field name; you can choose as needed.

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

Obsy AI AI Error Analysis¶

Guance provides the capability to parse error data with one click. It utilizes 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 data entry to expand the details page.
2. Click the "Obsy AI AI Error Analysis" button in the upper right corner.
3. Begin anomaly analysis.

Further Reading¶