Troubleshooting guides (TSGs)
Troubleshooting guides (TSGs) for Business Central development and administration. They cover cloud migration problems, report errors and slow performance, and web service failures (OData, API, SOAP). Use them for questions about causes of errors, telemetry to check, and fixes.
Path: Development > Troubleshooting > Troubleshooting guides (TSGs) · tier official · system development · narrative reviewed (checked by Opus)
Overview
The TSGs are task-focused guides for diagnosing specific problems in Business Central. Each guide describes symptoms, the likely causes, and how to find the root cause, often with telemetry and debugging tools.
Two guides sit directly in this section. Troubleshooting Cloud Migration covers database compatibility, change tracking, user permissions, Integration Runtime setup, version requirements and common data problems. Troubleshooting reports covers analyzing report telemetry, finding the cause of report errors or slow performance, and resolving common reporting exceptions.
A subtopic, Troubleshoot web services, has two pages on OData, API and SOAP calls. It covers HTTP status codes, OData error codes and how AL runtime exceptions map to OData errors. Start with the guide that matches your problem area, then follow its telemetry and debugging advice.
Key points
- Cloud migration guide covers SQL Server compatibility, change tracking, and Integration Runtime setup.
- Cloud migration guide also covers migration user permissions, company name validation, and the tenant media table, with notes for versions 23, 24 and 25.
- Reports guide covers report limits, report telemetry, and performance analysis.
- Reports guide addresses both RDL layouts and Excel/Word layouts, and how to debug report issues.
- Web services troubleshooting covers failed OData, API and SOAP calls and their HTTP status codes.
- Web services pages explain OData error codes and how AL runtime exceptions map to them.
- Telemetry is a recurring tool for finding root causes in the reports and web services guides.
Subtopics
- Troubleshoot web services (2 pages)
More Learn pages
- Troubleshooting Cloud Migration: Learn how to troubleshoot problems that you might experience with the cloud migration to Business Central online from on-premises.
- Troubleshooting reports: Learn about how to troubleshoot Business Central reports
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.