Add bootstrap development guidelines #9821

PerfectSlayer · 2025-10-21T17:44:48Z

What Does This Do

This PR adds documentation about pitfalls and guideline implementation the agent bootstrap.
It also includes an addition about logging guidelines for instrumentations.

Motivation

The goal is to capture the knowledge so it would make it easier for contributors to avoid common pitfalls that might not be caught by testing.

Additional Notes

Refers to the discussions from both internal Slack channel and #9780

cc @mcculls who's the most knowledgeable about this part.
I would like to make sure I get it right. Feel free to edit the PR or add comment for me to amend the doc 🙏

Contributor Checklist

Format the title according the contribution guidelines
Assign the type: and (comp: or inst:) labels in addition to any useful labels
Don't use close, fix or any linking keywords when referencing an issue.
Use solves instead, and assign the PR milestone to the issue
Update the CODEOWNERS file on source file addition, move, or deletion
Update the public documentation in case of new configuration flag or behavior

Jira ticket: [PROJ-IDENT]

github-actions · 2025-10-21T17:45:04Z

Hi! 👋 Thanks for your pull request! 🎉

To help us review it, please make sure to:

Add at least one type, and one component or instrumentation label to the pull request

If you need help, please check our contributing guidelines.

datadog-datadog-prod-us1 · 2025-10-21T17:50:06Z

🎯 Code Coverage
• Patch Coverage: 100.00%
• Total Coverage: 59.70% (-0.00%)

View detailed report

_{This comment will be updated automatically if new data arrives.

🔗 Commit SHA: 487b8dd | Docs | Was this helpful? Give us feedback!}

pr-commenter · 2025-10-21T18:06:26Z

Benchmarks

Startup

Parameters

	Baseline	Candidate
baseline_or_candidate	baseline	candidate
git_branch	master	bbujon/doc
git_commit_date	1761174241	1761213298
git_commit_sha	`f42a6e9`	`487b8dd`
release_version	1.55.0-SNAPSHOT~f42a6e9909	1.55.0-SNAPSHOT~487b8ddca4

See matching parameters

	Baseline	Candidate
application	insecure-bank	insecure-bank
ci_job_date	1761215315	1761215315
ci_job_id	1193447387	1193447387
ci_pipeline_id	80064706	80064706
cpu_model	Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz	Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz
kernel_version	Linux runner-zfyrx7zua-project-304-concurrent-0-92gnu7aq 6.8.0-1031-aws #33~22.04.1-Ubuntu SMP Thu Jun 26 14:22:30 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux	Linux runner-zfyrx7zua-project-304-concurrent-0-92gnu7aq 6.8.0-1031-aws #33~22.04.1-Ubuntu SMP Thu Jun 26 14:22:30 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux
module	Agent	Agent
parent	None	None

Summary

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

Startup time reports for insecure-bank

gantt
    title insecure-bank - global startup overhead: candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909

    dateFormat X
    axisFormat %s
section tracing
Agent [baseline] (1.028 s) : 0, 1028237
Total [baseline] (8.675 s) : 0, 8674804
Agent [candidate] (1.027 s) : 0, 1027176
Total [candidate] (8.685 s) : 0, 8684579
section iast
Agent [baseline] (1.176 s) : 0, 1176447
Total [baseline] (9.444 s) : 0, 9444359
Agent [candidate] (1.15 s) : 0, 1149752
Total [candidate] (9.271 s) : 0, 9271164

baseline results

Module	Variant	Duration	Δ tracing
Agent	tracing	1.028 s	-
Agent	iast	1.176 s	148.21 ms (14.4%)
Total	tracing	8.675 s	-
Total	iast	9.444 s	769.556 ms (8.9%)

candidate results

Module	Variant	Duration	Δ tracing
Agent	tracing	1.027 s	-
Agent	iast	1.15 s	122.577 ms (11.9%)
Total	tracing	8.685 s	-
Total	iast	9.271 s	586.585 ms (6.8%)

gantt
    title insecure-bank - break down per module: candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909

    dateFormat X
    axisFormat %s
