PHP Tracer releases

Instana monitors your PHP environment by using the PHP sensor and tracer. The PHP sensor provides infrastructure metrics, while the PHP Tracer provides automated code instrumentation and tracing data across your environment.

For more information, see Monitoring PHP. To get specific tracer updates, you need to install the associated agent version specified in the release version.

For more information about the latest updates on PHP sensor, PHP-FPM sensor and PHP profile sensor, see PHP sensor releases.

The following releases offer the latest performance updates for PHP Tracer:

Release 5.5.1

PHP Tracer 5.5.1 is released on 5 November 2025.

Features

PHP Tracer now instruments the Microsoft SQL Server PHP extension (sqlsrv).

Improvements

This release provides the following enhancements:

  • Improved serverless PHP Tracer performance during PHP-FPM metrics collection.
  • Logging of PHP deprecation warning when the instana.disabled_instrumentation INI setting is used to disable instrumentations.
  • Effective instrumentation disabling configuration when both Span Disabling feature and instana.disabled_instrumentation INI setting are used.

Fixes

PHP CLI crashed when PHP Tracer's debug logging is enabled and the error_log PHP INI setting is configured. This issue is now fixed.

Relelase 5.3.0

PHP Tracer 5.3.0 is released on 30 September 2025.

Features

You can now disable spans in PHP Traces either by using the agent configuration.yaml file or at PHP runtime by using the environment variable INSTANA_CONFIG_PATH .

Improvements

This release improves exception handling in CakePHP by extending the middleware exception handler class in CakePHP.

Release 5.1.0

PHP Tracer 5.1.0 is released on 11 September 2025.

Features

The PHP Tracer now supports the following features:

  • PHP-FPM process monitoring in AWS Fargate
  • OpenSSL 1.1 for PHP on AWS fargate

Release 5.0.2

PHP Tracer 5.0.2 is released on 25 August 2025.

Fixes

This release resolves request and response header cache issues in cURL instrumentation.

Release 5.0.1

PHP Tracer 5.0.1 is released on 15 July 2025.

Features

You can now monitor PHP applications that run on Podman.

Fixes

This release fixes an issue where the endpoint name was not specified for FPM status calls that are initiated through the CGI-FCGI tool.

Release 5.0.0

PHP Tracer 5.0.0 is released on 26 June 2025.

Features

You can now monitor PHP applications on AWS ECS.

Fixes

This release has the following fixes:

  • The Instana header issues when using the CURLOPT_HEADERFUNCTION is now fixed.
  • The PHP service visibility issue is now fixed. You can now view the PHP service under the PHP runtime for Apache2handler SAPI.

Release 4.9.0

PHP Tracer 4.9.0 is released on 19 May 2025.

Features

PHP Tracer now supports Windows environments.

Improvements

This release improves the integration of PHP-CGI SAPI with PHP Tracer.

Release 4.8.0

PHP Tracer 4.8.0 is released on 5 May 2025.

Features

PHP Tracer now provides the following features:

  • Removes support for PHP 7.0 and 8.0.
  • Introduces bitmask value to disable openLDAP instrumentation by using the disabled_instrumentation setting in the PHP INI file.

Improvements

The log level for PHP Tracer now defaults to NONE.

Release 4.7.3

PHP Tracer 4.7.3 is released on 9 April 2025.

Fixes

This release fixes the OpenLDAP callback integrations to remove deprecated PHP Zend function convert_to_long_base ().

Release 4.7.1

PHP Tracer 4.7.1 is released on 31 March 2025.

Fixes

This release fixes excessive INFO level logging to DEBUG level in PHP Tracer.

Release 4.7.0

PHP Tracer 4.7.0 is released on 26 February 2025.

Features

PHP Tracer now provides the following features:

  • Supports the following environment variables:
    • INSTANA_AGENT_HOST
    • INSTANA_AGENT_PORT
    • INSTANA_EXTRA_HTTP_HEADERS
    • INSTANA_SECRETS
  • Captures request and response custom HTTP headers in exit span.

Fixes

This release fixes compatibility issues of MongoDB 1.20.0 and earlier with PHP 7.4 and later.

Release 4.6.2

PHP Tracer 4.6.2 is released on 12 December 2024.

Features

The PHP Tracer now supports PHP 8.4. This release also updates support for environment variable INSTANA_DEBUG and INSTANA_LOG_LEVEL to enable logging in PHP Tracer.

Release 4.6.1

PHP Tracer 4.6.1 is released on 20 November 2024.

Release 4.5.1

PHP Tracer 4.5.1 is released on 28 October 2024.

Fixes

Previously the PHP Tracer failed when it was used with the Drupal logger without specifying the third argument context for logging. This issue is fixed now.

Release 4.2.0

PHP Tracer 4.2.0 is released on 9 October 2024.

Features

You can now use the INSTANA_AUTO_PROFILE environment variable to enable or disable auto-profiling.

Fixes

The PHP Tracer uses PHP runtime _SERVER array to fetch environment variables instead of the std::getenv() function.

Release 4.1.0

PHP Tracer 4.1.0 is released on 21 August 2024.

To get the following features or performance updates, you need to have Agent 1.1.712 or later.

Features

PHP Tracer now captures the query statement from Couchbase queries that are made through the Couchbase PECL extension.