Hot To: Activate Tracing for the (New) SwyxIt!

The information in this article applies to the following products:

• SwyxIt! version 14 and higher
• SwyxIt! Classic

SUMMARY

This article describes how to enable tracing for the new SwyxIt! and where the trace files can then be collected.
For SwyxIt! Classic, tracing is activated as usual via the registry keys Trace ON/OFF.

INFORMATION

How do I activate logging/tracing for the (new) SwyxIt!

• To activate tracing, update the ‘settings.json’ file under ‘%LocalAppData%\Local\Programs\SwyxIt!’ as follows:

  {‘traceSettings’: {‘traceLevel’: ‘info’}}

What are the related traceLevels?

• The following parameters for traceLevels can be set: 
  • ‘verbose’ – Intended for developer debugging. Collects an extremely large amount of data and can affect client performance. Should only be set if explicitly requested by Swyx Development.

  • ‘debug’ – Similar to verbose... but does not collect large data queries such as the telephone book, which may contain several thousand entries.

    ‘debug’ and ‘verbose’ should only be used upon request from support and if a problem can be directly reproduced, so that traceLevel can be reduced after finishing the reproduction scenario

  • ‘info’ - You can see information + everything above it (notice, warning, error). This is usually the first setting that support initially requests. The density of information provides sufficient information for an initial analysis.
  • ‘notice’ - Default setting -> Notice messages (e.g. app start info) + warnings + error
  • ‘warning’ - Only warnings and error messages  
  • ‘error’ - Only error messages

Where can I find the trace files/trace output?

• The trace files are filed daily and are located under %LocalAppData%\Swyx\SwyxIt!\Traces. 
• They have the following naming structure: 
  • SwyxIt!-yyyy-mm-dd.
  • ComSocket-yyyymmdd-hhmms