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 Microsoft Entra tenant ID used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra 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 |
| 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 |
| eventId |
AL0000E3F |
| alExecutionId |
Specifies the ID of the export operation. |
| alPackageCode |
Specifies the Code 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 |
| 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 |
| 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 Code 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| eventId |
AL0000E3N |
| alExecutionId |
Specifies the ID of the apply operation. |
| alPackageCode |
Specifies the Code 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 |
| 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 |
| 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 Code 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 |
| 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 |
| eventId |
AL0000E3P |
| alPackageCode |
Specifies the Code of the configuration package that was deleted. |
| See common custom dimensions |
|
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Prepare a Configuration Package in the Business Central