Analyzing cloud migration trace telemetry

INTRODUCED IN: Business Central 2023 release wave 1, version 22.1

Cloud migration telemetry gathers data about the success or failure of the following operations:

  • Replication runs
  • Cloud migration setup
  • Data upgrade

Use failure details, where provided, to investigate unsuccessful operations.

Replication run started

Occurs when a replication run starts.

General dimensions

DimensionDescription or value
messageReplication run started.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000K0J
alCategoryCloudMigration.
alReplicationTypeThe type of replication run: Data Replication, Azure Data Lake, or Diagnostic.
alSourceProductThe product ID configured for cloud migration.

Replication run completed

Occurs when a replication run completes, including when tables have failed. If tables have failed, the AL0000K0I event is also emitted.

General dimensions

DimensionDescription or value
messageReplication run completed.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000K0H
alCategoryCloudMigration.
alReplicationTypeThe type of replication run: Data Replication, Azure Data Lake, or Diagnostic.
alSourceProductThe product ID configured for cloud migration, if the setup record is available.

Replication run completed with failed tables

Occurs when a replication run completes with failed tables.

General dimensions

DimensionDescription or value
messageReplication run completed with failed tables.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000K0I
alCategoryCloudMigration.
alReplicationTypeThe type of replication run: Data Replication, Azure Data Lake, or Diagnostic.
alSourceProductThe product ID configured for cloud migration, if the setup record is available.
alHasFailurestrue. Indicates that the replication run has failed tables.
alNumberOfFailedTablesThe number of tables that failed in the replication run.
alDetailsAdditional details from the replication run summary.

Companion table repair scheduled

Occurs when a companion table repair is scheduled.

General dimensions

DimensionDescription or value
messageCompanion table repair scheduled.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000FXC
alCategoryCloudMigration. Use this dimension to distinguish the cloud migration event from other events with the same ID.

Companion table repair started

Occurs when a companion table repair is started.

General dimensions

DimensionDescription or value
messageCompanion table repair started.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000FJ1
alCategoryCloudMigration.

Companion table repair completed successfully

Occurs when a companion table repair has succeeded.

General dimensions

DimensionDescription or value
messageCompanion table repair completed successfully.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000FJ4
alCategoryCloudMigration.

Cloud migration data upgrade scheduled

Occurs when a data upgrade has been scheduled.

General dimensions

DimensionDescription or value
messageCloud Migration data upgrade scheduled.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000K0K
alCategoryCloudMigration.
alSourceProductThe product ID configured for cloud migration, if the setup record is available.

Environment data upgrade operation started

Occurs when a data upgrade operation on an environment is started.

General dimensions

DimensionDescription or value
messageEnvironment data upgrade operation started: {environmentName}

Custom dimensions

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.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0175

Environment data upgrade operation completed successfully

Occurs when a data upgrade operation on an environment has completed successfully.

General dimensions

DimensionDescription or value
messageEnvironment data upgrade operation completed successfully: {environmentName}

Custom dimensions

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.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0176
totalTimeSpecifies the total time the operation ran for.

Environment data upgrade operation failed

Occurs when a data upgrade operation on an environment has failed.

General dimensions

DimensionDescription or value
messageEnvironment data upgrade operation failed: {environmentName}

Custom dimensions

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.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0177
failureReasonSpecifies the reason for the failure. Use this for troubleshooting.
totalTimeSpecifies the total time the operation ran for.

Recovery from a failed data upgrade operation has completed successfully

Occurs when a recovery operation that's run after a failed data upgrade operation has completed successfully.

General dimensions

DimensionDescription or value
messageRecovery from a failed data upgrade operation has completed successfully: {environmentName}

Custom dimensions

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.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0178
totalTimeSpecifies the total time the operation ran for.

Recovery from a failed data upgrade operation has failed

Occurs when a recovery operation that's run after a failed data upgrade operation has also failed.

General dimensions

DimensionDescription or value
messageRecovery from a failed data upgrade operation has failed: {environmentName}

Custom dimensions

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.
applicationFamilySpecifies the application family for the environment, such as BusinessCentral. For environments in the ISV embed program, other values might show up here.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
environmentVersionSpecifies the version of the tenant environment.
eventIdLC0179
failureReasonSpecifies the reason for the failure. Use this for troubleshooting.
totalTimeSpecifies the total time the operation ran for.

Cloud migration disabled

Occurs when cloud migration is disabled for the environment.

General dimensions

DimensionDescription or value
messageCloud migration has been disabled.
severityLevel1

Custom dimensions

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
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdAL0000IGC
alCategoryCloudMigration.
alDisabledReasonThe reason recorded in the cloud migration setup: Abandoned, Completed, Paused, or an empty value if no reason is available.
alDisabledReasonDescriptionThe reason text supplied when cloud migration is disabled.
alSourceProductThe product ID configured for cloud migration, if the setup record is available.

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights