{"title":"Analyzing extension lifecycle trace telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-extension-lifecycle-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-extension-lifecycle-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-extension-lifecycle-trace","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Analyze Business Central extension lifecycle telemetry to track publishing, installation, synchronization, updates, and failures across environments.","date":"2026-11-17","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Analyzing extension lifecycle trace telemetry","slug":"analyzing-extension-lifecycle-trace-telemetry","at":0,"chars":67860},{"level":2,"title":"Environment and server traces","slug":"environment-and-server-traces","at":1828,"chars":655},{"level":2,"title":"Extension compiled successfully","slug":"extension-compiled-successfully","at":2483,"chars":3136},{"level":3,"title":"General dimensions","slug":"general-dimensions","at":2780,"chars":194},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions","at":2974,"chars":2645},{"level":2,"title":"Extension failed to compile","slug":"extension-failed-to-compile","at":5619,"chars":2187},{"level":3,"title":"General dimensions","slug":"general-dimensions-1","at":5908,"chars":190},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-1","at":6098,"chars":1708},{"level":2,"title":"Extension published successfully","slug":"extension-published-successfully","at":7806,"chars":2120},{"level":3,"title":"General dimensions","slug":"general-dimensions-2","at":7906,"chars":195},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-2","at":8101,"chars":1825},{"level":2,"title":"Extension failed to publish","slug":"extension-failed-to-publish","at":9926,"chars":2168},{"level":3,"title":"General dimensions","slug":"general-dimensions-3","at":10016,"chars":190},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-3","at":10206,"chars":1888},{"level":2,"title":"Extension unpublished successfully","slug":"extension-unpublished-successfully","at":12094,"chars":1672},{"level":3,"title":"General dimensions","slug":"general-dimensions-4","at":12202,"chars":198},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-4","at":12400,"chars":1366},{"level":2,"title":"Extension failed to un-publish","slug":"extension-failed-to-un-publish","at":13766,"chars":1726},{"level":3,"title":"General dimensions","slug":"general-dimensions-5","at":13860,"chars":193},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-5","at":14053,"chars":1439},{"level":2,"title":"Tenant traces","slug":"tenant-traces","at":15492,"chars":1699},{"level":2,"title":"Extension synchronized successfully","slug":"extension-synchronized-successfully","at":17191,"chars":2936},{"level":3,"title":"General dimensions","slug":"general-dimensions-6","at":17296,"chars":198},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-6","at":17494,"chars":2633},{"level":2,"title":"Extension failed to synchronize","slug":"extension-failed-to-synchronize","at":20127,"chars":3007},{"level":3,"title":"General dimensions","slug":"general-dimensions-7","at":20223,"chars":194},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-7","at":20417,"chars":2717},{"level":2,"title":"Extension is already synchronized","slug":"extension-is-already-synchronized","at":23134,"chars":2971},{"level":3,"title":"General dimensions","slug":"general-dimensions-8","at":23259,"chars":129},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-8","at":23388,"chars":2717},{"level":2,"title":"Extension installed successfully","slug":"extension-installed-successfully","at":26105,"chars":2144},{"level":3,"title":"General dimensions","slug":"general-dimensions-9","at":26201,"chars":195},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-9","at":26396,"chars":1853},{"level":2,"title":"Dependent extension installed successfully","slug":"dependent-extension-installed-successfully","at":28249,"chars":887},{"level":3,"title":"General dimensions","slug":"general-dimensions-10","at":28451,"chars":205},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-10","at":28656,"chars":480},{"level":2,"title":"Extension failed to install","slug":"extension-failed-to-install","at":29136,"chars":2218},{"level":3,"title":"General dimensions","slug":"general-dimensions-11","at":29223,"chars":190},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-11","at":29413,"chars":1941},{"level":2,"title":"Extension un-installed successfully","slug":"extension-un-installed-successfully","at":31354,"chars":1941},{"level":3,"title":"General dimensions","slug":"general-dimensions-12","at":31461,"chars":198},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-12","at":31659,"chars":1636},{"level":2,"title":"Dependent extension un-installed successfully","slug":"dependent-extension-un-installed-successfully","at":33295,"chars":1210},{"level":3,"title":"General dimensions","slug":"general-dimensions-13","at":33503,"chars":208},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-13","at":33711,"chars":794},{"level":2,"title":"Extension failed to un-install","slug":"extension-failed-to-un-install","at":34505,"chars":2301},{"level":3,"title":"General dimensions","slug":"general-dimensions-14","at":34597,"chars":193},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-14","at":34790,"chars":2016},{"level":2,"title":"Extension updated successfully","slug":"extension-updated-successfully","at":36806,"chars":2352},{"level":3,"title":"General dimensions","slug":"general-dimensions-15","at":37050,"chars":193},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-15","at":37243,"chars":1915},{"level":2,"title":"Extension failed to update","slug":"extension-failed-to-update","at":39158,"chars":2406},{"level":3,"title":"General dimensions","slug":"general-dimensions-16","at":39394,"chars":189},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-16","at":39583,"chars":1981},{"level":2,"title":"Control plane traces","slug":"control-plane-traces","at":41564,"chars":1443},{"level":2,"title":"Environment app version installation scheduled for environment","slug":"environment-app-version-installation-scheduled-for-environment","at":43007,"chars":1679},{"level":3,"title":"General dimensions","slug":"general-dimensions-17","at":43164,"chars":207},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-17","at":43371,"chars":1315},{"level":2,"title":"Environment app version installation scheduling failed for environment","slug":"environment-app-version-installation-scheduling-failed-for-environment","at":44686,"chars":2043},{"level":3,"title":"General dimensions","slug":"general-dimensions-18","at":44835,"chars":215},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-18","at":45050,"chars":1679},{"level":2,"title":"Environment app version installation started for environment","slug":"environment-app-version-installation-started-for-environment","at":46729,"chars":1922},{"level":3,"title":"General dimensions","slug":"general-dimensions-19","at":46849,"chars":205},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-19","at":47054,"chars":1597},{"level":2,"title":"Environment app version installation succeeded for environment","slug":"environment-app-version-installation-succeeded-for-environment","at":48651,"chars":2027},{"level":3,"title":"General dimensions","slug":"general-dimensions-20","at":48788,"chars":196},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-20","at":48984,"chars":1694},{"level":2,"title":"Environment app version installation failed for environment","slug":"environment-app-version-installation-failed-for-environment","at":50678,"chars":1534},{"level":3,"title":"General dimensions","slug":"general-dimensions-21","at":50796,"chars":204},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-21","at":51000,"chars":1212},{"level":2,"title":"Environment app version installation/update requires automatically installing a new dependency app for environment","slug":"environment-app-version-installationupdate-requires-automatically-installing-a-new-dependency-app-for-environment","at":52212,"chars":2718},{"level":3,"title":"General dimensions","slug":"general-dimensions-22","at":52466,"chars":334},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-22","at":52800,"chars":2130},{"level":2,"title":"Environment app update to version scheduled for environment","slug":"environment-app-update-to-version-scheduled-for-environment","at":54930,"chars":1753},{"level":3,"title":"General dimensions","slug":"general-dimensions-23","at":55090,"chars":203},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-23","at":55293,"chars":1390},{"level":2,"title":"Environment app update to version scheduling failed for environment","slug":"environment-app-update-to-version-scheduling-failed-for-environment","at":56683,"chars":2008},{"level":3,"title":"General dimensions","slug":"general-dimensions-24","at":56848,"chars":209},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-24","at":57057,"chars":1634},{"level":2,"title":"Environment app update to version started for environment","slug":"environment-app-update-to-version-started-for-environment","at":58691,"chars":1894},{"level":3,"title":"General dimensions","slug":"general-dimensions-25","at":58834,"chars":199},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-25","at":59033,"chars":1552},{"level":2,"title":"Environment app update to version succeeded for environment","slug":"environment-app-update-to-version-succeeded-for-environment","at":60585,"chars":1971},{"level":3,"title":"General dimensions","slug":"general-dimensions-26","at":60745,"chars":201},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-26","at":60946,"chars":1610},{"level":2,"title":"Environment app update to version failed for environment","slug":"environment-app-update-to-version-failed-for-environment","at":62556,"chars":2028},{"level":3,"title":"General dimensions","slug":"general-dimensions-27","at":62694,"chars":198},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-27","at":62892,"chars":1692},{"level":2,"title":"Environment app uninstall scheduled for environment","slug":"environment-app-uninstall-scheduled-for-environment","at":64584,"chars":1597},{"level":3,"title":"General dimensions","slug":"general-dimensions-28","at":64729,"chars":165},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-28","at":64894,"chars":1287},{"level":2,"title":"Environment app uninstall scheduling failed for environment","slug":"environment-app-uninstall-scheduling-failed-for-environment","at":66181,"chars":1473},{"level":3,"title":"General dimensions","slug":"general-dimensions-29","at":66318,"chars":171},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-29","at":66489,"chars":1165},{"level":2,"title":"Related information","slug":"related-information","at":67654,"chars":206}],"text":"# Analyzing extension lifecycle trace telemetry\nINTRODUCED IN: Business Central 2020 release wave 1, version 16.3. Extension-level support introduced in 2020 release wave 2, version 17.1.\nExtension lifecycle telemetry gathers data about the success or failure of the following extension-related operations:\n Compiling an extension\n Synchronizing an extension\n Publishing an extension\n Installing an extension\n Updating an extension\n Uninstalling an extension\n Unpublishing an extension\nFailed operations result in a trace log entry that includes a reason for the failure.\nTraces are recorded for operations initiated from any of the following components, depending on whether you have Business Central online or on-premises:\n|Component|Online|On-premises|\n|Extension Management page</ui-extensions> in the Business Central client.|Yes|Yes|\n|Manage Apps page<tenant-admin-center-manage-apps> in the Business Central admin center.|Yes||\n|administration-center-api_app_management of the Business Central admin center.|Yes||\n|Extension management PowerShell cmdlets<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management> from the Business Central Administration Shell||Yes|\n|Business Central control plane, which is the online service managed by Microsoft.|Yes||\n> NOTE\n> 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.\n## Environment and server traces\nThe traces in this section are recorded for extensions that are published to the environment/server in the tenant scope only.\n For on-premises, it includes extensions that are published by running the Publish-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/publish-navapp> with the `-Scope Tenant` parameter.\n 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<https://appsource.microsoft.com/en-US/marketplace?product=dynamics-365-business-central>.\n## Extension compiled successfully\nOccurs 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<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/repair-navapp>.\n### General dimensions\nDimension|Description or value\nmessage|Extension compiled successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\neventId|LC0020\nextensionCompilationDependencyList|Specifies details about the extensions on which the compiled extension has dependencies.<br /><br /> Note: If the value exceeds 8000 characters, one or two additional dimensions will be included in the trace to cover the complete dependency list. See About custom dimensions<telemetry-overview>.\nextensionCompilationResult|Compilation succeeded without errors or warnings.\nextensionName|Specifies the name of the extension that was compiled.\nextensionId|Specifies the ID of the extension/app.\nextensionPublishedAs|Specifies 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>\nextensionPublisher|Specifies the extension's publisher.\nextensionScope|Specifies 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>\nextensionVersion|Specifies the version of the compiled extension.\nresult|Success\nserverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.\ntotalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.\ntelemetrySchemaVersion|Specifies the version of the Business Central telemetry schema.\nCommon custom dimensions\nThe following table explains custom dimensions that are common to all traces.\nDimension|Description or value\naadTenantId|Specifies the Microsoft Entra tenant ID used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra authentication, this value is common.\ncomponent|Dynamics 365 Business Central Server.\nenvironmentName|Specifies the name of the tenant environment. See Managing environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See tenant-admin-center-environments#types-of-environments.\ncomponentVersion|Specifies the version number of the component that emits telemetry (see the component dimension.)\ndeprecatedKeys|A 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.\ntelemetrySchemaVersion|Specifies the version of the Business Central telemetry schema.\n## Extension failed to compile\nOccurs 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<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/repair-navapp>.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to compile: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0021|\n|extensionCompilationDependencyList|Specifies details about the extensions on which the compiled extension has dependencies.<br /><br /> Note: If the value exceeds 8000 characters, one or two additional dimensions will be included in the trace to cover the complete dependency list. See About custom dimensions<telemetry-overview>.|\n|extensionCompilationResult|Specifies details about the error that occurred during compilation.|\n|extensionName|Specifies the name of the extension that failed to compile.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the compiled extension.|\n|failureReason|Specifies the error that occurred when compiling the extension.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension published successfully\nOccurs when an extension published successfully on the service.\n### General dimensions\nDimension|Description or value\nmessage|Extension published successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0014|\n|extensionIsRad|Specifies whether the extension was RAD published. True indicates the extension was RAD published. False indicates normal publishing. <br /><br />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. See Work with Rapid Application Development<../developer/devenv-rad-publishing>.|\n|extensionName|Specifies the name of the extension that was published.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the published extension.|\n|result|Success|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension failed to publish\nOccurs when an extension failed to publish on the service.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to publish: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0015|\n|extensionIsRad|Specifies whether the extension was RAD published. True indicates the extension was RAD published. False indicates normal publishing. <br /><br />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. See Work with Rapid Application Development<../developer/devenv-rad-publishing>.|\n|extensionName|Specifies the name of the extension that published.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the published extension.|\n|failureReason|Specifies the error that occurred when publishing.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension unpublished successfully\nOccurs when an extension was unpublished successfully on the service.\n### General dimensions\nDimension|Description or value\nmessage|Extension un-published successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0018|\n|extensionName|Specifies the name of the extension that was unpublished.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the unpublished extension.|\n|result|Success|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension failed to un-publish\nOccurs when an extension fails to unpublish on the service.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to un-publish: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0019|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that failed to unpublish.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the unpublished extension.|\n|failureReason|Specifies the error that occurred when unpublishing.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Tenant traces\nThe traces in this section are recorded for synchronizing, installing and updating extensions on a tenant.\n Synchronizing extensions\n   For on-premises, data for this operation is recorded when an extension is synchronized by using the Sync-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp>.\n   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<tenant-admin-center-manage-apps> in the Business Central administration center.\n Installing and uninstalling extensions\n   For on-premises, data for these operations is recorded when an extension is installed or uninstalled by using the Install-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/install-navapp> or Uninstall-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/uninstall-navapp>. Or, when an extension is installed or uninstalled from the Extension Management page in the client.\n   For online, data for these operations is recorded when an extension is installed or uninstalled from the Extension Management page in the client.\n Updating an extension\n   For on-premises, data for this operation is recorded when an extension is upgraded by using the Start-NAVAppDataUpgrade cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/start-navappdataupgrade>.\n   For online, data is recorded when an extension is updated from the Manage Apps page<tenant-admin-center-manage-apps> in the Business Central administration center.\n## Extension synchronized successfully\nOccurs when an extension synchronizes successfully on the tenant.\n### General dimensions\nDimension|Description or value\nmessage|Extension synchronized successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0012|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that was synchronized.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionSynchronizationMode|Specifies 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> See Sync-NAVApp cmdlet -Mode<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp>.|\n|extensionVersion|Specifies the version of the extension that was synchronized.|\n|result|Success|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension failed to synchronize\nOccurs when an extension fails to synchronize on the tenant.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to synchronize: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0013|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that failed to synchronize.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionSynchronizationMode|Specifies 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> See Sync-NAVApp cmdlet -Mode<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp>.|\n|extensionVersion|Specifies the version of the extension was synchronized.|\n|failureReason|Specifies the error that occurred when synchronizing the extension.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension is already synchronized\nOccurs when an extension was already synchronized on the tenant. Added in version 21.1.\n### General dimensions\nDimension|Description or value\nmessage|Extension is already synchronized: {extensionName}\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0056|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that failed to synchronize.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionSynchronizationMode|Specifies 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> See Sync-NAVApp cmdlet -Mode<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/sync-navapp>.|\n|extensionVersion|Specifies the version of the extension was synchronized.|\n|failureReason|Specifies the error that occurred when synchronizing the extension.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension installed successfully\nOccurs when an extension installs successfully on a tenant.\n### General dimensions\nDimension|Description or value\nmessage|Extension installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0010|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that was installed.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the extension that was installed.|\n|extensionAvailability|Specifies 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>|\n|extensionPreviewKeyProvided|Specifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.|\n|result|Success|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Dependent extension installed successfully\nOccurs 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.\n### General dimensions\nDimension|Description or value\nmessage|Dependent extension installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0026|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that was installed.|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionVersion|Specifies the version of the extension that was installed.|\n|parentExtensionId|Specifies the ID of the other extension that required the installation this extension.|\n|See common custom dimensions<#other>||\n## Extension failed to install\nOccurs when an extension failed to install on a tenant.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to install: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0011|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that failed to install.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the extension that was installed.|\n|failureReason|Specifies the error that occurred when the extension was installed.|\n|extensionAvailability|Specifies 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>|\n|extensionPreviewKeyProvided|Specifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension un-installed successfully\nOccurs when an extension is successfully uninstalled from a tenant.\n### General dimensions\nDimension|Description or value\nmessage|Extension un-installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0016|\n|doNotSaveData|Specifies 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.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that was uninstalled.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the extension that was uninstalled.|\n|result|Success|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Dependent extension un-installed successfully\nOccurs 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.\n### General dimensions\nDimension|Description or value\nmessage|Dependent extension un-installed successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0027|\n|doNotSaveData|Specifies 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.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the dependent extension that was uninstalled.|\n|extensionPublisher|Specifies the dependent extension's publisher.|\n|extensionVersion|Specifies the version of the dependent extension that was uninstalled.|\n|parentExtensionId|Specifies the ID of the extension that the uninstalled extension is dependent on.|\n|See common custom dimensions<#other>||\n## Extension failed to un-install\nOccurs when an extension failed to uninstall on a tenant.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to un-install: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|eventId|LC0017|\n|doNotSaveData|Specifies 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.|\n|environmentName|Specifies the name of the tenant environment. See Managing environments<tenant-admin-center-environments>.|\n|environmentType|Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See tenant-admin-center-environments#types-of-environments.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that failed to uninstall.|\n|extensionPublishedAs|Specifies 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>|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionScope|Specifies 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>|\n|extensionVersion|Specifies the version of the extension that failed to uninstall.|\n|failureReason|Specifies the error that occurred when the extension was uninstalled.|\n|result|Failure|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension updated successfully\nOccurs when an extension updates successfully on the service.\n> NOTE\n> Data is also recorded for any upgrade code that was run. See Analyzing extension update trace telemetry<telemetry-extension-update-trace>.\n### General dimensions\nDimension|Description or value\nmessage|Extension updated successfully: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|environmentName|Specifies the name of the tenant environment. See Managing environments<tenant-admin-center-environments>.|\n|environmentType|Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See tenant-admin-center-environments#types-of-environments.|\n|eventId|LC0022|\n|extensionCulture|Specifies 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.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that was being upgraded.|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionVersion|Specifies the new version of the extension being upgraded.|\n|extensionVersionFrom|Specifies the old version of the extension being upgraded.|\n|extensionAvailability|Specifies 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>|\n|extensionPreviewKeyProvided|Specifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.|\n|result|Success|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Extension failed to update\nOccurs when an extension failed to update on the service.\n> NOTE\n> Data is also recorded for any upgrade code that was run. See Analyzing extension update trace telemetry<telemetry-extension-update-trace>.\n### General dimensions\nDimension|Description or value\nmessage|Extension failed to update: {extensionName} version {extensionVersion} by {extensionPublisher} ({extensionId})\nseverityLevel|3\n### Custom dimensions\n|Dimension|Description or value|\n|environmentName|Specifies the name of the tenant environment. See Managing environments<tenant-admin-center-environments>.|\n|environmentType|Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See tenant-admin-center-environments#types-of-environments.|\n|eventId|LC0023|\n|extensionCulture|Specifies 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.|\n|extensionId|Specifies the ID of the extension/app.|\n|extensionName|Specifies the name of the extension that was being upgraded.|\n|extensionPublisher|Specifies the extension's publisher.|\n|extensionVersion|Specifies the new version of the extension being upgraded.|\n|extensionVersionFrom|Specifies the old version of the extension being upgraded.|\n|failureReason|Specifies the error that occurred during upgrade.|\n|result|Failure|\n|extensionAvailability|Specifies 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>|\n|extensionPreviewKeyProvided|Specifies whether a preview key was specified when installing the extension. A preview key is required to install preview versions.|\n|serverExecutionTime|Specifies the amount of time it took the server to complete the request. The time has the format hh:mm:ss.sssssss.|\n|sqlExecutes|Specifies the number of SQL statements that the request executed.|\n|sqlRowsRead|Specifies the number of table rows that were read by the SQL statements.|\n|totalTime|Specifies the amount of time it took to process the request. The time has the format hh:mm:ss.sssssss.|\n|See common custom dimensions<#other>||\n## Control plane traces\n> APPLIES TO: Business Central online\nThe 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:\n The extension is explicitly installed or updated\n The extension is installed or updated because an extension that's dependent on it was installed or updated.\n A hotfix is applied to the extension by Microsoft or ISV embed partner.\nThe 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.\nExtension install lifecycle|Extension update lifecycle|Trace source\nEnvironment app version install scheduled|Environment app version update scheduled|Control plane\nEnvironment app version install started|Environment app version update started|Control plane\nEnvironment app version install/update requires dependency app|Environment app version install/update requires dependency app|Control plane\nExtension synchronized: version|Extension synchronized: version|Tenant\nExtension installed: version|Extension updated: version|Tenant\nEnvironment app version installed|Environment app version updated|Control plane\n## Environment app version installation scheduled for environment\nOccurs when scheduling the installation of a new extension/app has completed successfully.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName}, version {extensionDestinationVersion} installation scheduled for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0161\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app version installation scheduling failed for environment\nOccurs when scheduling the installation of a new extension/app has failed.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName}, version {extensionDestinationVersion} installation scheduling failed for environment: {environmentName}\nseverityLevel|3\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0162\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nfailureReason|Specifies the reason for the failure. Use this for troubleshooting.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app version installation started for environment\nOccurs when installing a new extension/app has started.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName}, version {extensionDestinationVersion} installation started for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0163\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app version installation succeeded for environment\nOccurs when installing a new extension/app has completed successfully.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName}, version {extensionVersion} installation succeeded for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\n|Dimension|Description or value|\n|allowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated|\n|allowPreviewVersion|A boolean that specifies whether preview versions are allowed.|\n|applicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.|\n|countryCode|Specifies the localization for the environment, such as US or DK.|\n|environmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.|\n|environmentType|Specifies the version of the tenant environment.|\n|environmentVersion|Specifies the version of the tenant environment.|\n|eventId|LC0164|\n|extensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S|\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|extensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.|\n|runAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.|\n||\n|totalTime|Specifies the total time the operation ran for.|\n|useEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.|\n|See common custom dimensions<#other>|-|\n## Environment app version installation failed for environment\nOccurs when installing a new extension/app has failed.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName}, version {extensionDestinationVersion} installation failed for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependentsUninstall|A boolean that specifies whether dependent extensions will be uninstalled.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0165\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nextensionSourceVersion|Specifies the current version of the extension/app.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app version installation/update requires automatically installing a new dependency app for environment\nOccurs when the extension/app that's being installed or updated has a dependency on another extension/app that must be installed first.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName}, version {extensionDestinationVersion} installation/update requires automatically installing a new dependency app {dependencyExtensionName}, version {dependencyExtensionDestinationVersion} for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\ndependencyExtensionDestinationVersion|Specifies the version of the dependency extension.\ndependencyExtensionId|Specifies the ID of the dependency extension/app.\ndependencyExtensionName|Specifies the name of the dependency extension/app.\ndependencyExtensionPublisher|Specifies the publisher of the dependency extension/app.\ndependencyExtensionScope|Specifies whether the dependency extension/app is published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0166\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app update to version scheduled for environment\nOccurs when scheduling the update of an existing extension/app to another version has succeeded.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName} update to version {extensionDestinationVersion} scheduled for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0167\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nextensionSourceVersion|Specifies the current version of the extension/app.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app update to version scheduling failed for environment\nOccurs when scheduling the update of an existing extension/app to another version has failed.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionId} update to version {extensionDestinationVersion} scheduling failed for environment: {environmentName}\nseverityLevel|3\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0168\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nextensionSourceVersion|Specifies the current version of the extension/app.\nfailureReason|Specifies the reason for the failure. Use this for troubleshooting.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app update to version started for environment\nOccurs when updating of an existing extension/app to another version has started.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionId} update to version {extensionDestinationVersion} started for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0169\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nextensionSourceVersion|Specifies the current version of the extension/app.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app update to version succeeded for environment\nOccurs when updating of an existing extension/app to another version has completed successfully.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionId} update to version {extensionDestinationVersion} succeeded for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0170\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nextensionSourceVersion|Specifies the current version of the extension/app.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\ntotalTime|Specifies the total time the operation ran for.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app update to version failed for environment\nOccurs when updating an existing extension/app to another version has failed.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionId} update to version {extensionDestinationVersion} failed for environment: {environmentName}\nseverityLevel|3\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0171\nextensionDestinationVersion|Specifies the version of the extension/app to be installed or updated to.S\nextensionId|Specifies the ID of the extension/app.\nextensionScope|Specifies whether the extension/app was published to one of the following scopes: <br />Global - the extension can be installed on all tenants connected the service instance. <br />Tenant - the extension can only be installed on the tenant to which it was published.\nextensionSourceVersion|Specifies the current version of the extension/app.\nfailureReason|Specifies the reason for the failure. Use this for troubleshooting.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\ntotalTime|Specifies the total time the operation ran for.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app uninstall scheduled for environment\nOccurs when scheduling the uninstallation of an extension/app has completed successfully.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionName} uninstall scheduled for environment: {environmentName}\nseverityLevel|1\n### Custom dimensions\nDimension|Description or value\nallowDependencyUpdate|A boolean that specifies whether dependent extensions will be updated\nallowPreviewVersion|A boolean that specifies whether preview versions are allowed.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0173\nextensionId|Specifies the ID of the extension/app.\nextensionName|Specifies the name of the extension/app.\nextensionPublisher|Specifies the publisher of the extension/app.\nextensionSourceVersion|Specifies the current version of the extension/app.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Environment app uninstall scheduling failed for environment\nOccurs when scheduling the uninstallation of an extension/app has failed.\n### General dimensions\nDimension|Description or value\nmessage|Environment app {extensionId} uninstall scheduling failed for environment: {environmentName}\nseverityLevel|3\n### Custom dimensions\nDimension|Description or value\nallowDependentsUninstall|A boolean that specifies whether dependent extensions will be uninstalled.\napplicationFamily|Specifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.\ncountryCode|Specifies the localization for the environment, such as US or DK.\ndeleteData|A boolean that specifies whether data will be deleted.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the version of the tenant environment.\nenvironmentVersion|Specifies the version of the tenant environment.\neventId|LC0174\nextensionId|Specifies the ID of the extension/app.\nfailureReason|Specifies the reason for the failure. Use this for troubleshooting.\nrunAfterDateUtc|Specifies the date and time (in UTC) after which the hotfix can be applied.\nuseEnvironmentUpdateWindow|A boolean value (true or false) that specifies whether to use the update window that's defined in the Business Central admin center.\nSee common custom dimensions<#other>|-\n## Related information\n../developer/devenv-upgrading-extensions\nMonitoring and Analyzing Telemetry<telemetry-overview>\nEnable Sending Telemetry to Application Insights<telemetry-enable-application-insights>"}