@airbnb/lunar-metrics

Lunar Metrics

Provides integrated NewRelic and Sentry insights and metrics logging.

npm install @airbnb/lunar-metrics --save

Setup

Initialize the metrics package with your Sentry key/project (optional) and the current user ID.

import Metrics from '@airbnb/lunar-metrics';

Metrics.initialize({
  context: { additionalParams: 'toLog' },
  ignoreErrors: ['APIError'],
  sentryKey: 'abcdef',
  sentryProject: 'project',
  userID: getUserID(),
});

This will automatically bootstrap NewRelic (if the global below exists) and Sentry (if the key/project are defined).

NewRelic

Rather than being configured in your application logic, NewRelic is configured in the DOM with a script block, usually within a index.html file. The script block can be found in your NewRelic project -> Application settings page, and looks something like the following.

<script type="text/javascript">
  window.NREUM || (NREUM = {}),
    (__nr_require = function(t, e, n) {
      /* CODE */
    });
  if (window.location.origin.indexOf('localhost') >= 0) {
    // development:
    NREUM.info = {
      beacon: 'bam.nr-data.net',
      errorBeacon: 'bam.nr-data.net',
      licenseKey: 'foobarbaz',
      applicationID: '12345678',
      sa: 1,
    };
  } else {
    // production:
    NREUM.info = {
      beacon: 'bam.nr-data.net',
      errorBeacon: 'bam.nr-data.net',
      licenseKey: 'foobarbaz',
      applicationID: '12345678',
      sa: 1,
    };
  }
</script>

If you'd like to support separate development and production projects, a localhost conditional like the above will work.

Usage

Logging Errors

To log an error to both NewRelic and Sentry, use captureError. This function accepts a string, Error, or Event instance. It optionally supports additional params for Sentry as the 2nd argument.

import captureError from '@airbnb/lunar-metrics/lib/utils/captureError';

captureError('Something is broken');

captureError(new Error('Something is really really broken!'), {
  level: 'error',
});

captureError(someDomEvent);

Capturing Breadcrumbs

If you'd like to capture a Sentry breadcrumb to trail along side errors, use captureBreadcrumb.

import captureBreadcrumb from '@airbnb/lunar-metrics/lib/utils/captureBreadcrumb';

captureBreadcrumb({
  message: 'Failed to login',
  category: 'auth',
  data: {
    username: 'foobar',
  },
});