Analyzing extension upload validation telemetry

APPLIES TO: Business Central online

In the Business Central service, when a user or administrator uploads a per-tenant extension to an environment from the Extension Management page, Business Central proactively validates it against the environment.

With this telemetry, partners can monitor these attempts for customers and set up alerts on failures so that they know up-front which customers will need help.

Failed operations result in a trace log entry that includes a reason for the failure.

The validation flow is as follows:

The PTE submission validation flow is as follows:

PTE submission validation request started (LC0200). This includes the main extension to be validated and a list of extensions it depends on.
For each extension (main + dependent extensions)
        For the main extension:
                Extension validation started (LC0204)
                Either
                        Extension validation completed successfully (LC0205)
                or
                        Validation diagnostic reported (LC0210)
                        Extension validation completed with failures (LC0206)
        For each dependent extension:
                Dependent extension validation started (LC0207)
                Either
                        Dependent extension validation completed successfully (LC0208)
                or
                        Validation diagnostic reported (LC0210)
                        Dependent extension validation completed with failures (LC0209)

Then either
        PTE submission validation request completed successfully (LC0202)
or
        PTE submission diagnostic reported (LC0201)
        PTE submission validation request completed with failures (LC0203)

Per-tenant extension (PTE) validation started (LC0200)

Occurs when a new per-tenant extension (PTE) validation attempt is started on the environment.

General dimensions

DimensionDescription or value
messagePTE validation started: request {submissionId}

{submissionId} indicates the identifier for the validation attempt.

Custom dimensions

DimensionDescription or value
eventIdLC0200
environmentIdSpecifies 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.
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.
mainExtensionA JSON structure that contains information about the extension that is being uploaded.
submissionOperationIdA unique identifier (GUID) for the validation attempt.

PTE submission diagnostic reported (LC0201)

Occurs during the PTE submission validation request to report diagnostics related to the submission itself. For example, it could be that a submission has duplicate object IDs. This signal isn't necessarily an error, but can also be a warning or information.

General dimensions

DimensionDescription or value
messageDiagnostic reported on PTE submission validation request: {submissionId}
severityLevel1 for information, 2 for warning, 3 for error

Custom dimensions

DimensionDescription or value
eventIdLC0201
environmentIdSpecifies 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.
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.
mainExtensionA JSON structure that contains information about the extension that is being uploaded.
submissionOperationIdA unique identifier (GUID) for the validation attempt.
dependentExtensionsA JSON structure that contains information about the dependent extensions.
diagnosticCodeSpecifies a diagnostics code emitted by the AL compiler. For more information, see AL compiler diagnostics
diagnosticMessageSpecifies a diagnostics message emitted by the AL compiler.
diagnosticSeveritySpecifies the severity of diagnostics message emitted by the AL compiler, such as Error or Warning.

Extension validation started (LC0204)

Occurs for each extension in the upload. This event is emitted for the main extension being uploaded.

General dimensions

DimensionDescription or value
messageExtension validation started: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the ID of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0204
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the extension that was to be validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
submissionOperationIdA unique identifier (GUID) for the validation attempt.

Extension validation completed successfully (LC0205)

Occurs if the extension can compile against the environment.

General dimensions

DimensionDescription or value
messageExtension validation completed successfully: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the ID of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0205
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the extension that was to be validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
submissionOperationIdA unique identifier (GUID) for the validation attempt.

Extension validation diagnostic reported (LC0210)

Occurs if something was not right when validating the extension on the environment.

General dimensions

DimensionDescription or value
messageValidation diagnostic reported: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the id of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0210
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the extension that was to be validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
diagnosticCodeSpecifies a diagnostics code emitted by the AL compiler. For more information, see AL compiler diagnostics
diagnosticMessageSpecifies a diagnostics message emitted by the AL compiler.
diagnosticSeveritySpecifies the severity of diagnostics message emitted by the AL compiler, such as Error or Warning.
diagnosticSourceLocationSpecifies where in the app code the AL compiler emitted the diagnostics.
diagnosticSourcePathSpecifies where in a file in the app the AL compiler emitted the diagnostics.
submissionOperationIdThe operation ID for the validation submission of the app.

Sample KQL code (Extension Validation diagnostic reported)

This KQL code can help you get started analyzing validation failures for an extension/app:

