Host formats¶

Hosts may be either hostnames (for IPv4 or IPv6) or IP addresses. IPv6 addresses must be surrounded by brackets and may include a zone after the % character. Examples:

Note: IPv6 addresses must be quoted in most shells.

Duration units¶

Durations are a sequence of decimal numbers, each with optional fraction, and unit suffix, such as: “300ms”, “1m30s” or “2.5m”. Sanity not enforced.

version¶

version information

"version": {
    "irtt": "0.9.0",
    "protocol": 1,
    "json_format": 1
},

•

irtt the IRTT version number

•

protocol the protocol version number (increments mean incompatible changes)

•

json_format the JSON format number (increments mean incompatible changes)

system_info¶

a few basic pieces of system information

"system_info": {
    "os": "darwin",
    "cpus": 8,
    "go_version": "go1.9.2",
    "hostname": "tron.local"
},

•

os the Operating System from Go's runtime.GOOS

•

cpus the number of CPUs reported by Go's runtime.NumCPU(), which reflects the number of logical rather than physical CPUs. In the example below, the number 8 is reported for a Core i7 (quad core) with hyperthreading (2 threads per core).

•

go_version the version of Go the executable was built with

•

hostname the local hostname

config¶

the configuration used for the test

"config": {
    "local_address": "127.0.0.1:51203",
    "remote_address": "127.0.0.1:2112",
    "open_timeouts": "1s,2s,4s,8s",
    "params": {
        "proto_version": 1,
        "duration": 600000000,
        "interval": 200000000,
        "length": 48,
        "received_stats": "both",
        "stamp_at": "both",
        "clock": "both",
        "dscp": 0,
        "server_fill": ""
    },
    "loose": false,
    "ip_version": "IPv4",
    "df": 0,
    "ttl": 0,
    "timer": "comp",
    "waiter": "3x4s",
    "filler": "none",
    "fill_one": false,
    "thread_lock": false,
    "supplied": {
        "local_address": ":0",
        "remote_address": "localhost",
        "open_timeouts": "1s,2s,4s,8s",
        "params": {
            "proto_version": 1,
            "duration": 600000000,
            "interval": 200000000,
            "length": 0,
            "received_stats": "both",
            "stamp_at": "both",
            "clock": "both",
            "dscp": 0,
            "server_fill": ""
        },
        "loose": false,
        "ip_version": "IPv4+6",
        "df": 0,
        "ttl": 0,
        "timer": "comp",
        "waiter": "3x4s",
        "filler": "none",
        "fill_one": false,
        "thread_lock": false
    }
},

•

local_address the local address (IP:port) for the client

•

remote_address the remote address (IP:port) for the server

•

open_timeouts a list of timeout durations used after an open packet is sent

•

params are the parameters that were negotiated with the server, including:

•

loose if true, client accepts and uses restricted server parameters, with a warning

•

ip_version the IP version used (IPv4 or IPv6)

•

df the do-not-fragment setting (0 == OS default, 1 == false, 2 == true)

•

