Review and apply recommendations

Manage your rules using the UI, API, or Terraform. This topic focuses on how to manage your rules using the Grafana UI.

On the Rules page in Adaptive Metrics, you can view all rules and recommended actions.

On the Overview page, you can see the current status and when rules were last updated.

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

Manage rules using the UI

You can add, keep, remove, or update recommended rules.

Navigate to Adaptive Metrics.
Navigate to the Rules page.
A list of rules and recommended actions appears.

Filter rules

Use the following controls to narrow down the rules list:

Segment: Filter rules by segment.
Filter: Search rules by metric name.
Recommendation type: Filter by recommended action: Add a new rule, Keep an existing rule, Remove an existing rule, or Update an existing rule. The rules list updates based on the type you select.
Show selected: Toggle to display only the rules you have selected.

Rules table

For each rule, the table shows the following columns:

Metric: The metric name. Click the metric name or the chevron icon to open the rule details drawer.
Received series: The number of active series received for this metric.
Current rule impact: The active series impact of the currently applied rule.
Recommendation impact: The expected active series impact of the recommended action.
Actions: Apply the recommended action or view rule details.

View rule details

Click a metric name or the chevron icon in the Actions column to open the rule details drawer. The drawer shows:

Series Impact: Three cards showing Received (series ingested for this metric), Stored (series stored after the recommended rule is applied), and a combined Reduction card showing the absolute series change and percentage. The card shows Increase instead of Reduction when the recommended rule would add series. If no series are detected for this metric in the current segment, the drawer shows a message in place of the cards.
Metric usage stats: Three cards that always display the count of each source using this metric: Alerting and recording rules, Dashboards, and Queries. Zero counts are shown explicitly. Each card has a tooltip that explains how the recommendation affects that source. A recommendation can apply even when usage is nonzero, because it only changes parts of the metric that aren’t observed in use, so existing alerts, dashboards, and queries keep working.
Rule: A summary section describing the recommended action.
- A banner at the top describes the recommendation in plain language. For Keep, it confirms no changes are needed. For Add, Update, or Remove, it describes the change and, when available, how stored active series would change.
- A series impact badge next to the action buttons shows Decrease ~N series, Increase ~N series, No impact on series count, or Impact unknown, depending on the recommendation.
- An Aggregation card shows the Types, Aggregate labels, Keep labels, and Managed by fields, when applicable. For drop rules, the card indicates that the entire metric is dropped.
Exemptions tab: Shows how exemptions affect this rule. Depending on the metric, the tab can include an Applied label exemptions table, a Recommendations muted list, a Rule suppressed by exemption warning, or a Rule effectively neutralized notice. If no exemptions affect the metric, the tab says so.
Dashboards tab: Lists the dashboards that use this metric. Each row shows the dashboard title and a button to open the dashboard in a new tab. The list paginates, and a search box appears when there are many dashboards. When dashboard links aren’t available, for example for system or internal dashboards, the tab notes this. If the metric isn’t used in any dashboards, the tab says so explicitly.

From the drawer, you can:

Apply the recommended action by clicking Apply recommendation. A confirmation dialog box opens. The button doesn’t appear for Keep recommendations.
Edit the rule by clicking Edit. The Edit button doesn’t appear for Add recommendations.
Copy the rule as JSON using the Copy JSON dropdown. The dropdown has two options: Recommendation (copies the recommended rule) and Applied rule (copies the currently applied rule). Each option is disabled when there isn’t a corresponding rule to copy.

Apply rules

Select which rules you want to apply or select Apply all recommendations.
A confirmation dialog box showing your updates opens. This dialog box displays the total expected series impact, which is useful for understanding the combined effect of all pending changes, including all recommendation types.
To confirm your rule updates, click Apply.