Analyzing financial report usage telemetry

APPLIES TO: Business Central 2025 release wave 1 (v26) and later.

Financial report usage telemetry gathers data about the following operations with financial reports:

  • Financial report run on-screen
  • Financial report run from request page

Learn more in Primary capabilities of financial reporting in the Business Central Application Help.

These events use normal verbosity (severityLevel 1) and TelemetryScope::All.

Common dimensions for all financial report usage events

The following table explains custom dimensions that are common to all financial report usage events.

DimensionDescription or value
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.
alReportDefinitionCodeSpecifies the report definition code for the financial report.
alRowDefinitionCodeSpecifies the row definition code for the financial report.
alColumnDefinitionCodeSpecifies the column definition code for the financial report.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.

Financial report run on-screen: {report definition code}

Occurs when a user views a financial report from the user interface.

General dimensions

DimensionDescription or value
messageFinancial Report run on-screen: {report definition code}
user_IdThe 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

DimensionDescription or value
eventIdAL0000OKU

Sample KQL code (financial report run on-screen)

This KQL code can help you get started analyzing usage of financial reports.

// Financial report run on-screen
traces
| where timestamp > ago(5d) // adjust the time range as needed
| where customDimensions has 'AL0000OKU'
| where customDimensions.eventId == 'AL0000OKU'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// report/row/column definitions
, reportDefinitionCode=customDimensions.alReportDefinitionCode
, rowDefinitionCode=customDimensions.alRowDefinitionCode
, columnDefinitionCode=customDimensions.alColumnDefinitionCode
// which user ran the report
, usertelemetryId = user_Id

Financial report run from request page: {report definition code}

Occurs when the Account Schedule report starts processing a financial report. The event can also occur when the report runs without a request page.

General dimensions

DimensionDescription or value
messageFinancial Report run from request page: {report definition code}
user_IdThe 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

DimensionDescription or value
eventIdAL0000O76
alReportIdThe object ID of the report.
alReportNameThe name of the report object.
alUseRequestPageWhether the report uses a request page.

Sample KQL code (financial report run from the request page)

This KQL code can help you get started analyzing usage of financial reports through the report object.

// Financial report run from request page
traces
| where timestamp > ago(5d) // adjust the time range as needed
| where customDimensions has 'AL0000O76'
| where customDimensions.eventId == 'AL0000O76'
| project timestamp
// in which environment/company did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// report definitions
, reportDefinitionCode=customDimensions.alReportDefinitionCode
, rowDefinitionCode=customDimensions.alRowDefinitionCode
, columnDefinitionCode=customDimensions.alColumnDefinitionCode
// which user ran the report
, usertelemetryId = user_Id

Primary capabilities of financial reporting
Analyzing financial report lifecycle trace telemetry
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights