Analyzing permission dependency cycle trace telemetry

APPLIES TO: Business Central 2022 release wave 1 and later

A permission dependency cycle occurs when a permission set depends on itself, which can happen when you build permission sets that include other permission sets. For example, suppose you create a permission set Y that includes permission set X. If you then try to modify permission set X to include permission set Y, you create a dependency cycle. When you create a permission dependency cycle in the Business Central client, you get an error similar to the following message:

The permission set [XX] has a circular reference on path [XX]->[YY]->[XX].

This telemetry data lets you identify and analyze permission problems that users might experience in Business Central.

Dependency cycle discovered in permission sets

Occurs when a permission set dependency cycle is logged while permission sets are expanded or validated.

General dimensions

DimensionDescription or value
messageDependency cycle discovered in permission sets.
severityLevel3

Custom dimensions

DimensionDescription or value
eventIdRT0032
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.
alObjectIdSpecifies the ID of the AL object in the current execution context. This value doesn't identify a permission set in the cycle.
alObjectNameSpecifies the name of the AL object in the current execution context.
alObjectTypeSpecifies the type of the AL object in the current execution context.
alStackTraceThe stack trace in AL.
clientTypeSpecifies the type of client that opened the session, such as Background or Web. For a list of the client types, see ClientType Option Type.
companyNameThe current company name.
componentDynamics 365 Business Central Server
componentVersionThe version number of the component that emits telemetry (see the component dimension)
environmentNameThe name of the tenant environment. This dimension isn't included for Business Central on-premises environments. Learn more in Managing environments.
environmentTypeThe environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
permissionSetCycleThe dependency path of the permission sets in the cycle. Long paths are truncated in the middle to retain the start and end of the cycle.
telemetrySchemaVersionThe version of the Business Central telemetry schema.

Composing Permission Sets
Upgrading Extensions
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights