Skip to content

Promote RUM MCP toolset to GA#37810

Merged
samcolmanetti merged 8 commits into
masterfrom
sam.colmanetti/rum-mcp-docs-ga
Jul 1, 2026
Merged

Promote RUM MCP toolset to GA#37810
samcolmanetti merged 8 commits into
masterfrom
sam.colmanetti/rum-mcp-docs-ga

Conversation

@samcolmanetti

@samcolmanetti samcolmanetti commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Promotes the rum toolset from Preview to GA in the MCP Server documentation:

  • Moves rum from the Preview toolsets section to GA in setup.md
  • Adds a ## RUM section to tools.md documenting upsert_rum_metric and delete_rum_metric
  • Adds aggregate_rum_events to tools.md and labels both search_datadog_rum_events and aggregate_rum_events with the core and rum toolsets
  • Documents the four RUM retention filter write tools: append_new_rum_retention_filter, update_rum_retention_filter, reorder_rum_retention_filters, and delete_rum_retention_filter
  • Updates the rum toolset summary in setup.md to reflect that retention filters are now manageable, not just readable
  • Uses correct RUM metric ID format (rum.<event_type>.<description>) in all examples
  • Uses monitoring-oriented examples (LCP distribution, checkout error filtering) rather than page view counts, which are already covered by built-in metrics

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

@samcolmanetti samcolmanetti requested a review from a team as a code owner June 26, 2026 22:35
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Possible site support note detected

The following files have a site-region shortcode at the top of the page that mentions a feature being "not available" or "not supported":

  • content/en/mcp_server/setup.md

Are you trying to document site support for a product? If so, the site-region shortcode is not the recommended approach. See the Documenting site support guide for the preferred method.

@github-actions

Copy link
Copy Markdown
Contributor

@samcolmanetti samcolmanetti changed the title [DOCS-0000] Promote RUM MCP toolset to GA Promote RUM MCP toolset to GA Jun 26, 2026
@samcolmanetti samcolmanetti requested a review from qsellem June 26, 2026 23:29
@datadog-prod-us1-6

This comment has been minimized.

@estherk15 estherk15 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Left one minor suggestion, but it doesn't block this PR!

Comment thread content/en/mcp_server/tools.md Outdated
Comment on lines 198 to +215
### `search_datadog_rum_events`
*Toolset: **core***\
*Permissions Required: `RUM Apps Read`*\
Search Datadog RUM events using advanced query syntax.

- Show JavaScript errors and console warnings in RUM.
- Find pages that are loading slowly (more than 3 seconds).
- Show recent user interactions on product detail pages.

### `aggregate_rum_events`
*Toolset: **core***\
*Permissions Required: `RUM Apps Read`*\
Aggregates RUM events to compute counts, sums, averages, min, max, cardinality, and percentiles, with grouping support. Use this for statistical analysis and trend data, not for inspecting individual events.

- Count JavaScript errors by page in the last 24 hours.
- Show me the p95 loading time grouped by country for my main RUM application.
- How many sessions had a Core Web Vitals failure this week?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We should add the rum toolset next to **core**

Also, as get_datadog_dashboard and upsert_datadog_dashboard, should we move the two core/rum overlapping tools to the beginning of the RUM section, instead of buried inside Core ?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

i updated to add rum to the list of toolsets on the search and aggregate tools in core. i ended up leaving them under the core section so customers can more easily see what the default tools are. don't feel strongly about it. @qsellem let me know if you have a preference.

@samcolmanetti samcolmanetti force-pushed the sam.colmanetti/rum-mcp-docs-ga branch from a82d766 to f878849 Compare June 30, 2026 21:37
- Remove Preview alert from the RUM toolset section in tools.md
- Add upsert_rum_metric and delete_rum_metric to the RUM toolset section
- Add aggregate_rum_events to the core toolset section
- Move rum from Preview toolsets to Available toolsets in setup.md
Use rum.<event_type>.<description> naming convention; hyphens are not
valid in RUM metric IDs.
Replace page view count example (covered by OOTB metrics and Product
Analytics) with LCP distribution and checkout error examples that
reflect the intended alerting/monitoring purpose of custom metrics.
@samcolmanetti samcolmanetti force-pushed the sam.colmanetti/rum-mcp-docs-ga branch from 055bf95 to 83867c9 Compare July 1, 2026 19:17
@samcolmanetti samcolmanetti merged commit b339c70 into master Jul 1, 2026
16 checks passed
@samcolmanetti samcolmanetti deleted the sam.colmanetti/rum-mcp-docs-ga branch July 1, 2026 20:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants