⚗ [RUM-11393] Add Start/StopResource API by BeltranBulbarellaDD · Pull Request #4110 · DataDog/browser-sdk

BeltranBulbarellaDD · 2026-01-22T09:55:02Z

Motivation

Discussed in this RFC

Following the same pattern as for start/stopAction, this PR introduces a manual resource tracking API.

Since start/stopAction and start/stopResource follow similar patterns, created eventTracker the idea is to reuse it for all events which have start/stop logic.

Changes

New Experimental Feature

Added START_STOP_RESOURCE feature flag

New Public APIs

Added startResource(url, options?) and stopResource(url, options?) to RumPublicApi

Architecture Refactoring

Extracted eventTracker: Shared utility for managing start/stop lifecycle (used by both actions and resources)
Refactored trackManualActions.ts to use the shared utility
Added trackManualResources.ts for manual resource lifecycle
Removed trackAction as it is now replaced by eventTracker

Test instructions

I used this HTML file to test locally.

Example Resource

Example in Flutter web.

Checklist

Tested locally
Tested on staging
Added unit tests for this change.
Added e2e/integration tests for this change.

cit-pr-commenter-54b7da · 2026-01-22T10:12:19Z

Bundles Sizes Evolution

📦 Bundle Name	Base Size	Local Size	𝚫	𝚫%	Status
Rum	168.98 KiB	170.71 KiB	+1.73 KiB	+1.03%	✅
Rum Profiler	4.31 KiB	4.31 KiB	+1 B	+0.02%	✅
Rum Recorder	24.54 KiB	24.54 KiB	+1 B	+0.00%	✅
Logs	56.27 KiB	56.32 KiB	+44 B	+0.08%	✅
Flagging	944 B	944 B	0 B	0.00%	✅
Rum Slim	125.82 KiB	127.44 KiB	+1.62 KiB	+1.29%	✅
Worker	23.63 KiB	23.63 KiB	0 B	0.00%	✅

🚀 CPU Performance

Action Name	Base CPU Time (ms)	Local CPU Time (ms)	𝚫%
RUM - add global context	0.0044	0.0043	-2.27%
RUM - add action	0.0138	0.0144	+4.35%
RUM - add error	0.014	0.0134	-4.29%
RUM - add timing	0.0031	0.0026	-16.13%
RUM - start view	0.0134	0.0137	+2.24%
RUM - start/stop session replay recording	0.0007	0.0008	+14.29%
Logs - log message	0.0156	0.015	-3.85%

🧠 Memory Performance

Action Name	Base Memory Consumption	Local Memory Consumption	𝚫
RUM - add global context	27.34 KiB	27.60 KiB	+266 B
RUM - add action	102.81 KiB	97.62 KiB	-5.19 KiB
RUM - add timing	26.94 KiB	26.40 KiB	-560 B
RUM - add error	106.71 KiB	99.25 KiB	-7.46 KiB
RUM - start/stop session replay recording	26.38 KiB	25.45 KiB	-943 B
RUM - start view	471.81 KiB	459.91 KiB	-11.90 KiB
Logs - log message	46.96 KiB	46.66 KiB	-304 B

🔗 RealWorld

datadog-official · 2026-01-22T10:15:41Z

✅ Tests

🎉 All green!

❄️ No new flaky tests detected
🧪 All tests passed

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

🔗 Commit SHA: bb72b7f | Docs | Datadog PR Page | Was this helpful? Give us feedback!}

BeltranBulbarellaDD · 2026-01-23T10:06:08Z

@codex pls review.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 998c7a9b5f

ℹ️ 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".

packages/rum-core/src/domain/resource/trackManualResources.ts

packages/rum-core/src/domain/manualEventLifecycle.ts

packages/rum-core/src/domain/resource/trackManualResources.ts

…le to manualEventRegistry, refactor manualEventRegistry.

BeltranBulbarellaDD · 2026-01-27T08:52:04Z

