Error catching

In this guide we will see how you can catch errors and send them to the Application Monitoring / Error Tracking Software you want.

TIP

In this example we will use Sentry (opens new window).

Create a middleware

A middleware will be used in order to catch the errors which will then be sent to Sentry.

• Create a ./middlewares/sentry/index.js file.

Path — ./middlewares/sentry/index.js

module.exports = strapi => {
  return {
    initialize() {
      strapi.app.use(async (ctx, next) => {
        await next();
      });
    },
  };
};

Handle errors

Here is the Node.js client documentation (opens new window).

Install it with yarn add @sentry/node or npm install @sentry/node --save.

• Now add the logic that will catch errors.

Path — ./middlewares/sentry/index.js

const Sentry = require('@sentry/node');
Sentry.init({
  dsn: 'https://<key>@sentry.io/<project>',
  environment: strapi.config.environment,
});
module.exports = strapi => {
  return {
    initialize() {
      strapi.app.use(async (ctx, next) => {
        try {
          await next();
        } catch (error) {
          Sentry.captureException(error);
          throw error;
        }
      });
    },
  };
};

WARNING

It’s important to call throw(error); to avoid stopping the middleware stack. If you don’t re-throw the error, it won’t be handled by the Strapi’s error formatter and the api will never respond to the client.

Configure the middleware

To ensure that your middleware catches all errors including those in other middleware, it needs to be added at the beginning of the stack but after the boom middleware.

After, the sentry middleware captures and rethrows the error, boom will return an appropriate HTTP response to the client.

Path — ./config/middleware.js

module.exports = {
  load: {
    before: ['boom', 'sentry', ...],
    ...
  },
};

And finally you have to enable the middleware.

Path — ./config/middleware.js

module.exports = {
  settings: {
    sentry: {
      enabled: true,
    },
  },
};