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.
| 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. |
| alReportDefinitionCode | Specifies the report definition code for the financial report. |
| alRowDefinitionCode | Specifies the row definition code for the financial report. |
| alColumnDefinitionCode | Specifies the column definition code for the financial report. |
| 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. |
Financial report run on-screen: {report definition code}
Occurs when a user views a financial report from the user interface.
General dimensions
| Dimension | Description or value |
|---|---|
| message | Financial Report run on-screen: {report definition code} |
| 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 | AL0000OKU |
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
| Dimension | Description or value |
|---|---|
| message | Financial Report run from request page: {report definition code} |
| 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 | AL0000O76 |
| alReportId | The object ID of the report. |
| alReportName | The name of the report object. |
| alUseRequestPage | Whether 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
Related information
Primary capabilities of financial reporting
Analyzing financial report lifecycle trace telemetry
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights