Skip to main content
Integration Service - Local Based Logging
Support avatar
Written by Support
Updated over 7 months ago

Product: Integration Service


The Integration Service is a Windows Service that runs in the background (often on your server) to provide a connection between your Business System and Transaction Manager. When provided a Direct Framework connection - the Integration Service can log the communication happening between the two programs.

Note: Logging only works for direct Framework Connections and does not work for file based transfers known as Flat Files (XML,CSV,TXT, etc.)

Flat Files are simply read as-is and no communication is available to be logged

Cloud Based Solutions

If you are utilizing a Cloud Based solution (such as NetSuite, Sage X3, and Microsoft Dynamics 365 Business Central) your solution does not utilize the Integration Service as all services are hosted by your partners.

As such you'll want to follow the below article on enabling Cloud Logs

Permissions & Third Party Hosting

In order to enable logging user's must be able to access, and make changes, to files within the C:\ drive of where the Integration Service is installed. Often I.T Departments and Third-Party Hosting solutions restrict this access for security reasons.

NOTE: If you are utilizing a Third-Party hosting service, you may need to engage your third-party support due to restrictions often placed that prevent end-users (and TrueCommerce) from enabling Logging

Enabling Integration Trace Logs


The Integration Service can provide detailed tracing of the communication that occurs between your Business System and Transaction Manager - detailing out the connection attempts, disconnects, Imports, Exports, and Transaction Searches that can help identify problematic issues.

Opening Permissions


Whenever logging is enabled for the Integration Service - the service will attempt to write a text file to the directory where the service was installed - this often requires elevated permissions in order to properly be able to write new files to the directory.

Navigate to C:/Program Files (x86)/ and locate the TrueCommerce folder. Right Click the folder โ†’ and select Properties

Select the Security Tab

Provide Full Control permissions to the Everyone user

If the Everyone user is missing - select the Edit button. Select Add on the new popup window. Type Everyone into the box on the bottom. Select Check Names and hit OK.

Check the Full Control checkbox under the Allow column with the Everyone user selected

Enabling Logging


Navigate: C:/Program Files (X86)/True Commerce/TmoIntegrationService

Right Click: IntTcConfig.xml โ†’ Edit

Turn tracing to True


Set: Tracing from False to True

Save File

Create: Create a new folder named Log inside the TmoIntegrationService if it does not yet exist (C:\Program Files(X86)\True Commerce\TmoIntegrationService\Log)

Generating the Log

Perform: your Import/Export/Sync as you would normally

  • This will generate (or add to an existing) LogFile

Recommendation: For easier tracking, if an old log file exists โ€“ delete it before performing your Import/Export as the system will ADD to the old logs. Itโ€™s best to have fresh data.

Enabling Integration Service Debugging


The Integration Service (V2) can also produce debugging information regarding its communication with the Transaction Manager platform, such as the SignalR Connection, Requests, and Responses that are being activated.

Note: This information is generally irrelevant of your Business System Connection and is instead simply connection information between the Integration Service installation and the Transaction Manager Platform.

As such - this information is most useful when diagnosing issues with the connection continually dropping versus a connection issue to your business system.

Enabling Debugging

You'll need to gain access to your Integration Service server and be able to restart the service before logging will take affect.

Navigate: C:\Program Files (x86)\True Commerce\TmoIntegrationServiceV2

Open (Notepad): TmoIntSvcs.exe.config

Add Key: <add key="Debug" value="True" /> under the<appSettings>

<add key="Debug" value="True" />

64-Bit Services

Note: If you're utilizing the 64-Bit version of the Integration Service - you'll want to update both the regular config as well as the x64.exe.config file.

Enabling Requests

To enable Request Debugging data - you'll want to add the DebugLogRequest entry to the appSettings group

<add key="DebugLogRequest" value="True" />

Log Dump Location

Logs will be generated for every Request (which there are multiple per-operation) in your ProgramData folder once an operation has occurred.

Navigate: C:\ProgramData\TrueCommerce\Requests

Enabling Responses

To enable Request Debugging data - you'll want to add the DebugLogResponse entry to the appSettings group

<add key="DebugLogResponse" value="True" />

Log Dump Location

Logs will be generated for every Response (which there are multiple per-operation) in your ProgramData folder once an operation has occurred.

Navigate: C:\ProgramData\TrueCommerce\Responses

Enabling SignalR

To enable Request Debugging data - you'll want to add the DebugLogSignalR entry to the appSettings group

<add key="DebugLogSignalR" value="True" />

Log Dump Location

Logs will be generated for every SignalR request in your ProgramData folder once an operation has occurred.

Navigate: C:\ProgramData\TrueCommerce\SignalR

Integration Service Restart

After modifying any of the settings - the Integration Service must be restarted for them to take affect.

Additional Resources


rev: 10/18/22

Did this answer your question?