Create a Test
Tests measure metrics in a time-bound manner to produce a static measurement for the given duration. Tests have two sub components namely, Steps and Tasks. A Test is a collection of Steps, and a Step is a collection of Tasks. In Tests, Tasks under Steps are run parallel and each Step runs for the duration you configure. For more information, see Tests and Monitors Overview.
To create a Test:
Do one of the following to access the Measurement Designer page:
Access Measurement Designer page through the Tests page.
Navigate to the Tests (Observability > Active Assurance > Tests) page.
The Tests page appears.
Click the Add (+) icon.
The Create new page appears.
The Create new page displays Both, Tests, and Monitors mode, and the Tests mode is enabled by default.
Select the + Create blank Test.
The Measurement Designer page appears.
Access Measurement Designer page directly.
Navigate to the Measurement Designer (Observability > Active Assurance > Measurement Designer) page.
The Create new page appears.
The Create new page displays Both, Tests, and Monitors modes, and the Both mode is enabled by default.
Select the Tests mode.
Select the + Create blank Test.
The Measurement Designer page appears.
Specify a name for the Test.
Click the Sequence Name or click the Edit (pencil) icon to enter a name for the Test in the Sequence Name text box.
Sequence Name is the placeholder name for the Test.
Click + Add Step to add Steps for a Test.
Note:You cannot run a Test if you have not specified the Test Name. Also, the first Step is available by default in the GUI.
For the Step, you can do the following:
(Optional) Edit the name of a Step—Click the Edit (pencil) icon near the Step Name and specify a name for the Step.
(Optional) Edit the duration of a Step—Click the Edit (pencil) icon near the Duration (clock) icon to edit the duration.
The default duration for a Step is set to 30 seconds. The duration range is 30s through 86400s.
(Optional) Delete a Step—To delete a step, do one of the following:
Click the horizontal ellipsis (three dots) in the Step and click Remove.
Drag the Step anywhere on the screen.
Click + Add Task to add Tasks for a Step. The Tasks page displays the list of protocols that can be configured for a Test.
Do one of the following:
Select a Task from the Tasks page. For example, click DNS to add DNS as one of the Tasks in the Step.
Click the Add (+) icon next to the Task.
Drag and drop the Task inside the Step that you are configuring.
For a Task, you can do the following:
(Optional) Edit the name of a Task—To edit a Task, do one of the following:
Click the Edit (pencil) icon to specify a name for the Task in the Task-Name text box.
Click the Task-Name and specify a name for the Task in the Task-Name text box.
By default, the plugin name is displayed. If you do not edit, the default name will be used.
(Optional) Delete the Task—To delete a Task, do one of the following:
Click the down arrow in the Task box and click Remove.
Drag the Task anywhere on the empty portion of the screen.
A confirmation message appears asking to confirm if you want to remove the Task. Click Yes.
Configure the parameters for a Task—Click the Settings (gear) icon on the Task box to configure a Task. The Step Name page appears and displays the Task you added. This page includes the following tabs:
Parameters tab—Configure parameters for the Tasks that you have added. For more information on parameters that you can configure for a Task, see Table 1.
Evaluation criteria tab—The Evaluation Criteria for each Task is added by default. You can configure customized evaluation criteria for metrics by using threshold expressions. On violation of any configured expression, Paragon Automation generates events. For more information on metrics that you can configure, see Table 12.
A Test can include one or more Steps, and a Step can include one or more Tasks. Based on your requirements, repeat Step 3 and Step 4.
Click Test Settings (gear) icon on the right side of the page to,
Specify the wait duration (in seconds)—You can specify the maximum wait duration. After the Test Agent completes a Step, Paragon Automation waits for the Test Agents to configure or download the plugins or for the Test Agents to be ready to run the Steps.
By default, the Step wait duration is 60 seconds. The Max wait duration has no effect on the Test duration.
(Optional) Specify a short description for the Test.
(Optional) Add Tags—Specify a key-value pair in the key:value format.
You can configure Tags for the Test in the key:value format to provide additional information about the Test you are configuring. A tag is a key-value pair in which the key signifies a category for which you configure a value. The value is an identifier for the category. Examples of key-value pairs are device and device name (edgedevice:acx7000), site and site name (site:bangalore).
Click Run.
A message confirming that the Test is created successfully appears and you are redirected to the Test-Name (Observability > Active Assurance > Tests > Test-Name) page. On the Test-Name page, Test status is displayed as Running indicating that the Test is in progress. The status changes to Completed when the Test is complete and you can view the details of the Test. See About the Test-Name page for more information about the Test details.
Note:The Run button is disabled until you add a Task under a Step.
| Tasks | Description |
|---|---|
|
DNS |
For information on the parameter that you can configure for DNS, see Table 2. |
|
HTTP |
For information on the parameter that you can configure for HTTP, see Table 3. |
|
Ping |
For information on the parameter that you can configure for ping, see Table 4. |
|
TWAMP/TWAMP Light |
For information on the parameter that you can configure for TWAMP/TWAMP Light, see Table 5. |
|
TWAMP Reflector |
For information on the parameter that you can configure for TWAMP Reflector, see Table 6. |
|
RPM HTTP |
For information on the parameter that you can configure for RPM HTTP, see Table 7. |
|
RPM PING |
For information on the parameter that you can configure for RPM PING, see Table 8. |
|
RPM TCP |
For information on the parameter that you can configure for RPM TCP, see Table 9. |
|
RPM TWAMP |
For information on the parameter that you can configure for RPM TWAMP, see Table 10. |
|
RPM UDP |
For information on the parameter that you can configure for RPM UDP, see Table 11. |
| Parameter | Description |
|---|---|
| General | |
| Client |
Select one or more Test Agents on which you want to run the Test. To select one or more Test Agents:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
| Lookup names |
Specify the address for which you want the DNS server to perform a lookup operation. Lookup is the process of querying the server to translate a domain name into IP address. When you click the Lookup names text box, a Select Lookup name page appears. You can add a name in the Lookup text box. To add more than one Lookup names, click + Add Lookup. |
| Time between requests |
Specify the time taken between successive DNS queries initiated by a Test Agent to resolve domain names into IP addresses. Unit—seconds (s). Default value—10.00 s. Range—0.01 s through 3600 s. |
| DNS server |
Specify the DNS server IP address. The server IP address allows the Test Agent to resolve domain names to their IP addresses. If left empty, the Test Agent uses the default interface, which the DNS address provides through DHCP. Maximum Length—200 characters. |
| DNS record type |
Select the DNS record type. A DNS record is a set of unstructured data stored in a DNS database. The database consists of information on a domain and its services. DNS has different resource records. Each record type has different functions in the resolution process.
By default, the record type is A. |
| Thresholds for errored seconds (ES) | |
| Timeout |
Specify the timeout value. Timeout measures the maximum duration the Test Agent can wait for a response from the DNS server before failing the request. When there is an unresponsive server, a timeout ensures that a Test Agent do not wait indefinitely for a response. Unit—Milliseconds (ms). Default value—1000ms. Range—1ms through 30000ms. |
| Advanced | |
| Request lifetime |
Specify the request lifetime value. Request lifetime value is the duration for which a DNS request is alive. It determines how long a request persists without getting terminated. Unit—Milliseconds (ms). Default value—5000 ms. Range—1 ms through 30000 ms. |
| Recursive requests |
Enable or disable the Recursive Requests toggle button. Recursive Request is the process where a DNS server queries other DNS servers until it resolves the lookup address. If you enable the Recursive Requests toggle button, the DNS server queries other DNS servers. By default, the toggle button is enabled. |
| Response code |
Select the DNS response code. You can select one of the following response codes:
The DNS response code can be any value from 0 to 9. The value indicates the outcome of a DNS query. For more information on DNS response codes and strings with descriptions, see IANA link. |
| Expected response |
Specify the expected DNS response you want to see as the output of the DNS server. If the actual output does not match the expected response you have entered, an errored second is triggered. For more information on DNS response codes and strings with descriptions, see IANA link. |
| Parameter | Description |
|---|---|
| General | |
| Clients |
Select one or more Test Agents on which you want to run the Test. To select one or more Test Agents:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
| URLs |
Specify the URL. URL is the domain name or the IP address of the host to where you send the HTTP requests. Maximum Length—200 characters. |
| Time between requests |
Specify the time taken between successive HTTP requests initiated by a Test Agent. Unit—Seconds (s). Default value—10.00 s. Range—0.01 s through 3600 s. |
| Thresholds for errored seconds (ES) | |
| Timeout |
Specify the timeout value. Timeout measures the maximum duration the Test Agent can wait for a response from the HTTP server before failing the request. When there is an unresponsive server, a timeout ensures that a Test Agents do not wait indefinitely for a response. Unit—Milliseconds (ms). Default value—1000 ms. Range—1 ms through 30000 ms. |
| Response content |
Enter the response content that the server uses to validate against the HTTP response. Response content is the regular expression, which is a highly descriptive language commonly used to search through a set of data. Maximum Length—50 characters. |
| Advanced | |
| Request lifetime |
Specify the request lifetime value. Request lifetime is the duration for which an HTTP request is alive. Lifetime value determines how long a request persists without getting terminated. Unit—Milliseconds (ms). Default value—5000 ms. Range—1 ms through 30000 ms. |
| HTTP response code |
Specify the HTTP response code for the Test Agent. HTTP response indicates the completion status of an HTTP request sent from a Test Agent to a remote endpoint. For more information on HTTP response codes, see RFC 9110. |
| Proxy server |
Specify the IP address of the HTTP proxy server. Proxy server is an intermediary device that connects a Test Agent to the remote server. When a Test Agent sends a request to the remote server, the request passes through a proxy to reach the remote server. |
| Proxy port |
Specify the port number that the Test Agent uses for HTTP proxy server. Proxy port receives the request sent by a Test Agent. Default value—8080. Range—1 through 65535. |
| Proxy authentication |
Select the authentication method that the Test Agent uses when connecting to a proxy server. Select one of the following authentication method:
Proxy authenticates the incoming request from a Test Agent. This ensures that only the authorized users have access to the internet. |
| Proxy username |
Specify the username for authorized access to a proxy. |
| Proxy password |
Specify the password for authorized access to a proxy server. |
| Parameter | Description |
|---|---|
| General | |
| Clients |
Select one or more Test Agents on which you want to run the Test. To select one or more Test Agents:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
| Hosts |
Specify the hostname or the destination IP. A host is the remote endpoint to which the Test Agent sends the request. When you click the Host text box, the Select Host page appears where you can enter hostnames. To add more than one hosts, click + Add Host and specify the following:
|
| Time between requests |
Specify the time taken between successive ping requests initiated by a Test Agent. Unit—Seconds (s). Default value—10.00 s. Range—0.01 s to 3600 s. |
| Thresholds for error seconds (ES) | |
| Delay |
Specify the maximum threshold value for delay in response to the ping request. Delay measures the difference in time taken by a request packet to reach the remote endpoint and the response packet to reach the Test Agent with respect to the actual configured time. If the delay value is higher, it indicates poor data quality. Configure the maximum threshold value for delay in response to the ping request. If the Test Agent detects that the delay in a connection exceeds the threshold you configured, the Paragon Automation generates an event. Unit—Milliseconds (ms). Default value—1000 ms. Range—1 ms through 30000 ms. |
| DV (Delay variance) |
Specify the maximum threshold value (ms) for delay variance (jitter). Delay variation (DV) occurs when different packets take different amount of time to travel from a Test Agent to a remote endpoint. Packets are sent at regular interval of time and if variation is experienced in consecutive packets, the Test Agent generates an errored-second event. Unit—Milliseconds (ms). Default value—500 ms. Range—0 ms through 10000 ms. |
| Advanced | |
| UDP echo |
Enable the toggle button for the UDP echo protocol to be used to send the ping request. The UDP echo uses port 7 to send the request. By default, the toggle button is disabled. |
| Payload |
Specify the size (in bytes) of the ping payload. Payload is the actual data in a request packet. Unit—Bytes. Default value—56 bytes. Range—0 byte through 65000 bytes. |
| TTL (Time to Live) |
Specify the number of times the packets hop before a device discards the packet. Time to live (TTL) value indicates lifespan of a request packet. TTL prevents infinite loop in a network when the packet fails to reach the destination. For example, if you have entered the TTL value as 64, every time the packet passes a device, the value is reduced by one until the packet reaches the remote server. If the entered value reaches zero before reaching the remote endpoint, the packet is discarded. Default value—64. Range—1 through 255. |
| Request Lifetime |
Specify the request lifetime value. Request lifetime value is the duration for which a ping request is alive. It determines how long a request persists before it terminates. Unit—Milliseconds (ms). Default value—2000 ms. Range—1 ms through 30000 ms. |
| DSCP/IPP |
Specify the Differentiated Services Code Point (DSCP) or the IP Precedence (IPP) value that is used in the IP packet headers. The IPP is the three-bit binary values (Precedence) in the ToS field of the IP header. An IPP value can be in the 0-7 range. IPP value informs the router about the priority of the packet. The higher the IPP value, the more the priority of the packet. See RFC 791 for more information. DSCP is a six-bit binary value in the DS field of the IP header. DSCP value facilitates QoS for traffic management through the Best Effort, Assured Forwarding, Class Selector, and the Expedited Forwarding categories. See RFC 2474 for more information. Default value—0. Range—0 through 255. |
| Parameter | Description |
|---|---|
| General | |
|
Senders |
Select one or more Test Agents on which you want to run the Test. To select one or more Test Agents:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. The TWAMP/TWAMP Light plugin cannot be run on Test Agents associated with devices. To run TWAMP/TWAMP Light plugin on devices, use the RPM TWAMP/TWAMP Light plugin. |
|
Reflectors |
Specify the reflector address. A Test Agent application can run a Reflector plugin whereas a Test Agent that is associated with a device needs to be configured to run Reflector plugin. When you click the text box, the Select reflectors page appears where you can add reflectors. On this page:
|
|
Rate |
The rate at which the Test Agents send the ethernet frames to the remote endpoint. The rate is calculated as the size of the request packet sent divided by the total request time. Each Ethernet packet contains one frame. Unit—Megabits per seconds (Mbit/s). Range—0.0 Mbit/s through 10000.0 Mbit/s. |
|
Time sync |
Enable this toggle button if you want to synchronize the timestamp of the Test Agent and the reflector by using Network Time Protocol (NTP). By default, the toggle button is disabled. |
|
Use hardware timestamping |
Enable hardware timestamping if you want to use the network interface card (NIC) of Test Agents for delay and jitter measurements. RPM plugins can only run in Test Agents that are associated with devices. If the device does not support hardware timestamping, an error message is displayed and the measurement will not begin. By default, the toggle button is disabled. |
|
Thresholds for error seconds (ES) |
|
|
Loss% |
Specify the loss percentage value. If the loss percentage exceeds the configured value, an errored-second is triggered. Loss percentage indicates the percentage of request packets sent from the Test Agent that were lost before reaching the remote endpoint or the response packets that were lost before reaching the Test Agent. The Loss percentage is calculated by comparing the total number of packets that were lost with the total number of packets that were sent from the Test Agent. Unit—Percentage (%). Default value—0.0 %. Range—0.0 % through 100.00 %. |
|
Delay |
Specify the maximum threshold value for delay in response to the TWAMP request. Delay measures the difference in time taken by a request packet to reach the remote endpoint and the response packet to reach the Test Agent with respect to the actual configured time. If the delay value is higher, it indicates poor data quality. If the Test Agent detects that the delay in a connection exceeds the threshold you configured, the Test Agent generates an event. Unit—Milliseconds (ms). Range—0.001 ms through 1000.0 ms. |
|
Delay Variation |
Specify the maximum threshold value (ms) for delay variance (jitter). Delay variation (DV) occurs when different packets take different amount of time to travel from a Test Agent to a remote endpoint. Packets are sent at regular interval of time and if variation is experienced in consecutive packets, the Test Agent generates an errored-second event. Unit—Milliseconds (ms). Range—0.001 ms through 1000.0 ms. |
|
Expected DSCP Value |
Specify the expected DSCP you want to see as the output of the reflector. If the received DSCP value does not match the configured value, an errored second will be indicated. Range—0 through 63. |
|
Thresholds for severely error seconds (ES) |
|
|
Loss |
Specify the loss percentage value. If the loss percentage exceeds the configured value during a one-second interval, a severely errored-second is triggered. Loss percentage indicates the percentage of request packets sent from the Test Agent that were lost before reaching the remote endpoint or the response packets that were lost before reaching the Test Agent. The Loss percentage is calculated by comparing the total number of packets that were lost with the total number of packets that were sent from the Test Agent. Unit—Percentage (%). Minimum value—0.0 %. |
|
Delay |
Specify the maximum threshold value for delay in response to the TWAMP request. If the delay between server and reflector exceeds the configured value during a one-second interval, a severely error seconds is indicated. Delay measures the difference in time taken by a request packet to reach the remote endpoint and the response packet to reach the Test Agent with respect to the actual configured time. If the delay value is higher, it indicates poor data quality. Unit—Milliseconds (ms). Minimum value—0.001 ms. |
|
Delay variation |
Specify the maximum threshold value (ms) for delay variance (jitter). If the jitter between server and Test Agent exceeds the configured value during a one-second interval, a severely error seconds is indicated. Delay variation (DV) occurs when different packets take different amount of time to travel from a Test Agent to a remote endpoint. Packets are sent at regular interval of time and if variation is experienced in consecutive packets, the Test Agent generates a severely errored-second event. Unit—Milliseconds (ms). Minimum value—0.001 ms. |
|
Advanced |
|
| Frame Size |
Specify the size of Layer 2 Ethernet frame for the data flow. Frame Size indicates the total size of the data frame sent from the Test Agent to the remote endpoint. The size also includes the header size. Unit—Bytes. Default value—1518. Range—87 through 9018. |
| DSCP |
Specify the Differentiated Services Code Point (DSCP) value that is used in the IP packet headers. DSCP is a six-bit binary value in the DS field of the IP header. DSCP value facilitates QoS for traffic management through the Best Effort, Assured Forwarding, Class Selector, and the Expedited Forwarding categories. See RFC 2474 for more information. Default value—0. Range—0 through 63. |
| Use random padding |
Enable the toggle button to use random numbers or zeroes as padding in a TWAMP packet. Random padding means addition of random number to the TWAMP packet. By default, the toggle button is enabled. |
|
Socket priority |
Specify the value for socket priority. Socket priority is the level of priority assigned to a socket used for TWAMP sessions. It is used to set VLAN Priority Code Points (PCP). Default value—0. Range—0 through 7. |
|
Socket send buffer size |
Specify the value for the socket buffer size (send) in bytes. Socket send buffer is used in network stack to buffer traffic. Unit—Bytes. Range—2048 through 10000000 bytes. |
|
Socket receive buffer size |
Specify the value for the socket buffer size (receive) in bytes. Socket receive buffer is used in network stack to buffer traffic. Unit—Bytes. Range—2048 through 10000000 bytes. |
|
Don't fragment flag |
Enable the Don’t Fragment Flag (DF Flag) to restrict the fragmentation of the packets that exceed the MTU. DF Flag is configured in an IP header. Router drops the packet if fragmentation is needed. Enabling the toggle button may cause performance degradation both in the network and in the sending or receiving Test Agents. By default, the toggle button is enabled. |
|
UAS period length |
Specify the minimum value for the consecutive severely errored seconds (SES) that causes a period of unavailability. The Unavailable Seconds (UAS) metric determines the number of seconds at which the service can be considered to be unavailable. Unit—Seconds (s). Default value—10 s. Range—0 s through 300 s. |
| Accept UDP checksum zero for IPv6 |
Enable this toggle button to accept the UDP Checksum as Zero for IPv6 in TWAMP Reflector packets. By default, the toggle button is enabled. |
|
Percentiles |
|
|
First delay percentile |
Specify the first delay percentile of the value of the TWAMP request packet. If the delay exceeds the configured value, the packet is included in the defined first delay percentile slot. Unit—Percentage (%). Range—0 % through 1 %. |
|
Second delay percentile |
Specify the second delay percentile of the value of the TWAMP request packet. If the delay exceeds the configured value, the packet is included in the defined second delay percentile slot. Unit—Percentage (%). Range—0 % through 1 %. |
|
Threshold for first delay percentile |
Specify the threshold for triggering an errored second based on the first delay percentile. Unit—Milliseconds (ms). Range—0.001 ms through 1000.00 ms. |
|
Threshold for second delay percentile |
Specify the threshold for triggering an errored second based on the second delay percentile. Unit—Milliseconds (ms). Range—0.001 ms through 1000.00 ms. |
|
SES threshold for first delay percentile |
Specify the threshold for triggering a severely errored second based on the first delay percentile. Unit—Milliseconds (ms). Range—0.001 ms through 1000.00 ms. |
|
SES threshold for second delay percentile |
Specify the threshold for triggering a severely errored second based on the second delay percentile. Unit—Milliseconds (ms). Range—0.001 ms through 1000.00 ms. |
|
Periodic Streams |
|
|
Active period duration |
Specify the time duration of each cycle during which ethernet frames are sent. Active period is followed by a silent period during which no ethernet frames are sent. Unit—Milliseconds (ms). Range—1 ms to 3600000 ms. |
|
Active cycle |
Specify the time duration of the cycle starting with an active period and ending with a silent period. The Active cycle duration must be at least equal to the active period duration. Unit—Milliseconds (ms). Range—1 ms to 604800 ms. |
|
Report metrics during inactive period |
Enable the toggle button to report metrics related to inactive periods of a periodic Test. By default, the toggle button is enabled. |
| Parameter | Description |
|---|---|
|
General |
|
|
Clients |
Select one or more Test Agents on which you want to run the Test. To select one or more Test Agents:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
|
Test session port |
Specify the destination port value for the Test session. Test session port is the port used by TWAMP sessions to communicate between the Test Agent and the reflector. Default value—7000. Range—1 through 65535. |
|
Rate threshold for ES |
Specify the errored-second if the combined rate for all sessions is below the threshold value. Unit—Megabits per seconds (Mbit/s). Range—0.001 (Mbit/s) through 10000 (Mbit/s). |
|
Standalone mode |
Enable Standalone mode to push the metrics data to Paragon Automation By default, the toggle button is disabled. |
| Parameter | Description |
|---|---|
| General | |
| Clients |
Select one or more interfaces of the network devices on which you want to run a Test. To select one or more network devices as client values:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
| URLs |
Specify the URL. URL is the domain name or the IP address of the host to which you send the HTTP requests. Maximum length—255 characters. |
| Time between requests |
Specify the time taken between successive HTTP requests initiated by a Test Agent. Unit—Seconds (s). Default value—10 s. Range—1 s to 255 s. |
|
Advanced |
|
| Collection Interval |
Specify the collection interval. Collection interval is the frequency at which the results are collected from the remote endpoint or the device. Collection interval must be larger than the specified Time between requests. Unit—Seconds (s). Default value—15 s. Range—5 s through 300 s. |
| Device response timeout |
Specify the device response timeout value. Device response timeout measures the maximum duration the Test Agent can wait for a response from the HTTP server before failing the request. When there is an unresponsive server, a device response timeout ensures that the Test Agent do not wait indefinitely for a response. Unit—Seconds (s). Default value—200 s. Range—30 s through 300 s. |
| Routing instance |
Specify the number of routing instances. Maximum value—64 |
|
TTL |
Specify the number of times the packets hop before a device discards the packet. Time to live (TTL) value indicates lifespan of a request packet. TTL prevents infinite loop in a network when the packet fails to reach the destination. For example, if you have entered the TTL value as 64, every time the packet passes a device, the value is reduced by one until the packet reaches the remote server. If the entered value reaches zero before reaching the remote endpoint, the packet is discarded. Default value—64. Range—1 through 254. |
|
Metadata get |
Enable Metadata get to perform HTTP Get request at target URL. By default, the toggle button is disabled. |
|
IPv6 local link |
Specify the link-local logical interface name for the egress interface with IPv6 address as the target address. Maximum length—64 characters. |
| Hardware timestamp |
Enable hardware timestamping if you want to use the network interface card (NIC) of Test Agents for delay and jitter measurements. RPM plugins can only run in Test Agents that are associated with devices. If the device does not support hardware timestamping, an error message is displayed and the measurement will not begin. By default, the toggle button is disabled. |
| Parameter | Description |
|---|---|
| General | |
| Client |
Select one or more interfaces of the network devices on which you want to run a Test. To select one or more network devices as client values:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
|
Hosts |
Specify hostnames or the destination IP. A Host is a remote endpoint to which the Test Agent sends the request. When you click the text box, the Select Host page appears where you can enter hostnames. To add more than one Hosts, click + Add Host and specify the following:
|
| Time between requests |
Specify the time taken between successive ping requests initiated by a Test Agent. Unit—Seconds (s). Default value—10 s. Range—1 s through 255 s. |
|
Advanced |
|
| Collection interval |
Specify the collection interval. Collection interval is the frequency at which the results are collected from the remote endpoint or the device. Collection interval must be larger than the specified Time between requests. Unit—Seconds (s). Default value—15 s. Range—5 s through 300 s. |
| Device response timeout |
Specify the device response timeout value. Device response timeout measures the maximum duration the Test Agent can wait for a response from the remote endpoint before failing the request. When there is an unresponsive server, a device response timeout ensures that the Test Agent do not wait indefinitely for a response. Unit—Seconds (s). Default value—200 s. Range—30 s through 300 s. |
| Routing instance |
Specify the number of routing instances. A routing instance is a collection of routing tables, interfaces, and routing protocol parameters. The routing protocol parameters control the information in the routing tables. Maximum value—64. |
| Data size |
Specify the size of the request packet sent from the Test Agent in bytes. Default value—0. Range—0 through 65400. |
| Data fill |
Specify the content of the data portion of Internet Control Message Protocol (ICMP) request packets. The value should be in hexadecimal format. |
| TTL |
Specify the number of times the packets hop before a device discards the packet. Time to live (TTL) value indicates lifespan of a request packet. TTL prevents infinite loop in a network when the packet fails to reach the destination. For example, if you have entered the TTL value as 64, every time the packet passes a device, the value is reduced by one until the packet reaches the remote server. If the entered value reaches zero before reaching the remote endpoint, the packet is discarded. Default value—64. Range—1 through 254. |
| DSCP code points |
Specify the Differentiated Services Code Point (DSCP) value that is used in the IP packet headers. DSCP is a six-bit binary value in the DS field of the IP header. DSCP value facilitates QoS for traffic management through the Best Effort, Assured Forwarding, Class Selector, and the Expedited Forwarding categories. See RFC 2474 for more information. Maximum length—64 characters. |
| Hardware timestamp |
Enable hardware timestamping if you want to use the network interface card (NIC) of Test Agents for delay and jitter measurements. RPM plugins can only run in Test Agents that are associated with devices. If the device does not support hardware timestamping, an error message is displayed and the measurement will not begin. In case of ping plugin, you can enable timestamping of RPM messages in the Packet Forwarding Engine host processor. By default, the toggle button is disabled. |
| Ping timestamp |
Enable ping timestamp to perform ICMP ping timestamping instead of a normal ping. By default, the toggle button is disabled. |
| One way hardware timestamp |
Enable the one-way hardware timestamping for one-way measurements (delay and jitter). By default, the toggle button is disabled. |
| IPv6 local link |
Specify the link-local logical interface name for the egress interface with IPv6 address as the target address. Maximum length—64 characters. |
| Parameter | Description |
|---|---|
| General | |
| Client |
Select one or more interfaces of the network devices on which you want to run a Test. To select one or more network devices as client values:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
|
Servers |
Specify the remote IP address of the server to which the client sends the request. When you click the text box, the Select server page appears where you can enter details. To add more than one servers, click + Add Server and specify the following:
|
|
Time between requests |
Specify the time taken between successive TCP requests initiated by a Test Agent. Unit—Seconds (s). Default value—10 s. Range—1 s through 255 s. |
|
Advanced |
|
| Collection interval |
Specify the collection interval. Collection interval is the frequency at which the results are collected from the remote endpoint or the device. Collection interval must be larger than the specified Time between requests. Unit—Seconds (s). Default value—15 s. Range—5 s through 300 s. |
| Device response timeout |
Specify the device response timeout value. Device response timeout measures the maximum duration the Test Agent can wait for a response from the remote endpoint before failing the request. When there is an unresponsive server, a device response timeout ensures that the Test Agent do not wait indefinitely for a response. Unit—Seconds (s). Default value—200 s. Range—30 s through 300 s. |
| Routing instance |
Specify the number of routing instances. A routing instance is a collection of routing tables, interfaces, and routing protocol parameters. The routing protocol parameters control the information in the routing tables. Maximum value—64. |
| Data size |
Specify the size of the request packet sent from the Test Agent in bytes. Default value—0. Range—0 through 65400. |
| Data fill |
Specify the content of the data portion of Internet Control Message Protocol (ICMP) request packets. The value should be in hexadecimal format. |
| TTL |
Specify the number of times the packets hop before a device discards the packet. Time to live (TTL) value indicates lifespan of a request packet. TTL prevents infinite loop in a network when the packet fails to reach the destination. For example, if you have entered the TTL value as 64, every time the packet passes a device, the value is reduced by one until the packet reaches the remote server. If the entered value reaches zero before reaching the remote endpoint, the packet is discarded. Default value—64. Range—1 through 254. |
| DSCP code points |
Specify the Differentiated Services Code Point (DSCP) value that is used in the IP packet headers. DSCP is a six-bit binary value in the DS field of the IP header. DSCP value facilitates QoS for traffic management through the Best Effort, Assured Forwarding, Class Selector, and the Expedited Forwarding categories. See RFC 2474 for more information. Maximum length—64 characters. |
| IPv6 Local Link |
Specify the link-local logical interface name for the egress interface with IPv6 address as the target address. Maximum length—64 characters. |
| Parameter | Description |
|---|---|
| General | |
| Clients |
Select one or more interfaces of the network devices on which you want to run a Test. To select one or more network devices as client values:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
|
Reflectors |
Specify the reflector address in your network. A Test Agent application can run a Reflector plugin whereas a Test Agent that is associated with a device needs to be configured to run Reflector plugin. When you click the text box, the Select reflectors page appears where you can add reflectors. On this page:
|
| Time between requests |
Specify the time taken between successive TWAMP requests initiated by a Test Agent. Unit—Seconds (s). Default value—10s. Range—1s through 255s. |
|
Advanced |
|
| Collection interval |
Specify the collection interval. Collection interval is the frequency at which the results are collected from the remote endpoint or the device. Collection interval must be larger than the specified Time between requests. Unit—Seconds (s). Default value—15 s. Range—5 s through 300 s. |
| Device response timeout |
Specify the device response timeout value. Device response timeout measures the maximum duration the Test Agent can wait for a response from the remote endpoint before failing the request. When there is an unresponsive server, a device response timeout ensures that the Test Agent do not wait indefinitely for a response. Enter the device response timeout value. Unit—Seconds (s). Default value—200 s. Range—30 s through 300 s. |
| Routing instance |
Specify the number of routing instances. A routing instance is a collection of routing tables, interfaces, and routing protocol parameters. The routing protocol parameters control the information in the routing tables. Maximum value—64. |
|
Zero fill |
Enable this toggle button to populate the content for the request packet with zeros. |
|
Data size |
Specify the size of the request packet sent from the Test Agent in bytes. Default value—60. Range—60 to 1400. |
|
TTL |
Specify the number of times the packets hop before a device discards the packet. Time to live (TTL) value indicates lifespan of a request packet. TTL prevents infinite loop in a network when the packet fails to reach the destination. For example, if you have entered the TTL value as 64, every time the packet passes a device, the value is reduced by one until the packet reaches the remote server. If the entered value reaches zero before reaching the remote endpoint, the packet is discarded. Default value—64. Range—1 to 254. |
| DSCP Code Points |
Specify the Differentiated Services Code Point (DSCP) value that is used in the IP packet headers. DSCP is a six-bit binary value in the DS field of the IP header. DSCP value facilitates QoS for traffic management through the Best Effort, Assured Forwarding, Class Selector, and the Expedited Forwarding categories. See RFC 2474 for more information. Maximum length—64 characters. |
| IPv6 Local Link |
Specify the link-local logical interface name for the egress interface with IPv6 address as the target address. Maximum length—64 characters. |
|
PFE timestamping |
Enable PFE timestamping to perform timestamping on Packet Forward Engine host. By default, the toggle button is disabled. |
| Parameter | Description |
|---|---|
| General | |
| Clients |
Select one or more interfaces of the network devices on which you want to run a Test. To select one or more network devices as client values:
Note:
On the Select interfaces page, you can filter the Test Agents based on the following criteria:
You can enable the Display Device Names toggle button to display the hostnames of the routers that are associated with the Test Agents. You can also enable the Hide unsupported toggle button to hide devices that are not supported by the plugin you have selected. To search for a specific interface or a Test Agent, enter one or more keywords in the search text box. You can search based on the name, description, IP and MAC address of the interfaces or the Test Agents. You can also search based on the device name, device model, and device MAC addresses if searching for a Test Agent associated with the device. You can also hover over an interface name to view the details such as the Test Agent name, bind interface, bind family, and to check if the Test Agent is run on a device or not. |
|
Servers |
Specify the IP address of the server to which the client sends the request. When you click the text box, the Select server page appears where you can enter details. To add more than one servers, click + Add Server and specify the following:
|
| Time Between Requests |
Specify the time taken between successive UDP requests initiated by a Test Agent. Unit—Seconds (s). Default value—10 s. Range—1 s through 255 s. |
|
Remote port |
Configure the remote port number for the Test sessions. Default value—7. Range—7 through 65535. |
|
Advanced |
|
| Collection Interval |
Specify the collection interval. Collection interval is the frequency at which the results are collected from the remote endpoint or the device. Collection interval must be larger than the specified Time between requests. Unit—Seconds (s). Default value—15 s. Range—5 s through 300 s. |
| Device Response Timeout |
Specify the device response timeout value. Device response timeout measures the maximum duration the Test Agent can wait for a response from the remote endpoint before failing the request. When there is an unresponsive server, a device response timeout ensures that the Test Agent do not wait indefinitely for a response. Unit—Seconds (s). Default value—200 s. Range—30 s through 300 s. |
| Routing instance |
Specify the number of routing instances. A routing instance is a collection of routing tables, interfaces, and routing protocol parameters. The routing protocol parameters control the information in the routing tables. Maximum value—64. |
| Data Size |
Specify the size of the request packet sent from the Test Agent in bytes. Default value—0. Range—0 through 65400. |
| Data fill |
Specify the content of the data portion of Internet Control Message Protocol (ICMP) request packets. The value should be in hexadecimal format. |
| TTL |
Specify the number of times the packets hop before a device discards the packet. Time to live (TTL) value indicates lifespan of a request packet. TTL prevents infinite loop in a network when the packet fails to reach the destination. For example, if you have entered the TTL value as 64, every time the packet passes a device, the value is reduced by one until the packet reaches the remote server. If the entered value reaches zero before reaching the remote endpoint, the packet is discarded. Default value—64. Range—1 through 254. |
| DSCP Code Points |
Specify the Differentiated Services Code Point (DSCP) value that is used in the IP packet headers. DSCP is a six-bit binary value in the DS field of the IP header. DSCP value facilitates QoS for traffic management through the Best Effort, Assured Forwarding, Class Selector, and the Expedited Forwarding categories. For more information, see RFC 2474. Maximum length—64 characters. |
| Hardware Timestamp |
Enable hardware timestamping if you want to use the network interface card (NIC) of Test Agents for delay and jitter measurements. RPM plugins can only run in Test Agents that are associated with devices. If the device does not support hardware timestamping, an error message is displayed and the measurement will not begin. By default, the toggle button is disabled. |
| Ping Timestamp |
Enable ping timestamping to perform ping timestamping instead of a normal ping. By default, the toggle button is disabled. |
| One Way Hardware Timestamp |
Enable the one-way hardware timestamping for one-way delay and jitter measurements. By default, the toggle button is disabled. |
| IPv6 Local Link |
Specify the link-local logical interface name for the egress interface with IPv6 address as the target address. Maximum length—64 characters. |
| Field | Description |
|---|---|
|
Field |
Select the type of metric that you want to evaluate from the drop-down list. The metrics listed in this drop-down depends on the Task you select. The metrics will be displayed as stream graphs in the Stream-Name Details page. |
| Comparator |
Select the type of comparator that you want to use for the evaluation. You can choose among the following comparators—==(equal to), != (not equal to), < (less than), <= (less than or equal to), > (greater than), >= (greater than or equal to). For example, if you have used > (greater than) comparator, and if you have specified 3000 ms in the Value text box, then an event is raised if the value exceeds 3000 ms. |
| Value |
Specify the threshold value that you want to evaluate. On violation of any configured threshold value, an event is generated. |
| Severity |
Select the severity level of the event that is raised when there is a threshold violation. The severity levels are: Debug—Indicates that the event needs troubleshooting. Info—Indicates that it is an informational event and does not require immediate attention. Warning—Indicates that the event needs to be reviewed but does not require immediate attention. Error—Indicates that the event needs to be reviewed and requires immediate attention. Critical—Indicates that the event is major and needs immediate attention. When an event is raised, the severity level you have selected will be displayed in the Events bar of the Test-Name page. |
|
Name |
Specify the name for the evaluation criteria. |
|
Description |
Specify the description to be displayed when there is a threshold violation. If you do not specify the description, the default description generated by Paragon Automation is displayed. When an event is raised, the description you have specified here will be displayed in the Events bar of the Test-Name page. |
|
Raise Delay |
Specify the duration that the Paragon Automation waits before triggering an event. If the number of seconds exceeds the configured Raise delay value, then an event is triggered. The triggered event is displayed in the Events bar of the Test-Name page. |
|
Clear Delay |
Specify the duration of time after which an event is cleared if the threshold is not violated. If the threshold has not exceeded the configured Clear delay seconds, then the event is cleared. |