Compatibility :	3.3.0
Editions :
Platforms :

This property is used to configure the body of alert emails.

Like several of the event emails properties, it can be defined:

• Globally for all events: wrapper.event.default.email.body property, or
• For a specific event: wrapper.event.<event_name>.email.body property.

The "<event_name>" component of the property name can be either the keyword "default", or one of the Event Types. By setting the default property, all Event Types which are not set explicitly will take on that value.

Variables:

It is possible to reference any of the Wrapper's default environment variables, or event handler variables from anyplace within the text.

Multiline:

The .email.body property is a bit special, in that its value allows you to define a multiline message body. The end of a line (line break) is indicated with the text "\n". If you wish to place a single backslash "\" in the text, use a double backslash "\\" instead. Any other character following a single backslash "\" is escaped and may change in the future.

The default value defines a simple, but useful message body:

Java Service Wrapper Event Notification\\n\\nHost: %WRAPPER_HOSTNAME%\\nApp Name: %WRAPPER_NAME%\\n          %WRAPPER_DISPLAYNAME%\\n\\nEvent: %WRAPPER_EVENT_NAME%

When formatted in the message, this will result in a message body like the following:

Java Service Wrapper Event Notification

Host: myhost
App Name: myapp
          MyApplication

Event: jvm_started

The following example will simply display the "host name", "application name", and "event name".

wrapper.event.default.email.body=Host: %WRAPPER_HOSTNAME%\\nApp Name: %WRAPPER_NAME%\\nEvent: %WRAPPER_EVENT_NAME%

Attach Log:

It is possible to attach or append recent log activity to an email using the wrapper.event.<event_name>.email.maillog property.

Please see the overview of Event Mails for the usage examples.

Email Alert Setting:

• wrapper.event.<event_name>.email (3.3.0) ( Pro )

  Configures whether or not emails should be sent for a particular event.

Email System:

• wrapper.event.<event_name>.email.client.host (3.3.2) ( Pro )

  Sets the name of the machine running the Wrapper and sent to the SMTP server.

• wrapper.event.<event_name>.email.smtp.host (3.3.0) ( Pro )

  Configures the SMTP host which the Wrapper will attempt to connect to when sending emails.

• wrapper.event.<event_name>.email.smtp.port (3.3.0) ( Pro )

  Configures the SMTP port which the Wrapper will attempt to connect to when sending emails.

• wrapper.event.<event_name>.email.smtp.auth.type (3.5.3) ( Pro )

  Specifies an authentication method to use when connecting to an SMTP server.

• wrapper.event.<event_name>.email.smtp.auth.userid (3.5.3) ( Pro )

  Specifies the user Id to use for authentication when connecting to an SMTP server.

• wrapper.event.<event_name>.email.smtp.auth.password (3.5.3) ( Pro )

  Specifies the password to use for authentication when connecting to an SMTP server.

• wrapper.event.<event_name>.email.receive.timeout (3.3.2) ( Pro )

  Configures the maximum number of seconds to wait for a reply from the SMTP server after a command is sent by the Wrapper.

• wrapper.event.<event_name>.email.send.timeout (3.3.2) ( Pro )

  Configures the maximum number of seconds to wait when the Wrapper attempts to send a command to the SMTP server.

• wrapper.event.<event_name>.email.debug (3.3.0) ( Pro )

  Prints detailed information when emails are sent.

Email Body:

• wrapper.event.<event_name>.email.sender (3.3.0) ( Pro )

  Specifies the from address of the emails.

• wrapper.event.<event_name>.email.recipient (3.3.0) ( Pro )

  Specifies the recipient(s) of the emails.

• wrapper.event.<event_name>.email.subject (3.3.0) ( Pro )

  Configures the subject of the emails.

• wrapper.event.<event_name>.email.body (3.3.0) ( Pro )

  Configures the body of the emails.

• wrapper.event.<event_name>.email.maillog (3.5.31) ( Pro )

  Enables sending logs as an attachment or directly in the body of the emails.

• wrapper.event.default.email.maillog.lines (3.4.0) ( Pro )

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

• wrapper.event.default.email.maillog.format (3.4.0) ( Pro )

  Configures the format of the logs included in the emails.

• wrapper.event.default.email.maillog.loglevel (3.4.0) ( Pro )

  Filters messages included in the emails according to their log levels.