// Extension Validation diagnostic reported (LC0210)
traces
| where customDimensions has "LC0210"
| where customDimensions.eventId == "LC0210"
| where timestamp > ago(30d) // adjust as needed
| project timestamp
// which environment is being validated
, aadTenantId = customDimensions.environmentId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
// which extension/app is being validated
, extensionId = customDimensions.extensionId
, extensionPublisher = customDimensions.extensionPublisher
, extensionVersion = customDimensions.extensionVersion
, extensionName = customDimensions.extensionName
, mainExtension = customDimensions.mainExtension
// validation info
, diagnosticSourceLocation = customDimensions.diagnosticSourceLocation
, diagnosticMessage = customDimensions.diagnosticMessage
, diagnosticSourcePath = customDimensions.diagnosticSourcePath
, diagnosticCode = customDimensions.diagnosticCode
, diagnosticSeverity = customDimensions.diagnosticSeverity
, submissionOperationId = customDimensions.submissionOperationId

Extension validation completed with failures (LC0206)

Occurs if the extension could not compile against the environment.

General dimensions

DimensionDescription or value
messageExtension validation completed with failures: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the ID of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0206
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the extension that was to be validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
submissionOperationIdA unique identifier (GUID) for the validation attempt.
failureReasonThe overall reason that the extension failed to validate.

Dependent extension validation started (LC0207)

Occurs for each dependent extension in the upload. This event is emitted for extensions that the main extension depends on, not the main extension itself.

General dimensions

DimensionDescription or value
messageExtension validation started: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the ID of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0207
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the dependent extension that was to be validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
submissionOperationIdA unique identifier (GUID) for the validation attempt.

Dependent extension validation completed successfully (LC0208)

Occurs if the dependent extension can compile against the environment.

General dimensions

DimensionDescription or value
messageExtension validation completed successfully: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the ID of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0208
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the dependent extension that was validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
submissionOperationIdA unique identifier (GUID) for the validation attempt.

Dependent extension validation completed with failures (LC0209)

Occurs if the dependent extension could not compile against the environment.

General dimensions

DimensionDescription or value
messageExtension validation completed with failures: extension {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})

{extensionName} indicates the name of the extension.

{extensionVersion} indicates the version of the extension.

{extensionPublisher} indicates the publisher of the extension.

{extensionId} indicates the ID of the extension.

Custom dimensions

DimensionDescription or value
eventIdLC0209
environmentIdSpecifies 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.
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.
extensionNameSpecifies the name of the dependent extension that was validated.
extensionIdSpecifies the ID of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionVersionSpecifies the version of the extension.
submissionOperationIdA unique identifier (GUID) for the validation attempt.
failureReasonThe overall reason that the dependent extension failed to validate.

Per-tenant extension (PTE) validation completed successfully (LC0202)

Occurs when a per-tenant extension (PTE) validation attempt is completed successfully on the environment (so that the extension was uploaded).

General dimensions

DimensionDescription or value
messagePTE submission validation request completed successfully: request {submissionId}

{submissionId} indicates the identifier for the validation attempt.

Custom dimensions

DimensionDescription or value
eventIdLC0202
environmentIdSpecifies 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.
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.
mainExtensionA JSON structure that contains information about the extension that was uploaded.
submissionOperationIdA unique identifier (GUID) for the validation attempt.

Per-tenant extension (PTE) validation completed with failures (LC0203)

Occurs when a new per-tenant extension (PTE) validation attempt completed with failures on the environment (so that the extension was not uploaded).

General dimensions

DimensionDescription or value
messagePTE validation completed with failures: request {submissionId}

{submissionId} indicates the identifier for the validation attempt.

Custom dimensions

DimensionDescription or value
eventIdLC0203
environmentIdSpecifies 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.
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.
mainExtensionA JSON structure that contains information about the extension that is being uploaded.
submissionOperationIdA unique identifier (GUID) for the validation attempt.
failureReasonThe overall reason that the extension failed to upload.

Sample KQL code (per-tenant extension (PTE) validation completed with failures)

This KQL code can help you get started analyzing validation failures for uploading an extension to the environment:

// PTE submission validation request completed with failures: request <submission id>
traces
| where customDimensions has "LC0203"
| where customDimensions.eventId == "LC0203"
| where timestamp > ago(30d) // adjust as needed
| extend mainExtension = parse_json(tostring( customDimensions.mainExtension ))
| project timestamp
// in which environment is the extension being validated
, aadTenantId = customDimensions.aadTenantId
, environmentId = customDimensions.environmentId
, environmentName = customDimensions.environmentName
// which extension/app is being validated
, mainExtensionId = mainExtension.Id
, mainExtensionPublisher = mainExtension.Publisher
, mainExtensionVersion = mainExtension.Version
, mainExtensionName = mainExtension.Name
, dependentExtensions = customDimensions.dependentExtensions
// validation info
, submissionOperationId = customDimensions.submissionOperationId
, failureReason = customDimensions.failureReason

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights