Skip to main content
After errors are reported, you can view Issues in the Error Tracking module. In RUM, an Issue is a group of similar errors, typically related to the same bug.
Issue List
For detailed grouping rules, please refer to Error Grouping.

​
Issue Information Overview

Issue Information Overview
Each entry listed in the Issue browser contains the following information:
ItemDescription
Error type and error messageCore identifying information of the Issue
File path where error occurredLocate error source
Service nameAssociated service
Error causeSystem-inferred possible root cause
Whether issue has regressedIndicates if a resolved issue has reappeared
First and last occurrence timeIssue lifecycle information
Occurrence count chartTrend over time
Occurrence count in selected time periodStatistical data

​
Issue Status

Issues have 4 statuses, with transitions as follows:
Issue Status Transitions
StatusDescription
For ReviewNewly discovered issues that need attention
ReviewedConfirmed issues being fixed
ResolvedIssues that have been fixed
IgnoredIssues that don’t need handling
For regression-related transition logic, please refer to Issue Status.

​
Filtering and Sorting

The timeline in the upper right corner of the browser allows you to display Issues that had errors during the selected time period. You can:
  • Select a preset range from the dropdown menu
  • Directly modify the time
  • Enter natural language for filtering

​
Error Cause Classification

Flashcat adds an error cause classification to each Issue when created, helping improve fault localization efficiency.
Error CauseDescription
Code ErrorErrors caused by code defects
Illegal Object AccessCode accessed a null or undefined object
Invalid ParameterFunction called with invalid parameters
Network ErrorServer response too slow or poor network speed
API Request FailedAPI endpoint returned an error status code
Unknown ErrorUnable to locate this error type
When hovering over an error cause classification, the system will use AI capabilities to provide inferred root causes and fix suggestions.

​
Classification Mechanism

The system uses a two-layer analysis mechanism to classify errors: Layer 1: Pattern Matching The rule engine checks error types and messages in priority order; the first matching rule determines the classification:
Check OrderMatch ConditionClassification
1Error message contains “Unexpected token … is not valid JSON”Invalid Parameter
2Associated resource HTTP status code is 4xx or 5xxAPI Request Failed
3Error type contains “Network” or “AbortError”Network Error
4Error type contains “Syntax”, “Reference”, “Range”, “URI”, or “Eval”Code Error
5Error type is TypeError and message matches null access patterns (e.g., “Cannot read property of undefined”)Illegal Object Access
6Error message matches invalid argument patterns (e.g., “invalid argument”, “unexpected token”)Invalid Parameter
7Error message contains “API ERROR:” or license-related errorsAPI Request Failed
8Error message contains network connection keywords (e.g., “timeout”, “connection”, “dns”)Network Error
9None of the above matchedUnknown Error
Layer 2: AI Inference When pattern matching results in “Unknown Error”, the system invokes an AI model for deeper analysis. The AI model evaluates the following information:
  • Error Message: The error description text
  • Stack Trace: The complete call stack
  • Platform Type: Browser/JavaScript, Android/Kotlin/Java, iOS/Swift/Objective-C, Flutter/Dart, React Native, Unity/C#, etc.
The AI outputs an error classification and a brief cause explanation (up to 100 words). Inference results are displayed as hover tooltips on the Issue card, helping you quickly understand the root cause of the error.

​
Regression

Regression refers to previously fixed bugs reappearing.
Regression
If an error is marked as resolved but the same error occurs later (with a different version), the Issue status will be reopened from the closed state and marked as “Regression”.

​
Issue Details

The Issue list supports two viewing modes: sidebar mode and fullscreen mode. By default, the details panel opens as a sidebar. You can click the expand button to switch to fullscreen mode for a more spacious view and more complete data display. Click any Issue to open the details panel and view more information.
Issue Details
The top of the panel displays basic Issue information, such as status and error cause. You can also understand the Issue lifecycle: first and last occurrence dates, duration, and error occurrence count over time (aggregated by time granularity).
In the label distribution section, you can view the proportion of different labels under this Issue across various dimensions, quickly determining the impact scope and helping locate root causes.Currently supports labels like view_name, browser_name, version, env, etc.
By default, displays the most recent error information reported during the Issue’s occurrence as an error sample. You can also switch through the navigation bar.
View Web error context and stack information. If SourceMaps have been uploaded, you can see the mapped original source code locations and code snippets.
Error Stack
You can view uploaded source code information in “Application Management” - “Source Code Management”. See Source Mapping for details.
The error stack display for native platforms (Android/iOS) is specifically designed for mobile characteristics, providing the following capabilities:Pretty / Raw Mode Toggle
  • Pretty Mode: Displays structured stack information, automatically distinguishing between app frames and third-party frames. Third-party frames are collapsed by default, highlighting your own code
  • Raw Mode: Displays raw stack text for easy copying and analysis in external tools
Symbolication StatusIf the corresponding version’s symbol files (Android mapping or iOS dSYM) have been uploaded, obfuscated addresses in the stack are automatically restored to readable function names, file names, and line numbers. When not symbolicated, the system prompts you to upload symbol files with direct links to “Source Code Management” and the upload tool.Thread Stacks (Threads)Native crashes typically involve multiple threads. The thread panel displays stack information for all threads at the time of the crash, supporting:
  • Viewing total thread count and currently displayed threads
  • Expanding/collapsing all threads
  • Independent separation of app frames and third-party frames within each thread, with third-party frames expandable on demand
  • The crashing thread’s stack is displayed first
Binary Images (iOS)For iOS crashes, you can also view the list of Binary Images loaded at the time of the crash, including image names, address ranges, and UUIDs, for offline symbolication analysis.For detailed symbol file upload procedures, see Source Mapping.
View the total number of Session events for the current error sample, as well as user resource access and operations before and after the error occurred.
Currently displays up to 20 context items including the current Error event. You can view more log information in the Session Viewer module later.
If the session has replay data collected, you can click the “View Replay” button to jump directly to the session replay page, recreating the complete user operation path when the error occurred from the user’s perspective.
Error events carry a series of attributes when reported. You can view current Session, view, user, and other information in the attributes section to help troubleshoot issues.

​
Issue Alerts

Discover problems immediately when they occur, giving you the opportunity to proactively identify and fix them before they become severe.
Alert Configuration
1

Enter Application Management

Select an application card and edit it
2

Enable Alerts

Turn on the “Alerts” switch
3

Select Channel

Select the notification channel
For detailed alert configuration instructions, please refer to Issue Alerts.

​
Best Practices

Configure Source Mapping

Facilitates problem localization in production environments

Add User Information

Configure user-related information to provide better error context

Set Alert Policies

Configure appropriate channels and escalation rules for errors

Regular Error Analysis

Regularly check error reports to discover potential issues

Team Collaboration

Use team ownership features to ensure issues are quickly assigned to relevant teams

Monitor Regressions

Closely monitor potential regressions of resolved issues

​
Next Steps

Source Mapping

Configure source mapping

Error Grouping

Learn about grouping mechanisms

Issue Status

Manage Issue status