Sunset DI log probes and prepare Live Debugger docs for GA by sstonehill12 · Pull Request #37791 · DataDog/documentation

sstonehill12 · 2026-06-26T14:27:39Z

What does this PR do? What is the motivation?

Fixes DOCS-XXXXX

Consolidates and extends the changes from #37664 (Live Debugger GA prep) and #37757 (DI log probe sunset), then restructures the Dynamic Instrumentation enablement docs to lead with in-app enablement.

Includes:

From Prepare Live Debugger docs for GA #37664: Removes Limited Availability callouts from Ruby/PHP/Go DI enabling pages. Replaces the in-app vs. env var enablement table on the Live Debugger page with three enablement modes (Automatic, Enabled, Disabled), updates minimum tracer versions, updates permissions to the new Live Debugger Read / Write / Redaction Write set, and documents mode-based and identifier-based sensitive data redaction.
From [WIP] Remove log probes from DI docs; redirect to Live Debugger #37757: Removes log probes from the DI docs (log capture has moved to Live Debugger), updates "probe" terminology to "instrumentation," removes Node.js/Ruby/Go from the DI language selector (these languages only supported log probes for DI), and removes the related log probe screenshots and blog post link.
Additional edits on top of the two source PRs:
- Updates the source:dd_debugger reference on the Live Debugger page to say "All Live Debugger logs" (was "Dynamic Instrumentation logs").
- Restructures the Enable Dynamic Instrumentation section on the main DI page to lead with in-app enablement, list the minimum tracer versions that support remote enablement (Java ≥ 1.64.0, Python ≥ 4.11.0, .NET ≥ 3.46.0), and call out manual enablement as required for PHP and older tracers, or as an alternative for env-var-based bulk management.
- Adds an intro to the DI Enabling subpage that points users to in-app enablement before they follow the manual per-language instructions.
- Adds a small callout on the DI page noting that DI and Live Debugger share enablement state per service and environment (separate permissions and Settings pages).

Merge instructions

Merge readiness:

Ready for merge

Additional notes

