{"title":"Web service telemetry in Business Central","url":"https://jonas-paprotka.de/docs/dev-itpro/webservices/web-service-telemetry/","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/webservices/web-service-telemetry, 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/webservices/web-service-telemetry","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":"Monitor Business Central web service requests with telemetry to analyze endpoint usage, HTTP failures, access key authentication, and publishing errors.","date":"2026-11-17","meta":{"topic":"article"},"outline":[{"level":1,"title":"Web service telemetry in Business Central","slug":"web-service-telemetry-in-business-central","at":0,"chars":3029},{"level":2,"title":"Incoming web service telemetry","slug":"incoming-web-service-telemetry","at":354,"chars":955},{"level":2,"title":"Web service access key telemetry","slug":"web-service-access-key-telemetry","at":1309,"chars":862},{"level":2,"title":"Web service publish failure telemetry","slug":"web-service-publish-failure-telemetry","at":2171,"chars":493},{"level":2,"title":"Related information","slug":"related-information","at":2664,"chars":365}],"text":"# Web service telemetry in Business Central\nWhen telemetry is enabled, Business Central logs web service calls to partner telemetry. Telemetry enables you to monitor which endpoints are being used and the category of the web service, like SOAP, OData, or API. You can also see possible failures, which are tracked in the HTTP status codes for the calls.\n## Incoming web service telemetry\nWeb services telemetry gathers data about SOAP, OData, and API requests through the service. It provides information like the request's endpoint, time to complete, the SQL statements run, and more.\nWhen calling Business Central web services, you can inject information about the caller into telemetry for REST API and OData calls.\n Setting the HTTP header _UserAgent_ logs requests with the httpHeaders dimension.\n Setting the HTTP header _client-request-id_, logs requests with the httpHeaders dimension and it also sets the \"OperationId\"/ClientActivity in Application Insights.\nThis capability means you can use telemetry to see who's calling Business Central REST APIs and OData web services. It also lets you correlate to telemetry from other web services, if you use Azure Application Insights to instrument them.\nSee Analyzing Incoming Web Services Request Telemetry<../administration/telemetry-webservices-trace>.\n## Web service access key telemetry\nBusiness Central emits telemetry data about the success or failure of authenticating web service access keys on web service requests.\n> IMPORTANT\n> Starting October, 2022, the use of access keys (Basic Auth) for web service authentication is deprecated and not supported<../upgrade/deprecated-features-platform#accesskeys> in Business Central online. We recommend that you use OAuth2 instead. See Using OAuth to Authorize Business Central Web Services<authenticate-web-services-using-oauth>.\nAs a partner or customer, this data lets you monitor legacy web service access key use in on-premises environments and plan migration to OAuth authentication. Web service access keys aren't supported in Business Central online.\nSee Analyzing Web Service Access Key Telemetry<../administration/telemetry-webservices-access-key-trace>.\n## Web service publish failure telemetry\nIf a web service couldn't be published or a published web service isn't working, most often it's due to an error in creating metadata for the web service. When telemetry is enabled, metadata creation failures are available in partner telemetry, along with a stack trace of the element responsible for breaking the web service metadata.\nSee Analyzing Web Service Publish Failure Telemetry<../administration/telemetry-webservices-publish-failure-trace>.\n## Related information\nWeb Services Overview<web-services>\nweb-services-best-practices\nAnalyzing Incoming Web Services Request Telemetry<../administration/telemetry-webservices-trace>\nAnalyzing Web Service Access Key Telemetry<../administration/telemetry-webservices-access-key-trace>\nConfiguring Business Central Server<../administration/configure-server-instance>"}