About Sentry Extra
This is a MODX Extra that provides a Sentry integration for MODX Revolution.
Information
Released
July 11, 2024
Supported Database
MySQL
License
MIT
Instructions
Installation
sentry.dsn
setting to the DSN you copied in step 3sentry.environment
setting to the environment you want to use (e.g. production
)Usage
The extra will automatically log all errors to Sentry. You can also log messages manually:
MODX 2.x
$sentry = $modx->getService('sentryextra', 'SentryExtra', $modx->getOption('sentryextra.core_path', null, $modx->getOption('core_path') . 'components/sentryextra/') . 'model/sentryextra/');
if ($sentry) $sentry->log(xPDO::LOG_LEVEL_ERROR, 'This is a test error message');
MODX 3.x
$sentry = $modx->services->get('sentryextra');
if ($sentry) $sentry->log(xPDO::LOG_LEVEL_ERROR, 'This is a test error message');
Additional System Settings
sentry.traces_sample_rate
(default:0.1
) - The percentage of errors that should be sent to Sentry. This is useful for testing the integration without spamming Sentry with errors (So, for example, if you set traces_sample_rate to 0.2, approximately 20% of your transactions will get recorded and sent.).sentry.keep_error_log
(default:1
) - If set to1
, the PHP Errors will not be cleared after sending the errors to Sentry. This has no effect on events that call$modx->log()
directly.
New in 1.1.0-pl
- Upgrade Sentry SDK to 4.8.0
- Add option to disable PHP Warnings and Notices