Documentation forAppOptics

PHP Agent (legacy) Release Notes

AppOptics agents are no longer receiving updates. The new SolarWinds Observability Libraries can send APM data to AppOptics and are regularly updated with new features and improvements. If your components are supported by the new libraries, consider transitioning to the SolarWinds Observability Libraries for your APM needs. Alternatively, you can also consider using SolarWinds Observability as your primary APM monitoring solution.

SolarWinds Observability Libraries are not compatible with AppOptics agents. Do not use a mix of SolarWinds Observability Libraries and AppOptics agents to instrument applications that are part of a distributed trace.

5.1.2 - March 24, 2022

Return to top

Enhancements

  • Fixed PHP-FPM forking timeout issues during web server startup.

5.1.1 - February 7, 2022

Return to top

New features

  • PHP 8.1 support

Enhancements

  • Improved the Apache prefork handling of gRPC connections
  • Replaced the laravel trace error with an agent internal error so the error now shows in the log file

5.1.0 - June 14, 2021

Return to top

Supported versions

  • Added support for ARMv8 (AWS Graviton2)

5.0.3 - April 26, 2021

Return to top

Fixes

  • Removed 64KB limitation on event messages.
  • Disabled error events for unclosed Laravel spans. A message will be logged instead.
  • Improved start-up handling to avoid problems with Apache prefork.

5.0.2 - March 29, 2021

Return to top

Fixes

  • Fixed service error reporting for suppressed PHP errors
  • Added protection against crashes caused by NULL pointers

5.0.1 - March 16, 2021

Return to top

  • Fixed a problem with custom SDK usage from command line when CLI tracing is disabled
  • Reproducible builds for the PHP agent (security enhancement)
  • Adjusted traces to conform to Error Spec changes

5.0.0 - January 18, 2021

Return to top

  • Added support for PHP 8.0
  • Removed PHP 5 from feature release cycle (PHP 5 will stay on 4.x)
  • Adjusted traces to conform to RSC Spec

4.1.5 - January 15, 2021

Return to top

  • PHP 5 only
  • Adjusted traces to conform to RSC Spec

4.1.4 - October 29, 2020

Return to top

  • Added measures to prevent gRPC symbol collisions
  • Added support for Laravel 8

4.1.3 - October 14, 2020

Return to top

  • Improved Redis support for methods ‘hGet’ and ‘hGetAll’

4.1.2 - October 8, 2020

Return to top

  • Added support for Redis >= 5.3.0

4.1.1 - September 10, 2020

Return to top

  • Fixed handling of HTTP streams
  • Fixed code profiling for custom started traces

4.1.0 - Jun 24, 2020

Return to top

  • Enabled profiling for custom started traces
  • Added checks and protection against memory corruption
  • Improved handling of gRPC log messages

4.0.1 - Mar 09, 2020

Return to top

  • Fixed retrieval of EC2 metadata

4.0.0 - Mar 04, 2020

Return to top

  • Switched internal communication protocol to gRPC
  • Added HTTP proxy support
  • Added support for PHP 7.4
  • Added option to hide URL query parameters
  • Dropped support for old distros (CentOS 6, RHEL 6, Ubuntu 12.04, Debian 6/7)

3.8.4 - Jan 14, 2020

Return to top

  • Added logging of descriptive warning message on invalid service key or other soft disable states

3.8.3 - Dec 17, 2019

Return to top

  • Improved tracing of curl
  • Fixed a problem with profiling and custom SDK

3.8.2 - Oct 31, 2019

Return to top

  • Added support for Laravel 6

3.8.1 - Sep 30, 2019

Return to top

  • Fixed a conflict with the MongoDB extension
  • Added support for Microsoft Azure App Service

3.8.0 - Sep 11, 2019

Return to top

  • Added support for Trigger Trace
  • Added configuration option to change the EC2 metadata retrieval timeout

3.7.0 - Jul 11, 2019

Return to top

  • Added support for Laravel
  • Improved handling of environment variables

3.6.1 - May 09, 2019

Return to top

  • Added support for new API token format

3.6.0 - Apr 15, 2019

Return to top

  • Added trace ID injection into log messages
  • Fixed a memory issue with HTTP streams in PHP 7
  • Fixed corrupted transaction names
  • Fixed handling of invalid regular expressions for transaction filtering

3.5.1 - Mar 25, 2019

Return to top

  • Added support for PHP 7.3
  • Added support for Alpine Linux 3.9
  • Fixed issue with random characters in transaction names

