Description

This plugin can report PHP errors (optionally) and JavaScript errors (optionally) to Sentry and integrates with its release tracking.

It will auto detect authenticated users and add context where possible. All context/tags can be adjusted/expanded using filters.

For more information and documentation have a look at the README.md file.

Contributors

See: github.com/stayallive/wp-sentry/graphs/contributors

Installation

Install this plugin by cloning or copying this repository to your wp-contents/plugins folder
Configure your DSN as explained below
Activate the plugin through the WordPress admin interface

For more information and documentation have a look at the README.md file.

Note: this plugin does not do anything by default and has only a admin interface to test the integration. A Sentry DSN must be configured in your wp-config.php.

(Optionally) track PHP errors by adding this snippet to your wp-config.php and replace PHP_DSN with your actual DSN that you find inside Sentry in the project settings under “Client Keys (DSN)”:

define( 'WP_SENTRY_PHP_DSN', 'PHP_DSN' );

Note: Do not set this constant to disable the PHP tracker.

Note: This constant was previously called WP_SENTRY_DSN and is still supported.

(Optionally) set the error types the PHP tracker will track:

define( 'WP_SENTRY_ERROR_TYPES', E_ALL & ~E_DEPRECATED & ~E_NOTICE & ~E_USER_DEPRECATED );

(Optionally) If this flag is enabled, certain personally identifiable information is added by active integrations. Without this flag they are never added to the event, to begin with.

If possible, it’s recommended to turn on this feature and use the server side PII stripping to remove the values instead.

When enabled the current logged in user and IP address will be added to the event.

define( 'WP_SENTRY_SEND_DEFAULT_PII', true );

(Optionally) track JavaScript errors by adding this snippet to your wp-config.php and replace JS_DSN with your actual DSN that you find inside Sentry in the project settings under “Client Keys (DSN)”:

define( 'WP_SENTRY_BROWSER_DSN', 'JS_DSN' );

Note: Do not set this constant to disable the JavaScript tracker.

Note: This constant was previously called WP_SENTRY_PUBLIC_DSN and is still supported.

(Optionally) define a version of your site; by default the theme version will be used. This is used for tracking at which version of your site the error occurred. When combined with release tracking this is a very powerful feature.

define( 'WP_SENTRY_VERSION', 'v4.10.3' );

(Optionally) define an environment of your site. Defaults to unspecified.

define( 'WP_SENTRY_ENV', 'production' );

For more information and documentation have a look at the README.md file.

Reviews

laugau October 15, 2021

It works like a charm ! Thank you so much 🙂

Filipe Chaves April 29, 2021

The support is very quick and the code is very pretty, I like a lot this plugin! Congrats for the job done!

Karolina Vyskocilova March 9, 2021

WP Sentry is a great integration of Sentry for WP needs with extensive documentation which is easy to use. And in case you need it the support is great. Thanks a lot, Alex!

morvy February 8, 2021

Just by adding some simple constants I can see errors on the website and I can react immediately. Having all the info in sentry thanks to this plugin is just great and it saves so much time in debugging the issues. After v.4 update, you can see some browser "network tab" stats so you can identify what takes so much time to load on your website in real world, not just your top-spec computer with broadband internet ..

Robin September 2, 2020

Works like a charm.

Richard Sweeney May 29, 2020

Perfect, this just works perfectly with zero setup. Fantastic!

Read all 11 reviews

Contributors & Developers

“WordPress Sentry” is open source software. The following people have contributed to this plugin.

Alex

Translate “WordPress Sentry” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.10.3

Fix possible composer autoloader conflict with Sentry SDK helpers file

4.10.2

Fix problem loading plugin in wp-config.php with browser DSN enabled

4.10.1

Fix Interface 'Stringable' not found on PHP < 8.0
Fix problem loading plugin in wp-config.php without WP_SENTRY_VERSION defined

4.10.0

Allow loading the plugin from wp-config.php before WordPress is loaded (see documentation) (thanks @ocean90)
Add support for modifying the Sentry PHP SDK ClientBuilder builder (see documentation)

4.9.0

Update Sentry Browser to version 6.15.0

4.8.0

Update PHP SDK to version 3.3.4
Update Sentry Browser to version 6.14.1

4.7.0

Update PHP SDK to version 3.3.3
Update Sentry Browser to version 6.13.2

4.6.0

Update PHP SDK to version 3.3.2
Update Sentry Browser to version 6.11.0

4.5.0

Update Sentry Browser to version 6.8.0

4.4.1

Update PHP SDK to version 3.3.1
Update Sentry Browser to version 6.7.2

4.4.0

Update PHP SDK to version 3.3.0
Update Sentry Browser to version 6.7.0

4.3.0

Update PHP SDK to version 3.2.1
Update Sentry Browser to version 6.3.4

4.2.0

Update PHP SDK to version 3.1.5
Update Sentry Browser to version 6.2.0

4.1.1

Allow overwriting the integrations array using the JavaScript wp_sentry_hook callback

4.1.0

Add WP_SENTRY_BROWSER_TRACES_SAMPLE_RATE option to enable browser performance tracing
Update PHP SDK to version 3.1.4
Update Sentry Browser to version 6.1.0

4.0.1

Rereleased 4.0.0 to fix issue with missing dependencies folder, see 4.0.0 changelog for changes!

4.0.0

Note: This is a breaking release for the PHP SDK, please test it well and read the migration guides if applicable before upgrading!

If you are doing anything more than just have this plugin installed and a DSN defined on your wp-config.php, check out the upgrade docs:

PHP SDK: https://github.com/getsentry/sentry-php/blob/master/UPGRADE-3.0.md

Becasue of the upgrade to the 3.x version of the PHP SDK this plugin now has the requirement that it runs on at least PHP 7.2, for older PHP versions stick to version 3.x.

Drop PHP 7.1 support and add PHP 8.0 support
Update PHP SDK to version 3.1.3
Update Sentry Browser to version 6.0.3

3.11.1

Fix missing files in the release

3.11.0

Update PHP SDK to version 2.5.0
Update Sentry Browser to version 5.27.3

3.10.0

Update PHP SDK to version 2.4.2
Update Sentry Browser to version 5.20.0

3.9.0

Update PHP SDK to version 2.4.1
Update Sentry Browser to version 5.19.2

3.8.0

Update Sentry Browser to version 5.18.1
Admin test page will now show for users with the activate_plugins capability (instead of install_plugins) to support sites that have install_plugins disabled globally
Rename public/sentry-browser-<Sentry Browser version>.min.js to public/wp-sentry-browser.min.js, this change should have no user impact unless you manually include that file
Renamed WP_SENTRY_DSN to WP_SENTRY_PHP_DSN, both will be supported but the latter is preferred because of it’s more descriptive name
Renamed WP_SENTRY_PUBLIC_DSN to WP_SENTRY_BROWSER_DSN, both will be supported but the latter is preferred because of it’s more descriptive name

3.7.0

Update PHP SDK to version 2.4.0
Update Sentry Browser to version 5.17.0

3.6.0

