[en] Enable Control Center and Web Printing tracing

[en] Problem

[en] 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.

[en] Solution

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

注意

[en] 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.

[en] NiceLabel Control Center Proxy Service 2019 tracing

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

[en] Edit the <Tracing> tag in "c:\ProgramData\NiceLabel\NiceLabel Control Center\system.net\product.config" on the server where you installed Control Center.
[en] Connect to the server where Control Center is installed.
[en] With text or XML editor open the file "c:\ProgramData\NiceLabel\NiceLabel Control Center\system.net\product.config".

[en] 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>
  ...

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

注意

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

[en] NiceLabel Web Printing Proxy Service 2019 tracing

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

[en] Connect to the server where Control Center is installed.
[en] With text or XML editor open the file "c:\ProgramData\NiceLabel\NiceLabel Web Printing\product.config".

[en] 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>
  ...

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

注意

[en] 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..

[en] Control Center, WebDav, and Web Printing tracing

[en] You can trace activities in the following applications:

[en] Control Center
[en] WebDav
[en] Web Printing

警告

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

[en] Control Center application tracing:
1. [en] Navigate to the file "c:\Program Files\NiceLabel\NiceLabel Control Center\WEB\web.config" and make a backup of the file.
2. [en] Open "web.config" with XML or text editor.
3. [en] Search for the tag
```
<add key="TracingEnabled" value="true" />
```
4. [en] Remove the comment in XML code.
5. [en] Add the comment sign to the end of the upper comment.
  
  [en] XML tag for tracing becomes active.
  
  [en] Log files will be saved to the folder "c:\Program Files\NiceLabel\NiceLabel Control Center\WEB\".
6. [en] Search for the tag
```
<add name="FileTraceListener" type="System.Diagnostics.TextWriterTraceListener"
```
7. [en] Remove the comment in XML code.
8. [en] Add the comment sign to the end of the upper comment.
  
  [en] XML tag for tracing becomes active.
  
  [en] Log files will be saved to the folder specified in the uncommented XML tag, defined in "initializeData" parameter.
[en] WebDav website tracing:
1. [en] Navigate to the file "c:\Program Files\NiceLabel\NiceLabel Control Center\WebDAV\web.config" and make a backup of the file.
2. [en] Open "web.config" with XML or text editor.
3. [en] Search for the tag
```
<add key="TracingEnabled" value="true" />
```
4. [en] Remove the comment in XML code.
5. [en] Add the comment sign to the end of the upper comment.
  
  [en] XML tag for tracing becomes active.
  
  [en] Log files will be saved to the folder "c:\Program Files\NiceLabel\NiceLabel Control Center\WebDAV\".
6. [en] Search for the tag
```
<add name="FileTraceListener" type="System.Diagnostics.TextWriterTraceListener"
```
7. [en] Remove the comment in XML code.
8. [en] Add the comment sign to the end of the upper comment.
  
  [en] XML tag for tracing becomes active.
  
  [en] Log files will be saved to the folder specified in the uncommented XML tag, defined in "initializeData" parameter.
[en] WebPrinting website tracing:
1. [en] Navigate to the file "c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\web.config" and make a backup of the file.
2. [en] Open "web.config" with XML or text editor.
3. [en] Search for the string
```
<add key="TracingEnabled" value="true" />
```
4. [en] Remove the comment in XML code.
5. [en] Add the comment sign to the end of the upper comment.
  
  [en] XML tag for tracing becomes active.
  
  [en] Log files will be saved to the folder "c:\Program Files\NiceLabel\NiceLabel Web Printing\Web\".
6. [en] Search for the tag
```
<add name="FileTraceListener" type="System.Diagnostics.TextWriterTraceListener"
```
7. [en] Remove the comment in XML code.
8. [en] Add the comment sign to the end of the upper comment.
  
  [en] XML tag for tracing becomes active.
  
  [en] Log files will be saved to the folder specified in the uncommented XML tag, defined in "initializeData" parameter.

[en] trace.axd website tracing

[en] You can enable trace.axd website tracing in:

[en] Control Center.

[en] Edit "c:\Program Files\NiceLabel\NiceLabel Control Center\WEB\web.config" file.
[en] WebDav.

[en] Edit "c:\Program Files\NiceLabel\NiceLabel Control Center\WebDAV\web.config" file
[en] WebPrinting.

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

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

[en] Search for the string

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

[en] Remove the comment in XML code.
[en] Add the comment sign to the end of the upper comment. XML tag for tracing becomes active.

[en] Search for the string

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

[en] Remove the comment in XML code.
[en] Add the comment sign to the end of the upper comment.

[en] XML tag for tracing becomes active.

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

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

[en] To enable Failed Requests Tracing:

[en] 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.
[en] Open Internet Information Services (IIS) Manager. Navigate to Sites > Default Web Site > EPM, and double-click Failed Request Tracing Rules.

注意

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

[en] Click on the message to enable Failed Request Tracing Rules, then select the option Enable.
[en] Click Add.
[en] Select All content (*), then click Next.
[en] Enter your preferred codes in the Status code(s) edit field, then click Next.
[en] Select all Trace Providers and click Finish.

[en] 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).