Analyzing extension lifecycle trace telemetry

INTRODUCED IN: Business Central 2020 release wave 1, version 16.3. Extension-level support introduced in 2020 release wave 2, version 17.1.

Extension lifecycle telemetry gathers data about the success or failure of the following extension-related operations:

  • Compiling an extension
  • Synchronizing an extension
  • Publishing an extension
  • Installing an extension
  • Updating an extension
  • Uninstalling an extension
  • Unpublishing an extension

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

Traces are recorded for operations initiated from any of the following components, depending on whether you have Business Central online or on-premises:

ComponentOnlineOn-premises
Extension Management page in the Business Central client.YesYes
Manage Apps page in the Business Central admin center.Yes
App Management API of the Business Central admin center.Yes
Extension management PowerShell cmdlets from the Business Central Administration ShellYes
Business Central control plane, which is the online service managed by Microsoft.Yes

Note

For some operations, you might experience that certain custom dimensions aren't available. The reason is that custom dimensions are added to the signal gradually, as the information is retrieved. If the operation fails before the custom dimension is retrieved, it isn't included in the result. For example, if you try to uninstall an extension using the Uninstall-NAVApp cmdlet, and the specified extension name is wrong, the operation fails. In this case, the extensionId and extensionVersion will be excluded from the results.

Environment and server traces

The traces in this section are recorded for extensions that are published to the environment/server in the tenant scope only.

  • For on-premises, it includes extensions that are published by running the Publish-NAVApp cmdlet with the -Scope Tenant parameter.

  • For online, it includes per-tenant extensions uploaded from the Extension Management page in the client. It doesn't include Microsoft extensions or Marketplace extensions.

Extension compiled successfully

Occurs when an extension compiles successfully on the service. An extension compiles when it's published or when it's repaired by using the Repair-NAVApp cmdlet.

General dimensions

DimensionDescription or value
messageExtension compiled successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0020
extensionCompilationDependencyListSpecifies details about the extensions on which the compiled extension has dependencies.

Note: If the value exceeds 8000 characters, one or two additional dimensions will be included in the trace to cover the complete dependency list. Learn more in About custom dimensions.
extensionCompilationResultCompilation succeeded without errors or warnings.
extensionNameSpecifies the name of the extension that was compiled.
extensionIdSpecifies the ID of the extension/app.
extensionPublishedAsSpecifies whether the compiled extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the compiled extension.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Common custom dimensions

The following table explains custom dimensions that are common to all traces.

DimensionDescription or value
aadTenantIdSpecifies 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.
componentDynamics 365 Business Central Server.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing environments.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeysA comma-separated list of keys that have been deprecated. We recommend that you update any queries that use these keys to use the new key names.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Extension failed to compile

Occurs when an extension failed to compile on the service. An extension compiles when it's published or when it's repaired by using the Repair-NAVApp cmdlet.

General dimensions

DimensionDescription or value
messageExtension failed to compile: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0021
extensionCompilationDependencyListSpecifies details about the extensions on which the compiled extension has dependencies.

Note: If the value exceeds 8000 characters, one or two additional dimensions will be included in the trace to cover the complete dependency list. Learn more in About custom dimensions.
extensionCompilationResultSpecifies details about the error that occurred during compilation.
extensionNameSpecifies the name of the extension that failed to compile.
extensionIdSpecifies the ID of the extension/app.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the compiled extension.
failureReasonSpecifies the error that occurred when compiling the extension.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension published successfully

Occurs when an extension published successfully on the service.

General dimensions

DimensionDescription or value
messageExtension published successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0014
extensionIsRadSpecifies whether the extension was RAD published. True indicates the extension was RAD published. False indicates normal publishing.

RAD (Rapid Application Development) publishing is done from the AL development environment. RAD publishing is a partial publishing operation that only publishes application objects that have changed during development. Learn more in Work with Rapid Application Development.
extensionNameSpecifies the name of the extension that was published.
extensionIdSpecifies the ID of the extension/app.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the published extension.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension failed to publish

Occurs when an extension failed to publish on the service.

General dimensions

DimensionDescription or value
messageExtension failed to publish: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0015
extensionIsRadSpecifies whether the extension was RAD published. True indicates the extension was RAD published. False indicates normal publishing.

