Analyze 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.

These events come from AL application code. The application source uses the event ID without the AL prefix. For example, the source ID 0000E3N appears as AL0000E3N in Application Insights. Learn more in Find AL event IDs in the application source.

Common custom dimensions

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

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.
alCategoryRapidStart
alDataClassificationSystemMetadata
clientTypeSpecifies 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.
companyNameThe name of the company where the operation is applied. Added in version 20.0.
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. See Environment Types.
telemetrySchemaVersionSpecifies 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

DimensionDescription or value
messageConfiguration package export started: {packageSystemId}
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
eventIdAL0000E3F
alExecutionIdSpecifies the GUID that correlates the start and completion events for the export operation.
alPackageCodeSpecifies the system ID (GUID) of the configuration package being exported. The dimension name is retained for compatibility.
See common custom dimensions

Configuration package exported successfully

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

General dimensions

DimensionDescription or value
messageConfiguration package exported successfully: {packageSystemId}
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
eventIdAL0000E3G
alExecutionIdSpecifies the GUID that correlates the start and completion events for the export operation.
alExecutionTimeInMsSpecifies the number of milliseconds it took to complete the export operation.
alPackageCodeSpecifies the system ID (GUID) of the configuration package that was exported. The dimension name is retained for compatibility.
See common custom dimensions

Configuration package import started

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

General dimensions

DimensionDescription or value
messageConfiguration package import started: {packageSystemId}
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
eventIdAL0000E3H
alExecutionIdSpecifies the GUID that correlates the start and completion events for the import operation.
See common custom dimensions

Configuration package imported successfully

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

General dimensions

DimensionDescription or value
messageConfiguration package imported successfully: {packageSystemId}
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
eventIdAL0000E3I
alExecutionTimeInMsSpecifies the number of milliseconds it took to complete the import operation.
alExecutionIdSpecifies the GUID that correlates the start and completion events for the import operation.
alFileSizeInBytesSpecifies the approximate size of the imported XML content in bytes.
See common custom dimensions

Configuration package apply started

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

General dimensions

DimensionDescription or value
messageConfiguration package apply started: {packageSystemId}
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
eventIdAL0000E3N
alExecutionIdSpecifies the GUID that correlates the start and completion events for the apply operation.
alPackageCodeSpecifies the system ID (GUID) of the configuration package being applied. The dimension name is retained for compatibility.
See common custom dimensions

Configuration package applied successfully

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

General dimensions

DimensionDescription or value
messageConfiguration package applied successfully: {packageSystemId}
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
eventIdAL0000E3O
alExecutionIdSpecifies the GUID that correlates the start and completion events for the apply operation.
alExecutionTimeInMsSpecifies the number of milliseconds it took to complete the apply operation.
alErrorCountSpecifies the number of errors that occurred when applying the configuration package.
alFieldCountSpecifies the number of fields that were included in the migration table of the applied configuration package.
alPackageCodeSpecifies the system ID (GUID) of the configuration package that was applied. The dimension name is retained for compatibility.
alRecordCountSpecifies 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

DimensionDescription or value
messageConfiguration package deleted successfully: {packageSystemId}
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
eventIdAL0000E3P
alPackageCodeSpecifies the system ID (GUID) of the configuration package that was deleted. The dimension name is retained for compatibility.
See common custom dimensions

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