1. Home
  2. Tutorials and How Tos
  3. How to Create an Email Application Check

How to Create an Email Application Check

(For a short video about this topic, click here.)

An email application check evaluates the response time of an email server. Only one email application check may be added to OmniCenter.

From the main menu, select Administration → Modules → Email to open the Email Application Overview page.

If you have not yet added the email application check, the Email Application Overview page will be displayed. If you have already added the check, the edit page for that check will be displayed instead.

Create the Base Check

On the Email Application Overview page:

  1. Click the Add Application button.
  2. On the Add an Application page:

    1. Enter a name for your email application check. (“Mail” is provided as the default name.)
    2. Click Create.
      • Only one email application check is permitted. Once a check is added, the Email Application Overview page will no longer be available, and selecting Administration → Modules → Email will open the edit page for the currently configured check. If the current check is deleted, the Email Application Overview page will again appear.
  3. The edit page for your new email application check will open.

    • You must now add a synthetic check step to your email application check for it to function. (Your email application check will never become active if a synthetic check step is not added to it.)
  4. Proceed to add a synthetic check to the email check.

Add a Synthetic Check Step to the Email Application Check

The synthetic check step added in this procedure (only one step is typically required) makes use of two mail servers—an internal server to check (receive server), and a (preferably) external server off of which to reflect email (send server). The send server can be any working email account (you may wish to set up an email account just for this purpose) to which OmniCenter will connect using SMTP. By using two servers in this way, OmniCenter can also passively verify that a network is able to connect to the internet and properly send and receive emails.

After a synthetic check step has been added, the email application check must be left to run for a short time before you are allowed to configure alarms or add threshold checks to it. The application status will show as PENDING in the Application Performance page. When the status shows as OK, you may configure additional settings.

On the edit page for your email application check:

  1. Click the Add Custom Email Check button.
  2. On the Add Custom Check to Mail page:

    1. Enter a name or descriptive term for this step in the “Check Description” field.
    2. In the “Send” section:
      1. In the SMTP SERVER field, enter the domain name of the external mail server that will be used to send the test email.
      2. In the DESTINATION EMAIL field, enter the email address that will be tested.
      3. In the FROM EMAIL field, enter the email address that will be used to send the test email.
      4. Enter the account username and password of the FROM EMAIL address and check SMTP AUTHENTICATION. The username and password are optional, but most external mail servers require authentication to send mail.
    3. In the “Receive” section:
      1. In the RECEIVE SERVER field, enter the domain name of the internal mail server where the DESTINATION EMAIL resides. This is the email server that you want to check.
      2. Select the RECEIVE SERVER TYPE for that server.
      3. If a specific port on the RECEIVE SERVER must be used, specify it in the RECEIVE SERVER PORT field.
      4. Enter the account username and password of the DESTINATION EMAIL.
      5. Check USE SSL, if required by your email server.
    4. Click Save Synthetic Check.
    5. Proceed to configure the default threshold check.

Configure the Default Threshold for the Synthetic Check

This section is for performance monitoring.

The email application check includes a default threshold check with one variable for “Total Response Time.” This threshold check is configured separately from any additional threshold checks added to this check.

On the edit page for your email application check:

  1. Click the edit icon in the ACTIONS column of the single synthetic check.
  2. On the Edit Detail page for the synthetic check:
    1. In the “Edit Threshold” section, configure the individual WARNING and CRITICAL values for high, low and anomaly (as required) for VARIABLE ONE.

      • See the Configuration section of the Threshold Check page for detailed information about how to configure these settings.
  3. Proceed to configure the alarm and action group settings for the synthetic check.

Configure Alarm and Action Groups for the Synthetic Check

This section is for availability monitoring.

On the Edit Detail page of your synthetic check:

  1. In the “Custom Application Check” section, configure the alarm settings as necessary and select your desired action groups for notification.

    • See the Alarm Configuration Options section of the Service Check page for detailed information about how to configure these settings.
  2. Click Save Synthetic Check.
  3. Proceed to configure additional threshold checks for this synthetic check, if desired.

Configure Additional Threshold Checks

This section is optional. If you want additional performance monitoring for your email check, the following additional threshold checks are available.

  • Mail Send handshake time
  • Mail receive handshake time
  • Mail total send time
  • Mail total receive time

On the edit page for your email application check:

  1. Click the Thresholds tab at the top of the page.
  2. On the Threshold page:

    1. In the “Add Threshold” section, select the resource to monitor from the drop-down list and click Add Threshold.
  3. On the Add Threshold page:
    1. Configure the individual WARNING and CRITICAL values for high, low and anomaly (as required) for VARIABLE ONE.

      • See the Configuration section of the Threshold Check page for detailed information about how to configure these settings.
    2. Click Create Threshold.
  4. The new threshold check is added to the synthetic check and will begin collecting performance data automatically. No further configuration is required.
Note

Once a threshold check has been added to a synthetic check step, it cannot be removed—only disabled—on the Thresholds tab of the check.

Updated on April 2, 2019

Was this article helpful?

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support

Leave a Reply