Vlad/315 profiling dev tooling

[vlad-scherbich]

prev: #19256 | next: #19258

Summary

Profiling bring-up scripts, compatibility baselines, Echion migration runbook (GAP-03).

Test plan

• scripts/run-profiling-tests --check-only passes on 3.15 (when available)
• Docs build / link check

[pr-commenter]

Benchmarks

Benchmark execution time: 2026-07-23 14:17:42

Comparing candidate commit 672f90d in PR branch vlad/315-profiling-dev-tooling with baseline commit 528a085 in branch main.

Found 0 performance improvements and 4 performance regressions! Performance is the same for 615 metrics, 10 unstable metrics.

scenario:iastaspects-lstrip_aspect

• 🟥 execution_time [+49.995µs; +54.331µs] or [+15.303%; +16.630%]

scenario:iastaspectsospath-ospathbasename_aspect

• 🟥 execution_time [+59.440µs; +70.673µs] or [+13.478%; +16.025%]

scenario:iastaspectssplit-rsplit_aspect

• 🟥 execution_time [+14.167µs; +17.160µs] or [+9.162%; +11.097%]

scenario:telemetryaddmetric-1-count-metric-1-times

• 🟥 execution_time [+230.663ns; +263.989ns] or [+10.914%; +12.491%]

[cit-pr-commenter-54b7da]

Codeowners resolved as

.claude/skills/type-annotate/SKILL.md                                   @DataDog/apm-core-python
AGENTS.md                                                               @DataDog/apm-core-python

[cit-pr-commenter-54b7da]

Circular import analysis

⚠️ Existing circular imports

There are 33 circular imports that already exist on the base branch and have not been changed by this PR.

Show existing cycles (showing 5 of 33 shortest)

ddtrace.internal.datastreams -> ddtrace.internal.datastreams.kafka -> ddtrace.internal.datastreams
ddtrace.internal.datastreams -> ddtrace.internal.datastreams.botocore -> ddtrace.internal.datastreams
ddtrace.internal.datastreams -> ddtrace.internal.datastreams.kombu -> ddtrace.internal.datastreams
ddtrace.internal.core -> ddtrace._trace.span -> ddtrace.internal.core
ddtrace.internal.datastreams -> ddtrace.internal.datastreams.aiokafka -> ddtrace.internal.datastreams

To see all cycles, download the cycles-base.json and cycles-pr.json artifacts from this CI job and run:

uv run --script scripts/import-analysis/cycles.py compare cycles-base.json cycles-pr.json