# 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
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
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
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
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
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
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
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
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
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
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
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
eventId|RT0045
eventName|Specifies the name of the business event that was triggered.
eventVersion|Specifies the version of the business event.
### Sample KQL code
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
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
```kql
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. See telemetry-enable-application-insights#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. See Managing Environments<tenant-admin-center-environments>.
environmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.
eventId|RT0047
eventName|Specifies the name of the business event.
eventVersion|Specifies the version of the business event.
### Sample KQL code
```kql
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 telemetry-alert.
## Related information
Monitoring and Analyzing Telemetry<telemetry-overview>
Enable Sending Telemetry to Application Insights<telemetry-enable-application-insights>

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/telemetry-business-events-trace, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-business-events-trace/
