{"title":"Feature management telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-feature-management-trace/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/telemetry-feature-management-trace, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/telemetry-feature-management-trace","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Analyze feature management telemetry in Business Central to identify feature switches, their new state, and the user who changed each feature.","date":"2026-11-17","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Feature switch has been flipped","slug":"feature-switch-has-been-flipped","at":382,"chars":1958},{"level":3,"title":"General dimensions","slug":"general-dimensions","at":641,"chars":305},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions","at":946,"chars":726},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code","at":1672,"chars":668},{"level":2,"title":"Related information","slug":"related-information","at":2340,"chars":661}],"text":"INTRODUCED IN: Business Central 2023 release wave 1, version 22.0.\nWhen 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.\n## Feature switch has been flipped\nOccurs when the enabled state of a feature changes in a nontemporary `Feature Key` record, including changes made on the Feature Management page.\nThis event uses normal verbosity (severityLevel 1) and `TelemetryScope::All`.\n### General dimensions\nField|Description or value\nmessage|Feature switch has been flipped\nuser_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. See telemetry-enable-application-insights#assign-a-telemetry-id-to-users.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\nalFeatureDescription|Specifies the description of the feature.\nalFeatureId|Specifies the name of the feature.\nalStatus|Specifies the new state of the feature: Enabled for all users or Disabled.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|AL0000JT3\n### Sample KQL code\nThis KQL code can help you get started analyzing feature management telemetry or if you want to alert on these changes.\n```kql\ntraces\n| where timestamp > ago(60d) // adjust as needed\n| where customDimensions.eventId == 'AL0000JT3'\n| project timestamp\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, environmentType = customDimensions.environmentType\n, featureId = customDimensions.alFeatureId // feature name\n, featureDescription = customDimensions.alFeatureDescription // feature description\n, status = customDimensions.alStatus // enabled/disabled\n, usertelemetryId = user_Id // who did it\n```\n## Related information\ntelemetry-overview\nEnable Telemetry in Business Central<telemetry-enable-application-insights>\nFeature Telemetry sample code<https://github.com/microsoft/BCTech/tree/master/samples/AppInsights/AL/FeatureTelemetry>\n../developer/devenv-system-application-overview\nFeature Telemetry System Application Documentation<https://github.com/microsoft/BCApps/tree/main/src/System%20Application/App/Telemetry>\nFeature Telemetry Codeunit Reference Documentation<https://learn.microsoft.com/dynamics365/business-central/application/system-application/codeunit/system.telemetry.feature-telemetry>\nEnabling new features ahead of time<feature-management>"}