Alerts

From the System Administration tool, you can configure system wide alert email notifications. JobServer is capable of sending email messages to notify administrators and other users when there are problems with the environment or with a specific Job. There are two types of alerts: System alerts and Job alerts.

System Alerts

System alerts should typically be sent to an administrator. They are sent when a problem occurs with the web server or the JobServer Engine. These same alerts can also be viewed using the JobServer Runtime Log tool or can be found in the web server log files on the file system. For GUI application logs and errors, you should refer to the web server logs which can be viewed manually by going to the directory jobserver/sys/app/logs/<hostname>/jobserver_log.<date>.log. Web GUI errors/exceptions are also emailed out to the System email addresses.

Job Alerts

Job alerts notify users when a job failure occurs during job processing. These are typically failures associated with the Job/Tasklet throwing an unexpected exception that may result in the Tasklet or job failing to continue processing. For example an uncaught out of memory exception or sql exception would constitute such a situation. Also when a Job/Tasklet throws TaskletFailureException this will also trigger an alert to be sent out. Note that errors and warnings logged via Log4J or the Java Logging API do not trigger an email alert.

The email alerts use a cascading mechanism. It works by first sending an alert to the email address listed at the system level. It then sends the alert to the email addresses defined for that Job's Partition, it then sends it to the Job's Group alert addresses, and then it finally will send it to the alert email addresses defined for the specific Job. With this design you can setup a hierarchy of email alerts. So, for example, you can set it up so that you only receive emails when a specific job fails or when any job in a particular Partition fails, ...etc.

The Tasklet may also programmatically trigger alerts by using the SOAFaces API. Refer to the API TaskletOutputContext.sendAlert().

Outgoing Email Server Configuration

The configuration options in this section allow for setting up your outgoing email server and enabling email alerts from JobServer to be sent to their corrresponding recipients. This allows email alerts and other email notification to be sent from JobServer through the specified SMTP server.

SMTP Server

This is the name of the mail server to use when sending email alerts. If this is not set, then no email alerts from JobServer will be sent.

Port

This port value defaults to 25 for the "none" security option. If you are using SSL the default port value is 465. If you are using TLS you must specify a port value.

Security

Choosing "none", uses no security when connecting to the SMTP server. Typically this does not require setting a Username/Password fields. Selecting SSL/TLS typically requires setting a Username/Password along with a port number.

Username/Password

Set these fields if you are using SSL/TLS security to authenticate with the SMTP server.

From Address

Set the "from" address to be used in the outgoing emails. This field is optional if authentication is required and the Username field is already set. You should typically set this field, if you are not using any form of authentication and the Username field is not set.

System Alert Addresses

Where to send alerts when system errors occuring during failure in JobServer Engine or Web Server. You may enter up to five email addresses.

Job Alert Addresses

This specifies where to send alerts when any job has a failure, as described above. You may enter up to five email addresses. If the same email address here, is present in the alert notification address for the job's Partition, Job Group, and/or job configuration, only one email will be sent per unique email address and error event.