Guarded rollouts
Read time: 2 minutes
Last edited: Nov 20, 2024
Guarded rollouts is available to customers on a Guardian Edition plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.
Overview
This topic explains how to monitor metrics on flag releases and configure LaunchDarkly to take action on the results. You can use guarded rollouts to notify you or automatically roll back changes that have a negative effect on your app's performance.
About guarded rollouts
When you make a flag change, you can attach metrics to the flag to monitor changes in your app performance and guard against any regressions that result from the release. You can use metrics to track a variety of system health indicators and end-user behaviors, from engineering metrics like errors and latencies, to product metrics like clicks and conversions. To learn more, read Metrics.
You can connect metrics to LaunchDarkly using any of the following methods:
- Use one of our metrics integrations
- Call the metric import API
- Use a LaunchDarkly SDK to send custom events, and connect them to metrics
- Enable OpenTelemetry in a LaunchDarkly SDK, send the OpenTelemetry traces to LaunchDarkly, and connect them to metrics
You can monitor metrics on any flag rule, except rules already serving a percentage rollout or progressive rollout, and those in use in a running experiment.
Guarded rollouts are one of several options that LaunchDarkly provides to help you release features to production safely and gradually. To learn about other options for releasing features, read Releasing features with LaunchDarkly.
Regressions
When you attach metrics to a flag and then toggle the flag on or change the variation served, LaunchDarkly detects if the change is having a negative impact on your app or audience. This negative effect is called a "regression." You can configure LaunchDarkly to either notify you of the regression, or notify you of the regression and automatically roll back the release.