PHP agent release notesRSS

New Relic PHP Agent v10.9.0.324

Security

• Updated the Golang version used to build the Daemon from 1.9 to 1.20

New features

Bug Fixes

Important end-of-life information

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

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.
• 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.8.0.323

New features

• Added healthcheck log level for the daemon, allowing for precise monitoring of the number of connected applications.

Bug Fixes

• Fixed debian package installation occasionally requiring an additional manual step #634
• Fixed a warning from agent when passing null as the second parameter to curl_multi_exec #605. Special thanks to dejanceltra for finding and fixing this issue!

New Contributors

This release contains the first contribution to the New Relic PHP Agent from community member dejanceltra! 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, 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.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.