# Troubleshooting tools and guides 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 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<https://learn.microsoft.com/troubleshoot/dynamics-365/business-central/welcome-business-central>
  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<devenv-error-dialog>
 Investigate page data and filters with the /across-inspect-page.
 See if the events you rely on are fired as expected with the Event Recorder<devenv-events-discoverability>
 Check for unexpected table sizes with /admin-view-table-information
 Find locks with /admin-view-database-locks
 Identity whether there are Missing indexes/keys<../administration/database-missing-indexes>
 Analyze database bottlenecks with https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration\database-wait-statistics
 Identify performance issues with the ../administration/performance-profiler-overview
 Verify report dataset with Save report dataset to Excel</report-analyze-excel>
 Check personalization issues with Personalized pages</ui-personalization-user>
 Resolve user personalization issues with Troubleshooting user personalization can't be started<https://learn.microsoft.com/troubleshoot/dynamics-365/business-central/client/client-user-personalization> in Microsoft troubleshooting documentation.
 Check customization issues with Customized pages</ui-personalization-manage>
 Resolve profile configuration issues with Troubleshooting profile configuration can't be started<https://learn.microsoft.com/troubleshoot/dynamics-365/business-central/client/client-profile-configuration> in Microsoft troubleshooting documentation
 Verify user permissions with Effective permissions</ui-define-granular-permissions>
 Investigate issues with Mobile app on-premises<devenv-troubleshooting-the-mobile-app>
 Investigate issues with Troubleshoot in Visual Studio Code directly from the web client<devenv-troubleshoot-vscode-webclient>.
## 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<devenv-debugging> in sandboxes with customer data
 Capture snapshots<devenv-snapshot-debugging> in production environments and debug offline
 Find AL performance issues with the devenv-al-profiler-overview in Visual Studio Code
 Investigate Printer and report payloads<devenv-reports-troubleshoot-printing> when working with reporting
 Inspecting and troubleshooting pages<devenv-inspecting-pages> to help identify data issues
 Identifying and working with Performance issues<../performance/performance-overview>
 Investigate and troubleshoot from the web client with Troubleshoot in Visual Studio Code directly from the web client<devenv-troubleshoot-vscode-webclient>.
## 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</product-help-and-support#troubleshooting>
 Enable telemetry and query telemetry data in Azure Application Insights<../administration/telemetry-overview>
 Find telemetry data on the type of issue you're troubleshooting in ../administration/telemetry-available-telemetry
 Use ../administration/telemetry-power-bi-app to analyze errors and performance issues
 Use ../administration/telemetry-analyze-with-kql to analyze errors and performance issues
 Use telemetry to investigate performance issues<../performance/performance-work-perf-problem>
## 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)<../administration/migration-troubleshooting>
 Troubleshoot cloud migration (setup and data replication)<https://learn.microsoft.com/troubleshoot/dynamics-365/business-central/welcome-business-central> in Microsoft troubleshooting documentation.
Performance:
 ../performance/performance-overview
 ../performance/performance-work-perf-problem
Reports and printing:
 Troubleshoot printer errors<devenv-reports-troubleshoot-printing>
 Troubleshoot report errors<devenv-reports-troubleshooting>
Shopify integration
 Troubleshoot the Shopify connector</shopify/troubleshoot>
Web services:
 Troubleshoot web service errors<../webservices/web-service-troubleshooting>
 Troubleshooting OData calls<../webservices/dynamics-error-codes>
 Troubleshooting API calls<../webservices/dynamics-error-codes>
Edit in Excel:
 Troubleshoot Edit In Excel</admin-deploy-excel-addin#known-limitations-in-metadata-generation>

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/developer/devenv-troubleshooting-overview, 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. https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-troubleshooting-overview/
