Monitoring and Analyzing Telemetry

APPLIES TO: Business Central 2019 release wave 2 and later

Business 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 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.

Telemetry in Business Central can be enabled on two different levels:

• Environment-level telemetry
• App/extension-level telemetry (for each app/extension installed)

When 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.

With 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 AppSource 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.

Both online environments and on-premises instances can emit telemetry to Azure Application Insights.

Currently, Business Central offers telemetry on the following operations:

Area	Description	Online	On-premises	Extension support	More information
AppSource Submission Validation	Provides information about validation when an extension is submitted to AppSource.				Learn more
App key vault secrets	Provides information about the retrieval of secrets from Azure Key Vaults by extensions.	[1]	[1]		Learn more
Authorization	Provides information about user sign-in attempts. Information includes success or failure indication, reason for failure, user type, and more.				Learn more
Azure Function Integration[6]	Provides information about requests to Azure Functions from Business Central				Learn more
Changelog configuration changes[9]	Provides information about changes to the configuration of the change log.				Learn more
Client actions[7]	Provides information about usage of client features.				Learn more
Client control add-in exception[11]	Provides information about operations done on configuration packages, including exporting, importing, applying, and deleting.				Learn more
Cloud migration[8]	Provides information about cloud migration setup, replication runs, and data upgrade				Learn more
Company lifecycle	Provides information about creating, copying, and deleting of companies.				Learn more
Configuration package lifecycle	Provides information about operations done on configuration packages, including exporting, importing, applying, and deleting.				Learn more
Database deadlocks[5]	Provides information about database deadlocks that occur.				Learn more
Database lock timeouts	Provides information about database locks that have timed out.				Learn more
Database wait statistics	Provides information about the wait categories and the wait times a query runs into.				Learn more
Email	Provides information about the success or failure of sending emails.				Learn more
Environment lifecycle [5]	Provides information about changes and operations on an environment, like updates, hotfixes, copy, move, delete, configuration changes, and more.				Learn more
Environment validation [7]	Provides information about proactive validattions on extensions in the environment against the next release.				Learn more
Error message quality[5]	Provides information about error messages that users thought were helpful or unhelpful.				Learn more
Error method	Provides information about error dialogs that are shown to the users.				Learn more
Extension lifecycle [2]	Provides information about the success or failure of extension-related operations, like publishing, synchronizing, installing, and more.				Learn more
Extension update	Provides information about errors that occur and upgrade tags used when upgrading an extension.				Learn more
Extension Upload Validation[9]	Provides information about validations when a user/administrator uploads a per-tenant extension to an environment from the Extension Management page.				Learn more
Feature Management[7]	Provides information about the state changes done on the Feature Management page.				Learn more
Feature telemetry	Provides information about the usage and errors of features.				Learn more
Field monitoring trace	Provides information about the usage of the field monitoring feature.				Learn more
Financial report lifecycle[11]	Provides data about the lifecycle operations in financial reporting.				Learn more
Financial report usage[11]	Provides data about the usage of the financial reports: Financial report run on-screen and Financial report run from request page.				Learn more
Job queue	Provides information about creating and running job queue entries.				Learn more
Long running AL method trace[3]	Provides information about long running AL methods.				Learn more
Long running operation (SQL query)	Provides information about SQL queries that take longer than expected to execute.				Learn more
Onboarding[7]	Provides information about the onboarding of users.				Learn more
Page views	Provides information about the pages that users open in the modern client.		[6]	[4]	Learn more
Performance Toolkit (BCPT)	Provides information about test results from running the Business Central Performance Toolkit (BCPT).				Learn more
Permissions	Provides information about adding, removing, and assigning permission sets.				Learn more
Permissions dependency cycle[5]	Provides information about dependency cycles in permissions.				Learn more
Permission error[5]	Provides information about errors related to permissions that users get.				Learn more
Profile configuration lifecycle[6]	Provides information about design operations done on profiles from the client.				Learn more
Report generation	Provides information about the execution of reports.				Learn more
Report layout lifecycle[10]	Provides information about actions taken by users on report layouts.				Learn more
Retention policy trace[3]	Provides information about the usage of the retention policy feature.				Learn more
Stopped sessions[5]	Provides information about background sessions that were forcibly stopped from the admin center or by calling the StopSession method from AL.				Learn more
Table index trace[3]	Provides information about the addition or removal of a table index.				Learn more
Task scheduler lifecycle	Provides information the execution of scheduled tasks.				Learn more
User checklists[5]	Provides information about when the status of a user checklist changes				Learn more
Verbose logging enabled/disabled[5]	Provides information about when additional logging is enabled and disabled from the client.				Learn more
Web service access key authentication	Provides information about the authentication of web server access keys on web service requests.				Learn more
Web service publish failures[8]	Provides information about the web services publish failures.				Learn more
Web service requests (incoming)	Provides information about the execution time of incoming web service requests.				Learn more
Web service requests (outgoing )	Provides information about the execution time of outgoing web service requests.				Learn more
Web 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.				Learn more

¹This signal is only emitted to the Application Insights resource that's specified in the extension.

²Introduced 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.

³Introduced in Business Central 2020 release wave 1, version 17.1. For extension telemetry, this signal was introduced in 2021 release wave 1, version 18.1.

⁴Introduced in Business Central 2021 release wave 1, version 18.

⁵Introduced in Business Central 2022 release wave 1, version 20.

⁶Introduced in Business Central 2022 release wave 2, version 21.

⁷Introduced in Business Central 2023 release wave 1, version 22.

⁸Introduced in Business Central 2023 release wave 1, version 22.1.

⁹Introduced in Business Central 2023 release wave 2, version 23.

¹⁰Introduced in Business Central 2024 release wave 2, version 25.1.

¹¹Introduced in Business Central 2025 release wave 1, version 26.0.

To 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. Learn more at Enable Sending Telemetry to Application Insights.

Azure Application Insights is billed based on the volume of telemetry data that is sent (data ingestion) and how long time you want data to be available (data retention).

Check the Azure Application Insights documentation for up-to-date information on pricing at https://azure.microsoft.com/pricing/details/monitor/.

For more information, go to Control Telemetry Cost.

To make it simple to analyze Business Central telemetry, we've developed two Power BI apps available from the Microsoft commercial marketplace. One app is for telemetry on environments. The other one is for telemetry on apps/extensions (the telemetry defined in app.json). Both apps are free and open source but requires Power BI pro licenses to install.

For more information, go to Analyze and Monitor Telemetry with Power BI.

Telemetry 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). Learn more at Logs in Azure Monitor and Overview of log queries in Azure Monitor.

For more information, go to Analyze Telemetry with KQL.

If 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.

If you're a project manager, product owner, or functional consultant, consider using the no-code tool Power BI Metrics for your alerting needs.

If you prefer more control, consider using one of these low-code tools for your alerting needs.

• Azure Application Insights Alerts
• Azure Logic Apps
• Power Automate

For more information, go to Alert on Telemetry.

Go to Business Central BCTech repository on GitHub.

We have compiled a list of frequently asked questions (FAQ) on telemetry. See Telemetry FAQ

Available signal in telemetry
Enable Telemetry
Control Telemetry Cost
Analyze Telemetry with Power BI
Analyze Telemetry with KQL
Alert on Telemetry
Telemetry FAQ
Feature Telemetry* codeunit
Custom telemetry with LogMessage Method
Working with Administration Tools
Business Central Administration Center