# 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.

# 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.

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

Make sure your middleware is added at the beginning of the middleware stack.

Path — ./config/middleware.js

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

And finally you have to enable the middleware.

Path — ./config/middleware.js

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