package quic_trace

Get desktop application:
View/edit binary Protocol Buffers messages

The intervals are closed, i.e. the interval represented here is [first_packet, last_packet].

Used in: AckInfo

• optional uint64 first_packet = 1

• optional uint64 last_packet = 2

Metadata for ACK frames.

Used in: Frame

• repeated AckBlock acked_packets = 1

• optional uint64 ack_delay_us = 2

Metadata for CONNECTION_CLOSE/APPLICATION_CLOSE frames.

Used in: Frame

• optional uint32 error_code = 1

• optional string reason_phrase = 2

• optional CloseType close_type = 3

• optional uint64 transport_close_frame_type = 4

Metadata for CONNECTION_CLOSE frames. Close_type will indicate whether the close is a Google QUIC close, IETF QUIC Transport CONNECTION CLOSE, or IETF QUIC Application Connection Close, frame.

Used in: CloseInfo

• GOOGLE_QUIC_CONNECTION_CLOSE = 0

• IETF_QUIC_TRANSPORT_CONNECTION_CLOSE = 1

• IETF_QUIC_APPLICATION_CONNECTION_CLOSE = 2

Metadata for CRYPTO frames.

Used in: Frame

• optional uint64 length = 1

• optional uint64 offset = 2

Used in: Event

• ENCRYPTION_UNKNOWN = 0

• ENCRYPTION_INITIAL = 1

• ENCRYPTION_0RTT = 2

• ENCRYPTION_1RTT = 3

• ENCRYPTION_HANDSHAKE = 4

An event that has occurred over duration of the connection.

Used in: Trace

• optional uint64 time_us = 1

• optional EventType event_type = 2

• optional uint64 packet_number = 3

• repeated Frame frames = 4

• optional uint64 packet_size = 5

• optional EncryptionLevel encryption_level = 6

• optional TransportState transport_state = 7

  State of the transport stack after the event has happened.

• optional ExternalNetworkParameters external_network_parameters = 8

  For event_type = EXTERNAL_PARAMETERS, record parameters specified.

• optional TransmissionReason transmission_reason = 9

  For sent packets, indicate if there is a special reason for why the packet in question was transmitted.

• optional MoqtObject moqt_object = 10

  For MOQT object events, describes the associated object.

• optional uint64 bandwidth_estimate_bps = 11

  For MOQT-related events, indicates the payload bitrate that the MOQT stack suggests to the application at the moment event happens.

Used in: Event

• UNKNOWN_EVENT = 0

• PACKET_SENT = 1

• PACKET_RECEIVED = 2

• PACKET_LOST = 3

• APPLICATION_LIMITED = 4

  An APPLICATION_LIMITED event occurs when the sender is capable of sending more data and tries to send it, but discovers that it does not have any outstanding data to send. Such events are important to some congestion control algorithms (for example, BBR) since they are trying to measure the largest achievable throughput, but it is impossible to measure it when the application does not send anything.

• EXTERNAL_PARAMETERS = 5

  Record when external information about expected network conditions (available bandwidth, RTT, congestion window, etc) is supplied to the sender.

• MOQT_OBJECT_ENQUEUED = 6

  Indicates that an application has generated an MOQT object, and it has been enqueued for sending.

• MOQT_OBJECT_ACKNOWLEDGED = 7

  Indicates that an MOQT object has been explicitly acknowledged as received via an OBJECT_ACK message.

• MOQT_TARGET_BITRATE_SET = 8

  Indicates that the MOQT stack has notified the application of the new payload bitrate it should target.

• MOQT_PROBE_START = 9

  Indicates that the MOQT stack has started a bandwidth probe.

• MOQT_PROBE_SUCCESS = 10

  Indicates that the MOQT stack has completed a bandwidth probe successfully.

• MOQT_PROBE_FAILURE = 11

  Indicates that the MOQT stack has completed a bandwidth probe unsuccessfully.

Documents external network parameters supplied to the sender. Typically not all of those would be supplied (e.g. if bandwidth and RTT are supplied, you can infer the suggested CWND), but there are no restrictions on which fields may or may not be set.

Used in: Event

• optional uint64 bandwidth_bps = 1

  in bits per second

• optional uint64 rtt_us = 2

• optional uint64 cwnd_bytes = 3

Metadata for MAX_DATA/MAX_STREAM_DATA frames.

Used in: Frame

• optional uint64 max_data = 1

• optional uint64 stream_id = 2

A message representing a frame, either sent or received.

Used in: Event

• optional FrameType frame_type = 1

• optional StreamFrameInfo stream_frame_info = 2

• optional AckInfo ack_info = 3

• optional ResetStreamInfo reset_stream_info = 4

• optional CloseInfo close_info = 5

• optional FlowControlInfo flow_control_info = 6

• optional CryptoFrameInfo crypto_frame_info = 7

Used in: Frame

• UNKNOWN_FRAME = 0

• STREAM = 1

• ACK = 2

• RESET_STREAM = 3

• CONNECTION_CLOSE = 4

• MAX_DATA = 5

• MAX_STREAM_DATA = 6

• PING = 7

• BLOCKED = 8

• STREAM_BLOCKED = 9

• PADDING = 10

• CRYPTO = 11

Represents information specific to a MoQT fetch data stream.

Used in: StreamAnnotation

(message has no fields)

A description of an MOQT object associated with a specific event.

Used in: Event

• optional uint64 track_alias = 1

• optional uint64 group_id = 2

• optional uint64 subgroup_id = 3

• optional uint64 object_id = 4

• optional uint64 publisher_priority = 5

• optional uint64 payload_size = 6

Represents information specific to a MoQT probe data stream.

Used in: StreamAnnotation

• optional uint64 probe_id = 1

Represents information specific to a MoQT subgroup data stream.

Used in: StreamAnnotation

• optional uint64 track_alias = 1

• optional uint64 group_id = 2

• optional uint64 subgroup_id = 3

Metadata for RST_STREAM frames.

Used in: Frame

• optional uint64 stream_id = 1

• optional uint32 application_error_code = 2

• optional uint64 final_offset = 3

For a specific QUIC stream, allows to record application-specific metadata.

Used in: Trace

• optional uint64 stream_id = 1

  ID of the stream in question.

• optional bool moqt_control_stream = 2

  If true, the stream in question is an MoQT control stream.

• optional MoqtSubgroupStream moqt_subgroup_stream = 3

  If the stream in question is an MoQT subgroup stream, provides information about the subgroup.

• optional MoqtFetchStream moqt_fetch_stream = 5

  If the stream in question is an MoQT fetch stream, provides information about the fetch.

• optional MoqtProbeStream moqt_probe_stream = 4

  If the stream in question is an MoQT probe stream, provides information about the probe.

Metadata for STREAM frames.

Used in: Frame

• optional uint64 stream_id = 1

• optional bool fin = 2

• optional uint64 length = 3

• optional uint64 offset = 4

• optional bytes protocol_version = 1

  QUIC version tag, as represented on wire. Should be always 4 bytes long.

• optional bytes source_connection_id = 2

  Source and destination connection ID. If multiple connection IDs are used, record the first one used with short-form header.

• optional bytes destination_connection_id = 3

• repeated Event events = 4

• repeated StreamAnnotation stream_annotations = 5

Used in: Event

• NORMAL_TRANSMISSION = 0

  Indicates that there was not any particular special reason the packet was sent.

• TAIL_LOSS_PROBE = 1

  Indicates that the packet sent is a tail loss probe, cf. https://tools.ietf.org/html/draft-ietf-quic-recovery-14#section-4.3.2

• RTO_TRANSMISSION = 2

  Indicates that the packet is sent due to retransmission timeout, cf https://tools.ietf.org/html/draft-ietf-quic-recovery-14#section-4.3.3

• PROBING_TRANSMISSION = 3

  Indicates that the packet is sent in order to probe whether there is extra bandwidth available in cases where the sender needs an estimate of available bandwidth, but the application does not provide enough data for such estimate to become naturally available. This is usually only used in real-time protocols.

Metadata that represents transport stack's understanding of the current state of the transport channel.

Used in: Event

• optional uint64 min_rtt_us = 1

• optional uint64 smoothed_rtt_us = 2

  Smoothed RTT, usually computed using EWMA.

• optional uint64 last_rtt_us = 3

  The latest RTT measureent available.

• optional uint64 in_flight_bytes = 4

• optional uint64 cwnd_bytes = 5

• optional uint64 pacing_rate_bps = 6

  Pacing rate, in bits per second.

• optional string congestion_control_state = 7

  Any arbitrary information about congestion control state that is not representable via parameters above.

• optional uint64 bandwidth_estimate_bps = 8

  The estimate of the available bandwidth returned by the congestion controller.