RAD (Rapid Application Development) publishing is done from the AL development environment. RAD publishing is a partial publishing operation that only publishes application objects that have changed during development. Learn more in Work with Rapid Application Development.
extensionNameSpecifies the name of the extension that published.
extensionIdSpecifies the ID of the extension/app.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the published extension.
failureReasonSpecifies the error that occurred when publishing.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension unpublished successfully

Occurs when an extension was unpublished successfully on the service.

General dimensions

DimensionDescription or value
messageExtension un-published successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0018
extensionNameSpecifies the name of the extension that was unpublished.
extensionIdSpecifies the ID of the extension/app.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the unpublished extension.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension failed to un-publish

Occurs when an extension fails to unpublish on the service.

General dimensions

DimensionDescription or value
messageExtension failed to un-publish: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0019
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that failed to unpublish.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the unpublished extension.
failureReasonSpecifies the error that occurred when unpublishing.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Tenant traces

The traces in this section are recorded for synchronizing, installing and updating extensions on a tenant.

  • Synchronizing extensions

    • For on-premises, data for this operation is recorded when an extension is synchronized by using the Sync-NAVApp cmdlet.

    • For online, data is recorded when an extension is installed from the Extension Management page in the client. Or, when upgraded from the Manage Apps page in the Business Central administration center.

  • Installing and uninstalling extensions

    • For on-premises, data for these operations is recorded when an extension is installed or uninstalled by using the Install-NAVApp cmdlet or Uninstall-NAVApp cmdlet. Or, when an extension is installed or uninstalled from the Extension Management page in the client.

    • For online, data for these operations is recorded when an extension is installed or uninstalled from the Extension Management page in the client.

  • Updating an extension

    • For on-premises, data for this operation is recorded when an extension is upgraded by using the Start-NAVAppDataUpgrade cmdlet.

    • For online, data is recorded when an extension is updated from the Manage Apps page in the Business Central administration center.

Extension synchronized successfully

Occurs when an extension synchronizes successfully on the tenant.

General dimensions

DimensionDescription or value
messageExtension synchronized successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0012
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that was synchronized.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionSynchronizationModeSpecifies whether the extension was synchronized in one of the following modes:<ul><li>Add: The database schema defined by the objects in the extension is added to the database schema of the tenant database. This mode is typically used after you publish an extension for the first time.</li><li>Clean: The database schema defined by all versions of the extension will be removed from the database and all data is lost. This mode is typically used when an extension will no longer be used and all versions are unpublished.</li><li>Development: This mode acts similarly to Add, except it's intended for use during development. It lets you sync the same version of an extension that is already published. However, to run this mode, only one version of the app can be currently published.</li><li>ForceSync: This mode is like Add except it supports destructive schema changes, such as removing fields, renaming them, and changing their data types. It's typically used during development, and is the mode used when an extension is published and installed from the AL development environment.</li></ul> Learn more in Sync-NAVApp cmdlet -Mode.
extensionVersionSpecifies the version of the extension that was synchronized.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension failed to synchronize

Occurs when an extension fails to synchronize on the tenant.

General dimensions

DimensionDescription or value
messageExtension failed to synchronize: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0013
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that failed to synchronize.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionSynchronizationModeSpecifies whether the extension was synchronized in one of the following modes:<ul><li>Add: The database schema defined by the objects in the extension is added to the database schema of the tenant database. This mode is typically used after you publish an extension for the first time.</li><li>Clean: The database schema defined by all versions of the extension will be removed from the database and all data is lost. This mode is typically used when an extension will no longer be used and all versions are unpublished.</li><li>Development: This mode acts similarly to Add, except it's intended for use during development. It lets you sync the same version of an extension that is already published. However, to run this mode, only one version of the app can be currently published.</li><li>ForceSync: This mode is like Add except it supports destructive schema changes, such as removing fields, renaming them, and changing their data types. It's typically used during development, and is the mode used when an extension is published and installed from the AL development environment.</li></ul> Learn more in Sync-NAVApp cmdlet -Mode.
extensionVersionSpecifies the version of the extension was synchronized.
failureReasonSpecifies the error that occurred when synchronizing the extension.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension is already synchronized

Occurs when an extension was already synchronized on the tenant. Added in version 21.1.

General dimensions

