No results for ""
  • Home
  • API docs


Flag insights

Read time: 2 minutes
Last edited: Dec 08, 2023


This topic explains how to use the flag Insights tab to observe flag evaluations over time.

Flag evaluations

The flag evaluations graph gives your engineering and product teams insight into how many times different contexts are receiving each version of a flag over time, as well as any changes to the flag that could have affected how many times each flag was evaluated.

To view a flag's evaluations graph:

  1. Navigate to the flags list.
  2. Click the name of the flag you want to view evaluations over time for. The flag's Targeting tab appears.
  3. Click the Insights tab. The flag evaluations graph appears:
The flag evaluations graph on the "Insights" tab.
The flag evaluations graph on the "Insights" tab.

The flag evaluations graph shows you how flag evaluations change over time. Changes to flag targeting rules, new variations, or an increased number of contexts affects how your end users experience your application.

Flag evaluations graphs are generated on a per-flag evaluation basis, not a per-context instance basis. This means that if the same context instance is evaluated 20 times, the flag evaluations graph records and displays all 20 evaluations. New evaluations appear on the flag evaluations graph within one to two minutes.

Each graph also has annotations, indicated by dashed vertical lines. The annotations pull from audit log entries to tell you about changes to your flag and when those changes were made. This gives you input about how changes affect what your end users receive.

To view the annotations from the flag evaluations graph, hover over an annotation line. To view the audit log entries for this change, click the annotation line. A panel of audit log entries appears.