---
id: topic/dev-itpro/development/troubleshooting
type: topic
title: Troubleshooting
summary: Troubleshooting for Business Central development covers tools and guides for gathering information, finding causes and fixing problems. It answers questions on client tools, AL debugging and profiling, telemetry setup and analysis, and guides for migration, report and web service errors.
tier: official
language: en
system: development
review:
  state: reviewed
  by: opus
  at: "2026-10-07T21:13:11.948Z"
  flags: []
generated:
  at: "2026-10-08T00:04:31.553Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: bcd5f8e4d25f74f2f63f8c3a10a1523d9058e44c5c53f18b28ae67ef5b3f253d
evidence:
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/telemetry-alert
    title: Alert on Telemetry
    date: "2022-11-17"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-al-profiler-overview
    title: Analyze AL Performance with the AL Profiler
    date: "2026-10-07"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/telemetry-analyze-with-kql
    title: Analyze and monitor telemetry with KQL
    date: "2024-12-19"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/telemetry-power-bi-app
    title: Analyze and monitor telemetry with Power BI
    date: "2024-03-21"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/report-analyze-excel
    title: Analyzing report data with Excel and XML
    date: "2024-09-09"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/telemetry-available-telemetry
    title: Available Telemetry
    date: "2021-07-09"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/ui-personalization-manage
    title: Customizing Pages for Roles
    date: "2024-06-13"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-debugging
    title: Debugging in AL
    date: "2025-08-21"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/ui-define-granular-permissions
    title: Define granular permissions
    date: "2026-03-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-events-discoverability
    title: Events discoverability
    date: "2025-05-21"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/performance/performance-work-perf-problem
    title: How to work with a performance problem
    date: "2026-09-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-inspecting-pages
    title: Inspecting pages
    date: "2026-09-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/across-inspect-page
    title: Inspecting pages in Business Central
    date: "2025-10-16"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/database-missing-indexes
    title: Missing indexes in Business Central databases
    date: "2025-03-21"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/telemetry-overview
    title: Monitoring and Analyzing Telemetry
    date: "2025-06-20"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/performance/performance-developer
    title: Performance Articles for AL Developers
    date: "2026-09-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/performance-profiler-overview
    title: Performance Profiler overview
    date: "2024-08-12"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/ui-personalization-user
    title: Personalize your workspace
    date: "2026-06-17"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/scheduled-performance-profiler-overview
    title: Scheduled performance profiler overview
    date: "2026-08-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-snapshot-debugging
    title: Snapshot debugging
    date: "2026-08-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/migration-troubleshooting
    title: Troubleshooting Cloud Migration
    date: "2025-05-19"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-reports-troubleshoot-printing
    title: Troubleshooting Printing
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-reports-troubleshooting
    title: Troubleshooting reports
    date: "2025-01-28"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/webservices/dynamics-error-codes
    title: Troubleshooting REST API/OData calls
    date: "2024-02-06"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-troubleshooting-the-mobile-app
    title: Troubleshooting the Business Central Mobile App On-Premises
    date: "2026-08-24"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-troubleshooting-overview
    title: Troubleshooting tools and guides overview
    date: "2026-09-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/webservices/web-service-troubleshooting
    title: Troubleshooting web service errors (OData, API, and SOAP)
    date: "2024-01-10"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/administration/telemetry-enable-application-insights
    title: Turn sending telemetry to application insights on or off
    date: "2024-07-23"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-error-dialog
    title: Understanding the error dialog
    date: "2024-01-03"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/admin-view-database-locks
    title: View Database Locks
    date: "2021-06-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/admin-view-table-information
    title: View table information
    date: "2025-02-21"
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-troubleshooting-overview
  objects:
    - object/page/119
    - object/page/8700
    - object/page/8705
    - object/page/8930
    - object/page/9000
    - object/page/9004
    - object/page/9005
    - object/page/9006
    - object/page/9007
    - object/page/9009
    - object/page/9010
    - object/page/9016
    - object/page/9017
    - object/page/9020
    - object/page/9022
    - object/page/9024
    - object/page/9026
    - object/page/9027
    - object/page/9030
    - object/page/9171
    - object/page/9511
    - object/page/9800
    - object/page/9802
    - object/page/9807
    - object/page/9808
    - object/page/9816
    - object/page/9855
    - object/page/9862
    - object/page/9865
    - object/page/9874
    - object/page/9878
    - object/page/9883
  features: []
  topics:
    - topic/dev-itpro/development
    - topic/dev-itpro/development/troubleshooting/troubleshooting-in-the-client
    - topic/dev-itpro/development/troubleshooting/troubleshooting-in-al
    - topic/dev-itpro/development/troubleshooting/troubleshooting-with-telemetry
    - topic/dev-itpro/development/troubleshooting/troubleshooting-guides-tsgs
  localizations: []
  videos: []
  posts: []
  guidelines: []
