Assign Synthetic Monitor Templates

Monitoring starts only after assigning the templates to your synthetic monitor.

You can assign only one template per synthetic monitor. Monitoring does not work as expected if you assign more than one template.
You can assign templates that pertain to a specific synthetic monitor. For example, you can assign DNS Templates to DNS synthetic monitors and not to PING synthetic monitors.
You can create templates using Setup > Monitoring > Templates.
You can select the following basic details while creating a template:
- Collector Type: Synthetics
- Applicable For: Synthetics
- Type: Select the synthetic monitor
To get alerts for configured metrics from all the configured locations assigned to a template, you must enable the Alert option and configure the Component Threshold for each metric while creating the template.

Assign Templates

Select a client from the All Clients list.
Select Infrastructure > Resources > Synthetics and click a synthetic monitor or create a new monitor.
Select the monitor and click +Assign Templates from the Templates screen. The Apply Templates screen is displayed.
From Select Templates > Available Templates, select the templates. The Selected Templates will be displayed.
Click Assign. The Enter Configurations section is displayed.
Enter Value for the Assigned Templates and Configuration Parameters.
Click Submit.

The selected templates are displayed in the templates screen.

Note

You can assign only one template per synthetic monitor. Monitoring does not work as expected if you assign more than one template.

Configuration Parameters

The following table describes the configuration parameters for each monitor:

Synthetic Monitor	Configuration Parameters	Description	Values/Example
HTTP	Timeout	Connection timed out. Maximum time-out required to connect to the given website.	Default value: not NULL Valid values: 1 - 540 seconds Example: 80
	HttpHeaders	HTTP headers	Default value: empty string Valid values: valid JSON Example: {"Accept":"application/json","Content-Type":"application/json"}
	HttpParams	HTTP parameters	Default value: empty string Valid values: valid JSON Example: {"Content-Type":"application/json"}
	ShouldContain	Response body should contain specific content. Check the presence of any text in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: test <123> _testing # test
	ShouldNotContain	Response body should not contain specific content. Check the absence of any text string in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: test123_sample # testing
	Method	Method. Type of method to execute while monitoring the website.	Default value: GET Valid values: GET, PUT, HEAD, POST Example: GET
	PostData	Post data.	Default value: empty string Valid values: ASCII only Example: name123<123*%#&!>1234567
	Expected Response Code	The response code returned from the end server should be one from the mentioned response codes (which is in csv format).	Default value: NULL (OpsRamp considers 200 and 300 series as default at the backend) Valid values: 100, 200, 300, 400, 500 series response codes Example: 401, 402, 404
	Payload Regular Expression	Create Regex Patterns to validate the HTTP Response body received from the webserver.	Default value: NULL Example: john\|Bat\|check
HTTPS	Timeout	Connection timed out. Maximum time-out required to connect to the given website.	Default value: not NULL Valid values: 1 - 540 seconds Example: 80
	HttpHeaders	HTTP headers	Default value: empty string Valid values: valid JSON Example: {"Accept":"application/json","Content-Type":"application/json"}
	HttpParams	HTTP parameters	Default value: empty string Valid values: valid JSON Example: {"Content-Type":"application/json"}
	ShouldContain	Response body should contain specific content. Check the presence of any text in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: test <123> _testing # test
	ShouldNotContain	Response body should not contain specific content. Check the absence of any text string in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: test123_sample # testing
	Method	Method. Type of method to execute while monitoring the website.	Default value: GET Valid values: GET, PUT, HEAD, POST Example: GET
	SslValidation	Validates the SSL certificate of the URL under consideration. This option validates only the last redirected website.	Default value: False Valid values: True or False Example: FALSE
	PostData	Post data.	Default value: empty string Valid values: ASCII only Example: name123<123*%#&!>1234567
	Expected Response Code	The response code returned from the end server should be one from the mentioned response codes (which is in csv format).	Default value: NULL (OpsRamp considers 200 and 300 series as default at the backend) Valid values: 100, 200, 300, 400, 500 series response codes Example: 401, 402, 404
	Payload Regular Expression	Create Regex Patterns to validate the HTTP Response body received from the webserver.	Default value: NULL Example: john\|Bat\|check
DNS	Timeout	Connection timed out. Maximum time-out to resolve the DNS Query.	Default value: not NULL Valid values: 1 - 540 seconds Example: 5
	ExpectedIp	Expected server address.	Default value: empty string Valid values: ipv4 and ipv6 validation Example: 111.22.333.00
	NameServer	Name server - Converts the English URL to a physical IP Address.	Default value: empty string Valid values: hostname validation, ipv4 validation, and valid url Example: www.google.com, 111.22.333.00
