You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/concepts/data-management/event-grouping/index.mdx
+26Lines changed: 26 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -55,6 +55,32 @@ If the stack trace is not available, but exception information is, then the grou
55
55
56
56
Grouping falls back to messages if the stack trace, `type`, and `value` are not available. When this happens, the grouping algorithm will try to use the message without any parameters. If that is not available, the grouping algorithm will use the full message attribute.
57
57
58
+
### AI-Enhanced Grouping
59
+
60
+
In addition to fingerprint-based grouping, Sentry uses AI to further improve issue grouping accuracy. This system helps identify semantically similar errors that might have different fingerprints due to minor code variations. The AI grouping system works alongside traditional fingerprinting - it only attempts to group new issues and will never split up issues that were grouped by fingerprint.
61
+
62
+
This system will not apply to any events that have fully custom fingerprints (either set via SDK or [fingerprint rules](https://docs.sentry.io/product/issues/grouping-and-fingerprints/#fingerprint-rules)). However, events with fingerprints containing `{{ default }}` will use AI grouping to calculate the `{{ default }}` portion of the fingerprint.
63
+
64
+
When Sentry's default fingerprinting algorithm generates a new hash, it automatically sends the error data to [Seer](https://github.com/getsentry/seer), our AI/ML service. That error data includes the message and in-app stack frames (including those configured with stack trace rules), or all frames when no in-app frames are present.
65
+
66
+
Seer performs the following steps:
67
+
68
+
1. It generates a vector representation of the error's stack trace using a transformer-based text embedding model
69
+
2. It compares this embedding against existing error embeddings for that project in the database
70
+
3. If a semantically similar error is found within the configured threshold, Sentry merges the new error into the existing issue
This algorithm is particularly effective at handling cases where:
75
+
76
+
- Similar errors occur in different parts of the codebase
77
+
- Code changes or deployments introduce slight variations in stack traces
78
+
- Different error types represent the same underlying problem
79
+
80
+
You can see issues that have been merged through this system in the “Merged Issues” section of the Issue Details UI. You can always unmerge any fingerprints that you would not like to see grouped, and our system will avoid grouping them in the future.
81
+
82
+

83
+
58
84
## Ways to Customize Error Grouping
59
85
60
86
If the way that Sentry is grouping issues for your organization is already ideal, you don't need to make any changes. However, you may find that Sentry is either creating too many similar groups, or is grouping disparate events into groups that should be separate. If this is the case, for **error issues**, you can extend and change the default grouping behavior. Error grouping can be extended and changed completely according to your needs. Transaction grouping currently cannot be customized.
0 commit comments