Referência de telemetria do feature flag

Ter dados de telemetria em seus sinalizadores de recursos pode ser uma ferramenta poderosa para entender como seus 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 Avaliação de recursos é emitido sempre que um sinalizador de recurso com telemetria habilitada é avaliado em seu aplicativo. Esse evento, chamado FeatureEvaluation, ocorre sempre que seu código verifica o status de um sinalizador de recurso ou obtém uma variante. O evento captura o resultado da avaliação, detalhes da atribuição de variantes e 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 para dados de telemetria:

• FeatureName: O nome do sinalizador de recurso.
• Habilitado: um valor booleano que indica se o sinalizador de recurso está habilitado.
• Variante: A variante que foi selecionada para o sinalizador de recurso.
• VariantAssignmentReason: A razão pela qual a variante foi atribuída ao usuário; DefaultWhenDisabled, DefaultWhenEnabled, User, Group, Percentil, None.
• TargetingId: A ID do usuário que foi 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 a porcentagem da base de usuários para a qual a variante atribuída está alocada. Este campo só está presente para atribuições baseadas em percentis.

O esquema completo pode ser encontrado na definição de esquema do 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 seguintes propriedades sempre que um sinalizador de recurso habilitado para telemetria é avaliado.

Campos personalizados de Configuração do 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. Estas propriedades fornecem mais contexto sobre o sinalizador de recurso e sua avaliação:

• AllocationID: um identificador exclusivo que representa o estado da alocação do sinalizador de recurso.
• ETag: O 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 do Evento de Avaliação do Recurso de Configuração do Aplicativo.

Próximos passos

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, continue para o seguinte documento para seu idioma ou plataforma.