{"title":"Analyzing Marketplace app breaking changes validation telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-appsource-app-validation-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-appsource-app-validation-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-appsource-app-validation-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":"Learn about the telemetry for breaking changes validation of Marketplace apps in Business Central.","date":"2026-03-11","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Analyzing Marketplace app breaking changes validation telemetry","slug":"analyzing-marketplace-app-breaking-changes-validation-telemetry","at":0,"chars":14261},{"level":2,"title":"Marketplace app breaking changes validation started (LC0230)","slug":"marketplace-app-breaking-changes-validation-started-lc0230","at":1595,"chars":1234},{"level":3,"title":"General dimensions","slug":"general-dimensions","at":1757,"chars":508},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions","at":2265,"chars":564},{"level":2,"title":"Diagnostic reported on Marketplace app breaking changes validation (LC0231)","slug":"diagnostic-reported-on-marketplace-app-breaking-changes-validation-lc0231","at":2829,"chars":1264},{"level":3,"title":"General dimensions","slug":"general-dimensions-1","at":3169,"chars":226},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-1","at":3395,"chars":698},{"level":2,"title":"Marketplace app breaking changes validation completed successfully (LC0232)","slug":"marketplace-app-breaking-changes-validation-completed-successfully-lc0232","at":4093,"chars":1038},{"level":3,"title":"General dimensions","slug":"general-dimensions-2","at":4288,"chars":505},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-2","at":4793,"chars":338},{"level":2,"title":"Marketplace app breaking changes validation completed with failures (LC0233)","slug":"marketplace-app-breaking-changes-validation-completed-with-failures-lc0233","at":5131,"chars":1793},{"level":3,"title":"General dimensions","slug":"general-dimensions-3","at":5312,"chars":395},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-3","at":5707,"chars":406},{"level":3,"title":"Sample KQL code (Marketplace app breaking changes validation completed with failures)","slug":"sample-kql-code-marketplace-app-breaking-changes-validation-completed-with-failures","at":6113,"chars":811},{"level":2,"title":"Extension validation started (LC0234)","slug":"extension-validation-started-lc0234","at":6924,"chars":1008},{"level":3,"title":"General dimensions","slug":"general-dimensions-4","at":7030,"chars":466},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-4","at":7496,"chars":436},{"level":2,"title":"Extension validation completed successfully (LC0235)","slug":"extension-validation-completed-successfully-lc0235","at":7932,"chars":1048},{"level":3,"title":"General dimensions","slug":"general-dimensions-5","at":8068,"chars":481},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-5","at":8549,"chars":431},{"level":2,"title":"Validation diagnostic reported (LC0236)","slug":"validation-diagnostic-reported-lc0236","at":8980,"chars":2908},{"level":3,"title":"General dimensions","slug":"general-dimensions-6","at":9204,"chars":610},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-6","at":9814,"chars":982},{"level":3,"title":"Sample KQL code (Validation diagnostic reported)","slug":"sample-kql-code-validation-diagnostic-reported","at":10796,"chars":1092},{"level":2,"title":"Extension validation completed with failures (LC0237)","slug":"extension-validation-completed-with-failures-lc0237","at":11888,"chars":2076},{"level":3,"title":"General dimensions","slug":"general-dimensions-7","at":12033,"chars":498},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-7","at":12531,"chars":568},{"level":3,"title":"Sample KQL code (Extension validation completed with failures)","slug":"sample-kql-code-extension-validation-completed-with-failures","at":13099,"chars":865},{"level":2,"title":"Related information","slug":"related-information","at":13964,"chars":297}],"text":"# Analyzing Marketplace app breaking changes validation telemetry\n> APPLIES TO: Business Central online\nThe Business Central service periodically validates existing Marketplace apps against upcoming releases to detect breaking changes. This breaking changes validation ensures that Marketplace apps continue to compile and meet technical requirements across upcoming Business Central versions. If an app fails validation, telemetry traces are emitted to the partner's Application Insights resource.\nWith this telemetry, partners can monitor their Marketplace apps and set up alerts so that they know up front which apps need attention prior to the next major version of Business Central. This process is separate from the Marketplace submission validation<telemetry-appsource-submission-validation-trace>, which occurs when an app is submitted through Partner Center.\nFailed operations result in a trace log entry that includes a reason for the failure.\nThe validation flow is as follows:\n```text\nFirst, Marketplace app breaking changes validation started (LC0230).\nFor each extension\n        Extension validation started (LC0234)\n        Either\n                Extension validation completed successfully (LC0235)\n        or\n                Validation diagnostic reported (LC0236)\n                Extension validation completed with failures (LC0237)\nFinally,\neither\n        Marketplace app breaking changes validation completed successfully (LC0232)\nor\n        Marketplace app breaking changes validation completed with failures (LC0233)\n        Diagnostic reported on validation (LC0231)\n```\n## Marketplace app breaking changes validation started (LC0230)\nOccurs when a new breaking changes validation attempt is started for a Marketplace app extension.\n### General dimensions\nDimension|Description or value\nmessage|Marketplace app breaking changes validation started: extension {extensionInfo} for countries/regions {countryCodeList}, and target build version {targetVersion} <br /><br /> `{extensionInfo}` indicates information about the extension being validated.<br /><br /> `{countryCodeList}` indicates the list of countries/regions the app is being validated for.<br /><br /> `{targetVersion}` indicates the new version that the app is validated against.\n### Custom dimensions\nDimension|Description or value\neventId|LC0230\nextensionId|Specifies the ID of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\ncountryCodeList|Specifies the comma-separated list of countries/regions that the app is being validated for.\nCommon custom dimensions\nThe following table explains other custom dimensions that are common to all Marketplace app breaking changes validation traces.\nDimension|Description or value\ntelemetrySchemaVersion|Specifies the version of the Business Central telemetry schema.\n## Diagnostic reported on Marketplace app breaking changes validation (LC0231)\nOccurs during the breaking changes validation request to report diagnostics related to the validation itself. For example, it could be that a validation has duplicate object IDs. This signal isn't necessarily an error, but can also be a warning or information.\n### General dimensions\nDimension|Description or value\nmessage|Diagnostic reported on validation of extension {extensionInfo} and target build version {targetVersion}\nseverityLevel|1 for information, 2 for warning, 3 for error\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0231|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|extensionName|Specifies the name of the extension/app.|\n|extensionVersion|Specifies the version of the extension.|\n|diagnosticCode|Specifies a diagnostics code emitted by the AL compiler. See AL compiler diagnostics<../developer/diagnostics/diagnostics-overview>|\n|diagnosticMessage|Specifies a diagnostics message emitted by the AL compiler.|\n|diagnosticSeverity|Specifies the severity of diagnostics message emitted by the AL compiler, such as Error or Warning.|\n|See common custom dimensions<#other>||\n## Marketplace app breaking changes validation completed successfully (LC0232)\nOccurs when the breaking changes validation of a Marketplace app has completed successfully and no errors occurred.\n### General dimensions\nDimension|Description or value\nmessage|Marketplace app breaking changes validation completed successfully: extension {extensionInfo}, country {countryCodeList}, and target build version {targetVersion} <br /><br /> `{extensionInfo}` indicates information about the extension that was validated.<br /><br /> `{countryCodeList}` indicates the list of countries/regions the app was validated for.<br /><br /> `{targetVersion}` indicates the version that the app was validated against.\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0232|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|countryCodeList|Specifies the comma-separated list of countries/regions that the app was validated for.|\n|See common custom dimensions<#other>||\n## Marketplace app breaking changes validation completed with failures (LC0233)\nOccurs when the breaking changes validation of a Marketplace app has completed, but errors occurred.\n### General dimensions\nDimension|Description or value\nmessage|Marketplace app breaking changes validation completed with failures: extension {extensionInfo} and target build version {targetVersion} <br /><br /> `{extensionInfo}` indicates information about the extension that was validated.<br /><br /> `{targetVersion}` indicates the version that the app was validated against.\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0233|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|countryCodeList|Specifies the comma-separated list of countries/regions that the app was validated for.|\n|failureReason|One or more extension validation tasks have failed.|\n|See common custom dimensions<#other>||\n### Sample KQL code (Marketplace app breaking changes validation completed with failures)\nThis KQL code can help you get started analyzing breaking changes validation failures for a Marketplace app:\n```kql\n// Marketplace app breaking changes validation completed with failures (LC0233)\ntraces\n| where customDimensions has \"LC0233\"\n| where customDimensions.eventId == \"LC0233\"\n| where timestamp > ago(30d) // adjust as needed\n| project timestamp\n// which extension/app is being validated\n, extensionId = customDimensions.extensionId\n, extensionPublisher = customDimensions.extensionPublisher\n// validation info\n, countryCodeList = customDimensions.countryCodeList\n, failureReason = customDimensions.failureReason\n```\nTo learn more about how to set up alerting on Business Central telemetry, see telemetry-alert.\n## Extension validation started (LC0234)\nOccurs when the validation for a specific extension has started.\n### General dimensions\nDimension|Description or value\nmessage|Extension validation started: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId}) <br /><br /> `{extensionName}` indicates the name of the extension.<br /><br /> `{extensionVersion}` indicates the version of the extension.<br /><br /> `{extensionPublisher}` indicates the publisher of the extension.<br /><br /> `{extensionId}` indicates the ID of the extension.\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0234|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|extensionVersion|Specifies the version of the extension.|\n|countryRegion|Specifies the country/region that the extension is being validated for.|\n|See common custom dimensions<#other>||\n## Extension validation completed successfully (LC0235)\nOccurs when the validation for a specific extension has completed successfully.\n### General dimensions\nDimension|Description or value\nmessage|Extension validation completed successfully: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId}) <br /><br /> `{extensionName}` indicates the name of the extension.<br /><br /> `{extensionVersion}` indicates the version of the extension.<br /><br /> `{extensionPublisher}` indicates the publisher of the extension.<br /><br /> `{extensionId}` indicates the ID of the extension.\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0235|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|extensionVersion|Specifies the version of the extension.|\n|countryRegion|Specifies the country/region that the extension was validated for.|\n|See common custom dimensions<#other>||\n## Validation diagnostic reported (LC0236)\nOccurs when a diagnostic error is reported during the validation of an extension. The errors are reported by the AL compiler or by the ../developer/analyzers/appsourcecop analyzer.\n### General dimensions\nDimension|Description or value\nmessage|Validation diagnostic reported: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId}) for country {countryRegion}. <br /><br /> `{extensionName}` indicates the name of the extension.<br /><br /> `{extensionVersion}` indicates the version of the extension.<br /><br /> `{extensionPublisher}` indicates the publisher of the extension.<br /><br /> `{extensionId}` indicates the ID of the extension.<br /><br /> `{countryRegion}` indicates the country/region that the extension was validated for.\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0236|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|extensionVersion|Specifies the version of the extension.|\n|countryRegion|Specifies the country/region that the extension was validated for.|\n|diagnosticCode|Specifies a diagnostics code emitted by the AL compiler. See AL compiler diagnostics<../developer/diagnostics/diagnostics-overview>|\n|diagnosticMessage|Specifies a diagnostics message emitted by the AL compiler.|\n|diagnosticSeverity|Specifies the severity of diagnostics message emitted by the AL compiler, such as Error or Warning.|\n|diagnosticSourceLocation|Specifies where in the app code the AL compiler emitted the diagnostics.|\n|diagnosticSourcePath|Specifies where in a file in the app the AL compiler emitted the diagnostics.|\n|See common custom dimensions<#other>||\n### Sample KQL code (Validation diagnostic reported)\nThis KQL code can help you get started analyzing breaking changes validation diagnostics for a Marketplace app:\n```kql\n// Validation diagnostic reported (LC0236)\ntraces\n| where customDimensions has \"LC0236\"\n| where customDimensions.eventId == \"LC0236\"\n| where timestamp > ago(30d) // adjust as needed\n| project timestamp\n// which extension/app is being validated\n, extensionId = customDimensions.extensionId\n, extensionName = customDimensions.extensionName\n, extensionPublisher = customDimensions.extensionPublisher\n, extensionVersion = customDimensions.extensionVersion\n// validation info\n, countryRegion = customDimensions.countryRegion\n, diagnosticCode = customDimensions.diagnosticCode\n, diagnosticMessage = customDimensions.diagnosticMessage\n, diagnosticSeverity = customDimensions.diagnosticSeverity\n, diagnosticSourceLocation = customDimensions.diagnosticSourceLocation\n, diagnosticSourcePath = customDimensions.diagnosticSourcePath\n```\nTo learn more about how to set up alerting on Business Central telemetry, see telemetry-alert.\n## Extension validation completed with failures (LC0237)\nOccurs when the validation for a specific extension has completed, but errors occurred.\n### General dimensions\nDimension|Description or value\nmessage|Extension validation completed with failures: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId}) <br /><br /> `{extensionName}` indicates the name of the extension.<br /><br /> `{extensionVersion}` indicates the version of the extension.<br /><br /> `{extensionPublisher}` indicates the publisher of the extension.<br /><br /> `{extensionId}` indicates the ID of the extension.\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0237|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension/app.|\n|extensionPublisher|Specifies the publisher of the extension/app.|\n|extensionVersion|Specifies the version of the extension.|\n|countryRegion|Specifies the country/region that the extension was validated for.|\n|failureReason|One or more error diagnostics were reported. For more information about the diagnostics, see traces with eventId LC0236.|\n|See common custom dimensions<#other>||\n### Sample KQL code (Extension validation completed with failures)\nThis KQL code can help you get started analyzing breaking changes validation failures for a Marketplace app:\n```kql\n// Extension validation completed with failures (LC0237)\ntraces\n| where customDimensions has \"LC0237\"\n| where customDimensions.eventId == \"LC0237\"\n| where timestamp > ago(30d) // adjust as needed\n| project timestamp\n// which extension/app is being validated\n, extensionId = customDimensions.extensionId\n, extensionName = customDimensions.extensionName\n, extensionPublisher = customDimensions.extensionPublisher\n, extensionVersion = customDimensions.extensionVersion\n// validation info\n, countryRegion = customDimensions.countryRegion\n, failureReason = customDimensions.failureReason\n```\nTo learn more about how to set up alerting on Business Central telemetry, see telemetry-alert.\n## Related information\nMonitoring and Analyzing Telemetry<telemetry-overview>\nEnable Sending Telemetry to Application Insights<telemetry-enable-application-insights>\nMarketplace submission validation telemetry<telemetry-appsource-submission-validation-trace>\ntelemetry-environment-validation-trace"}