You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Learn how App Configuration allows for telemetry viewing for feature flags.
5
5
ms.service: azure-app-configuration
@@ -9,25 +9,25 @@ ms.topic: reference
9
9
ms.date: 11/06/2024
10
10
---
11
11
12
-
# Tutorial: Feature flag telemetry reference (preview)
12
+
# Tutorial: Feature flag telemetry reference
13
13
14
-
Having telemetry data on your feature flags can be a powerful tool for understanding how your feature flags are used. Telemetry (preview) allows you to make informed decisions about your feature management strategy.
14
+
Having telemetry data on your feature flags can be a powerful tool for understanding how your feature flags are used. Telemetry allows you to make informed decisions about your feature management strategy.
15
15
16
16
In this tutorial, you:
17
17
18
18
> [!div class="checklist"]
19
-
> - Learn which telemetry data is viewable using the Azure App Configuration provider libraries (preview)
20
-
> - Learn which telemetry data is viewable using the Feature Management libraries (preview)
19
+
> - Learn which telemetry data is viewable using the Azure App Configuration provider libraries
20
+
> - Learn which telemetry data is viewable using the Feature Management libraries
21
21
22
-
## Viewing telemetry data (Preview)
22
+
## Viewing telemetry data
23
23
24
-
With telemetry (preview) enabled no other properties are added to the feature flag besides the setting enabling telemetry. The use of one of the Azure App Configuration provider libraries along with the Feature Management libraries is required to start collecting telemetry data.
24
+
With telemetry enabled no other properties are added to the feature flag besides the setting enabling telemetry. The use of one of the Azure App Configuration provider libraries along with the Feature Management libraries is required to start collecting telemetry data.
25
25
26
26
### Azure App Configuration provider libraries
27
27
28
28
The use of an Azure App Configuration provider library that supports telemetry is required to start collecting telemetry data. When telemetry is enabled, the Azure App Configuration provider libraries add more properties to the feature flags when they're retrieved. A new object is added to the **telemetry** section of the feature flag called **metadata**. The **metadata** object contains the following properties:
29
29
30
-
-**AllocationID**: A unique identifier for the feature flag in its current state.
30
+
-**AllocationID**: A unique identifier for the feature flag in its current state. (preview)
31
31
-**ETag**: The current ETag for the feature flag.
32
32
-**FeatureFlagReference**: A reference to the feature flag in the format of `<your_store_endpoint>kv/<feature_flag_key>`, it also includes the label if one is present, `<your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>`.
33
33
-**FeatureFlagId**: A unique identifier for the feature flag.
@@ -43,16 +43,16 @@ When the Feature Management libraries and the provider libraries are used togeth
43
43
-**Version**: The version of this schema.
44
44
-**Reason**: The reason the feature flag was enabled or disabled.
45
45
-**Variant**: The variant that was selected for the feature flag.
46
-
-**VariantAssignmentPercentage**: If a variant wasn't targeted specifically at the user, or one of the user's groups, this number is the Percentage chance of the user being assigned to the variant.
47
-
-**DefaultWhenEnabled**: The default variant of the feature flag when it's enabled.
48
-
-**AllocationID**: A unique identifier for the feature flag in its current state.
46
+
-**VariantAssignmentPercentage** (preview): If a variant wasn't targeted specifically at the user, or one of the user's groups, this number is the Percentage chance of the user being assigned to the variant.
47
+
-**DefaultWhenEnabled** (preview): The default variant of the feature flag when it's enabled.
48
+
-**AllocationID** (preview): A unique identifier for the feature flag in its current state.
49
49
-**ETag**: The current ETag for the feature flag.
50
50
-**FeatureFlagReference**: A reference to the feature flag in the format of `<your_store_endpoint>kv/<feature_flag_key>`, it also includes the label if one is present, `<your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>`.
51
51
-**FeatureFlagId**: A unique identifier for the feature flag.
52
52
-**TargetingId**: The ID of the user that was assigned to the variant.
53
53
54
54
The full schema can be found [here](https://github.com/microsoft/FeatureManagement/blob/main/Schema/FeatureEvaluationEvent/FeatureEvaluationEvent.v1.0.0.schema.json).
55
55
56
-
## Next steps (Preview)
56
+
## Next steps
57
57
58
58
In this tutorial, you learned about how to enable telemetry for feature flags in Azure App Configuration. To learn about how to use the telemetry data in your applications, continue to the following tutorial for your language or platform.
0 commit comments