section tracing
crashtracking [baseline] (1.463 ms) : 0, 1463
crashtracking [candidate] (1.466 ms) : 0, 1466
BytebuddyAgent [baseline] (701.065 ms) : 0, 701065
BytebuddyAgent [candidate] (699.729 ms) : 0, 699729
GlobalTracer [baseline] (244.369 ms) : 0, 244369
GlobalTracer [candidate] (244.826 ms) : 0, 244826
AppSec [baseline] (32.181 ms) : 0, 32181
AppSec [candidate] (32.488 ms) : 0, 32488
Debugger [baseline] (6.364 ms) : 0, 6364
Debugger [candidate] (6.41 ms) : 0, 6410
Remote Config [baseline] (677.459 µs) : 0, 677
Remote Config [candidate] (685.341 µs) : 0, 685
Telemetry [baseline] (14.501 ms) : 0, 14501
Telemetry [candidate] (9.298 ms) : 0, 9298
Flare Poller [baseline] (6.379 ms) : 0, 6379
Flare Poller [candidate] (10.963 ms) : 0, 10963
section iast
crashtracking [baseline] (1.476 ms) : 0, 1476
crashtracking [candidate] (1.474 ms) : 0, 1474
BytebuddyAgent [baseline] (835.206 ms) : 0, 835206
BytebuddyAgent [candidate] (813.764 ms) : 0, 813764
GlobalTracer [baseline] (236.365 ms) : 0, 236365
GlobalTracer [candidate] (231.363 ms) : 0, 231363
AppSec [baseline] (28.409 ms) : 0, 28409
AppSec [candidate] (35.161 ms) : 0, 35161
Debugger [baseline] (6.158 ms) : 0, 6158
Debugger [candidate] (6.201 ms) : 0, 6201
Remote Config [baseline] (614.053 µs) : 0, 614
Remote Config [candidate] (595.687 µs) : 0, 596
Telemetry [baseline] (8.57 ms) : 0, 8570
Telemetry [candidate] (8.706 ms) : 0, 8706
Flare Poller [baseline] (4.157 ms) : 0, 4157
Flare Poller [candidate] (4.293 ms) : 0, 4293
IAST [baseline] (33.805 ms) : 0, 33805
IAST [candidate] (26.714 ms) : 0, 26714

Startup time reports for petclinic

gantt
    title petclinic - global startup overhead: candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909

    dateFormat X
    axisFormat %s
section tracing
Agent [baseline] (1.028 s) : 0, 1027919
Total [baseline] (10.801 s) : 0, 10801385
Agent [candidate] (1.018 s) : 0, 1018118
Total [candidate] (10.759 s) : 0, 10758593
section appsec
Agent [baseline] (1.205 s) : 0, 1205468
Total [baseline] (11.013 s) : 0, 11012595
Agent [candidate] (1.198 s) : 0, 1198292
Total [candidate] (10.937 s) : 0, 10936792
section iast
Agent [baseline] (1.159 s) : 0, 1159219
Total [baseline] (11.111 s) : 0, 11111160
Agent [candidate] (1.158 s) : 0, 1157794
Total [candidate] (11.078 s) : 0, 11078228
section profiling
Agent [baseline] (1.172 s) : 0, 1171963
Total [baseline] (10.914 s) : 0, 10913593
Agent [candidate] (1.168 s) : 0, 1167716
Total [candidate] (10.887 s) : 0, 10886887

baseline results

Module	Variant	Duration	Δ tracing
Agent	tracing	1.028 s	-
Agent	appsec	1.205 s	177.549 ms (17.3%)
Agent	iast	1.159 s	131.3 ms (12.8%)
Agent	profiling	1.172 s	144.044 ms (14.0%)
Total	tracing	10.801 s	-
Total	appsec	11.013 s	211.209 ms (2.0%)
Total	iast	11.111 s	309.775 ms (2.9%)
Total	profiling	10.914 s	112.208 ms (1.0%)

candidate results

Module	Variant	Duration	Δ tracing
Agent	tracing	1.018 s	-
Agent	appsec	1.198 s	180.173 ms (17.7%)
Agent	iast	1.158 s	139.676 ms (13.7%)
Agent	profiling	1.168 s	149.598 ms (14.7%)
Total	tracing	10.759 s	-
Total	appsec	10.937 s	178.199 ms (1.7%)
Total	iast	11.078 s	319.635 ms (3.0%)
Total	profiling	10.887 s	128.294 ms (1.2%)

gantt
    title petclinic - break down per module: candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909

    dateFormat X
    axisFormat %s
section tracing
crashtracking [baseline] (1.459 ms) : 0, 1459
crashtracking [candidate] (1.458 ms) : 0, 1458
BytebuddyAgent [baseline] (701.257 ms) : 0, 701257
BytebuddyAgent [candidate] (692.909 ms) : 0, 692909
GlobalTracer [baseline] (244.498 ms) : 0, 244498
GlobalTracer [candidate] (243.241 ms) : 0, 243241
AppSec [baseline] (32.037 ms) : 0, 32037
AppSec [candidate] (32.194 ms) : 0, 32194
Debugger [baseline] (6.321 ms) : 0, 6321
Debugger [candidate] (6.28 ms) : 0, 6280
Remote Config [baseline] (686.408 µs) : 0, 686
Remote Config [candidate] (680.183 µs) : 0, 680
Telemetry [baseline] (14.893 ms) : 0, 14893
Telemetry [candidate] (9.331 ms) : 0, 9331
Flare Poller [baseline] (5.648 ms) : 0, 5648
Flare Poller [candidate] (10.846 ms) : 0, 10846
section appsec
crashtracking [baseline] (1.471 ms) : 0, 1471
crashtracking [candidate] (1.454 ms) : 0, 1454
BytebuddyAgent [baseline] (727.182 ms) : 0, 727182
BytebuddyAgent [candidate] (720.829 ms) : 0, 720829
GlobalTracer [baseline] (236.831 ms) : 0, 236831
GlobalTracer [candidate] (235.286 ms) : 0, 235286
AppSec [baseline] (174.786 ms) : 0, 174786
AppSec [candidate] (174.537 ms) : 0, 174537
Debugger [baseline] (5.925 ms) : 0, 5925
Debugger [candidate] (6.112 ms) : 0, 6112
Remote Config [baseline] (622.426 µs) : 0, 622
Remote Config [candidate] (643.238 µs) : 0, 643
Telemetry [baseline] (8.47 ms) : 0, 8470
Telemetry [candidate] (9.313 ms) : 0, 9313
Flare Poller [baseline] (3.931 ms) : 0, 3931
Flare Poller [candidate] (3.904 ms) : 0, 3904
IAST [baseline] (25.088 ms) : 0, 25088
IAST [candidate] (24.929 ms) : 0, 24929
section iast
crashtracking [baseline] (1.457 ms) : 0, 1457
crashtracking [candidate] (1.459 ms) : 0, 1459
BytebuddyAgent [baseline] (822.002 ms) : 0, 822002
BytebuddyAgent [candidate] (819.75 ms) : 0, 819750
GlobalTracer [baseline] (233.663 ms) : 0, 233663
GlobalTracer [candidate] (232.934 ms) : 0, 232934
AppSec [baseline] (30.621 ms) : 0, 30621
AppSec [candidate] (35.362 ms) : 0, 35362
Debugger [baseline] (6.142 ms) : 0, 6142
Debugger [candidate] (6.186 ms) : 0, 6186
Remote Config [baseline] (593.261 µs) : 0, 593
Remote Config [candidate] (613.424 µs) : 0, 613
Telemetry [baseline] (8.412 ms) : 0, 8412
Telemetry [candidate] (8.787 ms) : 0, 8787
Flare Poller [baseline] (4.179 ms) : 0, 4179
Flare Poller [candidate] (4.258 ms) : 0, 4258
IAST [baseline] (30.827 ms) : 0, 30827
IAST [candidate] (26.842 ms) : 0, 26842
section profiling
crashtracking [baseline] (1.453 ms) : 0, 1453
crashtracking [candidate] (1.455 ms) : 0, 1455
BytebuddyAgent [baseline] (725.739 ms) : 0, 725739
BytebuddyAgent [candidate] (723.157 ms) : 0, 723157
GlobalTracer [baseline] (220.308 ms) : 0, 220308
GlobalTracer [candidate] (219.691 ms) : 0, 219691
AppSec [baseline] (32.206 ms) : 0, 32206
AppSec [candidate] (32.373 ms) : 0, 32373
Debugger [baseline] (13.884 ms) : 0, 13884
Debugger [candidate] (6.636 ms) : 0, 6636
Remote Config [baseline] (1.473 ms) : 0, 1473
Remote Config [candidate] (694.492 µs) : 0, 694
Telemetry [baseline] (8.218 ms) : 0, 8218
Telemetry [candidate] (15.231 ms) : 0, 15231
Flare Poller [baseline] (4.09 ms) : 0, 4090
Flare Poller [candidate] (4.988 ms) : 0, 4988
ProfilingAgent [baseline] (109.247 ms) : 0, 109247
ProfilingAgent [candidate] (109.735 ms) : 0, 109735
Profiling [baseline] (109.862 ms) : 0, 109862
Profiling [candidate] (110.387 ms) : 0, 110387

Load

Parameters

	Baseline	Candidate
baseline_or_candidate	baseline	candidate
git_branch	master	bbujon/doc
git_commit_date	1761174241	1761213298
git_commit_sha	`f42a6e9`	`487b8dd`
release_version	1.55.0-SNAPSHOT~f42a6e9909	1.55.0-SNAPSHOT~487b8ddca4

See matching parameters

	Baseline	Candidate
application	insecure-bank	insecure-bank
ci_job_date	1761214983	1761214983
ci_job_id	1193447388	1193447388
ci_pipeline_id	80064706	80064706
cpu_model	Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz	Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz
kernel_version	Linux runner-zfyrx7zua-project-304-concurrent-0-xbh99z8y 6.8.0-1031-aws #33~22.04.1-Ubuntu SMP Thu Jun 26 14:22:30 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux	Linux runner-zfyrx7zua-project-304-concurrent-0-xbh99z8y 6.8.0-1031-aws #33~22.04.1-Ubuntu SMP Thu Jun 26 14:22:30 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux

Summary

Found 4 performance improvements and 1 performance regressions! Performance is the same for 7 metrics, 12 unstable metrics.

scenario	Δ mean http_req_duration	Δ mean throughput	candidate mean http_req_duration	candidate mean throughput	baseline mean http_req_duration	baseline mean throughput
scenario:load:insecure-bank:iast_FULL:high_load	better [-1188.090µs; -569.493µs] or [-8.052%; -3.859%]	unstable [-32.432op/s; +51.648op/s] or [-10.265%; +16.348%]	13.877ms	325.545op/s	14.756ms	315.938op/s
scenario:load:petclinic:profiling:high_load	better [-2.631ms; -1.696ms] or [-5.379%; -3.468%]	unstable [-1.319op/s; +12.653op/s] or [-1.378%; +13.222%]	46.744ms	101.367op/s	48.908ms	95.700op/s
scenario:load:petclinic:code_origins:high_load	better [-2.501ms; -1.649ms] or [-5.537%; -3.650%]	unstable [-1.026op/s; +13.774op/s] or [-0.991%; +13.301%]	43.097ms	109.937op/s	45.172ms	103.562op/s
scenario:load:petclinic:tracing:high_load	better [-1.931ms; -1.110ms] or [-4.294%; -2.468%]	unstable [-0.685op/s; +13.482op/s] or [-0.659%; +12.959%]	43.449ms	110.436op/s	44.970ms	104.037op/s
scenario:load:petclinic:iast:high_load	worse [+1.143ms; +1.961ms] or [+2.611%; +4.480%]	unstable [-9.841op/s; +5.179op/s] or [-9.208%; +4.846%]	45.317ms	104.544op/s	43.766ms	106.875op/s

Request duration reports for petclinic

gantt
    title petclinic - request duration [CI 0.99] : candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909
    dateFormat X
    axisFormat %s
section baseline
no_agent (36.999 ms) : 36702, 37295
.   : milestone, 36999,
appsec (47.286 ms) : 46864, 47707
.   : milestone, 47286,
code_origins (45.172 ms) : 44768, 45575
.   : milestone, 45172,
iast (43.766 ms) : 43387, 44144
.   : milestone, 43766,
profiling (48.908 ms) : 48452, 49364
.   : milestone, 48908,
tracing (44.97 ms) : 44574, 45366
.   : milestone, 44970,
section candidate
no_agent (37.314 ms) : 37014, 37613
.   : milestone, 37314,
appsec (48.2 ms) : 47765, 48636
.   : milestone, 48200,
code_origins (43.097 ms) : 42709, 43485
.   : milestone, 43097,
iast (45.317 ms) : 44936, 45699
.   : milestone, 45317,
profiling (46.744 ms) : 46333, 47155
.   : milestone, 46744,
tracing (43.449 ms) : 43082, 43816
.   : milestone, 43449,

