Track your Strapi errors in Sentry
The official plugin to track Strapi errors with Sentry.
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
property | type (default) | description |
---|---|---|
dsn | string (null ) | Your Sentry data source name (see Sentry docs). |
sendMetadata | boolean (true ) | Whether the plugin should attach additional information (like OS, browser, etc.) to the events sent to Sentry. |
init | object ({} ) | 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
module.exports = ({ env }) => ({
// ...
sentry: {
enabled: true,
config: {
dsn: env('SENTRY_DSN'),
sendMetadata: true,
},
},
// ...
});
You can access a Sentry service throughout your app.
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
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
const sentryInstance = strapi
.plugin('sentry')
.service('sentry')
.getInstance();
This plugin can be disabled in the plugins configuration file. With the env
utility, it is also possible to disable it depending on the environment.
Example
./config/plugins.js
module.exports = ({ env }) => ({
// ...
sentry: {
// Only enable Sentry in production
enabled: env('NODE_ENV') === 'production',
},
// ...
});
npm install @strapi/plugin-sentry