FTP Monitor Settings

This topic describes the configuration settings for FTP monitors. You can change the monitoring locations, run intervals, timeouts and other settings.



Monitor Name

The monitor name that appears in dashboards and reports. For example, Customer Login.


On – the monitor is enabled.

Off – the monitor is disabled.


On – the monitor sends alerts. You can specify which alerts to send (availability, performance or both) in the Alerts section.

Off – the monitor does not send any alerts.



Measurement Plan

The monitoring plan used for this monitor.


The host name of the FTP server, optionally with a directory path. For example:


If a directory path is specified, the monitor will use the CWD command to change the working directory to the specified one.

Note: To monitor the server by the IP instead of the host name, leave Host blank, unselect Resolve DNS, and enter the IP Address (IPv4 only).

Run Interval (Minutes)

How often the monitor checks your FTP server. Possible values depend on the selected Measurement Plan.

Timeout (Seconds)

The connection timeout, in seconds. If AlertSite cannot establish a connection to your server within this time interval, it will report status 1 (TCP connection failed), and an alert will be triggered. Default: 30 seconds.

Monitor Note

Leave a note for yourself or other users. This note will appear on the AlertSite Dashboard when you hover over the note icon. Note text can be up to 255 characters long.


Monitoring Mode

The monitoring mode controls if locations check your website simultaneously or sequentially, and when they send alerts. See Monitoring Modes for possible values and details.

Rotate Locations

For each monitor, you define a location pool. Rotation means the monitor uses a subset of this location pool (say, 2 out of 10 locations) on every run, cycling through the locations. If rotation is not used, the monitor checks from all of its locations every time.


Locations Per Run

If Rotate Locations is selected, you need to specify the number (subset) of locations to use for each monitor run. This value ranges from 1 to the total number of locations you selected for the monitor.

If Monitoring Mode is Round Robin or SLA (MultiPOP), you need at least 2 locations per interval.

Enable Local Retry

Used only for Usage-Based Monitoring plans. Controls the monitor behavior when it finds errors. Select this to retry the test from the same location to see if an error was just a temporary error. Clear to suppress the retry on errors.

Note: The retry consumes extra measurement credits.

Allow AlertSite QA Testing

Before releasing AlertSite updates, SmartBear runs regression tests to make sure that both existing and new functionality work correctly. Select this check box to include your monitor in SmartBear regression testing, so we can make sure your monitors will work correctly after AlertSite updates. Participation is voluntary.


Attempt file upload to FTP server

If this option is selected, AlertSite will test the file upload and download on your FTP server. An upload/download test works as follows: AlertSite generates a small test file with a random name, uploads this file to your tested server, then downloads this file, and compares the uploaded and downloaded files. The uploaded file will be removed afterwards.

If your FTP Host includes a subpath, such as ftp.example.com/path/subpath, AlertSite will upload the file to the specified directory on the server.

Note: A file upload requires that your FTP server supports passive FTP. You also need to specify the FTP Username and FTP Password of a user with read/write permissions on your server.

Resolve DNS?

If this is selected, AlertSite will connect to your FTP server using the Host name. If this is unselected, AlertSite will use the IP Address instead.

IP Address

This option is displayed only if Resolve DNS? is unselected. It specifies the IP address (IPv4) of the tested FTP server. AlertSite will connect to the server using this IP address instead of the Host name.


Optional. The port number on your FTP server that AlertSite will connect to. The default ports are 21 for FTP and 990 for FTPS (FTP over SSL).

TCP Traceroute on Error

If this is selected, the monitor runs a TCP traceroute to your website when it detects a network connectivity problem (status 1 or 2), and sends results to all email alert recipients. The traceroute shows the path that data packets are taking from a monitoring location to your server, and can help administrators and engineers troubleshoot problems.


SSL Options

These options apply only to FTPS (FTP over SSL/TLS) monitors.

Version of SSL Protocol to use when connecting

If your FTP server requires a specific SSL or TLS version for client connections, select the desired version from the list. Otherwise, select Auto-Detect, and the monitor and your server will select the protocol automatically.

Use user-supplied client certificate when connecting

If your FTP server requires a client-side SSL certificate to access it, you need to upload your certificate to AlertSite. To do this, go to Settings > AlertSite 1.0 > Configure > SSL Certificates, upload the certificate, and then assign it to your monitor. For detailed instructions, see Using SSL Certificates and Keystores. This approach works if you use AlertSite’s public locations.

If you use private locations, please send the certificate to SmartBear Support, along with your API monitor name, location name, and also your company name and customer ID from the profile > Account screen. You will be informed when the certificate is in place. After that you can do a test on demand to verify the monitor.

FTP Authentication

You need to specify the FTP Username and FTP Password if your FTP server requires authentication, or if Attempt file upload to FTP server is selected. In the latter case, the specified user must have read/write permissions on your FTP server.

For anonymous access, use anonymous as the user name. Any password should work, but it is common to use the password guest or your email address. Some FTP servers explicitly require passwords in the form of an email address.


Select one or more locations to monitor you FTP server from. For details, see Selecting Locations for Monitoring.


Here you can configure availability and performance alerts for the monitor. To receive alerts, you need to have alert recipients configured. By default, the monitor sends alerts to all configured recipients, but you can target alerts to specific recipients by selecting recipient groups for this monitor.

Recipient Groups

Select the recipient groups that will receive alerts from this monitor. The recipient groups must have been previously created in Alerts > Alert Recipients.

If the monitor is not assigned to any recipient group, it sends alerts to all the recipients configured in your AlertSite account.

Note that adding a monitor to the recipient group overrides any step-level associations for that recipient group. So if you want to add individual steps to a group, remove the monitor from that group first.

Availability Alerts

Select this check box to send alerts when the monitor detects errors like HTTP errors, timeouts, or incorrect website content. The monitor status turns red in these cases.

Alert Notes

Monitor-specific notes that can be included in email and JSON alerts (availability alerts only), up to 255 characters long. Note that to actually add these notes to alerts, you need to configure alert templates to include the $ALERT_NOTE variable.

Performance Alerts

Select this to send alerts when the monitor response time exceeds the specified value. See Performance Alerts for a description of available settings and to learn how to set up these alerts. Note that, for multi-step monitors, the response time thresholds should include the total response time for all test steps.

See Also

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