Skip to content

Commit 43228b7

Browse files
authored
ref(profiling): add note for profiles stack trace rules (#11852)
* add note for profiles stack trace rules
1 parent 7d3d3c4 commit 43228b7

File tree

1 file changed

+20
-2
lines changed

1 file changed

+20
-2
lines changed

docs/concepts/data-management/event-grouping/stack-trace-rules.mdx

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,27 @@ description: "Learn how to use stack trace rules to group incoming events based
66

77
<Include name="only-error-issues-note.mdx" />
88

9-
If you use stack traces for grouping, the stack trace rules (previously known as _grouping enhancements_) influence the data that's fed into the grouping algorithm. These rules can be configured on a per-project basis in **[Project] > Settings > Issue Grouping > Stack Trace Rules**.
9+
Stack trace rules improve issue tracking by ensuring accurate grouping and better classification of stack frames as in-app or system. This helps focus on relevant code, reduces noise, and minimizes false positives. By tailoring rules to your project, you can streamline debugging and maintain consistency across teams or multiple applications.
1010

11-
Each line is a single rule; one or multiple match expressions are followed by one or multiple actions to be executed when all expressions match. All rules are executed from top to bottom on all frames in the stack trace.
11+
When you set stack trace rules (previously known as _grouping enhancements_) for grouping in Sentry, they influence the data that's fed into the grouping algorithm. These rules can be configured on a per-project basis by going to your project settings and then clicking on "Issue Grouping".
12+
13+
Here are a few things to note about stack trace rules:
14+
15+
- Each rule is written on a single line.
16+
- Rules consist of one or more match expressions followed by one or more actions triggered when all expressions match.
17+
- Rules are applied sequentially, from top to bottom, across all frames in the stack trace.
18+
19+
In addition, the stack trace rules using the below matchers and actions can also be applied to incoming profiles to improve frame classification (in-app vs system, for example).
20+
21+
Allowed Matchers:
22+
* `stack.abs_path`
23+
* `stack.module`
24+
* `stack.function`
25+
* `stack.package`
26+
27+
Allowed Actions:
28+
* `+app`
29+
* `-app`
1230

1331
The syntax for stack trace rules is similar to:
1432

0 commit comments

Comments
 (0)