{"title":"Analyze business events telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-business-events-trace/","by":"JOP-AL","license":"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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/telemetry-business-events-trace","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn about business events telemetry in Business Central","date":"2026-05-01","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Analyze business events telemetry","slug":"analyze-business-events-telemetry","at":0,"chars":13934},{"level":2,"title":"Business event subscription created","slug":"business-event-subscription-created","at":315,"chars":1917},{"level":3,"title":"General dimensions","slug":"general-dimensions","at":421,"chars":313},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions","at":734,"chars":968},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code","at":1702,"chars":530},{"level":2,"title":"Business event subscription deleted","slug":"business-event-subscription-deleted","at":2232,"chars":1645},{"level":3,"title":"General dimensions","slug":"general-dimensions-1","at":2325,"chars":313},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-1","at":2638,"chars":862},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-1","at":3500,"chars":377},{"level":2,"title":"Business event subscription modified","slug":"business-event-subscription-modified","at":3877,"chars":1755},{"level":3,"title":"General dimensions","slug":"general-dimensions-2","at":3972,"chars":314},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-2","at":4286,"chars":916},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-2","at":5202,"chars":430},{"level":2,"title":"Business event subscription enabled","slug":"business-event-subscription-enabled","at":5632,"chars":1645},{"level":3,"title":"General dimensions","slug":"general-dimensions-3","at":5725,"chars":313},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-3","at":6038,"chars":862},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-3","at":6900,"chars":377},{"level":2,"title":"Business event subscription disabled","slug":"business-event-subscription-disabled","at":7277,"chars":1650},{"level":3,"title":"General dimensions","slug":"general-dimensions-4","at":7372,"chars":314},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-4","at":7686,"chars":864},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-4","at":8550,"chars":377},{"level":2,"title":"Business event triggered successfully","slug":"business-event-triggered-successfully","at":8927,"chars":1595},{"level":3,"title":"General dimensions","slug":"general-dimensions-5","at":9051,"chars":315},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-5","at":9366,"chars":783},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-5","at":10149,"chars":373},{"level":2,"title":"Business event trigger failed","slug":"business-event-trigger-failed","at":10522,"chars":1553},{"level":3,"title":"General dimensions","slug":"general-dimensions-6","at":10607,"chars":307},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-6","at":10914,"chars":788},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-6","at":11702,"chars":373},{"level":2,"title":"Business event notification sending failed","slug":"business-event-notification-sending-failed","at":12075,"chars":1694},{"level":3,"title":"General dimensions","slug":"general-dimensions-7","at":12211,"chars":320},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-7","at":12531,"chars":770},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-7","at":13301,"chars":468},{"level":2,"title":"Related information","slug":"related-information","at":13769,"chars":165}],"text":"# Analyze business events telemetry\nAPPLIES TO: Business Central 2023 release wave 2 and later\nBusiness 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.\n## Business event subscription created\nOccurs when a business event subscription is successfully created.\n### General dimensions\nDimension|Description or value\nmessage|Business event subscription created\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event subscription was created.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0040\neventName|Specifies the name of the business event that was subscribed to.\neventVersion|Specifies the version of the business event.\nnotificationUrl|Specifies the notification URL that receives business event notifications.\nsubscriptionId|Specifies the GUID assigned to the business event subscription.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0040'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, environmentType = customDimensions.environmentType\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, eventVersion = customDimensions.eventVersion\n, subscriptionId = customDimensions.subscriptionId\n, notificationUrl = customDimensions.notificationUrl\n```\n## Business event subscription deleted\nOccurs when a business event subscription is deleted.\n### General dimensions\nDimension|Description or value\nmessage|Business event subscription deleted\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event subscription was deleted.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0041\neventName|Specifies the name of the business event.\neventVersion|Specifies the version of the business event.\nsubscriptionId|Specifies the GUID of the business event subscription that was deleted.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0041'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, subscriptionId = customDimensions.subscriptionId\n```\n## Business event subscription modified\nOccurs when a business event subscription is modified.\n### General dimensions\nDimension|Description or value\nmessage|Business event subscription modified\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event subscription was modified.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0042\neventName|Specifies the name of the business event.\neventVersion|Specifies the version of the business event.\nnotificationUrl|Specifies the new notification URL.\nsubscriptionId|Specifies the GUID of the business event subscription that was modified.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0042'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, subscriptionId = customDimensions.subscriptionId\n, notificationUrl = customDimensions.notificationUrl\n```\n## Business event subscription enabled\nOccurs when a business event subscription is enabled.\n### General dimensions\nDimension|Description or value\nmessage|Business event subscription enabled\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event subscription was enabled.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0043\neventName|Specifies the name of the business event.\neventVersion|Specifies the version of the business event.\nsubscriptionId|Specifies the GUID of the business event subscription that was enabled.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0043'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, subscriptionId = customDimensions.subscriptionId\n```\n## Business event subscription disabled\nOccurs when a business event subscription is disabled.\n### General dimensions\nDimension|Description or value\nmessage|Business event subscription disabled\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event subscription was disabled.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0044\neventName|Specifies the name of the business event.\neventVersion|Specifies the version of the business event.\nsubscriptionId|Specifies the GUID of the business event subscription that was disabled.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0044'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, subscriptionId = customDimensions.subscriptionId\n```\n## Business event triggered successfully\nOccurs when a business event is successfully triggered and a log entry is created.\n### General dimensions\nDimension|Description or value\nmessage|Business event triggered successfully\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event was triggered.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0045\neventName|Specifies the name of the business event that was triggered.\neventVersion|Specifies the version of the business event.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0045'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, eventVersion = customDimensions.eventVersion\n```\n## Business event trigger failed\nOccurs when a business event couldn't be triggered.\n### General dimensions\nDimension|Description or value\nmessage|Business event trigger failed\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event trigger failed.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0046\neventName|Specifies the name of the business event that failed to trigger.\neventVersion|Specifies the version of the business event.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0046'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, eventVersion = customDimensions.eventVersion\n```\n## Business event notification sending failed\nOccurs when a business event notification failed to be sent to the subscription endpoint.\n### General dimensions\nDimension|Description or value\nmessage|Business event notification sending failed\nuser_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.\n### Custom dimensions\nDimension|Description or value\naadTenantId|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.\ncompanyId|Specifies the GUID of the company in which the business event notification failed.\ncompanyName|The current company name.\nenvironmentName|Specifies the name of the tenant environment. See Managing Environments<tenant-admin-center-environments>.\nenvironmentType|Specifies the environment type for the tenant, such as Production or Sandbox. See tenant-admin-center-environments#types-of-environments.\neventId|RT0047\neventName|Specifies the name of the business event.\neventVersion|Specifies the version of the business event.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0047'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, companyName = customDimensions.companyName\n, eventName = customDimensions.eventName\n, eventVersion = customDimensions.eventVersion\n```\nTo learn more about how to set up alerting on Business Central telemetry, see telemetry-alert.\n## Related information\nMonitoring and Analyzing Telemetry<telemetry-overview>\nEnable Sending Telemetry to Application Insights<telemetry-enable-application-insights>"}