PHP agent release notesRSS

New Relic PHP Agent v10.7.0.319

Important note

If the following error occurs when installing the newrelic-php5 Debian package:

Setting up newrelic-php5 (10.7.0.319) ...
Unknown PHP version: 8.2

Please run the newrelic-install installation program which will complete the installation of the PHP agent and set up the correct symlink to the PHP extension directory.

New features

• Added Support for PHP 8.2.

Important end-of-life information

• Support for PHP versions 5.5 and 5.6 will end June 2023.

Support statement

• Support for 32 bit and FreeBSD ended with release v9.19.0.309 and those binaries are no longer provided.
• Support for ZTS builds ended with release v9.19.0.309.
• 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, check out our PHP EOL policy.
• The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.

New Relic PHP Agent v10.6.0.318

New features

• Code Level Metrics (CLM) is now enabled by default.
  • CLM allows you to gather more data associated with each span, including line numbers, function names, filepaths, and namespaces.
  • CLM was introduced in release 10.4.0.316.
  • Use this ini value to configure CLM.

Important end-of-life information

• Support for PHP versions 5.5 and 5.6 will end June 2023.

Support statement

• Support for 32 bit and FreeBSD ended with release v9.19.0.309 and those binaries are no longer provided.
• Support for ZTS builds ended with release v9.19.0.309.
• 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, check out our PHP EOL policy.
• The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.

New Relic PHP Agent v10.5.0.317

Bug Fixes

• agent: Fixed #577 - Large performance regression in 10.3.0. #588
• agent: Fixed #594 - Instrumentation from opcache.preload for PHP 8.1. #595
• agent: Fixed sending Supportability/Logging/Forwarding/PHP/% and Supportability/Logging/Metrics/PHP/% application logging configuration metrics. #575

Support statement

• Support for 32 bit and FreeBSD ended with release v9.19.0.309 and those binaries are no longer provided.
• Support for ZTS builds ended with release v9.19.0.309.
• 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, check out our PHP EOL policy.
• The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.

New Relic PHP Agent v10.4.0.316

Important end-of-life information

• Support for ZTS binaries was deprecated with release v9.17.0.300 and will be removed in a January 2023 release.

• For installations using an unsupported PHP version or platform (32 bit, FreeBSD, ZTS, etc), it is highly recommended to disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Alternatively, the PHP agent packages can be version pinned to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed, removing support for the required, unsupported features. This would disrupt APM data collection.
  The PHP agent packages which are affected are:

  • newrelic-php5
  • newrelic-php5-common
  • newrelic-daemon

• You should check the PHP agent compatibility and requirements page for the latest information on supported PHP versions and platforms.

New features

• Code Level Metrics (CLM) has been introduced and is set to off by default.
  • CLM allows you to gather more data associated with each span, including line numbers, function names, filepaths, and namespaces.
  • Use this ini value to start using CLM!

Improvements

• Custom Event Limit default reservoir size has been increased and is now configurable.
  • The default maximum number of custom events gathered per minute has been increased from 10,000 to 30,000.
  • This value can now be modified with this ini value.

New Relic PHP Agent v10.3.0.315

Important end-of-life information

• Support for 32 bit and FreeBSD binaries were deprecated with release v9.19.0.309 and are no longer shipped starting with this release.

• Support for ZTS binaries was deprecated with release v9.17.0.300 and will be removed in a release in the near future.

• For installations using an unsupported PHP version or platform (32 bit, FreeBSD, ZTS, etc), it is highly recommended to disable the auto-update mechanisms for the PHP agent packages. This can be done by adding the PHP agent packages to an exclusion list for package upgrades. Alternatively, the PHP agent packages can be version pinned to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed, removing support for the required, unsupported features. This would disrupt APM data collection.
  The PHP agent packages which are affected are:

  • newrelic-php5
  • newrelic-php5-common
  • newrelic-daemon

• The PHP agent compatibility and requirements page should be consulted for the latest information on supported PHP versions and platforms.

New features

• APM logs in context. Automatic application log forwarding is now enabled by default. This version of the agent will automatically send enriched application logs to New Relic. To learn more about this feature see PHP: Configure logs in context, and additional configuration options are available PHP agent configuration: Config file. To learn about how to toggle log ingestion on or off by account see Disable automatic logging. #556

Bug fixes

• agent: Fix to ensure datastore segments do not create children segments. #511
• agent: Updates instrumentation lookups for PHP 7.4+. Using reserved field of zend_func's op_array is no longer reliable as other extensions are unreliably using this shared area which then corrupts the opcache enough that it no longer provides lookups. The new method no longer relies on the agent storing any information in the reserved array of a zend_function. Fixes: Laravel 9 PHP8.1 Not reporting errors, All transactions are "unknown" bug

New Relic PHP Agent v10.2.0.314

New Features

• newrelic-daemon: Informational messages will be logged if the number of connected applications falls below 25 or exceeds 200. #534

Bug Fixes

• agent: Fixed SIGSEGV in Drupal 7 drupal_http_request instrumentation for PHP 7.4, 8.0 and 8.1. #538
• agent: Fixed displaying newrelic.application_logging*.enabled value in PHP info output. #535
• agent: When forwarding application logs, send the log message as a well-formed JSON string that is correctly escaped. #540
• agent: Reduce the severity of a log message when an agent does not detect environmental variables. #539

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, check out our PHP EOL policy.

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 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 (up 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 using 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.