Tracing Mode

By default, NiceLabel 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, NiceLabel 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.

Warning

Tracing mode slows down processing. It should only be used when instructed so by NiceLabel technical support team.

Enabling the tracing mode

To enable the tracing mode, do the following:

Navigate to the NiceLabel Automation System folder.

%PROGRAMDATA%\NiceLabel\NiceLabel 10
Create backup copy of product.config file.
Open product.config file in text editor. The file has an XML structure.

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>

After you save the file, NiceLabel Automation Service automatically applies the setting.
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.
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>