All Classes Namespaces Files Functions Pages
Rx.Latency.Distribution.ResultSnapshot Class Reference

The latency distribution result. More...

Methods

 Bucket.Count.Get
 Returns the number of buckets in which the range is divided. More...
 
 Bucket.Width.Get
 Returns the width in nanoseconds of a bucket. More...
 
 ByteCount.Get
 Gets the current received bytes counter. More...
 
 Description.Get
 Returns a textual description of the object.
 
 Framesize.Maximum.Get
 Gets the largest frame size received in this snapshot. More...
 
 Framesize.Minimum.Get
 Gets the smallest frame size received in this snapshot. More...
 
 Jitter.Get
 Gets the jitter [ns] measured in this snapshot. More...
 
 Latency.Average.Get
 Gets the average latency [ns] measured in this snapshot. More...
 
 Latency.Maximum.Get
 Gets the maximum latency [ns] measured in this snapshot. More...
 
 Latency.Minimum.Get
 Gets the minimum latency [ns] measured in this snapshot. More...
 
 PacketCount.AboveMaximum.Get
 Returns the number of packets arrived with a latency above the given range. More...
 
 PacketCount.BelowMinimum.Get
 Returns the number of packets arrived with a latency below the given range. More...
 
 PacketCount.Buckets.Get
 Returns the number of packets received per bucket. More...
 
 PacketCount.Get
 Gets the received packet count. More...
 
 PacketCount.Invalid.Get
 Gets the received packet count of invalid packets. More...
 
 PacketCount.Valid.Get
 Gets the received packet count of valid packets. More...
 
 Parent.Get
 Returns the parent object.
 
 Range.Maximum.Get
 Returns the exclusive maximum of the range configured. More...
 
 Range.Minimum.Get
 Returns the inclusive minimum of the range configured. More...
 
 Refresh.Timestamp.Get
 Returns the timestamp when the counters of this object where last refreshed. More...
 
 Refresh
 Updates the counters with the latest data available from the ByteBlower server. More...
 
 Timestamp.First.Get
 Gets the timestamp [NS] of the first packet in this snapshot. More...
 
 Timestamp.Get
 Gets the snapshot timestamp [NS]. More...
 
 Timestamp.Last.Get
 Gets the current timestamp [NS] of the last packet in this snapshot. More...
 

Class overview

The latency distribution result.

Note
The information is not updated until Refresh is called
See What's new in API v2 for more information.
Example
1 set port [ $server Port.Create "trunk-1-2"]
2  set latencyDist [ $port Rx.Latency.Distribution.Add ]
3  $latencyDist filter.set "ip src 10.1.1.1"

start the traffic

1 set distribution [ $latencyDist Result.Get ]

Returns:

<Rx.Latency.Distribution.ResultSnapshot object>  
1 $distribution PacketCount.Get

Returns:

1000  

Definition at line 19923 of file api.tcl.

Method documentation

Rx.Latency.Distribution.ResultSnapshot::Bucket.Count.Get

Returns the number of buckets in which the range is divided.

Example
1 $latency Range.Set 0 1 s
2  set result [ $latency Result.Get ]
3  $result Bucket.Count.Get

Returns:

1000 

Definition at line 19935 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Bucket.Width.Get

Returns the width in nanoseconds of a bucket.

Example
1 set latency [ $port Rx.Latency.Add "distribution" ]
2  $latency Range.Set 0 1s
3  set result [ $latency Result.Get ]
4  $result Bucket.Width.Get

Returns:

1000000 

Definition at line 19948 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::ByteCount.Get

Gets the current received bytes counter.

Example

This example gets the received bytes counter

1 $triggerResult ByteCount.Get

Returns:

100 

Definition at line 19958 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Framesize.Maximum.Get

Gets the largest frame size received in this snapshot.

Exceptions
CounterUnavailableWhen no frames are received, this counter is unavailable
Example

This example gets the largest frame size received in this snapshot.

1 $triggerResult Framesize.Maximum.Get

Returns:

100 

Definition at line 19975 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Framesize.Minimum.Get

Gets the smallest frame size received in this snapshot.

Exceptions
CounterUnavailableWhen no frames are received, this counter is unavailable
Example

This example gets the smallest frame size received in this snapshot.

1 $triggerResult Framesize.Minimum.Get

Returns:

100 