This PR is intended to supersede Prepare Live Debugger docs for GA #37664 and [WIP] Remove log probes from DI docs; redirect to Live Debugger #37757; those can be closed once this lands.
Node.js, Ruby, and Go DI enabling pages remain private: true (set in [WIP] Remove log probes from DI docs; redirect to Live Debugger #37757). Equivalent manual-enable instructions for those languages will move to tabs on the Live Debugger page in a follow-up edit to this branch.

- Remove Limited Availability callouts from the Ruby, PHP, and Go Dynamic Instrumentation setup pages - Replace the in-app vs. environment variable setup table with Automatic, Enabled, and Disabled enablement modes - Add minimum tracer versions and note that older tracers may require environment variable enablement - Update Live Debugger permissions to Live Debugger Read, Live Debugger Write, and Live Debugger Redaction Write - Document mode-based and identifier-based sensitive data redaction - Remove outdated screenshots and demo videos from the Live Debugger page

…ugger

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Rewrite the Enable Dynamic Instrumentation section on the main DI page around three enablement modes (Automatic, Enabled, Disabled), list minimum tracer versions that support in-app enablement, and call out manual enablement as required for PHP and older tracers, or as an alternative for env-var-based bulk management. Add an intro to the enabling subpage that points users back to the main DI page for in-app enablement before they follow the per-language manual instructions. Add a callout noting that DI and Live Debugger share enablement state per service and environment. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

github-actions · 2026-06-26T14:32:04Z

Preview links (active after the `build_preview` check completes)

Modified Files

brett0000FF · 2026-06-26T20:29:38Z

Added card for editorial review from Docs team.

Replace the three-mode (Automatic/Enabled/Disabled) framing copied from Live Debugger with the actual DI Settings page behavior: a binary Enable/Disable action per service and environment, plus automatic enablement attempted on first instrumentation creation when all prerequisites are met. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Replace the card grid that linked back to DI enabling subpages with a tabbed manual-enablement section directly on the Live Debugger page. Tabs cover Java, Python, .NET, Node.js, PHP, Ruby, and Go, each with prereqs, env-var setup, and a next-step link. Add a callout explaining that DI and Live Debugger share the underlying enablement state and the DD_DYNAMIC_INSTRUMENTATION_ENABLED environment variable. Reorder the minimum tracer versions list to match the tab order. Remove the "Why DI instructions?" callout — Live Debugger setup is now self-contained. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Create a new Enable Live Debugger sub-page at /tracing/live_debugger/enabling/ that mirrors the Dynamic Instrumentation enabling sub-page structure but uses tabs in place of language cards. The sub-page covers manual env-var enablement for Java, Python, .NET, Node.js, PHP, Ruby, and Go, and points users back to the main Live Debugger page for in-app enablement details. On the main Live Debugger page, replace the tabbed Manual enablement section with short pointers to the new sub-page. Add a one-line reference to the Bits Live Debugger setup page in the same section, and mirror that reference on the new sub-page. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Move Minimum tracer versions above Enabling Live Debugger. - Rename Enablement modes to Enabling Live Debugger and reorganize the section to lead with per-language enablement behavior (Java/Python/ .NET/Node.js auto-enable, Ruby/PHP tracer-level manual, Go Agent-level manual then in-app or env var). - Nest Enablement modes and Manual enablement as H4 subsections under Enabling Live Debugger. - Move the Bits Live Debugger pointer into an alert callout directly under the Enabling Live Debugger heading. - Add a Preview beta-callout to the Bits Live Debugger section, matching the treatment on the Bits Live Debugger sub-page. - Rename the manual enablement sub-page H1 to "Enabling Live Debugger". Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

The Go DI enabling page covered three Agent-level configuration methods (system-probe.yaml, env var, Helm). Restore all three on the Live Debugger enabling sub-page, formatted as a list rather than nested tabs since nested tabs aren't a pattern used elsewhere in the docs. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Expand Requirements list: add Unified Service Tagging as a required prereq and Source Code Integration as a recommended prereq. Rename "APM-instrumented application" to "Datadog SDK installed". - Replace the multi-subsection enablement block with a single per-language tab section using programming-lang-wrapper. Each tab covers the language-specific requirements and environment variable setup for that runtime. - Introduce the tabs with a short explainer describing Settings-page enablement for eligible languages, environment-variable enablement for other languages and older tracers, and Settings-page disabling always being available. - Remove the Manual enablement H4 (now absorbed into per-language tabs). - Remove the trailing pointer under Minimum tracer versions (now covered by the explainer above the tabs). - Delete the /tracing/live_debugger/enabling/ sub-page. All content lives on the main page. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Remove the "and other PII" phrasing from the Targeted Mode description; Live Debugger's Targeted Mode is not a general PII redactor. - Note in the Strict Mode bullet that Bits Live Debugger is unavailable when a service and environment are set to Strict Mode. - Add a matching one-line note to the Bits Live Debugger section pointing back to the mode-based redaction anchor, so users landing in that section see the requirement without hunting. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Align the Live Debugger main page, Dynamic Instrumentation main page, and DI enabling subpage with the Datadog SDK terminology adopted in #35358. Standalone "tracer" (in version phrases like "minimum tracer versions" or "older tracer versions") becomes "SDK". Per-language link text on the Live Debugger main page adopts the "Datadog <Language> SDK" convention already used in other APM docs. Package identifiers such as ddtrace, dd-trace-js, and dd-trace-php stay in parentheticals as concrete package names. The DI per-language enabling pages (Java, Python, .NET, PHP) still use older "Tracing library" phrasing and are left out of this pass to keep the PR footprint contained. External URLs like dtdg.co/latest-java-tracer are unchanged. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…bugger-ga

tylfin and others added 8 commits June 22, 2026 15:24

Remove log probes from DI docs; redirect to Live Debugger

ee8972d

Remove screenshots from metric, span, and span tag sections

bded4cd

Remove Node.js, Ruby, and Go from enabling page language selector

fc14868

Merge PR #37664: Prepare Live Debugger docs for GA

69a92a5

Merge PR #37757: Remove log probes from DI docs; redirect to Live Deb…

15336cf

…ugger

Update source:dd_debugger reference to Live Debugger logs

cc68b0b

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

sstonehill12 requested a review from a team as a code owner June 26, 2026 14:27

github-actions Bot added the Images Images are added/removed with this PR label Jun 26, 2026

This comment has been minimized.

Sign in to view

brett0000FF assigned brett0000FF and unassigned brett0000FF Jun 26, 2026

brett0000FF added the editorial review Waiting on a more in-depth review label Jun 26, 2026

sstonehill12 marked this pull request as draft June 26, 2026 20:38

sstonehill12 added the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 26, 2026

sstonehill12 changed the title ~~[DOCS-XXXXX] Sunset DI log probes and prepare Live Debugger docs for GA~~ [WIP] Sunset DI log probes and prepare Live Debugger docs for GA Jun 26, 2026

sstonehill12 and others added 5 commits June 26, 2026 17:10

tylfin mentioned this pull request Jul 8, 2026

docs(live-debugger): embed setup instructions #38038

Closed

1 task

tylfin reviewed Jul 13, 2026

View reviewed changes

Comment thread content/en/tracing/live_debugger/_index.md

tylfin reviewed Jul 13, 2026

View reviewed changes

Comment thread content/en/tracing/live_debugger/_index.md Outdated

sstonehill12 and others added 3 commits July 14, 2026 16:26

sstonehill12 commented Jul 15, 2026

View reviewed changes

Comment thread content/en/tracing/live_debugger/_index.md Outdated

Apply suggestion from @sstonehill12

03df9e0

sstonehill12 changed the title ~~[WIP] Sunset DI log probes and prepare Live Debugger docs for GA~~ Sunset DI log probes and prepare Live Debugger docs for GA Jul 15, 2026

Merge branch 'master' into sarah.stonehill/di-logs-sunset-and-live-de…

081ecfa

…bugger-ga

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Sunset DI log probes and prepare Live Debugger docs for GA#37791

Sunset DI log probes and prepare Live Debugger docs for GA#37791
sstonehill12 wants to merge 18 commits into
masterfrom
sarah.stonehill/di-logs-sunset-and-live-debugger-ga

sstonehill12 commented Jun 26, 2026

Uh oh!

github-actions Bot commented Jun 26, 2026 •

edited

Loading

Uh oh!

This comment has been minimized.

brett0000FF commented Jun 26, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

sstonehill12 commented Jun 26, 2026

What does this PR do? What is the motivation?

Merge instructions

Additional notes

Uh oh!

github-actions Bot commented Jun 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview links (active after the build_preview check completes)

Modified Files

Uh oh!

This comment has been minimized.

brett0000FF commented Jun 26, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions Bot commented Jun 26, 2026 •

edited

Loading

Preview links (active after the `build_preview` check completes)