debug-files

Work with debug information files

Commands

sentry debug-files check <path>

Inspect a debug information file

Arguments:

Argument	Description
<path>	Path to the debug information file

sentry debug-files print-sources <path>

List the source files a debug file references

Arguments:

Argument	Description
<path>	Path to the debug information file

sentry debug-files bundle-sources <path>

Bundle a debug file's source files for source context

Arguments:

Argument	Description
<path>	Path to the debug information file

Options:

Option	Description
-o, --output <output>	Output path for the source bundle ZIP (default: .src.zip)

sentry debug-files bundle-jvm <path>

Create a JVM source bundle for source context

Arguments:

Argument	Description
<path>	Directory containing JVM source files

Options:

Option	Description
-o, --output <output>	Output directory for the bundle ZIP
-d, --debug-id <debug-id>	Debug ID (UUID) to stamp on the bundle
-e, --exclude <exclude>...	Additional directory names to exclude (repeatable)

All commands support --json for machine-readable output and --fields to select specific JSON fields.

Examples

# Inspect a debug information file (auto-detects the format)
sentry debug-files check ./libexample.so
sentry debug-files check MyApp.dSYM/Contents/Resources/DWARF/MyApp
sentry debug-files check ./app.pdb --json

# List the source files a debug file references (and whether they're available)
sentry debug-files print-sources ./libexample.so
sentry debug-files print-sources ./app.pdb --json

# Bundle a debug file's referenced source files (run on the build machine)
sentry debug-files bundle-sources ./libexample.so
sentry debug-files bundle-sources ./app.pdb --output ./app.src.zip

# Bundle JVM sources with a debug ID
sentry debug-files bundle-jvm --output ./out --debug-id <uuid> ./src

# Exclude additional directories
sentry debug-files bundle-jvm --output ./out --debug-id <uuid> --exclude generated --exclude build-tools ./src

# Output as JSON
sentry debug-files bundle-jvm --output ./out --debug-id <uuid> --json ./src

Important Notes

• check, print-sources, bundle-sources, and bundle-jvm are local-only — they make no network requests. They parse object files in-process (Mach-O/dSYM, ELF, PE/PDB, Portable PDB, WebAssembly, Breakpad, source bundles) via a bundled symbolic WASM module.
• check exits non-zero if the file is not usable for symbolication (no debug id or no useful features).
• print-sources lists the source files each object references, reporting for each whether the source is embedded in the debug file, available via a source link, or present on the local disk. It is a read-only preview of what bundle-sources would collect and always exits zero on a parseable file.
• bundle-sources reads source files from the paths recorded in the debug info, so it is normally run on the build machine right after compiling. Referenced files that are not present locally are skipped; it exits non-zero (writing nothing) when none are found. The bundle defaults to <path>.src.zip and is uploaded via sentry debug-files upload.
• Upload a JVM bundle separately via sentry debug-files upload --type jvm.
• Supported JVM source file extensions: .java, .kt, .scala, .sc, .groovy, .gvy, .gy, .gsh, .clj, .cljc
• Build output directories (build/, target/, out/, bin/) are automatically excluded unless they appear under a src/ ancestor.
• Source-set prefixes (e.g., src/main/java/) are stripped to produce package-relative paths matching JVM stack traces.