From 0a92a8f340d0229a881fdf0026cedfa60382a788 Mon Sep 17 00:00:00 2001 From: Olivier Vielpeau Date: Thu, 9 Oct 2025 19:51:45 +0200 Subject: [PATCH 1/4] Update agent-filtering-for-dogstatsd-custom-metrics.md with remote config + RBAC details --- ...-filtering-for-dogstatsd-custom-metrics.md | 25 ++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md index d0cb5bc7454ff..71f047863a2b3 100644 --- a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md +++ b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md @@ -30,9 +30,23 @@ Agent-side filtering enables you to filter out unused or unwanted DogStatsD cust Filtering is performed at the Agent level but centrally managed through the Datadog UI, giving teams full visibility and control. You can create, update, and manage filtering policies in Datadog, streamlining metric governance while maintaining transparency. +Creating and updating filtering policies requires the [`metric_tags_write`][1] RBAC permission. All users can view filtering policies. + +## Prerequisites + +- Upgrade to Datadog Agent v7.67.0 or higher (v7.70.0 or higher is recommended) +- Ensure that your RBAC permissions include [`org_management`][2] and that [Remote Configuration][3] is enabled for your organization. +- Ensure that your RBAC permissions include [`api_keys_write`][4] and that the [Remote Configuration capability is enabled on the API keys][5] used by your Agents. After enabling Remote Configuration on an API key, an Agent restart is required for Remote Configuration enablement to take effect. + +{{API Key properties with Remote Configuration capability Enable button.}} + ## Create a metric filtering policy -You can create a metric filtering policy from the [Metrics Settings page][1] or the [Metrics Summary page][2]. +You can create a metric filtering policy from the [Metrics Settings page][6] or the [Metrics Summary page][7]. + +Metric filtering policies are applied to all of the Agents v7.67.0+ with Remote Configuration enabled. Older Agent versions, or Agents with Remote Configuration disabled, do not apply filtering policies. + +Policy updates are deployed to Agents in ~1min (up to 2 minutes). ### From the Metrics Settings page @@ -184,5 +198,10 @@ This initial preview release includes the following limitations: {{< partial name="whats-next/whats-next.html" >}} -[1]: https://app.datadoghq.com/metric/settings/policies -[2]: https://app.datadoghq.com/metric/summary +[1]: /account_management/rbac/permissions/#metrics +[2]: /account_management/rbac/permissions/#access-management +[3]: https://app.datadoghq.com/organization-settings/remote-config +[4]: /account_management/rbac/permissions#api-and-application-keys +[5]: https://app.datadoghq.com/organization-settings/api-keys +[6]: https://app.datadoghq.com/metric/summary +[7]: https://app.datadoghq.com/metric/settings/policies From b7ffd3e2243f3622de47bfa2181dd33350789a3a Mon Sep 17 00:00:00 2001 From: Olivier Vielpeau Date: Fri, 10 Oct 2025 11:39:52 +0200 Subject: [PATCH 2/4] Apply suggestions from code review Co-authored-by: domalessi <111786334+domalessi@users.noreply.github.com> --- .../guide/agent-filtering-for-dogstatsd-custom-metrics.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md index 71f047863a2b3..ce162378b39a9 100644 --- a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md +++ b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md @@ -34,7 +34,7 @@ Creating and updating filtering policies requires the [`metric_tags_write`][1] R ## Prerequisites -- Upgrade to Datadog Agent v7.67.0 or higher (v7.70.0 or higher is recommended) +- Upgrade to Datadog Agent v7.67.0 or higher (v7.70.0 or higher is recommended). - Ensure that your RBAC permissions include [`org_management`][2] and that [Remote Configuration][3] is enabled for your organization. - Ensure that your RBAC permissions include [`api_keys_write`][4] and that the [Remote Configuration capability is enabled on the API keys][5] used by your Agents. After enabling Remote Configuration on an API key, an Agent restart is required for Remote Configuration enablement to take effect. @@ -44,9 +44,9 @@ Creating and updating filtering policies requires the [`metric_tags_write`][1] R You can create a metric filtering policy from the [Metrics Settings page][6] or the [Metrics Summary page][7]. -Metric filtering policies are applied to all of the Agents v7.67.0+ with Remote Configuration enabled. Older Agent versions, or Agents with Remote Configuration disabled, do not apply filtering policies. +Metric filtering policies are applied to all Agents v7.67.0+ with Remote Configuration enabled. Older Agent versions, or Agents with Remote Configuration disabled, do not apply filtering policies. -Policy updates are deployed to Agents in ~1min (up to 2 minutes). +Policy updates are deployed to Agents in 1–2 minutes. ### From the Metrics Settings page From 35d8ba9d9028f8ffd600d0cb7c206fd9f5223d67 Mon Sep 17 00:00:00 2001 From: domalessi <111786334+domalessi@users.noreply.github.com> Date: Tue, 14 Oct 2025 13:04:32 -0400 Subject: [PATCH 3/4] Update content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md --- .../guide/agent-filtering-for-dogstatsd-custom-metrics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md index ce162378b39a9..f42f67be24670 100644 --- a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md +++ b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md @@ -46,7 +46,7 @@ You can create a metric filtering policy from the [Metrics Settings page][6] or Metric filtering policies are applied to all Agents v7.67.0+ with Remote Configuration enabled. Older Agent versions, or Agents with Remote Configuration disabled, do not apply filtering policies. -Policy updates are deployed to Agents in 1–2 minutes. +Policy updates are deployed to Agents in 1-2 minutes. ### From the Metrics Settings page From 94f9abb1d17382cf4b13f2306cb3d3d996b8d403 Mon Sep 17 00:00:00 2001 From: Olivier Vielpeau Date: Wed, 15 Oct 2025 11:41:19 +0200 Subject: [PATCH 4/4] Update content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md --- .../guide/agent-filtering-for-dogstatsd-custom-metrics.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md index f42f67be24670..ffd1dea392e51 100644 --- a/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md +++ b/content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md @@ -35,8 +35,8 @@ Creating and updating filtering policies requires the [`metric_tags_write`][1] R ## Prerequisites - Upgrade to Datadog Agent v7.67.0 or higher (v7.70.0 or higher is recommended). -- Ensure that your RBAC permissions include [`org_management`][2] and that [Remote Configuration][3] is enabled for your organization. -- Ensure that your RBAC permissions include [`api_keys_write`][4] and that the [Remote Configuration capability is enabled on the API keys][5] used by your Agents. After enabling Remote Configuration on an API key, an Agent restart is required for Remote Configuration enablement to take effect. +- With [`org_management`][2] permissions, enable [Remote Configuration][3] for your organization. +- With [`api_keys_write`][4] permissions, enable the [Remote Configuration capability on the API keys][5] used by your Agents. After enabling Remote Configuration on an API key, restart your Agents for the change to take effect. {{API Key properties with Remote Configuration capability Enable button.}}