sentry / sentry-bref
Bref SDK for Sentry (https://sentry.io)
Requires
- php: ^8.2
- bref/bref: ^3.0.13
- bref/logger: ^1 | ^2
- psr/http-server-middleware: ^1.0
- sentry/sentry: ^4.33
Requires (Dev)
- aws/aws-sdk-php: ^3
- bref/laravel-bridge: ^3
- friendsofphp/php-cs-fixer: ^3.95
- laravel/framework: ^12 | ^13
- phpstan/phpstan: ^2
- phpunit/phpunit: ^9
- sentry/sentry-laravel: ^4.28
- symfony/dependency-injection: ^6.4 | ^7 | ^8
- symfony/event-dispatcher: ^6.4 | ^7 | ^8
- symfony/http-kernel: ^6.4 | ^7 | ^8
Suggests
- sentry/sentry-laravel: For Laravel applications: Lambda contexts and cold starts in Laravel's transactions
- sentry/sentry-symfony: For Symfony applications: cold starts in Symfony's transactions
Provides
None
Conflicts
- laravel/framework: <12
- symfony/http-foundation: <6.4
- symfony/http-kernel: <6.4
Replaces
None
This package is not auto-updated.
Last update: 2026-10-31 08:33:51 UTC
README
Bad software is everywhere, and we're tired of it. Sentry is on a mission to help developers write better software faster, so we can get back to enjoying technology. If you want to join us Check out our open positions
Official Sentry integration for Bref
This is the official Sentry integration for Bref, to monitor PHP applications running on AWS Lambda. It adds to the Sentry SDK for PHP, Laravel or Symfony:
- Lambda errors that happen outside of PHP-FPM: timeouts, responses too large, etc.
- Exceptions and transactions for event handlers (SQS, EventBridge, S3, etc.).
- Cold starts in transactions.
- AWS SDK calls as spans and breadcrumbs.
Getting Started
Install
First, set up Sentry in your application: PHP, Laravel or Symfony.
Then install the sentry/sentry-bref package:
composer require sentry/sentry-bref
Configure
Laravel: there is nothing to configure, the service provider is discovered automatically.
Symfony: register the bundle in config/bundles.php:
return [ // ... Sentry\Bref\Symfony\BrefSentryBundle::class => ['all' => true], ];
Other frameworks: add the Sentry\Bref\Psr15\BrefSentryMiddleware PSR-15 middleware to your HTTP middleware stack.
To learn more about how to use the integration, refer to our docs.
Getting help/support
If you need help setting up or configuring the Bref integration (or anything else in the Sentry universe) please head over to the Sentry Community on Discord. There is a ton of great people in our Discord community ready to help you!
Resources
License
Licensed under the MIT license, see LICENSE.