hapi-sentry

A hapi plugin for request error logging to Sentry.

Usage

Use the hapi plugin like this:

const server = hapi.server();
await server.register({
  plugin: require('hapi-sentry'),
  options: {
    client: { dsn: 'dsn-here' },
  },
});

This setup will:

• Initialize Sentry regularly, which should capture all global errors and unhandled promise rejects
• Capture all unhandled exceptions thrown or returned in routes
• Use request data and request.auth.credentials to enhance errors from routes

You can use the following options to customize this behavior further.

Options

The plugin options, you can pass in while registering are the following:

The baseUri option is used internally to get a correct URL in sentry issues. The scope option is used to set up a global Scope for all events and the client option is used as a Sentry instance or to initialize an internally used Sentry instance.

The internally used client (initialized in either way) is accessible through server.plugins['hapi-sentry'].client.

Using your own Sentry instance

You can pass a Sentry instance to the client option if you already initialized your own like this:

const server = hapi.server();
const Sentry = require('sentry');
Sentry.init({ dsn: 'dsn-here' });
await server.register({ plugin: require('hapi-sentry'), options: { client: Sentry } });

Scope

You can alter the scope of an event in every hapi route handler by accessing request.sentryScope. Just use some of the Scopes methods to add breadcrumbs, set extra, fingerprint or level information, etc. like this:

server.route({
  method: 'GET',
  path: '/your/route',
  handler(request) {
    try {
      // ... some logic here
    } catch (error) {
      request.sentryScope.setExtra('someErrorSpecificInfo', 'yourInformation');
      throw error;
    }
  },
});

Capturing server.log and request.log events

You can enable capturing of request.log and server.log events using the catchLogErrors option. All events which are Error objects and are tagged by one of ['error', 'fatal', 'fail'] are automatically being tracked when catchLogErrors is set to true, e.g.:

request.log(['error', 'foo'], new Error('Oh no!'));
server.log(['error', 'foo'], new Error('No no!'));

The considered tags can be changed by setting catchLogErrors to a custom array of tags like ['error', 'warn', 'failure'].

Capturing the request body

hapi-sentry currently does not capture the body for performance reasons. You can use the following snippet to capture the body in all sentry errors:

server.ext({
  type: 'onPostAuth',
  method(request, h) {
    request.payload && request.sentryScope.setExtra('payload', request.payload);
    return h.continue;
  },
});