Perfecto Monitor Settings

Last modified on May 14, 2021

Perfecto monitors run scripts on real mobile devices in Perfecto MobileCloud. Each monitor runs a specific script from your Perfecto Mobile script repository, on one or more devices. You can configure the run interval and other settings. For a detailed guide on Perfecto monitoring, see Perfecto Mobile Monitoring.

Note: Only Admin, Co-Admin and Power Users can change monitor settings.


Name (or Site Name in AlertSite 1.0)

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

Monitor ID (in AlertSite UXM)

Read-only. The monitor ID that can be used in AlertSite APIs.

Enable Monitoring (or Monitoring Is in AlertSite 1.0)

AlertSite UXM

On the Main tab, select or clear the Enable Monitoring check box to enable or disable monitoring.

AlertSite 1.0

Set Monitoring Is to Enabled to enable the monitor or Disabled to disable it.

Monitor ID (in AlertSite UXM)

Read-only. The monitor ID that can be used in AlertSite APIs.

Name (or Site Name in AlertSite 1.0)

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

Enable alerting

AlertSite UXM

Enable availability or performance alerts on the Alerts tab.

AlertSite 1.0

Set Notify on Error to 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.

Custom Properties

This section shows custom properties defined for your monitor. You can select a value for each property from the predefined list.



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 runs your Perfecto script. Keep in mind that Perfecto devices are single-threaded, so they need the time to complete the script, plus a little headroom.

Collection/Notification Mode (Monitoring Type in AlertSite 1.0)

Only for monitors that use 2 or more devices. This is the script run mode:

  • One Handset (Rotated) – Run the script on one device at a time, rotating through the selected devices.

  • All Handsets Simultaneously – Run the script on all selected devices at the same time.

Monitor Offset

The offset from the beginning of an hour, when the run starts. Use offsets to spread the monitoring over an hour between the various devices you have, so that no two monitors try to access the same device at the same time. For a 120-minute monitor, offsets 1-60 mean it will run on even hours (8 AM, 10 AM, and so on), offsets 61-120 – on odd hours (7 AM, 9 AM, and so on).

Monitor offset


Run interval, min Offset, min Monitor runs at ...
60 10 9:10, 10:10, 11:10, ...
20 5 5, 25 and 45 minutes past hour
120 15 6:15, 8:15, 10:15, ...
120 75 (1 hr 15 min) 7:15, 9:15, 11:15, ...

AlertSite QA Testing (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 or exclude your monitor in SmartBear regression testing, so we can make sure your monitors will work correctly after AlertSite updates. Participation is voluntary.

AlertSite UXM

You can set the default value for new monitors in  > Settings > Preferences > Monitor Defaults.

AlertSite 1.0

To set the default testing behavior for all new monitors, use the Default new devices to option in Account > Manage Account > Preferences.

Perfecto Settings

User ID and Password (or Userid and Password in AlertSite 1.0)

Your user ID and password in Perfecto MobileCloud.


The host name of your Perfecto MobileCloud host. For example,

Save and Test Perfecto Settings (in AlertSite UXM only)

Click this button to verify the specified Perfecto account settings.

Monitor Sharing

These options are available only in AlertSite UXM.

Select the Dashboard Tile 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 Tile Sharing check box will revoke the link.

Add/Edit Script

AlertSite UXM

You can choose the script to run, and the devices (handsets) to run it on. Once ready, click Save Script Settings.

Selecting Perfecto Mobile script and devices

Click the image to enlarge it.

To select the script to run, or replace the selected script:

  1. Click Add Script. You will see a list of folders and subfolders in your Perfecto Mobile script repository.

  2. Select a folder, then select a script from that folder.

To select the devices to run the script:

  1. Click Add a Device.

  2. Click the devices in the list to add them to the selection.

  3. Once ready, click Continue.

To delete a device from the selection, click next to that device.

To save the changes made, click either Save Script Settings or Save at the top.

AlertSite 1.0

To select a script and a device to run the script:

  • Click Scripts on the Manage Mobile Monitor screen.

  • In the Available Scripts list, select a script.

  • In the Available Handsets list select one or more devices.

  • Click Move left.

To delete the device from the selection, select it in the Selected Script/Handsets Pairs list and click Move right.

To save the changes made, click Submit at the upper right.

Monitor Alerts

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 using recipient groups.

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

Select this to send alerts when the monitor detects errors like timeouts or failed checkpoints. 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 1000 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.

To learn how to configure availability and performance alerts in AlertSite 1.0, see Opt in to Availability and Performance Alerts.

See Also

Perfecto Mobile Monitoring with AlertSite
Perfecto Mobile Monitoring

Highlight search results