Introduction

The Synthetics section displays the configured synthetic monitors. After creating a synthetic monitor, click the desired monitor to view details such as Overview, Metrics, and Monitors.

Dashboard

The dashboard displays the total number of configured synthetics, the status of each synthetic configured on the Infrastructure page, Add, Delete button, and a Refresh button.

Status of synthetics

Status of Synthetics
FieldDescription
Indicates the total number of created synthetic monitors.
Indicates the number of synthetic monitors that are up and running.
Indicates the number of monitors that have Open, Warning or Critical alerts.
Indicates the number of monitors for which the template thresholds are not configured and are facing issues.
To add synthetic monitors.
To delete synthetic monitor.
To refresh the Synthetic items.
To search for any Synthetic monitor.

Overview

Overview displays various details like basic information, metric type, availability log, and recent log.

Overview

Overview

Metric type

Metric type displays a graphical representation of each metric for a selected synthetic monitor.

Basic information

Basic Information section displays the fundamental information about the selected synthetic monitor. For example, the type of synthetic monitor, the time period since the synthetic monitor is UP/DOWN, Response Time (if any), configured URL, Frequency, Locations, and Service.

Availability log

Availability Log section displays the log details of the availability status (Up or Down) for the selected synthetic monitor. The Availability Log section displays a view Root Cause icon when the availability status of the synthetic monitor is Down. The view Root Cause displays the root cause for the unavailability of the synthetic monitor.

Availability Log

Availability Log

View root cause

To view Root Cause in Availability Log:

  1. From the Availability Log section, click view Root Cause.
    The Last Collected Root Cause Analysis window appears.
  2. From the Last Collected Root Cause Analysis window, analyze the below details from the configured location.
    • Analysis started time – The Root Cause Analysis (RCA) collection start time.
    • Analysis ended time – The RCA collection end time.
    • Analysis elapsed time – The time taken to perform the RCA.
    • Initial Validation – Displays the reason for the Down availability status for the selected synthetic monitor.
    • TraceRoute Test – Displays details that allow you to debug the issue.
      Last Collected RCA

      Last Collected RCA

TraceRoute test

The TraceRoute Test section focuses on the reachability of the host from a configured location. The status of the synthetic monitor displays Down (red color) when the configured host is inaccessible from the configured location in the OpsRamp console. The TraceRoute Test information helps you to analyze and track the exact point of failure.

Traceroute Test

Traceroute Test

The TraceRoute Test section displays the following details:

  • Route Info – The path taken by packets from the configured location to the host.
  • Error Log – Displays that Traceroute is a failure.

Recent log

Recent Log displays information about the recently collected metrics.

Attributes

Attributes display all basic information on the configured synthetic monitor.

Attributes

Attributes

Location availability

Location availability highlights the uptime or downtime of a synthetic monitor from each location.

HTTP test

For HTTP/HTTPS monitors, OpsRamp provides HTTP Response Headers and HTTP Raw Response Time to identify the issue that makes your website unavailable at a location. The HTTP Test section displays the following:

  • URL: Refers to the URL of the website.
  • Method: Refers to the REST method of the connected website.
  • Status Code: Refers to the HTTP response code or Libcurl error code of the Website.
  • Response Headers: Refers to the HTTP response headers of the website.
  • Raw Data Response: Refers to the HTTP response provided by the website.
  • Status: Refers to the success or failure of the test.
HTTP Test

HTTP Test

Monitors

Displays templates and monitors assigned to the configured synthetic monitor.

Templates

Displays the templates available for the selected synthetic monitor. You can assign templates to enable the monitoring of your synthetic using the Assign Templates option. You can also implement a device management policy on specific synthetic resources.

Filter Criteria - Device Management Policy

Filter Criteria - Device Management Policy

Use the following synthetic types to filter:

  • HTTPS
  • HTTP
  • TCP
  • PING
  • UDP
  • DNS
  • SMTP
  • POP3
  • IMAP
  • SCRIPT
  • SSL
  • FTP
  • SIP
  • RTT

Assigning templates

OpsRamp can start monitoring 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 create templates using Setup > Monitoring > Templates.

To assign templates:

  1. From Templates, click Assign Templates.
    Apply Templates screen is displayed.
    Apply Templates

    Apply Templates

  2. From Select Templates > Available templates, select the desired templates.
    Selected templates display the chosen templates.
  3. Click Assign.
    Enter Configurations section is displayed.
    Enter Configurations

    Enter Configurations

  4. Provide Value for the Assigned Templates and Configuration Parameters and click Submit.
    Configuration Parameter and Value

    Configuration Parameter and Value

    The templates screen displays the selected templates.

The following table describes the configuration parameters for each monitor:

Configuration Parameters for synthetic monitors
Synthetic MonitorConfiguration ParametersDescriptionExample
HTTP/HTTPSConnection Timed OutMaximum time out required to connect to the given website.5 seconds [1-540]
HTTP Headers-{"Accept":"application/json","Content-Type":"application/json"}
HTTP Parameters-{"Content-Type":"application/json"}
Response Should ContainCheck the presence of any text in the response of the URL.True
Response Should Not ContainCheck the absence of any text string in the response of the URL.Null
MethodType of method to execute while monitoring the website.GET
Validate SSLValidate the SSL certificate of the URL under consideration.
Important:This option lets you validate only the last redirected website.
-
DNSConnection Timed OutMaximum time out to resolve the DNS Query.5
Expected ServerThe expected IPV4 address.1.2.3.0
Name ServerConverts the English URL to physical IP Address.8.8.8.8
PINGConnection Timed OutMaximum time out to verify the accessibility of the chosen host.5
TCPConnection Timed OutMaximum time out to connect to a given port of the TCP server.5
DaysConfigure the number of days to set notification regarding the SSL expiry in the Days field.10
PortPort number of TCP port. You must manually configure the port number.443
Response Should ContainCheck the presence of any text string in the response of the TCP server.True
Response Should Not ContainCheck the absence of any text string in the response of the TCP server.Null
Command/Message to SendThe command that is sent to the TCP server.Tokens
Validate SSLValidate the SSL certificate of the URL under consideration. Important:This option lets you validate only the last redirected website.-
UDPConnection Timed OutMaximum time out to connect to a given port of the UDP server.5
PortPort number of UDP port. You must manually configure the port number.80
Response Should ContainCheck the presence of any text string in the response of the UDP server.true
Response Should Not ContainCheck the absence of any text string in the response of the UDP server.null
Command/Message To SendThe command that is sent to the UDP server.tokens
IMAPConnection Timed OutMaximum time out to connect to the IMAP server.5
PortPort Number of IMAP server.993
POP3Connection Timed OutMaximum timeout to connect to the IMAP server.5
PortPort Number of POP3 server.110
SMTPConnection Timed OutMaximum time out to send an email through the SMTP server.5
PortPort Number of SMTP. The default port number is 587. However, if you wants to configure SMTP synthetic monitor with different port numbers: 465, 25; then you must configure those port numbers manually.587
Command/Message To SendThe message that is sent to the SMTP server.Tokens
Recipient Email IdsThe Email IDs of the recipients.abc@gmail.com
RTTConnection Timed OutMaximum time out to perform the RTT monitoring.5
PortPort number for SMTP.587
Receiver HostIMAP/POP3 hostname.pop.gmail.com
Receiver Host PortIMAP/POP3 host port number.995
Email Receiver TypeIMAP/POP3 host port number.IMAP
SSLConnection Timed OutMaximum time out to connect to a host or a website.5
DaysChecks the number of days remaining field.10
FTPConnection Timed OutMaximum timeout to connect to the FTP server.4
PortPort number of the FTP server.21
SCRIPT – HTTP Synthetic Transaction Synthetic MonitorConnection Timed OutMaximum time out to complete the synthetic transaction.5
Script TypeProvide content from the .side file.-

Unassigning templates

You can remove an assigned template from the monitor. Use the Unassign Templates option to unassign the templates from the synthetic monitors. OpsRamp removes every graph associated with the templates.

Unassign Templates

Unassign Templates

Monitors

Monitors allow you to configure alerts and edit threshold values assigned to any metric in the selected synthetic monitor.

Monitors

Monitors

Availability rule

Availability lets you configure rules to confirm the status of the resources with the availability check depending on the critical alerts received for the metrics.

Availability Rule

Availability Rule

After clicking Availability Rule, select one of the following options to determine the status of the resource:

  • Resource is Up if ALL availability monitors are OK, Resource is Down otherwise
  • Resource is Up if ANY availability monitor is OK, Resource is Down otherwise

Parameters

Parameters display the parameters migrated from synthetics to the monitoring templates section. You can modify the values for the migrated parameters of the selected synthetic monitor.

Parameters

Parameters

Metrics

Metrics displays a pictorial representation of all metrics configured in the assigned templates.

Synchronize tooltips

Synchronize Tooltips
TooltipDescription
Enable or disable tooltips.
Decrease (S) or Increase (L) the size of the graphical representations for each metric.

Credentials

Credential Set enables you to create or assign credentials to your synthetic monitors. You can use these credentials to mask plain text usernames and passwords in the synthetic script.

Notes

Notes enable you to record special instructions for any synthetic monitor under consideration.

Notes

Notes

To add Notes:

  1. Click Add displayed on the Notes window.
  2. On the Notes window, provide the required details.
  3. Click Save.

You can modify existing notes from the Notes window using Edit Notes.

Articles

Articles display notes tagged to the configured synthetic monitor.

Articles

Articles

ADD/MODIFY

The ADD/MODIFY option allows you to add or remove articles for the selected synthetic monitor.

To ADD/MODIFY articles:

  1. Click ADD/MODIFY.
    The Articles window appears.
  2. Select the check-box of desired articles from the Articles window.
  3. Click Add.
    The Articles section displays the selected articles.

What to do next