Configuring the Server Logging

Sync4j SyncServer logs the server activity in many loggers so that it is possible to tell the server to selectively log only the information we are interested into.

Each logger has a name in a dot separated notation; each subname represents a level in a hierarchical structure. Each logger is meant to log the activity of a particular server subsystem or component.

The default loggers are:

Loggers settings are accessible from the Server settings/Logging node. Selecting a logger, the form of Figure 12 is show.


Figure 12 - The logger configuration form

For each logger, it is possible to set the following values:

ParameterDescription
Logger nameThe name of the logger
Same as ...As said, the logger are in a hierarchical relationships represented by their names. A child logger can inherit its settings from its parent logger. For example, the logger sync4j.engine can inherit its settings from the settings of the logger sync4j.
Logging levelCan be one of the following:
  • NONE: the logger is disabled
  • ERROR: trace only error conditions
  • INFO: trace informative and error messages
  • ALL: trace debug, informative and error messages
Output to console Should the output of the log be written on the console too?
Output to file Should the output of the log be written on a file?
Filename patter A filename pattern consists of a string that includes the following special components that will be replaced at runtime:
  • "/" the local pathname separator
  • "%t" the system temporary directory
  • "%h" the value of the "user.home" system property
  • "%g" the generation number to distinguish rotated logs
  • "%u" a unique number to resolve conflicts
  • "%%" translates to a single percent sign "%"
If the file reaches the limit specified with the file size limit parameter, and the rotation file count is greater than 1, the file is "rotated" so that a new file is created and the output is written to it instead of the old one.
File size limit Maximum size of the file before being rotate (or overwritten)
Rotation file count Maximum number of rotated files