Tracing Mode

By default, NiceLabel 10 logs events into the log database. This includes higher-level information, such as logging of action execution, logging of filter execution and logging of trigger status updates. For more information, see section Event Monitoring.

However, the default logging does not log the deep under-the-hood executions. When troubleshooting is needed on the lower-level of the code execution, tracing mode must be enabled. In this mode, NiceLabel 10 logs the details about all internal executions that take place during event processing.

Note

Tracing mode should only be enabled during troubleshooting to collect logs and then disabled to enable normal operation.

Warning

Tracing mode slows down processing and should only be used when instructed to do so by the technical support team.

To enable the tracing mode, perform the following:

Navigate to the System folder.

Example 145. Example

c:\ProgramData\NiceLabel\NiceLabel 10\
Make a backup copy of the product.config file
Open product.config in a text editor. The file has an XML structure.

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

The file includes 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 10 Service will automatically apply the setting.
By default, tracing files (*.LOG) will appear in the same System folder.

Note

You can override the location of the log folder by specifying it in the element Folder. This element is optional.
When you finish logging the error, replace the modified product.config file with the original product.config file.