⚗️ Add Live Debugger lifetime event budgets

[watson]

Motivation

Add a circuit breaker so a single Live Debugger probe version cannot emit unbounded events over its lifetime.

Changes

Add new DD_DEBUGGER.init() options to configure lifetime budgets for:

• snapshot probe events
• non-snapshot probe events

Track emitted events per active probe version in the debugger runtime and automatically unregister probes once they exhaust their configured lifetime budget. Add unit tests covering snapshot and non-snapshot lifetime limits, skipping further collection after exhaustion, and resetting the budget when a new probe version is delivered.

Test instructions

1. Run yarn test:unit --spec packages/debugger/src/domain/api.spec.ts
2. In packages/debugger/src/entries/main.ts, verify that DebuggerInitConfiguration exposes:
   • maxSnapshotsPerProbeLifetime
   • maxNonSnapshotsPerProbeLifetime
3. In packages/debugger/src/domain/probes.ts, verify that initialized probes track:
   • eventsSentInLifetime
   • lifetimeBudgetWarningEmitted
4. In packages/debugger/src/domain/api.ts, verify that exhausted probes are removed after their final allowed send.

Checklist

• Tested locally
• Tested on staging
• Added unit tests for this change.
• Added e2e/integration tests for this change.
• Updated documentation and/or relevant AGENTS.md file

[watson]

• ⚗️ Add Live Debugger lifetime event budgets #4510 👈 (View in Graphite)
• Make Live Debugger per-second budgets configurable #4509
• Add Live Debugger package #4449 : 4 other dependent PRs (#4480 , #4503 , #4508 and 1 other)
• Fix TanStack Router lint resolution in test app #4513
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cit-pr-commenter-54b7da]

Bundles Sizes Evolution

📦 Bundle Name	Base Size	Local Size	𝚫	𝚫%	Status
Rum	169.51 KiB	169.51 KiB	0 B	0.00%	✅
Rum Profiler	5.97 KiB	5.97 KiB	0 B	0.00%	✅
Rum Recorder	21.23 KiB	21.23 KiB	0 B	0.00%	✅
Logs	54.70 KiB	54.70 KiB	0 B	0.00%	✅
Rum Slim	127.85 KiB	127.85 KiB	0 B	0.00%	✅
Worker	22.99 KiB	22.99 KiB	0 B	0.00%	✅

🚀 CPU Performance

Action Name	Base CPU Time (ms)	Local CPU Time (ms)	𝚫%
RUM - add global context	0.0031	0.0018	-41.94%
RUM - add action	0.0164	0.0101	-38.41%
RUM - add error	0.0137	0.0092	-32.85%
RUM - add timing	0.0007	0.0004	-42.86%
RUM - start view	0.0151	0.0091	-39.74%
RUM - start/stop session replay recording	0.0013	0.0006	-53.85%
Logs - log message	0.0234	0.014	-40.17%

🧠 Memory Performance

Action Name	Base Memory Consumption	Local Memory Consumption	𝚫
RUM - add global context	38.75 KiB	38.57 KiB	-187 B
RUM - add action	64.74 KiB	62.76 KiB	-1.98 KiB
RUM - add timing	36.82 KiB	38.06 KiB	+1.24 KiB
RUM - add error	70.81 KiB	68.12 KiB	-2.69 KiB
RUM - start/stop session replay recording	41.37 KiB	41.91 KiB	+557 B
RUM - start view	486.34 KiB	482.09 KiB	-4.25 KiB
Logs - log message	55.35 KiB	53.88 KiB	-1.47 KiB

🔗 RealWorld

[datadog-official]

🎉 All green!

❄️ No new flaky tests detected
🧪 All tests passed

🎯 Code Coverage (details)
• Patch Coverage: 63.33%
• Overall Coverage: 76.89% (-0.06%)

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

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 95da4144b2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[watson]

@codex address that feedback

[chatgpt-codex-connector]

Summary

• Updated debugger probe processing loops to iterate over a shallow copy (probes.slice()) in onEntry, onReturn, and onThrow, so probe removal after processing can’t cause sibling probes to be skipped due to array index shifting. packages/debugger/src/domain/api.tsL54-L60 packages/debugger/src/domain/api.tsL135-L149 packages/debugger/src/domain/api.tsL223-L231
• Added post-send exhaustion handling in onReturn and onThrow: after a successful enqueue, probes that just exhausted lifetime budget are collected and unregistered after the loop, preserving safe iteration while removing exhausted probes promptly. packages/debugger/src/domain/api.tsL201-L210 packages/debugger/src/domain/api.tsL286-L295
• Hardened queueDebuggerSnapshot to return a boolean, perform a lifetime-budget check immediately before enqueueing, and only increment/send when allowed. This ensures zero-budget probes cannot emit events even at enqueue time. packages/debugger/src/domain/api.tsL304-L312 packages/debugger/src/domain/api.tsL355-L358
• Committed changes with message: 🐛 Fix probe lifetime budget handling during iteration (commit ad79725) and created a follow-up PR message via make_pr summarizing the feedback fixes.

Testing

• ⚠️ yarn test:unit --spec packages/debugger/src/domain/api.spec.ts (failed due to environment limitation: ChromeHeadless binary not available; CHROME_BIN not set).

View task →

[watson]

Ignore the codex comment above. I didn't mean to ask it to try and fix anything