@codex pls review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 69aa0b9ef0

ℹ️ 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".

packages/rum-core/src/domain/resource/trackManualResources.ts

…which merges eventRegistry and actionTracker.

BeltranBulbarellaDD · 2026-01-29T15:19:16Z

@codex can you pls review?

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1d19e7c3ea

ℹ️ 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".

packages/rum-core/src/domain/resource/trackManualResources.ts

…iscard. Switched to makeRumPublicApiWithDefaults which has built-in cleanup in startResource / stopResource

BeltranBulbarellaDD · 2026-01-29T15:44:13Z

@codex pls review now?

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 83054aa544

ℹ️ 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".

packages/rum-core/src/domain/resource/trackManualResources.ts

BeltranBulbarellaDD · 2026-01-30T08:53:39Z

@codex pls review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c6ec7ebdfb

ℹ️ 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".

packages/rum-core/src/domain/resource/trackManualResources.ts

BeltranBulbarellaDD · 2026-01-30T12:59:03Z

@codex pls review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7d07e62855

ℹ️ 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".

packages/rum-core/src/domain/action/trackClickActions.ts

BeltranBulbarellaDD · 2026-01-30T13:29:06Z

@codex pls review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9294b1d657

ℹ️ 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".

packages/rum-core/src/domain/resource/trackManualResources.ts

packages/rum-core/src/domain/action/computeFrustration.ts

packages/rum-core/src/domain/action/trackClickActions.ts

packages/rum-core/src/domain/action/trackManualActions.ts

packages/rum-core/src/domain/eventTracker.ts

BenoitZugmeyer · 2026-02-02T14:35:37Z

packages/rum-core/src/domain/resource/trackManualResources.ts

