Skip to content

Enable sidecar by default on PHP 8.3#2680

Merged
bwoebi merged 18 commits intomasterfrom
pierre/enable-sidecar-by-default
Jun 7, 2024
Merged

Enable sidecar by default on PHP 8.3#2680
bwoebi merged 18 commits intomasterfrom
pierre/enable-sidecar-by-default

Conversation

@pierotibou
Copy link
Copy Markdown
Collaborator

@pierotibou pierotibou commented May 29, 2024

Description

This PR enables sending traces on Unix through the sidecar by default in PHP 8.3.
This will thus impact 5% of our customers.

If the customer has explicitly disabled telemetry (thus the sidecar), we need to fallback to the background zender.

This is tested through unit tests on config logging.

APMSP-1154

Reviewer checklist

  • Test coverage seems ok.
  • Appropriate labels assigned.

@codecov-commenter
Copy link
Copy Markdown

codecov-commenter commented May 29, 2024

Codecov Report

Attention: Patch coverage is 95.31250% with 3 lines in your changes missing coverage. Please review.

Project coverage is 77.96%. Comparing base (c795fcd) to head (1085733).

Additional details and impacted files

Impacted file tree graph

@@             Coverage Diff              @@
##             master    #2680      +/-   ##
============================================
- Coverage     79.40%   77.96%   -1.44%     
  Complexity     2212     2212              
============================================
  Files           201      227      +26     
  Lines         22488    26551    +4063     
  Branches          0      988     +988     
============================================
+ Hits          17857    20701    +2844     
- Misses         4631     5324     +693     
- Partials          0      526     +526     
Flag Coverage Δ
appsec-extension 69.13% <ø> (?)
tracer-extension 78.86% <95.31%> (+0.23%) ⬆️
tracer-php 80.52% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files Coverage Δ
ext/coms.c 79.64% <100.00%> (+0.70%) ⬆️
ext/coms.h 100.00% <ø> (ø)
ext/configuration.h 100.00% <ø> (ø)
ext/startup_logging.c 86.06% <100.00%> (+0.14%) ⬆️
ext/auto_flush.c 71.91% <0.00%> (+17.97%) ⬆️
ext/ddtrace.c 74.36% <94.11%> (+0.22%) ⬆️
ext/serializer.c 82.18% <87.50%> (+0.54%) ⬆️

... and 26 files with indirect coverage changes


Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update c795fcd...1085733. Read the comment docs.

@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch from 17f3a13 to b5e4ec2 Compare May 30, 2024 09:59
@pierotibou pierotibou force-pushed the pierre/enable-sidecar-by-default branch from 4f72426 to bc1fa68 Compare May 30, 2024 12:28
@pr-commenter
Copy link
Copy Markdown

pr-commenter Bot commented May 30, 2024

Benchmarks

Benchmark execution time: 2024-06-07 21:43:42

Comparing candidate commit fa07162 in PR branch pierre/enable-sidecar-by-default with baseline commit c795fcd in branch master.

Found 6 performance improvements and 0 performance regressions! Performance is the same for 172 metrics, 0 unstable metrics.

scenario:ComposerTelemetryBench/benchTelemetryParsing

  • 🟩 execution_time [-3.072µs; -1.328µs] or [-5.197%; -2.248%]

scenario:ComposerTelemetryBench/benchTelemetryParsing-opcache

  • 🟩 execution_time [-4.586µs; -1.814µs] or [-7.291%; -2.884%]

scenario:ContextPropagationBench/benchInject64Bit

  • 🟩 execution_time [-465.393ns; -190.607ns] or [-5.970%; -2.445%]

scenario:ContextPropagationBench/benchInject64Bit-opcache

  • 🟩 execution_time [-515.418ns; -206.582ns] or [-6.602%; -2.646%]

scenario:EmptyFileBench/benchEmptyFileBaseline-opcache

  • 🟩 execution_time [-192.105µs; -57.535µs] or [-7.485%; -2.242%]

scenario:MessagePackSerializationBench/benchMessagePackSerialization

  • 🟩 execution_time [-5.762µs; -4.478µs] or [-3.793%; -2.948%]

@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch from 96cde75 to 0344bb0 Compare June 3, 2024 12:40
@pierotibou pierotibou marked this pull request as ready for review June 4, 2024 18:11
@pierotibou pierotibou requested review from a team as code owners June 4, 2024 18:11
Comment thread ext/ddtrace.c
get_global_DD_TRACE_AGENT_STACK_BACKLOG());
}
#endif

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The code paths are just to complicated for my brain, but why is it safe to move this code to dd_activate_once?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Background sender thread is only actually needed once spans may actually be flushed. And that never happens before dd_activate_once.

