Analyzing server certificate validation errors for outgoing web service requests telemetry

APPLIES TO: Business Central 2025 release wave 1 (v26) and later.

Server certificate validation error telemetry gathers data about errors in validating server certificates on the endpoint when doing outgoing web service requests using the AL HttpClient data type. Use the data to contact the owner of the endpoint and ask them to fix their certificate.

The event is emitted when a certificate validation error is detected, even if certificate validation is bypassed for the request. The event alone doesn't mean that the HTTP request was blocked.

General dimensions

The following table explains the general dimensions included in a server certificate validation error trace. The table lists the dimensions that are specific to Business Central.

DimensionDescription or value
messageHTTP server certificate validation failed when calling endpoint: {endpoint}
severityLevel3

Custom dimensions

The following table explains the custom dimensions included in a server certificate validation error trace.

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.
alObjectIdSpecifies the ID of the AL object that made the request.
alObjectNameSpecifies the name of the AL object that made the request.
alObjectTypeSpecifies the type of the AL object that made the request.
certificateChainSpecifies an ordered list of certificates, including an SSL/TLS certificate and certificate authority (CA) certificates, which allows the receiver to verify the trustworthiness of the sender and all CAs.
certificateIssuerNameSpecifies the value of the issuer field in the certificate properties.
certificateSubjectSpecifies the value of the subject field in the certificate properties. This field typically includes the Common Name (CN) attribute.
companyNameThe current company name.
endpointSpecifies the endpoint for the request. The endpoint is cleaned to include only the base URI.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventIdRT0052
extensionIdSpecifies the appID of the extension that made the request.
extensionNameSpecifies the name of the extension that made the request.
extensionPublisherSpecifies the publisher of the extension that made the request.
extensionVersionSpecifies the version of the extension that made the request.
failureReasonSpecifies why the certificate didn't validate.
httpMethodSpecifies the HTTP method used in the outgoing request. Values include: POST, GET, PUT, PATCH, or DELETE.

Sample KQL code

This KQL code can help you get started analyzing server certificate validation errors.

// added in version 26.0
traces
| where timestamp > ago(60d) // change if your retention policy is different than the default
| where customDimensions has 'RT0052'
| where customDimensions.eventId == 'RT0052'
| project timestamp
// in which environment did it happen
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
// in which extension/app
, extensionId = customDimensions.extensionId
, extensionName = customDimensions.extensionName
, extensionVersion = customDimensions.extensionVersion
, extensionPublisher = customDimensions.extensionPublisher
// in which object
, alObjectId = customDimensions.alObjectId
, alObjectName = customDimensions.alObjectName
, alObjectType = customDimensions.alObjectType
// certificate information
, certificateChain = customDimensions.certificateChain
, certificateIssuerName = customDimensions.certificateIssuerName
, certificateSubject = customDimensions.certificateSubject
// http request details
, endpoint = customDimensions.endpoint
, httpMethod = customDimensions.httpMethod
// why did it fail?
, failureReason = customDimensions.failureReason

HttpClient data type
Telemetry overview
Enable sending telemetry to Application Insights