Logging Configuration Properties

Logging properties are used to configure how where the Java Service Wrapper logs internal output as well as JVM output which would normally show up in the console used to launch a Java application. Wrapper Logging properties do not in any way control nor replace Logging tools within the Java application.

[General/Common]

• wrapper.adviser (3.1.0)

  Displays advice whenever certain common problems are detected.

• wrapper.debug (1.0.0)

  Enables debug logging both to the console and log file.

• wrapper.filter.action.<n> (3.0.0)

  Configure the actions to take place whenever filters are triggered.

• wrapper.filter.allow_wildcards.<n> (3.5.5)

  Allow usage of wildcards in the trigger texts.

• wrapper.filter.message.<n> (3.5.0)

  Specify messages to be displayed whenever a trigger is fired.

• wrapper.filter.trigger.<n> (3.0.0)

  Specify the texts to trigger actions when matching a log message.

• wrapper.javaio.buffer_size (3.5.21)

  Controls the size of the buffer used by the pipe between the JVM and Wrapper processes.

• wrapper.javaio.use_thread (3.5.21)

  Controls whether the Wrapper uses a dedicated thread to process console output from the JVM.

• wrapper.properties.dump.format (3.5.35)

  Configures the format to use when dumping the configuration properties.

• wrapper.properties.dump.loglevel (3.5.30)

  Controls at which log level the configuration properties will be logged.

• wrapper.property_warning.loglevel (3.5.21)

  Controls at which log level warnings about invalid property values will be logged.

[Console]

• wrapper.console.direct (3.5.21)

  Specifies whether the Wrapper will use Windows APIs or pipes to write console log outputs.

• wrapper.console.flush (3.2.0)

  Configures the Wrapper to flush stdout after each line of output is sent to the console.

• wrapper.console.format (1.0.0)

  Configures the format of outputs sent to the console.

• wrapper.console.loglevel (1.0.0)

  Filters messages sent to the console according to their log levels.

• wrapper.console.fatal_to_stderr (3.5.3)
• wrapper.console.error_to_stderr (3.5.3)
• wrapper.console.warn_to_stderr (3.5.3)

  Controls whether warning messages sent to the console are logged through stdout or stderr.

[Command]

• wrapper.event.<event_name>.command.argv.<n> (3.3.0) ( Pro )

  Specify a command (and its arguments) to be executed in response to a specific event.

• wrapper.event.<event_name>.command.on_exit.<n> (3.3.0) ( Pro )

  Control what the Wrapper will do in response to specific exit codes of event commands.

• wrapper.event.<event_name>.command.loglevel (3.3.0) ( Pro )

  Controls the log level of messages related to the event commands being executed.

• wrapper.event.<event_name>.command.new_process_group (3.5.47) ( Pro )

  Specifies if the event command should be started in a new process group.

• wrapper.event.<event_name>.command.block (3.4.1) ( Pro )

  Tells the Wrapper whether or not to wait for the command to complete before allowing the Wrapper to continue.

• wrapper.event.<event_name>.command.block.timeout (3.3.0) ( Pro )

  Configures how long the Wrapper will wait for a configured event to complete.

• wrapper.event.<event_name>.command.block.action (3.4.1) ( Pro )

  Configures the action to take place whenever a configured event command fails to complete within the specified timeout.

[Log File]

• wrapper.log.lf_delay.threshold (3.5.10)

  Sets a threshold to split JVM messages that would be too long to be printed at once.

• wrapper.log.warning.threshold (3.5.8)

  Prints a warning when a log entry takes longer to be printed than the specified number of seconds.

• wrapper.logfile (1.0.0)

  Sets the path to the Wrapper log file.

• wrapper.logfile.close.timeout (3.5.21)

  Controls the number of seconds at which the log file should close after the last log entry.

• wrapper.logfile.flush.timeout (3.5.21)

  Configures the interval in seconds at which the Wrapper flushes all outputs to the log file.

• wrapper.logfile.format (2.2.5)

  Configures the format of the outputs sent to the log file.

• wrapper.logfile.inactivity.timeout (3.2.0)

  Controls the number of seconds at which the log file should close after the last log entry.

• wrapper.logfile.loglevel (2.2.5)

  Filters messages sent to the log file according to their log levels.

• wrapper.logfile.maxfiles (2.2.5)

  Controls the maximum number of rolled files.

• wrapper.logfile.maxsize (2.2.5)

  Controls the maximum size of rolled files.

• wrapper.logfile.purge.pattern (3.3.8)

  Controls the file pattern to purge old log files.

• wrapper.logfile.purge.sort (3.3.8)

  Configures the sorting mode of the rolled files to purge the last ones.

• wrapper.logfile.rollmode (3.2.0)

  Sets the roll mode of the log file.

• wrapper.logfile.group (3.5.38)

  Specifies the group to assign when creating the log file.

• wrapper.logfile.umask (3.2.0)

  Specifies the umask to use when creating the log file.

• wrapper.wrapperm.logfile.enable (3.5.58)

  Enable log file for "wrapperm" instances.

[Log-Dialog]

• wrapper.logdialog.enable (3.3.1) ( Std/Pro )

  Controls whether or not the log dialog should be displayed on shutdown when the "wrapperW.exe" exits in an error state.

• wrapper.logdialog.format (3.3.1) ( Std/Pro )

  Configures the format of the outputs displayed in the log dialog.

• wrapper.logdialog.lines (3.3.1) ( Std/Pro )

  Controls the maximum number of output lines displayed in the log dialog.

• wrapper.logdialog.loglevel (3.3.1) ( Std/Pro )

  Filters messages of the log dialog according to their log levels.

[Syslog]

• wrapper.syslog.facility (3.2.1)

  Sets the facility code to use when logging to the syslog on UNIX systems.

• wrapper.syslog.ident (3.2.0)

  Sets the identity (or event source on Windows) to use when logging to the syslog.

• wrapper.syslog.ident.enable (3.5.28)

  Ensures whether the event source should exist or not in the Windows registry.

• wrapper.syslog.local.host (3.5.0) ( Std/Pro )

  Specifies the local host name included in the packets sent to a remote syslog.

• wrapper.syslog.loglevel (2.2.5)

  Filters messages sent to the syslog (or event log on Windows) according to their log levels.

• wrapper.syslog.remote.host (3.5.0) ( Std/Pro )

  Specifies the host name of a remote syslog server where log outputs should be redirected to.

• wrapper.syslog.remote.port (3.5.0) ( Std/Pro )

  Specifies the port that the remote syslog server is listening on.

• wrapper.syslog.split_messages (3.5.24)

  Forces messages to be broken up into individual lines making them easier to read.

• wrapper.wrapperm.syslog.enable (3.5.58)

  Enable logging to the Event Log system for "wrapperm" instances.