Analyzing profile configuration lifecycle telemetry

APPLIES TO: Business Central 2022 release wave 2, version 21.0, and later

From the Business Central Web client, users can do various operations on profiles, like import/export, create, copy, and remove. Learn more in Manage user profiles and Customize pages for profiles.

Business Central emits telemetry signals for these operations, which you can collect using an Application Insights resource. As a partner or consultant, this information gives you insight into what the service does with the profiles and page customizations you provide.

Common custom dimensions

The following table explains custom dimensions that are common to all profile configuration 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.
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. Learn more in Environment types.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Profile import succeeded

Occurs when a profile was successfully imported from a file.

General dimensions

DimensionDescription or value
messageProfile import succeeded: {profileId} in app/extension {profileAppId}
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0046
diagnosticsList of diagnostics (severity and message) from compiler and designer.
profileAppIdSpecifies the ID of the extension that included the profile. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was targeted by the operation.
sqlExecutesSpecifies the number of SQL statements that executed by the operation.
serverExecutionTimeSpecifies the amount of time the operation took on server. The time has the format hh:mm:ss.sssssss.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements during the operation.
resultSuccess
totalTimeSpecifies the total time the operation ran for.

Profile import failed

Occurs when a profile failed to be imported from a file.

General dimensions

DimensionDescription or value
messageProfile import failed: {ProfileId} in app/extension {ProfileAppId}
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0047
diagnosticsList of diagnostics (severity and message) from compiler and designer.
failureReasonSpecifies why the import operation failed.
profileAppIdSpecifies the ID of the extension that included the profile. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was targeted by the operation.
See common custom dimensions

Profile export succeeded

Occurs when a profile was successfully exported to a file.

General dimensions

DimensionDescription or value
messageProfiles exported successfully
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0048
diagnosticsList of diagnostics (severity and message) from compiler and designer.
forceSpecifies whether the Force flag was set, allowing profiles to be exported even with compilation errors.
profileCountSpecifies the number of profiles that were exported.
sqlExecutesSpecifies the number of SQL statements that executed by the operation.
serverExecutionTimeSpecifies the amount of time the operation took on server. The time has the format hh:mm:ss.sssssss.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements during the operation.
resultSuccess
totalTimeSpecifies the total time the operation ran for.
See common custom dimensions

Profiles export failed

Occurs when a profile failed to be exported to a file.

General dimensions

DimensionDescription or value
messageProfiles failed to be exported
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0049
diagnosticsList of diagnostics (severity and message) from compiler and designer.
failureReasonSpecifies why the export operation failed.
forceSpecifies whether the Force flag was set, allowing profiles to be exported even with compilation errors.
See common custom dimensions

Profile copy succeeded

Occurs when a profile was copied successfully.

General dimensions

DimensionDescription or value
messageProfile copy succeeded: {profileId} to {newProfileId} from app/extension {profileAppId} to app/extension {newProfileAppId}
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0050
diagnosticsList of diagnostics (severity and message) from compiler and designer.
profileAppIdSpecifies the ID of the extension that included the profile that was copied. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was copied.
newProfileAppIdSpecifies the ID of the extension that included the new profile. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
newProfileIdSpecifies the ID of the new profile that was created from a copy.
sqlExecutesSpecifies the number of SQL statements that executed by the operation.
serverExecutionTimeSpecifies the amount of time the operation took on server. The time has the format hh:mm:ss.sssssss.
sqlRowsReadSpecifies the number of table rows that were read by the SQL statements during the operation.
resultSuccess
totalTimeSpecifies the total time the operation ran for.
See common custom dimensions

Profile copy failed

Occurs when a profile failed to copy successfully.

General dimensions

DimensionDescription or value
messageProfile copy failed: {ProfileId} to {NewProfileId} from app/extension {ProfileAppId} to app/extension {NewProfileAppId}
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdLC0051
diagnosticsList of diagnostics (severity and message) from compiler and designer.
failureReasonSpecifies why the copy operation failed.
profileAppIdSpecifies the ID of the extension that included the profile that was copied. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was copied.
newProfileAppIdSpecifies the ID of the extension that included the new profile. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
newProfileIdSpecifies the ID of the new profile that was created from a copy.
See common custom dimensions

Profile created successfully

Occurs when a new profile was created successfully.

General dimensions

DimensionDescription or value
messageProfile created successfully: {profileId} in app/extension {profileAppId}
severityLevel1

Custom dimensions

DimensionDescription or value
eventIdLC0052
profileAppIdSpecifies the ID of the extension that includes the new profile. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was created.
See common custom dimensions

Profile removed

Occurs when a profile was deleted.

General dimensions

DimensionDescription or value
messageProfile removed: {profileId} in app/extension {profileAppId}
severityLevel2

Custom dimensions

DimensionDescription or value
eventIdLC0053
profileAppIdSpecifies the ID of the extension that included the profile that was removed. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was removed.
See common custom dimensions

Profile page customization removed

Occurs when a page customization was deleted from a profile.

General dimensions

DimensionDescription or value
messageProfile page customization removed: {profileId} in app/extension {profileAppId}
severityLevel2

Custom dimensions

DimensionDescription or value
eventIdLC0054
pageIdSpecifies the ID of the page object from which the customization was removed.
profileAppIdSpecifies the ID of the extension that included the profile page customization that was removed. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was targeted by the operation.
See common custom dimensions

Profile page customization converted

Occurs when a page customization was converted successfully.

General dimensions

DimensionDescription or value
messageProfile page customization converted: {ProfileId} in app/extension {ProfileAppId}
severityLevel2

Custom dimensions

DimensionDescription or value
eventIdLC0055
pageIdSpecifies the ID of the page object for which the customization was converted.
profileAppIdSpecifies the ID of the extension that included the profile page customization. An empty value or 00000000-0000-0000-0000-000000000000 indicates the profile was created from the Business Central web client or programmatically using AL code.
profileIdSpecifies the ID of the profile that was targeted by the operation.
operationReasonSpecifies the reason why the conversion was triggered.
See common custom dimensions

Next steps

Use this telemetry data to determine how the users are working with the profiles that you provide in extensions. Then, make changes to better suit the users' needs as you see fit.

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights