Last modified on March 2, 2018

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


  • You must be an Admin, Co-Admin or Power User to change the monitor settings.

  • It may take a few minutes for the changes to take effect.

  • You can set the default settings for new monitors in  > Settings > Preferences > Monitor Defaults in AlertSite UXM, or in Account > Manage Account in AlertSite 1.0.


Monitor Name (or Site Name in AlertSite 1.0)

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

Monitoring (or Monitoring Is in AlertSite 1.0)

AlertSite UXM

On – The monitor is enabled.

Off – The monitor is disabled.

AlertSite 1.0

Select Enabled to enable the monitor or Disabled to disable it.

Alerting (or Notify on Error in AlertSite 1.0)

AlertSite UXM

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.

AlertSite 1.0

Select Yes to enable availability alerts for this monitor or No to disable availability alerts. Performance alerts are configured separately by clicking the Performance Alerts button in the top row.

Download Script (or Download JAR in AlertSite 1.0)

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 (or Upload JAR in AlertSite 1.0)

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.

AlertSite UXM

Click to run a test on demand.

AlertSite 1.0

Click the Test On Demand button.



Measurement Plan (or Site Plan in AlertSite 1.0)

The monitoring plan used for this monitor.

Run Interval (Minutes) (or Check Every in AlertSite 1.0)

How often the monitor checks your website. Possible values depend on the Measurement Plan selected for this monitor.

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 or error) is determined by the exit code of the JAR file.

Monitor Note (or Device Note in AlertSite 1.0)

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


Monitoring Mode (or Monitoring Type in AlertSite 1.0)

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.


  • Rotated locations are not available for monitors that use Private Node Server locations (private monitoring stations installed on your local network).

  • Usage-Based Monitoring plan allows rotated locations for the following monitoring modes: Round Robin, SLA (MultiPOP), Global Notify, and Global Verify.

  • Legacy plans (Performance Pro, SLA) support rotating through locations only for the Round Robin and SLA (MultiPOP) modes.

Locations Per Run (or Locations per Interval in AlertSite 1.0)

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 (or Monitoring Type in AlertSite 1.0) is Round Robin or SLA (MultiPOP), you need at least 2 locations per interval.

Enable Local Retry (or Disable Local Retry in AlertSite 1.0)

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 (or select in AlertSite 1.0) to suppress the retry on errors. To learn more about that, see Local Retry and Global Verification.

Note: The retry consumes extra measurement credits.

Allow AlertSite QA Testing (or Disallow AlertSite QA Testing in AlertSite 1.0)

Before releasing AlertSite updates, SmartBear runs regression tests to make sure that both existing and new functionality work correctly. Select (or clear in AlertSite 1.0) 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:

  • Web page screenshots.

  • HTML source code of web pages.

  • Request and response headers for all HTTP requests made during the page load (this includes the page itself, its images, scripts, Ajax requests, and so on).

  • Selenium run log with the console output from the JAR file.

This option specifies the amount of extra data to capture:

  • Disabled – Do not capture any extra data.

  • Error Only – Default. Capture extra data only for web pages that have error status, such as page timeout.

  • All Actions on Error – Capture extra data for all pages, but only if the monitor has error status. This option consumes 0.5 measurement credits per web page capture.

  • All Actions – Capture extra data for all pages, even if there are no errors. This option consumes 0.5 measurement credits per web page 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 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’Capture Level.

Browser Timeout

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

  • DOM Load (DOMContentLoaded) – the page’s HTML has been completely loaded and parsed, without waiting for stylesheets, images, and subframes to finish loading.

  • Page Load (load) – the page is fully loaded with all images, styles, and other resources (except for Ajax and Flash content).

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) (or Timeout Objects After in AlertSite 1.0)

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 or error status. They are only indicated in the reports by status 7002.


Monitor Sharing

These options are available only in AlertSite UXM.

Select the Dashboard Time Sharing check box to generate a public link for this monitor’s dashboard tile. You can share this link with your colleagues who do not have an AlertSite account, or use it to embed the monitor tile into external dashboards. For details, see Sharing and Embedding Monitor Tiles.

Unselecting the Dashboard Time Sharing check box will revoke the link.


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


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 (or Notifier Groups in AlertSite)

Select the recipient groups that will receive alerts from this monitor. The recipient groups must have been previously created in Alerts > Alert Recipients (or Notifiers > Notifier Groups in AlertSite 1.0).

If the monitor is not assigned to any recipient group, it sends alerts to all the recipients configured in your AlertSite account.
Note: 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 (or Notify on Error? in AlertSite 1.0)

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. To add these notes to alerts, you need to configure alert templates to include the $ALERT_NOTE variable. For details, see Adding Monitor-Specific Notes to Alerts.

Performance Alerts

Enable performance alerts if you wish to be notified 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.


  • In AlertSite 1.0, click the Performance Alerts button in the top left corner of the monitor configuration screen to view or change the performance alert settings.

  • For multi-step monitors, the response time thresholds should include the total response time for all test steps.

See Also

Website Monitoring With Selenium and AlertSite
Selenium Monitors