Analyzing company lifecycle trace telemetry

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

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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

Dimension Description or value
message Company created: {companyName}

{companyName} indicates the name of the new company.
severityLevel 1
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys Specifies a comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
environmentName Specifies the name of the tenant environment. See Managing Environments.
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0001
result Success
serverExecutionTime Specifies the amount of time it took the server to create the company. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that were executed.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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

Dimension Description or value
message Company creation canceled: {companyName}

{companyName} indicates the name of the company being created.
severityLevel 2
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys Specifies a comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0002
failureReason Operation was canceled
result Failure
serverExecutionTime Specifies the amount of time it took the server create the company before being canceled. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that were executed by the operation.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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

Dimension Description or value
message Company creation failed: {companyName}

{companyName} indicates the name of the company being created.
severityLevel 1
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys Specifies a comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0003
failureReason Specifies the exception that indicates the cause of the failure.
result Failure
serverExecutionTime Specifies the amount of time it took the server create the company before it failed. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that were executed by the operation.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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

Dimension Description or value
message Company copied: {companyNameSource} to {companyNameDestination}
  • {companyNameSource} is name of the company that was copied.
  • {companyNameDestination}is the name of new company that was created.
severityLevel 2
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyNameDestination Specifies the name of the new company.
companyNameSource Specifies the name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys Specifies a comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0004
result Success
serverExecutionTime Specifies the amount of time it took the server to copy the company. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that were executed by the operation.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies the amount of time it took to copy the company. The time has the format hh:mm:ss.sssssss.

Company copy canceled

Occurs when a copying a company was canceled.

General dimensions

Dimension Description or value
message Company copied canceled: {source company name} to {destination company name}
  • {companyNameSource} is name of the company that was being copied.
  • {companyNameDestination}is the name of new company that was being created.
severityLevel 2
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed operation, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0005
failureReason Operation was canceled.
result Failure
serverExecutionTime Specifies the amount of time it took the server to copy the company. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that were executed.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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

Dimension Description or value
message Company copy failed: {companyNameSource} to {companyNameDestination}
  • {companyNameSource} is name of the company that was being copied.
  • {companyNameDestination}is the name of new company that was being created.
severityLevel 3
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0006
failureReason Specifies the exception that indicates the cause of the failure.
result Failure
serverExecutionTime Specifies the amount of time on the server. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that were executed.
sqlRowsRead Specifies the number of table rows that by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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

Dimension Description or value
message Company deleted: {companyName}

{companyName} indicates the name of the company that was deleted.
severityLevel 1
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0007
result Success
serverExecutionTime Specifies the amount of time it took on server. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that the operation executed.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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 failed was canceled.

General dimensions

Dimension Description or value
message Company deletion canceled: {companyName}

{companyName} indicates the name of the company that was being deleted.
severityLevel 2
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0008
failureReason Operation was canceled
result Failure
serverExecutionTime Specifies the amount of time it took on server. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that executed by the operation.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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

Dimension Description or value
message Company deletion failed: {companyName}

{companyName} indicates the name of the company that was being deleted.
severityLevel 3
user_Id The 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

Dimension Description or value
aadTenantId 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.
clientType Specifies the type of client that executed the SQL Statement, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyName Specifies the display name of the Business Central company.
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId LC0009
failureReason Specifies the exception that caused the failure.
result Failed
serverExecutionTime Specifies the amount of time it took on server. The time has the format hh:mm:ss.sssssss.
sqlExecutes Specifies the number of SQL statements that executed by the operation.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
totalTime Specifies 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