Povolení telemetrie pro funkční přepínače

Telemetrie je automatizovaný proces shromažďování, přenosu a analýzy dat o tom, jak se vaše aplikace a její funkce používají. Povolení telemetrie pro příznaky funkcí nabízí cenné přehledy o chování a dopadu zavedení funkcí, což pomáhá týmům iterovat rychleji, vylepšit uživatelské prostředí, včas zjišťovat problémy a ověřovat efektivitu nových funkcí. Díky telemetrii můžou týmy odpovídat na kritické otázky, jako jsou:

• Je funkce povolená nebo zakázaná podle očekávání?
• Mají konkrétní uživatelé nebo skupiny přístup k nové funkci?
• Způsobuje funkce regresi výkonu nebo chyby?
• Jaký je dopad funkce na klíčové metriky, jako je zapojení nebo převod?

Díky využití telemetrických dat můžou organizace provádět informovaná rozhodnutí, rozhodnutí řízená daty, rychle identifikovat a řešit problémy a optimalizovat doručování funkcí pro lepší obchodní a uživatelské výsledky.

Telemetrie je proces shromažďování, přenosu a analýzy dat o využití a výkonu vaší aplikace. Pomáhá monitorovat chování funkčních příznaků a přijímat rozhodnutí na základě dat. Když je nasazena změna příznaku funkce, je často důležité analyzovat její vliv na aplikaci. Tady je například několik otázek, které mohou nastat:

• Jsou moje vlajky povolené nebo zakázané, jak bylo očekáváno?
• Mají cíloví uživatelé přístup k určité funkci podle očekávání?
• Jaký vliv má varianta na zapojení zákazníků?

Na tyto typy otázek je možné odpovědět prostřednictvím emisí a analýzy událostí vyhodnocení příznaků funkcí.

Požadavky

• Příznak funkce vytvořený v Použít variantní příznaky.

Připojení k Application Insights

1. V portálu Azure otevřete svůj App Configuration store.

2. V části Telemetrie vyberte okno Application Insights (Preview).

3. Vyberte předplatné, skupinu prostředků. Poté vyberte existující prostředek Application Insights, ke kterému chcete připojit službu App Configuration Store, nebo zvolte Vytvořit nový a vytvořte nový prostředek Application Insights.

4. Vyberte tlačítko Připojit .

   

Povolení telemetrie příznaku funkce

1. Otevřete úložiště konfigurace aplikace v portálu Azure a v části Operace vyberte panel Správce funkcí.

2. Vyberte příznak funkce s názvem Greeting (Pozdrav). Pokud ho nemáte, vytvořte ho podle pokynů. Potom klikněte pravým tlačítkem myši na příznak funkce a vyberte Upravit.

   

3. V novém zobrazení vyberte kartu Telemetrie .

4. Zaškrtněte políčko Povolit telemetrii a pak v dolní části stránky vyberte tlačítko Zkontrolovat a aktualizovat .

   

5. Pokračujte následujícími pokyny k používání telemetrie ve vaší aplikaci pro jazyk nebo platformu, kterou používáte.

   • ASP.NET Core
   • Krajta
   • JavaScript

Kontrola výsledků telemetrie v Azure App Configuration

1. Přejděte do okna Application Insights na portálu Konfigurace aplikace. Měl by se zobrazit graf zobrazující všechny události z vaší aplikace. Tento graf poskytuje počáteční přehled vzorů aktivit.

   

2. Pomocí selektoru časového rozsahu se můžete zaměřit na konkrétní období a identifikovat trendy nebo prozkoumat konkrétní časové rámce zájmu.

3. Filtrovat podle flagu funkce

   1. Klikněte na rozevírací nabídku nad grafem událostí.
   2. V části Příznaky funkcí s událostmi vyberte příznak funkce.
   3. Graf teď zobrazí pouze události související s vyhodnoceními příznaku funkce.

   

4. Pokud chcete získat přístup k podrobnější telemetrii, kliknutím na Zobrazit podrobnosti otevřete kartu telemetrie.

   

Poznámka:

K této záložce se dostanete také tak, že přejdete na Správce funkcí a kliknete na Zobrazit události ve sloupci telemetrie pro příslušný příznak funkce.

Ověřte přiřazení variant

Na kartě telemetrie můžete zobrazit:

• Celkový počet událostí: Celkový počet událostí vyhodnocení vygenerovaných vaší aplikací
• Jedineční uživatelé: Počet jedinečných uživatelů, kteří byli cílem a pro které byly události generovány.

Pokud chcete zobrazit distribuci uživatelů a počet vyhodnocení napříč variantami Simple, Long a None, seskupte metriky podle varianty. Toto seskupení umožňuje zjistit, jestli nakonfigurované alokace fungují podle očekávání a že všem uživatelům jsou dostupné všechny očekávané varianty.

V tomto příkladu vidíme, že počet uživatelů přiřazených variantě None je téměř dvojnásobný než u variant Simple a Long vzhledem ke konfigurovanému rozdělení 50-25-25 percentilu mezi "None", "Simple" a "Long".

Potvrdit přepsání a chování na základě stavu příznaku

Uživatelé můžou obdržet variantu z různých důvodů. Chcete zajistit, aby přiřazení variant nebyla pouze ve správném poměru, ale také z správného důvodu. Metriky můžete seskupit podle důvodu přiřazení. V tomto příkladu vidíme, že jediným důvodem přiřazení je pouze přidělení percentilu.

1. Zakažte příznak funkce tak, že přejdete do správce funkcí a vypnete přepínač příznaku funkce "Povolit."

2. Ve sloupci telemetrie klikněte na Zobrazit události a přejděte na kartu telemetrie v režimu jen pro čtení.

3. Zobrazit jedinečný počet uživatelů podle variant. Mělo by být vidět, že všechna přiřazení pro Long a Simple se stanou nulou. Uživatelům je přiřazena pouze varianta None, která je v našem případě výchozí.

   

4. Přepněte na zobrazení jedinečného počtu uživatelů podle důvodu přiřazení. Ověřte z grafu, že alokace percentilů klesají na nulu a DefaultWhenDisabled je jediný důvod, proč jsou uživatelům přiřazovány varianty.

   Mezi další možné důvody patří "DefaultWhenEnabled", "Group" nebo "User", pokud je nakonfigurováno.

   

Analýza telemetrie v Application Insights

Teď, když jste potvrdili, že přidělení feature flagů funguje podle očekávání, můžete se podrobněji podívat na události telemetrie a zjistit, jak různé varianty fungují na základě lajků emitovaných pro uživatele.

Na webu Azure Portal otevřete prostředek Application Insights a v části Monitorování vyberte Protokoly. V okně dotazu spusťte následující dotaz, aby se zobrazily události telemetrie:

// Step 1: Get distinct users and their Variant from FeatureEvaluation (Replace <store-endpoint> with your store's endpoint)
let evaluated_users =
    customEvents
    | where name == "FeatureEvaluation"
    | where tostring(customDimensions.FeatureFlagReference) == "https://<store-endpoint>/kv/.appconfig.featureflag/Greeting"
    | extend TargetingId = tostring(customDimensions.TargetingId),
            Variant = tostring(customDimensions.Variant)
    | summarize Variant = any(Variant) by TargetingId;

// Step 2: Get distinct users who emitted a "Like"
let liked_users =
    customEvents
    | where name == "Liked"
    | extend TargetingId = tostring(customDimensions.TargetingId)
    | summarize by TargetingId;

// Step 3: Join them to get only the evaluated users who also liked
let hearted_users =
    evaluated_users
    | join kind=inner (liked_users) on TargetingId
    | summarize HeartedUsers = dcount(TargetingId) by Variant;

// Step 4: Total evaluated users per variant
let total_users =
    evaluated_users
    | summarize TotalUsers = dcount(TargetingId) by Variant;

// Step 5: Combine results
let combined_data =
    total_users
    | join kind=leftouter (hearted_users) on Variant
    | extend HeartedUsers = coalesce(HeartedUsers, 0)
    | extend PercentageHearted = strcat(round(HeartedUsers * 100.0 / TotalUsers, 1), "%")
    | project Variant, TotalUsers, HeartedUsers, PercentageHearted;

// Step 6: Add total row
let total_sum =
    combined_data
    | summarize Variant="All", TotalUsers = sum(TotalUsers), HeartedUsers = sum(HeartedUsers);

// Step 7: Output
combined_data
| union (total_sum)

Při každém načtení stránky nabídky se zobrazí jedna událost FeatureEvaluation a pokaždé, když se kliklo na tlačítko Like, zobrazí se jedna událost Like. Události "FeatureEvaluation" mají vlastní vlastnost nazvanou FeatureName s názvem příznaku funkce, který byl vyhodnocen. Obě události mají vlastní vlastnost zvanou TargetingId se jménem uživatele, který označil citát jako oblíbený.

V tomto příkladu vidíme, že i když počet uživatelů, kteří získali Dlouhou variantu oproti Jednoduché, byl zhruba stejný, zdá se, že Jednoduchá varianta dosahuje lepších výsledků s náskokem 22%.