Definition at line 19987 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Jitter.Get

Gets the jitter [ns] measured in this snapshot.

Example

This example gets the jitter measured in this snapshot

1 $latencyResult Jitter.Get

Returns:

100 

Definition at line 19997 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Latency.Average.Get

Gets the average latency [ns] measured in this snapshot.

Example

This example gets the average latency measured in this snapshot

1 $latencyResult Latency.Average.Get

Returns:

100 

Definition at line 20007 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Latency.Maximum.Get

Gets the maximum latency [ns] measured in this snapshot.

Example

This example gets the maximum latency measured in this snapshot

1 $latencyResult Latency.Maximum.Get

Returns:

100 

Definition at line 20017 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Latency.Minimum.Get

Gets the minimum latency [ns] measured in this snapshot.

Example

This example gets the minimum latency measured in this snapshot

1 $latencyResult Latency.Minimum.Get

Returns:

100 

Definition at line 20027 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::PacketCount.AboveMaximum.Get

Returns the number of packets arrived with a latency above the given range.

Example
1 $latency Range.Set 0 1 s
2  set result [ $latency Result.Get ]
3  $result PacketCount.AboveMaximum.Get

Returns:

11 

Definition at line 20039 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::PacketCount.BelowMinimum.Get

Returns the number of packets arrived with a latency below the given range.

Example
1 $latency Range.Set 0 1 s
2  set result [ $latency Result.Get ]
3  $result PacketCount.BelowMinimum.Get

Returns:

11 

Definition at line 20051 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::PacketCount.Buckets.Get

Returns the number of packets received per bucket.

Example
1 $latency Range.Set 0 1 s
2  set result [ $latency Result.Get ]
3  $result PacketCount.Buckets.Get

Returns:

{1 2 3 ... 2 1} 

Definition at line 20063 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::PacketCount.Get

Gets the received packet count.

Example

This example gets the received packet counter

1 $triggerResult PacketCount.Get

Returns:

100 

Definition at line 20073 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::PacketCount.Invalid.Get

Gets the received packet count of invalid packets.

Example

This example gets the received invalid packet counter

1 $triggerResult PacketCount.Invalid.Get

Returns:

10 

Definition at line 20083 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::PacketCount.Valid.Get

Gets the received packet count of valid packets.

Example

This example gets the received valid packet counter

1 $triggerResult PacketCount.Valid.Get

Returns:

90 

Definition at line 20093 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Range.Maximum.Get

Returns the exclusive maximum of the range configured.

Returns
The lower bound of the configured range on the Rx.Latency.Distribution object.
Example
1 $latencyResult Range.Maximum.Get

Returns:

1000000000 

Definition at line 20106 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Range.Minimum.Get

Returns the inclusive minimum of the range configured.

Returns
The lower bound of the configured range on the Rx.Latency.Distribution object.
Example
1 $latencyResult Range.Minimum.Get

Returns:

10000 

Definition at line 20116 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Refresh

Updates the counters with the latest data available from the ByteBlower server.

Example
1 $result Refresh

Definition at line 20138 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Refresh.Timestamp.Get

Returns the timestamp when the counters of this object where last refreshed.

Note
This is not the same as Timestamp.Get
Example
1 $result Refresh.Timestamp.Get

Returns:

1432805398000000000 

Definition at line 20128 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Timestamp.First.Get

Gets the timestamp [NS] of the first packet in this snapshot.

Exceptions
CounterUnavailableWhen no frames are received, this counter is unavailable
Example

This example gets the timestamp [NS] of the first received packet in this snapshot

1 $triggerResult Timestamp.First.Get

Returns:

1413475037767331530 

Definition at line 20150 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Timestamp.Get

Gets the snapshot timestamp [NS].

Example

This example gets the snapshot timestamp [NS].

1 $triggerResult Timestamp.Get

Returns:

1413475070000000000 

Definition at line 20160 of file api.tcl.

Rx.Latency.Distribution.ResultSnapshot::Timestamp.Last.Get

Gets the current timestamp [NS] of the last packet in this snapshot.

Exceptions
CounterUnavailableWhen no frames are received, this counter is unavailable
Example

This example gets the timestamp [NS] of the last received packet in this snapshot

1 $triggerResult Timestamp.Last.Get

Returns:

1413475071947640170 

Definition at line 20172 of file api.tcl.