Skip to content

Commit b929734

Browse files
olivielpeaudomalessi
authored andcommitted
Update agent-filtering-for-dogstatsd-custom-metrics.md with remote config + RBAC details (#32104)
* Update agent-filtering-for-dogstatsd-custom-metrics.md with remote config + RBAC details * Apply suggestions from code review Co-authored-by: domalessi <[email protected]> * Update content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md * Update content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md --------- Co-authored-by: domalessi <[email protected]>
1 parent 3b854d1 commit b929734

File tree

1 file changed

+22
-3
lines changed

1 file changed

+22
-3
lines changed

content/en/metrics/guide/agent-filtering-for-dogstatsd-custom-metrics.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,23 @@ Agent-side filtering enables you to filter out unused or unwanted DogStatsD cust
3030

3131
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.
3232

33+
Creating and updating filtering policies requires the [`metric_tags_write`][1] RBAC permission. All users can view filtering policies.
34+
35+
## Prerequisites
36+
37+
- Upgrade to Datadog Agent v7.67.0 or higher (v7.70.0 or higher is recommended).
38+
- With [`org_management`][2] permissions, enable [Remote Configuration][3] for your organization.
39+
- 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.
40+
41+
{{<img src="agent/remote_config/RC_Key_updated.png" alt="API Key properties with Remote Configuration capability Enable button." width="90%" style="center">}}
42+
3343
## Create a metric filtering policy
3444

35-
You can create a metric filtering policy from the [Metrics Settings page][1] or the [Metrics Summary page][2].
45+
You can create a metric filtering policy from the [Metrics Settings page][6] or the [Metrics Summary page][7].
46+
47+
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.
48+
49+
Policy updates are deployed to Agents in 1-2 minutes.
3650

3751
### From the Metrics Settings page
3852

@@ -184,5 +198,10 @@ This initial preview release includes the following limitations:
184198

185199
{{< partial name="whats-next/whats-next.html" >}}
186200

187-
[1]: https://app.datadoghq.com/metric/settings/policies
188-
[2]: https://app.datadoghq.com/metric/summary
201+
[1]: /account_management/rbac/permissions/#metrics
202+
[2]: /account_management/rbac/permissions/#access-management
203+
[3]: https://app.datadoghq.com/organization-settings/remote-config
204+
[4]: /account_management/rbac/permissions#api-and-application-keys
205+
[5]: https://app.datadoghq.com/organization-settings/api-keys
206+
[6]: https://app.datadoghq.com/metric/summary
207+
[7]: https://app.datadoghq.com/metric/settings/policies

0 commit comments

Comments
 (0)