Last modified on February 12, 2018

In AlertSite, API monitors test SOAP and REST web services to make sure they are working correctly. API monitors are powered by Ready! API or SoapUI tests, and have a number of settings that control the monitoring behavior.

Notes:

  • 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.

Common

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 Project, Upload Project (in AlertSite UXM)

Use these buttons to download the SoapUI project to your computer, and upload a new project. See Managing the SoapUI Project below.

Main

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.

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 API 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.

Notes

  • Rotated locations are not available for monitors that use private locations.

  • 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.

When using the Round Robin or SLA (MultiPOP) monitoring mode, you need at least 2 locations per interval.

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

Applies only to monitors using the Usage-Based Monitoring plan. If local retry is enabled, then whenever the monitor finds an error, it will repeat the test from the same location to see if the problem is temporary. If the retry succeeds, no alert is triggered. For more information, see Local Retry and Global Verification.

Note: The retry consumes extra measurement credits.

Enable AlertSite QA Testing (or Disable 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 keep SoapUI logs from test runs for later analysis. The logs include complete requests and responses (URL, headers, body, HTTP status code) and the details of any errors occurred. This can help troubleshoot failed tests.

Select the level of logs to store:

  • Disabled – Do not store SoapUI test logs.

  • Errors Only – (Default) Store SoapUI logs for just failed test steps.

  • All Steps on Error – Store SoapUI logs for all test steps, but only if the test failed.

  • All Steps – Always store SoapUI logs, even for successful runs.

The last 2 values are available for Usage-Based Monitoring accounts only, and consume 0.5 measurement credits per capture.

You can view SoapUI logs:

  • in the test step details on the Monitor Runs dashboard
  • in the Detail report by clicking the Camera camera icon.

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

Advanced

SSL Options

These options apply only if your SoapUI monitor tests an API accessed over HTTPS.

SSL Version

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

SSL Certificate

If your SoapUI test uses a keystore or a client SSL certificate, upload this certificate or keystore to AlertSite, and then select it from this list. The certificate will be automatically installed to the AlertSite global locations selected for this monitor. For details, see Using SSL Certificates and Java Keystores.

Note: Certificates are not distributed automatically to private locations (Private Node Server and InSite). If you need to install a certificate to a private location, please contact our Support Team.

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.

Transaction Trace

Enable Transaction Trace (or Transaction Trace in AlertSite 1.0)

This option enables or disables AppDynamics transaction tracing for the monitor (see AppDynamics Integration). If it is selected, AppDynamics captures server-side transaction snapshots for all API calls made by the monitor. The snapshots contain code-level details like the slowest methods and SQL queries, and can help troubleshoot performance issues. You can access these snapshots from the Monitor Runs dashboard.

Note: AppDynamics transaction tracing is supported in AlertSite Enterprise only.

Project Information (or SoapUI Monitor Configuration in AlertSite 1.0)

This section shows various information about the SoapUI test the monitor runs, including:

  • The project name
  • The test suite name
  • The test case name
  • The names of the steps in the test case

This information is read-only. To select another test case to run, upload the project and select a new test case.

Locations

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

Alerts

Here you can configure availability and performance alerts for the monitor or individual steps. 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.

Monitor Alerts and Step Level Alerts (in AlertSite UXM)

If the monitor has multiple steps, you can configure alerts for the whole monitor or individual steps. Use these tabs to switch between monitor-level and step-level configuration.

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.

Notes:

  • 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.

Manage the SoapUI Project

Update or Replace the Project

  1. Download the project to your computer.

  2. Change it in Ready! API or SoapUI.

  3. Upload the updated project in the monitor settings in AlertSite.

Download SoapUI Project

Click Download Project to download the zipped SoapUI project used by the monitor to your computer. You can open the downloaded project in Ready! API or SoapUI by using the File > Import Packed Project menu item.

Upload New Project

  1. In Ready! API or SoapUI, export the project as a .zip file. To do this, right-click the project in the Navigator and select Export Project from the context menu.

  2. In AlertSite, open your SoapUI monitor settings.

  3. (AlertSite 1.0 only) Click Manage API Project.

  4. Click Upload Project, browse for the exported project and proceed from there.

See Also

Create API Monitor From SoapUI Test
SoapUI Monitors