---
title: "Debugging Web Service calls and Soap Messages | Nutrient SDK"
canonical_url: "https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/debugging-web-service-calls-and-soap-messages/"
md_url: "https://www.nutrient.io/guides/document-converter/sharepoint/troubleshooting/debugging-web-service-calls-and-soap-messages.md"
last_updated: "2026-05-23T00:08:18.031Z"
description: "Learn how to debug Web Service calls and Soap Messages."
---

# Debugging Web Service calls and Soap Messages

The Muhimbi Conversion Service is a Windows Service based on the Microsoft Windows Communication Foundation (WCF) framework. This comprehensive framework is used to expose a standards based Web Services interface that can be consumed by many different platforms including.NET, Java, PHP, SAP, Documentum and many others.

Even though WCF Web Services are standards based, standards are not interpreted the same by everyone so from time to time you may need to do some troubleshooting when programming against  the [Document Converter Web Service](https://www.nutrient.io/guides/document-converter/document-converter-services.md), especially from non-Microsoft platforms.

Fortunately WCF comes with extensive tracing and logging facilities that can be used to log exactly what is going on during a Web Service call, including the logging of SOAP messages, which is particularly useful.

You can enable WCF logging as follows. Please revert  these settings when you are done as the log files will grow very quickly.

1. Open the Conversion Service's config file in notepad. It is located in the folder the software has been deployed to, there is a handy shortcut to this folder in the Windows Start menu. The config file is named 'Muhimbi.DocumentConverter.Service.exe.config'.

2. Just before the '</configuration>' element add the following. Update the location of the log file (in red) if needed:

3. ```

   <system.diagnostics>
    <sources>
     <source name="System.IdentityModel"
             switchValue="Verbose"
             logKnownPii="true">
      <listeners>
       <add name="xml" />
      </listeners>
     </source>
     <!-- Log all messages in the 'Messages' tab of SvcTraceViewer. -->

     <source name="System.ServiceModel.MessageLogging">
      <listeners>
       <add name="xml" />
      </listeners>
     </source>
     <!-- ActivityTracing and propogateActivity are used to flesh out the
          'Activities' tab in SvcTraceViewer to aid debugging. -->

     <source name="System.ServiceModel"
             switchValue="Error, ActivityTracing"
             propagateActivity="true">
      <listeners>
       <add name="xml" />
      </listeners>
     </source>
     <!-- This records Microsoft.IdentityModel generated traces, including
          exceptions thrown from the framework. -->

     <source name="Microsoft.IdentityModel" switchValue="Warning">
      <listeners>
       <add name="xml" />
      </listeners>
     </source>
    </sources>
    <sharedListeners>
     <add name="xml"
          type="System.Diagnostics.XmlWriterTraceListener"
          initializeData="C:\trace.svclog" />
    </sharedListeners>
    <trace autoflush="true" />
   </system.diagnostics>
   ```

4. In the '<system.serviceModel>' element add the following:

5. ```

   <diagnostics>
    <!-- log all messages sent/received at the transport/service model level -->

    <messageLogging logEntireMessage="true"
                    maxMessagesToLog="1000"
                    maxSizeOfMessageToLog="69905067"
                    logMessagesAtServiceLevel="true"
                    logMalformedMessages="true"
                    logMessagesAtTransportLevel="true" />
   </diagnostics>
   ```

6. Save the config file and restart the _Muhimbi Document Converter Service_.

7. Make a single Web Service call to log all information to the Trace Log. You may want to log the same operation using the Diagnostics Tool that ships with our Document Converter, also available in the Windows Start menu. You can then verify the SOAP message logged by your software with the message logged by our software.

8. Open the log file (C:\trace.svclog) in SvcTraceViewer.exe. If already installed on your system then double clicking the log file should open it. If the viewer is not installed then download the [Windows SDK](http://www.microsoft.com/en-us/download/details.aspx?id=8279)&nbsp;(You only need to install _.NET Development / Tools)_.

9. In the _Trace Viewer_ navigate to the first ' _Process action..._' activity and select the _Message Log Trace_ option followed by the _Message_ tab. Alternatively click on the top level _Message_ tab to display all messages. (Switch to the 'Message View' by subsequently clicking the _Message_ tab in the bottom-right pane).

If the difference between your request and the request made by the Muhimbi Diagnostics tool is not immediately clear then you can use a [free 'Diff' tool](http://www.sourcegear.com/diffmerge/index.html) to compare two Soap Messages (not the entire trace file) and highlight the differences. Depending on your Web Services framework you may want to rename the namespaces in one of the messages so it matches the other's as this reduces the number of differences highlighted.(e.g. replace all "<ns1:" & "</ns1:" references with "<a:" & "</a:").

For more details about WCF logging see the [MSDN Website](http://msdn.microsoft.com/en-us/library/ms730064\(v=vs.85\).aspx).

---

## Related pages

- [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)
- [Enable Custom App Authentication](/guides/document-converter/sharepoint/troubleshooting/enable-custom-app-authentication.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)
- [Troubleshooting error 1001 in SharePoint upgrades](/guides/document-converter/sharepoint/troubleshooting/error-1001-an-exception-occurred-in-the-onafterinstall-event-handler-during-upgrade.md)
- [Check your Document Converter version easily](/guides/document-converter/sharepoint/troubleshooting/how-to-determine-which-version-of-the-pdf-converter-is-installed.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)
- [How do I enable debug logging?](/guides/document-converter/sharepoint/troubleshooting/how-do-i-enable-debug-logging.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)
- [Understanding InfoPath document conversion processes](/guides/document-converter/sharepoint/troubleshooting/infopath-rules-custom-code-data-connections-are-not-executed.md)
- [Troubleshooting: SharePoint Document Converter](/guides/document-converter/sharepoint/troubleshooting.md)
- [Invalid digital signature during installation](/guides/document-converter/sharepoint/troubleshooting/invalid-digital-signature-during-installation.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 InfoPath form conversion issues](/guides/document-converter/sharepoint/troubleshooting/my-infopath-form-fails-to-convert-how-can-i-troubleshoot-this.md)
- [Troubleshoot SharePoint Designer workflow issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-designer-workflow-activities-are-not-inserted.md)
- [Troubleshooting Document Converter login issues](/guides/document-converter/sharepoint/troubleshooting/problems-logging-in-to-pdf-converter-services-online.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 SharePoint Document Converter issues](/guides/document-converter/sharepoint/troubleshooting/sharepoint-behaves-unexpectedly-after-deploying-the-pdf-converter-for-sharepoint.md)
- [Solving formatting issues when converting HTML to PDF](/guides/document-converter/sharepoint/troubleshooting/solving-formatting-issues-when-converting-html-to-pdf.md)
- [Troubleshooting PDF workflow issues in SharePoint](/guides/document-converter/sharepoint/troubleshooting/pdf-workflow-activities-are-not-displayed-in-sharepoint-designer-2013.md)
- [Troubleshooting SharePoint Online menu visibility issues](/guides/document-converter/sharepoint/troubleshooting/some-menu-options-are-not-displayed-in-sharepoint-online.md)
- [Troubleshoot evaluation message in SharePoint](/guides/document-converter/sharepoint/troubleshooting/the-license-has-been-installed-but-an-evaluation-message-is-still-displayed.md)
- [Fixing SharePoint search for HTML-to-PDF conversion](/guides/document-converter/sharepoint/troubleshooting/sharepoint-search-does-not-return-converted-html-content.md)
- [The Conversion Service does not start](/guides/document-converter/sharepoint/troubleshooting/the-conversion-service-does-not-start.md)
- [Troubleshooting install.cmd errors](/guides/document-converter/sharepoint/troubleshooting/troubleshooting-install-cmd-errors.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 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)
- [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)
- [Watermarker fails to load because Microsoft now enforces Content Security Policy (CSP)](/guides/document-converter/sharepoint/troubleshooting/watermarker-blocked-by-microsoft-csp.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)
- [Understanding duplicate PDF conversion options in SharePoint](/guides/document-converter/sharepoint/troubleshooting/why-are-the-various-pdf-conversion-options-displayed-twice-in-sharepoint.md)
- [Why are my watermarks not visible?](/guides/document-converter/sharepoint/troubleshooting/why-are-my-watermarks-not-visible.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)
- [Troubleshoot PDF merging issues and solutions](/guides/document-converter/sharepoint/troubleshooting/error-while-merging-existing-pdf-files-e-g-pdflexer-errors.md)