Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 doesn't 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 with debugging in sandboxes, or snapshot debugging in production environments, to pinpoint the cause of a specific issue. To investigate and troubleshoot issues after they occur, use telemetry and its related tools.
Troubleshooting articles
For a large collection of troubleshooting articles, see the following site provided by Microsoft Support:
Microsoft Dynamics 365 Business Central troubleshooting
These articles explain how to check, diagnose, and fix issues that you might encounter when using Business Central. The articles are organized by feature area, and each article focuses on a specific issue and its solution.
Troubleshooting in the client
These tools in the Business Central client help you understand 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
- Resolve user personalization issues with Troubleshooting user personalization can't be started in Microsoft troubleshooting documentation.
- Check customization issues with Customized pages
- Resolve profile configuration issues with Troubleshooting profile configuration can't be started in Microsoft troubleshooting documentation
- 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 with debugging in sandboxes, or snapshot debugging in production environments to pinpoint the cause of 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 more 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're 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
Besides the troubleshooting tools described above, these articles explain how to troubleshoot different areas and features in Business Central.
Cloud migration:
- Troubleshoot cloud migration (overview)
- Troubleshoot cloud migration (setup and data replication) in Microsoft troubleshooting documentation.
Performance:
Reports and printing:
Shopify integration
Web services:
Edit in Excel: