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
Copy file name to clipboardExpand all lines: articles/azure-app-configuration/feature-flag-telemetry-reference.md
+10-22Lines changed: 10 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: App Configuration and Telemetry (preview)
2
+
title: Feature flag telemetry reference (preview)
3
3
titleSuffix: Azure App Configuration
4
4
description: Learn how App Configuration allows for telemetry viewing for feature flags.
5
5
ms.service: azure-app-configuration
@@ -9,37 +9,23 @@ ms.topic: how-to
9
9
ms.date: 10/31/2024
10
10
---
11
11
12
-
# Tutorial: Azure App Configuration and Telemetry (preview)
12
+
# Tutorial: Feature flag telemetry reference (preview)
13
13
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. In this guide, you learn how to add telemetry (preview) to your Azure App Configuration feature flags and what data you can get from them.
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.
15
15
16
16
In this tutorial, you:
17
17
18
18
> [!div class="checklist"]
19
-
> - Add telemetry to a feature flag (preview)
20
19
> - Learn which telemetry data is viewable using the Azure App Configuration provider libraries (preview)
21
20
> - Learn which telemetry data is viewable using the Feature Management libraries (preview)
22
21
23
-
## Prerequisites
24
-
25
-
- An Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
26
-
- An App Configuration store. If you don't have an App Configuration store, see [Create an App Configuration store](./quickstart-azure-app-configuration-create.md).
27
-
- A feature flag. If you don't have a feature flag, see [Create a feature flag](./manage-feature-flags.md).
28
-
29
-
## Add telemetry to a feature flag (preview)
30
-
31
-
1. Open your App Configuration store in the Azure portal.
32
-
1. In the **Operations** section, select the **Feature manager** page.
33
-
1. When viewing the list of feature flags, you should see a column labeled **Telemetry** (preview), it should show as **Disabled**. Right click on the feature flag you want to enable telemetry for and select **Edit**.
34
-
1. In the new view, select the **Telemetry** tab.
35
-
1. Select the **Enable Telemetry** checkbox and then the **Review + update** button at the bottom of the page.
36
-
1. On the **Review + update** page, select the **Update** button.
37
-
38
22
## Viewing telemetry data (Preview)
39
23
40
-
With telemetry (preview) enabled no other properties are added to the feature flag besides the setting enabling telemetry. Use of an Azure App Configuration provider library that supports telemetry is required to start collecting telemetry data.
24
+
With telemetry (preview) enabled no other properties are added to the feature flag besides the setting enabling telemetry. The additional use of one of the Azure App Configuration provider libraries along with the Feature Management libraries is required to start collecting telemetry data.
25
+
26
+
### Azure App Configuration provider libraries
41
27
42
-
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:
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:
43
29
44
30
-**AllocationID**: A unique identifier for the feature flag in its current state.
45
31
-**ETag**: The current ETag for the feature flag.
@@ -48,7 +34,9 @@ When telemetry is enabled, the Azure App Configuration provider libraries add mo
48
34
49
35
The full schema can be found [here](https://github.com/microsoft/FeatureManagement/tree/main/Schema/FeatureEvaluationEvent/FeatureEvaluationEventWithAzureAppConfiguration.v1.0.0.schema.json).
50
36
51
-
When feature flags with telemetry enabled are used with the Feature Management libraries, more properties are added to the telemetry data and be sent to location to be viewed, such as Azure Monitor. When using our provided connections to Azure Monitor a **custom_event** is published to Open Telemetry with the following properties whenever a telemetry enabled feature flag is evaluated:
37
+
### Feature Management libraries
38
+
39
+
When feature flags with telemetry enabled are used with the Feature Management libraries in addition to the provider libraries, more properties are added to the telemetry data and be sent to location to be viewed, such as Azure Monitor. When using our provided connections to Azure Monitor a **custom_event** is published to Open Telemetry with the following properties whenever a telemetry enabled feature flag is evaluated:
52
40
53
41
-**Feature_Name**: The name of the feature flag.
54
42
-**Enabled**: A boolean value indicating if the feature flag is enabled.
0 commit comments