NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #515 most downloaded on Packagist
Symfony integration for Sentry (http://getsentry.com)
Latest stable
5.15.0
Last release 24 days ago
29 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
107 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.15.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.15.0.
Add the experimental register_monolog_handler option, which captures errors through the Monolog channels Symfony reports them to instead of the SDK's global error handlers. (#1092)
sentry:
register_error_listener: false
register_error_handler: false
register_monolog_handler: true
Add the $includeChannel argument to the Monolog LogsHandler, which attaches the Monolog channel as a channel attribute to logs. (#1091)
services:
Sentry\SentryBundle\Monolog\LogsHandler:
arguments:
$level: !php/const Monolog\Logger::WARNING
$includeChannel: true
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.14.0.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.14.0.
Add the data_collection option to control which potentially sensitive data the SDK attaches to events and spans. (#1087)
sentry:
options:
data_collection:
user_info: true
http_headers:
mode: allowList
terms:
- x-request-id
http_bodies: []
database_query_data: false
sentry-php version to 4.34.0. (#1087)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.13.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.13.0.
sentry-php version to 4.31.0. (#1053)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.12.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.12.0.
guzzlehttp/psr7 3.x for Guzzle 8 compatibility. (#1046)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.11.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.11.0.
sentry_trace_meta() and sentry_baggage_meta() helpers. (#1025)RequestFetcher during kernel termination even when no transaction is set on the hub. (#1026)security.untracked_token_storage service in LoginListener. (#1028)Remove the deprecated traceparent header.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.10.0.
strict_trace_continuation and org_id to continue incoming traces only when they belong to the same Sentry organization. (#1002)ConsoleInputSerializer to capture console command arguments and options via class_serializers. (#1007)log_flush_threshold to flush logs once a configured batch size is reached. (#1012)Sentry\Integration\OTLPIntegration. (#1014)tracing.dbal.ignore_prepare_spans to suppress db.sql.prepare spans for prepared queries. (#1016)messenger.isolate_context_by_message to prevent scope, logs, and metrics data from leaking across messages. (#997)traceparent header. (#1005)sentry-php version to 4.23.0. (#1012)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.9.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.9.0.
sentry-php version to 4.20.0. (#996)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.3.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.3.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.2.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.2.
symfony/yaml to a non-dev dependency. (#983)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.1.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.1.
before_send_metric and enable_metrics. (#981)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.8.0.
// Counter metric
\Sentry\trace_metrics()->count('test-counter', 10, ['my-attribute' => 'foo']);
// Gauge metric
\Sentry\trace_metrics()->gauge('test-gauge', 50.0, ['my-attribute' => 'foo'], \Sentry\Unit::millisecond());
// Distribution metric
\Sentry\trace_metrics()->distribution('test-distribution', 20.0, ['my-attribute' => 'foo'], \Sentry\Unit::kilobyte());
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.7.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.6.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.6.0.
max_breadcrumbs option. (#953)services:
Sentry\SentryBundle\Monolog\LogsHandler:
arguments:
- 'info'
# or using PSR constants
services:
Sentry\SentryBundle\Monolog\LogsHandler:
arguments:
- !php/const Psr\Log\LogLevel::INFO
// or via PHP config
$container->services()
->set(\Sentry\SentryBundle\Monolog\LogsHandler::class)
->args([\Monolog\Level::Info]);
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.5.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.5.0.
sentry:
messenger:
isolate_breadcrumbs_by_message: true
services:
App\IntegrationCallback:
factory: ['App\IntegrationCallback', 'factory']
sentry:
options:
integrations: 'App\IntegrationCallback'
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.4.1.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.4.1.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.4.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.4.0.
sentry:
options:
enable_logs: true
services:
Sentry\SentryBundle\Monolog\LogsHandler:
arguments:
- !php/const Monolog\Logger::INFO
monolog:
handlers:
sentry_logs:
type: service
id: Sentry\SentryBundle\Monolog\LogsHandler
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.3.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.3.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.3.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.2.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.2.0.
Allow to configure the logger via the sentry.yaml configuration file (#899)
sentry:
dsn: "%env(SENTRY_DSN)%"
options:
logger: "sentry.logger"
services:
sentry.logger:
class: 'Sentry\Logger\DebugFileLogger'
arguments:
$filePath: '../../var/log/sentry.log'
symfony/security-core and symfony/security-http as dependencies (#912)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.1.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v5.0.1.
Please refer to the UPGRADE-5.0.md guide for a complete list of breaking changes.
The Sentry SDK team is thrilled to announce the immediate availability of Sentry Symfony SDK v5.0.0.
Please refer to the UPGRADE-5.0.md guide for a complete list of breaking changes.
This version adds support for the underlying Sentry PHP SDK v4.0. Please refer to the PHP SDK sentry-php/UPGRADE-4.0.md guide for a complete list of breaking changes.
This version exclusively uses the envelope endpoint to send event data to Sentry.
If you are using sentry.io, no action is needed.
If you are using an on-premise/self-hosted installation of Sentry, the minimum requirement is now version >= v20.6.0.
You need to have ext-curl installed to use the SDK.
The IgnoreErrorsIntegration integration was removed. Use the ignore_exceptions option instead.
Previously, both Symfony\Component\ErrorHandler\Error\FatalError and Symfony\Component\Debug\Exception\FatalErrorException were ignored by default.
To continue ignoring these exceptions, make the following changes to the config file:
// config/packages/sentry.yaml
sentry:
options:
ignore_exceptions:
- 'Symfony\Component\ErrorHandler\Error\FatalError'
- 'Symfony\Component\Debug\Exception\FatalErrorException'
This option performs an is_a check now, so you can also ignore more generic exceptions.
Add support for Sentry Developer Metrics (#1619)
use function Sentry\metrics;
// Add 4 to a counter named hits
metrics()->increment(key: 'hits', value: 4);
// Add 25 to a distribution named response_time with unit milliseconds
metrics()->distribution(key: 'response_time', value: 25, unit: MetricsUnit::millisecond());
// Add 2 to gauge named parallel_requests, tagged with type: "a"
metrics()->gauge(key: 'parallel_requests', value: 2, tags: ['type': 'a']);
// Add a user's email to a set named users.sessions, tagged with role: "admin"
metrics()->set('users.sessions', 'jane.doe@example.com', null, ['role' => User::admin()]);
Metrics are automatically sent to Sentry at the end of a request, hooking into Symfony's kernel.terminate event.
Add new fluent APIs (#1601)
// Before
$transactionContext = new TransactionContext();
$transactionContext->setName('GET /example');
$transactionContext->setOp('http.server');
// After
$transactionContext = (new TransactionContext())
->setName('GET /example');
->setOp('http.server');
Simplify the breadcrumb API (#1603)
// Before
\Sentry\addBreadcrumb(
new \Sentry\Breadcrumb(
\Sentry\Breadcrumb::LEVEL_INFO,
\Sentry\Breadcrumb::TYPE_DEFAULT,
'auth', // category
'User authenticated', // message (optional)
['user_id' => $userId] // data (optional)
)
);
// After
\Sentry\addBreadcrumb(
category: 'auth',
message: 'User authenticated', // optional
metadata: ['user_id' => $userId], // optional
level: Breadcrumb::LEVEL_INFO, // set by default
type: Breadcrumb::TYPE_DEFAULT, // set by default
);
New default cURL HTTP client (#1589)
The SDK now ships with its own HTTP client based on cURL. A few new options were added.
// config/packages/sentry.yaml
sentry:
options:
- http_proxy_authentication: 'username:password' // user name and password to use for proxy authentication
- http_ssl_verify_peer: false // default true, verify the peer's SSL certificate
- http_compression: false // default true, http request body compression
To use a different client, you may use the http_client option.
To use a different transport, you may use the transport option. A custom transport must implement the TransportInterface.
If you use the transport option, the http_client option has no effect.
php-http/message-factory was removed.The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.14.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.13.2.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.13.2.
symfony/http-client (#797)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.13.1.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.13.1.
http_client service is registered (#792)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.13.0.
Add support for symfony/psr-http-message-bridge: ^6.4
Silence TokenInterface::isAuthenticated deprecation in LoginListener
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.10.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.10.0.
Tracing without Performance (#742)
The SDK will now continue a trace from incoming HTTP requests, even if performance is not enabled. To continue a trace outward, you may attach the Sentry tracing headers to any HTTP client request. You can fetch the required header values by calling \Sentry\getBaggage() and \Sentry\getTraceparent().
Add ignore_exceptions and ignore_transactions options (#724)
We decided to revert two previous PRs that aimed to remove deprecation warnings during test runs
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.9.2.
We decided to revert two previous PRs that aimed to remove deprecation warnings during test runs (#736)
We are sorry for the inconvenience caused by these changes.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.9.1.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.9.1.
TracingDriverForV32 by adding VersionAwarePlatformDriver::createDatabasePlatformForVersion (#731)Add a new Doctrine DBAL tracing driver that does not implement the deprecated VersionAwarePlatformDriver
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.9.0.
Add a new Doctrine DBAL tracing driver that does not implement the deprecated VersionAwarePlatformDriver (#723)
The driver is automatically picked if doctrine/dbal version 3.2.0 or higher is installed.
http_connect_timeoutand http_timeout options (#721)^3.19 (#725)The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.8.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.8.0.
Set cache keys as span descriptions (#677)
To better identify the source of a cache operation, we now set the cache key as the description of cache op spans.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.7.0.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.7.0.
Add profiles_sample_rate config option (#698)
With this new config option, you can now use our new profiling feature in Symfony as well. Please consult https://github.com/getsentry/sentry-php/releases/3.15.0 for setup instructions.
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.6.0. This release contains a colorful bouquet of new feat
The Sentry SDK team is happy to announce the immediate availability of Sentry Symfony SDK v4.6.0. This release contains a colorful bouquet of new features.
Report exceptions to Sentry as unhandled by default (#674)
All unhandled exceptions will now be marked as handled: false. You can query for such events on the issues list page,
by searching for error.handled:false.
Exceptions from messages which will be retried are sent to Sentry as handled (#674)
All unhandled exceptions happening on the message bus will now be unpacked and reported individually.
The WorkerMessageFailedEvent::willRetry property is used to determine the handled value of the event sent to Sentry.
Add register_error_handler config option (#687)
With this option, you can disable the global error and exception handlers of the base PHP SDK. If disabled, only events logged by Monolog will be sent to Sentry.
sentry:
dsn: '%env(SENTRY_DSN)%'
register_error_listener: false
register_error_handler: false
monolog:
handlers:
sentry:
type: sentry
level: !php/const Monolog\Logger::ERROR
hub_id: Sentry\State\HubInterface
Add before_send_transaction (#691)
Similar to before_send, you can now apply additional logic for transaction events.
You can mutate the transaction event before it is sent to Sentry. If your callback returns null,
the event is dropped.
sentry:
options:
before_send_transaction: 'sentry.callback.before_send_transaction'
services:
sentry.callback.before_send_transaction:
class: 'App\Service\Sentry'
factory: [ '@App\Service\Sentry', 'getBeforeSendTransaction' ]
<?php
namespace App\Service;
class Sentry
{
public function getBeforeSendTransaction(): callable
{
return function (\Sentry\Event $event): ?\Sentry\Event {
return $event;
};
}
}
Use the _route attribute as the transaction name (#692)
If you're using named routes, the SDK will default to use this attribute as the transaction name.
With this change, you should be able to see a full list of your transactions on the performance page,
instead of << unparameterized >>.
You may need to update your starred transactions as well as your dashboards due to this change.
Symfony version 3.4 is no longer supported
feat: Add support for Dynamic Sampling
Nothing published for this version
Fix compatibility issue with Symfony >= 6.1.0
TracingDriverConnectionInterface::getNativeConnection() method to get the original driver connection (#597)options.http_timeout and options.http_connect_timeout configuration options (#593)Fix compatibility issue with Twig >= 3.4.0
Fix deprecation notice thrown when instrumenting the PDOStatement::bindParam() method and passing $length = null on DBAL 2.x
PDOStatement::bindParam() method and passing $length = null on DBAL 2.x (#613)Fix compatibility issue with Doctrine Bundle >= 2.6.0
>= 2.6.0 (#608)Fix deprecation notice thrown when instrumenting the PDOStatement::bindParam() method and passing $length = null
PDOStatement::bindParam() method and passing $length = null (#586)Add support for symfony/cache-contracts package version 3.x
symfony/cache-contracts package version 3.x (#588)Fix fatal errors logged twice on Symfony 3.4
3.4 (#570)Add return typehints to the methods of the SentryExtension class to prepare for Symfony 6
SentryExtension class to prepare for Symfony 6 (#563)TracingDriverConnection::errorCode() (#568)ServerInfoAwareConnection interface (#567)Improve the compatibility layer with Doctrine DBAL to avoid deprecations notices
TracingStatement alias if it already exist (#552)TransportFactory factory (#555)Fix missing instrumentation of the Statement::execute() method of Doctrine DBAL
Statement::execute() method of Doctrine DBAL (#548)Fix return type for TracingDriver::getDatabase() method
TracingDriver::getDatabase() method (#541)TraceableCacheAdapterTrait::prune() and TraceableCacheAdapterTrait::reset() methods when the decorated adapter does not implement the respective interfaces (#543)Log the bus name, receiver name and message class name as event tags when using Symfony Messenger
sentry_trace_meta() Twig function to print the sentry-trace HTML meta tag (#510)TracingDriverConnection::getWrappedConnection() (#536)logger config option to ease setting a PSR-3 logger to debug the SDK (#538)^2.13|^3; simplify the DBAL tracing feature (#527)Fix decoration of cache adapters inheriting parent service
5.3 (#518)Fix missing require of the symfony/cache-contracts package
symfony/cache-contracts package (#506)Fix the check of the existence of the CacheItem class while attempting to enable the cache instrumentation
CacheItem class while attempting to enable the cache instrumentation (#501)Fix deprecations triggered by Symfony 5.3
5.3 (#489)SERVER_PROTOCOL header is missing (#495)Deprecate the Sentry\SentryBundle\EventListener\ConsoleCommandListener class in favor of its parent class Sentry\SentryBundle\EventListener\ConsoleLis…
RequestFetcher fails to translate the Request (#472)Sentry\SentryBundle\EventListener\ConsoleCommandListener class in favor of its parent class Sentry\SentryBundle\EventListener\ConsoleListener (#429)symfony/psr-http-message-bridge to allow installing it on a project that uses Symfony 3.4.x components only (#480)Fix regression from #454 for null value on DSN not disabling Sentry
null value on DSN not disabling Sentry (#457)Add kernel.project_dir to prefixes default value to trim paths to the project root
kernel.project_dir to prefixes default value to trim paths to the project root (#434)null, false or empty value not disabling Sentry (#454)Add missing capture-soft-fails option to the XSD schema for the XML config
capture-soft-fails option to the XSD schema for the XML config (#417)send_default_pii option is off (#425)register_error_listener option is disabled (#427)This is a new major release, that uses and requires a new major version of sentry/sentry, specifically with a ^3.0 constraint. To upgrade your app, re
This is a new major release, that uses and requires a new major version of sentry/sentry, specifically with a ^3.0 constraint.
To upgrade your app, read through the UPGRADE-4.0.md document of this bundle, and for further details the UPGRADE-3.0.md document of sentry/sentry.
>= v20.6.0 to work. If you are using sentry.io nothing will change and no action is needed.options.traces_sampler and options.traces_sample_rate configuration options (#385)options.project_root configuration option. Instead of setting it, use a combination of options.in_app_include and options.in_app_exclude (#385)options.excluded_exceptions configuration option. Instead of setting it, configure the IgnoreErrorsIntegration integration (#385)ConsoleCommandListener, ErrorListener, RequestListener and SubRequestListener event listeners (#387)RequestStack when using the RequestIntegration integration (#361)monolog configuration option. Instead, register the service manually (#406)listener_priorities configuration option. Instead, use a compiler pass to change the priority of the listeners (#407)Symfony\Bridge\PsrHttpMessage\HttpMessageFactoryInterface service for the RequestFetcher class (#409)RequestListener and SubRequestListener listeners (#414)Fix deprecations triggered by Symfony 5.3 (#490, thanks to @derrabus)
/ (#371, thanks to @VincentLanglet)One column per quarter.