Configuring Logging Options

Once you’ve enabled IDDA logging, you can modify configuration options in the logging.properties file, which you can find in this location:

<PS_CFG_HOME>/webserv/<domain_name>/piaconfig/properties

The relevant configuration properties are:

Property Description

.level

Sets the global logging level.

  • OFF: Disables all IDDA logging.

  • SEVERE: Displays server issues, such as premature termination and failure.

  • WARNING: Displays less severe issues, such as configuration issues.

  • INFO: Displays basic operational information, such as starting and stopping.

  • FINE, FINER, FINEST: Displays internal non-critical informational messages.

  • ALL: Enables all logging levels.

Default value is INFO.

WARNING and SEVERE messages are always logged, unless IDDA logging is set to OFF.

INFO or FINE, FINER, FINEST messages are only logged if the IDDA value is greater than zero.

java.util.logging.FileHandler.pattern

Sets the naming style for the log file and the output directory location.

Default value is: ./servers/PIA/logs/PIA_servlets%u.log

If you are running a multi-server, distributed environment (for clustering and failover purposes), the default value for java.util.logging.FileHandler.pattern is not applicable. You must set this property to point to a valid location in order to collect logging messages for a particular server.

Logging output is tab-delimited.

java.util.logging.FileHandler.limit

Limits the size of the output file in bytes. When set to 0, there is no size limit.

Default value is 0.

java.util.logging.FileHandler.count

Sets the total number of log files. Default value is 5.

If the value is greater than 1, the system writes to a rotating set of log files. When the file reaches a given size limit or the web server restarts, the system ends writing to the current file and begins writing to a new file. The system names each file in the sequence it is saved by adding "0", "1", "2", (and so on) into the base filename.