Data logged to app/extension telemetry
For an app/extension that enables telemetry, the Business Central platform emits telemetry events that happen in the context of the AL code of the app/extension. For example, you get telemetry events when users interact with pages from your app/extension, when REST APIs from your app/extension are called, or when reports from your app/extension are rendered. You get telemetry events when users get error dialogs raised in pages from your app/extension, and when your AL code consumes excessive resources on the Business Central server or database.
Currently, Business Central offers telemetry on the following operations (the column Extension support shows the types of events that are emitted to app/extension telemetry):
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 | |||
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 | |||
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 | |||
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 |
1This signal is only emitted to the Application Insights resource that's specified in the extension.
2Introduced 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.
3Introduced 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.
4Introduced in Business Central 2021 release wave 1, version 18.
5Introduced in Business Central 2022 release wave 1, version 20.
6Introduced in Business Central 2022 release wave 2, version 21.
7Introduced in Business Central 2023 release wave 1, version 22.
8Introduced in Business Central 2023 release wave 1, version 22.1.
9Introduced in Business Central 2023 release wave 2, version 23.
10Introduced in Business Central 2024 release wave 2, version 25.1.
See also
Instrumenting an application for telemetry
Viewing telemetry data in Azure Application Insights