Skip to main content

How do I exclude unknown frames at the top of my stack from issue grouping?

Issue

My application includes third-party frames that Sentry cannot symbolicate because I do not have the debug information files for them. These frames appear at the top of the stack trace (toward the crash) and show as Unknown in the Sentry UI. I want Sentry to ignore these unsymbolicated frames when grouping issues so that unrelated errors are not grouped together.

Applies To

  • All SaaS Customers and Self-Hosted Users

  • Any SDK that uploads debug information files for symbolication (for example, the Native, Apple, Android NDK, .NET, Unity, and Unreal Engine SDKs)

  • Issue Grouping / Stack Trace Rules

Resolution

Use stack trace rules (previously called grouping enhancements) to remove the unsymbolicated frames from grouping. Configure them per project in Settings > Projects > [project] > Issue Grouping, under Stack Trace Rules.

Unsymbolicated frames have no resolved function name, so Sentry represents them internally with the value <unknown>. Add a rule that removes any frame with that function value from grouping:

stack.function:"<unknown>" -group

This rule matches every frame whose function could not be resolved and marks it as not contributing to grouping, so only your symbolicated frames are used to group issues.

Stack trace rules apply to new events going forward and do not retroactively regroup existing issues. For matcher and action syntax, see the stack trace rules documentation.

Did this answer your question?