Feature management telemetry

INTRODUCED IN: Business Central 2023 release wave 1, version 22.0.

When new capabilities are added to Business Central in major updates and minor updates, they might come with the ability to be enabled ahead of time on sandbox and production environments. Enabling a feature is done by administrators using the Feature Management page. Each of these changes is logged to telemetry.

Feature switch has been flipped

Occurs when the enabled state of a feature changes in a nontemporary Feature Key record, including changes made on the Feature Management page.

This event uses normal verbosity (severityLevel 1) and TelemetryScope::All.

General dimensions

FieldDescription or value
messageFeature switch has been flipped
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies the Microsoft Entra tenant ID used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra authentication, this value is common.
alFeatureDescriptionSpecifies the description of the feature.
alFeatureIdSpecifies the name of the feature.
alStatusSpecifies the new state of the feature: Enabled for all users or Disabled.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000JT3

Sample KQL code

This KQL code can help you get started analyzing feature management telemetry or if you want to alert on these changes.

traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions.eventId == 'AL0000JT3'
| project timestamp
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, featureId = customDimensions.alFeatureId // feature name
, featureDescription = customDimensions.alFeatureDescription // feature description
, status = customDimensions.alStatus // enabled/disabled
, usertelemetryId = user_Id // who did it

Telemetry Overview
Enable Telemetry in Business Central
Feature Telemetry sample code
Application Overview
Feature Telemetry System Application Documentation
Feature Telemetry Codeunit Reference Documentation
Enabling new features ahead of time