{"title":"Analyze API metadata validation telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/telemetry-api-metadata-validation-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-api-metadata-validation-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-api-metadata-validation-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 the API metadata validation telemetry in Business Central","date":"2026-05-01","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Analyze API metadata validation telemetry","slug":"analyze-api-metadata-validation-telemetry","at":0,"chars":6821},{"level":2,"title":"API metadata conflicting API path","slug":"api-metadata-conflicting-api-path","at":358,"chars":1299},{"level":3,"title":"General dimensions","slug":"general-dimensions","at":484,"chars":219},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions","at":703,"chars":661},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code","at":1364,"chars":293},{"level":2,"title":"API metadata invalid page","slug":"api-metadata-invalid-page","at":1657,"chars":1214},{"level":3,"title":"General dimensions","slug":"general-dimensions-1","at":1797,"chars":120},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-1","at":1917,"chars":661},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-1","at":2578,"chars":293},{"level":2,"title":"API metadata circular API pages","slug":"api-metadata-circular-api-pages","at":2871,"chars":1330},{"level":3,"title":"General dimensions","slug":"general-dimensions-2","at":3037,"chars":126},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-2","at":3163,"chars":746},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-2","at":3909,"chars":292},{"level":2,"title":"API metadata invalid root entity","slug":"api-metadata-invalid-root-entity","at":4201,"chars":1120},{"level":3,"title":"General dimensions","slug":"general-dimensions-3","at":4293,"chars":127},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-3","at":4420,"chars":661},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-3","at":5081,"chars":240},{"level":2,"title":"API metadata conflicting navigation property","slug":"api-metadata-conflicting-navigation-property","at":5321,"chars":1287},{"level":3,"title":"General dimensions","slug":"general-dimensions-4","at":5473,"chars":139},{"level":3,"title":"Custom dimensions","slug":"custom-dimensions-4","at":5612,"chars":661},{"level":3,"title":"Sample KQL code","slug":"sample-kql-code-4","at":6273,"chars":335},{"level":2,"title":"Related information","slug":"related-information","at":6608,"chars":213}],"text":"# Analyze API metadata validation telemetry\nAPPLIES TO: Business Central 2024 release wave 2 and later\nAPI metadata validation telemetry gathers data about errors that occur when Business Central validates API page metadata during API generation. These errors help identify configuration issues with API pages that prevent them from being exposed correctly.\n## API metadata conflicting API path\nOccurs when two or more API pages attempt to use the same API path, creating a conflict.\n### General dimensions\nDimension|Description or value\nmessage|Web service conflicting API path: {path} for group {groupId}, object type {objectType}, object ID {objectId}, package ID {packageId}\nseverityLevel|3 (Error)\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.\ncomponent|Dynamics 365 Business Central Server\ncomponentVersion|Specifies the version number of the component that emits telemetry.\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|RT0048\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0048'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, environmentType = customDimensions.environmentType\n```\n## API metadata invalid page\nThis error occurs when an API page has an invalid configuration that prevents it from being exposed as an API.\n### General dimensions\nDimension|Description or value\nmessage|Web service metadata invalid page\nseverityLevel|3 (Error)\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.\ncomponent|Dynamics 365 Business Central Server\ncomponentVersion|Specifies the version number of the component that emits telemetry.\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|RT0037\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0037'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, environmentType = customDimensions.environmentType\n```\n## API metadata circular API pages\nOccurs when API pages have circular references through navigation properties, creating an infinite loop in the metadata hierarchy.\n### General dimensions\nDimension|Description or value\nmessage|Web service metadata circular API pages\nseverityLevel|3 (Error)\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.\ncomponent|Dynamics 365 Business Central Server\ncomponentVersion|Specifies the version number of the component that emits telemetry.\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|RT00049\npagesHierarchy|Specifies the hierarchy of pages that caused the circular reference.\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT00049'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n, pagesHierarchy = customDimensions.pagesHierarchy\n```\n## API metadata invalid root entity\nOccurs when an API page defines an invalid root entity.\n### General dimensions\nDimension|Description or value\nmessage|Web service metadata invalid root entity\nseverityLevel|3 (Error)\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.\ncomponent|Dynamics 365 Business Central Server\ncomponentVersion|Specifies the version number of the component that emits telemetry.\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|RT0050\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0050'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\n```\n## API metadata conflicting navigation property\nOccurs when an API page has conflicting navigation properties with the same name but different targets.\n### General dimensions\nDimension|Description or value\nmessage|Web service metadata conflicting navigation property\nseverityLevel|3 (Error)\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.\ncomponent|Dynamics 365 Business Central Server\ncomponentVersion|Specifies the version number of the component that emits telemetry.\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|RT0051\n### Sample KQL code\n```kql\ntraces\n| where timestamp > ago(60d)\n| where customDimensions.eventId == 'RT0051'\n| project timestamp\n, message\n, aadTenantId = customDimensions.aadTenantId\n, environmentName = customDimensions.environmentName\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>\nAPI Page Type<../developer/devenv-api-pagetype>"}