Vercel

Vercel is an all-in-one platform with Global CDN supporting static and JAMstack deployment and Serverless Functions. Connect your Sentry and Vercel projects to automatically upload source maps and notify Sentry of release deployment.

This integration needs to set up only once per organization, then it is available for all projects.

Install

  1. Visit https://vercel.com/integrations/sentry/add

  2. Select your account and click "Add".

    Sentry modal showing Vercel installation

    Sentry modal showing Vercel internal integration

Configure

Use Vercel to link projects for uploading source maps and notifiying Sentry of release deployment.

Project Linking

  1. Select a Sentry project and a Vercel project to link together.

    Sentry modal showing linking Sentry project to Vercel project

    • This step will generate environment variables in the selected Vercel project. Having these set means you can skip the CLI Configuration step in the Sentry Webpack Plugin setup. You can see these in Vercel in Project Settings > General > Environment Variables.

    Sentry modal showing linking Sentry project to Vercel project

    • SENTRY_ORG - the name of your Sentry organization
    • SENTRY_PROJECT - the name of your linked Sentry project
    • SENTRY_AUTH_TOKEN - the auth token from the Vercel Internal Integration that was created upon installation
    • NEXT_PUBLIC_SENTRY_DSN - the linked Sentry project's DSN
    • VERCEL_GITHUB_COMMIT_SHA, VERCEL_GITLAB_COMMIT_SHA, or VERCEL_BITBUCKET_COMMIT_SHA - your source code provider's commit SHA, used for creating releases and associating commits
  2. Redeploy your Vercel project in order to trigger a release.

Usage

Uninstallation

  1. The integration must be uninstalled from Vercel. Visit the Vercel integration configuration page (Organization Settings > Integrations > Vercel > Configurations) and click "Uninstall" then "Visit Vercel" in the modal that pops up.

    Sentry modal showing uninstalling Vercel integration

  2. Click "Remove Configuration".

  3. Delete the internal integration that was created by navigating to Organization Settings > Developer Settings and clicking the trash can icon next to Vercel Internal Integration. You will be prompted to confirm the deletion by entering a string provided in the modal. Enter the string and click "Confirm" to finalize the deletion.

    Sentry modal showing uninstalling Vercel integration

You can edit this page on GitHub.