Journals and logs

Journals

Error log

Contains all errors that occurred during the operation. Errors are divided into the following classes (the Object class column):

• errors that occurred on the server — displayed on a white background and included in the single class Exception on server;
• errors that occurred on the server and were received by the client application — displayed on a pink background and included in the single class Exception on server (from client);
• errors that occurred in the client application — displayed on a yellow background and fall into two classes: Exception on client and Exception on web client;
• connection errors — displayed on a blue background and divided into two classes:
  • Temporary connection loss — connection with the server was interrupted, but was then restored;
  • Permanent connection loss — connection with the server was interrupted and could not be restored.

The Exception trace section displays the java stack for the error; the Exception LSF trace displays the lsfusion stack; the Async exception trace section displays the stack of the asynchronous request that spawned the failing one (relevant for errors in background threads and event handlers, where the regular stack does not show the originating user context).

Connection log

Stores information about users who connected to the system, from which computer, the characteristics of that computer, as well as information about the date and time of connection / disconnection. On the form, you can display the users currently working with the database — the Active connections checkbox.

The Form section shows which forms the user entered and how many times. The Session section lets you trace when changes were applied, for some forms.

Startup log

Stores information about the dates and times when the application server was started (restarted). You can also see the name of the computer on which the server is installed and the version of the application (if filled in during the build).

Change log

Contains more detailed information about the changes which were reflected in the Session section of the connection log. The Change column displays a list of Properties (columns) where the values changed, as well as the number of changes (rows). Only changes in the current form are logged: dependent Properties that change simultaneously on other tables do not feature on this list.

By default the list of changed properties is not logged — only the summary counts remain in the Change column; full logging is enabled by the logChangesSession setting.

The form lets you filter the changes made by users (excluding system changes) by checking Only user changes.

Client application log

Contains information about the quality of the connection while working with the application server for a given period of time.

As well as system memory indicators, you can analyze the average response time (ping) in milliseconds and the memory available to and used by the java application on client computers in the upper part of the form. The period to be analyzed is set by entering Date from and Date to in the Date and time section. In addition to dates, you can also set a threshold value here for the same indicators (ping and memory) — this allows you to get the total time (in seconds) when the client PC has exceeded the threshold values.

The Data tab at the bottom provides a chronology of changes in response time and in memory available and used. This information is displayed for the Desktop client only.

Log retention

How much information should be stored in these logs is indicated in the Admin form > Settings > Logging tab.

User logging

If you need to track changes to the individual values of any Properties (columns) on specific Forms, a mechanism for user logging has been developed to allow you to do it. For example, let's say you need to record changes to an employee's last name in the Employees directory. To do this:

1. go to any entry in the Surname column and right-click to bring up the Configure property policy menu:

   

2. in the Security policy form, check Logged by user and click OK:

   

3. once you restart the application server, right-clicking on the Surname property will bring up an additional Show Change History menu item. If the surname for the current record has been changed by someone, this will be reflected in the property change history:

   

The retention time for these logs is set to the same retention time as for the Change log.

Journal setup mechanism

Each of the journals above is set up in the platform's system modules in a uniform way: a dedicated class is declared for the journal, together with a form for viewing it, a retention-days parameter, and an extension point for clearing stale records. This bundle is generated on the system-module side by the same template, so the retention time is set independently for each journal — on the Administration > Settings > Logging form each journal gets its own row.

Stale records are cleared on schedule through a common clearApplicationLog extension point. An application module can hook into this point to add its own journal to the shared cleanup cycle without setting up a separate scheduler entry.

Logs

The following set of logs is supported for each platform component in the platform:

Component	Folder	Logs
Application server (Server)	$FUSION_DIR$/logs, where $FUSION_DIR$ is the application server startup folder	stdout - standard output log (output to the standard output stream, i.e. to the OS console, IDE, etc.). Includes start and explain logs. stderr - general error log start - a log of the stop and start process remote, invocation - logs of processes related to accessing the application server sql, sqlhand, sqlconnection, sqlconflict, sqladjust - logs of processes related to accessing the database server explain, explaincompile - logs where query plans are displayed (database server and application server, respectively) lru - log of memory management processes (mainly LRU caches) cache - cache diagnostics log (disabled by default) allocatedbytes - log of memory allocation processes assert - a log of various checks on meeting specified conditions (or rather, non-meeting) mail - mail log import - log of import processes jasperReports - JasperReports log jdbc - jdbc driver log exinfo - a log of additional information (not included in the above)
Web server (Client)	$CATALINA_BASE$/logs, where $CATALINA_BASE$ is the folder where Tomcat is installed	catalina.out - general output log gwtlog, gwtlog-err - GWT logs invocation - logs of processes related to accessing the web server
Desktop client	$USER_DIR$/.fusion/logs, where $USER_DIR$ is the user folder	stdout - standard output log (output to the standard output stream, i.e. to the OS console, IDE, etc.). stderr - general error log remote, invocation - logs of processes related to accessing the application server jasperReports - JasperReports log

info

With automatic installation under Linux, symlinks for these folders (as well as for the lsFusion launch parameters) are automatically created to other folders whose location is better aligned with Linux ideology.