Log configuration

Logging

To debug programming code and to log errors, the runtime components use the standard logging interface for Java applications (log4j). The interface is designed so that logging does not heavily affect the performance of the application and that logging behavior can be controlled by changing the log configuration, without altering the application binary.

On the Connector Log Configuration page, you can specify the log settings of a connector. You can change the default name and path of the log file and you can indicate on which level the connector must be logged. To reach the Log Configuration page, click log configuration page or Configure logging on the connector's starting page.

Log Configuration properties

These fields are displayed on the Connector Log Configuration page:

Application log level

The used log level for the connectors. You can select one of these levels.

• Error

  The Error level designates error events that can still allow the connector to continue running. The error message indicates that parts of the application are not working or working incorrectly. The Error level also includes the logging of fatal errors.

• Info

  The Info level designates informational messages that highlight the progress of the application at coarse-grained level. Such informational messages include, for example, the initialization of a configuration or the end of a long import process. The Info level includes Error logging.

• Debug

  The Debug level designates fine-grained informational events that are most useful to debug the connector. Use this level only for developing purposes to follow the program execution. The Debug level includes the Info logging.

Log file location (Web Server)

The name and location of the log file of a particular connector. The log file must be located on the computer hosting the web server that runs the connector.

Maximum log file size (Mb)

Specify the maximum size of the log file in Mb. Leave the field empty or use the value 0 for an unlimited log file size. If the log file reaches the specified size, a backup is made and the log file is cleared automatically. The file name of these backup files is the log file name extended with a number. The log files are stored in the folder that is specified in the Log file location (Web Server) field.

Maximum number of backup files

This field is used when the maximum log file size is specified. After the maximum size of the log file is reached, a backup of the log file is created. This process is repeated until the maximum number of backup files is reached. When reaching this maximum number, the oldest backup is deleted.

Connector for Web Services uses the following file path and file name as default value for the Log file location:

<Tomcat installation directory>/logs/c4ws.log

By default, the log level of the connector is set to Error. To trace down errors, change the logging to a lower level.