Guarded rollout health checks

Overview

This topic explains how to use guarded rollout health checks to verify that you set up your guarded rollout correctly and fix any problems with your rollout configuration.

Health check statuses

When you create a guarded rollout, LaunchDarkly provides a health check status at the top of your guarded rollout setup.

The health check statuses include:

Health check waiting: LaunchDarkly does not have enough information yet about your guarded rollout configuration to determine its health status
Healthy: your flag is receiving evaluations, your metrics are tracking events, and your flag and metrics are encountering the same context kinds
Health check warnings: there is at least one problem with your guarded rollout configuration

Hover on the status to view your rollout’s individual health checks:

A guarded rollout with a health warning.

The individual health checks are explained below.

Flag evaluations

The flag evaluation health check can have a status of:

Flag is receiving evaluations: Contexts are encountering your flag, and your SDKs are sending flag evaluation information to LaunchDarkly.
Flag is not receiving evaluations: Either your flag is not configured correctly in your code, or your SDK is not set up correctly.

You can expand the Evaluations graph at the top of the flag Targeting tab to view how many contexts are encountering the flag and which variation they are receiving.

Flag context kinds

Your flag should be encountering context kinds that match the randomization unit that you chose in the Target by menu for the guarded rollout. If a flag is encountering other context kinds, LaunchDarkly will not be able to measure the performance of the rollout.

The flag context kind health check can have a status of:

Flag is seeing [context kind]: The flag is being evaluated by contexts with the same kind as the guarded rollout’s randomization unit.
Flag is not seeing [context kind]: The flag is being evaluated by contexts with a different context kind than the one you selected for the guarded rollout. Either update the guarded rollout’s randomization unit, or investigate why your flag is not encountering the context kinds you expect.

To learn more, read Randomization unit and Context kinds.