Uploading source maps (The Telebugs Manual)

Next: Managing source maps, Previous: Integrating source maps with releases, Up: Source maps [Contents]

13.3 Uploading source maps ¶

Upload source maps to an existing release either manually through the user interface or automatically using the Sentry CLI tool, which is compatible with Telebugs.

Manual upload: Navigate to the release details (see Release details), select Attach artifacts (or drag and drop), and upload the .map files. Multiple files can be uploaded simultaneously.

Automated upload: Obtain an API key from account settings (see Regenerating your API key). The API key starts with tlbgs_.

Before running the commands, set the following environment variables:

export SENTRY_URL=<your-telebugs-url>
export SENTRY_AUTH_TOKEN=tlbgs_<your-api-key>
export SENTRY_PROJECT=<your-project-id>
export SENTRY_ORG=<any-value> # This is not used but required for compatibility

Execute the following commands:

sentry-cli sourcemaps upload --release=<version> ./path/to/maps

For builds requiring injection of source map references:

sentry-cli sourcemaps inject ./build
sentry-cli sourcemaps upload --release=<version> ./build

Upon upload, Telebugs applies the maps to incoming error reports, resolving minified traces without further configuration. To verify, trigger a test error and review the resolved stack trace in the report.