1. NiceLabel Help Center
  2. Knowledge Base
  3. How To

Enable Control Center and Web Printing tracing

Problem

You face problems with Control Center (on-premises installation) or Web Printing, which you can't resolve with the standard methods. Our development team can identify and resolve such issues by analyzing trace log files.

Solution

Tracing is not enabled by default. You can enable tracing for Control Center and Web Printing events by editing Control Center configuration files.

Note

Tracing can slow down your Control Center and Web Printing. Trace log files take disc space which can be critical if tracing is running for a longer time. After you reproduce the issue, disable the tracing.

NiceLabel Control Center Proxy Service 2019 tracing

To trace the activity of NiceLabel Control Center Proxy Service 2019:

  1. Edit the <Tracing> tag in "c:\ProgramData\NiceLabel\NiceLabel Control Center\system.net\product.config" on the server where you installed Control Center.

  2. Connect to the server where Control Center is installed.

  3. With text or XML editor open the file "c:\ProgramData\NiceLabel\NiceLabel Control Center\system.net\product.config".

  4. Edit the <Tracing> tag by setting <Enabled> value to True:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <Common>
    <Diagnostics>
      <Tracing>
        <Enabled>True</Enabled>
      </Tracing>
    </Diagnostics>
  ...

Trace log files will be created in the folder "c:\ProgramData\NiceLabel\NiceLabel Control Center\system.net\".

Note

This method enables tracing only for NiceLabel Control Center Proxy Service 2019, To enable tracing in applications, see NiceLabel, WebDav and Web Printing tracing.

NiceLabel Web Printing Proxy Service 2019 tracing

To trace the activity of NiceLabel Web Printing Proxy Service 2019:

  1. Connect to the server where Control Center is installed.

  2. With text or XML editor open the file "c:\ProgramData\NiceLabel\NiceLabel Web Printing\product.config".

  3. Edit the <Tracing> tag by setting <Enabled> value to True:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <Common>
    <Diagnostics>
      <Tracing>
        <Enabled>True</Enabled>
      </Tracing>
    </Diagnostics>
  ...

Trace log files will be created in the folder: "c:\ProgramData\NiceLabel\NiceLabel Web Printing\".

Note

This method enables tracing only for NiceLabel Web Printing Proxy Service 2019. To enable tracing in applications, see Control Center, WebDav and Web Printing tracing..

Control Center, WebDav, and Web Printing tracing

You can trace activities in the following applications:

Warning

Applications tracing are possible only with builds 19.2.1.5450 and newer. Tracing with older builds may cause applications to crash.

  • Control Center application tracing:

    1. Navigate to the file "c:\Program Files\NiceLabel\NiceLabel Control Center\WEB\web.config" and make a backup of the file.

    2. Open "web.config" with XML or text editor.

    3. Search for the tag

      <add key="TracingEnabled" value="true" />

    4. Remove the comment in XML code.

      01_e.png

    5. Add the comment sign to the end of the upper comment.

      02_e.png

      XML tag for tracing becomes active.

      Log files will be saved to the folder "c:\Program Files\NiceLabel\NiceLabel Control Center\WEB\".

    6. Search for the tag

      <add name="FileTraceListener" type="System.Diagnostics.TextWriterTraceListener"

    7. Remove the comment in XML code.

      03_e.png

    8. Add the comment sign to the end of the upper comment.

      04_e.png

      XML tag for tracing becomes active.

      Log files will be saved to the folder specified in the uncommented XML tag, defined in "initializeData" parameter.

      initializeData.png

  • WebDav website tracing:

    1. Navigate to the file "c:\Program Files\NiceLabel\NiceLabel Control Center\WebDAV\web.config" and make a backup of the file.

    2. Open "web.config" with XML or text editor.

    3. Search for the tag

      <add key="TracingEnabled" value="true" />

    4. Remove the comment in XML code.

      09.png

    5. Add the comment sign to the end of the upper comment.

      10.png

      XML tag for tracing becomes active.

      Log files will be saved to the folder "c:\Program Files\NiceLabel\NiceLabel Control Center\WebDAV\".

    6. Search for the tag

      <add name="FileTraceListener" type="System.Diagnostics.TextWriterTraceListener"

    7. Remove the comment in XML code.

      11.png

    8. Add the comment sign to the end of the upper comment.

      12.png

      XML tag for tracing becomes active.

      Log files will be saved to the folder specified in the uncommented XML tag, defined in "initializeData" parameter.

      initializeData.png

  • WebPrinting website tracing:

    1. Navigate to the file "c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\web.config" and make a backup of the file.

    2. Open "web.config" with XML or text editor.

    3. Search for the string

      <add key="TracingEnabled" value="true" />

    4. Remove the comment in XML code.

      13.png

    5. Add the comment sign to the end of the upper comment.

      14.png

      XML tag for tracing becomes active.

      Log files will be saved to the folder "c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\".

    6. Search for the tag

      <add name="FileTraceListener" type="System.Diagnostics.TextWriterTraceListener"

    7. Remove the comment in XML code.

      15.png

    8. Add the comment sign to the end of the upper comment.

      16.png

      XML tag for tracing becomes active.

      Log files will be saved to the folder specified in the uncommented XML tag, defined in "initializeData" parameter.

      initializeData.png
trace.axd website tracing

You can enable trace.axd website tracing in:

  • Control Center.

    Edit "c:\Program Files\NiceLabel\NiceLabel Control Center\WEB\web.config" file.

  • WebDav.

    Edit "c:\Program Files\NiceLabel\NiceLabel Control Center\WebDAV\web.config" file

  • WebPrinting.

    Edit "c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\web.config" file

Edit the following XML tags in "product.config" files:

  1. Search for the string

    <trace enabled="true" requestLimit="1000" traceMode="SortByTime" />

  2. Remove the comment in XML code.

    05_e.png

  3. Add the comment sign to the end of the upper comment. XML tag for tracing becomes active.

    06_e.png

  4. Search for the string

    <add name="WebPageTraceListener" type="System.Web.WebPageTraceListener,

  5. Remove the comment in XML code.

    07_e.png

  6. Add the comment sign to the end of the upper comment.

    08_e.png

    XML tag for tracing becomes active.

You can check tracing activity on URL: http://<server_name>/EPM/trace.axd

Failed Requests Tracing in Control Center, WebDav and Web Printing websites

To enable Failed Requests Tracing:

  1. On your server with Control Center installation open Turn Windows Features on or off. Navigate to Internet Information Services > World Wide Web Services > Health and Diagnostics, and enable Tracing.

    01_features.png

  2. Open Internet Information Services (IIS) Manager. Navigate to Sites > Default Web Site > EPM, and double-click Failed Request Tracing Rules.

    02_01_IIS_failed_requests.png

    Note

    If Failed Request Tracing Rules is not enabled for Default Web Site, an alert displays in the top right corner of the window.

    03_01_b_alert.png

    Click on the message to enable Failed Request Tracing Rules, then select the option Enable.

    03_02_enable.png

  3. Click Add.

    03_b_add.png

  4. Select All content (*), then click Next.

    04_add2.png

  5. Enter your preferred codes in the Status code(s) edit field, then click Next.

    05_trace_conditions.png

  6. Select all Trace Providers and click Finish.

    06_enable.png

Failed Requests Tracing is now enabled. Log files will be created in the default folder "%SystemDrive%\inetpub\logs\FailedReqLogFiles" (unless you specified the different path when enabling the tracing).