{"title":"Troubleshooting tools and guides overview","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-troubleshooting-overview/","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/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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-troubleshooting-overview","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":"An overview of tools and processes that help troubleshoot issues in Business Central.","date":"2026-09-18","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Troubleshooting tools and guides overview","slug":"troubleshooting-tools-and-guides-overview","at":0,"chars":5885},{"level":2,"title":"Troubleshooting articles","slug":"troubleshooting-articles","at":685,"chars":513},{"level":2,"title":"Troubleshooting in the client","slug":"troubleshooting-in-the-client","at":1198,"chars":1920},{"level":2,"title":"Troubleshooting in AL","slug":"troubleshooting-in-al","at":3118,"chars":846},{"level":2,"title":"Troubleshooting with telemetry","slug":"troubleshooting-with-telemetry","at":3964,"chars":793},{"level":2,"title":"Troubleshooting guides","slug":"troubleshooting-guides","at":4757,"chars":1128}],"text":"# Troubleshooting tools and guides overview\nThe 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.\nUse 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.\n## Troubleshooting articles\nFor a large collection of troubleshooting articles, see the following site provided by Microsoft Support:\n Microsoft Dynamics 365 Business Central troubleshooting<https://learn.microsoft.com/troubleshoot/dynamics-365/business-central/welcome-business-central>\n  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.\n## Troubleshooting in the client\nThese tools in the Business Central client help you understand trends in application behavior, identify performance issues, database locks, and more.\n Investigate root causes for errors with Copy details in the error dialog<devenv-error-dialog>\n Investigate page data and filters with the /across-inspect-page.\n See if the events you rely on are fired as expected with the Event Recorder<devenv-events-discoverability>\n Check for unexpected table sizes with /admin-view-table-information\n Find locks with /admin-view-database-locks\n Identity whether there are Missing indexes/keys<../administration/database-missing-indexes>\n Analyze database bottlenecks with https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration\\database-wait-statistics\n Identify performance issues with the ../administration/performance-profiler-overview\n Verify report dataset with Save report dataset to Excel</report-analyze-excel>\n Check personalization issues with Personalized pages</ui-personalization-user>\n 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.\n Check customization issues with Customized pages</ui-personalization-manage>\n 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\n Verify user permissions with Effective permissions</ui-define-granular-permissions>\n Investigate issues with Mobile app on-premises<devenv-troubleshooting-the-mobile-app>\n Investigate issues with Troubleshoot in Visual Studio Code directly from the web client<devenv-troubleshoot-vscode-webclient>.\n## Troubleshooting in AL\nUse profiling with debugging in sandboxes, or snapshot debugging in production environments to pinpoint the cause of a specific issue.\n Debug AL code<devenv-debugging> in sandboxes with customer data\n Capture snapshots<devenv-snapshot-debugging> in production environments and debug offline\n Find AL performance issues with the devenv-al-profiler-overview in Visual Studio Code\n Investigate Printer and report payloads<devenv-reports-troubleshoot-printing> when working with reporting\n Inspecting and troubleshooting pages<devenv-inspecting-pages> to help identify data issues\n Identifying and working with Performance issues<../performance/performance-overview>\n Investigate and troubleshoot from the web client with Troubleshoot in Visual Studio Code directly from the web client<devenv-troubleshoot-vscode-webclient>.\n## Troubleshooting with telemetry\nTelemetry can be used for troubleshooting things after they happened and it is possible to analyze patterns across sessions.\n Ask the user to enable more logging. See Resources for Help and Support - troubleshooting</product-help-and-support#troubleshooting>\n Enable telemetry and query telemetry data in Azure Application Insights<../administration/telemetry-overview>\n Find telemetry data on the type of issue you're troubleshooting in ../administration/telemetry-available-telemetry\n Use ../administration/telemetry-power-bi-app to analyze errors and performance issues\n Use ../administration/telemetry-analyze-with-kql to analyze errors and performance issues\n Use telemetry to investigate performance issues<../performance/performance-work-perf-problem>\n## Troubleshooting guides\nBesides the troubleshooting tools described above, these articles explain how to troubleshoot different areas and features in Business Central.\nCloud migration:\n Troubleshoot cloud migration (overview)<../administration/migration-troubleshooting>\n Troubleshoot cloud migration (setup and data replication)<https://learn.microsoft.com/troubleshoot/dynamics-365/business-central/welcome-business-central> in Microsoft troubleshooting documentation.\nPerformance:\n ../performance/performance-overview\n ../performance/performance-work-perf-problem\nReports and printing:\n Troubleshoot printer errors<devenv-reports-troubleshoot-printing>\n Troubleshoot report errors<devenv-reports-troubleshooting>\nShopify integration\n Troubleshoot the Shopify connector</shopify/troubleshoot>\nWeb services:\n Troubleshoot web service errors<../webservices/web-service-troubleshooting>\n Troubleshooting OData calls<../webservices/dynamics-error-codes>\n Troubleshooting API calls<../webservices/dynamics-error-codes>\nEdit in Excel:\n Troubleshoot Edit In Excel</admin-deploy-excel-addin#known-limitations-in-metadata-generation>"}