---
sourceDocument: Zurich IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/it-operations-management

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Create and edit a synthetic monitor

# Create and edit a synthetic monitor {#ariaid-title1}

* Release version: Zurich
* 
* Updated June 8, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Create or edit a synthetic monitor to test the availability and performance of your HTTP endpoints before your users discover issues.

## Before you begin

* A configuration item (CI) for the endpoint you want to test.
* If you're testing private endpoints or want to run the monitors from your environment, one or more locations must be created to host the monitor. To create a location, see [Create synthetic monitoring locations](https://www.servicenow.com/docs/uJRenWoniJARdT7A3v6ZAQ "Create a synthetic monitoring location to run a synthetic monitor. If you plan to run monitors from a ServiceNow hosted location, you can skip this procedure.").

{#create-synthetic-monitor__ul_zlb_4rg_ngc}  
Note:  
For information about how to bulk create synthetic monitors, see the [Synthetic Monitoring Developer Guide](https://www.servicenow.com/docs/access?context=synth-monitor_dev-guide&version=zurich&pubname=zurich-api-reference&ft:locale=en-US).

Role required: sn_sow_synthetics.synthetics_editor or sn_sow_synthetics.synthetics_admin

## Procedure

1. Navigate to AllService Operations Workspace and select the synthetic monitoring icon (![Synthetic monitoring]()).
2. On the Overview page, either create a synthetic monitor or edit an existing one.
   * To create a synthetic monitor, select New.
   * To edit an existing one, select the link for the monitor you want to edit and then select the Details tab.
   {#create-synthetic-monitor__choices_xwp_lgj_d2c}
3. On the form, fill in the fields.
   1. In the Monitor details section, enter a unique name for the monitor and a description.
   2. In the HTTP settings section, fill in the fields.  
      {#create-synthetic-monitor__table_fyp_s2l_c2c__entry__2}

      | Field | Description |
      |-|-|
      | HTTP method | HTTP method that you want to monitor for the endpoint. Note: HEAD and OPTIONS methods aren't supported from a MID Server. |
      | HTTP endpoint CI | CI for the endpoint that you want the monitor to test. If the endpoint doesn't exist, choose Manage HTTP endpoints in CMDB to create a CI. |
      | Related service CI | Application service CI related to the HTTP endpoint. The entered value is used to create or update the CI relationship between the HTTP endpoint and the application service. |
      | Support group | Group who is notified and assigned alerts when this monitor fails. Note: To view this field in the HTTP Endpoints table, use the Synthetic Monitoring view. |
      | Query parameters | String of query parameters to include in the request URL. Note: The string shouldn't include the leading question mark. For example, use `id=xyz&customer=myco` instead of `?id=xyz&customer=myco`. |
      | Credentials | Credential needed if the endpoint requires authentication. OAuth, Basic Auth, and API keys are supported. |
      | Headers | Key-value pairs for the HTTP request headers. You can add multiple pairs. |
      | Body | Text that is used if the API expects a message body, such as a JSON snippet. |
      [Table 1. HTTP settings section]

      {#create-synthetic-monitor__table_fyp_s2l_c2c}
   3. In the Locations section, select one or more locations.  
      Choose a MID Server or Agent Client Collector location, or to run this monitor's test from your ServiceNow instance, choose ServiceNow hosted location.  
      Note:  
      When running tests from your instance, only six tests can be run every minute for performance reasons.

      Choose Create new location to create a location.
      For more information on how to create a location, see [Create synthetic monitoring locations](https://www.servicenow.com/docs/uJRenWoniJARdT7A3v6ZAQ "Create a synthetic monitoring location to run a synthetic monitor. If you plan to run monitors from a ServiceNow hosted location, you can skip this procedure.").
   4. In the Assertion section, define a successful test by selecting one or more criteria, an operator, and a value.  
      Note:  
      Multiple criteria are joined with an `AND` phrase, so the test must pass all criteria to be successful.
      {#create-synthetic-monitor__table_tt1_2nt_m2c__entry__2}

      | Criteria type | Description of success |
      |-|-|
      | Status code | Endpoint returns the given status code. |
      | Response time (in ms) | Endpoint response time is less than the given value. |
      | Response body | Endpoint sends a string value in the response body that matches the selected operator and given value. |
      [ ]

      {#create-synthetic-monitor__table_tt1_2nt_m2c}
   5. In the Frequency section, enter the number of minutes between each test run.
   6. **Optional:** To have an alert sent through Event Management when a test fails:  
      * In the Alert settings section, activate the toggle switch.
      * Select an alert severity for a test failure.
      * Add tags to the alert. For more information about using tags in alerts, see [Tag cluster alert grouping](https://www.servicenow.com/docs/wo2B9OTDXZtqeoO2xcMqkQ "Tag cluster alert grouping enables you to easily create groups of alerts. It is a non-code method of alert grouping that correlates alerts without having to use CMDB or model training. This simpler way of grouping similar alerts reduces the overall noise of a large quantity of alerts.").
      {#create-synthetic-monitor__ul_xkh_dtg_ngc}
   {#create-synthetic-monitor__substeps_eyp_s2l_c2c}
4. Select Save.

## Result

The Overview page for the synthetic monitor displays the results of the tests that the monitor runs. See [Identifying system issues with synthetic monitoring](https://www.servicenow.com/docs/VWO95JXxjrR_5VIDOs6Mlw "Tests run by synthetic monitors enable service owners and operators to view service endpoint performance at scale.") for more information.

*[\>]: and then