Explore documentation
  1. Welcome to Errors 👋
    1. JavaScript tag
  2. Collecting errors
    1. Integrating using an AI prompt
    2. Sentry SDK
  3. Using the product
    1. Exception grouping
    2. Fix with AI
    3. Releases
    4. Uploading source maps
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
    6. GitHub
  5. Errors API
    1. Getting an API token
    2. Applications API
    3. Application groups API

Uploading source maps

Upload JavaScript or TypeScript source maps by integrating your existing Sentry Source Map Upload with Better Stack. All of the Sentry-supported JavaScript build-system integrations and manual uploads should work as-is.

Browser JavaScript / TypeScript

React Native

We do not currently support publicly-hosted source maps, and require you to upload them.

If you need public source maps, or have any issues uploading source maps for one of the above types, please get in touch at hello@betterstack.com.

To configure your build process to upload source maps to Better Stack, follow the "Manual Setup" steps for any of the linked build processes above, and update the required configuration values or environment variables from the values in Errors -> Applications -> Your Application -> Data ingestion.

  • org or SENTRY_ORG - A Better Stack ID representing your team.
  • project or SENTRY_PROJECT - The Better Stack ID for your application.
  • url or SENTRY_URL - The Better Stack endpoint source maps are uploaded to, for example https://us-east-9-sourcemaps.betterstackdata.com.
  • authToken or SENTRY_AUTH_TOKEN - This is a Telemetry API token.

Ensure you don't commit your BETTER_STACK_API_TOKEN to source control, as it also gives access to your Telemetry account. Use an uncommited env file or CI secrets management instead.

Here are a few examples:

Webpack Vite .env file 
sentryWebpackPlugin({
  org: $SENTRY_ORG,
  project: $SENTRY_PROJECT,
  url: $SENTRY_URL,
  authToken: process.env.BETTER_STACK_API_TOKEN
})
sentryVitePlugin({
  org: $SENTRY_ORG,
  project: $SENTRY_PROJECT,
  url: $SENTRY_URL,
  authToken: process.env.BETTER_STACK_API_TOKEN
})
SENTRY_ORG=$SENTRY_ORG
SENTRY_PROJECT=$SENTRY_PROJECT
SENTRY_AUTH_TOKEN=$BETTER_STACK_API_TOKEN
SENTRY_URL=$SENTRY_URL

See the expanded source maps in Better Stack

After uploading your source maps, any subsequent errors will have detailed stack frames in Better Stack Errors! 🚀

Previous article

Releases

Next article

Reporting incidents