baseline results

Variant	Request duration [CI 0.99]	Δ no_agent
no_agent	36.999 ms [36.702 ms, 37.295 ms]	-
appsec	47.286 ms [46.864 ms, 47.707 ms]	10.287 ms (27.8%)
code_origins	45.172 ms [44.768 ms, 45.575 ms]	8.173 ms (22.1%)
iast	43.766 ms [43.387 ms, 44.144 ms]	6.767 ms (18.3%)
profiling	48.908 ms [48.452 ms, 49.364 ms]	11.909 ms (32.2%)
tracing	44.97 ms [44.574 ms, 45.366 ms]	7.971 ms (21.5%)

candidate results

Variant	Request duration [CI 0.99]	Δ no_agent
no_agent	37.314 ms [37.014 ms, 37.613 ms]	-
appsec	48.2 ms [47.765 ms, 48.636 ms]	10.887 ms (29.2%)
code_origins	43.097 ms [42.709 ms, 43.485 ms]	5.783 ms (15.5%)
iast	45.317 ms [44.936 ms, 45.699 ms]	8.004 ms (21.5%)
profiling	46.744 ms [46.333 ms, 47.155 ms]	9.431 ms (25.3%)
tracing	43.449 ms [43.082 ms, 43.816 ms]	6.135 ms (16.4%)

Request duration reports for insecure-bank

gantt
    title insecure-bank - request duration [CI 0.99] : candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909
    dateFormat X
    axisFormat %s
section baseline
no_agent (4.327 ms) : 4274, 4381
.   : milestone, 4327,
iast (9.282 ms) : 9119, 9445
.   : milestone, 9282,
iast_FULL (14.756 ms) : 14458, 15054
.   : milestone, 14756,
iast_GLOBAL (11.022 ms) : 10820, 11223
.   : milestone, 11022,
profiling (9.116 ms) : 8967, 9264
.   : milestone, 9116,
tracing (7.768 ms) : 7657, 7880
.   : milestone, 7768,
section candidate
no_agent (4.253 ms) : 4203, 4304
.   : milestone, 4253,
iast (9.591 ms) : 9427, 9754
.   : milestone, 9591,
iast_FULL (13.877 ms) : 13600, 14154
.   : milestone, 13877,
iast_GLOBAL (11.286 ms) : 11079, 11494
.   : milestone, 11286,
profiling (9.113 ms) : 8968, 9259
.   : milestone, 9113,
tracing (7.945 ms) : 7832, 8058
.   : milestone, 7945,

baseline results

Variant	Request duration [CI 0.99]	Δ no_agent
no_agent	4.327 ms [4.274 ms, 4.381 ms]	-
iast	9.282 ms [9.119 ms, 9.445 ms]	4.955 ms (114.5%)
iast_FULL	14.756 ms [14.458 ms, 15.054 ms]	10.429 ms (241.0%)
iast_GLOBAL	11.022 ms [10.82 ms, 11.223 ms]	6.694 ms (154.7%)
profiling	9.116 ms [8.967 ms, 9.264 ms]	4.788 ms (110.6%)
tracing	7.768 ms [7.657 ms, 7.88 ms]	3.441 ms (79.5%)

candidate results

Variant	Request duration [CI 0.99]	Δ no_agent
no_agent	4.253 ms [4.203 ms, 4.304 ms]	-
iast	9.591 ms [9.427 ms, 9.754 ms]	5.337 ms (125.5%)
iast_FULL	13.877 ms [13.6 ms, 14.154 ms]	9.624 ms (226.3%)
iast_GLOBAL	11.286 ms [11.079 ms, 11.494 ms]	7.033 ms (165.4%)
profiling	9.113 ms [8.968 ms, 9.259 ms]	4.86 ms (114.3%)
tracing	7.945 ms [7.832 ms, 8.058 ms]	3.692 ms (86.8%)

Dacapo

Parameters

	Baseline	Candidate
baseline_or_candidate	baseline	candidate
git_branch	master	bbujon/doc
git_commit_date	1761174241	1761213298
git_commit_sha	`f42a6e9`	`487b8dd`
release_version	1.55.0-SNAPSHOT~f42a6e9909	1.55.0-SNAPSHOT~487b8ddca4

