Skip to content

Commit fe16abd

Browse files
committed
Made it a reference doc not a how to doc
1 parent 933242e commit fe16abd

File tree

2 files changed

+14
-26
lines changed

2 files changed

+14
-26
lines changed

articles/azure-app-configuration/TOC.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -152,10 +152,6 @@
152152
href: howto-targetingfilter.md
153153
- name: ASP.NET Core
154154
href: howto-targetingfilter-aspnet-core.md
155-
- name: Telemetry
156-
items:
157-
- name: Overview
158-
href: howto-telemetry.md
159155
- name: Run experiments with variant feature flags
160156
items:
161157
- name: ASP.NET Core
@@ -334,6 +330,10 @@
334330
href: ./feature-management-python-reference.md
335331
- name: API reference
336332
href: https://microsoft.github.io/FeatureManagement-Python/html/index.html
333+
- name: Telemetry
334+
items:
335+
- name: Feature flags telemetry reference
336+
href: feature-flag-telemetry-reference.md
337337
- name: Deployment
338338
items:
339339
- name: ARM template

articles/azure-app-configuration/howto-telemetry.md renamed to articles/azure-app-configuration/feature-flag-telemetry-reference.md

Lines changed: 10 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: App Configuration and Telemetry (preview)
2+
title: Feature flag telemetry reference (preview)
33
titleSuffix: Azure App Configuration
44
description: Learn how App Configuration allows for telemetry viewing for feature flags.
55
ms.service: azure-app-configuration
@@ -9,37 +9,23 @@ ms.topic: how-to
99
ms.date: 10/31/2024
1010
---
1111

12-
# Tutorial: Azure App Configuration and Telemetry (preview)
12+
# Tutorial: Feature flag telemetry reference (preview)
1313

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.
1515

1616
In this tutorial, you:
1717

1818
> [!div class="checklist"]
19-
> - Add telemetry to a feature flag (preview)
2019
> - Learn which telemetry data is viewable using the Azure App Configuration provider libraries (preview)
2120
> - Learn which telemetry data is viewable using the Feature Management libraries (preview)
2221
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-
3822
## Viewing telemetry data (Preview)
3923

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
4127

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:
4329

4430
- **AllocationID**: A unique identifier for the feature flag in its current state.
4531
- **ETag**: The current ETag for the feature flag.
@@ -48,7 +34,9 @@ When telemetry is enabled, the Azure App Configuration provider libraries add mo
4834

4935
The full schema can be found [here](https://github.com/microsoft/FeatureManagement/tree/main/Schema/FeatureEvaluationEvent/FeatureEvaluationEventWithAzureAppConfiguration.v1.0.0.schema.json).
5036

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:
5240

5341
- **Feature_Name**: The name of the feature flag.
5442
- **Enabled**: A boolean value indicating if the feature flag is enabled.

0 commit comments

Comments
 (0)