Skip to content

Document browser profiling quota API endpoint and proxy/CSP setup#36894

Merged
thomasbertet merged 3 commits into
masterfrom
thomas.bertet/browser-profiling-quota-docs
May 22, 2026
Merged

Document browser profiling quota API endpoint and proxy/CSP setup#36894
thomasbertet merged 3 commits into
masterfrom
thomas.bertet/browser-profiling-quota-docs

Conversation

@thomasbertet
Copy link
Copy Markdown
Contributor

What does this PR do?

Adds documentation for the quota check API call made by the Browser SDK when Browser Profiling is enabled.

Changes

content/en/real_user_monitoring/_index.md

  • Adds a new "Additional endpoints for Browser Profiling" subsection under "Supported endpoints for SDK domains", listing the quota. subdomain URLs for all 8 Datadog sites (e.g. https://quota.browser-intake-datadoghq.com).
  • Includes a note that proxy and CSP users must allow these domains.

content/en/real_user_monitoring/correlate_with_other_telemetry/profiling/_index.mdoc.md

  • Adds a new Step 3 "Quota check" in the browser setup section, explaining:
    • The SDK calls /api/v2/profiling/quota before starting a profiling session
    • The call goes to a quota. subdomain of the standard RUM intake
    • Proxy and CSP users must explicitly allow this domain

content/en/real_user_monitoring/guide/proxy-rum-data.mdoc.md

  • Documents the ddforwardSubdomain query parameter sent when using a string proxy, which tells the proxy which intake subdomain to target (quota for profiling quota requests).
  • Documents the subdomain property in the function proxy options object (alongside existing path and parameters), used for the same purpose.

Motivation

The Browser SDK's profiling quota check reaches a new quota. subdomain that wasn't previously documented. Customers using a proxy or CSP restrictions would silently fail to collect profiling data without this information.

@github-actions github-actions Bot added Guide Content impacting a guide cdocs labels May 21, 2026
@thomasbertet thomasbertet force-pushed the thomas.bertet/browser-profiling-quota-docs branch from e9ab35e to c32e75d Compare May 21, 2026 11:28
@thomasbertet thomasbertet force-pushed the thomas.bertet/browser-profiling-quota-docs branch from c32e75d to 09a3faf Compare May 21, 2026 11:34
@thomasbertet thomasbertet marked this pull request as ready for review May 21, 2026 15:30
@thomasbertet thomasbertet requested review from a team as code owners May 21, 2026 15:30
@janine-c janine-c self-assigned this May 21, 2026
Copy link
Copy Markdown
Contributor

@janine-c janine-c left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Magnificent! Just a couple very minor writing suggestions, but we should be good to go!

Comment thread content/en/real_user_monitoring/guide/proxy-rum-data.mdoc.md Outdated
Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com>
@thomasbertet thomasbertet merged commit b947fcf into master May 22, 2026
16 checks passed
@thomasbertet thomasbertet deleted the thomas.bertet/browser-profiling-quota-docs branch May 22, 2026 08:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cdocs Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants