{"title":"Analyzing financial report usage telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-financial-report-usage-trace/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/telemetry-financial-report-usage-trace, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/telemetry-financial-report-usage-trace","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Analyze financial report usage telemetry in Business Central to identify reports viewed on-screen or run as reports, including their definition codes.","date":"2026-11-17","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Analyzing financial report usage telemetry","slug":"analyzing-financial-report-usage-telemetry","at":0,"chars":4866},{"level":2,"title":"Common dimensions for all financial report usage events","slug":"common-dimensions-for-all-financial-report-usage-events","at":498,"chars":942},{"level":2,"title":"Financial report run on-screen: {report definition code}","slug":"financial-report-run-on-screen-report-definition-code","at":1440,"chars":1403},{"level":3,"title":"General dimensions","slug":"general-dimensions","at":1569,"chars":334},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions","at":1903,"chars":71},{"level":3,"title":"Sample KQL code (financial report run on-screen)","slug":"sample-kql-code-financial-report-run-on-screen","at":1974,"chars":869},{"level":2,"title":"Financial report run from request page: {report definition code}","slug":"financial-report-run-from-request-page-report-definition-code","at":2843,"chars":1674},{"level":3,"title":"General dimensions","slug":"general-dimensions-1","at":3059,"chars":342},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-1","at":3401,"chars":212},{"level":3,"title":"Sample KQL code (financial report run from the request page)","slug":"sample-kql-code-financial-report-run-from-the-request-page","at":3613,"chars":904},{"level":2,"title":"Related information","slug":"related-information","at":4517,"chars":349}],"text":"# Analyzing financial report usage telemetry\n> APPLIES TO: Business Central 2025 release wave 1 (v26) and later.\nFinancial report usage telemetry gathers data about the following operations with financial reports:\n Financial report run on-screen\n Financial report run from request page\nSee Primary capabilities of financial reporting</finance-financial-reporting-capabilities> in the Business Central Application Help.\nThese events use normal verbosity (severityLevel 1) and `TelemetryScope::All`.\n## Common dimensions for all financial report usage events\nThe following table explains custom dimensions that are common to all financial report usage events.\nDimension|Description or value\naadTenantId|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.\nalReportDefinitionCode|Specifies the report definition code for the financial report.\nalRowDefinitionCode|Specifies the row definition code for the financial report.\nalColumnDefinitionCode|Specifies the column definition code for the financial report.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\n## Financial report run on-screen: {report definition code}\nOccurs when a user views a financial report from the user interface.\n### General dimensions\nDimension|Description or value\nmessage|Financial Report run on-screen: {report definition code}\nuser_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. See telemetry-enable-application-insights#assign-a-telemetry-id-to-users.\n### Custom dimensions\nDimension|Description or value\neventId|AL0000OKU\n### Sample KQL code (financial report run on-screen)\nThis KQL code can help you get started analyzing usage of financial reports.\n```kql\n// Financial report run on-screen\ntraces\n| where timestamp > ago(5d) // adjust the time range as needed\n| where customDimensions has 'AL0000OKU'\n| where customDimensions.eventId == 'AL0000OKU'\n| project timestamp\n// in which environment/company did it happen\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, environmentType = customDimensions.environmentType\n, companyName = customDimensions.companyName\n// report/row/column definitions\n, reportDefinitionCode=customDimensions.alReportDefinitionCode\n, rowDefinitionCode=customDimensions.alRowDefinitionCode\n, columnDefinitionCode=customDimensions.alColumnDefinitionCode\n// which user ran the report\n, usertelemetryId = user_Id\n```\n## Financial report run from request page: {report definition code}\nOccurs when the Account Schedule report starts processing a financial report. The event can also occur when the report runs without a request page.\n### General dimensions\nDimension|Description or value\nmessage|Financial Report run from request page: {report definition code}\nuser_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. See telemetry-enable-application-insights#assign-a-telemetry-id-to-users.\n### Custom dimensions\nDimension|Description or value\neventId|AL0000O76\nalReportId|The object ID of the report.\nalReportName|The name of the report object.\nalUseRequestPage|Whether the report uses a request page.\n### Sample KQL code (financial report run from the request page)\nThis KQL code can help you get started analyzing usage of financial reports through the report object.\n```kql\n// Financial report run from request page\ntraces\n| where timestamp > ago(5d) // adjust the time range as needed\n| where customDimensions has 'AL0000O76'\n| where customDimensions.eventId == 'AL0000O76'\n| project timestamp\n// in which environment/company did it happen\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, environmentType = customDimensions.environmentType\n, companyName = customDimensions.companyName\n// report definitions\n, reportDefinitionCode=customDimensions.alReportDefinitionCode\n, rowDefinitionCode=customDimensions.alRowDefinitionCode\n, columnDefinitionCode=customDimensions.alColumnDefinitionCode\n// which user ran the report\n, usertelemetryId = user_Id\n```\n## Related information\nPrimary capabilities of financial reporting</finance-financial-reporting-capabilities>\nAnalyzing financial report lifecycle trace telemetry<telemetry-financial-report-lifecycle-trace>\nMonitoring and Analyzing Telemetry<telemetry-overview>\nEnable Sending Telemetry to Application Insights<telemetry-enable-application-insights>"}