Deno

Prerequisites

You need:

• A Sentry account and project
• Your application up and running
• Deno version >= 2.0.0

Step 1: Install

Choose the features you want to configure, and this guide will show you how:

Import the Sentry SDK

Import the Sentry Deno SDK directly from the npm registry, before importing any other modules:

import * as Sentry from "npm:@sentry/deno";
// your other imports

Step 2: Configure

Initialize the Sentry SDK

Initialize Sentry as early as possible in your app:

import * as Sentry from "npm:@sentry/deno";
// your other imports

Sentry.init({
  dsn: "___PUBLIC_DSN___",

  // Adds request headers and IP for users, for more info visit:
  // https://docs.sentry.io/platforms/javascript/guides/deno/configuration/options/#sendDefaultPii
  sendDefaultPii: true,
  // ___PRODUCT_OPTION_START___ performance

  // Set tracesSampleRate to 1.0 to capture 100%
  // of transactions for performance monitoring.
  // We recommend adjusting this value in production
  // Learn more at
  // https://docs.sentry.io/platforms/javascript/configuration/options/#traces-sample-rate
  tracesSampleRate: 1.0,
  // ___PRODUCT_OPTION_END___ performance
  // ___PRODUCT_OPTION_START___ logs

  // Enable logs to be sent to Sentry
  enableLogs: true,
  // ___PRODUCT_OPTION_END___ logs
});

Enable Network Access

To make sure the SDK can send events, enable network access for your Sentry ingestion domain:

deno run --allow-net=___ORG_INGEST_DOMAIN___ index.ts

Allow Access to Source Files

Grant read access to your source files so that the SDK can include your source code in stack traces:

deno run --allow-read=./src index.ts

Step 3: Add Readable Stack Traces With Source Maps (Optional)

The stack traces in your Sentry errors probably won't look like your actual code without unminifying them. To fix this, upload your source maps to Sentry. The easiest way to do this is by using the Sentry Wizard:

npx @sentry/wizard@latest -i sourcemaps

Step 4: Verify Your Setup

Let's test your setup and confirm that Sentry is working correctly and sending data to your Sentry project.

Issues

First, let's verify that Sentry captures errors and creates issues in your Sentry project. Add the following code snippet to your main application file, which will call an undefined function, triggering an error that Sentry will capture:

setTimeout(() => {
  try {
    foo();
  } catch (e) {
    Sentry.captureException(e);
  }
}, 99);

Sentry.startSpan(
  {
    op: "test",
    name: "My First Test Transaction",
  },
  () => {
    setTimeout(() => {
      try {
        foo();
      } catch (e) {
        Sentry.captureException(e);
      }
    }, 99);
  },
);

View Captured Data in Sentry

Finally, head over to your project on Sentry.io to view the collected data (it takes a couple of moments for the data to appear).

Next Steps

At this point, you should have integrated Sentry into your Deno application and should already be sending data to your Sentry project.

Now's a good time to customize your setup and look into more advanced topics. Our next recommended steps for you are:

• Explore practical guides on what to monitor, log, track, and investigate after setup
• Extend Sentry to your frontend using one of our frontend SDKs
• Learn how to manually capture errors
• Continue to customize your configuration
• Get familiar with Sentry's product features like tracing, insights, and alerts