From 564aba47c7af28f87a835bdc5a4e1f0cf602e810 Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Fri, 26 Jun 2026 13:59:38 -0400 Subject: [PATCH 1/8] Promote RUM MCP toolset to GA in documentation - 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 --- content/en/mcp_server/setup.md | 2 +- content/en/mcp_server/tools.md | 29 ++++++++++++++++++++++++++--- 2 files changed, 27 insertions(+), 4 deletions(-) diff --git a/content/en/mcp_server/setup.md b/content/en/mcp_server/setup.md index 226af20e701..d834506ea8f 100644 --- a/content/en/mcp_server/setup.md +++ b/content/en/mcp_server/setup.md @@ -682,6 +682,7 @@ These toolsets are generally available. See [Datadog MCP Server Tools][49] for a - `product-analytics`: Tools for interacting with [Product Analytics][41] queries - `profiling`: Tools for discovering, exploring, and analyzing [Continuous Profiler][58] data - `reference-tables`: Tools for managing [Reference Tables][48], including listing tables, reading rows, appending rows, and creating tables from cloud storage +- `rum`: Tools for [Real User Monitoring][57], including resolving applications, summarizing performance, surfacing aggregated insights, reading retention filters and metrics, and managing custom RUM metrics - `security`: Tools for code security scanning and searching [security signals][39] and [security findings][40] - `software-delivery`: Tools for interacting with Software Delivery ([CI Visibility][30] and [Test Optimization][31]) - `synthetics`: Tools for interacting with Datadog [Synthetic tests][29] @@ -694,7 +695,6 @@ These toolsets are in Preview. Sign up for a toolset by completing the Product P - `apm`: ([Sign up][45]) Tools for in-depth [APM][34] trace analysis, span search, Watchdog insights, and performance investigation - `code-exec`: ([Sign up][60]) A single tool that runs agent-authored TypeScript in a Datadog-managed sandbox with direct access to Datadog APIs, for multi-signal investigation and ad-hoc data exploration in one call - `remote-actions`: ([Sign up][62]) Tools for on-host diagnostics, including reading files, listing directories, and running safe read-only shell commands directly on instrumented hosts through the Agent -- `rum`: Tools for [Real User Monitoring][57], including summarizing application performance, inspecting application configuration, and running performance investigations ## Supported clients diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index 8dd879b8047..8adfade80aa 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -204,6 +204,15 @@ Search Datadog RUM events using advanced query syntax. - 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? + ### `create_datadog_notebook` *Toolset: **core***\ *Permissions Required: `Notebooks Read` and `Notebooks Write`*\ @@ -1210,9 +1219,7 @@ Runs a read-only shell command on a specified host. Supported commands include: ## RUM -Tools for [Real User Monitoring][58], including resolving applications, summarizing performance, surfacing aggregated insights for views, exploring metrics, and inspecting application configuration. - -
The rum toolset is in Preview. Contact Datadog support to request access.
+Tools for [Real User Monitoring][58], including resolving applications, summarizing performance, surfacing aggregated insights for views, exploring metrics, inspecting application configuration, and managing custom RUM metrics. ### `search_rum_applications` *Toolset: **rum***\ @@ -1254,6 +1261,22 @@ Lists retention filters configured on a RUM application. Read-only; available fo - List the retention filters configured on the "checkout-web" application. - What retention filters do I have on my main RUM app? +### `upsert_rum_metric` +*Toolset: **rum***\ +*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ +Creates or updates a custom RUM metric. Checks immutable fields before updating an existing metric. This operation is idempotent. + +- Create a custom RUM metric that counts page views on the checkout page, grouped by country. +- Update the filter on my "error-rate-by-service" custom metric to exclude bot traffic. + +### `delete_rum_metric` +*Toolset: **rum***\ +*Permissions Required: `RUM Generate Metrics`*\ +Permanently deletes a custom RUM metric by ID. This operation is destructive and idempotent. + +- Delete the custom RUM metric with ID "my-custom-metric". +- Remove the "legacy-page-views" RUM metric from my organization. + ## Security Tools for code security scanning, analyzing, searching and triaging [security signals][53], managing [detection rules][60] and [suppressions][61], and analyzing [security findings][54]. From f8ca80f1bfcbf06d41e8995dfbab3b9d76e6465b Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Fri, 26 Jun 2026 18:52:08 -0400 Subject: [PATCH 2/8] Fix metric ID format in upsert and delete RUM metric examples Use rum.. naming convention; hyphens are not valid in RUM metric IDs. --- content/en/mcp_server/tools.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index 8adfade80aa..47752218db1 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -1266,16 +1266,16 @@ Lists retention filters configured on a RUM application. Read-only; available fo *Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ Creates or updates a custom RUM metric. Checks immutable fields before updating an existing metric. This operation is idempotent. -- Create a custom RUM metric that counts page views on the checkout page, grouped by country. -- Update the filter on my "error-rate-by-service" custom metric to exclude bot traffic. +- Create a custom RUM metric `rum.view.checkout_page_views` that counts page views on the checkout page, grouped by country. +- Update the filter on the `rum.error.error_rate_by_service` custom metric to exclude bot traffic. ### `delete_rum_metric` *Toolset: **rum***\ *Permissions Required: `RUM Generate Metrics`*\ Permanently deletes a custom RUM metric by ID. This operation is destructive and idempotent. -- Delete the custom RUM metric with ID "my-custom-metric". -- Remove the "legacy-page-views" RUM metric from my organization. +- Delete the custom RUM metric `rum.view.my_custom_metric`. +- Remove the `rum.view.legacy_page_views` RUM metric from my organization. ## Security From 36192894c2a370352ed2229fa33ea800a82fba71 Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Fri, 26 Jun 2026 18:55:52 -0400 Subject: [PATCH 3/8] Improve upsert_rum_metric examples to show monitoring use cases 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. --- content/en/mcp_server/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index 47752218db1..cd8227cc402 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -1266,8 +1266,8 @@ Lists retention filters configured on a RUM application. Read-only; available fo *Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ Creates or updates a custom RUM metric. Checks immutable fields before updating an existing metric. This operation is idempotent. -- Create a custom RUM metric `rum.view.checkout_page_views` that counts page views on the checkout page, grouped by country. -- Update the filter on the `rum.error.error_rate_by_service` custom metric to exclude bot traffic. +- Create a distribution metric `rum.view.lcp_by_country` that tracks p95 LCP for view events, grouped by country. +- Update the filter on `rum.error.checkout_errors` to exclude synthetic test traffic. ### `delete_rum_metric` *Toolset: **rum***\ From b7b756f46b31d9c7294faaddf9eb504b52ce8a81 Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Fri, 26 Jun 2026 19:00:40 -0400 Subject: [PATCH 4/8] Add RUM Apps Read permission to delete_rum_metric --- content/en/mcp_server/tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index cd8227cc402..d106308580d 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -1271,7 +1271,7 @@ Creates or updates a custom RUM metric. Checks immutable fields before updating ### `delete_rum_metric` *Toolset: **rum***\ -*Permissions Required: `RUM Generate Metrics`*\ +*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ Permanently deletes a custom RUM metric by ID. This operation is destructive and idempotent. - Delete the custom RUM metric `rum.view.my_custom_metric`. From 078b94c64b765c052f9e361462f7f4c7131b341a Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Mon, 29 Jun 2026 09:46:11 -0400 Subject: [PATCH 5/8] Remove redundant 'destructive' from delete_rum_metric description --- content/en/mcp_server/tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index d106308580d..058ae1acf4c 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -1272,7 +1272,7 @@ Creates or updates a custom RUM metric. Checks immutable fields before updating ### `delete_rum_metric` *Toolset: **rum***\ *Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ -Permanently deletes a custom RUM metric by ID. This operation is destructive and idempotent. +Permanently deletes a custom RUM metric by ID. This operation is idempotent. - Delete the custom RUM metric `rum.view.my_custom_metric`. - Remove the `rum.view.legacy_page_views` RUM metric from my organization. From 6e766f5479be72fcfc450bd0553b3f74049e71f9 Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Tue, 30 Jun 2026 17:02:41 -0400 Subject: [PATCH 6/8] Document RUM retention filter write tools in MCP Server docs --- content/en/mcp_server/setup.md | 2 +- content/en/mcp_server/tools.md | 34 +++++++++++++++++++++++++++++++++- 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/content/en/mcp_server/setup.md b/content/en/mcp_server/setup.md index d834506ea8f..f6e4059797f 100644 --- a/content/en/mcp_server/setup.md +++ b/content/en/mcp_server/setup.md @@ -682,7 +682,7 @@ These toolsets are generally available. See [Datadog MCP Server Tools][49] for a - `product-analytics`: Tools for interacting with [Product Analytics][41] queries - `profiling`: Tools for discovering, exploring, and analyzing [Continuous Profiler][58] data - `reference-tables`: Tools for managing [Reference Tables][48], including listing tables, reading rows, appending rows, and creating tables from cloud storage -- `rum`: Tools for [Real User Monitoring][57], including resolving applications, summarizing performance, surfacing aggregated insights, reading retention filters and metrics, and managing custom RUM metrics +- `rum`: Tools for [Real User Monitoring][57], including resolving applications, summarizing performance, surfacing aggregated insights, exploring metrics, managing retention filters, and managing custom RUM metrics - `security`: Tools for code security scanning and searching [security signals][39] and [security findings][40] - `software-delivery`: Tools for interacting with Software Delivery ([CI Visibility][30] and [Test Optimization][31]) - `synthetics`: Tools for interacting with Datadog [Synthetic tests][29] diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index 058ae1acf4c..094b2ca18e3 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -1219,7 +1219,7 @@ Runs a read-only shell command on a specified host. Supported commands include: ## RUM -Tools for [Real User Monitoring][58], including resolving applications, summarizing performance, surfacing aggregated insights for views, exploring metrics, inspecting application configuration, and managing custom RUM metrics. +Tools for [Real User Monitoring][58], including resolving applications, summarizing performance, surfacing aggregated insights for views, exploring metrics, inspecting application configuration, managing retention filters, and managing custom RUM metrics. ### `search_rum_applications` *Toolset: **rum***\ @@ -1261,6 +1261,38 @@ Lists retention filters configured on a RUM application. Read-only; available fo - List the retention filters configured on the "checkout-web" application. - What retention filters do I have on my main RUM app? +### `append_new_rum_retention_filter` +*Toolset: **rum***\ +*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ +Creates a RUM retention filter, appended to the end of the evaluation order. Retention filters control which RUM events are indexed and retained, which affects billing. Confirm the change before applying. + +- Create a retention filter on "checkout-web" that retains 100% of error events. +- Add a filter to my main RUM app that keeps all sessions matching `@view.url_path:/checkout`. + +### `update_rum_retention_filter` +*Toolset: **rum***\ +*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ +Updates an existing RUM retention filter's attributes in place, such as its name, event type, query, sample rate, or enabled state. Affects data retention and billing. Confirm the change before applying. + +- Increase the sample rate on the "checkout errors" retention filter to 100%. +- Disable the "long tasks" retention filter on my main RUM app. + +### `reorder_rum_retention_filters` +*Toolset: **rum***\ +*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ +Sets the full evaluation order of a RUM application's retention filters. Filters are evaluated top-down and each event stops at the first match, so order determines which sample rate applies. Affects data retention and billing. Confirm the new order before applying. + +- Move the "checkout errors" retention filter above the catch-all filter on "checkout-web". +- Reorder my retention filters so the specific filters are evaluated before the broad ones. + +### `delete_rum_retention_filter` +*Toolset: **rum***\ +*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ +Permanently deletes a RUM retention filter by ID. This action cannot be undone and affects data retention and billing. Confirm the deletion before applying. This operation is idempotent. + +- Delete the "legacy sessions" retention filter from "checkout-web". +- Remove the retention filter with ID `abc-123-def` from my main RUM app. + ### `upsert_rum_metric` *Toolset: **rum***\ *Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ From f62d870d0dc18a80ef73cd954b1e147e7cf51e51 Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Tue, 30 Jun 2026 17:34:48 -0400 Subject: [PATCH 7/8] Address PR feedback: trim retention filter wording, label RUM-event tools --- content/en/mcp_server/tools.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index 094b2ca18e3..eb57ec130dc 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -196,7 +196,7 @@ Searches logs with filters (time, query, service, host, storage tier, and so on) - Get all 500 status code logs from production. ### `search_datadog_rum_events` -*Toolset: **core***\ +*Toolset: **core**, **rum***\ *Permissions Required: `RUM Apps Read`*\ Search Datadog RUM events using advanced query syntax. @@ -205,7 +205,7 @@ Search Datadog RUM events using advanced query syntax. - Show recent user interactions on product detail pages. ### `aggregate_rum_events` -*Toolset: **core***\ +*Toolset: **core**, **rum***\ *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. @@ -1272,7 +1272,7 @@ Creates a RUM retention filter, appended to the end of the evaluation order. Ret ### `update_rum_retention_filter` *Toolset: **rum***\ *Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ -Updates an existing RUM retention filter's attributes in place, such as its name, event type, query, sample rate, or enabled state. Affects data retention and billing. Confirm the change before applying. +Updates an existing RUM retention filter's attributes in place, such as its name, event type, query, sample rate, or enabled state. Confirm the change before applying. - Increase the sample rate on the "checkout errors" retention filter to 100%. - Disable the "long tasks" retention filter on my main RUM app. @@ -1280,7 +1280,7 @@ Updates an existing RUM retention filter's attributes in place, such as its name ### `reorder_rum_retention_filters` *Toolset: **rum***\ *Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ -Sets the full evaluation order of a RUM application's retention filters. Filters are evaluated top-down and each event stops at the first match, so order determines which sample rate applies. Affects data retention and billing. Confirm the new order before applying. +Sets the full evaluation order of a RUM application's retention filters. Filters are evaluated top-down and each event stops at the first match, so order determines which sample rate applies. Confirm the new order before applying. - Move the "checkout errors" retention filter above the catch-all filter on "checkout-web". - Reorder my retention filters so the specific filters are evaluated before the broad ones. @@ -1288,7 +1288,7 @@ Sets the full evaluation order of a RUM application's retention filters. Filters ### `delete_rum_retention_filter` *Toolset: **rum***\ *Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\ -Permanently deletes a RUM retention filter by ID. This action cannot be undone and affects data retention and billing. Confirm the deletion before applying. This operation is idempotent. +Permanently deletes a RUM retention filter by ID. Confirm the deletion before applying. This operation is idempotent. - Delete the "legacy sessions" retention filter from "checkout-web". - Remove the retention filter with ID `abc-123-def` from my main RUM app. From 83867c9b779e29b3d108f5a310dd97bdcd27242e Mon Sep 17 00:00:00 2001 From: Samuel Colmanetti Date: Wed, 1 Jul 2026 15:14:39 -0400 Subject: [PATCH 8/8] Group RUM metric and retention filter tools together in tools.md --- content/en/mcp_server/tools.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/content/en/mcp_server/tools.md b/content/en/mcp_server/tools.md index eb57ec130dc..8afa6d6e83f 100644 --- a/content/en/mcp_server/tools.md +++ b/content/en/mcp_server/tools.md @@ -1253,6 +1253,22 @@ Explores RUM metrics for an application, including out-of-the-box metrics and cu - List the custom RUM metrics defined on the "checkout-web" application. - Show me available RUM metrics related to page load time on my main app. +### `upsert_rum_metric` +*Toolset: **rum***\ +*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ +Creates or updates a custom RUM metric. Checks immutable fields before updating an existing metric. This operation is idempotent. + +- Create a distribution metric `rum.view.lcp_by_country` that tracks p95 LCP for view events, grouped by country. +- Update the filter on `rum.error.checkout_errors` to exclude synthetic test traffic. + +### `delete_rum_metric` +*Toolset: **rum***\ +*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ +Permanently deletes a custom RUM metric by ID. This operation is idempotent. + +- Delete the custom RUM metric `rum.view.my_custom_metric`. +- Remove the `rum.view.legacy_page_views` RUM metric from my organization. + ### `search_rum_retention_filters` *Toolset: **rum***\ *Permissions Required: `RUM Retention Filters Read`*\ @@ -1293,22 +1309,6 @@ Permanently deletes a RUM retention filter by ID. Confirm the deletion before ap - Delete the "legacy sessions" retention filter from "checkout-web". - Remove the retention filter with ID `abc-123-def` from my main RUM app. -### `upsert_rum_metric` -*Toolset: **rum***\ -*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ -Creates or updates a custom RUM metric. Checks immutable fields before updating an existing metric. This operation is idempotent. - -- Create a distribution metric `rum.view.lcp_by_country` that tracks p95 LCP for view events, grouped by country. -- Update the filter on `rum.error.checkout_errors` to exclude synthetic test traffic. - -### `delete_rum_metric` -*Toolset: **rum***\ -*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\ -Permanently deletes a custom RUM metric by ID. This operation is idempotent. - -- Delete the custom RUM metric `rum.view.my_custom_metric`. -- Remove the `rum.view.legacy_page_views` RUM metric from my organization. - ## Security Tools for code security scanning, analyzing, searching and triaging [security signals][53], managing [detection rules][60] and [suppressions][61], and analyzing [security findings][54].