README

Pushes Craft CMS errors to Sentry.

Installation

Plugin Store

1. Search for 'Sentry SDK'.
2. Hit install
3. Create a config file as explained below.

Composer

1. Run: composer require roelvanhintum/craft-sentry
2. Hit install in Admin > Settings > Plugins
3. Create a config file as explained below.

Requirements

• Craft 4.0.0 and up
• PHP 8.0.2 and up

Configuring Sentry

Create a config/sentry-sdk.php config file with the following contents:

<?php

return [
 '*' => [
 'enabled' => true,
 'anonymous' => false, // Determines to log user info or not
 'clientDsn' => getenv('SENTRY_DSN') ?: 'https://example@sentry.io/123456789', // Set as string or use environment variable.
 'clientKey' => getenv('SENTRY_CLIENT_KEY') ?: 'z987654321a', // https://js.sentry-cdn.com/z987654321a.min.js
 'excludedCodes' => ['400', '404', '429'],
 'release' => getenv('SENTRY_RELEASE') ?: null, // Release number/name used by sentry.
 'reportJsErrors' => false,
 'sampleRate' => 1.0,
 'ignoreErrors' => [
 // Email link Microsoft Outlook crawler compatibility error
 // cf. https://forum.sentry.io/t/unhandledrejection-non-error-promise-rejection-captured-with-value/14062
 "Non-Error promise rejection captured with value: Object Not Found Matching Id:",
 ]
 ],
];

Credits

Based upon the sentry plugin by Luke Youell.