Flag evaluations
Overview
This topic explains how to use flag evaluations graphs to observe flag evaluations over time. Flag evaluations graphs give your engineering and product teams insight into how many times different contexts are receiving each variation of a flag over time, as well as any changes to the flag that could have affected how many times each flag was evaluated.
About flag evaluations
The flag evaluations graph on a flag’s Targeting tab 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:
- Navigate to the Flags list.
- Click the name of the flag you want to view evaluations over time for. The flag’s Targeting tab appears.
- Click Evaluations to expand the section.
The flag evaluations graph displays flag evaluations over time. Hover on a specific date to view the number of flag evaluations and any changes you made to the flag on that date:
The default date range is the last seven days. To change the date range, click Last 7 days and select a new date range.
Only flag evaluations are recorded
LaunchDarkly generates the flag evaluations graph based on analytics events, which are sent from variation calls from the LaunchDarkly SDKs. To learn more, read Evaluating flags.
Other SDK methods, such as getting all flags, typically do not populate the flag evaluations graph. To learn more and review the exceptions to this, read About the all flags feature.
Evaluation display
LaunchDarkly generates the flag evaluations graph 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.
Enhanced flag evaluations charts
The enhanced flag evaluations chart on a flag’s Monitoring tab gives you deeper insights to how different variations are performing over time.
To view a flag’s enhanced evaluations chart:
- Navigate to the Flags list.
- Click the name of the flag you want to view evaluations over time for. The flag’s Targeting tab appears.
- Click the Monitoring tab.
- The flag evaluations charts appear in the “Flag-specific” section.
The default evaluations chart displays the total number of flag evaluations for each flag variation over time. You can change the time range from the previous hour, to the previous three months:
You can use the All variations menu to view a single variation at time.
To share a direct link to the chart, click the three-dot overflow menu and select “Copy link.” To save a .png version of a chart, select “Save as PNG.”
View evaluations by application or SDK
Depending on your SDK and its configuration, you can view flag evaluations by specific applications or specific SDKs. To do this:
- In the evaluations chart, click Breakdown.
- Select Application or SDK.
Individual charts appear for each application or SDK that is sending flag evaluations to LaunchDarkly. Each chart lists the percentage of overall evaluations coming from that specific app or SDK.
To learn how to configure your SDK to send application metadata to LaunchDarkly, read Automatic environment attributes and application metadata configuration.
