Documentation Grafana Cloud Cost management and billing Adaptive Telemetry Adaptive Metrics Create exemptions

Create exemptions

Create and manage exemptions using the UI, API, or Terraform. This topic focuses on how to manage your exemptions using the Grafana UI.

To manage exemptions using the API or Terraform, refer to Adaptive Metrics HTTP API or Adaptive Metrics Terraform provider.

An exemption prevents certain metrics or labels from being included in recommendations.

Creating an exemption gives you fine-grained control over which metrics the Adaptive Metrics engine analyzes and suggests changes for, or to ensure that certain metrics are handled in a specific way, overriding potential recommendations.

Here are some examples of when you may want to use exemptions.

• Critical metrics:

  For metrics that are essential for monitoring system health, performance, or business-critical functions, you might want to prevent any automated recommendations that could potentially alter their collection or aggregation in an undesirable way.

• Compliance requirements:

  Certain metrics might need to be retained with specific labels or at a certain granularity due to regulatory or compliance requirements, and an exemption can ensure these requirements are met consistently.

• Manually configured rules:

  If you have carefully crafted a specific aggregation or drop rule for a metric, you can use an exemption to prevent Adaptive Metrics from recommending changes to that rule.

• Ongoing investigations or specific use cases:

  You might temporarily exempt a metric from recommendations if you are actively investigating it or have a specific, non-standard use case that requires preserving the raw data or a particular aggregation.

Create exemptions using the UI

Create, edit, and delete exemptions using the UI.

This provides you with a more visual way of creating and managing your exemptions.

It is the recommended way for initial set up and smaller organizations and it is also easier to make ad-hoc adjustments.

View a list of all exemptions on the Configuration tab, where you can also edit or delete existing exemptions.

To create exemptions using the UI, complete the following steps.

1. Navigate to Administration > Cost Management > Metrics > Adaptive Metrics.

2. Click the Rules tab.

3. Click Add new exemption

4. From the Metric dropdown menu to select a metric from the list or toggle the All switch to apply this exemption to all metrics.

5. [Advanced]: Select the Disable recommendations for this metric and preserve existing rule state checkbox to stop generating any new recommendations for this metric and if there is an existing rule in place, to keep it.

   This is useful if you have manually configured a rule for a critical metric and want to ensure it remains unchanged by automated recommendations.

6. From the Keep labels dropdown, select one or more specific labels associated with the chosen metric that you do not want to be aggregated or toggle the All switch to keep all labels for the selected metric.

7. [Optional]: Enter a reason for why the exemption is being created.

   This is optional, but can be a crucial step for team collaboration, as it explains the business or technical need for preserving the data.