Already using Sentry?

If you’re already using Sentry, setting up Decipher is a 1-line change.

⏱ Estimated Time To Completion: 2 minutes

1

Get your new DSN by creating a project in Decipher

Log in to Decipher with your work email. On the Organization Settings page, choose a project name and click “Create New Project”.

We auto-create a Decipher-only project called “FirstFrontendProject” when your organization registers with Decipher, but that is separate from the Sentry project you’re about to add.

On the following screen, decide where you want to send data. We recommend choosing Decipher only to avoid double charges.

I want to send data to Decipher only (Recommended, if you want to switch from Sentry)

Sending data only to Decipher is the recommended option for many as it:

• Avoids duplicate charges from multiple providers

• Provides all the functionality you need in one place

• Simplifies your monitoring footprint

Decipher will give you a new dsn to copy and paste in the following step.

I want to send data to Decipher and Sentry

Sending data to both Decipher and Sentry requires your existing Sentry DSN and may result in charges from both services.

On the next screen, enter your Sentry DSN, and click “I’ll set this later” for the Sentry auth token. Then click “Add this project”.

Decipher will create a new project with a dedicated DSN for you. Using this new DSN will result in data being sent to both Decipher and Sentry.

2

Update your Sentry initialization to use the new DSN and configuration

NextJS

In your codebase, update the line that sets the dsn field of your existing Sentry initialization to use the new value you got from Step 1.

For client.config, we strongly recommend making sure replayIntegration and replaysSessionSampleRate are also set as below.

Please update your sentry.client.config.ts, sentry.edge.config.ts, and sentry.server.config.ts.

Other Frameworks

In your codebase, update the line that sets the dsn field of your existing Sentry initialization to use the new value you got from Step 1.

For frontends, we strongly recommend making sure replayIntegration and replaysSessionSampleRate are also set as below.

For example:

    Sentry.init({
    dsn: "YOUR_DSN_FROM_STEP_1", // Get this at https://app.getdecipher.com/settings
    integrations: [
        Sentry.browserTracingIntegration(),
        Sentry.replayIntegration({
            maskAllText: false,
            blockAllMedia: false,
            maskAllInputs: true
        }),
    ],
    replaysOnErrorSampleRate: 1.0,
    replaysSessionSampleRate: 1.0,
    tracesSampleRate: 1.0,
    });

3

Identify Users

If you aren’t already doing this, make sure to identify users where user information is available in your application frontend, typically after authentication or login.

// Set user information in Decipher via the Sentry TypeScript SDK
Sentry.setUser({
  "email": "[e-mail]",  // Recommended identifier to set (can add others)
  "id": "your_internal_unique_identifier", // use if email not available
  "username": "unique_username", // use if email not available
  "account": "AcmeCo",  // Which account/organization is this user a member of?
  // Additional user information can be added here        
});

Once you’re done, simply use your website to validate that Decipher is collecting session replay data (and that Sentry is too, if you selected that option).