APPLIES TO: Business Central 2024 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
| Dimension |
Description or value |
| message |
Business event subscription created |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event subscription was created. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0040 |
| eventName |
Specifies the name of the business event that was subscribed to. |
| eventVersion |
Specifies the version of the business event. |
| notificationUrl |
Specifies the notification URL that receives business event notifications. |
| subscriptionId |
Specifies 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
| Dimension |
Description or value |
| message |
Business event subscription deleted |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event subscription was deleted. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0041 |
| eventName |
Specifies the name of the business event. |
| eventVersion |
Specifies the version of the business event. |
| subscriptionId |
Specifies 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
| Dimension |
Description or value |
| message |
Business event subscription modified |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event subscription was modified. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0042 |
| eventName |
Specifies the name of the business event. |
| eventVersion |
Specifies the version of the business event. |
| notificationUrl |
Specifies the new notification URL. |
| subscriptionId |
Specifies 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
| Dimension |
Description or value |
| message |
Business event subscription enabled |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event subscription was enabled. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0043 |
| eventName |
Specifies the name of the business event. |
| eventVersion |
Specifies the version of the business event. |
| subscriptionId |
Specifies 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
| Dimension |
Description or value |
| message |
Business event subscription disabled |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event subscription was disabled. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0044 |
| eventName |
Specifies the name of the business event. |
| eventVersion |
Specifies the version of the business event. |
| subscriptionId |
Specifies 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
| Dimension |
Description or value |
| message |
Business event triggered successfully |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event was triggered. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0045 |
| eventName |
Specifies the name of the business event that was triggered. |
| eventVersion |
Specifies 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
| Dimension |
Description or value |
| message |
Business event trigger failed |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event trigger failed. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0046 |
| eventName |
Specifies the name of the business event that failed to trigger. |
| eventVersion |
Specifies 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
| Dimension |
Description or value |
| message |
Business event notification sending failed |
| 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. |
Custom dimensions
| Dimension |
Description or value |
| 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. |
| companyId |
Specifies the GUID of the company in which the business event notification failed. |
| companyName |
The current company name. |
| environmentName |
Specifies the name of the tenant environment. Learn more in Managing Environments. |
| environmentType |
Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types. |
| eventId |
RT0047 |
| eventName |
Specifies the name of the business event. |
| eventVersion |
Specifies 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