See matching parameters

	Baseline	Candidate
application	biojava	biojava
ci_job_date	1761215455	1761215455
ci_job_id	1193447389	1193447389
ci_pipeline_id	80064706	80064706
cpu_model	Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz	Intel(R) Xeon(R) Platinum 8259CL CPU @ 2.50GHz
kernel_version	Linux runner-zfyrx7zua-project-304-concurrent-0-xx4kbsxp 6.8.0-1031-aws #33~22.04.1-Ubuntu SMP Thu Jun 26 14:22:30 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux	Linux runner-zfyrx7zua-project-304-concurrent-0-xx4kbsxp 6.8.0-1031-aws #33~22.04.1-Ubuntu SMP Thu Jun 26 14:22:30 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux

Summary

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

Execution time for tomcat

gantt
    title tomcat - execution time [CI 0.99] : candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909
    dateFormat X
    axisFormat %s
section baseline
no_agent (1.469 ms) : 1457, 1480
.   : milestone, 1469,
appsec (2.455 ms) : 2403, 2506
.   : milestone, 2455,
iast (2.209 ms) : 2144, 2273
.   : milestone, 2209,
iast_GLOBAL (2.251 ms) : 2186, 2315
.   : milestone, 2251,
profiling (2.053 ms) : 2002, 2105
.   : milestone, 2053,
tracing (2.016 ms) : 1966, 2067
.   : milestone, 2016,
section candidate
no_agent (1.476 ms) : 1464, 1488
.   : milestone, 1476,
appsec (3.714 ms) : 3497, 3930
.   : milestone, 3714,
iast (2.202 ms) : 2138, 2266
.   : milestone, 2202,
iast_GLOBAL (2.245 ms) : 2181, 2309
.   : milestone, 2245,
profiling (2.066 ms) : 2013, 2119
.   : milestone, 2066,
tracing (2.027 ms) : 1977, 2076
.   : milestone, 2027,

baseline results

Variant	Execution Time [CI 0.99]	Δ no_agent
no_agent	1.469 ms [1.457 ms, 1.48 ms]	-
appsec	2.455 ms [2.403 ms, 2.506 ms]	986.132 µs (67.2%)
iast	2.209 ms [2.144 ms, 2.273 ms]	740.034 µs (50.4%)
iast_GLOBAL	2.251 ms [2.186 ms, 2.315 ms]	782.192 µs (53.3%)
profiling	2.053 ms [2.002 ms, 2.105 ms]	584.908 µs (39.8%)
tracing	2.016 ms [1.966 ms, 2.067 ms]	547.865 µs (37.3%)

candidate results

Variant	Execution Time [CI 0.99]	Δ no_agent
no_agent	1.476 ms [1.464 ms, 1.488 ms]	-
appsec	3.714 ms [3.497 ms, 3.93 ms]	2.238 ms (151.6%)
iast	2.202 ms [2.138 ms, 2.266 ms]	725.719 µs (49.2%)
iast_GLOBAL	2.245 ms [2.181 ms, 2.309 ms]	768.78 µs (52.1%)
profiling	2.066 ms [2.013 ms, 2.119 ms]	590.376 µs (40.0%)
tracing	2.027 ms [1.977 ms, 2.076 ms]	550.866 µs (37.3%)

Execution time for biojava

gantt
    title biojava - execution time [CI 0.99] : candidate=1.55.0-SNAPSHOT~487b8ddca4, baseline=1.55.0-SNAPSHOT~f42a6e9909
    dateFormat X
    axisFormat %s
section baseline
no_agent (15.511 s) : 15511000, 15511000
.   : milestone, 15511000,
appsec (14.901 s) : 14901000, 14901000
.   : milestone, 14901000,
iast (18.472 s) : 18472000, 18472000
.   : milestone, 18472000,
iast_GLOBAL (18.083 s) : 18083000, 18083000
.   : milestone, 18083000,
profiling (15.875 s) : 15875000, 15875000
.   : milestone, 15875000,
tracing (15.251 s) : 15251000, 15251000
.   : milestone, 15251000,
section candidate
no_agent (14.818 s) : 14818000, 14818000
.   : milestone, 14818000,
appsec (14.879 s) : 14879000, 14879000
.   : milestone, 14879000,
iast (18.582 s) : 18582000, 18582000
.   : milestone, 18582000,
iast_GLOBAL (18.109 s) : 18109000, 18109000
.   : milestone, 18109000,
profiling (15.575 s) : 15575000, 15575000
.   : milestone, 15575000,
tracing (15.083 s) : 15083000, 15083000
.   : milestone, 15083000,

