Skip to content

Commit 2b75f2e

Browse files
committed
Adding initial changes for telemetry updates.
1 parent 53b508d commit 2b75f2e

9 files changed

+24
-21
lines changed

articles/azure-app-configuration/howto-telemetry.md

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.service: azure-app-configuration
66
author: mrm9084
77
ms.author: mametcal
88
ms.topic: how-to
9-
ms.date: 06/19/2025
9+
ms.date: 07/08/2025
1010
---
1111

1212
# Enable telemetry for feature flags
@@ -71,6 +71,11 @@ These types of questions can be answered through the emission and analysis of fe
7171
> [!div class="mx-imgBorder"]
7272
> ![Screenshot of the Azure portal, navigate to telemetry tab from app insights blade of App Configuration resource.](./media/howto-telemetry/app-insights-view-details-link.png)
7373
74+
You can also access this tab by going to the feature manager and clicking **"View events"** in the telemetry column for the feature flag of interest.
75+
> [!div class="mx-imgBorder"]
76+
> ![Screenshot of the Azure portal, view events from feature manager.](./media/howto-telemetry/feature-manager-view-events.png)
77+
78+
7479
In the telemetry tab, you can view:
7580

7681
- **Total events**: Total number of evaluation events emitted by your application
@@ -83,37 +88,34 @@ These types of questions can be answered through the emission and analysis of fe
8388
In order to show the distribution of users and number of evaluations across Simple, Long, and None variants, group the metrics by Variant. This will enable you see whether the configured allocations are working as expected, and that all expected variants are being served to users.
8489

8590
> [!div class="mx-imgBorder"]
86-
> ![Screenshot of the Azure portal, view total events by variant in telemetry tab.](./media/howto-telemetry/total-events-by-variant.png)
91+
> ![Screenshot of the Azure portal, view unique users by variant in telemetry tab.](./media/howto-telemetry/unique-user-count-by-variant.png)
8792
88-
In this example, we see that the number of events for the "None" variant is almost twice that of the "Simple" and "Long" variants given the configured 50-25-25 percentile split between "None", "Simple" and "Long" respectively.
93+
In this example, we see that the number of users assigned the "None" variant is almost twice that of the "Simple" and "Long" variants given the configured 50-25-25 percentile split between "None", "Simple" and "Long" respectively.
8994

9095

9196
**Confirm overrides and behaviour based on flag state**
92-
- Users may be assigned a variant for different reasons so you would want to ensure that your variant assignments are not only in the right proprtion, but also for the right reason. You can view this by grouping metrics by assignment reason. In this example, we will see that the only assignment reason is solely due to Percentile allocations.
97+
- Users may be assigned a variant for different reasons so you would want to ensure that your variant assignments are not only in the right proportion, but also for the right reason. You can view this by grouping metrics by assignment reason. In this example, we will see that the only assignment reason is solely due to Percentile allocations.
9398

9499
> [!div class="mx-imgBorder"]
95-
> ![Screenshot of the Azure portal, view total events by assignment reason in telemetry tab.](./media/howto-telemetry/total-events-by-assignment-reason.png)
100+
> ![Screenshot of the Azure portal, view total events by assignment reason in telemetry tab.](./media/howto-telemetry/unique-user-count-by-assignmentreason.png)
101+
102+
- Disable the feature flag by going to the feature manager and toggling the feature flag "Enable" switch.
103+
- In the telemetry column click "View events" to go to telemetry tab in read-only mode.
104+
- View Unique user count by Variant. You will see that all assignments for Long and Simple go to zero, and only the default variant (which is None in our case) is the only variant being assigned to users.
105+
> [!div class="mx-imgBorder"]
106+
> ![Screenshot of the Azure portal, view unique user count by variant in telemetry tab.](./media/howto-telemetry/unique-user-count-by-variant-disabled.png)
96107
97-
- Disable the feature flag by going to the feature manager and toggling the feature flag off. Visit your feature flag telemetry tab and view Unique user count by Variant. You will see that all assignments for Long and Simple go to zero, and only the default variant (which is None in our case) is the only variant being assigned to users.
98-
> [!div class="mx-imgBorder"]
99-
> ![Screenshot of the Azure portal, view unique user count by variant in telemetry tab.]()
100108
- Switch to group by unique user count by assignment reason.
101-
Confirm from the graph that the Percentile allocations fall to zero and DefaultWhenDisabled is the only reason for which users are being assing variants.
109+
Confirm from the graph that the Percentile allocations fall to zero and DefaultWhenDisabled is the only reason for which users are being assigned variants.
102110
- Other possible reasons include "Group Override" or "User Override" if configured.
103-
> [!div class="mx-imgBorder"]
104-
> ![Screenshot of the Azure portal, view unique user count by assignment reason in telemetry tab.]()
105-
106-
107-
108-
1. You can also access telemetry directly from the Feature Manager blade:
109-
- Navigate to your Feature Manager
110-
- Locate your feature flag in the displayed grid
111-
- Click **"View events"** in the Telemetry column
112111
> [!div class="mx-imgBorder"]
113-
> ![Screenshot of the Azure portal, view events from feature manager.](./media/howto-telemetry/feature-manager-view-events.png)
112+
> ![Screenshot of the Azure portal, view unique user count by assignment reason in telemetry tab.](./media/howto-telemetry/unique-user-count-by-assignmentreason-disabled.png)
113+
114114

115115
## Analyze in Application Insights
116116

117+
Now that we have confirmed the feature flag allocations are working as expected, we would want to dive deeper into the telemetry events to see how different variants are performing based on the likes emitted for users.
118+
117119
1. Open your Application Insights resource in the Azure portal and select **Logs** under **Monitoring**. In the query window, run the following query to see the telemetry events:
118120

119121
```kusto
@@ -160,8 +162,9 @@ These types of questions can be answered through the emission and analysis of fe
160162
combined_data
161163
| union (total_sum)
162164
```
163-
![Screenshot of the Azure portal, view results of application insights analysis.](./media/howto-telemetry/application-insights-query-results.png)
165+
> [!div class="mx-imgBorder"]
166+
> ![Screenshot of the Azure portal, view results of application insights analysis.](./media/howto-telemetry/application-insights-query-results.png)
164167
165168
You see one "FeatureEvaluation" event for each time the quote page was loaded and one "Liked" event for each time the like button was clicked. The "FeatureEvaluation" event have a custom property called `FeatureName` with the name of the feature flag that was evaluated. Both events have a custom property called `TargetingId` with the name of the user that liked the quote.
166169
167-
In this example, we can see that, even though there were roughly the same number of users getting the Long variant vs Simple, the Simple variant appears to be performing better by a margin of 20%.
170+
In this example, we can see that, even though there were roughly the same number of users getting the Long variant vs Simple, the Simple variant appears to be performing better by a margin of 22%.
-31 KB
Loading
1.88 KB
Loading
Binary file not shown.
47.2 KB
Loading
35.2 KB
Loading
49.4 KB
Loading
48.6 KB
Loading

0 commit comments

Comments
 (0)