---
title: Using Feature Flag Tracking
description: View and understand your feature flag's health and usage.
breadcrumbs: >-
  Docs > RUM & Session Replay > Feature Flag Tracking > Using Feature Flag
  Tracking
---

# Using Feature Flag Tracking

Once you have set up your feature flag data collection, navigate to the [**Feature Flag Tracking**](https://app.datadoghq.com/rum/feature-flags) tab within RUM.

From this view, you can investigate any questions you have about your feature flag's health and usage.

- Monitor the number of users experiencing each variant and see summary statistics of your feature flag.
- Check the status of your feature flag to see if there are any that can be removed for code clean up.
- View which pages your feature flags are being evaluated against.

Feature flags show up in the context of events where they are evaluated, meaning they should show up on the views that the feature flag code logic is run on.

{% image
   source="https://docs.dd-static.net/images/real_user_monitoring/feature_flag_tracking/feature-flag-list-2.6e724d71feca1d74ff18a4a31c77ab85.png?auto=format"
   alt="View a list of your feature flags to investigate any questions you have about your feature flag's health and usage" /%}

## Search and filter{% #search-and-filter %}

Search and filter your feature flags by typing in the search bar. You can also use the faceted search to narrow down, broaden, or shift your focus on subsets of feature flags you are interested in.

{% image
   source="https://docs.dd-static.net/images/real_user_monitoring/feature_flag_tracking/feature-flag-list-search-filter.8e22ea9e4aa6473a68380d1adc4b2e75.png?auto=format"
   alt="Feature Flag list search bar and filtering" /%}

## Feature flag status{% #feature-flag-status %}

There are three possible feature flag statuses:

{% dl %}

{% dt %}
Active
{% /dt %}

{% dd %}
The feature flag has evaluated different variants for the past 2 weeks.
{% /dd %}

{% dt %}
Inactive
{% /dt %}

{% dd %}
For the past 2 weeks, there have only been feature flag evaluations for your control variant.
{% /dd %}

{% dt %}
Out to 100%
{% /dt %}

{% dd %}
For the past 2 weeks, there have only been feature flag evaluations for one of your *non-control* variants.
{% /dd %}

{% /dl %}

## Analyze your feature flags{% #analyze-your-feature-flags %}

To get more details about the health and performance of your feature flag, you can click the flag in the list to navigate to a dedicated Feature Flag analysis dashboard. The Feature Flag analysis dashboard provides an overview of the performance of your feature flag, displaying information about user sessions, changes in your Core Web Vitals, and error rates.

These out-of-the-box graphs are aggregated across your flag variants, making it easy to spot problems in your feature releases before they turn into serious issues. This dashboard provides an easy way to monitor your feature releases and allows you to quickly roll back as soon as you spot an issue so you can avoid negative user experiences.

{% video
   url="https://docs.dd-static.net/images/real_user_monitoring/feature_flag_tracking/feature-flag-details-page.mp4" /%}

- The **Users** tab provides some high level summary statistics of your feature flag and allows you to further analyze the users viewing each of your feature flag variants by any attribute. If you want to understand what it looks like for someone who experienced a certain variant versus another, you can watch a [Session Replay](https://docs.datadoghq.com/session_replay/browser/) for each case.

- The **Issues** tab gives you a view of the errors that are occurring in your application for user sessions that have your feature flag. Check if any issues detected by [Error Tracking](https://docs.datadoghq.com/real_user_monitoring/error_tracking/explorer/#explore-your-issues) occurred for a specific variant of your feature flag and might be related to your changes.

- The **Performance** tab allows you to understand if one of your feature flag variants have caused poor performance. You can view your Core Web Vitals and loading time for each variant to determine if one of your variants may be causing a negative impact on your application's performance.

## Build custom views from Feature Flag data using the RUM Explorer{% #build-custom-views-from-feature-flag-data-using-the-rum-explorer %}

Search through all the data collected by RUM in the [RUM Explorer](https://app.datadoghq.com/rum/explorer) to surface trends on feature flags, analyze patterns with greater context, or export them into [dashboards](https://docs.datadoghq.com/dashboards/) and [monitors](https://docs.datadoghq.com/monitors/#create-monitors).

You can search your Sessions, Views, or Errors in the RUM Explorer, with the `@feature_flags.{flag_name}` attribute to scope down and focus on events where users were shown a specific user experience.

You can compare important metrics to you and your teams by grouping your query by `@feature_flags.{flag_name}`. For example, if you want to understand how your new checkout flow is affecting the conversion rate from the checkout page to users making a purchase, you can add a "Group by" on the conversion rate graph.

{% image
   source="https://docs.dd-static.net/images/real_user_monitoring/feature_flag_tracking/feature-flag-rum-explorer.b9ed8de8c2f12b4f2380db6827090084.png?auto=format"
   alt="Feature Flag list search bar and filtering" /%}

## Further reading{% #further-reading %}

- [Set up Feature Flag data collection](https://docs.datadoghq.com/real_user_monitoring/feature_flag_tracking/setup/)
- [Learn about the RUM Explorer](https://docs.datadoghq.com/real_user_monitoring/explorer/)
- [Ensure release safety with feature flag tracking in Datadog RUM](https://www.datadoghq.com/blog/feature-flag-tracking/)
