New Relic PHP Agent v10.1.0

New features

• APM logs in context support for Monolog 2 and 3

  • The PHP agent will now generate logging metrics for Monolog (versions 2 and 3) to allow seeing the rate of log messages by severity.
  • These metrics are enabled by default and are controlled by a config file directive.
  • The PHP agent can also now forward log messages from Monolog for viewing on the New Relic platform.
  • Log forwarding is currently disabled by default (can be enabled by a config file directive), and will be enabled by default in a future release.

  To learn more about APM logs in context, see the logs in context docs.

  For more information about logs in context and the PHP agent check the PHP logs in context docs.

• Enhanced redis/PhpRedis support Thank you to Michael Grunder for contributing to the PHP agent and extending the existing redis/PhpRedis support!

New contributors

As mentioned above, community member Michael Grunder made his first contribution to the New Relic PHP agent. Thanks!!!

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines please consult the following document.

New Relic PHP Agent v10.0.0

New features

• The agent now incorporates updated backend communications which will pave the way to efficiently add new features.
• Agent tags are now supported by the PHP agent.

Bug fixes

• Infinite tracing is now disabled at startup if distributed tracing is disabled since it is required (Issue 452).
• Removed a debugging statement that was no longer needed and could lead to large log file usage if verbose debugging was enabled (Issue 447).
• Additional fixes to significantly reduce the number of duplicated log messages in some situations where large log consumption had been observed in the past.

Support statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines please consult the following document.

New Relic PHP Agent v9.21.0

New features

• Distributed Tracing is now turned on by default.
• Distributed Tracing span reservoir size now has a default of 2000, from 1000, and a maximum of 10000.
• Cross Application Tracing is deprecated.

Bug fixes

• Fixed an install script bug where it detects Alpine Linux as Debian when phpize dependencies are installed.
• Improved stability of Laravel framework when using opcache with PHP 8.1.

Support statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines please consult the following document.

v9.20.0

New Relic PHP agent v9.20.0

New features

• AWS instance metadata service (IMDS) feature now allows AWS IMDSv2 by @robertprast.

New Contributors

• @robertprast made their first contribution. Thanks!!

End of Life Notices

• Support for the Centos 6 / RHEL6 operating systems are deprecated and will be removed by June 2022.

Support statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. For more information on supported agent versions and EOL timelines please consult the following document.

v9.19.0

New Relic PHP Agent v9.19.0

New Features

• Added support for 64-bit PHP 8.1! (#177). Compatibility note: Support for PHP 8.1 does not include Fibers.

Bug Fixes

• Fixed Symfony 5 auto detect (#113, #256). Thank you @piotrantosik for your contribution!
• Fixed URL of New Relic for PHP docs website used in error messages (#334)
• Fixed URL of New Relic of PHP docs website in README (#254). Thank you @revilon1991 for you contribution!

End of Life Notices

• 32-bit support for PHP versions 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4 is deprecated and will be removed by June 2022.
• Support for FreeBSD operating system is deprecated and will be removed by June 2022.
• This will be the last release in which ZTS builds are supported. In the future, ZTS builds may not be provided and support may be completely pulled from the codebase.

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.

v9.18.1

New Relic PHP Agent v9.18.1

New Features

• Added a docker development environment. It's now possible for contributors to both develop and test (unit tests and integration tests) without setting up a specific environment on their own system. Please see our documentation for more information.
• Route caching in Laravel 7.x is now supported!. Transaction naming now works with routes cached via php artisan route:cache. @stockalexander, thanks for your contribution!
• Redis::mget and Redis::mset functions are now supported. @b-viguier, thanks for your contribution!

Bug Fixes

• Fixed instances where a memory leak was occurring with our curl multi instrumentation.
• Fixed an issue where a supportability metric used to track an edge case was causing a segfault.
• Fixed an issue where PHP versions with an unknown API version were incorrectly handled during Debian package install.
• Fixed instances where parent.transportDuration values are 0 for transactions between two PHP applications instrumented through distributed tracing. @b-viguier, thanks for your contribution!
• Fixed an issue where the newrelic.ini configuration file was incorrectly installed. @b-viguier, thanks for your contribution!

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.

v9.17.1

New Relic PHP Agent v9.17.1

Bug Fixes

• Fixed instances where the agent's mysqli_commit instrumentation returned a NULL instead of a boolean.
• Fixed an issue where parameters were not passed by reference in the agent's pdo instrumentation. This caused a warning in PHP 8.
• Fixed instances where an Unknown PHP version: 8.0 error was occurring when installing on Debian and Ubuntu systems.

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.

v9.17.0

New Relic PHP Agent v9.17.0

End of Life Notices

• This will be the last release in which ZTS builds are supported. In the future, ZTS builds may not be provided, and support may be completely pulled from the codebase.
• New Relic no longer supports PHP 5.3 or PHP 5.4. New Relic highly encourages upgrading to a supported version of PHP. If you would like to continue running the New Relic PHP agent with PHP 5.3 or 5.4, we recommend using version 9.16 of the agent. However, please note that we can only offer limited support in this case.
• Ubuntu LTS versions earlier than 14.04, Ubuntu non-LTS versions earlier than 19.04, and Debian versions earlier than 7 "wheezy" are no longer supported.
• The following frameworks or framework versions are no longer supported and may be removed from future agent builds:
  • Cake PHP 1.x
  • Joomla 1.5, 1.6, and 2.x
  • Kohana
  • Silex 1.x and 2.x
  • Symfony 1.x and 2.x

New Features

• The agent now supports 64-bit PHP 8.0! Compatibility note: When PHP 8.0 detects the New Relic agent, it disables Just-In-Time (JIT) compilation.
• mysqli_commit is now instrumented.

Bug Fixes

• Fixed a memory leak that occurred when short lived segments throw exceptions. Thanks, @b-viguier for providing the excellent reproduction environment and script!
• Fixed a build up of duplicate Distributed Tracing headers that sometimes occurred when using file_get_contents.
• Fixed an issue where Laravel Lumen transactions were not being properly named.

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.6.0.

v9.16.0

New Relic PHP Agent v9.16.0

Bug Fixes

• The Drupal instrumentation now guards against rare conditions that led to PHP processes exiting with an allocation error. Additionally, the allocation routines now log stack traces when they fail.
• When initially building the agent, a parallel build is no longer required to avoid an error about a missing header file (v1.pb-c.h).
• SOAP transactions when using Magento 2.3.2+ are now properly named instead of being attributed to Magento's internal SOAP interceptor. Thanks @steven-hoffman-jomashop for the issue report and fix suggestion!

Support Statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.5.0.

v9.15.0

New Relic PHP Agent v9.15.0

End of Life Notices

• Support for PHP 5.3 and PHP 5.4 in the New Relic PHP Agent is deprecated and will be removed in a future version. New Relic highly encourages upgrading to a supported version of PHP - 7.3 or higher as of the date of this release. If you would like to continue running the New Relic PHP agent with PHP 5.3 and 5.4, we recommend using version 9.15 of the agent for maximum compatibility, however, please note that we can only offer limited support in this case.
• This release marks the last officially supported New Relic PHP Agent for CentOS 5.
• MacOS builds of the New Relic PHP Agent will no longer be provided, and we will no longer ensure compatibility on MacOS platforms.

New Features

• Support has been added for Laminas 3.x.
• Support has been added for Laravel Lumen 6.x, 7.x, and 8.x
• Experimental support has been added for excluding subpaths from WordPress instrumentation. This lowers the overall WordPress instrumentation overhead by reducing the number of files being instrumented at the cost of losing visibility into the excluded subpaths. This can be enabled using the configuration setting newrelic.framework.wordpress.hooks_skip_filename.

Bug Fixes

• Corrected string representation of arginfo parameter names. Thank you @TysonAndre for this contribution.

Support statement

• New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 8.4.0.