Edit

Share via

Feature management telemetry

  • Article

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

Specifies 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.
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

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