Analyzing Web Service Access Key Telemetry

APPLIES TO: Business Central 2020 release wave 2, version 17.3, and later

Note

Azure Active Directory is now Microsoft Entra ID. Learn more

The Business Central emits telemetry data about the success or failure of authenticating web service access keys on web service requests.

Important

Starting October, 2022, the use of access keys (Basic Auth) for web service authentication is deprecated and not supported in Business Central online. We recommend that you use OAuth2 instead. For more information, see Using OAuth to Authorize Business Central Web Services.

As a partner or customer, this data lets you monitor the use of web service access keys on your environments in preparation for the deprecation of the feature.

For information about web service access keys, see How to use an Access Key for SOAP and OData Web Service Authentication.

Authentication with web service key succeeded

Occurs when a web service access key was authenticated successfully.

General dimensions

The following table explains the general dimensions included in the trace. The table lists the dimensions that are specific to Business Central.

Dimension	Description or value
message	Authentication with Web Service Key succeeded: {endpoint}
severityLevel	1

Custom dimensions

The following table explains the custom dimensions included in the trace.

Dimension	Description or value
aadTenantId	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.
alObjectId	Specifies the ID of the AL object that was run by request.
authenticationStatus	Succeeded
authenticationType	Specifies whether the service uses NavUserPassword or AccessControl authentication.
category	Specifies the service type. Values include: Api, ODataV4, ODataV3, and SOAP.
component	Dynamics 365 Business Central Server
componentVersion	Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys	A comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
endpoint	Specifies the endpoint for the request. Private and sensitive information is omitted from the endpoint.
environmentType	Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId	RT0020 This dimension was introduced in Business Central 2020 release wave 1, version 16.1.
telemetrySchemaVersion	Specifies the version of the Business Central telemetry schema.

Authentication with web service key failed

Occurs when a web service access key failed to authenticate.

General dimensions

The following table explains the general dimensions included in the trace. The table lists the dimensions that are specific to Business Central.

Dimension	Description or value
message	Authentication with Web Service Key failed: {endpoint}
severityLevel	3

Custom dimensions

The following table explains the custom dimensions included in the trace.

Dimension	Description or value
aadTenantId	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.
alObjectId	Specifies the ID of the AL object that was run by request.
authenticationStatus	Failed
authenticationType	Specifies whether the service uses NavUserPassword or AccessControl authentication.
category	Specifies the service type. Values include: Api, ODataV4, ODataV3, and SOAP.
component	Dynamics 365 Business Central Server
componentVersion	Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys	A comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
endpoint	Specifies the endpoint for the request. Private and sensitive information is omitted from the endpoint.
environmentType	Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
eventId	RT0021
failureReason	Specifies the exception that was thrown by the server. Some exception messages can contain customer data. As a precaution, Business Central only emits information that's classified as SystemMetadata. Exception messages that contain other data classifications, like customer data, are not shown. Instead, the following message is shown: "Message not shown because the NavBaseException(string, Exception, bool) constructor was used."
telemetrySchemaVersion	Specifies the version of the Business Central telemetry schema.

Example trace

The following code snippet is a CustomDimensions example:

{"component":"Dynamics 365 Business Central Server","category":"Api","AadTenantId":"common","environmentType":"Production","Component":"Dynamics 365 Business Central Server","AL Object Id":"0","alObjectId":"0","Telemetry schema version":"0.1","telemetrySchemaVersion":"0.1","authenticationType":"NavUserPassword","componentVersion":"17.0.15855.0","Component version":"17.0.15855.0","eventId":"RT0020","endpoint":"BC170/ODataV4/Company()/purchaseDocumentLines","deprecatedKeys":"Company name, AL Object Id, AL Object type, AL Object name, AL Stack trace, Client type, Extension name, Extension App Id, Extension version, Telemetry schema version, Component, Component version, Telemetry schema version, AadTenantId, Environment name, Environment type","aadTenantId":"common","Environment type":"Production","authenticationStatus":"Succeeded"}

See also

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights