Analyzing Error Message Quality Telemetry
APPLIES TO: > APPLIES TO: Business Central 2022 release wave 1 and later
Note
Azure Active Directory is now Microsoft Entra ID. Learn more
When a user gets an error message in Business Central while working in the application, the message includes a yes or no question as to whether the message was helpful, similar to the following illustration:
If a user selects either Yes or No, a signal is emitted and recorded in Azure Application Insights. This information can help partners and developers get insight into error messages that users find hard to understand. They can then follow up with the customer to help out.
This voting feature appears on all error messages that are thrown by calls to the Error(String) and Error(ErrorInfo) methods.
User gave feedback on error message
Occurs when a use selects either Yes or No to the question on the error dialog as to whether the message was helpful.
General dimensions
The following table explains the general dimensions included in the trace. The table lists the dimensions that are specific to Business Central.
| Dimension | Description or value |
|---|---|
| message | User gave feedback on error message: [OK|Not OK] |
| 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. Data in user_Id from the User card was introduced in version 24 for page view telemetry. |
Custom dimensions
The following table explains the custom dimensions included in the trace.
| Dimension | Description or value |
|---|---|
| eventId | CL0002 |
| aadTenantId | 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. |
| alObjectId | Specifies the ID of the AL object that threw the error. |
| alObjectName | Specifies the ID of the AL object that threw the error. |
| alObjectType | Specifies the ID of the AL object that threw the error. |
| alStackTrace | Specifies the stack trace in AL code for the error. |
| appId | Specifies the ID of the extension that threw the error. |
| appName | Specifies the name of the extension that threw the error. |
| appVersion | Specifies the version of the extension that threw the error. |
| component | Dynamics 365 Business Central Server |
| componentVersion | Specifies the version number of the component that emits telemetry (see the component dimension.) |
| environmentName | Specifies the name of the tenant environment. This dimension isn't included with Business Central on-premises. See Managing Environments. |
| environmentType | Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types |
| errorMessage | Specifies the error shown to the user. |
| exceptionId | Specifies the GUID assigned to the error. |
| userFeedback | Specifies what the user voted, which can be either Yes or No. |
| userLocale | Specifies the regional language version of the message. The value is a language culture name, like en-US for English US and da-DK for Danish. |
| telemetrySchemaVersion | Specifies the version of the Business Central telemetry schema. |
Related information
Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights