Debug Symbols

Debug symbols help provide you with readable stack traces, which Sentry displays on the Issue Details page, to help you triage an issue. We offer a range of methods to provide Sentry with debug symbols.

When to Upload

With default settings, complete stack traces are available in your Java/Kotlin error, out of the box, unless you use enableProguardInReleaseBuilds. In this case, you need to upload the ProGuard/R8 mapping files generated by the Android Gradle Plugin, so Sentry can show you proper stack traces.

Errors raised from the native layer in Android apps require certain debug information files to be uploaded. For example, dwarf debug files need to be uploaded for an Android app with NDK support.

Uploading With Sentry Gradle Plugin

Upload the Android ProGuard/R8 mapping files and native symbols by the recommended method of using our Gradle integration.

Uploading With sentry-cli

Upload the Android ProGuard/R8 mapping files and native symbols manually by using sentry-cli upload-proguard and debug-files.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) to suggesting an update ("yeah, this would be better").