@sentry/aws-serverless

Official Sentry SDK for AWS Lambda

Links

• Official SDK Docs

General

This package is a wrapper around @sentry/node, with added functionality related to AWS Lambda. All methods available in @sentry/node can be imported from @sentry/aws-serverless.

To use this SDK, call Sentry.init(options) at the very beginning of your JavaScript file.

import * as Sentry from '@sentry/aws-serverless';

Sentry.init({
  dsn: '__DSN__',
  // ...
});

// async (recommended)
export const handler = async (event, context) => {
  throw new Error('oh, hello there!');
};

// sync
export const handler = (event, context, callback) => {
  throw new Error('oh, hello there!');
};

If you also want to trace performance of all the incoming requests and also outgoing AWS service requests, just set the tracesSampleRate option.

import * as Sentry from '@sentry/aws-serverless';

Sentry.init({
  dsn: '__DSN__',
  tracesSampleRate: 1.0,
});

Integrate Sentry using the Sentry Lambda layer

Another much simpler way to integrate Sentry to your AWS Lambda function is to add the official layer.

• Choose Layers -> Add Layer.
• Specify an ARN: arn:aws:lambda:us-west-1:943013980633:layer:SentryNodeServerlessSDKv10:19. Get the latest ARN from the docs.
• Go to Environment variables and add:
  • NODE_OPTIONS: --import @sentry/aws-serverless/awslambda-auto.
  • SENTRY_DSN: your dsn.
  • SENTRY_TRACES_SAMPLE_RATE: a number between 0 and 1 representing the chance a transaction is sent to Sentry. For more information, see docs.