Informations de référence sur la télémétrie de l’indicateur de fonctionnalité

Avoir des données de télémétrie sur vos indicateurs de fonctionnalité peut être un outil puissant pour comprendre comment vos indicateurs de fonctionnalité sont utilisés. La télémétrie vous permet de prendre des décisions éclairées sur votre stratégie de gestion des fonctionnalités.

Dans ce document, vous allez :

Évaluation des fonctionnalités

L’événement d’évaluation des fonctionnalités est émis chaque fois qu’un indicateur de fonctionnalité sur lequel la télémétrie est activée est évalué dans votre application. Cet événement, nommé FeatureEvaluation, se produit chaque fois que votre code vérifie l’état d’un indicateur de fonctionnalité ou obtient une variante. L’événement capture le résultat de l’évaluation, les détails de l’attribution de variantes et les informations contextuelles sur la raison pour laquelle des décisions spécifiques ont été prises.

Cet événement contient les champs suivants :

Champs de base

Les bibliothèques de gestion des fonctionnalités fournissent les propriétés suivantes aux données de télémétrie :

• FeatureName : nom de l’indicateur de fonctionnalité.
• Activé : valeur booléenne indiquant si l’indicateur de fonctionnalité est activé.
• Variant : variante sélectionnée pour l’indicateur de fonctionnalité.
• VariantAssignmentReason : raison pour laquelle la variante a été affectée à l’utilisateur ; DefaultWhenDisabled, DefaultWhenEnabled, User, Group, Percentile, None.
• TargetingId : ID de l’utilisateur affecté à la variante.
• DefaultWhenEnabled : variante par défaut de l’indicateur de fonctionnalité lorsqu’elle est activée.
• Version : version de ce schéma.
• VariantAssignmentPercentage : spécifie le pourcentage de la base utilisateur pour laquelle la variante affectée est allouée. Ce champ n’est présent que pour les affectations basées sur centile.

Le schéma complet se trouve dans la définition du schéma d’événement d’évaluation des fonctionnalités.

Ces données peuvent ensuite être envoyées à des emplacements à afficher, comme Azure Monitor. Lorsque vous utilisez nos connexions fournies à Azure Monitor, une custom_event est publiée avec les propriétés suivantes chaque fois qu’un indicateur de fonctionnalité activé pour la télémétrie est évalué.

Champs personnalisés App Configuration

Lorsque les bibliothèques de fournisseurs Azure App Configuration sont utilisées, des propriétés supplémentaires sont ajoutées aux données de télémétrie. Ces propriétés fournissent davantage de contexte sur l’indicateur de fonctionnalité et son évaluation :

• AllocationID : identificateur unique représentant l’état de l’allocation de l’indicateur de fonctionnalité.
• ETag : ETag actuel pour l’indicateur de fonctionnalité.
• FeatureFlagReference : référence à l’indicateur de fonctionnalité au format de <your_store_endpoint>kv/<feature_flag_key>. Lorsqu’une étiquette est présente, la référence l’inclut en tant que paramètre de requête : <your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>.

Le schéma complet se trouve dans la définition du schéma d’événement d’évaluation des fonctionnalités App Configuration.

Étapes suivantes

Dans ce document, vous avez découvert les données de télémétrie disponibles pour les indicateurs de fonctionnalité. Pour en savoir plus sur l’utilisation des données de télémétrie dans vos applications, passez au document suivant pour votre langue ou plateforme.