Update Sentry Browser to version 5.15.5
Added a way to filter the Browser SDK options and/or disable loading the Browser SDK using JavaScript (https://github.com/stayallive/wp-sentry/blob/v3.6.0/README.md#advanced-client-side-hook)

3.5.1

Fix scope data (user context & tags etc.) being lost when set before the after_setup_theme hook

3.5.0

Remove undocumented WP_SENTRY_PROJECT_ROOT option
Set a default for prefixes to get cleaner file paths on PHP stack traces

3.4.6

Fix the Monolog namespace being incorrectly scoped causing errors when using the \Sentry\Monolog\Handler class

3.4.5

Fix Call to undefined function getallheaders() error on PHP versions below 7.3

3.4.4

Remove extra files from WordPress plugin release
Fix fatal error caused by composer autoloader when including Sentry sources in other composer autoloader

3.4.3

Fix fatal error caused by composer autoloader conflicts with other plugins

3.4.2

Add button to admin page to test JavaScript integration

3.4.1

Important: In this release we start using a process to prefix our dependencies to prevent conflicts with other WordPress plugins.
This should cause no problems, but if they do please open up a support ticket or GitHub issue with details about your environment.

Fixes issue in build process causing missing files in 3.4.0

3.4.0

Update PHP SDK to version 2.3.2
Update Sentry Browser to version 5.15.4

3.3.0

Update PHP SDK to version 2.3.1
Update Sentry Browser to version 5.12.4

3.2.0

Add admin page (Tools > WP Sentry) to test if the Sentry integration is enabled and working (props @federicobond)

3.1.0

Update PHP SDK to version 2.2.6
Update Sentry Browser to version 5.10.2

3.0.4

Fixed error when WP_SENTRY_VERSION is not defined and theme version returns false.
Update PHP SDK to version 2.2.2

3.0.3

Use the ABSPATH constant as default project root.

3.0.2

Show a notice that we only support PHP 7.1+ instead of letting 7.1 code break the site.

3.0.1

Just a version bump because a version number was not correctly updated.

3.0.0

Note: This is a breaking release for both the PHP SDK and the Browser SDK, please test it well and read the migration guides if applicable before upgrading!

If you are doing anything more than just have this plugin installed and a DSN defined on your wp-config.php, check out the upgrade docs:

PHP SDK: https://github.com/getsentry/sentry-php/blob/master/UPGRADE-2.0.md
Browser SDK: https://github.com/getsentry/sentry-javascript/blob/master/MIGRATION.md#upgrading-from-4x-to-5x

Becasue of the upgrade to the 2.x version of the PHP SDK this plugin now has the requirement that it runs on at least PHP 7.1, for older PHP versions stick to version 2.x.

Update PHP SDK to version 2.2.1
Update Sentry Browser to version 5.6.3

2.8.0

Update Sentry Browser to version 4.6.6

2.7.2

Remove unneeded files from the plugin download

2.7.1

Fix IE compatibility for JS integration
Update Sentry Browser to version 4.5.0

2.7.0

This release might contain breaking changes if you are using the wp_sentry_public_options filter.

Update wp_sentry_public_options filter to support the Sentry Browser SDK better (#28)
Update Sentry Browser to version 4.4.2
Update Raven PHP to version 1.10.0

2.6.1

Update Sentry Browser to version 4.3.2

2.6.0

If you are doing custom calls to Sentry from your front-end make sure you check out the new docs and migration instructions: https://github.com/getsentry/sentry-javascript/releases/tag/4.0.0

If you are not doing anything custom to the JS side of the SDK you can safely upgrade to this version.

Upgrade Raven JS to Sentry Browser version 4.2.3
Tested on WordPress 5.0

2.5.0

Update Raven JS to version 3.27.0
Update Raven PHP to version 1.9.2

2.4.0

Update Raven JS to version 3.26.3
Update Raven PHP to version 1.9.1

This version allows the usage of the new private key-less DSN introduced in Sentry 9.

2.3.0

Update Raven JS to version 3.24.2
Update Raven PHP to version 1.9.0

2.2.0

Change minimum PHP requirement to 5.4

2.1.5

“Fix” PHP 5.3 support (this will be the last version supporting PHP 5.3)
Update Raven JS to version 3.22.0

2.1.4

Update Raven JS to version 3.21.0
Update Raven PHP to version 1.8.2

2.1.3

Tested up to WordPress 4.9
Update Raven PHP to version 1.8.1

2.1.2

Update Raven PHP to version 1.8.0

2.1.0

Switch to a composer based plugin setup (@LeoColomb)
Update Raven JS to version 3.19.1

2.0.18

Update Raven PHP to version 1.7.1 (@ikappas)
Update Raven JS to version 3.17.0 (@ikappas)

2.0.17

Update Raven JS to version 3.16.0
Update documentation on how to use as a mu-plugin

2.0.16

Update Raven JS to version 3.15.0 (@hjanuschka)
Update Raven PHP to version 1.7.0

2.0.15

Update Raven JS to version 3.13.1

2.0.14

Update Raven JS to version 3.13.0

2.0.13

Update Raven JS to version 3.12.0

2.0.12

Allow the error_types option to be configured from wp-config.php
Fire the wp_sentry_options after the after_setup_theme action if it’s defined

2.0.11

Update Raven JS to version 3.11.0

2.0.10

Update Raven JS to version 3.10.0 (@ikappas)

2.0.9

Update Raven PHP to version 1.6.2 (@mckernanin)

2.0.8

Fix setting the context on the JS SDK

2.0.7

Update Raven JS to version 3.9.1

2.0.6

Update Raven JS to version 3.9.0

2.0.4

Re-release to fix SVN issues

2.0.0

Complete rewrite of the plugin for better integration (@ikappas)
Updated Raven JS tracker to version 3.8.0 (@ikappas)

1.0.1

Fix WP_SENTRY_VERSION already defined error (@ikappas)

1.0.0

Initital release

WordPress.org

Description

Contributors

Installation

Reviews

Contributors & Developers

Interested in development?

Changelog

4.10.3

4.10.2

4.10.1

4.10.0

4.9.0

4.8.0

4.7.0

4.6.0

4.5.0

4.4.1

4.4.0

4.3.0

4.2.0

4.1.1

4.1.0

4.0.1

4.0.0

3.11.1

3.11.0

3.10.0

3.9.0

3.8.0

3.7.0

3.6.0

3.5.1

3.5.0

3.4.6

3.4.5

3.4.4

3.4.3

3.4.2

3.4.1

3.4.0

3.3.0

3.2.0

3.1.0

3.0.4

3.0.3

3.0.2

3.0.1

3.0.0

2.8.0

2.7.2

2.7.1

2.7.0

2.6.1

2.6.0

2.5.0

2.4.0

2.3.0

2.2.0

2.1.5

2.1.4

2.1.3

2.1.2

2.1.0

2.0.18

2.0.17

2.0.16

2.0.15

2.0.14

2.0.13

2.0.12

2.0.11

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

2.0.4

2.0.0

1.0.1