Skip to content
Docs GitHub

debug-files

Work with debug information files

Create a JVM source bundle for source context

Arguments:

ArgumentDescription
<path>Directory containing JVM source files

Options:

OptionDescription
-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.

Terminal window
# 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
  • This command is local-only — it makes no network requests. Upload the generated 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.