dd-trace-php

Added

• Tracer limited mode, stopping span creation when memory use raises to 80% of current PHP memory limit #437
• Configurable Curl timeouts DD_TRACE_AGENT_TIMEOUT and DD_TRACE_AGENT_CONNECT_TIMEOUT when communicating with the agent #150
• Configurable DD_TRACE_REPORT_HOSTNAME reporting of hostname via root span #441
• Support for CakePHP v2 and Cake Console v2 #436

Fixed

• Generation of E_WARNING in certain contexts of PHP 5 installs when the date.timezone INI setting is not set #435

NOTE: We changed the way the service name can be configured. Now you must use DD_SERVICE_NAME instead of DD_TRACE_APP_NAME for consistency with other tracers. Usage of DD_TRACE_APP_NAME is now deprecated and will be removed in a future release.

Added

• Support for Lumen 5.2+ #416
• Tracing support from the CLI SAPI #422
• Support for Laravel Artisan #422

Changed

• Now the way to configure service name is through DD_SERVICE_NAME instead of DD_TRACE_APP_NAME #432

Added

• Official support for PHP 7.3 #429
• Tracer limited mode where spans are not created to preserve resources #417

Fixed

• Error when a subclassed integration returns an object that cannot be cast as a string #423

Added

• dd_trace_forward_call() to forward the original call from within a tracing closure #284

Fixed

• parent:: keyword not honored from a subclass when forwarding a call from a tracing closure #284
• Private and protected callable strings not resolved properly from a tracing closure #303

Added

• Force tracing or discarding trace via special Span tag (manual.keep and manual.drop) #409

Fixed

• Resource use by caching configuration values instead of processing data on every access #406

Fixed

• Tracing of functions called using DO_FCALL_BY_NAME opcode #404
• Curl headers not being correctly set #404

Changed

• Span and SpanContext main implementation uses public fields to share data to allow faster serialization and overall Span overhead #398
• DDTrace\Encoders\SpanEncoder::encode() now takes an instance of DDTrace\Data\Span instead of DDTrace\Contracts\Span #398
• DDTrace\Processing\TraceAnalyticsProcessor::process() now takes an instance of DDTrace\Data\Span instead of DDTrace\Contracts\Span #398
• Improve performance of setTag and setResource #398
• Load required PHP files in one go #387
• Load optional PHP files without filesystem check #387

NOTE: THIS IS A BREAKING CHANGE RELEASE

This change should not impact most users.

Added

• MessagePack serialization for traces sent to the Agent with a new function dd_trace_serialize_msgpack() #378

Changed

• Request init hook module blacklist now avoids miss matching partial matches #372
• Add 10MB cap to payloads sent to the Agent #388
• Added an getTracesAsArray() method to DDTrace/Contracts/Tracer which returns an array of spans (which are also encoded as an array.) To encode an instance of DDTrace\Contracts\Span as an array, use DDTrace/Encoders/SpanEncoder::encode($span) #378
• DDTrace/Transport::send() now takes an instance of DDTrace/Contracts/Tracer instead of an array #378
• DDTrace/Encoder::encodeTraces() now takes an instance of DDTrace/Contracts/Tracer instead of an array #378
• The default encoder is now DDTrace/Encoders/MessagePack. You can still use the JSON encoder by setting the environment variable DD_TRACE_ENCODER=json. It is generally not recommended to use the JSON encoder as parsing JSON payloads at the Agent level is more CPU & memory intensive.

Added

• Integration aware spans #360
• Trace Analytics Client Configuration #367

Fixed

• Error traces don't appear in "Total Errors" panel #375

Changed

• When shutdown hook is executed we disable all tracing to avoid creating unnecessary spans #361
• Inside request init hook we disable all function tracing when we decide not to trace #361

Added

• Disable request_init_hook functionality in presence of blacklisted modules via ddtrace.internal_blacklisted_modules_list=some_module,some_other_module #345 & #370
• Integration-level configuration #354
• dd_trace_disable_in_request function which disables all function tracing until request ends #361

Fixed

• Symfony template rendering spans #359
• Laravel integration user ID errors #363
• Non-success HTTP response codes aren't properly categorized as errors in the APM UI #366

Added

• Symfony 2.3 web tests for resource name #349
• Update images and enable leak detection, split tests in CI to Unit, Integration and Web #299

Fixed

• Resource name on Symfony 2.x requests served through controllers #341
• Sanitize url in web spans #344
• Laravel 5.8 compatibility #351

Changed

• Removed beta references and get ready for GA #339

Fixed

• Ensure Function name is safely copied to avoid freeing persistent string #333

Fixed

• Large number of mysqli spans not containing relevant information #330

Added

• Loading of integrations before knowing if the library will be actually used #319
• Ability to define tracing for not yet defined methods and classes #325

Special thanks to @stayallive for helping us debugging the memory issues in his environment! His help and guidance were of paramount importance.

Fixed

• Accessing freed memory when instrumentation code un/instrumented itself #314
• Freeing $this object prematurely in PHP-FPM VM #317

Fixed

• 7.x handling of $this pointer passed to the closure causing errors in PHP VM #311

Added

• Optional extension .so files compiled with "-g" flag #306
• Log backtrace on segmentation fault, enabled via ddtrace.log_backtrace=1 #300

Fixed

• Auto-instrumentation when user's autoloader throws exception on not found #305

Fixed

• Honor ddtrace provided by composer if user provided one #276
• Remove unused function that was moved to dispatch_table_dtor() #291
• PHP 5.4 incorrectly handling nested internal functions #295