Debug Information Files

Debug information files allow Sentry to extract stack traces and provide more information about crash reports for most compiled platforms. Information stored in debug files includes original function names, paths to source files and line numbers, source code context, or the placement of variables in memory. Sentry can use some of this information and display it on the issue details page.

Each major platform uses different debug information files. We currently support the following formats:

• dSYM files for iOS, iPadOS, tvOS, watchOS, macOS, and visionOS
• ELF symbols for Linux and Android (NDK)
• PDB files for Windows and .NET
• Breakpad symbols for all platforms
• WASM files for WebAssembly
• ProGuard mappings for Java and Android

Sentry requires access to debug information files of your application as well as system libraries to provide fully symbolicated crash reports. You can either upload your files to Sentry or put them on a compatible Symbol Server to be downloaded by Sentry when needed.

Managing Debug Information Files

After they have been uploaded, debug information files can be viewed and managed from the Debug Files section in the associated project's settings page. That page lists all uploaded debug files, and also allows you to configure symbol servers for automatic downloads.

From the Project Details page, click into settings, then click on Debug Files in the page navigation.

Retention Policy

Debug Files have a retention period of 90 days, using a time to idle expiration mechanism. This means that uploaded debug files are retained for as long as they are actively being used for event processing. Once a debug file has not been used to process incoming events for at least 90 days, it will automatically expire and be eligible for deletion.

Learn More