Analyzing report layout lifecycle telemetry
APPLIES TO: Business Central 2024 release wave 2 (v25) and later.
This article describes the telemetry gathered for actions taken by users on report layouts. Learn more about the actions users can take on report layouts at Get started with report layouts.
Report layout added by user
Occurs when a user adds a new report layout.
General dimensions
The following table explains the general dimensions of this trace.
| Dimension | Description or value |
|---|---|
| message | Report layout added by user |
| 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 |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alAction | New |
| alLayoutFormat | Specifies the layout file type. Possible values: RDLC (.rdlc file type), Word (.docx file type), Excel (.xlsx file type), Custom (custom file type, indicated as External in the client UI). |
| alLayoutName | Specifies the name of the report layout. |
| alReportId | Specifies the ID of the report assigned the layout. |
| companyName | The current company name. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000N0E |
Sample KQL code (report layout added)
This KQL code can help you get started analyzing which reports users run:
traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions has 'AL0000N0E' // performance optimization
| where customDimensions.eventId == 'AL0000N0E'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// for which report and layout
, reportId = customDimensions.alReportId // object ID of the report
, layoutName = customDimensions.alLayoutName
, layoutFormat = customDimensions.alLayoutFormat // possible values: RDLC, Word, Excel, Custom
// what did the user do
, action = customDimensions.alAction // alAction is "New" for this event
// user who performed the action
, user_Id // user telemetry ID
Report layout default changed by user
Occurs when a user changes the default layout used by a report.
General dimensions
The following table explains the general dimensions of this trace.
| Dimension | Description or value |
|---|---|
| message | Report layout default changed by user |
| 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 |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alAction | SetDefault |
| alLayoutFormat | Specifies the layout file type. Possible values: RDLC (.rdlc file type), Word (.docx file type), Excel (.xlsx file type), Custom (custom file type, indicated as External in the client UI). |
| alLayoutName | Specifies the name of the report layout. |
| alReportId | Specifies the ID of the report assigned the layout. |
| companyName | The current company name. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000N0D |
Sample KQL code (report layout default changed)
This KQL code can help you get started analyzing which reports users run:
traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions has 'AL0000N0D' // performance optimization
| where customDimensions.eventId == 'AL0000N0D'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// for which report and layout
, reportId = customDimensions.alReportId // object ID of the report
, newDefaultLayoutName = customDimensions.alLayoutName
// NB! alLayoutFormat shows as an integer in the telemetry in versions prior to 25.1
, layoutFormat = customDimensions.alLayoutFormat // possible values: RDLC, Word, Excel, Custom
// what did the user do
, action = customDimensions.alAction // alAction is "SetDefault" for this event
// user who performed the action
, user_Id // user telemetry ID
Report layout properties changed by user
Occurs when a user changes the properties of layout used by a report.
General dimensions
The following table explains the general dimensions of this trace.
| Dimension | Description or value |
|---|---|
| message | Report layout properties changed by user |
| 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 |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alAction | Edit |
| alOldLayoutDescription | Specifies the description of the layout before it was changed. |
| alOldLayoutName | Specifies the name of the layout before it was changed. |
| alNewLayoutDescription | Specifies the new description of the layout. |
| alNewLayoutName | Specifies the new name of the layout. |
| alReportId | Specifies the ID of the report assigned the layout. |
| companyName | The current company name. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000N0H |
Sample KQL code (report layout properties changed)
This KQL code can help you get started analyzing which reports users run:
traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions has 'AL0000N0H' // performance optimization
| where customDimensions.eventId == 'AL0000N0H'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// for which report
, reportId = customDimensions.alReportId // object ID of the report
// what did the user do
, action = customDimensions.alAction // alAction is "Edit" for this event
, oldLayoutDescription = customDimensions.alOldLayoutDescription
, oldLayoutName = customDimensions.alOldLayoutName
, newLayoutDescription = customDimensions.alNewLayoutDescription
, newLayoutName = customDimensions.alNewLayoutName
// user who performed the action
, user_Id // user telemetry ID
Report layout exported by user
Occurs when a user exports a layout used by a report.
General dimensions
The following table explains the general dimensions of this trace.
| Dimension | Description or value |
|---|---|
| message | Report layout exported by user |
| 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 |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alAction | Export |
| alLayoutName | Specifies the name of the report layout. |
| alReportId | Specifies the ID of the report assigned the layout. |
| companyName | The current company name. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000N0I |
Sample KQL code (report layout exported)
This KQL code can help you get started analyzing which reports users run:
//
traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions has 'AL0000N0I' // performance optimization
| where customDimensions.eventId == 'AL0000N0I'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// for which report and layout
, reportId = customDimensions.alReportId // object ID of the report
, layoutName = customDimensions.alLayoutName
// what did the user do
, action = customDimensions.alAction // alAction is "Export" for this event
// user who performed the action
, user_Id // user telemetry ID
Report layout deleted by user
Occurs when a user deletes a report layout.
General dimensions
The following table explains the general dimensions of this trace.
| Dimension | Description or value |
|---|---|
| message | Report layout exported by user |
| 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 |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alAction | Delete |
| alLayoutName | Specifies the name of the report layout. |
| alReportId | Specifies the ID of the report assigned the layout. |
| companyName | The current company name. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000N0F |
Sample KQL code (report layout deleted)
This KQL code can help you get started analyzing which reports users run:
traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions has 'AL0000N0F' // performance optimization
| where customDimensions.eventId == 'AL0000N0F'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// for which report and layout
, reportId = customDimensions.alReportId // object ID of the report
, layoutName = customDimensions.alLayoutName
// what did the user do
, action = customDimensions.alAction // alAction is "Delete" for this event
// user who performed the action
, user_Id // user telemetry ID
Report layout replaced by user
Occurs when a user replaces a report layout with another layout.
General dimensions
The following table explains the general dimensions of this trace.
| Dimension | Description or value |
|---|---|
| message | Report layout exported by user |
| 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 |
|---|---|
| aadTenantId |
Note Azure Active Directory is now Microsoft Entra ID. Learn more |
| alAction | Replace |
| alLayoutName | Specifies the name of the report layout. |
| alReportId | Specifies the ID of the report assigned the layout. |
| companyName | The current company name. |
| environmentName | Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId | AL0000N0G |
Sample KQL code (report layout replaced)
This KQL code can help you get started analyzing which reports users run:
traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions has 'AL0000N0G' // performance optimization
| where customDimensions.eventId == 'AL0000N0G'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// for which report and layout
, reportId = customDimensions.alReportId // object ID of the report
, layoutName = customDimensions.alLayoutName
// what did the user do
, action = customDimensions.alAction // alAction is "Replace" for this event
// user who performed the action
, user_Id // user telemetry ID
Related information
Report performance
Troubleshooting report errors
Monitoring and Analyzing Telemetry