@payloadcms/plugin-sentry
TypeScript icon, indicating that this package has built-in type declarations

0.0.6 • Public • Published

Sentry Plugin for Payload

This plugin seamlessly integrates Sentry with Payload for performance monitoring and error tracking.

Installation

  yarn add @payloadcms/plugin-sentry
  # OR
  npm i @payloadcms/plugin-sentry

Basic Usage

  1. Import sentry from '@payloadcms/plugin-sentry'
  2. Add it to the plugins array of your Payload config
  3. Pass in your Data Source Name (DSN)
  4. Pass additional options - not required
import { buildConfig } from 'payload/config'
import { sentry } from '@payloadcms/plugin-sentry'
import { Pages, Media } from './collections'

const config = buildConfig({
  collections: [Pages, Media],
  plugins: [
    sentry({
      dsn: 'https://61edebas777889984d323d777@o4505289711681536.ingest.sentry.io/4505357433352176',
    }),
  ],
})

export default config

Options

Data Source Name (DSN) and where to find it

Additional Options

  • enabled: boolean | optional

    Set to false to disable the plugin. Defaults to true.

  • init : ClientOptions | optional

    Sentry allows a variety of options to be passed into the Sentry.init() function, see the full list of options here.

  • requestHandler : RequestHandlerOptions | optional

    Accepts options that let you decide what data should be included in the event sent to Sentry, checkout the options here.

  • captureErrors: number[] | optional

    By default, Sentry.errorHandler will capture only errors with a status code of 500 or higher. To capture additional error codes, pass the values as numbers in an array.

You can configure any of these options by passing them to the plugin under options:

import { buildConfig } from 'payload/config'
import { sentry } from '@payloadcms/plugin-sentry'
import { Pages, Media } from './collections'

const config = buildConfig({
  collections: [Pages, Media],
  plugins: [
    sentry({
      dsn: 'https://61edebas777889984d323d777@o4505289711681536.ingest.sentry.io/4505357433352176',
      options: {
        init: {
          debug: true,
          environment: 'development',
          tracesSampleRate: 1.0,
        },
        requestHandler: {
          serverName: false,
          user: ['email'],
        },
        captureErrors: [400, 403, 404],
      },
    }),
  ],
})

export default config

To learn more about these options and when to use them, visit the Sentry Docs.

TypeScript

All types can be directly imported:

import { PluginOptions } from '@payloadcms/plugin-sentry/types'

Development

To actively develop or debug this plugin you can either work directly within the demo directory of this repo, or link your own project.

Internal Demo

This repo includes a demo of Payload that installs the plugin directly from the source code. This is the easiest way to get started. To spin up this demo, follow these steps:

  1. First clone the repo
  2. Then, cd plugin-sentry && yarn && cd dev && yarn && yarn dev
  3. Now open http://localhost:3000/admin in your browser
  4. Create a new user and sign in
  5. Use the buttons to throw test errors

That's it! Changes made in ./src will be reflected in the demo.

Package Sidebar

Install

npm i @payloadcms/plugin-sentry

Weekly Downloads

1,940

Version

0.0.6

License

MIT

Unpacked Size

28.8 kB

Total Files

22

Last publish

Collaborators

  • jesschow
  • jarrodmflesch
  • danribbens
  • elliotpayload
  • jacobsfletch
  • payloadjs