ttl the IP time-to-live (https://en.wikipedia.org/wiki/Time_to_live) value

•

timer the timer used: simple, comp, hybrid or busy (irtt client --timer flag)

•

waiter the waiter used: fixed duration, multiple of RTT or multiple of max RTT (irtt client --wait flag)

•

filler the packet filler used: none, rand or pattern (irtt client --fill flag)

•

fill_one whether to fill only once and repeat for all packets (irtt client --fill-one flag)

•

thread_lock whether to lock packet handling goroutines to OS threads

•

supplied a nested config object with the configuration as originally supplied to the API or irtt command. The supplied configuration can differ from the final configuration in the following ways:

stats¶

statistics for the results

"stats": {
    "start_time": "2017-10-16T21:05:23.502719056+02:00",
    "send_call": {
        "total": 79547,
        "n": 3,
        "min": 17790,
        "max": 33926,
        "mean": 26515,
        "stddev": 8148,
        "variance": 66390200
    },
    "timer_error": {
        "total": 227261,
        "n": 2,
        "min": 59003,
        "max": 168258,
        "mean": 113630,
        "stddev": 77254,
        "variance": 5968327512
    },
    "rtt": {
        "total": 233915,
        "n": 2,
        "min": 99455,
        "max": 134460,
        "mean": 116957,
        "median": 116957,
        "stddev": 24752,
        "variance": 612675012
    },
    "send_delay": {
        "total": 143470,
        "n": 2,
        "min": 54187,
        "max": 89283,
        "mean": 71735,
        "median": 71735,
        "stddev": 24816,
        "variance": 615864608
    },
    "receive_delay": {
        "total": 90445,
        "n": 2,
        "min": 45177,
        "max": 45268,
        "mean": 45222,
        "median": 45222,
        "stddev": 64,
        "variance": 4140
    },
    "server_packets_received": 2,
    "bytes_sent": 144,
    "bytes_received": 96,
    "duplicates": 0,
    "late_packets": 0,
    "wait": 403380,
    "duration": 400964028,
    "packets_sent": 3,
    "packets_received": 2,
    "packet_loss_percent": 33.333333333333336,
    "upstream_loss_percent": 33.333333333333336,
    "downstream_loss_percent": 0,
    "duplicate_percent": 0,
    "late_packets_percent": 0,
    "ipdv_send": {
        "total": 35096,
        "n": 1,
        "min": 35096,
        "max": 35096,
        "mean": 35096,
        "median": 35096,
        "stddev": 0,
        "variance": 0
    },
    "ipdv_receive": {
        "total": 91,
        "n": 1,
        "min": 91,
        "max": 91,
        "mean": 91,
        "median": 91,
        "stddev": 0,
        "variance": 0
    },
    "ipdv_round_trip": {
        "total": 35005,
        "n": 1,
        "min": 35005,
        "max": 35005,
        "mean": 35005,
        "median": 35005,
        "stddev": 0,
        "variance": 0
    },
    "server_processing_time": {
        "total": 20931,
        "n": 2,
        "min": 9979,
        "max": 10952,
        "mean": 10465,
        "stddev": 688,
        "variance": 473364
    },
    "timer_err_percent": 0.056815,
    "timer_misses": 0,
    "timer_miss_percent": 0,
    "send_rate": {
        "bps": 2878,
        "string": "2.9 Kbps"
    },
    "receive_rate": {
        "bps": 3839,
        "string": "3.8 Kbps"
    }
},

Note: In the stats object, a duration stats class of object repeats and will not be repeated in the individual descriptions. It contains statistics about nanosecond duration values and has the following attributes:

•

total the total of the duration values

•

n the number of duration values

•

min the minimum duration value

•

max the maximum duration value

•

mean the mean duration value

•

stddev the standard deviation

•

variance the variance

The regular attributes in stats are as follows:

•

start_time the start time of the test, in TZ format

•

send_call a duration stats object for the call time when sending packets

•

timer_error a duration stats object for the observed sleep time error

•

rtt a duration stats object for the round-trip time

•

send_delay a duration stats object for the one-way send delay (only available if server timestamps are enabled)

•

receive_delay a duration stats object for the one-way receive delay (only available if server timestamps are enabled)

•

server_packets_received the number of packets received by the server, including duplicates (always present, but only valid if the ReceivedStats parameter includes ReceivedStatsCount, or the --stats flag to the irtt client is count or both)

•

bytes_sent the number of UDP payload bytes sent during the test

•

bytes_received the number of UDP payload bytes received during the test

•

duplicates the number of packets received with the same sequence number

•

late_packets the number of packets received with a sequence number lower than the previously received sequence number (one simple metric for out-of-order packets)

•

wait the actual time spent waiting for final packets, in nanoseconds

•

duration the actual duration of the test, in nanoseconds, from the time just before the first packet was sent to the time after the last packet was received and results are starting to be calculated

•

packets_sent the number of packets sent to the server

•

packets_received the number of packets received from the server

•

packet_loss_percent 100 * (packets_sent - packets_received) / packets_sent

•

upstream_loss_percent 100 * (packets_sent - server_packets_received / packets_sent) (always present, but only valid if server_packets_received is valid)

•

downstream_loss_percent 100 * (server_packets_received - packets_received / server_packets_received) (always present, but only valid if server_packets_received is valid)

•

duplicate_percent 100 * duplicates / packets_received

•

late_packets_percent 100 * late_packets / packets_received

•

ipdv_send a duration stats object for the send IPDV (https://en.wikipedia.org/wiki/Packet_delay_variation) (only available if server timestamps are enabled)

•

ipdv_receive a duration stats object for the receive IPDV (https://en.wikipedia.org/wiki/Packet_delay_variation) (only available if server timestamps are enabled)

•

ipdv_round_trip a duration stats object for the round-trip IPDV (https://en.wikipedia.org/wiki/Packet_delay_variation) (available regardless of whether server timestamps are enabled or not)

•

server_processing_time a duration stats object for the time the server took after it received the packet to when it sent the response (only available when both send and receive timestamps are enabled)

•

timer_err_percent the mean of the absolute values of the timer error, as a percentage of the interval

•

timer_misses the number of times the timer missed the interval (was at least 50% over the scheduled time)

•

timer_miss_percent 100 * timer_misses / expected packets sent

•

send_rate the send bitrate (bits-per-second and corresponding string), calculated using the number of UDP payload bytes sent between the time right before the first send call and the time right after the last send call

•

receive_rate the receive bitrate (bits-per-second and corresponding string), calculated using the number of UDP payload bytes received between the time right after the first receive call and the time right after the last receive call

round_trips¶

each round-trip is a single request to / reply from the server

"round_trips": [
    {
        "seqno": 0,
        "lost": false,
        "timestamps": {
            "client": {
                "receive": {
                    "wall": 1508180723502871779,
                    "monotonic": 2921143
                },
                "send": {
                    "wall": 1508180723502727340,
                    "monotonic": 2776704
                }
            },
            "server": {
                "receive": {
                    "wall": 1508180723502816623,
                    "monotonic": 32644353327
                },
                "send": {
                    "wall": 1508180723502826602,
                    "monotonic": 32644363306
                }
            }
        },
        "delay": {
            "receive": 45177,
            "rtt": 134460,
            "send": 89283
        },
        "ipdv": {}
    },
    {
        "seqno": 1,
        "lost": false,
        "timestamps": {
            "client": {
                "receive": {
                    "wall": 1508180723702917735,
                    "monotonic": 202967099
                },
                "send": {
                    "wall": 1508180723702807328,
                    "monotonic": 202856692
                }
            },
            "server": {
                "receive": {
                    "wall": 1508180723702861515,
                    "monotonic": 32844398219
                },
                "send": {
                    "wall": 1508180723702872467,
                    "monotonic": 32844409171
                }
            }
        },
        "delay": {
            "receive": 45268,
            "rtt": 99455,
            "send": 54187
        },
        "ipdv": {
            "receive": 91,
            "rtt": -35005,
            "send": -35096
        }
    },
    {
        "seqno": 2,
        "lost": true,
        "timestamps": {
            "client": {
                "receive": {},
                "send": {
                    "wall": 1508180723902925971,
                    "monotonic": 402975335
                }
            },
            "server": {
                "receive": {},
                "send": {}
            }
        },
        "delay": {},
        "ipdv": {}
    }
]

Note: wall values are from Go's time.Time.UnixNano(), the number of nanoseconds elapsed since January 1, 1970 UTC

Note: monotonic values are the number of nanoseconds since the start of the test for the client, and since start of the process for the server

•

seqno the sequence number

•

lost the lost status of the packet, which can be one of false, true, true_down or true_up. The true_down and true_up values are only possible if the ReceivedStats parameter includes ReceivedStatsWindow (irtt client --stats flag). Even then, if it could not be determined whether the packet was lost upstream or downstream, the value true is used.

•

timestamps the client and server timestamps

•

delay an object containing the delay values

•

ipdv an object containing the IPDV (https://en.wikipedia.org/wiki/Packet_delay_variation) values (attributes present only for seqno > 0, and if lost is false for both the current and previous round_trip)