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 a user changes the state of a feature on the Feature Management page.
General dimensions
| Field | Description or value |
|---|---|
| message | Feature switch has been flipped |
| user_Id | The 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
| Dimension | Description or value |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alFeatureDescription | Specifies the description of the feature. |
| alFeatureId | Specifies the name of the feature. |
| alStatus | Specifies the new state of the feature, such as enabled or disabled. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000JT3 |
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
Related information
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