--- title: "Using the diagnostics tool to troubleshoot conversions | Nutrient Document Converter" canonical_url: "https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/using-the-diagnostics-tool-to-troubleshoot-conversions/" md_url: "https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/using-the-diagnostics-tool-to-troubleshoot-conversions.md" last_updated: "2026-05-22T14:49:21.607Z" description: "Learn how to use the diagnostics tool to troubleshoot problems with Nutrient Document Converter (formerly Muhimbi PDF Converter)." --- # Using the diagnostics tool to troubleshoot conversions [Nutrient Document Converter for SharePoint On-Premises](https://www.nutrient.io/low-code/try/?product=document-converter&platform=sharepoint&deployment=on-premises) and [Document Converter Services](https://www.nutrient.io/guides/document-converter/document-converter-services.md) both include a diagnostics tool designed for system administrators to troubleshoot issues. While some users run individual or batch conversions with this tool, it’s primarily intended for diagnostic purposes rather than day-to-day production work. The user interface prioritizes function over design. Nutrient Support may ask you to perform specific tests using this tool during issue resolution. To launch it: - Open the taskbar search box. - Type **Diagnostics Tool** and press **Enter**. The tool will launch in a basic interface designed for administrative testing, as shown in the image below. ## How the diagnostics tool works The diagnostics tool communicates with the same Web Services API used by the conversion service and the SharePoint frontend. If a conversion succeeds in the diagnostics tool, it confirms that the conversion service is configured correctly and functioning as expected. ## Operation The tool provides access to most of the object model available through the [Web Services API](https://www.nutrient.io/guides/document-converter/document-converter-services.md). While many options in the interface are self-explanatory, the following features require additional explanation. ### WS Convert tab Use the **WS Convert** tab to select input files or folders and provide optional settings for password-protected files as follows: - **Select a file** — Enter the complete file path in the **Source** field, or click the three dots (...) button to browse and select a file. - **Select a folder** — For operations that require a folder, such as **Convert Folder** or **Merge Folder**, enter the complete folder path in the **Source** field. The three dots (...) button doesn’t support folder selection and only allows selecting individual files. - **Set an open password** — Use the **Open Password** field next to **Source** to enter the password for protected input files — for example, password-secured Microsoft Word documents. This is not the same as the **Open Password** field in the **PDF Security** tab, which applies to the output PDF. ### HTML Conversion tab Use the **HTML Conversion** tab to convert either complete URLs or raw HTML fragments. - By default, the tool converts URLs using the account under which Document Converter Services runs. - If a specific account is required to access the content, you can optionally provide alternate authentication credentials. Only enter a username or password when explicitly instructed by the Nutrient Support Desk. ### WS Configure tab Use the **WS Configure** tab to define how the diagnostics tool interacts with the conversion service by setting the fields below. - **Service URL** — Specify the URL of a remote conversion service if you want the tool to send requests to a remote server. - **Request Configuration** — View the available converter types, including: - Fidelity names - Accepted input types - Supported operation types - Maximum instances beyond defaults - Maximum run duration per operation - **Parallel Conversions** — When converting a folder, the tool sends multiple conversion requests in parallel. Set the number of parallel requests in this section. The service configuration file limits this to a maximum of 15 concurrent operations. This option is useful for performance testing. For more information on the benchmark data, refer to the [official performance metrics](https://www.nutrient.io/blog/official-performance-metrics-for-the-muhimbi-pdf-converter-sharepoint-java-net-php/) blog post. While the performance metric referenced in the linked blog post is based on older data, our document converter continues to deliver exceptional performance and scales efficiently for both increased load (scaling up) and distributed processing (scaling out). We’re preparing to publish updated performance metrics data in the near future. - **Verbose Logging** — Disable diagnostics tool logging when running performance tests to reduce overhead. This setting only affects the diagnostics tool. The internal logging of the Document Converter Services remains active. ### WS Diagnose tab Use the **WS Diagnose** tab to verify the health and readiness of the converters and related services. It includes two actions: - **Request Diagnostics** — Click this button to validate whether each converter and its prerequisites have been installed correctly. This check follows the setup steps in chapter 2 of the administration guide provided as part of the Document Converter download file. If any converter shows **False** under a valid field, refer to the [validating converters and troubleshooting errors](https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/validating-converters-and-troubleshooting-errors.md) guide. - **Request Service Status** — Click this button to display the current status of all converters and operations, including the current and maximum number of allowed parallel operations. ### Reports tab Starting with version 12.2.0, Document Converter logs usage activity within your application or workflow. The **Reports** tab in the diagnostics tool enables you to view and export this data. You can: - View usage directly in the tab. - Export the data to a CSV or PDF file: - Enable the **Output File** option. - Provide a valid file path for the export. For more information, refer to the following guides: - [View usage details — in-tool or CSV export](https://www.nutrient.io/guides/document-converter/document-converter-services/instrumentation/csv-reports.md) - [View usage details — in-tool or PDF export](https://www.nutrient.io/guides/document-converter/document-converter-services/instrumentation/pdf-reports.md) - [Analyze usage with the Document Converter Services API](https://www.nutrient.io/guides/document-converter/document-converter-services/instrumentation/analyze-usage-with-api.md) - [Generate PDF usage reports with the Document Converter Services API](https://www.nutrient.io/guides/document-converter/document-converter-services/instrumentation/generate-pdf-usage-reports-with-api.md) ## Rebranding Muhimbi, Aquaforest, ORPALIS, PSPDFKit, and Integrify have rebranded under Nutrient to support a unified product vision. As part of this change, product names and branding are evolving to reflect a cohesive suite of solutions. During the transition period, you may encounter documentation that refers to both Muhimbi PDF Converter and Nutrient Document Converter. These names refer to the same product. --- ## Related pages - [How to check if a SharePoint server runs workflows](/guides/document-converter/sharepoint/troubleshooting/determining-if-a-server-is-involved-in-executing-workflows.md) - [Debugging Web Service calls and Soap Messages](/guides/document-converter/sharepoint/troubleshooting/debugging-web-service-calls-and-soap-messages.md) - [Converting IRM and DRM protected documents seamlessly](/guides/document-converter/sharepoint/troubleshooting/dealing-with-the-conversion-of-irm-drm-rms-aip-protected-documents.md) - [Converting HTML - Empty page / Authentication problems](/guides/document-converter/sharepoint/troubleshooting/converting-html-web-pages-returns-an-empty-pdf.md) - [CabLib Extract ERROR when converting InfoPath files](/guides/document-converter/sharepoint/troubleshooting/cablib-extract-error-when-converting-infopath-files.md) - [Adjusting document file size limits easily](/guides/document-converter/sharepoint/troubleshooting/how-can-i-change-the-maximum-file-size-of-documents-to-process.md) - [How to Disable Incremental Updates When Watermarking?](/guides/document-converter/sharepoint/troubleshooting/disable-incremental-update-when-watermarking.md) - [Troubleshooting error 1001 in SharePoint upgrades](/guides/document-converter/sharepoint/troubleshooting/error-1001-an-exception-occurred-in-the-onafterinstall-event-handler-during-upgrade.md) - [Enable Custom App Authentication](/guides/document-converter/sharepoint/troubleshooting/enable-custom-app-authentication.md) - [Troubleshoot PDF merging issues and solutions](/guides/document-converter/sharepoint/troubleshooting/error-while-merging-existing-pdf-files-e-g-pdflexer-errors.md) - [How do I manually remove the Conversion Service?](/guides/document-converter/sharepoint/troubleshooting/how-do-i-manually-remove-the-conversion-service.md) - [How do I enable debug logging?](/guides/document-converter/sharepoint/troubleshooting/how-do-i-enable-debug-logging.md) - [Troubleshooting InfoPath view-related errors](/guides/document-converter/sharepoint/troubleshooting/infopath-cannot-execute-any-view-related-object-model-calls-the-view-is-not-ready.md) - [Troubleshooting: SharePoint Document Converter](/guides/document-converter/sharepoint/troubleshooting.md) - [Understanding InfoPath document conversion processes](/guides/document-converter/sharepoint/troubleshooting/infopath-rules-custom-code-data-connections-are-not-executed.md) - [Invalid digital signature during installation](/guides/document-converter/sharepoint/troubleshooting/invalid-digital-signature-during-installation.md) - [Check your Document Converter version easily](/guides/document-converter/sharepoint/troubleshooting/how-to-determine-which-version-of-the-pdf-converter-is-installed.md) - [Document Converter front-end WSP is stuck on 'Deploying](/guides/document-converter/sharepoint/troubleshooting/pdf-converter-front-end-wsp-is-stuck-on-deploying.md) - [Differences between SharePoint Online and on-premises Document Converter](/guides/document-converter/sharepoint/troubleshooting/how-does-the-pdf-converter-for-sharepoint-online-differ-from-the-on-premise-product.md) - [Troubleshooting InfoPath form conversion issues](/guides/document-converter/sharepoint/troubleshooting/my-infopath-form-fails-to-convert-how-can-i-troubleshoot-this.md) - [Troubleshooting SharePoint Online menu visibility issues](/guides/document-converter/sharepoint/troubleshooting/some-menu-options-are-not-displayed-in-sharepoint-online.md) - [Troubleshooting PDF workflow issues in SharePoint](/guides/document-converter/sharepoint/troubleshooting/pdf-workflow-activities-are-not-displayed-in-sharepoint-designer-2013.md) - [Troubleshoot evaluation message in SharePoint](/guides/document-converter/sharepoint/troubleshooting/the-license-has-been-installed-but-an-evaluation-message-is-still-displayed.md) - [The Conversion Service does not start](/guides/document-converter/sharepoint/troubleshooting/the-conversion-service-does-not-start.md) - [Troubleshoot SharePoint Designer workflow issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-designer-workflow-activities-are-not-inserted.md) - [Troubleshooting SharePoint document converter issues](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-connectivity-problems-between-web-front-end-and-conversion-servers.md) - [Troubleshooting Document Converter login issues](/guides/document-converter/sharepoint/troubleshooting/problems-logging-in-to-pdf-converter-services-online.md) - [Fixing SharePoint search for HTML-to-PDF conversion](/guides/document-converter/sharepoint/troubleshooting/sharepoint-search-does-not-return-converted-html-content.md) - [Solving formatting issues when converting HTML to PDF](/guides/document-converter/sharepoint/troubleshooting/solving-formatting-issues-when-converting-html-to-pdf.md) - [Troubleshooting install.cmd errors](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-install-cmd-errors.md) - [Convert InfoPath forms to Word and Excel easily](/guides/document-converter/sharepoint/troubleshooting/when-converting-infopath-to-word-excel-my-file-does-not-look-100-the-same.md) - [Troubleshooting SharePoint Document Converter issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-behaves-unexpectedly-after-deploying-the-pdf-converter-for-sharepoint.md) - [Troubleshooting document converter issues on SharePoint](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-the-pdf-converter-for-sharepoint-online.md) - [Tips for pixel-perfect InfoPath-to-PDF conversion](/guides/document-converter/sharepoint/troubleshooting/when-converting-infopath-to-pdf-my-file-does-not-look-100-the-same.md) - [Where can I enable Web Application Scoped SharePoint Features?](/guides/document-converter/sharepoint/troubleshooting/where-can-i-enable-web-application-scoped-sharepoint-features.md) - [Validating converters and troubleshooting errors](/guides/document-converter/sharepoint/troubleshooting/validating-converters-and-troubleshooting-errors.md) - [Watermarker fails to load because Microsoft now enforces Content Security Policy (CSP)](/guides/document-converter/sharepoint/troubleshooting/watermarker-blocked-by-microsoft-csp.md) - [Why are my watermarks not visible?](/guides/document-converter/sharepoint/troubleshooting/why-are-my-watermarks-not-visible.md) - [Find the Document Converter administration screen](/guides/document-converter/sharepoint/troubleshooting/where-is-the-pdf-converter-s-central-administration-screen-located.md) - [Why are my legacy DOC and XLS files failing to convert?](/guides/document-converter/sharepoint/troubleshooting/why-are-my-legacy-doc-and-xls-files-failing-to-convert.md) - [Understanding duplicate PDF conversion options in SharePoint](/guides/document-converter/sharepoint/troubleshooting/why-are-the-various-pdf-conversion-options-displayed-twice-in-sharepoint.md)