Round-Trip Email Monitors

The Roundtrip Email monitor tests the end-to-end functionality of your email server, that is, the actual email sending and retrieval. This monitor does the following:

In This Guide

Requirements

Creating a Round-Trip Email Monitor

Currently, round-trip email monitors can be created only in AlertSite 1.0 (classic interface). However, you can view and edit existing monitors in both AlertSite 1.0 and AlertSite UXM.

To create a round-trip email monitor:

  1. If you are using AlertSite UXM, select Settings > AlertSite 1.0 from the top menu to switch to AlertSite 1.0.
  2. In AlertSite 1.0, go to Configure > Sites and click Add a new site:

    AlertSite 1.0: Add a new site

    This will open the monitor configuration screen.

  3. Specify the monitor settings:

    Roundtrip email monitor settings

    Option Description
    Site Type Change to Roundtrip Email (POP/SMTP)
    Email Address The email address for the roundtrip test. AlertSite will send an email to this address, then access the mailbox, find and delete the test email. This must be a dedicated email address used only for this test.
    POP3 Server The mail server to access the inbox of Email Address. For example, mail.example.com (using default port 110) or pop3s://mail.example.com:995 (for SSL connection).
    Userid and Password The user name and password to access the Email Address on the POP3 Server. The user name is usually either the same as the email address, or the part before the @.
    SMTP Server Optional. The mail server to send the test message from, such as smtp.example.com (using default port 25) or smtps://smtp.example.com:465 (for SSL connection). This is not necessarily the same server as the one that hosts the Email Address.

    The SMTP server must not require authorization.

    Leave blank to send the test email via AlertSite mail server.
    Timeout Select the maximum value, usually 300 seconds (5 minutes).
    Check Every How often the round-trip email test should be run. This value must be greater than the Timeout.
    Site Name The monitor name that will be displayed in AlertSite dashboards, alerts and reports.
    Site Plan The billing plan for this monitor. If you have private locations and wish to run the monitor only at private locations, select the VM Node or InSite plan.
    Notify on Error? Select Yes (recommended) to be alerted when the email test fails.
  4. Click Submit in the top right corner. AlertSite will create the monitor and display additional settings.
  5. (Optional.) Click Locations in the top right corner and select the locations the monitor will run from. The default locations for all new monitors can be configured in your account settings.
  6. Click Test on Demand to test your monitor. The results will be displayed on the screen. If there are errors, review the monitor settings. See the Troubleshooting tips below.

Your monitor is now ready and will run the round-trip email test at the configured intervals. You will see the first results on AlertSite dashboards in a few minutes.

 

You can change the monitor settings at any time later if you wish. See Round-Trip Email Monitor Settings for a description of applicable settings.

Note: In AlertSite 1.0 (classic interface), only some of the displayed settings apply to round-trip email monitors.

Example: Gmail Round-Trip Test

In Gmail:

In AlertSite, use these settings for your round-trip email monitor:

Option Value
POP3 Server pop3s://pop.gmail.com:995
Email Address The Gmail email address you created.
Userid and Password The user name and password for this email address. The user name is the part before the @.
SMTP Server aspmx.l.google.com – this is Gmail’s restricted SMTP server, which allows sending mail only to Gmail and G Suite users.

Or, leave empty to send the test email via AlertSite mail server.

Troubleshooting

Common Error Codes

Monitor status 0 indicates a successful test, and any other statuses are errors. The following table lists common error statuses for round-trip email monitors. For a complete list, see AlertSite Status Codes.

Status Description
1 - TCP connection failed Possible reasons:
  • Your firewall may be blocking connections from our IP addresses.
  • POP3 Server specifies a wrong port number.
2 - Test timed out Possible reasons:
  • The specified SMTP Server requires authentication. Leave SMTP Server blank to use AlertSite SMTP Server instead.
  • Unable to connect to the POP3 Server.
    • Make sure the Userid or Password is correct.
    • If POP3 Server specifies a port number, make sure the port is correct.
3 - Invalid response from server

Possible reasons:

  • The specified Email Address does not exist. Double-check the spelling.
  • Wrong SMTP Server host name or port. Use one of the following formats.

    For non-secure SMTP:

    hostname
    hostname:port

    For SMTP over SSL/TLS:

    smtps://hostname:port
  • An SMTP protocol error when trying to send the test email. Check your SMTP server log.

6 - No response from server

We could not connect to the specified SMTP Server. If your SMTP server supports different ports, try a different port. Or, leave SMTP Server blank to send the email via AlertSite SMTP server instead.

51 - Unable to resolve IP address We could not resolve your POP3 and SMTP host names to IP addresses. Make sure POP3 Server and SMTP Server specify correct host names.

Troubleshooting Tips

Viewing Diagnostic Log

When troubleshooting round-trip email errors, use the diagnostic log to view the debug messages from the monitor. The diagnostic log is only available for regular monitor runs and not for tests on demand.

To view the log:

  1. In AlertSite UXM, go to Monitors > Summary and select your monitor.
  2. On the Availability History chart, click a time period. This opens a scatter plot where each dot corresponds to a monitor run.
  3. Click a dot, then click View Detail Report.
  4. In the report, click the icon in the table.

Below is a sample diagnostic log. The Message column contains the debug messages related to the SMTP and POP3 connections. Check the last few messages to see if any problems occurred before the error was triggered.

Roundtrip email monitor - diagnostic log

See Also

© 2017 SmartBear Software. All rights reserved.      Terms of Use · Privacy Policy