Documentation forSolarWinds Observability

Synthetic transaction commands

Synthetic transaction commands are used to define what your Synthetic transaction will 'do' to test your website. When you add a Synthetic transaction , you define the steps your Synthetic transaction will take through these commands.

The commands you provide commands include associated keyphrase tokens. Keyphrase tokens can contain from 1 to 3 keyphrases. Only a valid combination of all associated keyphrase tokens make up a command. You can enter a command by completing one of the following methods.

  • Picking a suggested element from the autocomplete options

  • Typing or pasting a custom CSS selector

In this topic, the Synthetic transaction commands are separated into Instructions and Assertions. See the tables below for a full list of commands that can be used in your Synthetic transaction definition.

Instructions

Instructions have your Synthetic transaction complete an action, such as going to a specified URL or clicking a hypertext link. See the table below for a full list of Instructions that can be used in your Synthetic transaction definition.

Command Explanation
Go to url URL Directs the browser to navigate to the URL. This must be the first step in the Synthetic transaction, but can also be used for subsequent steps.
click element Clicks the provided element.
fill in field element with text Fills the provided text field element with the provided text value.
check radio/checkbox Checks the provided radio/checkbox element.
uncheck radio/checkbox Unchecks the provided radio/checkbox element.
sleep for number seconds Waits for the amount of time set in seconds before resuming.
select dropdown element with item Locates the provided select element and selects the provided item option from it.
submit form form Triggers a submit action on the provided form element.
wait for element element to exist Waits for the provided element to exist.

Validations

Validations are similar to instructions and can be used in your Synthetic transaction definition to validate an aspect of your website. See the table below for a full list of validations that can be used in your Synthetic transaction definition.

Command Explanation
URL should be URL Asserts that the current URL matches the one given in URL.
element should exist Asserts that there is an element that matches the provided text element.
element should not exist Asserts that there is not an element that matches the provided text given in element.
element should contains text Assets that the first provided text element contains the value given in text.
element should not contain text Asserts that the first provided text elementdoes not contain the value given in text.
Assert checked radio/checkbox Asserts that the first provided checkbox or radio is considered as checked.
Assert not checked radio/checkbox Asserts that the first provided checkbox or radio is not considered as checked.
Dropdown element with name item should be selected Asserts that the first element has the dropdown option given in item as selected.
Dropdown element with name item should not be selected Asserts that the first element does not have the dropdown option given in item as the selection.