Analyzing profile configuration lifecycle telemetry

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

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

From the Business Central Web client, users can do various operations on profiles, like, import/export, create, copy, and remove. To learn more about these operations, see 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.

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

Profile import succeeded

Occurs when a profile was successfully imported from a file.

General dimensions

Dimension Description or value
message Profile import succeeded: {profileId} in app/extension {profileAppId}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId LC0046
diagnostics List of diagnostics (severity and message) from compiler and designer.
profileAppId Specifies 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.
profileId Specifies the ID of the profile that was targeted by the operation.
sqlExecutes Specifies the number of SQL statements that executed by the operation.
serverExecutionTime Specifies the amount of time the operation took on server. The time has the format hh:mm:ss.sssssss.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements during the operation.
result Success
totalTime Specifies the total time the operation ran for.

Profile import failed

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

General dimensions

Dimension Description or value
message Profile import failed: {ProfileId} in app/extension {ProfileAppId}
severityLevel 3

Custom dimensions

Dimension Description or value
eventId LC0047
diagnostics List of diagnostics (severity and message) from compiler and designer.
failureReason Specifies why the import operation failed.
profileAppId Specifies 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.
profileId Specifies 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

Dimension Description or value
message Profiles exported successfully
severityLevel 1

Custom dimensions

Dimension Description or value
eventId LC0048
diagnostics List of diagnostics (severity and message) from compiler and designer.
force Species whether the Force flag was set, allowing to export profiles even with compilation errors.
sqlExecutes Specifies the number of SQL statements that executed by the operation.
serverExecutionTime Specifies the amount of time the operation took on server. The time has the format hh:mm:ss.sssssss.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements during the operation.
result Success
totalTime Specifies 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

Dimension Description or value
message Profiles failed to be exported
severityLevel 3

Custom dimensions

Dimension Description or value
eventId LC0049
diagnostics List of diagnostics (severity and message) from compiler and designer.
failureReason Specifies why the export operation failed.
See common custom dimensions

Profile copy succeeded

Occurs when a profile was copied successfully.

General dimensions

Dimension Description or value
message Profile copy succeeded: {profileId} to {newProfileId} from app/extension {profileAppId} to app/extension {newProfileAppId}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId LC0050
diagnostics List of diagnostics (severity and message) from compiler and designer.
ProfileAppId Specifies 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.
ProfileId Specifies the ID of the profile that was copied.
newProfileAppId Specifies 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.
newProfileId Specifies the ID of the new profile that was created from a copy.
sqlExecutes Specifies the number of SQL statements that executed by the operation.
serverExecutionTime Specifies the amount of time the operation took on server. The time has the format hh:mm:ss.sssssss.
sqlRowsRead Specifies the number of table rows that were read by the SQL statements during the operation.
result Success
totalTime Specifies the total time the operation ran for.
See common custom dimensions

Profile copy failed

Occurs when a profile failed to copy successfully.

General dimensions

Dimension Description or value
message Profile copy failed: {ProfileId} to {NewProfileId} from app/extension {ProfileAppId} to app/extension {NewProfileAppId}
severityLevel 3

Custom dimensions

Dimension Description or value
eventId LC0051
diagnostics List of diagnostics (severity and message) from compiler and designer.
failureReason Specifies why the copy operation failed.
profileAppId Specifies 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.
profileId Specifies the ID of the profile that was copied.
newProfileAppId Specifies 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.
newProfileId Specifies 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

Dimension Description or value
message Profile created successfully: {profileId} in app/extension {profileAppId}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId LC0052
profileAppId Specifies 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.
profileId Specifies the ID of the profile that was created.
See common custom dimensions

Profile removed

Occurs when a profile was deleted.

General dimensions

Dimension Description or value
message Profile removed: {profileId} in app/extension {profileAppId}
severityLevel 2

Custom dimensions

Dimension Description or value
eventId LC0053
profileAppId Specifies 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.
profileId Specifies 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

Dimension Description or value
message Profile page customization removed: {profileId} in app/extension {profileAppId}
severityLevel 2

Custom dimensions

Dimension Description or value
eventId LC0054
pageId Specifies the ID of the page object from which the customization was removed.
profileAppId Specifies 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.
profileId Specifies 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

Dimension Description or value
message Profile page customization converted: {ProfileId} in app/extension {ProfileAppId}
severityLevel 2

Custom dimensions

Dimension Description or value
eventId LC0055
pageId Specifies the ID of the page object for which the customization was converted.
profileAppId Specifies 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.
profileId Specifies the ID of the profile that was targeted by the operation.
operationReason Specifies 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