Analyze business events telemetry

APPLIES TO: Business Central 2023 release wave 2 and later

Business events telemetry gathers data about the lifecycle and execution of business event subscriptions. Business events enable external systems to receive notifications when specific actions occur in Business Central.

Business event subscription created

Occurs when a business event subscription is successfully created.

General dimensions

DimensionDescription or value
messageBusiness event subscription created
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event subscription was created.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0040
eventNameSpecifies the name of the business event that was subscribed to.
eventVersionSpecifies the version of the business event.
notificationUrlSpecifies the notification URL that receives business event notifications.
subscriptionIdSpecifies the GUID assigned to the business event subscription.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0040'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, eventVersion = customDimensions.eventVersion
, subscriptionId = customDimensions.subscriptionId
, notificationUrl = customDimensions.notificationUrl

Business event subscription deleted

Occurs when a business event subscription is deleted.

General dimensions

DimensionDescription or value
messageBusiness event subscription deleted
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event subscription was deleted.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0041
eventNameSpecifies the name of the business event.
eventVersionSpecifies the version of the business event.
subscriptionIdSpecifies the GUID of the business event subscription that was deleted.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0041'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, subscriptionId = customDimensions.subscriptionId

Business event subscription modified

Occurs when a business event subscription is modified.

General dimensions

DimensionDescription or value
messageBusiness event subscription modified
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event subscription was modified.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0042
eventNameSpecifies the name of the business event.
eventVersionSpecifies the version of the business event.
notificationUrlSpecifies the new notification URL.
subscriptionIdSpecifies the GUID of the business event subscription that was modified.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0042'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, subscriptionId = customDimensions.subscriptionId
, notificationUrl = customDimensions.notificationUrl

Business event subscription enabled

Occurs when a business event subscription is enabled.

General dimensions

DimensionDescription or value
messageBusiness event subscription enabled
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event subscription was enabled.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0043
eventNameSpecifies the name of the business event.
eventVersionSpecifies the version of the business event.
subscriptionIdSpecifies the GUID of the business event subscription that was enabled.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0043'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, subscriptionId = customDimensions.subscriptionId

Business event subscription disabled

Occurs when a business event subscription is disabled.

General dimensions

DimensionDescription or value
messageBusiness event subscription disabled
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event subscription was disabled.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0044
eventNameSpecifies the name of the business event.
eventVersionSpecifies the version of the business event.
subscriptionIdSpecifies the GUID of the business event subscription that was disabled.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0044'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, subscriptionId = customDimensions.subscriptionId

Business event triggered successfully

Occurs when a business event is successfully triggered and a log entry is created.

General dimensions

DimensionDescription or value
messageBusiness event triggered successfully
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event was triggered.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0045
eventNameSpecifies the name of the business event that was triggered.
eventVersionSpecifies the version of the business event.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0045'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, eventVersion = customDimensions.eventVersion

Business event trigger failed

Occurs when a business event couldn't be triggered.

General dimensions

DimensionDescription or value
messageBusiness event trigger failed
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event trigger failed.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0046
eventNameSpecifies the name of the business event that failed to trigger.
eventVersionSpecifies the version of the business event.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0046'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, eventVersion = customDimensions.eventVersion

Business event notification sending failed

Occurs when a business event notification failed to be sent to the subscription endpoint.

General dimensions

DimensionDescription or value
messageBusiness event notification sending failed
user_IdThe 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.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies 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.
companyIdSpecifies the GUID of the company in which the business event notification failed.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0047
eventNameSpecifies the name of the business event.
eventVersionSpecifies the version of the business event.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'RT0047'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, companyName = customDimensions.companyName
, eventName = customDimensions.eventName
, eventVersion = customDimensions.eventVersion

To learn more about how to set up alerting on Business Central telemetry, see Alert on Telemetry.

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights