Applies to: WAVE

Summary

Log files track the internal actions performed by Wisenet WAVE components. They are a crucial part in the issues investigation as they help developers to understand the problem and its cause.

The following logs may be requested as part of a support ticket:

• System Logs

• Server Logs

• Client Log

This article describes how to collet WAVE logs in version 5.1 or later. 

Collecting WAVE Logs

To access and manage logs: 

1.  Log in to WAVE. 
    
2. For Client and Server: select Main Menu > System Administration > Advanced > Logs Management
   
   For Client only: select Main Menu > Local Settings > Advanced > Logs Management (does not require you to be logged into a System)
    

3. Select the log level definition.
   
   NONE – no log files are written (default for Desktop Client)
   
   ERROR – only errors and critical failures are written
   
   WARNING – warnings (predefined messages from developers), errors, critical failures
   
   INFO – same as WARNING plus informational messages predefined by developers (default log level for Servers)
   
   DEBUG – same as INFO plus auto generated messages about the actions performed by the application (recommended when reporting an issue)
   
   VERBOSE – same as DEBUG but records full track of everything that the application does (a very large amount of data). This is not recommended for a long-term run as it slows down the application. If this level is requested by developers, switch to this log level, collect the log files once the issue is reproduced, then switch back immediately.
   
   

   Additional log settings:
   
   Limit Max Volume – the maximum total size of the log files. Once the size hits the limit, the oldest records will be erased.
   
   Split File by Size – size of the single log file. Once the size hits the limit, the new file will be created until the Max Volume limit is reached by all log files.
   
   Split File by Time – if enabled, the new file will be created once in a specified period of time until the Max Volume limit is reached by all log files.
   
   Reset to Default – to revert settings to the original ones.
   
   
    

4. Click OK.

Obtaining Server and/or Client Logs

To obtain Server and/or Client Logs:          

1. Open Logs Management.       
    
2. Select the components that you want to download log files for (Client and/or Server).   
    
3. Click Download.    
         
4. Select the folder to be used to save log files.
   
   Log files are downloaded as zip archives with the following names:
   client_<date> - <time>.zip – client logs
   <server_name> - <server_guid> - <date> - <time>.zip – Server logs (for each Server in the System)
   
   Server logs archive contains the following:
   system_XXX.log – System events (licenses related events server start/stop, critical issues)
   main_XXX.log – Server events (everything else)