DimensionDescription or value
messageExtension is already synchronized: {extensionName}
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0056
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that failed to synchronize.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionSynchronizationModeSpecifies whether the extension was synchronized in one of the following modes:<ul><li>Add: The database schema defined by the objects in the extension is added to the database schema of the tenant database. This mode is typically used after you publish an extension for the first time.</li><li>Clean: The database schema defined by all versions of the extension will be removed from the database and all data is lost. This mode is typically used when an extension will no longer be used and all versions are unpublished.</li><li>Development: This mode acts similarly to Add, except it's intended for use during development. It lets you sync the same version of an extension that is already published. However, to run this mode, only one version of the app can be currently published.</li><li>ForceSync: This mode is like Add except it supports destructive schema changes, such as removing fields, renaming them, and changing their data types. It's typically used during development, and is the mode used when an extension is published and installed from the AL development environment.</li></ul> Learn more in Sync-NAVApp cmdlet -Mode.
extensionVersionSpecifies the version of the extension was synchronized.
failureReasonSpecifies the error that occurred when synchronizing the extension.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension installed successfully

Occurs when an extension installs successfully on a tenant.

General dimensions

DimensionDescription or value
messageExtension installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0010
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that was installed.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the extension that was installed.
extensionAvailabilitySpecifies the availability of a Marketplace extension:<ul><li>Public - The version is public and can be installed on any environment.</li><li>Preview - The version is in preview and can be installed on selected Sandbox environments using a preview key provided by the Marketplace publisher.</li>
extensionPreviewKeyProvidedSpecifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Dependent extension installed successfully

Occurs when an extension is installed because another extension that depends on it was installed. This event is only available from version 18.1 and later.

General dimensions

DimensionDescription or value
messageDependent extension installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0026
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that was installed.
extensionPublisherSpecifies the extension's publisher.
extensionVersionSpecifies the version of the extension that was installed.
parentExtensionIdSpecifies the ID of the other extension that required the installation this extension.
See common custom dimensions

Extension failed to install

Occurs when an extension failed to install on a tenant.

General dimensions

DimensionDescription or value
messageExtension failed to install: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0011
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that failed to install.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the extension that was installed.
failureReasonSpecifies the error that occurred when the extension was installed.
extensionAvailabilitySpecifies the availability of a Marketplace extension:<ul><li>Public - The version is public and can be installed on any environment.</li><li>Preview - The version is in preview and can be installed on selected Sandbox environments using a preview key provided by the Marketplace publisher.</li>
extensionPreviewKeyProvidedSpecifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension un-installed successfully

Occurs when an extension is successfully uninstalled from a tenant.

General dimensions

DimensionDescription or value
messageExtension un-installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0016
doNotSaveDataSpecifies whether the uninstall operation was run with option not to save the data in database table fields that are added by the extension. When using the Uninstall-NAVApp cmdlet, this condition is set with the -DoNotSaveData switch parameter.
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that was uninstalled.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the extension that was uninstalled.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Dependent extension un-installed successfully

Occurs when an extension is uninstalled because an extension that it's dependent on was uninstalled. This event is only available from version 18.1 and later.

General dimensions

DimensionDescription or value
messageDependent extension un-installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0027
doNotSaveDataSpecifies whether the uninstall operation on the parent extension was run with option not to save the data in database table fields that are added by the extension. When using the Uninstall-NAVApp cmdlet, this condition is set with the -DoNotSaveData switch parameter.
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the dependent extension that was uninstalled.
extensionPublisherSpecifies the dependent extension's publisher.
extensionVersionSpecifies the version of the dependent extension that was uninstalled.
parentExtensionIdSpecifies the ID of the extension that the uninstalled extension is dependent on.
See common custom dimensions

Extension failed to un-install

Occurs when an extension failed to uninstall on a tenant.

General dimensions

DimensionDescription or value
messageExtension failed to un-install: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0017
doNotSaveDataSpecifies whether the uninstall operation was run with option not to save the data in database table fields that are added by the extension. When using the Uninstall-NAVApp cmdlet, this condition is set with the -DoNotSaveData switch parameter.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing environments.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that failed to uninstall.
extensionPublishedAsSpecifies whether the extension was published as one of the following options:<ul><li>Dev - published from the AL development environment.</li><li>Global - published to the global scope.</li><li>Tenant - published to the tenant scope.</li></ul>
extensionPublisherSpecifies the extension's publisher.
extensionScopeSpecifies whether the extension was published to one of the following scopes:<ul><li>Global - the extension can be installed on all tenants connected the service instance. </li><li>Tenant - the extension can only be installed on the tenant to which it was published.</li></ul>
extensionVersionSpecifies the version of the extension that failed to uninstall.
failureReasonSpecifies the error that occurred when the extension was uninstalled.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension updated successfully

