Informazioni di riferimento sulla telemetria dei flag di funzionalità

Avere dati di telemetria sui flag di funzionalità può essere uno strumento potente per comprendere come vengono usati i flag di funzionalità. La telemetria consente di prendere decisioni informate sulla strategia di gestione delle funzionalità.

In questo documento:

• Informazioni sui dati di telemetria disponibili usando le librerie del provider di Configurazione app di Azure
• Informazioni sui dati di telemetria disponibili tramite le librerie di Gestione funzionalità

Valutazione delle funzionalità

L'evento di valutazione delle funzionalità viene generato ogni volta che viene valutato un flag di funzionalità con dati di telemetria abilitati nell'applicazione. Questo evento, denominato FeatureEvaluation, si verifica ogni volta che il codice controlla lo stato di un flag di funzionalità o ottiene una variante. L'evento acquisisce il risultato della valutazione, i dettagli sull'assegnazione delle varianti e le informazioni contestuali sul motivo per cui sono state prese decisioni specifiche.

Questo evento contiene i campi seguenti:

Campi di base

Le librerie di gestione delle funzionalità forniscono le proprietà seguenti ai dati di telemetria:

• FeatureName: nome del flag di funzionalità.
• Abilitato: valore booleano che indica se il flag di funzionalità è abilitato.
• Variant: variante selezionata per il flag di funzionalità.
• VariantAssignmentReason: motivo per cui la variante è stata assegnata all'utente; DefaultWhenDisabled, DefaultWhenEnabled, User, Group, Percentile, None.
• TargetingId: ID dell'utente assegnato alla variante.
• DefaultWhenEnabled: variante predefinita del flag di funzionalità quando è abilitata.
• Versione: versione di questo schema.
• VariantAssignmentPercentage: specifica la percentuale dell'utente per cui viene allocata la variante assegnata. Questo campo è presente solo per le assegnazioni basate su percentile.

Lo schema completo è disponibile nella definizione dello schema di eventi di valutazione delle funzionalità.

Questi dati possono quindi essere inviati alle posizioni da visualizzare, ad esempio Monitoraggio di Azure. Quando si usano le connessioni fornite a Monitoraggio di Azure, viene pubblicato un custom_event con le proprietà seguenti ogni volta che viene valutato un flag di funzionalità abilitato per la telemetria.

Campi personalizzati di Configurazione app

Quando vengono usate le librerie del provider di Configurazione app di Azure, vengono aggiunte proprietà aggiuntive ai dati di telemetria. Queste proprietà forniscono più contesto sul flag di funzionalità e sulla relativa valutazione:

• AllocationID: identificatore univoco che rappresenta lo stato dell'allocazione del flag di funzionalità.
• ETag: L'ETag corrente per il flag di funzionalità.
• FeatureFlagReference: riferimento al flag di funzionalità nel formato di <your_store_endpoint>kv/<feature_flag_key>. Quando è presente un'etichetta, il riferimento lo include come parametro di query: <your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>.

Lo schema completo è disponibile nella definizione dello schema di eventi di valutazione delle funzionalità di Configurazione app.

Passaggi successivi

In questo documento sono stati illustrati i dati di telemetria disponibili per i flag di funzionalità. Per informazioni su come usare i dati di telemetria nelle applicazioni, continuare con il documento seguente per la lingua o la piattaforma.