Skip to content

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

Draft
sstonehill12 wants to merge 13 commits into
masterfrom
sarah.stonehill/di-logs-sunset-and-live-debugger-ga
Draft

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

Conversation

@sstonehill12

Copy link
Copy Markdown
Contributor

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

tylfin and others added 8 commits June 22, 2026 15:24
- 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
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>
@sstonehill12 sstonehill12 requested a review from a team as a code owner June 26, 2026 14:27
@github-actions github-actions Bot added the Images Images are added/removed with this PR label Jun 26, 2026
@github-actions

github-actions Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

@datadog-official

datadog-official Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Pipelines

Fix all issues with BitsAI

⚠️ Warnings

🚦 1 Pipeline job failed

DataDog/documentation | set_redirect_metadata_preview   View in Datadog   GitLab

Useful? React with 👍 / 👎

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 40a841b | Docs | Datadog PR Page | Give us feedback!

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

Copy link
Copy Markdown
Contributor

Added card for editorial review from Docs team.

@sstonehill12 sstonehill12 marked this pull request as draft June 26, 2026 20:38
@sstonehill12 sstonehill12 added the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 26, 2026
@sstonehill12 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
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review Images Images are added/removed with this PR WORK IN PROGRESS No review needed, it's a wip ;)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants