Clever Use of the Issue Auto-Discovery Feature for Quick Response to Anomalies¶

Issue Auto-Discovery¶

In the TrueWatch platform, we have introduced the [Issue Auto-Discovery] feature, which aims to automatically batch-generate Issues and notify relevant members based on errors detected by the Application Performance Monitoring (APM) and User Access Monitoring (RUM) modules.

This feature is faster and more flexible compared to traditional manual Issue creation, effectively accelerating the identification and resolution of anomalies.

Next, let's see how to use the Issue Auto-Discovery feature.

How to Use the Issue Auto-Discovery Feature¶

Use Cases and Permissions¶

The Issue Auto-Discovery feature applies to: Application Performance Monitoring (APM) > Error Tracking, User Access Monitoring (RUM) > Error Explorer.

Operation permissions: Owner, Administrator, Standard, custom roles with [Issue Auto-Discovery] permission.

Start Configuration¶

First Look: Issue Auto-Discovery¶

Members with operational permissions, after entering APM > Error Tracking or RUM > Error Explorer, will see text for Issue Auto-Discovery, an edit button, and an activation indicator in the upper-right corner.

Clicking the edit button allows configuration of Issue Auto-Discovery rules.
The toggle button controls whether Issue Auto-Discovery is enabled.

Editing Issue Auto-Discovery Configuration¶

Concepts

Click the edit button to bring up the configuration panel and set up the rules for Issue Auto-Discovery.

Configuration Item	Description
Data Source	Automatically filled based on the location of the auto-discovery menu opened by the user.
Grouping Dimensions	Selection rule: default filling of corresponding dimensions from APM > Error Tracking / RUM > Error data. Function: Issue classification based on configured field combinations. If there are related field groupings and corresponding data in the error data, a single Issue will be automatically generated.
Detection Frequency	Issue Auto can regularly detect APM > Error Tracking / RUM > Error data. Customize the frequency of discovery here.
Issue Definition	Define automatically discovered Issues. Rules for creating Issues can be viewed at: Create Issue. Template variables: Support has been added for using predefined template variables in the title and description of Issues. After adding template variables, the details of the corresponding event in the generated Issue can be viewed.

Additional Notes:

When configuring separately in APM > Error Tracking and RUM > Error Explorer, the options for [Grouping Dimensions] and [Template Variables in Issues] differ, but the configuration logic remains unchanged.

Grouping Dimensions: Automatically filled, with different fields populated.
APM Grouping Dimensions:

RUM Grouping Dimensions:

Template Variables: Titles and descriptions of Issues support template variables; available variable categories differ between APM and RUM.

After completing the configuration of the Issue Auto-Discovery rules, click "Save."

Enable the Issue Auto-Discovery button.

Generating and Viewing Issues Using the Issue Auto-Discovery Feature¶

Issue Delivery¶

After configuring the Issue Auto-Discovery rules and enabling this function, the system will automatically discover errors according to the configured detection frequency and generate Issues. Generated Issues will be delivered to the configured channels.

Issue Display¶

Issues created via [Issue Auto-Discovery] will use [Grouping Dimensions] as unique IDs. If an Issue with the same combination of dimensions already exists in history, a new Issue will not be created but instead content will be appended to the historical Issue reply section for updates. In most cases, statuses can be identified through special markings such as "New Problem," "Duplicate Problem," and "Regression Problem."

Special elements of auto-discovered Issue cards:

Creator: Displayed as [Issue Auto-Discovery], indicating its automatic generation attribute.
Grouping Dimensions: New grouping dimension information is added, displayed on the Issue card page and detail page.
Special Markings: Auto-discovered Issues generally have 3 different special markings: "New Problem," "Duplicate Problem," "Regression Problem."
- New Problem: If no historical Issue exists with the same grouping dimensions, an Issue is created and marked as "New Problem" on the right side;
- Duplicate Problem: If a historical Issue already exists with the same grouping dimensions and the status is Open or Pending, it indicates the problem reoccurs, and the historical Issue is marked as "Duplicate Problem";
- Regression Problem: If a historical Issue already exists with the same grouping dimensions and the status is Resolved, it indicates the problem has reappeared after being resolved, and the historical Issue is marked as "Regression Problem".

Apart from these special fields and elements, other aspects such as titles, content, levels, statuses, replies, etc., follow the same logic as regular Issues.

Common Questions¶

Clicking the Issue Auto-Discovery enable button does not work.

If you are using this feature for the first time and have not yet edited the auto-discovery configuration, direct activation is not supported. You can first click the Issue Auto-Discovery edit button, configure the auto-discovery rules, and then activate them.

Entering APM > Error Tracking, RUM > Error Explorer does not show this feature.

The permission scope for this feature includes: Owner, Administrator, Standard, custom roles (configured with [Issue Auto-Discovery] permission).

Therefore, please first confirm your role under the Manage > Member Management menu. If you have a custom role, ensure that this permission has been granted.