learn_toc_path:
  - Development
  - Troubleshooting
toc_file: dev-itpro/TOC.md
parent: topic/dev-itpro/development
children:
  - topic/dev-itpro/development/troubleshooting/troubleshooting-in-the-client
  - topic/dev-itpro/development/troubleshooting/troubleshooting-in-al
  - topic/dev-itpro/development/troubleshooting/troubleshooting-with-telemetry
  - topic/dev-itpro/development/troubleshooting/troubleshooting-guides-tsgs
coverage:
  learn: 31
  code: 32
  video: 0
  blog: 0
  guideline: 0
bc_forms:
  - 119
  - 8700
  - 8705
  - 8930
  - 9000
  - 9004
  - 9005
  - 9006
  - 9007
  - 9009
  - 9010
  - 9016
  - 9017
  - 9020
  - 9022
  - 9024
  - 9026
  - 9027
  - 9030
  - 9171
  - 9511
  - 9800
  - 9802
  - 9807
  - 9808
  - 9816
  - 9830
  - 9831
  - 9855
  - 9862
  - 9865
  - 9874
  - 9878
  - 9883
member_hash: 02fb60db8d8be726a1d00cbddbe8c35231a4ebc2840f1e09c617353890f93848
narrative: generated
---

# Troubleshooting

> Troubleshooting for Business Central development covers tools and guides for gathering information, finding causes and fixing problems. It answers questions on client tools, AL debugging and profiling, telemetry setup and analysis, and guides for migration, report and web service errors.

Path: [Development](../development.md) > Troubleshooting · tier official · system development · narrative reviewed (checked by Opus)

## Overview

This section collects the tools and guides used to diagnose Business Central issues. The overview page lists the main tools: error dialog inspection, Page Inspector, Event Recorder, database locks, Performance Profiler and AL Profiler. It also points to snapshot debugging and telemetry.

The subtopics split by where you work. Troubleshooting in the client covers in-product tools, such as inspecting pages, reading error dialogs, viewing locks, finding missing indexes, discovering events, exporting report data and profiling performance. It also covers personalization, permissions and on-premises mobile app issues. Troubleshooting in AL covers the AL debugger, snapshot debugging, the AL Profiler, performance articles and printing problems.

Troubleshooting with telemetry covers sending telemetry to Azure Application Insights, the available events, analysis with KQL and Power BI, alerting and performance diagnosis. The troubleshooting guides (TSGs) give cause-and-fix steps for cloud migration problems, report errors and slow reports, and web service failures (OData, API, SOAP). Start with the overview, then pick the subtopic that matches your situation.

## Key points

- The overview page lists these tools: error dialog inspection, Page Inspector, Event Recorder, database locks, Performance Profiler and AL Profiler. It also points to snapshot debugging and telemetry.
- Client troubleshooting also covers table information, finding missing indexes, exporting report data, personalization, role customization and permissions.
- On-premises mobile app issues are covered under client troubleshooting.
- AL troubleshooting covers the AL debugger, snapshot debugging, the AL Profiler, Page Inspection, performance articles and printer errors.
- Telemetry troubleshooting covers turning on telemetry to Azure Application Insights, the available events, and analysis with KQL and Power BI.
- Telemetry pages also cover alerting and diagnosing performance problems.
- TSGs cover cloud migration problems, report errors and slow performance, and OData, API and SOAP web service failures.
- TSGs explain causes of errors, which telemetry to check and how to fix them.

## Subtopics

