Already using Sentry?

If you’re already using Sentry, switching to 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”.

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

(Alternatively, you can have data sent to both Decipher and Sentry by choosing the other box. You’ll need to find your dsn from Sentry for this option.)

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

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

Test the integration

That’s it! Now test the integration by forcing an error anywhere in your app, e.g.

app/cart.tsx

function Cart() {
    // ... existing code ...

    const handleError = () => {
        throw new Error("This is a test error for Decipher's Sentry integration.");
    };

    return (
        <div>
            <button onClick={handleError}>Trigger Error</button>
        </div>
    );
    // ... existing code ...
}

Check out the Decipher dashboard to see information about your captured error. Decipher will automatically analyze and group your usage and errors to highlight the important, high-impact bugs.