100+ Other Frameworks

Decipher collects data via the Sentry SDK for backends.

⏱ Estimated Time To Completion: 5 minutes

Please make sure you’ve installed Decipher for your frontend before continuing.

1

Initialize the Sentry SDK

Initialize the Sentry SDK in your backend project. The steps for this vary based on your language and framework; see Sentry docs here.

For example, for a NextJS project, run the following command at the root of your repository.

Terminal

npx @sentry/wizard@latest -i nextjs

2

Create a Decipher project and get your DSN

If you're using Decipher only (recommended)

Login to Decipher with your work email. On the Organization Settings page, select a new project name and click “Create New Project”. Decipher will generate a DSN to use in the next step; copy this to your clipboard.

If you already have a Sentry project

[These steps only apply if you already have a project in Sentry you would like to continue sending data to, in addition to sending data to Decipher. Otherwise, see **“**If you’re using Decipher only” sub-section above.]

Login to Decipher with your work email. On the Organization Settings page, select a new project name and click “Create New Project”. On the following screen, choose “Decipher and Sentry” to create a project that sends data to both Decipher and Sentry.

Enter your Sentry DSN and if possible, your auth token. Decipher will create a project and give you a new DSN to use (see Already using Sentry? if you need more help).

You can configure Decipher to stop sending data to Sentry to avoid double charges — just follow the above steps instead.

3

Update your Sentry initialization

Update the DSN parameter in your Sentry init call (which varies by language) to the new DSN.

For example:

instrumentation.ts

import * as Sentry from "@sentry/nextjs";

Sentry.init({
  dsn: process.env.DECIPHER_DSN_FROM_STEP_2, // Replace with your Decipher DSN.
  // Other Sentry options can go here.
});

For NextJS projects, you’ll need to update the DSN in sentry.client.config.ts, sentry.edge.config.ts, and sentry.server.config.ts (or instrumentation.ts).

4

[Frontend Only] Configuring Session Replays for AI Analysis

To provide enough context for the AI to determine which errors are high severity, you need to make sure session replays are configured correctly.

It is important that you set maskAllText: false. For additional privacy, you can set maskAllInputs: true.

Recommended configuration:

sentry.client.config.ts

Sentry.init({
  dsn: process.env.DECIPHER_DSN_FROM_STEP_2, // Replace with your Decipher DSN.
  integrations: [
    Sentry.replayIntegration({
      maskAllText: false,
      maskAllInputs: false, // Set this to `true` for extra privacy.
      blockAllMedia: false,
    }),
  ],
  // Other Sentry options can go here.
});

5

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 errors to highlight the important, high-impact ones.