PHP Library release notes
These release notes describe the new features, improvements, and fixed issues in the SolarWinds Observability PHP Library.
Learn more
- For release notes for all SolarWinds agents, libraries, and collectors, see SolarWinds Observability SaaS summary release notes.
- For currently known issues, see Known issues.
- For information about requirements, see SolarWinds Observability SaaS System Requirements.
2024 updates
8.10.0 - August 21, 2024
New features and improvements
-
Removed the local sample rate and token bucket configuration.
-
Added support for Laravel 11 instrumentation.
Fixes
-
Fixed an issue with custom instrumentation API
solarwinds_apm_metric_summary
andsolarwinds_apm_metrics_increment
.
Common APM library updates: Update to liboboe 15.0.1
- Internal improvement
8.9.0 - June 7, 2024
New features and improvements
-
The
telemetry.sdk.language
attribute has been added to traces and metrics.
Common APM library updates: Update to liboboe 15.0.0
-
Breaking change:
-
Added the following function in
oboe.h
to append attributes to metrics:void oboe_metrics_attributes_upsert(const char* key, const char* value)
bool oboe_metrics_attributes_remove(const char* key)
-
-
Fix:
-
Fixed file logging append functionality.
-
8.8.1 - April 29, 2024
Common APM library updates: Update to liboboe 14.1.1
- Removed base64 header.
- Fixed CodeQL alert.
8.8.0 - April 2, 2024
Common APM library updates: Update to liboboe 14.1.0
- Added exception handling in HttpAsyncClient class.
Fixes
- The upgrade to liboboe 14.1.0 fixed an exception handling issue when the PHP APM library didn't have permission to access network resource.
8.7.0 - February 22, 2024
New features and improvements
- Added logging about the PHP runtime during start up.
Common APM library updates: Update to liboboe 14.0.3
- Support of layer setting resolution has been removed.
Fixes
- Fixed an empty header issue in curl instrumentation.
Support changes
- Added PHP 8.3 support.
2023 updates
8.5.0 - August 17, 2023
New features and improvements
- Custom transaction name API works when the request is not sampled.
- The
solarwinds-apm.enable_wrap_*
configuration options are available. These options can be used to temporarily disable instrumentation for troubleshooting purposes.
Common APM library updates: Update to liboboe 13.0.0
- Sampling roll dice logic no longer results in a bug for edge cases.
k8s.pod.name
is sent only when the library is running in Kubernetes.
8.4.0 - July 17, 2023
New features and improvements
- Sends metrics formats based on whether the library is sending data to the AppOptics collector endpoint or the SolarWinds Observability SaaS collector endpoint.
Common APM library updates: update to liboboe 12.4.0
- Gather k8s metadata to correlate the service with Kubernetes entities.
- Extraneous
_V
key value pairs are no longer created and sent to SolarWinds Observability SaaS.
Fixes
- Deprecated
Message
key is removed, ErrorType is no longer sent, and fake error events for HTTP 5XX errors are no longer included in error log instrumentation. - Obsolete key value pair (
PreDownload
time) is removed for curl instrumentation.
8.3.1 - June 15, 2023
New features and improvements
- Removed obsolete key-value pair (
cURL_URL
andResponseCode
) for curl instrumentation.
Common APM library updates: update to liboboe 12.3.1
- The error log message now has the correct severity level.
Fixes
- The
RemoteHost
attribute is no longer missing in thephp_mysqli
span.
8.3.0 - May 24, 2023
Common APM library updates: update to liboboe 12.3.0
- Installed SolarWinds Observability Agents are identified more reliably by retrieving the client ID with the REST API.
Fixes
- Service names use the correct overrides when the service key is defined separately in both the INI file and the directory or virtual host (vhost) level.
Support changes
- Laravel 10 is supported.
8.2.0 - May 2, 2023
New features and improvements
api.php
is updated to support the new trace context in logs format.
Common APM library updates: update to liboboe 12.2.0
- AWS and Azure VM metadata is reported for Service and Host correlation.
8.1.0 - March 22, 2023
Improvements:
- liboboe is upgraded to version 12.1.0. liboboe 12.1.0 adds the ability to retrieve AWS EC2 and Azure VM metadata, fixes a threading locking issue, and allows messages to be ingested without an HTTP status code tag applied.
- RemoteHost / RemoteURL / connection string credentials are removed.
- Verifies
libstdc++
exists for Alpine Linux and adds it upon installation if necessary.
8.0.1 - February 14, 2023
Improvements:
- Updates to
__Init
message.
Fixes:
solarwinds-apm.enable_sanitize_sql
configuration correctly sanitizes queries.
Supported changes:
- PHP 8.2
2022 updates
7.2.0 - November 17, 2022
Changes:
- Updated to liboboe 11.0.0 to support using the AppOptics endpoint with default certificates.
- Fixed curl instrumentation compatibility issues with PHP 8.x.
7.1.2 - September 28, 2022
New features:
- Support for a new unified metrics format with an update to liboboe 10.6.1. See SolarWinds Observability SaaS October 2022 release notes for details of the unified metrics, why you should upgrade your library, and follow up actions that may be necessary after upgrading your library.
Breaking changes:
- Updated start trace SDK to use a
traceparent
andtracestate
parameter instead of the previousxtrace
edge parameter. See PHP SDK reference.
Fixes:
- Updated oboe API.
- Updated
api.php
. See PHP SDK reference.
7.1.0 - July 18, 2022
New features:
- The installer script now includes an option to specify a collector endpoint.
- The library now reports the SolarWinds Observability Agent's client ID so the relationship between the host entity and the services entity is detected and shown in SolarWinds Observability SaaS.
Fixes:
- Updated service key masking logic.
7.0.0 - July 16, 2022
New features:
- Added masking for service key in
phpinfo()
. - Added collector configuration.
Fixes:
- Fix installer script.
Supported systems:
- Removed support for alpine 3.9, 3.10. 3.11, 3.12 and added support for alpine 3.13+
- Removed support for Laravel instrumentation for version 5.5 and 5.8 and added support for Laravel 9 instrumentation
Legal notices
© 2024 SolarWinds Worldwide, LLC. All rights reserved.
This document may not be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the prior written consent of SolarWinds. All right, title, and interest in and to the software, services, and documentation are and shall remain the exclusive property of SolarWinds, its affiliates, and/or its respective licensors.
SOLARWINDS DISCLAIMS ALL WARRANTIES, CONDITIONS, OR OTHER TERMS, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, ON THE DOCUMENTATION, INCLUDING WITHOUT LIMITATION NONINFRINGEMENT, ACCURACY, COMPLETENESS, OR USEFULNESS OF ANY INFORMATION CONTAINED HEREIN. IN NO EVENT SHALL SOLARWINDS, ITS SUPPLIERS, NOR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR ANY OTHER LEGAL THEORY, EVEN IF SOLARWINDS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
The SolarWinds, SolarWinds & Design, Orion, and THWACK trademarks are the exclusive property of SolarWinds Worldwide, LLC or its affiliates, are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other SolarWinds trademarks, service marks, and logos may be common law marks or are registered or pending registration. All other trademarks mentioned herein are used for identification purposes only and are trademarks of (and may be registered trademarks) of their respective companies.