Referência de telemetria do sinalizador de recurso

Ter dados de telemetria em seus sinalizadores de recursos pode ser uma ferramenta poderosa para entender como os sinalizadores de recursos são usados. A telemetria permite que você tome decisões informadas sobre sua estratégia de gerenciamento de recursos.

Neste documento, você:

Avaliação de recursos

O evento de avaliação de recurso é emitido sempre que um sinalizador de recurso que tem a telemetria habilitada é avaliado em seu aplicativo. Esse evento, nomeado FeatureEvaluation, ocorre sempre que o código verifica o status de um sinalizador de recurso ou obtém uma variante. O evento captura o resultado da avaliação, os detalhes da atribuição variante e as informações contextuais sobre por que decisões específicas foram tomadas.

Este evento contém os seguintes campos:

Campos básicos

As bibliotecas de gerenciamento de recursos fornecem as seguintes propriedades aos dados de telemetria:

• FeatureName: o nome do sinalizador de recurso.
• Habilitado: um valor booliano que indica se o sinalizador de recurso está habilitado.
• Variant: a variante que foi selecionada para o sinalizador de recurso.
• VariantAssignmentReason: o motivo pelo qual a variante foi atribuída ao usuário; DefaultWhenDisabled, DefaultWhenEnabled, User, Group, Percentile, None.
• TargetingId: a ID do usuário atribuído à variante.
• DefaultWhenEnabled: a variante padrão do sinalizador de recurso quando ele está habilitado.
• Versão: a versão deste esquema.
• VariantAssignmentPercentage: especifica o percentual da base de usuários para a qual a variante atribuída está alocada. Esse campo só está presente para atribuições baseadas em percentil.

O esquema completo pode ser encontrado na definição de esquema de evento de avaliação de recursos.

Esses dados podem ser enviados para locais a serem exibidos, como o Azure Monitor. Ao usar nossas conexões fornecidas com o Azure Monitor, um custom_event é publicado com as propriedades a seguir sempre que um sinalizador de recurso habilitado para telemetria é avaliado.

Campos personalizados da Configuração de Aplicativo

Quando as bibliotecas do provedor de Configuração de Aplicativo do Azure são usadas, propriedades adicionais são adicionadas aos dados de telemetria. Essas propriedades fornecem mais contexto sobre o sinalizador de recursos e sua avaliação:

• AllocationID: um identificador exclusivo que representa o estado da alocação do sinalizador de recurso.
• ETag: a ETag atual para o sinalizador de recurso.
• FeatureFlagReference: uma referência ao sinalizador de recurso no formato de <your_store_endpoint>kv/<feature_flag_key>. Quando um rótulo está presente, a referência o inclui como um parâmetro de consulta: <your_store_endpoint>kv/<feature_flag_key>?label=<feature_flag_label>.

O esquema completo pode ser encontrado na definição de esquema de evento de avaliação de recursos de configuração de aplicativo.

Próximas etapas

Neste documento, você aprendeu sobre os dados de telemetria disponíveis para sinalizadores de recursos. Para saber mais sobre como usar os dados de telemetria em seus aplicativos, prossiga para o documento a seguir para seu idioma ou plataforma.