Selenium Monitor Settings

This topic describes the configuration settings for Selenium monitors. You can change the monitoring locations, run interval, 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.

Download Script

Click this button to download the JAR file used by this monitor. You can run it locally by using this command (provided that you have Java installed):

java -jar <path>\filename.jar

Upload Script

Click this button to upload a new JAR file to replace the one currently used.

Note: After you upload a new JAR file, the monitor is automatically disabled. You need to run a successful test on demand before you can enable the monitor again. Click to run a test on demand.



Measurement Plan

The monitoring plan used for this monitor.

Run Interval (Minutes)

How often the monitor checks your website. Possible values depend on your monitoring plan.

Step Timeout (Seconds)

The timeout for each web page opened by this Selenium monitor. This is the full page timeout, that is, the time to load the page including all of the images, JavaScript, CSS, Ajax content and other resources. If a page takes longer to load, it will have error status 7202 “Full page time out” in the reports.

Note: Timed out pages are indicated in run results but do not affect the overall monitor status (unless you designed your Selenium script to treat timeouts as errors). The monitor status (OK/error) is determined by the exit code of the JAR file.

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.


Capture Level

AlertSite can capture additional data about each web page used in your Selenium script. This includes:

This option specifies the amount of extra data to capture:

You can access the captured data from the Monitors > Runs screen, using the corresponding buttons in the expand run results. You can also see the captures in the Detail report by clicking the camera icon.

Note: You can also have the Selenium run log attached to email alerts if you configure alert recipients with the Attach server response to e-mail alerts option. This functionality does not depend on the monitor’s Capture Level.

Browser Timeout

When a browser loads a web page, it fires events to notify about the page loading progress, such as:

The browser timeout is the timeout to receive the DOM Load and Page Load events for a page. It is a “hard” timeout, meaning the Selenium script will be stopped if these events are not received within the timeout interval.

Fullpage Options

Object Timeout (seconds)

The time it takes for AlertSite to wait for each page asset (image, JavaScript file, CSS file, and so on) to load before reporting an object loading timeout. This value must be less than or equal to Step Timeout.

Timed out objects do not affect the monitor OK/error status. They are only indicated in the reports by status 7002.


Select one or more locations to monitor you website 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