Troubleshooting overview

The following sections help you troubleshoot issues with Business Central so that you can gather information about a given problem, identify the cause of the problem, and eventually implement a sustainable solution that does not introduce new issues. Use the tools provided in the Business Central client to gain insights on trends in application behavior, identify performance issues, database locks, and more. Use profiling combined with debugging in sandboxes, or snapshot debugging in production environments to pinpoint what causes a specific issue. And if you want to investigate and troubleshooting things after they happened, then use telemetry and the tools around that feature.

Troubleshooting in the client

These tools provided in the Business Central client can help you gain insights on trends in application behavior, identify performance issues, database locks, and more.

• Investigate root causes for errors with Copy details in the error dialog
• Investigate page data, filters, and load times with the Page Inspector
• See if the events you rely on are fired as expected with the Event Recorder
• Check for unexpected table sizes with Tables Information
• Find locks with Database Locks
• Identity whether there are Missing indexes/Keys
• Analyze database bottlenecks with Database wait statistics
• Identify performance issues with the Performance Profiler
• Verify report dataset with Save Report Dataset to Excel
• Check personalization issues with Personalized Pages
• Mitigate can't start user personalization issues with Troubleshooting user personalization can't be started
• Check customization issues with Customized Pages
• Mitigate can't start profile configuration issues with Troubleshooting profile configuration can't be started
• Verify user permissions with Effective Permissions
• Investigate issues with Mobile App On-Premises
• Investigate issues with Troubleshoot in Visual Studio Code directly from the web client.

Troubleshooting in AL

Use profiling combined with debugging in sandboxes, or snapshot debugging in production environments to pinpoint what causes a specific issue.

• Debug AL code in sandboxes with customer data
• Capture Snapshots in production environments and debug offline
• Find AL performance issues with the AL Profiler in Visual Studio Code
• Investigate Printer and Report Payloads when working with reporting
• Inspecting and Troubleshooting Pages to help identify data issues
• Identifying and working with Performance Issues
• Investigate and troubleshoot from the web client with Troubleshoot in Visual Studio Code directly from the web client.

Troubleshooting with telemetry

Telemetry can be used for troubleshooting things after they happened and it is possible to analyze patterns across sessions.

• Ask the user to enable additional logging, see Resources for Help and Support - Troubleshooting
• Enable telemetry and query telemetry data in Azure Application Insights
• Find telemetry data on the type of issue you are troubleshooting in Available telemetry
• Use Power BI to analyze errors and performance issues
• Use KQL to analyze errors and performance issues
• Use telemetry to investigate Performance Issues

Troubleshooting guides (TSGs)

Apart from the troubleshooting tools described above, the following articles describe ways to troubleshoot various areas and features in Business Central.

Cloud migration:

• Troubleshoot cloud migration (overview)
• Troubleshoot cloud migration (setup)
• Troubleshoot cloud migration (data replication)

Performance:

• Performance overview
• How to work with a performance problem

Reports and printing:

• Troubleshoot printer errors
• Troubleshoot report errors

Shopify integration

• Troubleshoot the Shopify connector

Web services:

• Troubleshoot web service errors
• Troubleshooting OData calls
• Troubleshooting API calls