---
title: "How do I enable debug logging? | Nutrient Integrations"
canonical_url: "https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/how-do-i-enable-debug-logging/"
md_url: "https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/how-do-i-enable-debug-logging.md"
last_updated: "2026-07-04T17:28:32.809Z"
description: "Learn how to enable debug logging."
---

# How do I enable debug logging?

The Document Converter uses the industry standard log4net framework to write various levels of logging information to a log file as well as the Windows Application Event Log.

By default this information is logged to the _DocumentConverter.log_ file stored in the directory the Document Conversion service has been installed in. A new file is created for each day and the default logging level is set to ‘INFO’.

Warnings and Errors are also written to the Windows Event Log.

You may want to consider changing the following settings:

- **Log file location:** change the path of the log file name in the _appender_ element to a location of your preference.

- **Log Level:** By default only ‘INFO’ and critical events are logged. To get a better view of what the service is doing, e.g. during a debug session, you may want to consider switching the <root> log level to DEBUG mode.

In the example below we will switch the logging level to _Debug_.

Open your Muhimbi Service’s config file ( [as described here](/guides/document-converter/sharepoint/knowledge-base/how-to-edit-the-conversion-service-s-configuration-file.md)) and change the following from

```xml

<root>
 <level value="INFO" />
 <appender-ref ref="RollingLogFileAppender" />
 <appender-ref ref="EventLogAppender" />
 </root>

```

To

```xml

<root>
 <level value="Debug" />
 <appender-ref ref="RollingLogFileAppender" />
 <appender-ref ref="EventLogAppender" />
 </root>

```

And restart the Muhimbi Service.

More information can be found on the&nbsp;[Apache log4net site](http://logging.apache.org/log4net/index.html).

---

## Related pages

- [Troubleshooting: SharePoint Document Converter](/guides/document-converter/sharepoint/troubleshooting.md)
- [CabLib Extract ERROR when converting InfoPath files](/guides/document-converter/sharepoint/troubleshooting/cablib-extract-error-when-converting-infopath-files.md)
- [Converting HTML - Empty page / Authentication problems](/guides/document-converter/sharepoint/troubleshooting/converting-html-web-pages-returns-an-empty-pdf.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)
- [Debugging Web Service calls and Soap Messages](/guides/document-converter/sharepoint/troubleshooting/debugging-web-service-calls-and-soap-messages.md)
- [How to check if a SharePoint server runs workflows](/guides/document-converter/sharepoint/troubleshooting/determining-if-a-server-is-involved-in-executing-workflows.md)
- [How to Disable Incremental Updates When Watermarking?](/guides/document-converter/sharepoint/troubleshooting/disable-incremental-update-when-watermarking.md)
- [Enable Custom App Authentication](/guides/document-converter/sharepoint/troubleshooting/enable-custom-app-authentication.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)
- [Troubleshoot PDF merging issues and solutions](/guides/document-converter/sharepoint/troubleshooting/error-while-merging-existing-pdf-files-e-g-pdflexer-errors.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 do I manually remove the Conversion Service?](/guides/document-converter/sharepoint/troubleshooting/how-do-i-manually-remove-the-conversion-service.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)
- [Check your Document Converter version easily](/guides/document-converter/sharepoint/troubleshooting/how-to-determine-which-version-of-the-pdf-converter-is-installed.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)
- [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)
- [Troubleshooting InfoPath form conversion issues](/guides/document-converter/sharepoint/troubleshooting/my-infopath-form-fails-to-convert-how-can-i-troubleshoot-this.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)
- [Troubleshooting PDF workflow issues in SharePoint](/guides/document-converter/sharepoint/troubleshooting/pdf-workflow-activities-are-not-displayed-in-sharepoint-designer-2013.md)
- [Troubleshooting Document Converter login issues](/guides/document-converter/sharepoint/troubleshooting/problems-logging-in-to-pdf-converter-services-online.md)
- [Troubleshooting SharePoint Document Converter issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-behaves-unexpectedly-after-deploying-the-pdf-converter-for-sharepoint.md)
- [Troubleshoot SharePoint Designer workflow issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-designer-workflow-activities-are-not-inserted.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 SharePoint Online menu visibility issues](/guides/document-converter/sharepoint/troubleshooting/some-menu-options-are-not-displayed-in-sharepoint-online.md)
- [The Conversion Service does not start](/guides/document-converter/sharepoint/troubleshooting/the-conversion-service-does-not-start.md)
- [Troubleshoot evaluation message in SharePoint](/guides/document-converter/sharepoint/troubleshooting/the-license-has-been-installed-but-an-evaluation-message-is-still-displayed.md)
- [Troubleshooting SharePoint document converter issues](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-connectivity-problems-between-web-front-end-and-conversion-servers.md)
- [Troubleshooting install.cmd errors](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-install-cmd-errors.md)
- [Troubleshooting document converter issues on SharePoint](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-the-pdf-converter-for-sharepoint-online.md)
- [Using the diagnostics tool to troubleshoot conversions](/guides/document-converter/sharepoint/troubleshooting/using-the-diagnostics-tool-to-troubleshoot-conversions.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)
- [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)
- [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)
- [Where can I enable Web Application Scoped SharePoint Features?](/guides/document-converter/sharepoint/troubleshooting/where-can-i-enable-web-application-scoped-sharepoint-features.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)
- [Why are my watermarks not visible?](/guides/document-converter/sharepoint/troubleshooting/why-are-my-watermarks-not-visible.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)