Occurs when an extension updates successfully on the service.

Note

Data is also recorded for any upgrade code that was run. Learn more in Analyzing extension update trace telemetry.

General dimensions

DimensionDescription or value
messageExtension updated successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel1

Custom dimensions

DimensionDescription or value
environmentNameSpecifies the name of the tenant environment. Learn more in Managing environments.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0022
extensionCultureSpecifies the language version for which the extension that was upgraded. The value is a language culture name, such as en-US or da-DK. If a language wasn't specified when the extension was installed, then en-US is used by default.
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that was being upgraded.
extensionPublisherSpecifies the extension's publisher.
extensionVersionSpecifies the new version of the extension being upgraded.
extensionVersionFromSpecifies the old version of the extension being upgraded.
extensionAvailabilitySpecifies the availability of a Marketplace extension:<ul><li>Public - The version is public and can be installed on any environment.</li><li>Preview - The version is in preview and can be installed on selected Sandbox environments using a preview key provided by the Marketplace publisher.</li>
extensionPreviewKeyProvidedSpecifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Extension failed to update

Occurs when an extension failed to update on the service.

Note

Data is also recorded for any upgrade code that was run. Learn more in Analyzing extension update trace telemetry.

General dimensions

DimensionDescription or value
messageExtension failed to update: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})
severityLevel3

Custom dimensions

DimensionDescription or value
environmentNameSpecifies the name of the tenant environment. Learn more in Managing environments.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0023
extensionCultureSpecifies the language version for which the extension that was upgraded. The value is a language culture name, such as en-US or da-DK. If a language wasn't specified when the extension was installed, then en-US is used by default.
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension that was being upgraded.
extensionPublisherSpecifies the extension's publisher.
extensionVersionSpecifies the new version of the extension being upgraded.
extensionVersionFromSpecifies the old version of the extension being upgraded.
failureReasonSpecifies the error that occurred during upgrade.
resultFailure
extensionAvailabilitySpecifies the availability of a Marketplace extension:<ul><li>Public - The version is public and can be installed on any environment.</li><li>Preview - The version is in preview and can be installed on selected Sandbox environments using a preview key provided by the Marketplace publisher.</li>
extensionPreviewKeyProvidedSpecifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.
serverExecutionTimeSpecifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the request executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
totalTimeSpecifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.
See common custom dimensions

Control plane traces

APPLIES TO: Business Central online

The traces in this section are emitted by the Business Central control plane service during the installation or update operation of an extension/app. These traces complement the tenant traces described above and help you identify the origin or cause of the extension's installation or update. The traces are recorded when:

  • The extension is explicitly installed or updated
  • The extension is installed or updated because an extension that's dependent on it was installed or updated.
  • A hotfix is applied to the extension by Microsoft or ISV embed partner.

The following table illustrates the traces you can expect to see with the installation or update of an extension, in the order that they'll occur. The trace messages have been simplified for illustration purposes.

Extension install lifecycleExtension update lifecycleTrace source
Environment app version install scheduledEnvironment app version update scheduledControl plane
Environment app version install startedEnvironment app version update startedControl plane
Environment app version install/update requires dependency appEnvironment app version install/update requires dependency appControl plane
Extension synchronized: versionExtension synchronized: versionTenant
Extension installed: versionExtension updated: versionTenant
Environment app version installedEnvironment app version updatedControl plane

Environment app version installation scheduled for environment

Occurs when scheduling the installation of a new extension/app has completed successfully.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName}, version {extensionDestinationVersion} installation scheduled for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0161
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app version installation scheduling failed for environment

Occurs when scheduling the installation of a new extension/app has failed.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName}, version {extensionDestinationVersion} installation scheduling failed for environment: {environmentName}
severityLevel3

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0162
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
failureReasonSpecifies the reason for the failure. Use this for troubleshooting.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app version installation started for environment

Occurs when installing a new extension/app has started.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName}, version {extensionDestinationVersion} installation started for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0163
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app version installation succeeded for environment

Occurs when installing a new extension/app has completed successfully.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName}, version {extensionVersion} installation succeeded for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0164
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
totalTimeSpecifies the total time the operation ran for.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app version installation failed for environment

