Analyzing Email Trace Telemetry

APPLIES TO: Business Central 2020 release wave 2, update 17.2, and later

Email telemetry gathers data about the following operations:

• An email was sent successfully
• An attempt to send an email failed

Before you can collect this data, you'll have to set up email. For more information, see Set Up Email in the Business Central application help.

Email sent successfully

Occurs when an email was successfully sent from the client.

General dimensions

Dimension	Description or value
message	Email sent successfully
severityLevel	1

Custom dimensions

Dimension	Description or value
aadTenantId	Specifies the Azure Active Directory (Azure AD) tenant ID used for Azure AD authentication. For on-premises, if you aren't using Azure AD authentication, this value is common.
alCategory	Email
alConnector	Specifies the email-provider connector used to send the email. Possible values include: Current User Microsoft 365 SMTP Other custom connectors installed by extensions. The connector is specified on the email accounts that are set up in Business Central. For more information, see Adding Email Accounts.
alDataClassification	SystemMetadata
alEmailMessageID	Specifies the GUID assigned to email, like C7A56676-9F3F-4044-90F0-D7F3196AC366.
alObjectId	8888, which is the ID of the system application codeunit that sends emails.
alObjectName	Email Dispatcher, which is the name of the system application codeunit that sends the emails.
alObjectType	CodeUnit
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. See Managing Environments. This dimension isn't included for Business Central on-premises environments.
environmentType	Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId	AL0000CTV
telemetrySchemaVersion	Specifies the version of the Business Central telemetry schema.

Failed to send email

Occurs when an email failed to be sent from the client.

General dimensions

Dimension	Description or value
message	Failed to send email.
severityLevel	1

Custom dimensions

Dimension	Description or value
aadTenantId	Specifies the Azure Active Directory (Azure AD) tenant ID used for Azure AD authentication. For on-premises, if you aren't using Azure AD authentication, this value is common.
alCategory	Email
alConnector	Specifies the email-provider connector used to send the email. Possible values include: Current User Microsoft 365 SMTP Other custom connectors installed by extensions. The connector is specified on the email accounts that are set up in Business Central. For more information, see Adding Email Accounts.
alDataClassification	SystemMetadata
alEmailMessageID	Specifies the GUID assigned to email, like C7A56676-9F3F-4044-90F0-D7F3196AC366.
alErrorCallStack	Specifies the AL callstack when the error occurred. This dimension was added in version 19.0.
alErrorText	Specifies the AL error message. This dimension was added in version 19.0.
alObjectId	8888, which is the ID of the system application codeunit that sends emails.
alObjectName	Email Dispatcher, which is the name of the system application codeunit that sends the emails.
alObjectType	CodeUnit
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. See Managing Environments. This dimension isn't included for Business Central on-premises environments.
environmentType	Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId	AL0000CTP
telemetrySchemaVersion	Specifies the version of the Business Central telemetry schema.

Tip

You can also view failed emails in the Email Outbox page in the Business Central client.

See also

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights