The Systemite.SystemWeaver.TcpSubServer.exe.nlog is now offering the first version of a configurable option for logging specific user operations and usage statistics. The actions, events and calls currently included in the log are listed below. The events and calls from both the client application and the API will be included, whereas only actions performed in the client application will be logged. They can prove to be useful information for Administrators.


Note: If a mirror server is in use, it would have to have its own statistics log for logging the operations of the users logging in to the mirror server. The statistics log on the main server will not include operations done on the mirror server(s).


User Activity Statistics

The following operations in the server are included in the log file. 


Actions

PrintDocument

The printing of a Document or Report. 


For Documents: 


For Reports: 


ExportXML

The export of XML files.


For XML generation: 


For XML Export


ExportToExcel (SaveGrid)

The export of data to MS Excel (or csv) from a configurable grid.



saveToRTF (SaveDocument)

The saving of a Document or Report to an RTF and RVF file save a SysW document or report to RTF


For Documents: 


For Reports: 


ItemViewLoaded

One of the following views has been loaded. The name of the previously loaded view is also provided.

  • Configure the explorer views, i.e., Coverage, Part list editor
  • Configurable views - config item, i.e., Chart, Graph, Grid, Report
  • Extension views, e.g., HARA
  • Project view- issues, i.e., public views


Calls

The following deletion operations are logged. 


deleteItem

An item is deleted from the server.  


deletePart

A part is deleted from the server.


deleteIssue

An issue is deleted from the server. 


UserActivation

A user account is activated or deactivated.


CreateUser

A user account is created


DeleteUser

A user account is deleted.


Events


Usage Statistics

The following usage statistics are logged.


Login

A client login to the server.


LoginCount

  • A count of the number of user logins (i.e., active connections)
  • A count of the number of concurrent Read/Write licenses in use
  • A count of the number of concurrent Viewer licenses in use


Server Start

The server start and server version # is logged.


Reading and Analyzing the Log

The Statistics log is JSON formated and can easily be read, analyzed and visualized using an external tool of choice, such as ELK (Elasticsearch, Logstash, and Kibana) which is open source. One solution is to install, for example, docker and include an image of ELK there.


Recommendations

  • The shipper application used, e.g., beats, should be installed on the same server machine as the SystemWeaver server application and Statistics log file
  • The docker should be installed on a different server than where SystemWeaver server is installed


Example

In the below example, the log file is read by beats. and the data is then parsed and transformed by Logstash. Next, Elasticsearch is used for searching and analyzing. Finally, results can then be presented using Kibana.