Analyzing company lifecycle trace telemetry

INTRODUCED IN: Business Central 2020 release wave 1, version 16.1

Company lifecycle telemetry gathers data about the success or failure of the following company-related operations:

  • creating a company
  • copying a company
  • deleting a company

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

Company created

Occurs when the company has been successfully created.

General dimensions

DimensionDescription or value
messageCompany created: {companyName}

{companyName} indicates the name of the new company.
severityLevel1
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSpecifies the display name of the Business Central company.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeysSpecifies 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.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing environments.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0001
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to create the company. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time it took to create the company. The time has the format hh:mm:ss.sssssss.

Company creation canceled

Occurs when creating a company was canceled.

General dimensions

DimensionDescription or value
messageCompany creation canceled: {companyName}

{companyName} indicates the name of the company being created.
severityLevel2
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSpecifies the display name of the Business Central company.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeysSpecifies 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.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0002
cancelReasonSpecifies why the operation was canceled.
cancelReasonMessageSpecifies the exception message for the cancellation.
resultCanceled
serverExecutionTimeSpecifies the amount of time it took the server to create the company before being canceled. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed by the operation.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time used to create the company before being canceled. The time has the format hh:mm:ss.sssssss.

Company creation failed

Occurs when a company failed to be created.

General dimensions

DimensionDescription or value
messageCompany creation failed: {companyName}

{companyName} indicates the name of the company being created.
severityLevel3
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSpecifies the display name of the Business Central company.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeysSpecifies 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.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0003
failureReasonSpecifies the exception that indicates the cause of the failure.
resultFailure
serverExecutionTimeSpecifies the amount of time it took the server to create the company before it failed. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed by the operation.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time used to create the company before it failed. The time has the format hh:mm:ss.sssssss.

Company copied

Occurs when a company has been copied from another company successfully.

General dimensions

DimensionDescription or value
messageCompany copied: {companyNameSource} to {companyNameDestination}<ul><li>{companyNameSource} is the name of the company that was copied.</li><li>{companyNameDestination} is the name of the new company that was created.</li></ul>
severityLevel1
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameDestinationSpecifies the name of the new company.
companyNameSourceSpecifies the name of the Business Central company.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeysSpecifies 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.
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0004
resultSuccess
serverExecutionTimeSpecifies the amount of time it took the server to copy the company. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed by the operation.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time it took to copy the company. The time has the format hh:mm:ss.sssssss.

Company copy canceled

Occurs when copying a company was canceled.

General dimensions

DimensionDescription or value
messageCompany copy canceled: {companyNameSource} to {companyNameDestination}<ul><li>{companyNameSource} is the name of the company that was being copied.</li><li>{companyNameDestination} is the name of the new company that was being created.</li></ul>
severityLevel2
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSourceSpecifies the name of the company that was being copied.
companyNameDestinationSpecifies the name of the new company that was being created.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0005
cancelReasonSpecifies why the operation was canceled.
cancelReasonMessageSpecifies the exception message for the cancellation.
resultCanceled
serverExecutionTimeSpecifies the amount of time it took the server to copy the company. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time used to do the operation. The time has the format hh:mm:ss.sssssss.

Company copy failed

Occurs when a company failed to be copied from another company.

General dimensions

DimensionDescription or value
messageCompany copy failed: {companyNameSource} to {companyNameDestination}<ul><li>{companyNameSource} is the name of the company that was being copied.</li><li>{companyNameDestination} is the name of the new company that was being created.</li></ul>
severityLevel3
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSourceSpecifies the name of the company that was being copied.
companyNameDestinationSpecifies the name of the new company that was being created.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0006
failureReasonSpecifies the exception that indicates the cause of the failure.
resultFailure
serverExecutionTimeSpecifies the amount of time on the server. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time used to create the company before it failed. The time has the format hh:mm:ss.sssssss.

Company deleted

Occurs when a company has been deleted successfully.

General dimensions

DimensionDescription or value
messageCompany deleted: {companyName}

{companyName} indicates the name of the company that was deleted.
severityLevel1
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSpecifies the display name of the Business Central company.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0007
resultSuccess
serverExecutionTimeSpecifies the amount of time it took on the server. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that the operation executed.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time it took to delete the company. The time has the format hh:mm:ss.sssssss.

Company deletion canceled

Occurs when deleting a company was canceled.

General dimensions

DimensionDescription or value
messageCompany deletion canceled: {companyName}

{companyName} indicates the name of the company that was being deleted.
severityLevel2
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSpecifies the display name of the Business Central company.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0008
cancelReasonSpecifies why the operation was canceled.
cancelReasonMessageSpecifies the exception message for the cancellation.
resultCanceled
serverExecutionTimeSpecifies the amount of time it took on the server. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed by the operation.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time used to delete the company before being canceled. The time has the format hh:mm:ss.sssssss.

Company deletion failed

Occurs when a company failed to be deleted.

General dimensions

DimensionDescription or value
messageCompany deletion failed: {companyName}

{companyName} indicates the name of the company that was being deleted.
severityLevel3
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

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.
clientTypeSpecifies the type of client that performed the operation, such as Background or Web. Learn more in ClientType option type.
companyNameSpecifies the display name of the Business Central company.
componentDynamics 365 Business Central Server.
componentVersionSpecifies the version number of the component that emits telemetry (see the component dimension.)
environmentTypeSpecifies the environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
eventIdLC0009
failureReasonSpecifies the exception that caused the failure.
resultFailure
serverExecutionTimeSpecifies the amount of time it took on the server. The time has the format hh:mm:ss.sssssss.
sqlExecutesSpecifies the number of SQL statements that were executed by the operation.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
totalTimeSpecifies the amount of time used to delete the company before it failed. The time has the format hh:mm:ss.sssssss.

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights