Referenční informace k telemetrii přepínače funkcí

Používání telemetrických dat u příznaků funkcí může být výkonným nástrojem pro pochopení způsobu použití příznaků funkcí. Telemetrie umožňuje činit informovaná rozhodnutí o strategii správy funkcí.

V tomto dokumentu:

• Zjistěte, jaká telemetrická data jsou k dispozici pomocí knihoven zprostředkovatele azure App Configuration.
• Zjistěte, jaká telemetrická data jsou k dispozici pomocí knihoven správy funkcí.

Vyhodnocení funkcí

Událost vyhodnocení funkce se vygeneruje vždy, když se ve vaší aplikaci vyhodnotí příznak funkce s povolenou telemetrií. Tato událost s názvem FeatureEvaluation, nastane pokaždé, když kód zkontroluje stav příznaku funkce nebo získá variantu. Událost zachycuje výsledek vyhodnocení, podrobnosti o přiřazení varianty a kontextové informace o tom, proč byla provedena konkrétní rozhodnutí.

Tato událost obsahuje následující pole:

Základní pole

Knihovny pro správu funkcí poskytují telemetrickým datům následující vlastnosti:

• FeatureName: Název příznaku funkce.
• Povoleno: Logická hodnota označující, jestli je příznak funkce povolený.
• Varianta: Varianta vybraná pro příznak funkce.
• VariantAssignmentReason: Důvod přiřazení varianty uživateli; DefaultWhenDisabled, DefaultWhenEnabled, User, Group, Percentile, None.
• TargetingId: ID uživatele, který byl přiřazen k variantě.
• DefaultWhenEnabled: Výchozí varianta příznaku funkce, když je povolená.
• Verze: Verze tohoto schématu.
• VariantAssignmentPercentage: Určuje procento uživatelské základny, pro které je přiřazená varianta přidělena. Toto pole je k dispozici pouze pro přiřazení na základě percentilu.

Úplné schéma najdete v definici schématu události vyhodnocení funkce.

Tato data je pak možné odeslat do umístění, která se mají zobrazit, jako je Azure Monitor. Při použití našich poskytnutých připojení ke službě Azure Monitor se custom_event publikuje s následujícími vlastnostmi při každém vyhodnocení příznaku funkce s povolenou telemetrií.

Vlastní pole konfigurace aplikace

Při použití knihoven zprostředkovatele Azure App Configuration se do telemetrických dat přidají další vlastnosti. Tyto vlastnosti poskytují další kontext příznaku funkce a jeho vyhodnocení:

• AllocationID: Jedinečný identifikátor představující stav přidělení příznaku funkce.
• ETag: Aktuální značky ETag příznaku funkce.
• FeatureFlagReference: Odkaz na příznak funkce ve formátu <your_store_endpoint>kv/<feature_flag_key>. Pokud je popisek k dispozici, odkaz ho obsahuje jako parametr dotazu: <your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>.

Úplné schéma najdete v definici schématu události vyhodnocení funkce konfigurace aplikace.

Další kroky

V tomto dokumentu jste se dozvěděli o telemetrických datech dostupných pro příznaky funkcí. Pokud chcete zjistit, jak používat telemetrická data ve vašich aplikacích, pokračujte následujícím dokumentem pro váš jazyk nebo platformu.