Comment thread ext/ddtrace.h Outdated
#endif

#ifndef _WIN32
void disable_sidecar_sending(void);
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick: this function does not seem to be used elsewhere but in ddtrace.c. So you could declare it before its usage (+ make it static) and remove the declaration from here

--TEST--
Sidecar should be enabled by default on PHP 8.3
--SKIPIF--
<?php include 'startup_logging_skipif_unix_83.inc'; ?>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The name is a bit confusing. What about startup_logging_skip_unless_unix_83?

Also, what about moving the files to the includes directory

@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch from 0344bb0 to 46ca434 Compare June 6, 2024 00:51
Copy link
Copy Markdown
Collaborator Author

@pierotibou pierotibou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM functionnaly speaking.
Thanks a lot for going through with finishing implementation and adding telemetry

@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch 7 times, most recently from 90f1fef to c4d648a Compare June 7, 2024 18:30
@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch from c4d648a to 446a704 Compare June 7, 2024 19:49
Signed-off-by: Bob Weinand <[email protected]>
@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch from 446a704 to a0edcc0 Compare June 7, 2024 20:11
Copy link
Copy Markdown
Collaborator Author

@pierotibou pierotibou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cannot approve my own PR (even though, it's clearly not my PR anymore :p)

Overall LGTM, I just have a few questions. Also realizing that the sidecar sets _top_level I would have rather not if not agentless.

$rootTraceAssertion = function ($i) {
return SpanAssertion::exists("do_manual_instrumentation_within_root_trace_function", "run $i")
->withChildren([
SpanAssertion::exists("first-sub-operation")->withChildren(
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't get why those have changed

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

normalization changes. Do you want to revert it?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd rather not mess around unnecessarily by now.

Comment thread tests/Integrations/PCNTL/PCNTLTest.php
}
if (isset($spanMetrics["_top_level"])) {
// Set by sidecar only
unset($spanMetrics['_top_level']);
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sidecar, if not agentless, shouldn't set, for the sake of consistency with the other tracers.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Java is setting _dd.top_level, this is one set only by the agent

@bwoebi bwoebi force-pushed the pierre/enable-sidecar-by-default branch from fa07162 to 1085733 Compare June 7, 2024 21:55
Copy link
Copy Markdown
Collaborator

@bwoebi bwoebi left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As Pierre cannot self-approve :-)

@bwoebi bwoebi merged commit c5f2dcb into master Jun 7, 2024
@bwoebi bwoebi deleted the pierre/enable-sidecar-by-default branch June 7, 2024 23:02
@github-actions github-actions Bot added this to the 1.1.0 milestone Jun 7, 2024
pierotibou added a commit that referenced this pull request Jun 10, 2024
morrisonlevi pushed a commit that referenced this pull request Jun 10, 2024
* Enable sidecar by default, only when telemetry is enabled

* Manually set sidecar config to false

Signed-off-by: Bob Weinand <[email protected]>

* minor comments in the tests

* add a test to make sure sidecar is enabled by default in 8.3

* Delay bgs initialization until sidecar sender status is finalized

Signed-off-by: Bob Weinand <[email protected]>

* Fix crash

Signed-off-by: Bob Weinand <[email protected]>

* Add telemetry for telemetry disabled

Signed-off-by: Bob Weinand <[email protected]>

* Fix mem leak

Signed-off-by: Bob Weinand <[email protected]>

* Hack to massage sidecar v0.7 into what is expected by tests

Signed-off-by: Bob Weinand <[email protected]>

* Fix telemetry path

Signed-off-by: Bob Weinand <[email protected]>

* More test stability

Signed-off-by: Bob Weinand <[email protected]>

* Fix header name

* Update libdatadog

* Test fixes

Signed-off-by: Bob Weinand <[email protected]>

* In the agent sampling test, telemetry conflicts with sidecar

Manually set sidecar sender config.

Signed-off-by: Bob Weinand <[email protected]>

* Avoid parseMultipleRequestsFromDumpedData with sidecar

* Skip valgrind test

Signed-off-by: Bob Weinand <[email protected]>

* Turn sidecar sender off in valgrind tests because of false positives

Signed-off-by: Bob Weinand <[email protected]>

---------

Signed-off-by: Bob Weinand <[email protected]>
Co-authored-by: Bob Weinand <[email protected]>
Co-authored-by: Björn Antonsson <[email protected]>
Co-authored-by: Luc Vieillescazes <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants