Referencja telemetrii przełącznika funkcji

Posiadanie danych telemetrycznych na flagach funkcji może być zaawansowanym narzędziem do zrozumienia sposobu użycia flag funkcji. Telemetria umożliwia podejmowanie świadomych decyzji dotyczących strategii zarządzania funkcjami.

W tym dokumencie wykonasz następujące elementy:

Ocena funkcji

Zdarzenie oceny funkcji jest emitowane za każdym razem, gdy flaga funkcji, która ma włączoną telemetrię, jest oceniana w aplikacji. To zdarzenie o nazwie FeatureEvaluationwystępuje za każdym razem, gdy kod sprawdza stan flagi funkcji lub pobiera wariant. Zdarzenie przechwytuje wynik oceny, szczegóły przypisania wariantu i kontekstowe informacje o tym, dlaczego podjęto konkretne decyzje.

To zdarzenie zawiera następujące pola:

Pola podstawowe

Biblioteki zarządzania funkcjami udostępniają następujące właściwości danych telemetrycznych:

• FeatureName: nazwa flagi funkcji.
• Włączone: wartość logiczna wskazująca, czy flaga funkcji jest włączona.
• Wariant: wariant wybrany dla flagi funkcji.
• VariantAssignmentReason: przyczyna przypisania wariantu do użytkownika; DefaultWhenDisabled, DefaultWhenEnabled, User, Group, Percentile, None.
• TargetId: identyfikator użytkownika przypisanego do wariantu.
• DefaultWhenEnabled: domyślny wariant flagi funkcji po jej włączeniu.
• Wersja: wersja tego schematu.
• VariantAssignmentPercentage: określa procent bazy użytkownika przydzielony wariant przypisany do. To pole jest obecne tylko w przypadku przypisań opartych na percentylu.

Pełny schemat można znaleźć w definicji schematu zdarzenia oceny funkcji.

Te dane można następnie wysyłać do lokalizacji, które mają być wyświetlane, na przykład do usługi Azure Monitor. W przypadku korzystania z udostępnionych połączeń z usługą Azure Monitor custom_event jest publikowany z następującymi właściwościami za każdym razem, gdy zostanie obliczona flaga funkcji z włączoną obsługą telemetrii.

Pola niestandardowe usługi App Configuration

Gdy są używane biblioteki dostawcy usługi Azure App Configuration, dodatkowe właściwości są dodawane do danych telemetrycznych. Te właściwości zapewniają więcej kontekstu flagi funkcji i jej oceny:

• AllocationID: unikatowy identyfikator reprezentujący stan alokacji flagi funkcji.
• ETag: bieżący element ETag flagi funkcji.
• FeatureFlagReference: odwołanie do flagi funkcji w formacie <your_store_endpoint>kv/<feature_flag_key>. Gdy etykieta jest obecna, odwołanie zawiera go jako parametr zapytania: <your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>.

Pełny schemat można znaleźć w definicji schematu zdarzenia oceny funkcji konfiguracji aplikacji.

Dalsze kroki

W tym dokumencie przedstawiono informacje o danych telemetrycznych dostępnych dla flag funkcji. Aby dowiedzieć się, jak używać danych telemetrycznych w aplikacjach, przejdź do następującego dokumentu dla języka lub platformy.