sentry-laravel

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.5.1.

Bug Fixes

• Prevent registering terminating callback multiple times and guard against finishing already finished transactions (#717)

  This fixes the Call to a member function finish() on null that could occur when using long running processes like on the CLI or with Laravel Octane.

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.5.0.

Features

• Improve terminating callbacks visibility (#707)

  This adds support for performance traces that happen after the terminable middleware emits the response.

• Add http.route.response span (#708)

  Note: This feature requires Laravel >= 10.13.0 to hail any new spans.

  This will add a http.route.response span which identifies possible actions taken to prepare the response, especially when using Illuminate\Contracts\Support\Responsable classes.

Bug Fixes

• Refactor queue integration (#692)

  This improves and fixes some edge cases around scope management when running Laravel Queues.

• Improve lazyLoadingViolationReporter helper (#709)

  Check for $model->exists and $model->wasRecentlyCreated before capturing the event.

Misc

• Bump the underlying PHP SDK to version ^3.19 to enforce an upgrade to fix an issue in libcurl >= v8.1.0 (#711)

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.4.1.

Bug Fixes

• Fix missing sentryMonitor macro if no DSN is set (#698)

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.4.0.

Features

• Add helper to report lazy loading violations (#678)

  We've added a new helper that makes reporting lazy loading violation to Sentry in production very easy:

  // See: https://laravel.com/docs/10.x/eloquent-relationships#preventing-lazy-loading
  \Illuminate\Database\Eloquent\Model::preventLazyLoading();
  
  // In production we just report the lazy loading violation instead of crashing the application since it's a performance issue not a security issue
  if (app()->isProduction()) {
    \Illuminate\Database\Eloquent\Model::handleLazyLoadingViolationUsing(
      \Sentry\Laravel\Integration::lazyLoadingViolationReporter(),
    );
  }
  

  We let you know which model and relation caused the lazy loading violation and we also include the origin of the violation so you can find the culprit quickly.

• Reintroduce Laravel Lumen support (#685)

  We dropped support for Laravel Lumen (10.x) in v3.0.0, but we are happy to announce that it is back!

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.3.3.

Bug Fixes

• Fix CheckIn constructor argument order (#680)
• Fix missing breadcrumbs for jobs throwing an exception (#633)

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.3.2.

Bug Fixes

• Fix "Object of class Closure could not be converted to string" error when tracing redis_commands (#668)

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.3.1.

Bug Fixes

• Fix scheduled commands running in the background not reporting success/failure (#664)

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.3.0.
This release adds initial support for Cron Monitoring as well as new performance spans and breadcrumbs.

Warning
Cron Monitoring is currently in beta. Beta features are still in-progress and may have bugs. We recognize the irony.
If you have any questions or feedback, please email us at [email protected], reach out via Discord (#cronjobs), or open an issue.

Features

• Add inital support for Cron Monitoring (#659)

  After creating your Cron Monitor on https://sentry.io, you can add the sentryMonitor() macro to your scheduled tasks defined in your app/Console/Kernel.php file.
  This will let Sentry know if your scheduled task started, whether the task was successful or failed, and its duration.

  protected function schedule(Schedule $schedule)
  {
      $schedule->command('emails:send')
          ->everyHour()
          ->sentryMonitor('<your-monitor-slug>'); // add this line
  }
  

• Add Livewire tracing integration (#657)

  You can enable this feature by adding new config options to your config/sentry.php file.

  'breadcrumbs' => [
      // Capture Livewire components in breadcrumbs
      'livewire' => true,
  ],
  'tracing' => [
      // Capture Livewire components as spans
      'livewire' => true,
  ],
  

• Add Redis operation spans & cache event breadcrumbs (#656)

  You can enable this feature by adding new config options to your config/sentry.php file.

  'breadcrumbs' => [
      // Capture Laravel cache events in breadcrumbs
      'cache' => true,
  ],
  'tracing' => [
      // Capture Redis operations as spans (this enables Redis events in Laravel)
      'redis_commands' => env('SENTRY_TRACE_REDIS_COMMANDS', false),
  
      // Try to find out where the Redis command originated from and add it to the command spans
      'redis_origin' => true,
  ],
  
  

• Add HTTP client request breadcrumbs (#640)

  You can enable this feature by adding a new config option to your config/sentry.php file.

  'breadcrumbs' => [
      // Capture HTTP client requests information in breadcrumbs
      'http_client_requests' => true,
  ],
  
  

• Offer the installation of a JavaScript SDK when running sentry:publish (#647)

Bug Fixes

• Fix a log channel context crash when unexpected values are passed (#651)

Misc

• The SDK is now licensed under MIT (#654)
  • Read more about Sentry's licensing here.

The Sentry SDK team is happy to announce the immediate availability of Sentry Laravel SDK v3.2.0.
This release adds support for Laravel 10.

Features

• Add support for Laravel 10 (#630)
  • Thanks to @jnoordsij for their contribution.
• Add tracing.http_client_requests option (#641)

  • You can now disable HTTP client tracing in your config/sentry.php file

    'tracing' => [
        'http_client_requests' => true|false, // This feature is enabled by default
    ],
    

• Increase debug trace limit count to 20 in Integration::makeAnEducatedGuessIfTheExceptionMaybeWasHandled() (#622)
  • Look futher into the backtrace to check if report() was called.
• Run the testsuite against PHP 8.2 (#624)

• Set traces_sample_rate to null by default (#616)

  • Make sure to update your config/sentry.php.

    Replace

    'traces_sample_rate' => (float)(env('SENTRY_TRACES_SAMPLE_RATE', 0.0)),
    

    with

    'traces_sample_rate' => env('SENTRY_TRACES_SAMPLE_RATE') === null ? null : (float)env('SENTRY_TRACES_SAMPLE_RATE'),
    

• Fix exceptions sent via the report() helper being marked as unhandled (#617)

• Fix missing scope information on unhandled exceptions (#611)

• Unhandled exceptions are now correctly marked as handled: false and displayed as such on the issues list and detail page (#608)
  • Make sure to update your App/Exceptions/Handler.php file to enable this new behaviour. See https://docs.sentry.io/platforms/php/guides/laravel/

• Remove incorrect checks if performance tracing should be enabled and rely on the transaction sampling decision instead (#600)
• Fix SENTRY_RELEASE .env variable not working when using config caching (#603)

New features

• We are now creating more spans to give you better insights into the performance of your application
  • Add a http.client span. This span indicates the time that is spent when using the Laravel HTTP client (#585)
  • Add a http.route span. This span indicates the time that is spent inside a controller method or route closure (#593)
  • Add a db.transaction span. This span indicates the time that is spent inside a database transaction (#594)
• Add support for Dynamic Sampling
  • Add support for Dynamic Sampling (#572)

Breaking changes

• Laravel Lumen is no longer supported
  • Drop support for Laravel Lumen (#579)
• Laravel versions 5.0 - 5.8 are no longer supported
  • Drop support for Laravel 5.x (#581)
• Remove Sentry\Integration::extractNameForRoute(), it's alternative Sentry\Integration::extractNameAndSourceForRoute() is marked as @internal (#580)
• Remove internal Sentry\Integration::currentTracingSpan(), use SentrySdk::getCurrentHub()->getSpan() if you were using this internal method (#592)

Other changes

• Set the tracing transaction name on the Illuminate\Routing\Events\RouteMatched instead of at the end of the request (#580)
• Remove extracting route name or controller for transaction names (#583). This unifies the transaction names to a more concise format.
• Simplify Sentry meta tag retrieval, by adding Sentry\Laravel\Integration::sentryMeta() (#586)
• Fix tracing with nested queue jobs (mostly when running jobs in the sync driver) (#592)

• Fix extracting command input resulting in errors when calling Artisan commands programatically with null as an argument value (#589)

• Fix not setting the correct SDK ID and version when running the sentry:test command (#582)

• Fix not listening to queue events because QueueManager is registered as queue in the container and not by it's class name (#568)
• Fix status code not populated on transaction if response did not inherit from Illuminate\Http\Response like Illuminate\Http\JsonResponse (#573)
• Align Span Operations with new spec (#574)
• Fix broken SetRequestMiddleware on Laravel < 6.0 (#575)
• Also extract the authenticated user email and username attributes if available (#577)

• Only catch BindingResolutionException when trying to get the PSR-7 request object from the container

• Fix incorrect release and environment values when using the sentry:test command