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. For more information, see 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.

See also

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights