TCP INFO

TCP measures the network as part of its normal operation. All transport protocols, including TCP, measure the network to determine how much data to send and when to optimally fill the network. Sending too much data or sending it too fast results in congestion, network queue overflows and discarded packets; sending data too slowly results in under-filled networks and wasted idle capacity. TCP INFO exposes these built in measurements for diagnostics and other applications.

M-Lab uses TCP INFO to collect statistics about every TCP connection used by each hosted measurement service running on the M-Lab platform. TCP INFO runs as a “side” addition to other tools, taking advantage of TCP connections generated by incoming tests to M-Lab.

Source code for M-Lab’s TCP INFO statistics collector

Citing the M-Lab TCP INFO Dataset

Please cite this data set as follows: The M-Lab TCP INFO Data Set, <date range used>. https://measurementlab.net/tests/tcp-info

TCP INFO Data in Raw Format

Data collected by TCP INFO is available in raw format in Google Cloud Storage for each hosted measurement service:

TCP INFO Data in BigQuery

M-Lab parses all TCP INFO data into BigQuery tables and views, and makes query access available for free. Find out more about how to get access on our BigQuery QuickStart page.

BigQuery Tables/Views for TCP INFO Data:

  • M-Lab Host Server TCP INFO data - Coming soon: measurement-lab.host.tcpinfo
  • NDT TCP INFO data - measurement-lab.ndt.tcpinfo
  • Neubot TCP INFO data - Coming soon: measurement-lab.neubot.tcpinfo
  • WeHe TCP INFO data - Coming soon: measurement-lab.wehe.tcpinfo

TCP INFO Schema

Note: The tcpinfo schema has not yet been migrated to standard columns. Until that time, this schema should be considered temporary or unstable.

Field name Type Description
UUID STRING  
TestTime TIMESTAMP  
ClientASN INTEGER  
ServerASN INTEGER  
ParseInfo RECORD Metadata about how the parser processed the measurement.
ParseInfo.TaskFileName STRING GCS URL to the archive containing the test_id for this row.
ParseInfo.ParseTime TIMESTAMP Time that the parser processed this row.
ParseInfo.ParserVersion STRING Version of the parser that processed this row.
ParseInfo.Filename STRING  
SockID RECORD  
SockID.SPort INTEGER  
SockID.DPort INTEGER  
SockID.SrcIP STRING  
SockID.DstIP STRING  
SockID.Interface INTEGER  
SockID.Cookie INTEGER  
Server RECORD  
Server.IP STRING  
Server.Port INTEGER  
Server.IATA STRING  
Server.Geo RECORD  
Server.Geo.continent_code STRING  
Server.Geo.country_code STRING  
Server.Geo.country_code3 STRING  
Server.Geo.country_name STRING  
Server.Geo.region STRING  
Server.Geo.Subdivision1ISOCode STRING  
Server.Geo.Subdivision1Name STRING  
Server.Geo.Subdivision2ISOCode STRING  
Server.Geo.Subdivision2Name STRING  
Server.Geo.metro_code INTEGER  
Server.Geo.city STRING  
Server.Geo.area_code INTEGER  
Server.Geo.postal_code STRING  
Server.Geo.latitude FLOAT  
Server.Geo.longitude FLOAT  
Server.Geo.radius INTEGER  
Server.Geo.Missing BOOLEAN The annotator looked for but was unable to find a Geo location for this IP.
Server.Network RECORD Network information about connection.
Server.Network.IPPrefix STRING  
Server.Network.CIDR STRING  
Server.Network.ASNumber INTEGER The Autonomous System Number, provided by RouteViews.
Server.Network.ASName STRING Canonical name for the ASN, provided by ipinfo.io.
Server.Network.Missing BOOLEAN The annotator looked but was unable to find a network for this IP.
Server.Network.Systems RECORD  
Server.Network.Systems.ASNs INTEGER  
Client RECORD  
Client.IP STRING  
Client.Port INTEGER  
Client.Geo RECORD  
Client.Geo.continent_code STRING  
Client.Geo.country_code STRING  
Client.Geo.country_code3 STRING  
Client.Geo.country_name STRING  
Client.Geo.region STRING  
Client.Geo.Subdivision1ISOCode STRING  
Client.Geo.Subdivision1Name STRING  
Client.Geo.Subdivision2ISOCode STRING  
Client.Geo.Subdivision2Name STRING  
Client.Geo.metro_code INTEGER  
Client.Geo.city STRING  
Client.Geo.area_code INTEGER  
Client.Geo.postal_code STRING  
Client.Geo.latitude FLOAT  
Client.Geo.longitude FLOAT  
Client.Geo.radius INTEGER  
Client.Geo.Missing BOOLEAN The annotator looked for but was unable to find a Geo location for this IP.
Client.Network RECORD Network information about connection.
Client.Network.IPPrefix STRING  
Client.Network.CIDR STRING  
Client.Network.ASNumber INTEGER The Autonomous System Number, provided by RouteViews.
Client.Network.ASName STRING Canonical name for the ASN, provided by ipinfo.io.
Client.Network.Missing BOOLEAN The annotator looked but was unable to find a network for this IP.
Client.Network.Systems RECORD  
Client.Network.Systems.ASNs INTEGER  
FinalSnapshot RECORD  
FinalSnapshot.Timestamp TIMESTAMP  
FinalSnapshot.Observed INTEGER  
FinalSnapshot.NotFullyParsed INTEGER  
FinalSnapshot.InetDiagMsg RECORD  
FinalSnapshot.InetDiagMsg.IDiagFamily INTEGER  
FinalSnapshot.InetDiagMsg.IDiagState INTEGER  
FinalSnapshot.InetDiagMsg.IDiagTimer INTEGER  
FinalSnapshot.InetDiagMsg.IDiagRetrans INTEGER  
FinalSnapshot.InetDiagMsg.IDiagExpires INTEGER  
FinalSnapshot.InetDiagMsg.IDiagRqueue INTEGER  
FinalSnapshot.InetDiagMsg.IDiagWqueue INTEGER  
FinalSnapshot.InetDiagMsg.IDiagUID INTEGER  
FinalSnapshot.InetDiagMsg.IDiagInode INTEGER  
FinalSnapshot.CongestionAlgorithm STRING  
FinalSnapshot.TOS INTEGER  
FinalSnapshot.TClass INTEGER  
FinalSnapshot.ClassID INTEGER  
FinalSnapshot.Shutdown INTEGER  
FinalSnapshot.Protocol INTEGER  
FinalSnapshot.Mark INTEGER  
FinalSnapshot.TCPInfo RECORD Results from getsockopt(..TCP_INFO..)
FinalSnapshot.TCPInfo.State INTEGER TCP State
In MLab data TCP state is nominally 1 (Established). Other values reflect transient states having incomplete rows.
Kernel: See TCP_ESTABLISHED in include/net/tcp_states.h
FinalSnapshot.TCPInfo.CAState INTEGER Loss recovery state machine
For traditional loss based congestion control algorithms, CAState is also used to control window adjustments.
Kernel: tcp_set_ca_state in include/net/tcp.h
FinalSnapshot.TCPInfo.Retransmits INTEGER Number of timeouts (RTO based retransmissions) at this sequence.
Reset to zero on forward progress
Kernel: icsk_retransmits in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.Probes INTEGER Consecutive zero window probes that have gone unanswered
Kernel: icsk_probes_out in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.Backoff INTEGER Exponential timeout backoff counter
Increment on RTO, reset on successful RTT measurements.
Kernel: icsk_backoff in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.Options INTEGER Bit encoded SYN options and other negotiations
TIMESTAMPS 0x1; SACK 0x2; WSCALE 0x4; ECN 0x8 - Was negotiated; ECN_SEEN - At least one ECT seen; SYN_DATA - SYN-ACK acknowledged data in SYN sent or rcvd
Kernel: TCPI_OPT_TIMESTAMPS in include/uapi/linux/tcp.h
FinalSnapshot.TCPInfo.WScale INTEGER BUG Conflation of SndWScale and RcvWScale
See github.com/m-lab/etl/issues/790
FinalSnapshot.TCPInfo.AppLimited INTEGER Flag indicating that rate measurements reflect non-network bottlenecks
Note that even very short application stalls invalidate max_BW measurements.
Kernel: rate_app_limited in include/linux/tcp.h
FinalSnapshot.TCPInfo.RTO INTEGER Retransmission Timeout
Quantized to system jiffies
Kernel: icsk_rto in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.ATO INTEGER Delayed ACK Timeout
Quantized to system jiffies
Kernel: ato in icsk_ack in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.SndMSS INTEGER Current Maximum Segment Size
Note that this can be smaller than the negotiated MSS for various reasons
Kernel: mss_cache in include/linux/tcp.h
FinalSnapshot.TCPInfo.RcvMSS INTEGER Maximum observed segment size from the remote host
Used to trigger delayed ACKs
Kernel: rcv_mss in icsk_ack in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.Unacked INTEGER Number of segments between snd.nxt and snd.una
Accounting for the Pipe algorithm
Kernel: packets_out in include/linux/tcp.h
FinalSnapshot.TCPInfo.Sacked INTEGER Scoreboard segment marked SACKED by sack blocks
Accounting for the Pipe algorithm
Kernel: sacked_out in include/linux/tcp.h
FinalSnapshot.TCPInfo.Lost INTEGER Scoreboard segments marked lost by loss detection heuristics
Accounting for the Pipe algorithm
Kernel: lost_out in include/linux/tcp.h
FinalSnapshot.TCPInfo.Retrans INTEGER Scoreboard segments marked retransmitted
Accounting for the Pipe algorithm
Kernel: retrans_out in include/linux/tcp.h
FinalSnapshot.TCPInfo.Fackets INTEGER Unused
Kernel: tcpi_fackets in include/uapi/linux/tcp.h
FinalSnapshot.TCPInfo.LastDataSent INTEGER Time since last data segment was sent
Quantized to jiffies
Kernel: lsndtime in include/linux/tcp.h
FinalSnapshot.TCPInfo.LastAckSent INTEGER Time since last ACK was sent (Not implemented)
Present in TCP_INFO but not elsewhere in the kernel
FinalSnapshot.TCPInfo.LastDataRecv INTEGER Time since last data segment was received
Quantized to jiffies
Kernel: lrcvtime in icsk_ack in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.LastAckRecv INTEGER Time since last ACK was received
Quantized to jiffies
Kernel: rcv_tstamp in include/linux/tcp.h
FinalSnapshot.TCPInfo.PMTU INTEGER Maximum IP Transmission Unit for this path
Kernel: icsk_pmtu_cookie in include/net/inet_connection_sock.h
FinalSnapshot.TCPInfo.RcvSsThresh INTEGER Current Window Clamp
Receiver algorithm to avoid allocating excessive receive buffers
Kernel: rcv_ssthresh in include/linux/tcp.h
FinalSnapshot.TCPInfo.RTT INTEGER Smoothed Round Trip Time (RTT)
The Linux implementation differs from the standard
Kernel: srtt_us in include/linux/tcp.h
FinalSnapshot.TCPInfo.RTTVar INTEGER RTT variance
The Linux implementation differs from the standard
Kernel: mdev_us in include/linux/tcp.h
FinalSnapshot.TCPInfo.SndSsThresh INTEGER Slow Start Threshold
Value controlled by the selected congestion control algorithm
Kernel: snd_ssthresh in include/linux/tcp.h
FinalSnapshot.TCPInfo.SndCwnd INTEGER Congestion Window
Value controlled by the selected congestion control algorithm
Kernel: snd_cwnd in include/linux/tcp.h
FinalSnapshot.TCPInfo.AdvMSS INTEGER Advertised MSS
Kernel: advmss in include/linux/tcp.h
FinalSnapshot.TCPInfo.Reordering INTEGER Maximum observed reordering distance
Kernel: reordering in include/linux/tcp.h
FinalSnapshot.TCPInfo.RcvRTT INTEGER Receiver Side RTT estimate
Kernel: rcv_rtt_est.rtt_us in include/linux/tcp.h
FinalSnapshot.TCPInfo.RcvSpace INTEGER Space reserved for the receive queue
Typically updated by receiver side auto-tuning
Kernel: space in rcvq_space in include/linux/tcp.h
FinalSnapshot.TCPInfo.TotalRetrans INTEGER Total number of segments containing retransmitted data
Kernel: total_retrans in include/linux/tcp.h
FinalSnapshot.TCPInfo.PacingRate INTEGER Current Pacing Rate, nominally updated by congestion control
Kernel: sk_pacing_rate in include/net/sock.h
FinalSnapshot.TCPInfo.MaxPacingRate INTEGER Settable pacing rate clamp
Set with setsockopt( ..SO_MAX_PACING_RATE.. )
Kernel: sk_max_pacing_rate in include/net/sock.h
FinalSnapshot.TCPInfo.BytesAcked INTEGER The number of data bytes for which cumulative acknowledgments have been received
Kernel: bytes_acked in include/linux/tcp.h
FinalSnapshot.TCPInfo.BytesReceived INTEGER The number of data bytes for which have been received
Kernel: bytes_received in include/linux/tcp.h
FinalSnapshot.TCPInfo.SegsOut INTEGER The number of segments transmitted
Includes data and pure ACKs
Kernel: segs_out in include/linux/tcp.h
FinalSnapshot.TCPInfo.SegsIn INTEGER The number of segments received
Includes data and pure ACKs
Kernel: segs_in in include/linux/tcp.h
FinalSnapshot.TCPInfo.NotsentBytes INTEGER Number of bytes queued in the send buffer that have not been sent
Kernel: tcpi_notsent_bytes() in net/ipv4/tcp.c
FinalSnapshot.TCPInfo.MinRTT INTEGER Minimum RTT
From an older, pre-BBR algorithm
Kernel: tcp_min_rtt in include/net/tcp.h
FinalSnapshot.TCPInfo.DataSegsIn INTEGER Input segments carrying data (len>0)
Kernel: data_segs_in in include/net/tcp.h
FinalSnapshot.TCPInfo.DataSegsOut INTEGER Transmitted segments carrying data (len>0)
Kernel: data_segs_out in include/net/tcp.h
FinalSnapshot.TCPInfo.DeliveryRate INTEGER Observed Maximum Delivery Rate
Kernel: tcp_compute_delivery_rate() in net/ipv4/tcp.c
FinalSnapshot.TCPInfo.BusyTime INTEGER Time with outstanding (unacknowledged) data
Time when snd.una not equal to snd.next
Kernel: tcp_get_info_chrono_stats() in net/ipv4/tcp.c
FinalSnapshot.TCPInfo.RWndLimited INTEGER Time spend waiting for receiver window
Kernel: tcp_get_info_chrono_stats() in net/ipv4/tcp.c
FinalSnapshot.TCPInfo.SndBufLimited INTEGER Time spend waiting for sender buffer space
This only includes the time when TCP transmissions are starved for data, but the application has been stopped because the buffer is full and can not be grown for some reason.
Kernel: tcp_get_info_chrono_stats() in net/ipv4/tcp.c
FinalSnapshot.TCPInfo.Delivered INTEGER Data segments delivered to the receiver including retransmits
As reported by returning ACKs, used by ECN
Kernel: delivered in include/linux/tcp.h
FinalSnapshot.TCPInfo.DeliveredCE INTEGER ECE marked data segments delivered to the receiver including retransmits
As reported by returning ACKs, used by ECN
Kernel: delivered_ce in include/linux/tcp.h
FinalSnapshot.TCPInfo.BytesSent INTEGER Payload bytes sent (excludes headers, includes retransmissions)
Kernel: bytes_sent
FinalSnapshot.TCPInfo.BytesRetrans INTEGER Bytes retransmitted
May include headers and new data carried with a retransmission (for thin flows).
Kernel: bytes_retrans
FinalSnapshot.TCPInfo.DSackDups INTEGER Duplicate segments reported by DSACK
Not reported by some OS
Kernel: dsack_dups
FinalSnapshot.TCPInfo.ReordSeen INTEGER Received ACKs that were out of order
Estimates reordering on the return path
Kernel: reord_seen
FinalSnapshot.TCPInfo.RcvOooPack INTEGER  
FinalSnapshot.TCPInfo.SndWnd INTEGER  
FinalSnapshot.MemInfo RECORD  
FinalSnapshot.MemInfo.Rmem INTEGER  
FinalSnapshot.MemInfo.Wmem INTEGER  
FinalSnapshot.MemInfo.Fmem INTEGER  
FinalSnapshot.MemInfo.Tmem INTEGER  
FinalSnapshot.SocketMem RECORD  
FinalSnapshot.SocketMem.RmemAlloc INTEGER  
FinalSnapshot.SocketMem.Rcvbuf INTEGER  
FinalSnapshot.SocketMem.WmemAlloc INTEGER  
FinalSnapshot.SocketMem.Sndbuf INTEGER  
FinalSnapshot.SocketMem.FwdAlloc INTEGER  
FinalSnapshot.SocketMem.WmemQueued INTEGER  
FinalSnapshot.SocketMem.Optmem INTEGER  
FinalSnapshot.SocketMem.Backlog INTEGER  
FinalSnapshot.SocketMem.Drops INTEGER  
FinalSnapshot.VegasInfo RECORD Instrumntation in Vegas TCP
Not used by M-Lab
FinalSnapshot.VegasInfo.Enabled INTEGER  
FinalSnapshot.VegasInfo.RTTCount INTEGER  
FinalSnapshot.VegasInfo.RTT INTEGER  
FinalSnapshot.VegasInfo.MinRTT INTEGER  
FinalSnapshot.DCTCPInfo RECORD Instrumentation in DCTCP
Not used by M-Lab
FinalSnapshot.DCTCPInfo.Enabled INTEGER  
FinalSnapshot.DCTCPInfo.CEState INTEGER  
FinalSnapshot.DCTCPInfo.Alpha INTEGER  
FinalSnapshot.DCTCPInfo.ABEcn INTEGER  
FinalSnapshot.DCTCPInfo.ABTot INTEGER  
FinalSnapshot.BBRInfo RECORD Instrumentation in the BBR TCP module in the kernel.
FinalSnapshot.BBRInfo.BW INTEGER The maximum end-to-end bandwidth from the server to the client as measured by BBR.
FinalSnapshot.BBRInfo.MinRTT INTEGER The minimum round trip time as measured by BBR.
FinalSnapshot.BBRInfo.PacingGain INTEGER Fixed point multiplier used to set the pacing rate from the maximum bandwidth.
The binary point varies by kernel version but the statistical mode is always 1.0.
FinalSnapshot.BBRInfo.CwndGain INTEGER Fixed point multiplier used to set the maximum window size from BW*MinRTT.
Snapshots RECORD  
Snapshots.Timestamp TIMESTAMP  
Snapshots.Observed INTEGER  
Snapshots.NotFullyParsed INTEGER  
Snapshots.InetDiagMsg RECORD  
Snapshots.InetDiagMsg.IDiagFamily INTEGER  
Snapshots.InetDiagMsg.IDiagState INTEGER  
Snapshots.InetDiagMsg.IDiagTimer INTEGER  
Snapshots.InetDiagMsg.IDiagRetrans INTEGER  
Snapshots.InetDiagMsg.IDiagExpires INTEGER  
Snapshots.InetDiagMsg.IDiagRqueue INTEGER  
Snapshots.InetDiagMsg.IDiagWqueue INTEGER  
Snapshots.InetDiagMsg.IDiagUID INTEGER  
Snapshots.InetDiagMsg.IDiagInode INTEGER  
Snapshots.CongestionAlgorithm STRING  
Snapshots.TOS INTEGER  
Snapshots.TClass INTEGER  
Snapshots.ClassID INTEGER  
Snapshots.Shutdown INTEGER  
Snapshots.Protocol INTEGER  
Snapshots.Mark INTEGER  
Snapshots.TCPInfo RECORD Results from getsockopt(..TCP_INFO..)
Snapshots.TCPInfo.State INTEGER TCP State
In MLab data TCP state is nominally 1 (Established). Other values reflect transient states having incomplete rows.
Kernel: See TCP_ESTABLISHED in include/net/tcp_states.h
Snapshots.TCPInfo.CAState INTEGER Loss recovery state machine
For traditional loss based congestion control algorithms, CAState is also used to control window adjustments.
Kernel: tcp_set_ca_state in include/net/tcp.h
Snapshots.TCPInfo.Retransmits INTEGER Number of timeouts (RTO based retransmissions) at this sequence.
Reset to zero on forward progress
Kernel: icsk_retransmits in include/net/inet_connection_sock.h
Snapshots.TCPInfo.Probes INTEGER Consecutive zero window probes that have gone unanswered
Kernel: icsk_probes_out in include/net/inet_connection_sock.h
Snapshots.TCPInfo.Backoff INTEGER Exponential timeout backoff counter
Increment on RTO, reset on successful RTT measurements.
Kernel: icsk_backoff in include/net/inet_connection_sock.h
Snapshots.TCPInfo.Options INTEGER Bit encoded SYN options and other negotiations
TIMESTAMPS 0x1; SACK 0x2; WSCALE 0x4; ECN 0x8 - Was negotiated; ECN_SEEN - At least one ECT seen; SYN_DATA - SYN-ACK acknowledged data in SYN sent or rcvd
Kernel: TCPI_OPT_TIMESTAMPS in include/uapi/linux/tcp.h
Snapshots.TCPInfo.WScale INTEGER BUG Conflation of SndWScale and RcvWScale
See github.com/m-lab/etl/issues/790
Snapshots.TCPInfo.AppLimited INTEGER Flag indicating that rate measurements reflect non-network bottlenecks
Note that even very short application stalls invalidate max_BW measurements.
Kernel: rate_app_limited in include/linux/tcp.h
Snapshots.TCPInfo.RTO INTEGER Retransmission Timeout
Quantized to system jiffies
Kernel: icsk_rto in include/net/inet_connection_sock.h
Snapshots.TCPInfo.ATO INTEGER Delayed ACK Timeout
Quantized to system jiffies
Kernel: ato in icsk_ack in include/net/inet_connection_sock.h
Snapshots.TCPInfo.SndMSS INTEGER Current Maximum Segment Size
Note that this can be smaller than the negotiated MSS for various reasons
Kernel: mss_cache in include/linux/tcp.h
Snapshots.TCPInfo.RcvMSS INTEGER Maximum observed segment size from the remote host
Used to trigger delayed ACKs
Kernel: rcv_mss in icsk_ack in include/net/inet_connection_sock.h
Snapshots.TCPInfo.Unacked INTEGER Number of segments between snd.nxt and snd.una
Accounting for the Pipe algorithm
Kernel: packets_out in include/linux/tcp.h
Snapshots.TCPInfo.Sacked INTEGER Scoreboard segment marked SACKED by sack blocks
Accounting for the Pipe algorithm
Kernel: sacked_out in include/linux/tcp.h
Snapshots.TCPInfo.Lost INTEGER Scoreboard segments marked lost by loss detection heuristics
Accounting for the Pipe algorithm
Kernel: lost_out in include/linux/tcp.h
Snapshots.TCPInfo.Retrans INTEGER Scoreboard segments marked retransmitted
Accounting for the Pipe algorithm
Kernel: retrans_out in include/linux/tcp.h
Snapshots.TCPInfo.Fackets INTEGER Unused
Kernel: tcpi_fackets in include/uapi/linux/tcp.h
Snapshots.TCPInfo.LastDataSent INTEGER Time since last data segment was sent
Quantized to jiffies
Kernel: lsndtime in include/linux/tcp.h
Snapshots.TCPInfo.LastAckSent INTEGER Time since last ACK was sent (Not implemented)
Present in TCP_INFO but not elsewhere in the kernel
Snapshots.TCPInfo.LastDataRecv INTEGER Time since last data segment was received
Quantized to jiffies
Kernel: lrcvtime in icsk_ack in include/net/inet_connection_sock.h
Snapshots.TCPInfo.LastAckRecv INTEGER Time since last ACK was received
Quantized to jiffies
Kernel: rcv_tstamp in include/linux/tcp.h
Snapshots.TCPInfo.PMTU INTEGER Maximum IP Transmission Unit for this path
Kernel: icsk_pmtu_cookie in include/net/inet_connection_sock.h
Snapshots.TCPInfo.RcvSsThresh INTEGER Current Window Clamp
Receiver algorithm to avoid allocating excessive receive buffers
Kernel: rcv_ssthresh in include/linux/tcp.h
Snapshots.TCPInfo.RTT INTEGER Smoothed Round Trip Time (RTT)
The Linux implementation differs from the standard
Kernel: srtt_us in include/linux/tcp.h
Snapshots.TCPInfo.RTTVar INTEGER RTT variance
The Linux implementation differs from the standard
Kernel: mdev_us in include/linux/tcp.h
Snapshots.TCPInfo.SndSsThresh INTEGER Slow Start Threshold
Value controlled by the selected congestion control algorithm
Kernel: snd_ssthresh in include/linux/tcp.h
Snapshots.TCPInfo.SndCwnd INTEGER Congestion Window
Value controlled by the selected congestion control algorithm
Kernel: snd_cwnd in include/linux/tcp.h
Snapshots.TCPInfo.AdvMSS INTEGER Advertised MSS
Kernel: advmss in include/linux/tcp.h
Snapshots.TCPInfo.Reordering INTEGER Maximum observed reordering distance
Kernel: reordering in include/linux/tcp.h
Snapshots.TCPInfo.RcvRTT INTEGER Receiver Side RTT estimate
Kernel: rcv_rtt_est.rtt_us in include/linux/tcp.h
Snapshots.TCPInfo.RcvSpace INTEGER Space reserved for the receive queue
Typically updated by receiver side auto-tuning
Kernel: space in rcvq_space in include/linux/tcp.h
Snapshots.TCPInfo.TotalRetrans INTEGER Total number of segments containing retransmitted data
Kernel: total_retrans in include/linux/tcp.h
Snapshots.TCPInfo.PacingRate INTEGER Current Pacing Rate, nominally updated by congestion control
Kernel: sk_pacing_rate in include/net/sock.h
Snapshots.TCPInfo.MaxPacingRate INTEGER Settable pacing rate clamp
Set with setsockopt( ..SO_MAX_PACING_RATE.. )
Kernel: sk_max_pacing_rate in include/net/sock.h
Snapshots.TCPInfo.BytesAcked INTEGER The number of data bytes for which cumulative acknowledgments have been received
Kernel: bytes_acked in include/linux/tcp.h
Snapshots.TCPInfo.BytesReceived INTEGER The number of data bytes for which have been received
Kernel: bytes_received in include/linux/tcp.h
Snapshots.TCPInfo.SegsOut INTEGER The number of segments transmitted
Includes data and pure ACKs
Kernel: segs_out in include/linux/tcp.h
Snapshots.TCPInfo.SegsIn INTEGER The number of segments received
Includes data and pure ACKs
Kernel: segs_in in include/linux/tcp.h
Snapshots.TCPInfo.NotsentBytes INTEGER Number of bytes queued in the send buffer that have not been sent
Kernel: tcpi_notsent_bytes() in net/ipv4/tcp.c
Snapshots.TCPInfo.MinRTT INTEGER Minimum RTT
From an older, pre-BBR algorithm
Kernel: tcp_min_rtt in include/net/tcp.h
Snapshots.TCPInfo.DataSegsIn INTEGER Input segments carrying data (len>0)
Kernel: data_segs_in in include/net/tcp.h
Snapshots.TCPInfo.DataSegsOut INTEGER Transmitted segments carrying data (len>0)
Kernel: data_segs_out in include/net/tcp.h
Snapshots.TCPInfo.DeliveryRate INTEGER Observed Maximum Delivery Rate
Kernel: tcp_compute_delivery_rate() in net/ipv4/tcp.c
Snapshots.TCPInfo.BusyTime INTEGER Time with outstanding (unacknowledged) data
Time when snd.una not equal to snd.next
Kernel: tcp_get_info_chrono_stats() in net/ipv4/tcp.c
Snapshots.TCPInfo.RWndLimited INTEGER Time spend waiting for receiver window
Kernel: tcp_get_info_chrono_stats() in net/ipv4/tcp.c
Snapshots.TCPInfo.SndBufLimited INTEGER Time spend waiting for sender buffer space
This only includes the time when TCP transmissions are starved for data, but the application has been stopped because the buffer is full and can not be grown for some reason.
Kernel: tcp_get_info_chrono_stats() in net/ipv4/tcp.c
Snapshots.TCPInfo.Delivered INTEGER Data segments delivered to the receiver including retransmits
As reported by returning ACKs, used by ECN
Kernel: delivered in include/linux/tcp.h
Snapshots.TCPInfo.DeliveredCE INTEGER ECE marked data segments delivered to the receiver including retransmits
As reported by returning ACKs, used by ECN
Kernel: delivered_ce in include/linux/tcp.h
Snapshots.TCPInfo.BytesSent INTEGER Payload bytes sent (excludes headers, includes retransmissions)
Kernel: bytes_sent
Snapshots.TCPInfo.BytesRetrans INTEGER Bytes retransmitted
May include headers and new data carried with a retransmission (for thin flows).
Kernel: bytes_retrans
Snapshots.TCPInfo.DSackDups INTEGER Duplicate segments reported by DSACK
Not reported by some OS
Kernel: dsack_dups
Snapshots.TCPInfo.ReordSeen INTEGER Received ACKs that were out of order
Estimates reordering on the return path
Kernel: reord_seen
Snapshots.TCPInfo.RcvOooPack INTEGER  
Snapshots.TCPInfo.SndWnd INTEGER  
Snapshots.MemInfo RECORD  
Snapshots.MemInfo.Rmem INTEGER  
Snapshots.MemInfo.Wmem INTEGER  
Snapshots.MemInfo.Fmem INTEGER  
Snapshots.MemInfo.Tmem INTEGER  
Snapshots.SocketMem RECORD  
Snapshots.SocketMem.RmemAlloc INTEGER  
Snapshots.SocketMem.Rcvbuf INTEGER  
Snapshots.SocketMem.WmemAlloc INTEGER  
Snapshots.SocketMem.Sndbuf INTEGER  
Snapshots.SocketMem.FwdAlloc INTEGER  
Snapshots.SocketMem.WmemQueued INTEGER  
Snapshots.SocketMem.Optmem INTEGER  
Snapshots.SocketMem.Backlog INTEGER  
Snapshots.SocketMem.Drops INTEGER  
Snapshots.VegasInfo RECORD Instrumntation in Vegas TCP
Not used by M-Lab
Snapshots.VegasInfo.Enabled INTEGER  
Snapshots.VegasInfo.RTTCount INTEGER  
Snapshots.VegasInfo.RTT INTEGER  
Snapshots.VegasInfo.MinRTT INTEGER  
Snapshots.DCTCPInfo RECORD Instrumentation in DCTCP
Not used by M-Lab
Snapshots.DCTCPInfo.Enabled INTEGER  
Snapshots.DCTCPInfo.CEState INTEGER  
Snapshots.DCTCPInfo.Alpha INTEGER  
Snapshots.DCTCPInfo.ABEcn INTEGER  
Snapshots.DCTCPInfo.ABTot INTEGER  
Snapshots.BBRInfo RECORD Instrumentation in the BBR TCP module in the kernel.
Snapshots.BBRInfo.BW INTEGER The maximum end-to-end bandwidth from the server to the client as measured by BBR.
Snapshots.BBRInfo.MinRTT INTEGER The minimum round trip time as measured by BBR.
Snapshots.BBRInfo.PacingGain INTEGER Fixed point multiplier used to set the pacing rate from the maximum bandwidth.
The binary point varies by kernel version but the statistical mode is always 1.0.
Snapshots.BBRInfo.CwndGain INTEGER Fixed point multiplier used to set the maximum window size from BW*MinRTT.
ServerX RECORD  
ServerX.Site STRING  
ServerX.Machine STRING  
ServerX.Geo RECORD  
ServerX.Geo.ContinentCode STRING  
ServerX.Geo.CountryCode STRING  
ServerX.Geo.CountryCode3 STRING  
ServerX.Geo.CountryName STRING  
ServerX.Geo.Region STRING  
ServerX.Geo.Subdivision1ISOCode STRING  
ServerX.Geo.Subdivision1Name STRING  
ServerX.Geo.Subdivision2ISOCode STRING  
ServerX.Geo.Subdivision2Name STRING  
ServerX.Geo.MetroCode INTEGER  
ServerX.Geo.City STRING  
ServerX.Geo.AreaCode INTEGER  
ServerX.Geo.PostalCode STRING  
ServerX.Geo.Latitude FLOAT  
ServerX.Geo.Longitude FLOAT  
ServerX.Geo.AccuracyRadiusKm INTEGER  
ServerX.Geo.Missing BOOLEAN The annotator looked for but was unable to find a Geo location for this IP.
ServerX.Network RECORD Network information about connection.
ServerX.Network.CIDR STRING  
ServerX.Network.ASNumber INTEGER The Autonomous System Number, provided by RouteViews.
ServerX.Network.ASName STRING Canonical name for the ASN, provided by ipinfo.io.
ServerX.Network.Missing BOOLEAN The annotator looked but was unable to find a network for this IP.
ServerX.Network.Systems RECORD  
ServerX.Network.Systems.ASNs INTEGER  
ClientX RECORD  
ClientX.Geo RECORD  
ClientX.Geo.ContinentCode STRING  
ClientX.Geo.CountryCode STRING  
ClientX.Geo.CountryCode3 STRING  
ClientX.Geo.CountryName STRING  
ClientX.Geo.Region STRING  
ClientX.Geo.Subdivision1ISOCode STRING  
ClientX.Geo.Subdivision1Name STRING  
ClientX.Geo.Subdivision2ISOCode STRING  
ClientX.Geo.Subdivision2Name STRING  
ClientX.Geo.MetroCode INTEGER  
ClientX.Geo.City STRING  
ClientX.Geo.AreaCode INTEGER  
ClientX.Geo.PostalCode STRING  
ClientX.Geo.Latitude FLOAT  
ClientX.Geo.Longitude FLOAT  
ClientX.Geo.AccuracyRadiusKm INTEGER  
ClientX.Geo.Missing BOOLEAN The annotator looked for but was unable to find a Geo location for this IP.
ClientX.Network RECORD Network information about connection.
ClientX.Network.CIDR STRING  
ClientX.Network.ASNumber INTEGER The Autonomous System Number, provided by RouteViews.
ClientX.Network.ASName STRING Canonical name for the ASN, provided by ipinfo.io.
ClientX.Network.Missing BOOLEAN The annotator looked but was unable to find a network for this IP.
ClientX.Network.Systems RECORD  
ClientX.Network.Systems.ASNs INTEGER  
Back to Top