Tracing Mode

By default, Loftware Automation logs events into log database. This includes higher-level information gathering, such as:

• action execution logging

• filter execution logging

• logging of trigger status updates

For more information, see section Event Logging Options.

However, default logging doesn't keep track of the deep under-the-hood executions. If troubleshooting is needed on the lower-level of the code execution, you must enable tracing mode. In this mode, Loftware Automation logs details about all internal executions that take place during trigger processing. Tracing mode should only be enabled during troubleshooting to collect logs and then disabled to resume normal operation.

Enabling the tracing mode

To enable the tracing mode, do the following:

1. Navigate to the Loftware Automation System folder.

   %PROGRAMDATA%\Loftware\Loftware

2. Create backup copy of product.config file.

3. Open product.config file in text editor. The file has an XML structure.

4. Add the element Common/Diagnostics/Tracing/Enabled and assign value True to it.

   The file should have the following contents:

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
       <Common>
           <Diagnostics>
               <Tracing>
                   <Enabled>True</Enabled>
                   <Folder>c:\Troubleshooting\TracingLogs</Folder>
               </Tracing>
           </Diagnostics>
       </Common>
   ...
   </configuration>

5. After you save the file, Loftware Automation Service automatically applies the setting.

6. By default, tracing files (*.LOG file extension) appear in the same System folder.

   To override the log folder, use product.config file. Specify the custom log folder in the Folder element. This element is optional.

7. To confirm that tracing mode is enabled, start the Automation Manager. With tracing mode enabled, it displays text Tracing has been enabled in the notification pane above the trigger list.

After you reproduce the issue with enabled tracing, disable tracing in product.config file or restore your original product.config file.

            <Tracing>
                <Enabled>False</Enabled>