Analyzing web service publish failure telemetry

APPLIES TO: Business Central 2023 release wave 1 and later

Web service publish failure telemetry gathers data when a web service couldn't be published or a published web service isn't working correctly due to an error in creating metadata for the web service. As a partner, the data gives you the ability to investigate and fix potential problems that are preventing a web service from working correctly.

The following sections explain the different events emitted during web service metadata generation, along with their dimensions. The tables list the dimensions that are specific to Business Central.

Web service metadata error: Name for subpage of parent page '{parentPageName}' is missing. Subpage is skipped.

General dimensions

DimensionDescription or value
messageWeb service metadata error: Name for subpage of parent page '{parentPageName}' is missing. Subpage is skipped.
severityLevel3

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.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0033
metadataStackSpecifies the entity where the error or warning has occurred.
parentPageIdThe ID of the parent entity object.
parentPageNameThe name of the parent entity object.
subPageEntityThe ID of the subpage entity.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Web service metadata error: Control element with id '{metadataObjectName}' has a missing name. The page with the control was skipped.

General dimensions

DimensionDescription or value
messageWeb service metadata error: Control element with id {metadataObjectName} has a missing name. The page with the control was skipped.
severityLevel3

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.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0034
metadataObjectIdThe ID of the metadata entity
metadataObjectNameThe name of the metadata entity object.
metadataStackSpecifies the entity where the error or warning has occurred.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Web service metadata error: The record with name '{webserviceRecordName}' was skipped.

General dimensions

DimensionDescription or value
messageWeb service metadata error: The record with name '{webserviceRecordName}' was skipped.
severityLevel3

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.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0035
metadataStackSpecifies the entity where the error or warning has occurred.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.
webServiceRecordIdThe ID of the web service record.
webServiceRecordNameThe name of the web service record.

Web service metadata error: Table field name error, the page containing the field with caption '{metaFieldCaption}' was skipped.

General dimensions

DimensionDescription or value
messageWeb service metadata error: Table field name error, the page contaning the field with caption '{metafieldCaption}' was skipped.
severityLevel3

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.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0036
metafieldCaptionThe caption of the metafield.
metaFieldIdThe ID of the metafield.
metadataStackSpecifies the entity where the error or warning has occurred.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Web service metadata warning: Multiple options while generation navigation property for tablerelation.

General dimensions

DimensionDescription or value
messageWeb service metadata warning: Multiple options while generation navigation property for tablerelation.
severityLevel2

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.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0038
metadataStackSpecifies the entity where the error or warning has occurred.
otherNavigationPropertiesThe list of all possible navigation properties.
pickedNavigationPropertyTypeThe final navigation property type.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Web service metadata error: The record with name '{entityName}' was skipped.

General dimensions

DimensionDescription or value
messageWeb service metadata error: The record with name '{entityName}' was skipped.
severityLevel3

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.
componentDynamics 365 Business Central Server
componentVersionSpecifies the version number of the component that emits telemetry. See the component dimension.
errorDetailsDetails about the error.
entityNameThe name of the entity.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0039
metadataStackSpecifies the entity where the error or warning has occurred.
telemetrySchemaVersionSpecifies the version of the Business Central telemetry schema.

Sample KQL code

This KQL code can help you get started analyzing and alerting on web service metadata errors.

traces
| where timestamp > ago(60d) // adjust as needed
| where customDimensions.eventId in ('RT0033','RT0034','RT0035','RT0036','RT0038','RT0039')
| project timestamp
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, eventId = customDimensions.eventId
, metadataStack = customDimensions.metadataStack
, errorDetails = customDimensions.errorDetails

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

Telemetry overview
Enable sending telemetry to Application Insights
Alert on Telemetry