共用方式為


功能旗標遙測參考

在功能旗標上擁有遙測數據,是瞭解功能旗標使用方式的強大工具。 遙測可讓您針對功能管理策略做出明智的決策。

在本檔中,您會:

  • 瞭解可使用 Azure 應用程式設定提供者連結庫的遙測數據
  • 瞭解使用功能管理連結庫可用的遙測數據

功能評估

每當應用程式中評估已啟用遙測的功能旗標時,就會發出功能評估事件。 每當程式代碼檢查功能旗標的狀態或取得變體時,就會發生名為 FeatureEvaluation的這個事件。 事件會擷取評估結果、變體指派詳細數據,以及關於為何做出特定決策的內容資訊。

此事件包含下欄位:

基本欄位

功能管理連結庫會將下列屬性提供給遙測數據:

  • FeatureName:功能旗標的名稱。
  • Enabled:布爾值,指出是否啟用功能旗標。
  • Variant:為功能旗標選取的變體。
  • VariantAssignmentReason:將變體指派給使用者的原因;DefaultWhenDisabled、DefaultWhenEnabled、User、Group、Percentile、None。
  • TargetingId:指派給變體之用戶的標識碼。
  • DefaultWhenEnabled:啟用功能旗標的預設變體。
  • 版本:此架構的版本。
  • VariantAssignmentPercentage:指定所指派變體所配置用戶基底的百分比。 此欄位僅適用於以百分位數為基礎的工作分派。

您可以在 功能評估事件架構定義中找到完整的架構。

此數據接著可以傳送至要檢視的位置,例如 Azure 監視器。 使用我們提供的 Azure 監視器連線時,每當評估已啟用遙測的功能旗標時,就會使用下列屬性發佈 custom_event

應用程式組態自定義欄位

使用 Azure 應用程式設定提供者連結庫時,會將其他屬性新增至遙測數據。 這些屬性提供功能旗標及其評估的相關內容:

  • AllocationID:代表功能旗標配置狀態的唯一標識碼。
  • ETag:功能旗標的目前 ETag。
  • FeatureFlagReference:以 的格式 <your_store_endpoint>kv/<feature_flag_key>參考功能旗標。 當標籤存在時,參考會將其納入為查詢參數: <your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>

您可以在 應用程式組態功能評估事件架構定義中找到完整的架構。

後續步驟

在本檔中,您已瞭解功能旗標可用的遙測數據。 若要瞭解如何在應用程式中使用遙測數據,請繼續閱讀下列語言或平台的檔。