3.5.0 - Mar 12, 2019

Return to top

  • Added transaction filtering to disable tracing on particular request URLs

3.4.1 - Mar 04, 2019

Return to top

  • Improved code profiling for long running requests
  • Reduced memory footprint of code profiling if disabled

3.4.0 - Feb 19, 2019

Return to top

  • Introduced code profiling
  • Modified handling of $_SERVER globals

3.3.6 - Jan 21, 2019

Return to top

  • Improved service name validation
  • Improved transaction name handling with CLI scripts
  • Use a default ‘max_ready_wait_time' value of 2 seconds for CLI (wait up to 2 seconds for AppOptics to become ready)
  • Fixed a memory issue with HTTP streams
  • Fixed optional parameters for Redis::connect()

3.3.5 - Nov 08, 2018

Return to top

  • Improved logging: allow to completely disable logging

3.3.4 - Nov 05, 2018

Return to top

  • Improved error reporting: always include backtrace

3.3.3 - Oct 17, 2018

Return to top

  • Added service name validation and automatic transformation of invalid service names

3.3.2 - Sep 19, 2018

Return to top

  • Fixed override of env variable APPOPTICS_DEBUG_LEVEL
  • Improved Network Interface detection
  • Log thrift internal messages as INFO instead of ERROR

3.3.1 - Aug 29, 2018

Return to top

  • Improved reporting of PHP errors
  • Fixed log level handling
  • Changed default log level to WARNING(2)
  • Added new config option: appoptics.enable

3.3.0 - Aug 15, 2018

Return to top

  • Fixed container ID detection on kubernetes
  • Fixed retrieval of MAC addresses
  • Improved Network Interface detection
  • Improved communication with AppOptics server (better host detection and optimized sending of data)
  • Optimization for FPM/FastCGI (sped up retrieval of initial settings)

3.2.5 - Jul 10, 2018

Return to top

  • Increased buffer size for events
  • Improved handling of multiple services
  • Rewrote code to address security/stability concerns
  • Fixed recovery of an expired account

3.2.4 - Jun 26, 2018

Return to top

  • Fixed 502 Gateway error on FPM/FastCGI

3.2.3 - Jun 21, 2018

Return to top

  • Fixed broken traces for phpredis when using pipeline/multi chains

3.2.2 - Jun 07, 2018

Return to top

  • Fixed multi-threaded (ZTS) mode
  • Disabled default instrumentation of ‘file_get_contents' (can be re-enabled via ‘appoptics.enable_wrap_file_get_contents = 1')

3.2.1 - May 28, 2018

Return to top

  • Fixed segfault on startup
  • Improved detection of Amazon EC2
  • Improved verbose logging

3.2.0 - May 24, 2018

Return to top

  • Added support for custom transaction naming
  • Optimizations for CLI apps (wait for ready, flush on exit)
  • Upgraded OpenSSL version

3.1.0 - May 17, 2018

Return to top

  • Added support for multiple VirtualHost services
  • Close inherited, unused sockets

3.0.11 - Apr 18, 2018

Return to top

  • Fixed memory leak
  • Reduced memory footprint
  • Added new config option: appoptics.max_transactions

3.0.10 - Mar 20, 2018

Return to top

  • Updated SSL protocol to TLSv1.2
  • Improved detection of Amazon EC2

3.0.9 - Feb 15, 2018

Return to top

  • Fixed segfault related to concurrency
  • Log level improvements

3.0.8 - Feb 12, 2018

Return to top

  • Added support for PHP 7.2

3.0.7 - Feb 08, 2018

Return to top

  • Added support for Alpine Linux 3.5, 3.6, 3.7

3.0.6 - Jan 24, 2018

Return to top

  • Fixed segfault related to cURL
  • Improved detection of docker ID on Mac OS X hosts and Amazon ECS

3.0.5 - Jan 08, 2018

Return to top

  • Improved detection of network interface devices

3.0.4 - Dec 18, 2017

Return to top

  • Disabled event reporting if context is not sampled
  • Various improvements (logging, memory management, docker container ID detection)

3.0.3 - Nov 16, 2017

Return to top

  • Reporting of HTTPMethod, HTTPStatus, and RemoteURL

3.0.2 - Nov 03, 2017

Return to top

  • Added new config options: appoptics.hostname_alias, appoptics.debug_level

3.0.1 - Oct 19, 2017

Return to top

  • Fixed cURL exception under Guzzle

3.0.0 - Oct 11, 2017

Return to top

  • Initial AppOptics PHP Agent Release