- [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md) (13 pages)
- [Troubleshooting in AL](troubleshooting/troubleshooting-in-al.md) (6 pages)
- [Troubleshooting with telemetry](troubleshooting/troubleshooting-with-telemetry.md) (7 pages)
- [Troubleshooting guides (TSGs)](troubleshooting/troubleshooting-guides-tsgs.md) (4 pages)

## More Learn pages

- [Troubleshooting tools and guides overview](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-troubleshooting-overview): An overview of tools and processes that help troubleshoot issues in Business Central.

## Business Central pages and reports

The pages, reports and queries this hub's Learn pages name (ms.search.form, API reference), joined to the code by exact object id (data/index/docs-objects.json); a page shows the table it runs on.

- [Page 119 "User Setup"](../../../objects/page/119.md) · on [Table 91 "User Setup"](../../../objects/table/91.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 8700 "Table Information"](../../../objects/page/8700.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 8705 "Table Information Card"](../../../objects/page/8705.md) · captioned "Index Management" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 8930 "Email View Policy List"](../../../objects/page/8930.md) · captioned "User Email View Policies" · on [Table 8930 "Email View Policy"](../../../objects/table/8930.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9000 "Whse. WMS Role Center"](../../../objects/page/9000.md) · captioned "Shipping and Receiving - Warehouse Management System" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9004 "Bookkeeper Role Center"](../../../objects/page/9004.md) · captioned "Bookkeeper" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9005 "Sales Manager Role Center"](../../../objects/page/9005.md) · captioned "Sales Manager" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9006 "Order Processor Role Center"](../../../objects/page/9006.md) · captioned "Sales Order Processor" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9007 "Purchasing Agent Role Center"](../../../objects/page/9007.md) · captioned "Purchasing Agent" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9009 "Whse. Worker WMS Role Center"](../../../objects/page/9009.md) · captioned "Warehouse Worker - Warehouse Management System" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9010 "Production Planner Role Center"](../../../objects/page/9010.md) · captioned "Manufacturing Manager" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9016 "Service Dispatcher Role Center"](../../../objects/page/9016.md) · captioned "Service Manager" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9017 "Service Technician Role Center"](../../../objects/page/9017.md) · captioned "Outbound Technician - Customer Service" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9020 "Small Business Owner RC"](../../../objects/page/9020.md) · captioned "President - Small Business" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9022 "Business Manager Role Center"](../../../objects/page/9022.md) · captioned "Business Manager" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9024 "Security Admin Role Center"](../../../objects/page/9024.md) · captioned "Administration of users, security groups and permissions" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9026 "Sales & Relationship Mgr. RC"](../../../objects/page/9026.md) · captioned "Sales and Relationship Manager" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9027 "Accountant Role Center"](../../../objects/page/9027.md) · captioned "Accountant" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9030 "Account Manager Activities"](../../../objects/page/9030.md) · captioned "Activities" · on [Table 9054 "Finance Cue"](../../../objects/table/9054.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9171 "Profile List"](../../../objects/page/9171.md) · captioned "Profiles (Roles)" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9511 "Database Locks"](../../../objects/page/9511.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9800 "Users"](../../../objects/page/9800.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9802 "Permission Sets"](../../../objects/page/9802.md) · on [Table 9009 "Permission Set Buffer"](../../../objects/table/9009.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9807 "User Card"](../../../objects/page/9807.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9808 "User Permission Sets"](../../../objects/page/9808.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9816 "Permission Set by User"](../../../objects/page/9816.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9855 "Permission Set"](../../../objects/page/9855.md) · on [Table 9862 "PermissionSet Buffer"](../../../objects/table/9862.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9862 "Expanded Permissions"](../../../objects/page/9862.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9865 "Permission Lookup List"](../../../objects/page/9865.md) · on [Table 9865 "Permission Lookup Buffer"](../../../objects/table/9865.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9874 "Permission Set By Sec. Group"](../../../objects/page/9874.md) · captioned "Permission Set by Security Group" · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9878 "Permission Set Lookup List"](../../../objects/page/9878.md) · captioned "Permission Set Lookup" · on [Table 9862 "PermissionSet Buffer"](../../../objects/table/9862.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)
- [Page 9883 "Permissions Overview"](../../../objects/page/9883.md) · via [Troubleshooting in the client](troubleshooting/troubleshooting-in-the-client.md)

Learn also names 2 objects with no object page: page/9830, page/9831.

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn's own.