Изменить

Поделиться через

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 about working with financial reporting in Primary capabilities of financial reporting in the Business Central Application Help.

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

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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 a user views a financial report from the 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

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

This KQL code can help you get started analyzing usage of financial reports (producing a PDF from the request page).

// 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