• Product

  • Solutions

  • Developers

  • Docs

  • Pricing

  • Cloud

Search icon
Strapi plugin logo for Sentry

Sentry
Made by Strapi badge
Made by Strapi

Track your Strapi errors in Sentry

Strapi plugin Sentry

The official plugin to track Strapi errors with Sentry.

Features

  • Initialize a Sentry instance when your Strapi app starts
  • Send errors encountered in your application's end API to Sentry
  • Attach useful metadata to Sentry events, to help you with debugging
  • Expose a global Sentry service

Installation

To install this plugin, you need to add an NPM dependency to your Strapi application.

# Using Yarn
yarn add @strapi/plugin-sentry

# Or using NPM
npm install @strapi/plugin-sentry

Configuration

propertytype (default)description
dsnstring (null)Your Sentry data source name (see Sentry docs).
sendMetadataboolean (true)Whether the plugin should attach additional information (like OS, browser, etc.) to the events sent to Sentry.
initobject ({})A config object that is passed directly to Sentry during the Sentry.init(). See all available options on Sentry's docs

Example

./config/plugins.js

1
2
3
4
5
6
7
8
9
10
11
module.exports = ({ env }) => ({
  // ...
  sentry: {
    enabled: true,
    config: {
      dsn: env('SENTRY_DSN'),
      sendMetadata: true,
    },
  },
  // ...
});

Global Sentry service

You can access a Sentry service throughout your app.

1
const sentryService = strapi.plugin('sentry').service('sentry');

This service exposes the following methods:

sendError(error, configureScope)

Use it to manually send errors to Sentry. The configureScope is optional, it allows you to customize the error event. Read more about Sentry's scope system on their docs.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
try {
  // Your code here
} catch (error) {
  // Either send a simple error
  strapi.plugin('sentry').service('sentry').sendError(error);

  // Or send an error with a customized Sentry scope
  strapi
    .plugin('sentry')
    .service('sentry')
    .sendError(error, (scope, sentryInstance) => {
      // Customize the scope here
      scope.setTag('my_custom_tag', 'Tag value');
    });
  throw error;
}

getInstance()

Use it if you need direct access to the Sentry instance, which should already already be initialized. It's useful if sendError doesn't suit your needs.

Example

1
const sentryInstance = strapi.plugin('sentry').service('sentry').getInstance();

Disabling for non-production environments

If the dsn property is set to a nil value (null or undefined) while enabled is true, the Sentry plugin will be available to use in the running Strapi instance, but the service will not actually send errors to Sentry. That allows you to write code that runs on every environment without additional checks, but only send errors to Sentry in production.

When you start Strapi with a nil dsn config property, the plugin will print a warning:
info: @strapi/plugin-sentry is disabled because no Sentry DSN was provided

You can make use of that by using the env utility to set the dsn config property depending on the environment.

Example

./config/plugins.js

1
2
3
4
5
6
7
8
9
10
11
module.exports = ({ env }) => ({
  // ...
  sentry: {
    enabled: true,
    config: {
      // Only set `dsn` property in production
      dsn: env('NODE_ENV') === 'production' ? env('SENTRY_DSN') : null,
    },
  },
  // ...
});

Disabling altogether

Like every other plugin, you can also disable this plugin in the plugins configuration file. This will cause strapi.plugins('sentry') to return undefined.

Example

./config/plugins.js

1
2
3
4
5
6
7
module.exports = ({ env }) => ({
  // ...
  sentry: {
    enabled: false,
  },
  // ...
});

Install now

npm install @strapi/plugin-sentry

STATS

59403 GitHub stars10448 weekly downloads

Last updated

6 days ago

Strapi Version

4.0.0 and above

Author

github profile image for Strapi Solutions SAS
Strapi Solutions SAS

Useful links

Create your own plugin

Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.