+  }
+
+  function startManualResource(url: string, options: ResourceOptions = {}, startClocks = clocksNow()) {
+    if (!isAllowedRequestUrl(url)) {


suggestion: this is probably unnecessary

I added it because of this Codex Review.

packages/rum-core/src/domain/resource/trackManualResources.ts

BeltranBulbarellaDD · 2026-02-03T15:47:38Z

@codex pls review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d8ef180bf1

ℹ️ 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".

packages/rum-core/src/boot/rumPublicApi.ts

…card and eventCounts from eventTracker. Use ClickActionBase type for click actions.

…izeClicks, linting fixes.

BeltranBulbarellaDD added 2 commits January 22, 2026 10:51

refactor manual tracking, add s/s resource

a49b4e9

Fix format and lint

40945d9

BeltranBulbarellaDD changed the title ~~refactor manual tracking, add s/s resource~~ ⚗ [RUM-11393] Add Start/StopResource API Jan 22, 2026

BeltranBulbarellaDD added 2 commits January 22, 2026 12:01

Remove stopResourceWithError

aeae65f

Add e2e test, merge unit tests, add telemetry

998c7a9

chatgpt-codex-connector bot reviewed Jan 23, 2026

View reviewed changes

packages/rum-core/src/domain/resource/trackManualResources.ts Outdated Show resolved Hide resolved

BeltranBulbarellaDD commented Jan 23, 2026

View reviewed changes

packages/rum-core/src/domain/manualEventLifecycle.ts Outdated Show resolved Hide resolved

Prevent event.resource.type access for manual resources

668bda0

BenoitZugmeyer reviewed Jan 26, 2026

View reviewed changes

BeltranBulbarellaDD added 3 commits January 26, 2026 13:50

Merge branch 'main' into beltran.bulbarella/start-stopResource

e4a5a36

Add optional fields to RawRumResourceEvent, rename manualEventLifecyc…

684d9dc

…le to manualEventRegistry, refactor manualEventRegistry.

Remove unneded check because of combine.

69aa0b9

chatgpt-codex-connector bot reviewed Jan 27, 2026

View reviewed changes

packages/rum-core/src/domain/resource/trackManualResources.ts Outdated Show resolved Hide resolved

BeltranBulbarellaDD added 5 commits January 27, 2026 10:19

Fix sanitizeIfLongDataUrl in trackManualResources

65d9f8b

Remove duplicate tests to use manualEventRegistry

0dd0466

Merge branch 'main' into beltran.bulbarella/start-stopResource

e16e523

Refactored action and resource tracking to use the new event tracker …

144b1ec

…which merges eventRegistry and actionTracker.

Merge branch 'main' into beltran.bulbarella/start-stopResource

1d19e7c

chatgpt-codex-connector bot reviewed Jan 29, 2026

View reviewed changes

packages/rum-core/src/domain/resource/trackManualResources.ts Outdated Show resolved Hide resolved

Updated eventTracker.ts to pass startClocks as third parameter to onD…

83054aa

…iscard. Switched to makeRumPublicApiWithDefaults which has built-in cleanup in startResource / stopResource

chatgpt-codex-connector bot reviewed Jan 29, 2026

View reviewed changes

packages/rum-core/src/domain/resource/trackManualResources.ts Show resolved Hide resolved

Don't allow resources to be started with undefined URL.

c6ec7eb

chatgpt-codex-connector bot reviewed Jan 30, 2026

View reviewed changes

packages/rum-core/src/domain/resource/trackManualResources.ts Outdated Show resolved Hide resolved

Filter out intake requests in manual resource tracking

7d07e62

chatgpt-codex-connector bot reviewed Jan 30, 2026

View reviewed changes

packages/rum-core/src/domain/action/trackClickActions.ts Outdated Show resolved Hide resolved

Add stopObservable.notify() in the discard() method

9294b1d

chatgpt-codex-connector bot reviewed Jan 30, 2026

View reviewed changes

packages/rum-core/src/domain/resource/trackManualResources.ts Outdated Show resolved Hide resolved

Simplify activityEndTime checks

1161c24

BeltranBulbarellaDD marked this pull request as ready for review February 2, 2026 14:01

BeltranBulbarellaDD requested a review from a team as a code owner February 2, 2026 14:01

BenoitZugmeyer reviewed Feb 2, 2026

View reviewed changes

BeltranBulbarellaDD added 3 commits February 3, 2026 15:19

Simplify and remove unnecessary code.

a1e6d11

Return getCounts in eventTracker. Rollback hasPageActivity.

8169e5a

Merge branch 'main' into beltran.bulbarella/start-stopResource

d8ef180

chatgpt-codex-connector bot reviewed Feb 3, 2026

View reviewed changes

packages/rum-core/src/boot/rumPublicApi.ts Show resolved Hide resolved

BeltranBulbarellaDD added 5 commits February 4, 2026 10:20

Make name required in ActionEventData.

7c4a484

Refactor action to have click and manual event trackers. Remove onDis…

555d774

…card and eventCounts from eventTracker. Use ClickActionBase type for click actions.

Fix tests

6f43388

Refactor isChildEvent, add getCounts to eventTracker because of final…

116783f

…izeClicks, linting fixes.

Merge branch 'main' into beltran.bulbarella/start-stopResource

bb72b7f

BenoitZugmeyer approved these changes Feb 10, 2026

View reviewed changes

Conversation

BeltranBulbarellaDD commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation

Changes

Test instructions

Checklist

Uh oh!

cit-pr-commenter-54b7da bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundles Sizes Evolution

Uh oh!

datadog-official bot commented Jan 22, 2026 • edited by datadog-datadog-prod-us1 bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 23, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 27, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 29, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 29, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 30, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 30, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

BeltranBulbarellaDD commented Jan 30, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

BenoitZugmeyer Feb 2, 2026

Choose a reason for hiding this comment

BeltranBulbarellaDD commented Jan 22, 2026 •

edited

Loading

cit-pr-commenter-54b7da bot commented Jan 22, 2026 •

edited

Loading

datadog-official bot commented Jan 22, 2026 •

edited by datadog-datadog-prod-us1 bot

Loading