Occurs when installing a new extension/app has failed.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName}, version {extensionDestinationVersion} installation failed for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependentsUninstallA boolean that specifies whether dependent extensions will be uninstalled.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0165
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionSourceVersionSpecifies the current version of the extension/app.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app version installation/update requires automatically installing a new dependency app for environment

Occurs when the extension/app that's being installed or updated has a dependency on another extension/app that must be installed first.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName}, version {extensionDestinationVersion} installation/update requires automatically installing a new dependency app {dependencyExtensionName}, version {dependencyExtensionDestinationVersion} for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
dependencyExtensionDestinationVersionSpecifies the version of the dependency extension.
dependencyExtensionIdSpecifies the ID of the dependency extension/app.
dependencyExtensionNameSpecifies the name of the dependency extension/app.
dependencyExtensionPublisherSpecifies the publisher of the dependency extension/app.
dependencyExtensionScopeSpecifies whether the dependency extension/app is published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0166
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app update to version scheduled for environment

Occurs when scheduling the update of an existing extension/app to another version has succeeded.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName} update to version {extensionDestinationVersion} scheduled for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0167
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionSourceVersionSpecifies the current version of the extension/app.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app update to version scheduling failed for environment

Occurs when scheduling the update of an existing extension/app to another version has failed.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionId} update to version {extensionDestinationVersion} scheduling failed for environment: {environmentName}
severityLevel3

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0168
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
extensionSourceVersionSpecifies the current version of the extension/app.
failureReasonSpecifies the reason for the failure. Use this for troubleshooting.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app update to version started for environment

Occurs when updating of an existing extension/app to another version has started.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionId} update to version {extensionDestinationVersion} started for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0169
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
extensionSourceVersionSpecifies the current version of the extension/app.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app update to version succeeded for environment

Occurs when updating of an existing extension/app to another version has completed successfully.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionId} update to version {extensionDestinationVersion} succeeded for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0170
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
extensionSourceVersionSpecifies the current version of the extension/app.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
totalTimeSpecifies the total time the operation ran for.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app update to version failed for environment

Occurs when updating an existing extension/app to another version has failed.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionId} update to version {extensionDestinationVersion} failed for environment: {environmentName}
severityLevel3

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0171
extensionDestinationVersionSpecifies the version of the extension/app to be installed or updated to.S
extensionIdSpecifies the ID of the extension/app.
extensionScopeSpecifies whether the extension/app was published to one of the following scopes:
Global - the extension can be installed on all tenants connected the service instance.
Tenant - the extension can only be installed on the tenant to which it was published.
extensionSourceVersionSpecifies the current version of the extension/app.
failureReasonSpecifies the reason for the failure. Use this for troubleshooting.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
totalTimeSpecifies the total time the operation ran for.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app uninstall scheduled for environment

Occurs when scheduling the uninstallation of an extension/app has completed successfully.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionName} uninstall scheduled for environment: {environmentName}
severityLevel1

Custom dimensions

DimensionDescription or value
allowDependencyUpdateA boolean that specifies whether dependent extensions will be updated
allowPreviewVersionA boolean that specifies whether preview versions are allowed.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0173
extensionIdSpecifies the ID of the extension/app.
extensionNameSpecifies the name of the extension/app.
extensionPublisherSpecifies the publisher of the extension/app.
extensionSourceVersionSpecifies the current version of the extension/app.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Environment app uninstall scheduling failed for environment

Occurs when scheduling the uninstallation of an extension/app has failed.

General dimensions

DimensionDescription or value
messageEnvironment app {extensionId} uninstall scheduling failed for environment: {environmentName}
severityLevel3

Custom dimensions

DimensionDescription or value
allowDependentsUninstallA boolean that specifies whether dependent extensions will be uninstalled.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
countryCodeSpecifies the localization for the environment, such as US or DK.
deleteDataA boolean that specifies whether data will be deleted.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the version of the tenant environment.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0174
extensionIdSpecifies the ID of the extension/app.
failureReasonSpecifies the reason for the failure. Use this for troubleshooting.
runAfterDateUtcSpecifies the date and time (in UTC) after which the hotfix can be applied.
useEnvironmentUpdateWindowA boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.
See common custom dimensions-

Upgrading Extensions
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights