Analyzing Permission Error Trace Telemetry
APPLIES TO: Business Central 2022 release wave 1 and later
Note
Azure Active Directory is now Microsoft Entra ID. Learn more
When a user gets an error dialog about lack of permissions while working in Business Central, a telemetry signal is emitted. This signal can be logged in an Application Insights resource.
This telemetry data let's you identify and analyze permission problems that users may experience in Business Central.
Permission Error Shown
Occurs when a user gets a permissions-related error message in Business Central when they try to do an operation in the application.
General dimensions
| Dimension | Description or value |
|---|---|
| message | Permission error shown |
| 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 | RT0031 |
| aadTenantId | The Microsoft Entra tenant ID that's used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra authentication, this value is common. |
| alObjectId | If there's no value or the value is 0, then the permission error wasn't related to a specific object, which typically happens when permissionArea is something other than Object. |
| alObjectType | The type of the AL object that the user was trying to access, like a table or page. |
| clientType | 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. |
| companyName | The display name of the Business Central company that was used at time of execution |
| component | Dynamics 365 Business Central Server |
| componentVersion | The version number of the component that emits telemetry (see the component dimension) |
| environmentName | The name of the tenant environment. See Managing Environments. This dimension isn't included for Business Central on-premises environments. |
| environmentType | The environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types |
| permissionArea | The area that the permission error is related to. Possible values include: System, Entitlement, Company, Object. |
| permissionType | The permission that the operation requires, but the user lacks. Possible values: Delete, Execute, Insert, Modify, Read, Undefined |
| telemetrySchemaVersion | The version of the Business Central telemetry schema. |
See also
Upgrading Extensions
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights