Sourcemap Upload API

edit

The APM Server exposes an API endpoint to upload source maps for real user monitoring (RUM).

Upload endpoint

edit

Send a HTTP POST request with the Content-Type header set to multipart/form-data to the source map endpoint:

http(s)://{hostname}:{port}/assets/v1/sourcemaps

The URL for uploading sourcemaps was previously /v1/sourcemaps. It still works, but is being deprecated in favor of /assets/v1/sourcemaps.

Request Fields

edit

The request must include some fields needed to identify source map correctly later on:

  • service_name
  • service_version
  • bundle_filepath: needs to be the absolute path of the final bundle as it is used in the web application

The source map must follow the Source map revision 3 proposal spec and be attached as a file upload.

You can configure a secret token to upload sourcemaps.

Example

edit

Example source map request including an optional secret token "mysecret":

curl -X POST http://127.0.0.1:8200/assets/v1/sourcemaps \
  -H "Authorization: Bearer mysecret" \
  -F service_name="test-service" \
  -F service_version="1.0" \
  -F bundle_filepath="http://localhost/static/js/bundle.js" \
  -F sourcemap=@bundle.js.map