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.

PHP-FPM sensor releases

1.1.71

PHP-FPM sensor 1.1.71 is released on 09 July 2024.

Fixes

Previously, PHP sensor was instantiated on AIX and Windows only after a successful installation of PHP Tracer. This issue is now fixed.

1.1.70

PHP-FPM sensor 1.1.70 is released on 03 April 2024.

Fixes

To fix security vulnerabilities CVE-2024-29131 and CVE-2024-29133, the org.apache.commons_commons-configuration2 library is updated to 2.10.1.

PHP profile sensor releases

3.0.0

PHP profile sensor 3.0.0 is released on 09 July 2024.

Features

PHP profiling is now generally available when PHP profile sensor 3.0.0 is combined with PHP Tracer 4.0.0.

Versions of PHP Tracer earlier than 4.0.0 are not compatible.

PHP sensor releases

1.5.6

PHP sensor 1.5.6 is released on 09 July 2024.

Features

PHP Tracer 4.0.0 is now deployed by default.

1.5.1

PHP sensor 1.5.1 is released on 02 May 2024.

Features

PHP sensor 1.5.1 now generates warnings for versions of PHP that are officially past end-of-life.

Fixes

PHP trace sensor 1.1.1 is now instantiated only after a successful installation of PHP Tracer.

1.3.2

PHP sensor 1.3.2 is released on 26 February 2024.

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

Features

PHP sensor now supports environment variables in the com.instana.plugin.php section of the Instana agent configuration file. For more information, see Configurations from process environment.

PHP Tracer releases

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.

Fixes

Previously, PHP Tracer crashed when Instana traced Elastica (ruflin/elastica) and Elasticsearch (elasticsearch/elasticsearch) while elastic/transport 8.10.0 or later was used as a transitive dependency. This issue is now fixed.

4.0.0

PHP Tracer 4.0.0 is released on 09 July 2024.

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

Features

  • PHP profiler is now generally available. For more information, see Profiling.

  • PHP Tracer now supports the following technologies:

    • Tracing exceptions in CakePHP 4.4 and later. The latest supported version is 5.0.9.
    • Couchbase PECL extension 4.0 and later. The latest supported version is 4.1.6.
    • Elastica PHP library 7.0 and later. The latest supported version is 8.0.0.
    • Elasticsearch PHP library 7.0 and later. The latest supported version is 8.14.0.

  • PHP Tracer no longer supports the following technologies because these technologies do not support PHP 7.0 and later:

    • Kohana
    • Magento 1
    • TYPO3 Flow

Fixes

This release fixes the following issues:

  • Span duplication in PHP 8.2 and later when you use the following extensions:

    • AMQP PECL extension
    • HTTP PECL extension
    • Memcached PECL extension
    • OCI8 PECL extension
    • Redis PECL extension

  • Error message Fatal error: Uncaught TypeError: Argument 1 passed to MongoDB\Driver\Server::executeCommand() must be of the type string, null given returned to PHP 7.3 and later when you use the MongoDB PECL extension.

3.1.0

PHP Tracer 3.1.0 is released on 04 March 2024.

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

Features

PHP profiler is now available as a private preview feature. For more information, see Profiling.

3.0.0

PHP Tracer 3.0.0 is released on 26 February 2024.

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

Features

PHP Tracer now supports the following elements:

  • The Monolog 3 library. For more information, see Monolog.
  • The INSTANA_STACK_TRACE_LENGTH environment variable. For more information, see Environment variables.

Improvements

The time that is taken to start the PHP Tracer is significantly reduced by moving the handshake process with the Instana agent to a background thread.

Fixes

  • Previously, when PHP Tracer lost connection to the Instana agent (for example, due to a restart during its daily update cycle), traces were lost, and you had to reload the PHP runtime to reestablish the connection. Now a detection mechanism for this connection loss is established. This mechanism triggers the handshake process with the Instana agent in parallel on a background thread to reestablish the connection.
  • Previously, the instana.backtrace_limit setting was capped at 35 entries. Now the default or capped value is 25 entries. For more information, see PHP Tracing extension.