test-session (Junos OS Evolved)
Syntax
test-session name { data-size data-size; destination-port destination-port; dscp-code-points dscp-code-points; history-size history-size; moving-average-size moving-average-size; offload-type (none | inline-timestamp | pfe-timestamp); probe-count probe-count; probe-interval seconds; source-address source-address; source-routing { forward (srmpls-nodes <label hop1...n> | srv6-nodes <IPv6 SID hop1...n>); return (srmpls-nodes <label hop1...n> | srv6-nodes <IPv6 SID hop1...n>); } target target-address local-link IPv6-link-local-interface-name; thresholds { control-failure (on | off); successive-loss number; total-loss number; threshold-type (microseconds | average); } traps { egress-jitter-exceeded egress-time-exceeded; ingress-jitter-exceeded; ingress-time-exceeded; jitter-exceeded; probe-failure; rtt-exceeded; test-completion; test-failure; } ttl hop-count; }
Hierarchy Level
[edit services monitoring twamp client control-connection name]
Description
Specify the TWAMP test session details, including the session name, the contents of the test packet, the data size, the probe details, and the target destination. You must configure at least one test session.
Options
name |
Name of the test session. |
data-size bytes |
Specify the size of the data portion of the test packet, in bytes.
|
destination-port port |
Specify the User Datagram Protocol (UDP) port number to which a probe is
sent. You must have the control-type option for the control-connection
statement set to
|
dscp-code-points dscp-bits |
Configure the value of the Differentiated Services (DiffServ) field within the IP header. The DiffServ code point (DSCP) bits value must be set to a valid 6-bit pattern.
|
history-size number |
Specify the number of stored history entries. The value configured for the history-size option must be equal to or larger than the value configured for the probe-count option, or the configuration will not commit.
|
moving-average-size number |
Enable statistical calculations to be performed across a configurable number of the most recent samples.
|
offload-type (none | inline-timestamp | pfe-timestamp) |
Enable timestamping of TWAMP probe messages in the Routing Engine, inline
in the hardware, or Packet Forwarding Engine host processor. Prior to
Junos OS Evolved 22.3R1, for IPv6 traffic, you must configure
|
probe-count number |
Specify the number of probes within a test. The value configured for the probe-count option must be smaller than the value configured for the history-size option, or the configuration will not commit.
|
probe-interval seconds |
Specify the number of seconds to wait before sending the next probe.
|
source-address address |
Specify the IPv4 or IPv6 source address used for test probes. If the source address is not one of the device’s assigned addresses, the probe uses the outgoing interface’s address as its source. You cannot use IPv6 link-local addresses or the following addresses as the source address for probes:
When an IPv6 link-local address is configured with the |
target target-address local-link IPv6-link-local-interface-name |
Specify the IPv4 or IPv6 address for the target destination of the probe.
Prior to Junos OS Evolved 22.3R1, you cannot use an IPv6 link-local
address for the target destination of a probe. Starting in Junos OS
Evolved 22.3R1, for TWAMP Light test sessions with IPv6 target addresses
(where the |
ttl hop-count |
Specify the maximum number of hops a TWAMP probe can travel. You configure the ttl option when necessary to restrict the scope of a probe, so that a probe does not unintentionally monitor an alternative path to the destination (such as may occur after a BGP re-routing). You can also use the ttl option to monitor direct reachability by specifying a TTL of 1. Probes that exceed the number configured are discarded.
|
The remaining statements are explained separately. Search for a statement in CLI Explorer or click a linked statement in the Syntax section for details.
Required Privilege Level
system—To view this statement in the configuration.
system-control—To add this statement to the configuration.
Release Information
Statement introduced in Junos OS Evolved Release 20.3R1.
traps
option introduced in Junos OS Evolved Release 21.3R1.
IPv6 address support introduced in Junos OS Evolved Release 21.4R1.
The local-link
sub-option of the target
option for
TWAMP Light test sessions introduced in Junos OS Evolved Release 22.3R1.
The inline-timestamping
suboption of the
offload-type
option introduced in Junos OS Evolved 22.4R1.
source-routing
option introduced in Junos OS Evolved Release
24.4R1.