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 & fix potential problems that are preventing web service from working correctly.

The following sections explain the different events included in an outgoing Web Service Publish Failure trace, 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

Dimension Description or value
message Web service metadata error: Name for subpage of parent page '{parentPageName}' is missing. Subpage is skipped.
severityLevel 1

Custom dimensions

Dimension Description or value
aadTenantId

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. See Environment Types.
eventId RT0033
metadataStack Specifies the entity where the error or warning has occurred.
parentPageId The ID of the parent entity object.
parentPageName The name of the parent entity object.
subPageEntityId The ID of the sub page entity.
telemetrySchemaVersion Specifies 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

Dimension Description or value
message Web service metadata error: Control element with id {metadataObjectName} has a missing name. The page with the control was skipped.
severityLevel 1

Custom dimensions

Dimension Description or value
aadTenantId

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. See Environment Types.
eventId RT0034
metadataObjectId The ID of the metadata entity
metadataObjectName The name of the metadata entity object.
metadataStack Specifies the entity where the error or warning has occurred.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.

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

General dimensions

Dimension Description or value
message Web service metadata error: The record with name '{webserviceRecordName}' was skipped.
severityLevel 1

Custom dimensions

Dimension Description or value
aadTenantId

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. See Environment Types.
eventId RT0035
metadataStack Specifies the entity where the error or warning has occurred.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.
webserviceRecordId The ID of the webservice Record.
webserviceRecordName The name of the webservice Record.

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

General dimensions

Dimension Description or value
message Web service metadata error: Table field name error, the page contains the field with caption '{metaFieldCaption}' was skipped.
severityLevel 1

Custom dimensions

Dimension Description or value
aadTenantId

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. See Environment Types.
eventId RT0036
metaFieldCaption The caption of the metafield.
metaFieldId The ID of the metafield.
metadataStack Specifies the entity where the error or warning has occurred.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.

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

General dimensions

Dimension Description or value
message Web service metadata warning: Multiple options while generation navigation property for tablerelation.
severityLevel 2

Custom dimensions

Dimension Description or value
aadTenantId

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. See Environment Types.
eventId RT0038
metadataStack Specifies the entity where the error or warning has occurred.
otherNavigationProperties The list of all possible navigation properties.
pickedNavigationPropertyType The final navigation property type.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.

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

General dimensions

Dimension Description or value
message Web service metadata error: The record with name '{entityName}' was skipped.
severityLevel 1

Custom dimensions

Dimension Description or value
aadTenantId

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

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.
component Dynamics 365 Business Central Server
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
errorDetails Details about the error.
entityName The name of the entity.
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. See Environment Types.
eventId RT0039
metadataStack Specifies the entity where the error or warning has occurred.
telemetrySchemaVersion Specifies 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 setup alerting on Business Central telemetry, see Alert on Telemetry.

See also

Telemetry overview
Enable sending telemetry to Application Insights
Alert on Telemetry