> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/feature-management-experimentation/use-fme/release-monitoring/alerts/index.md).

# Alerts in Harness FME

Harness FME provides a flexible alerting system to help teams monitor the impact of feature flags and experiments in real time. By configuring automated alerts on key or guardrail metrics, teams can quickly detect regressions, respond to issues, and protect customer experience during rollouts.

With alerts, you can:

* Detect when a metric crosses a critical threshold
* Automatically trigger notifications based on experiment results
* Respond to issues before they escalate

Harness FME alerts are designed to work seamlessly with your existing workflows, ensuring you stay informed and in control during every stage of a release or experiment.

### Determine an alert mechanism <a href="#determine-an-alert-mechanism" id="determine-an-alert-mechanism"></a>

Choose the alert type that matches how you want to detect and respond to metric changes:

| **Alert type**                                        | **How it's triggered**                                     | **Fires on**       | **Configured for**          | **Environment support** | **How to enable**                                                                                                                                                                                                                            |
| ----------------------------------------------------- | ---------------------------------------------------------- | ------------------ | --------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Significance alert (automatic) – Key metric**       | Statistically significant impact detected (threshold = 0). | Good or bad impact | Key metric linked to a flag | Production only         | Mark a metric as a [key metric](/feature-management-experimentation/use-fme/experimentation/experiment-results/viewing-experiment-results/metrics-impact-cards.md#actions-you-can-perform) for a feature flag on the **Metrics impact** tab. |
| **Significance alert (automatic) – Guardrail metric** | Statistically significant impact detected (threshold = 0). | Good or bad impact | Guardrail metric            | Production only         | Set a metric category to [`Guardrail`](/feature-management-experimentation/use-fme/experimentation/setup/metric-selection/guardrail-metrics.md) in the metric definition.                                                                    |
| **Manual metric alert policy (any metric)**           | Manually configured threshold is crossed.                  | Degradations only  | Any metric with a policy    | Any environment         | Create a [metric alert policy](/feature-management-experimentation/use-fme/release-monitoring/metrics/setup/metric-alert-policy.md) from the metric definition on the **Alert Policy** tab.                                                  |

For key metrics, alerts are triggered only when the **When a key metric reaches significance** option is enabled in a [feature flag's alert settings](/feature-management-experimentation/use-fme/release-monitoring/alerts/automated-alerts-and-notifications/index.md#significance-alerts-feature-flags). Guardrail metric alerts are automatically evaluated.

![](/files/Iwf5jyxDTPmpE9eIoHln)

Significance alerts are automatic and require no threshold configuration. Use them to detect statistically meaningful changes during feature flag rollouts. These alerts are only evaluated in production environments.

[Metric alert policies](/feature-management-experimentation/use-fme/release-monitoring/alerts/alert-policies/index.md) are manually configured and allow you to define thresholds and recipients. Use them when you:

* Need alerts in non-production environments (for example, staging or preview)
* Want explicit control over thresholds
* Need to customize notification recipients

Manual metric alerts fire when any metric crosses a defined threshold, regardless of feature flag or experiment.

### Configure alerts <a href="#configure-alerts" id="configure-alerts"></a>

Choose the type of alert you want to configure based on your use case:

* To set up automatic alerts based on statistical significance, see [Automated alerts and notifications](/feature-management-experimentation/use-fme/release-monitoring/alerts/automated-alerts-and-notifications/index.md#significance-alerts-feature-flags).
* To configure threshold-based alerts with custom conditions or non-production environments, see [Alert policies](/feature-management-experimentation/use-fme/release-monitoring/alerts/alert-policies/index.md).

#### Alert policies <a href="#alert-policies" id="alert-policies"></a>

Control how and when alerts trigger by creating an [alert policy](/feature-management-experimentation/use-fme/release-monitoring/alerts/alert-policies/index.md). Define thresholds, notification rules, and alert behaviors that match your team's processes.

**Monitoring window**

Set the time window over which metric performance is evaluated for alert policies. [Monitoring windows](/feature-management-experimentation/use-fme/release-monitoring/alerts/alert-policies/monitoring-window.md) help you tune sensitivity and reduce alert noise by limiting the period during which alerts are automatically triggered based on observed metric degradations.

Harness FME continues to monitor and alert your team of a metric degradation for up to 28 days after a version change. The default monitor window is 24 hours. Administrators can change this in the **Monitor window and statistics** settings.

{% hint style="info" %}
The monitoring window only applies to alert policies. If the monitoring window is set to 24 hours, Harness FME stops evaluating metrics for alerts triggering after 24 hours from the version change. However, significance-based alerts can still trigger later if metrics are recalculated (for example, during deeper analysis or manual recalculation).
{% endhint %}

#### Alert baseline treatment <a href="#alert-baseline-treatment" id="alert-baseline-treatment"></a>

Compare metrics against a [baseline treatment](/feature-management-experimentation/use-fme/release-monitoring/alerts/set-the-alert-baseline-treatment.md) to improve alert accuracy and minimize false positives. This treatment serves as the control group in impact comparisons, allowing Harness FME to evaluate whether changes in a metric are statistically significant when users receive a different treatment.

### Manage alerts <a href="#manage-alerts" id="manage-alerts"></a>

When an alert fires, you can access the [alert details](/feature-management-experimentation/use-fme/release-monitoring/alerts/view-triggered-alerts.md) and take action from the **Feature flags** page.

| **Action**        | **Description**                                                                                                                                                                                                                                |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kill feature flag | If you decide to kill a feature flag due to an alert, the [default treatment](/feature-management-experimentation/use-fme/feature-management/setup/default-treatment.md) overrides the existing targeting rules and is returned for all users. |

### Troubleshooting alerts <a href="#troubleshooting-alerts" id="troubleshooting-alerts"></a>

Fix common configuration or delivery issues, verify metric inputs, and fine tune thresholds for better alert performance. For more information, see [Troubleshooting alerts](/feature-management-experimentation/use-fme/release-monitoring/alerts/troubleshooting.md).
