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.
Important
For installations using an unsupported PHP version or platform (32 bit, FreeBSD, ZTS, etc), it's highly recommended that you 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. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and removal of 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
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/%
andSupportability/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.
Important
For installations using an unsupported PHP version or platform (32 bit, FreeBSD, ZTS, etc), it's highly recommended that you 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. Or you could version pin the PHP agent package to an agent version that supports the old, unsupported feature(s). Failure to prevent upgrades may result in a newer agent release being installed and removal of 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
New Relic PHP Agent v10.4.0.316
Important
We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version at most 90 days old. Read more about keeping your agent up to date.
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
We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version at most 90 days old. Read more about keeping your agent up to date.
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.
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.
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.