{"title":"Monitoring and analyzing telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-overview/","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-overview, 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-overview","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":"Monitor Business Central environments and extensions with Application Insights telemetry to diagnose errors, analyze performance, and track usage.","date":"2026-11-17","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Monitoring and analyzing telemetry","slug":"monitoring-and-analyzing-telemetry","at":0,"chars":16277},{"level":2,"title":"Environment-level and app/extension-level telemetry","slug":"environment-level-and-appextension-level-telemetry","at":717,"chars":1602},{"level":2,"title":"Available telemetry","slug":"available-telemetry","at":2319,"chars":10647},{"level":2,"title":" Enable telemetry","slug":"enable-telemetry","at":12966,"chars":535},{"level":2,"title":" Control telemetry cost","slug":"control-telemetry-cost","at":13501,"chars":302},{"level":2,"title":"Viewing telemetry data with Power BI","slug":"viewing-telemetry-data-with-power-bi","at":13803,"chars":430},{"level":2,"title":"Analyze telemetry data","slug":"analyze-telemetry-data","at":14233,"chars":483},{"level":2,"title":"Setting up alerts on telemetry","slug":"setting-up-alerts-on-telemetry","at":14716,"chars":648},{"level":2,"title":"Telemetry sample code","slug":"telemetry-sample-code","at":15364,"chars":146},{"level":2,"title":"Business Central telemetry FAQ","slug":"business-central-telemetry-faq","at":15510,"chars":100},{"level":2,"title":"Related information","slug":"related-information","at":15610,"chars":667}],"text":"# Monitoring and analyzing telemetry\n> APPLIES TO: Business Central 2019 release wave 2 and later\nBusiness Central emits telemetry data for various activities and operations on environments and apps/extensions. Monitoring telemetry gives you a look at the activities and general health of your environments/apps, so you can diagnose problems and analyze operations that affect performance. Azure Application Insights<https://learn.microsoft.com/azure/azure-monitor/app/app-insights-overview> is a service hosted within Azure that gathers telemetry data for analysis and presentation. Whether running Business Central online or on-premises, you can set your tenants up to send telemetry to Azure Application Insights.\n## Environment-level and app/extension-level telemetry\nTelemetry in Business Central can be enabled on two different levels:\n Environment-level telemetry\n App/extension-level telemetry (for each app/extension installed)\n![Shows how Environment-level telemetry and App/extension-level telemetry works in Business Central AL]\nWhen telemetry is enabled on the environment level, telemetry is emitted to an Azure Application Insights resource for gathering data on operations that happen on the environment.\nWith the Business Central 2020 release wave 2 and later, telemetry can also be enabled on a per-extension basis. Enabling telemetry is done by setting an Azure Application Insights connection string in the app's manifest (app.json file). At runtime, certain events related to the app/extension are emitted to the Azure Application Insights resource. This feature targets publishers of per-tenant extensions or Microsoft Marketplace apps. It gives extension publishers insight into usage of their apps/extensions and also allows them to find errors and performance issues before partners and customers report them.\nBoth online environments and on-premises instances can emit telemetry to Azure Application Insights.\n> TIP\n> As an AL developer, craft custom telemetry messages directly from AL by using the Feature Telemetry codeunit<https://github.com/microsoft/BCApps/tree/main/src/System%20Application/App/Telemetry> in the System Application or the ../developer/methods-auto/session/session-logmessage-string-string-verbosity-dataclassification-telemetryscope-string-string-string-string-method.\n## Available telemetry\nCurrently, Business Central offers telemetry on the following operations:\nArea|Description|Online|On-premises|Extension support|More information\nAgent Lifecycle #13|Provides information about agent creation, configuration changes, and task creation.|✓|||telemetry-agent-lifecycle-trace\nAI Consumption #11|Provides information about Copilot Credits consumed by features subject to consumption-based billing<tenant-admin-center-manage-consumption-billing>.|✓||✓|telemetry-ai-consumption\nApp key vault secrets|Provides information about the retrieval of secrets from Azure Key Vaults by extensions.|✓#1|✓#1|✓|telemetry-extension-key-vault-trace\nApp resource exposure policy #12|Provides information about failures when parsing resource exposure policy overrides in extensions.|✓|✓||telemetry-app-resource-exposure-trace\nAPI metadata validation #12|Provides information about API page metadata validation errors during API generation.|✓|✓||telemetry-api-metadata-validation-trace\nAuthorization|Provides information about user sign-in attempts. Information includes success or failure indication, reason for failure, user type, and more.|✓|✓||telemetry-authorization-trace\nAzure Function Integration#6|Provides information about requests to Azure Functions from Business Central|✓|✓||telemetry-azure-function-integration-trace\nBusiness events #9|Provides information about business event subscription lifecycle and execution.|✓|✓||telemetry-business-events-trace\nChangelog configuration changes#9|Provides information about changes to the configuration of the change log.|✓|✓||telemetry-changelog-configuration-trace\nClient actions#7|Provides information about usage of client features.|✓|✓||telemetry-client-action-trace\nClient control add-in exception#11|Provides information about operations done on configuration packages, including exporting, importing, applying, and deleting.|✓|✓||telemetry-client-add-in-exceptions\nCloud migration#8|Provides information about cloud migration setup, replication runs, and data upgrade|✓|||telemetry-cloud-migration-trace\nCompany lifecycle|Provides information about creating, copying, and deleting of companies.|✓|✓||telemetry-company-lifecycle-trace\nConfiguration package lifecycle|Provides information about operations done on configuration packages, including exporting, importing, applying, and deleting.|✓|✓||telemetry-configuration-package-trace\nDatabase deadlocks#5|Provides information about database deadlocks that occur.|✓|✓||telemetry-database-deadlocks-trace\nDatabase lock timeouts|Provides information about database locks that timed out.|✓|✓||telemetry-database-locks-trace\nDatabase wait statistics|Provides information about the wait categories and the wait times a query runs into.|✓|✓||telemetry-database-wait-statistics-trace\nEmail|Provides information about the success or failure of sending emails.|✓|✓||telemetry-email-trace\nEnvironment lifecycle #5|Provides information about changes and operations on an environment, like updates, hotfixes, copy, move, delete, configuration changes, and more.|✓|||telemetry-environment-lifecycle-trace\nEnvironment validation #7|Provides information about proactive validations on extensions in the environment against the next release.|✓|||telemetry-environment-validation-trace\nError message quality#5|Provides information about error messages that users thought were helpful or unhelpful.|✓|✓||telemetry-error-message-voting-trace\nError method|Provides information about error dialogs that are shown to the users.|✓|✓|✓|telemetry-error-method-trace\nExtension lifecycle #2|Provides information about the success or failure of extension-related operations, like publishing, synchronizing, installing, and more.|✓|✓|✓|telemetry-extension-lifecycle-trace\nExtension update|Provides information about errors that occur and upgrade tags used when upgrading an extension.|✓|✓|✓|telemetry-extension-update-trace\nExtension Upload Validation#9|Provides information about validations when a user/administrator uploads a per-tenant extension to an environment from the Extension Management page.|✓|||telemetry-pte-upload-validation-trace\nFeature Management#7|Provides information about the state changes done on the Feature Management page.|✓|✓||telemetry-feature-management-trace\nFeature telemetry|Provides information about the usage and errors of features.|✓|✓|Through a registered publisher telemetry logger.|Using feature telemetry<telemetry-feature-telemetry>\nField monitoring trace|Provides information about the usage of the field monitoring feature.|✓|✓||telemetry-field-monitoring-trace\nFinancial report lifecycle#11|Provides data about the lifecycle operations in financial reporting.|✓|✓||telemetry-financial-report-lifecycle-trace\nFinancial report usage#11|Provides data about the usage of the financial reports: Financial report run on-screen and Financial report run from request page.|✓|✓||telemetry-financial-report-usage-trace\nJob queue|Provides information about creating and running job queue entries.|✓|✓||telemetry-job-queue-lifecycle-trace\nLong running AL method trace#3|Provides information about long running AL methods.|✓|✓|✓|telemetry-al-method-trace\nLong running operation (SQL query)|Provides information about SQL queries that take longer than expected to execute.|✓|✓|✓|telemetry-long-running-sql-query-trace\nMCP configuration#13|Provides information about creating, modifying, and deleting MCP (Model Context Protocol) configurations.|✓|✓||telemetry-mcp-configuration-trace\nMCP Server#13|Provides information about tool calls made through MCP Server configurations.|✓|||telemetry-mcp-server-trace\nMarketplace app breaking changes validation|Provides information about ongoing validations checking if an app compiles and meets technical requirements across upcoming Business Central versions.|✓||✓|telemetry-appsource-app-validation-trace\nMarketplace Submission Validation|Provides information about validation when an extension is submitted to Marketplace.|✓||✓|telemetry-appsource-submission-validation-trace\nMetadata embeddings#13|Provides information about embedding generation lifecycle for extensions, used to power AI features like Copilot search.|✓|||telemetry-metadata-embeddings-trace\nOnboarding#7|Provides information about the onboarding of users.|✓|✓||telemetry-onboarding-trace\nOpen in Excel #14|Provides information about when users export data to Excel using the Open in Excel action.|✓|✓||telemetry-open-in-excel-trace\nPage views|Provides information about the pages that users open in the modern client.|✓|✓#6|✓#4|telemetry-page-view-trace\nPerformance Toolkit (BCPT)|Provides information about test results from running the Business Central Performance Toolkit (BCPT).|✓|✓||telemetry-performance-toolkit-trace\nPermissions|Provides information about adding, removing, and assigning permission sets.|✓|||telemetry-permission-changes-trace\nPermissions dependency cycle#5|Provides information about dependency cycles in permissions.|✓|✓||telemetry-permission-dependency-cycle-trace\nPermission error#5|Provides information about errors related to permissions that users get.|✓|✓||telemetry-permission-error-trace\nProfile configuration lifecycle#6|Provides information about design operations done on profiles from the client.|✓|✓||telemetry-profile-configuration-lifecycle-trace\nReport generation|Provides information about the execution of reports.|✓|✓|✓|telemetry-reports-trace\nReport layout lifecycle#10|Provides information about actions taken by users on report layouts.|✓|✓|✓|telemetry-reports-trace\nRetention policy trace#3|Provides information about the usage of the retention policy feature.|✓|✓||telemetry-retention-policy-trace\nSQL query trace #12|Provides verbose logging of all SQL queries when additional logging is enabled.|✓|✓||telemetry-sql-query-trace\nStopped sessions#5|Provides information about background sessions that were forcibly stopped from the admin center or by calling the StopSession method from AL.|✓|✓|AL calls with extension context.|telemetry-stop-session-trace\nTable index trace#3|Provides information about the addition or removal of a table index.|✓|✓|✓|telemetry-table-index-trace\nTask scheduler lifecycle|Provides information the execution of scheduled tasks.|✓|✓||telemetry-task-scheduler-trace\nUser checklists#5|Provides information about when the status of a user checklist changes|✓|✓||telemetry-user-checklist-trace\nVerbose logging enabled/disabled#5|Provides information about when additional logging is enabled and disabled from the client.|✓|✓||telemetry-verbose-logging-trace\nWeb service access key authentication|Provides information about the authentication of web server access keys on web service requests.|✓|✓||telemetry-webservices-access-key-trace\nWeb service publish failures#8|Provides information about the web services publish failures.|✓|✓|✓|telemetry-webservices-publish-failure-trace\nWeb service requests (incoming)|Provides information about the execution time of incoming web service requests.|✓|✓|✓|telemetry-webservices-trace\nWeb service requests (outgoing )|Provides information about the execution time of outgoing web service requests.|✓|✓|✓|telemetry-webservices-outgoing-trace\nWeb service requests (outgoing ): Server certificate validation errors#11|Provides information data about errors in validating server certificates on the endpoint when doing outgoing web service requests using the AL HTTPClient module.|✓|✓||telemetry-webservices-outgoing-certificate-validation-errors\n1This signal is only emitted to the Application Insights resource that's specified in the extension.\n2Introduced in Business Central 2020 release wave 1, version 16.3. For extension telemetry, this signal was introduced in 2020 release wave 2, version 17.1.\n3Introduced in Business Central 2020 release wave 2, version 17.1. For extension telemetry, this signal was introduced in 2021 release wave 1, version 18.1.\n4Introduced in Business Central 2021 release wave 1, version 18.\n5Introduced in Business Central 2022 release wave 1, version 20.\n6Introduced in Business Central 2022 release wave 2, version 21.\n7Introduced in Business Central 2023 release wave 1, version 22.\n8Introduced in Business Central 2023 release wave 1, version 22.1.\n9Introduced in Business Central 2023 release wave 2, version 23.\n10Introduced in Business Central 2024 release wave 2, version 25.1.\n11Introduced in Business Central 2025 release wave 1, version 26.0.\n12Introduced in Business Central 2025 release wave 1, version 26.1.\n13Introduced in Business Central 2026 release wave 1, version 28.0.\n14Introduced in Business Central 2026 release wave 2, version 29.0.\n##  Enable telemetry\nTo send telemetry data to Azure Application Insights, you must have an Application Insights resource in Azure. Once you have the Azure Application Insights resource, you can start to configure your environments and apps/extensions to send telemetry data to it. See Enable Sending Telemetry to Application Insights<telemetry-enable-application-insights>.\n> NOTE\n> For apps/extensions, learn more in Sending Extension Telemetry to Azure Application Insights<../developer/devenv-application-insights-for-extensions>.\n##  Control telemetry cost\nAzure Application Insights is billed based on the volume of telemetry data that is sent (data ingestion) and how long you want data to be available (data retention).\nSee Azure Monitor pricing<https://azure.microsoft.com/pricing/details/monitor/>.\nSee telemetry-control-cost.\n## Viewing telemetry data with Power BI\nYou can analyze Business Central telemetry with two free, open-source Power BI apps from the Microsoft commercial marketplace. One app lets you view telemetry for environments. The other app lets you view telemetry for apps and extensions (as defined in app.json). Both apps require Power BI Pro licenses to install.\nSee Analyze and Monitor Telemetry with Power BI<telemetry-power-bi-app>.\n## Analyze telemetry data\nTelemetry from Business Central is stored in Azure Application Insights Logs in the traces and pageViews tables. You can view collected data by writing log queries using Kusto Query Language (KQL). See Logs in Azure Monitor<https://learn.microsoft.com/azure/azure-monitor/platform/data-platform-logs> and Overview of log queries in Azure Monitor<https://learn.microsoft.com/azure/azure-monitor/log-query/log-query-overview>.\nSee telemetry-analyze-with-kql.\n## Setting up alerts on telemetry\nIf something happens in your environment or app that you need to act on, you can set up a system that sends you an alert. Azure Application Insights makes it easy to define such alerts. You can set up alerts on telemetry events with various tools depending on your role.\nIf you're a project manager, product owner, or functional consultant, consider using Power BI goals to track telemetry measures against business objectives.\nIf you prefer more control, consider using one of these low-code tools for your alerting needs.\n Azure Application Insights Alerts\n Azure Logic Apps\n Power Automate\nSee telemetry-alert.\n## Telemetry sample code\nGo to Business Central BCTech repository on GitHub<https://github.com/microsoft/BCTech/tree/master/samples/AppInsights>.\n## Business Central telemetry FAQ\nGet answers to common questions about telemetry in telemetry-faq.\n## Related information\nAvailable signal in telemetry<telemetry-available-telemetry>\ntelemetry-enable-application-insights\ntelemetry-control-cost\nAnalyze Telemetry with Power BI<telemetry-power-bi-app>\ntelemetry-analyze-with-kql\ntelemetry-alert\ntelemetry-faq\nFeature Telemetry codeunit<https://github.com/microsoft/BCApps/tree/main/src/System%20Application/App/Telemetry>\nCustom telemetry with LogMessage Method<../developer/methods-auto/session/session-logmessage-string-string-verbosity-dataclassification-telemetryscope-string-string-string-string-method>\nWorking with Administration Tools<administration>\nBusiness Central Administration Center<tenant-admin-center>"}