Analyzing Configuration Package Telemetry

APPLIES TO: Business Central 2020 release wave 2, version 17.2, and later

Configuration package telemetry gathers data about the following operations on configuration packages:

  • Export
  • Import
  • Apply
  • Delete

For information about working with configuration packages, see Prepare a Configuration Package in the Business Central Application Help.

Common custom dimensions

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

Dimension Description or value
aadTenantId Specifies the Azure Active Directory (Azure AD) tenant ID used for Azure AD authentication. For on-premises, if you aren't using Azure AD authentication, this value is common.
alCategory RapidStart
alDataClassification SystemMetadata
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. Added in version 20.0.
companyName The name of the company where the operation is applied. Added in version 20.0.
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.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.

Configuration package export started

Occurs when an export operation on a configuration package is started.

General dimensions

Dimension Description or value
message Configuration package export started: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3F
alExecutionId Specifies the ID of the export operation.
alPackageCode Specifies the ID of the configuration package being exported.

Configuration package exported successfully

Occurs when an export operation on a configuration package completes successfully.

General dimensions

Dimension Description or value
message Configuration package exported successfully: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3G
alExecutionId Specifies the ID of the export operation.
alExecutionTimeInMs Specifies the number of milliseconds it took to complete the export operation.
alPackageCode Specifies the ID of the configuration package that was exported.
See common custom dimensions

Configuration package import started

Occurs when an import operation on a configuration package is started.

General dimensions

Dimension Description or value
message Configuration package import started: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3H
alExecutionId Specifies the ID of the import operation.
alPackageCode Specifies the ID of the configuration package being imported.
See common custom dimensions

Configuration package imported successfully

Occurs when an import operation on a configuration package completes successfully.

General dimensions

Dimension Description or value
message Configuration package imported successfully: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3I
alExecutionTimeInMs Specifies the number of milliseconds it took to complete the import operation.
alExecutionId Specifies the ID of the import operation.
alPackageCode Specifies the ID of the configuration package that was imported.
See common custom dimensions

Configuration package apply started

Occurs when an apply operation on a configuration package is started.

General dimensions

Dimension Description or value
message Configuration package apply started: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3N
alExecutionId Specifies the ID of the apply operation.
alPackageCode Specifies the ID of the configuration package being applied.
See common custom dimensions

Configuration package applied successfully

Occurs when an apply operation on a configuration package completes successfully.

General dimensions

Dimension Description or value
message Configuration package applied successfully: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3O
alExecutionId Specifies the ID of the apply operation.
alExecutionTimeInMs Specifies the number of milliseconds it took to complete the apply operation.
alErrorCount Specifies the number of errors that occurred when applying the configuration package.
alFieldCount Specifies the number of fields that were included in the migration table of the applied configuration package.
alPackageCode Specifies the ID of the configuration package that was applied.
alRecordCount Specifies the number of records that were included in the applied configuration package.
See common custom dimensions

Configuration package deleted successfully

Occurs when a configuration package is deleted successfully.

General dimensions

Dimension Description or value
message Configuration package deleted successfully: {alPackageCode}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E3P
alPackageCode Specifies the ID of the configuration package that was deleted.
See common custom dimensions

See also

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Prepare a Configuration Package in the Business Central