]> University of Aberdeen

Fraser Noble Building Aberdeen, AB24 3UE UK ietf@raghavkejriwal.com

University of Aberdeen

Fraser Noble Building Aberdeen, AB24 3UE UK gorry@erg.abdn.ac.uk https://www.erg.abdn.ac.uk

Web and Internet Transport Standard Communication with Network Elements This document defines qlog events for the Standard Communication with Network Elements (SCONE) protocol. The events record the sending and reception of SCONE packets and changes to throughput advice. About This Document The latest revision of this draft can be found at . Status information for this document may be found at . Discussion of this document takes place on the Standard Communication with Network Elements Working Group mailing list (), which is archived at . Subscribe at . Source for this draft and an issue tracker can be found at .

Introduction describes a protocol where on-path network elements can communicate their perspective on the maximum sustainable throughput for QUIC flows to endpoints. This throughput advice suggests an upper bound on long-term average throughput, independent of and complementary to real-time congestion control signals. This document defines the qlog namespace and events that record the sending and reception of SCONE packets and changes to throughput advice, allowing for debugging of implementations and reconstruction of the packets received. The event namespace with the identifier scone is defined in . summarises the qlog events described in this document. Overview of SCONE qlog events.

Event Name	Importance	Definition
scone:packet_sent	Core
scone:packet_received	Core
scone:advice_updated	Base
scone:advice_expired	Base

Conventions and Definitions The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 when, and only when, they appear in all capitals, as shown here. The event and data structure definitions in this document are expressed in the Concise Data Definition Language and its extensions described in . This document follows the language used in :

• "Throughput advice" refers to the information communicated to endpoints by network elements in the form of a 7-bit rate signal
• A "monitoring period" is the time over which rate signals apply (67 seconds ).

SCONE Rate Signal Data Type A Rate Signal n in the range 0 to 126 maps to a ceiling bitrate of 100,000 * 10^(n/20) bits per second . The value 127 carries no throughput advice.

CDDL Description of SCONE Rate Signal types.

SCONE Event Schema Definition This document describes how the SCONE protocol can be expressed in qlog using the event schema. Per the requirements in , this document registers the scone namespace. The event schema URI is urn:ietf:params:qlog:events:scone.

Draft Event Schema Identification RFC-Editor NOTE:: Please remove this section when this is published as an RFC. Only implementations of the final, published RFC can use the events belonging to the event schema with the URI urn:ietf:params:qlog:events:scone. Until such an RFC exists, implementations MUST NOT identify themselves using this URI. Implementations of draft versions of the event schema MUST append the string "-" and the corresponding draft number to the URI. For example, draft 00 of this document is identified using the URI urn:ietf:params:qlog:events:scone-00. The namespace identifier itself is not affected by this requirement.

SCONE Events SCONE events extend the $ProtocolEventData extension point defined in . Additionally, they allow for direct extensibility by their use of per-event extension points via the $$ CDDL "group socket" syntax, as also described in .

SCONEEventData definition and ProtocolEventData extension

scone:packet_sent Importance: Core The packet_sent event is emitted when an endpoint includes a SCONE packet in a datagram it sends. The event records the rate signal in the sent SCONE packet.

CDDL Description of the SCONEPacketSent Data.

scone:packet_received Importance: Core The packet_received event is emitted when an endpoint receives a datagram that begins with a SCONE packet, after the packet (and any subsequent coalesced packets) have been parsed to check validity . The event records the rate signal carried in the received SCONE packet and the outcome of processing it, regardless of whether the packet is accepted or discarded.

CDDL Description of the SCONEPacketReceived Data.

The reason field MAY be omitted if the value of outcome is "discarded", and MUST NOT be present if the value of outcome is "accepted".

scone:advice_updated Importance: Base The advice_updated event is emitted by a SCONE-receiving endpoint when the effective throughput advice changes as a result of processing a received SCONE packet or applying the monitoring-period rules defined in .

CDDL Description of the SCONEAdviceUpdated Data.

This event may be emitted in the following common cases (non-exhaustive):

• When throughput advice first becomes effective, for example, after processing a SCONE packet carrying a known rate signal.
• Processing a SCONE packet that lowers the effective throughput advice.
• Advice from a previous monitoring period expires and advice from the current monitoring period becomes effective.

This event SHOULD NOT be emitted when advice from a previous monitoring period expires, but the advice in the current monitoring period does not change the effective advice.

scone:advice_expired Importance: Base The advice_expired event is emitted by a SCONE-receiving endpoint when previously effective SCONE advice expires because no applicable throughput advice was received during the monitoring period, as defined in .

CDDL Description of the SCONEAdviceExpired Data.

Security Considerations The security and privacy considerations discussed in apply to this document.

IANA Considerations This document registers a new entry in the "qlog event schema URIs" registry (created in ).

Event schema URI:

urn:ietf:params:qlog:events:scone

Namespace

scone

Event Types

packet_sent, packet_received, advice_updated, advice_expired

Description:

Event definitions related to the SCONE protocol.

Reference:

This Document

Normative References Mozilla Private Octopus Inc. Fastly Meta Ericsson This document describes a protocol where on-path network elements can communicate their perspective on the maximum sustainable throughput for QUIC flows to endpoints. This throughput advice suggests an upper bound on long-term average throughput, independent of and complementary to real-time congestion control signals. Akamai Meta Cloudflare qlog provides extensible structured logging for network protocols, allowing for easy sharing of data that benefits common debug and analysis methods and tooling. This document describes key concepts of qlog: formats, files, traces, events, and extension points. This definition includes the high-level log file schemas, and generic event schemas. Requirements and guidelines for creating protocol- specific event schemas are also presented. All schemas are defined independent of serialization format, allowing logs to be represented in various ways such as JSON, CSV, or protobuf. Note to Readers Note to RFC editor: Please remove this section before publication. Feedback and discussion are welcome at https://github.com/quicwg/qlog (https://github.com/quicwg/qlog). Readers are advised to refer to the "editor's draft" at that URL for an up-to-date version of this document. This document proposes a notational convention to express Concise Binary Object Representation (CBOR) data structures (RFC 7049). Its main goal is to provide an easy and unambiguous way to express structures for protocol messages and data formats that use CBOR or JSON. In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.

Acknowledgments The authors thank the European Space Agency (ESA) for supporting the QUICOPTSAT project, under which an evaluation of SCONE over satellite networks was undertaken.