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.
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.
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.
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.
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.
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.
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.
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.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.