wrapper.event.<event_name>.email.maillog Properties

Starting with Wrapper version 3.4.0, it is possible to attach or append recent log activity to the Notification emails sent by the Wrapper. The following properties allow you to configure the number of lines, format and log level to use, as well as how to include logs in the emails.

wrapper.event.<event_name>.email.maillog

Compatibility :3.5.31
Editions :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Enables sending logs as an attachment or directly in the body of the Notification emails sent by the Wrapper.

The properties are all of the form wrapper.event.<x>.email.maillog where "<x>" component is either the keyword "default", or one of the Event Types.

Valid values include:

  • NONE to not include logs,
  • INLINE to include logs in the body of the email,
  • ATTACHMENT to add a log file in the attachments,
  • BOTH to both include logs in the body and attachments of the email,

The default value is NONE.

Example (set the Wrapper to only attach the log for 'jvm_killed' but not 'jvm_prelaunch'):
#enable the mail notification for 2 events
wrapper.event.jvm_killed.email=TRUE
wrapper.event.jvm_prelaunch.email=TRUE

#enabling log file attachment as default
wrapper.event.default.email.maillog=ATTACHMENT

#disable log file attachment for 'jvm_prelaunch' event
wrapper.event.jvm_prelaunch.email.maillog=NONE

NOTE

For backwards compatibility, these properties get their default values from the deprecated wrapper.event.<x>.email.attach_log properties (which existed since Wrapper version 3.4.0, and deprecated as of Wrapper version 3.5.31).

wrapper.event.default.email.maillog.lines

Compatibility :3.4.0
Editions :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Specifies the number of lines of the logs included in the emails.

The default value is "50".

Example: (50 lines)
wrapper.event.default.email.maillog.lines=50

NOTE

Please note that, unlike the previous email properties, it is NOT possible to specify the numbers of lines for individual Event Types, only for the "default" case globally.

wrapper.event.default.email.maillog.format

Compatibility :3.4.0
Editions :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Defines the format of the logs included in the emails. The possible values are exactly the same as the console output format, the log file output format, etc.

The default value is "LPTM".

Example: (LPTM)
wrapper.event.default.email.maillog.format=LPTM

NOTE

Please note that, unlike the previous email properties, it is NOT possible to specify the format for individual Event Types, only for the "default" case globally.

wrapper.event.default.email.maillog.loglevel

Compatibility :3.4.0
Editions :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

Specifies the loglevel of the logs included in the emails. The possible values are exactly the same as the console output loglevel, the log file output loglevel, etc.

The default value is "INFO".

Example:
wrapper.event.default.email.maillog.loglevel=INFO

NOTE

Please note that, unlike the previous email properties, it is NOT possible to specify the loglevel for individual Event Types, only for the "default" case globally.

wrapper.event.<event_name>.email.attach_log

Compatibility :3.4.0 (Deprecated as of 3.5.31)
Editions :Professional EditionStandard Edition (Not Supported)Community Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/Linux

WARNING

Use of this property has been deprecated as of Wrapper version 3.5.31 in favor of the wrapper.event.<event_name>.email.maillog property.

Enables sending a log file in the attachments of the Notification emails sent by the Wrapper.

The properties are all of the form wrapper.event.<x>.email* where "<x>" component is either the keyword "default", or one of the Event Types. Unlike the other event related properties, if you want to use the log file as attachment you have to activate this globally for the "default" event type. You can, however, use the different Event Types to deactivate sending the logfile for those events.

The default value is "FALSE".

Example (set the Wrapper to only attach the log for 'jvm_killed' but not 'jvm_prelaunch'):
#enable the mail notification for 2 events
wrapper.event.jvm_killed.email=TRUE
wrapper.event.jvm_prelaunch.email=TRUE

#enabling log file attachment as default
wrapper.event.default.email.attach_log=TRUE

#disable log file attachment for 'jvm_prelaunch' event
wrapper.event.jvm_prelaunch.email.attach_log=FALSE

Reference: Event Mails