baseline results

Variant	Execution Time [CI 0.99]	Δ no_agent
no_agent	15.511 s [15.511 s, 15.511 s]	-
appsec	14.901 s [14.901 s, 14.901 s]	-610.0 ms (-3.9%)
iast	18.472 s [18.472 s, 18.472 s]	2.961 s (19.1%)
iast_GLOBAL	18.083 s [18.083 s, 18.083 s]	2.572 s (16.6%)
profiling	15.875 s [15.875 s, 15.875 s]	364.0 ms (2.3%)
tracing	15.251 s [15.251 s, 15.251 s]	-260.0 ms (-1.7%)

candidate results

Variant	Execution Time [CI 0.99]	Δ no_agent
no_agent	14.818 s [14.818 s, 14.818 s]	-
appsec	14.879 s [14.879 s, 14.879 s]	61.0 ms (0.4%)
iast	18.582 s [18.582 s, 18.582 s]	3.764 s (25.4%)
iast_GLOBAL	18.109 s [18.109 s, 18.109 s]	3.291 s (22.2%)
profiling	15.575 s [15.575 s, 15.575 s]	757.0 ms (5.1%)
tracing	15.083 s [15.083 s, 15.083 s]	265.0 ms (1.8%)

docs/how_instrumentations_work.md

sarahchen6

LGTM (from someone who doesn't know the details about bootstrap and premain). All of the context is really helpful!

PerfectSlayer · 2025-10-23T09:58:23Z

LGTM (from someone who doesn't know the details about bootstrap and premain)

Thanks for the review and feedback 🙏
I asked Stuart to have a look. There is no rush so I can leave it open for some days :)

feat(doc): Add logging into instrumentation documentation

76a9cb1

PerfectSlayer requested a review from a team as a code owner October 21, 2025 17:44

PerfectSlayer requested a review from ygree October 21, 2025 17:44

PerfectSlayer added the type: documentation label Oct 21, 2025

PerfectSlayer requested a review from mcculls October 21, 2025 17:45

PerfectSlayer added the tag: no release notes Changes to exclude from release notes label Oct 21, 2025

sarahchen6 reviewed Oct 22, 2025

View reviewed changes

docs/how_instrumentations_work.md Outdated Show resolved Hide resolved

sarahchen6 approved these changes Oct 22, 2025

View reviewed changes

feat(doc): Add boostrap development guidelines

487b8dd

PerfectSlayer force-pushed the bbujon/doc branch from f945dbd to 487b8dd Compare October 23, 2025 09:56

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add bootstrap development guidelines #9821

Add bootstrap development guidelines #9821

PerfectSlayer commented Oct 21, 2025

Uh oh!

github-actions bot commented Oct 21, 2025

Uh oh!

datadog-datadog-prod-us1 bot commented Oct 21, 2025 •

edited

Loading

Uh oh!

pr-commenter bot commented Oct 21, 2025 •

edited

Loading

Uh oh!

Uh oh!

sarahchen6 left a comment

Uh oh!

PerfectSlayer commented Oct 23, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Add bootstrap development guidelines #9821

Are you sure you want to change the base?

Add bootstrap development guidelines #9821

Conversation

PerfectSlayer commented Oct 21, 2025

What Does This Do

Motivation

Additional Notes

Contributor Checklist

Uh oh!

github-actions bot commented Oct 21, 2025

Uh oh!

datadog-datadog-prod-us1 bot commented Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pr-commenter bot commented Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Benchmarks

Startup

Parameters

Summary

Load

Parameters

Summary

Dacapo

Parameters

Summary

Uh oh!

Uh oh!

sarahchen6 left a comment

Choose a reason for hiding this comment

Uh oh!

PerfectSlayer commented Oct 23, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

datadog-datadog-prod-us1 bot commented Oct 21, 2025 •

edited

Loading

pr-commenter bot commented Oct 21, 2025 •

edited

Loading