Private Sourcemaps

Private sourcemaps are a core feature available on all paid plans along with public sourcemaps.

This guide assumes you have already installed Airbrake in your JavaScript app.

Benefits of private sourcemap uploads

Uploading private sourcemaps to Airbrake:

  • Allows us to de-minify your JavaScript files and present your backtraces with meaningful line numbers that look like pre-minified source code
  • Provides a more accurate picture of the error and faster debugging times
  • Gives you all of the debugging benefits of publicly hosted sourcemaps without exposing your source code

Generating sourcemaps

Generating sourcemaps can be done with uglifyjs and webpack. Here is an example to minify and create a sourcemap for an app.js file:

uglifyjs app.js -o app.min.js -c -m \
  --source-map "root='https://example.com/',url='app.min.js.map'"

This command will create two new files, a minified app.min.js file and a sourcemap named app.min.js.map. The sourcemap file is what we will be uploading to Airbrake.

Uploading sourcemaps

Continuing on with our above example, the next steps assume the minified version of app.js is publicly available at https://example.com/app.min.js.

The bottom of the app.min.js file should have a comment with the name of the of the sourcemap.

//# sourceMappingURL=app.min.js.map

Upload your sourcemap

The following curl command assumes that your sourcemap file app.min.js.map is in the current directory and will upload your sourcemap to airbrake.

curl https://airbrake.io/api/v4/projects/PROJECT_ID/sourcemaps \
  -X POST \
  -H 'Authorization: Bearer PROJECT_API_KEY' \
  -F file=@app.min.js.map \
  -F name="https://example.com/app.min.js.map"

Note: PROJECT_ID and PROJECT_API_KEY will need to be switched out for the real values from your project.

Troubleshooting

For your private sourcemap upload to function correctly it’s important you check that:

  • The name for the file https://example.com/app.min.js.map should be fully qualified.
  • Your app.min.js file has the sourceMappingURL comment at the bottom of that file, e.g. //# sourceMappingURL=app.min.js.map

We also support public sourcemaps please visit our official airbrake-js repo for more info.

Sourcemap file size limit

Public and private sourcemaps have a file size limit of 32MB. Sourcemaps greater than 32MB will return a 400

{"code":400,"type":"Bad Request","message":"http: request body too large"}