FTP	Timeout	Connection timed out. Maximum time-out to connect to the FTP server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 180
	Port	Port number of the FTP server.	Default value: 0 Valid values: 0 - 65535 seconds Example: 21
PING	Timeout	Connection timed out. Maximum time-out to verify the accessibility of the chosen host.	Default value: not NULL Valid values: 1 - 540 seconds Example: 180
POP3	Timeout	Connection timed out. Maximum time-out to connect to the server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 180
	Port	Port number of the server.	Default value: 0 Valid values: 0 - 65535 seconds Example: 995
IMAP	Timeout	Connection timed out. Maximum time-out to connect to the server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 540
	Port	Port number of the server.	Default value: 0 Valid values: 0 - 65535 seconds Example: 993
RTT	Timeout	Connection timed out. Maximum time-out to do the RTT monitoring.	Default value: not NULL Valid values: 1 - 540 seconds Example: 540
	Port	Port number.	Default value: 0 Valid values: 0 - 65535 seconds Example: 465
	ReceiverHost	Receiver host name.	Default value: empty string Valid values: string Example: pop.gmail.com
	ReceiverHostPort	Receiver host port number.	Default value: 0 Valid values: 0 - 65535 seconds Example: 995
	EmailReceiverType	Email receiver type	Default value: IMAP Valid values: IMAP, POP3 Example: IMAP
SCRIPT	Timeout	Connection timed out. Maximum time-out to connect to the server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 80
	PostScreenshotOnError	Post a screenshot of a failure in the HTTP script synthetic transaction at the time of failure.	Default value: False Acceptable values: True/False Example: FALSE
	PostSuccessScreenshotAlongWithError	Post a screenshot from a previous successful iteration so that you can compare the case that failed with the one that is successful.	Default value: False Acceptable values: True/False Example: FALSE
	WebBrowserType	Option to choose a web browser type to run the HTTP Synthetic Transaction against.	Default value: Google Chrome Acceptable values: Google Chrome, Mozilla Firefox, Microsoft Edge
SMTP	Timeout	Connection timed out. Maximum time-out to send an email through the SMTP server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 540
	Port	Port number.	Default value: 0 Valid values: 0 - 65535 seconds Example: 465
	MessageToSend	The command or message that is sent to the server.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: sample # test < name >
	RecipientList	The Email IDs of the recipients.	Default values: empty string Valid values: Email address with comma separators. Example: abc@gmail.com
SSL	Timeout	Connection timed out. Maximum time-out to connect to the server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 180
TCP	Timeout	Connection timed out. Maximum time-out required to connect to the server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 180
	Port	Port number.	Default value: 0 Valid values: 0 - 65535 seconds Example: 80
	ShouldContain	Response body should contain specific content. Check the presence of any text in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: testing_123
	ShouldNotContain	Response body should not contain specific content. Check the absence of any text string in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: 123 # name_ < string >
	MessageToSend	The command or message that is sent to the server.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: 1234
	SslValidation	Validates the SSL certificate of the URL under consideration. This option validates only the last redirected website.	Default value: False Valid values: True or False Example: FALSE
UDP	Timeout	Connection timed out. Maximum time-out required to connect to the server.	Default value: not NULL Valid values: 1 - 540 seconds Example: 180
	Port	Port number.	Default value: 0 Valid values: 0 - 65535 seconds Example: 37
	ShouldContain	Response body should contain specific content. Check the presence of any text in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: sample.123 #
	ShouldNotContain	Response body should not contain specific content. Check the absence of any text string in the response of the URL.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: Testing123. name< string >
	MessageToSend	The command or message that is sent to the server.	Default value: empty string Valid values: Alphanumeric characters, underscore (_), pound (#), period (.), less than (<), greater than (>), and spaces. Example: name123#

Configure the Component Level Threshold for Metrics

Once the templates are created, the user must configure the component level threshold for metrics to receive the alert.

Follow the steps below to configure the component level threshold for metrics:

Select a client from the All Clients list.
Navigate to Infrastructure > Resources > Synthetics.
Select an existing synthetic resource or create a new synthetic resource by clicking ADD button.

Go to Monitor > Monitor.
You should now see the list of Synthetics Templates Metrics. Click the Edit Symbol of a metric to update the component threshold.

The page Edit Metric Threshold will now appear. Click + Add button and enter the information in the following fields:.
- Location: Public or Private synthetic collector
- Alert checkbox: To get alerts for configured metrics, enable the **Alert option
- Warning Threshold
- Critical Threshold
- Repeat Count

Click Update.
Once the component threshold has been successfully updated, you will receive a confirmation page.

Unassign Templates

You can remove an assigned template from the monitor. Use the Unassign Templates option to unassign the templates from the synthetic monitors. Every graph associated with the templates is removed.