rfc8912xml2.original.xml | rfc8912.xml | |||
---|---|---|---|---|
<?xml version="1.0" encoding="US-ASCII"?> | <?xml version='1.0' encoding='utf-8'?> | |||
<!DOCTYPE rfc SYSTEM "rfc2629.dtd"> | <!DOCTYPE rfc [ | |||
<?rfc toc="yes"?> | <!ENTITY nbsp " "> | |||
<?rfc tocompact="yes"?> | <!ENTITY zwsp "​"> | |||
<?rfc tocdepth="3"?> | <!ENTITY nbhy "‑"> | |||
<?rfc tocindent="yes"?> | <!ENTITY wj "⁠"> | |||
<?rfc symrefs="yes"?> | ]> | |||
<?rfc sortrefs="yes"?> | ||||
<?rfc comments="yes"?> | <rfc xmlns:xi="http://www.w3.org/2001/XInclude" category="std" | |||
<?rfc inline="yes"?> | docName="draft-ietf-ippm-initial-registry-16" number="8912" | |||
<?rfc compact="yes"?> | ipr="trust200902" obsoletes="" updates="" submissionType="IETF" | |||
<?rfc subcompact="no"?> | consensus="true" xml:lang="en" tocInclude="true" tocDepth="3" | |||
<rfc category="std" docName="draft-ietf-ippm-initial-registry-16" | symRefs="true" sortRefs="true" version="3"> | |||
ipr="trust200902"> | <!-- xml2rfc v2v3 conversion 2.43.0 --> | |||
<front> | <front> | |||
<title abbrev="Initial Registry">Initial Performance Metrics Registry | <title abbrev="Initial Performance Metrics Registry">Initial Performance Met rics Registry | |||
Entries</title> | Entries</title> | |||
<seriesInfo name="RFC" value="8912"/> | ||||
<author fullname="Al Morton" initials="A." surname="Morton"> | <author fullname="Al Morton" initials="A." surname="Morton"> | |||
<organization>AT&T Labs</organization> | <organization>AT&T Labs</organization> | |||
<address> | <address> | |||
<postal> | <postal> | |||
<street>200 Laurel Avenue South</street> | <street>200 Laurel Avenue South</street> | |||
<city>Middletown</city> | ||||
<city>Middletown,</city> | ||||
<region>NJ</region> | <region>NJ</region> | |||
<code>07748</code> | <code>07748</code> | |||
<country>United States of America</country> | ||||
<country>USA</country> | ||||
</postal> | </postal> | |||
<phone>+1 732 420 1571</phone> | <phone>+1 732 420 1571</phone> | |||
<facsimile>+1 732 368 1192</facsimile> | ||||
<email>acmorton@att.com</email> | <email>acmorton@att.com</email> | |||
<uri/> | ||||
</address> | </address> | |||
</author> | </author> | |||
<author fullname="Marcelo Bagnulo" initials="M." surname="Bagnulo"> | <author fullname="Marcelo Bagnulo" initials="M." surname="Bagnulo"> | |||
<organization abbrev="UC3M">Universidad Carlos III de | <organization abbrev="UC3M">Universidad Carlos III de | |||
Madrid</organization> | Madrid</organization> | |||
<address> | <address> | |||
<postal> | <postal> | |||
<street>Av. Universidad 30</street> | <street>Av. Universidad 30</street> | |||
<city>Leganes</city> | <city>Leganes</city> | |||
<region>Madrid</region> | <region>Madrid</region> | |||
<code>28911</code> | <code>28911</code> | |||
<country>Spain</country> | ||||
<country>SPAIN</country> | ||||
</postal> | </postal> | |||
<phone>34 91 6249500</phone> | <phone>34 91 6249500</phone> | |||
<email>marcelo@it.uc3m.es</email> | <email>marcelo@it.uc3m.es</email> | |||
<uri>http://www.it.uc3m.es</uri> | <uri>http://www.it.uc3m.es</uri> | |||
</address> | </address> | |||
</author> | </author> | |||
<author fullname="Philip Eardley" initials="P." surname="Eardley"> | <author fullname="Philip Eardley" initials="P." surname="Eardley"> | |||
<organization abbrev="BT">BT</organization> | <organization abbrev="BT">BT</organization> | |||
<address> | <address> | |||
<postal> | <postal> | |||
<street>Adastral Park, Martlesham Heath</street> | <street>Adastral Park, Martlesham Heath</street> | |||
<city>Ipswich</city> | <city>Ipswich</city> | |||
<country>United Kingdom</country> | ||||
<country>ENGLAND</country> | ||||
</postal> | </postal> | |||
<email>philip.eardley@bt.com</email> | <email>philip.eardley@bt.com</email> | |||
</address> | </address> | |||
</author> | </author> | |||
<author fullname="Kevin D'Souza" initials="K." surname="D'Souza"> | <author fullname="Kevin D'Souza" initials="K." surname="D'Souza"> | |||
<organization>AT&T Labs</organization> | <organization>AT&T Labs</organization> | |||
<address> | <address> | |||
<postal> | <postal> | |||
<street>200 Laurel Avenue South</street> | <street>200 Laurel Avenue South</street> | |||
<city>Middletown</city> | ||||
<city>Middletown,</city> | ||||
<region>NJ</region> | <region>NJ</region> | |||
<code>07748</code> | <code>07748</code> | |||
<country>United States of America</country> | ||||
<country>USA</country> | ||||
</postal> | </postal> | |||
<phone>+1 732 420 2514</phone> | ||||
<phone>+1 732 420 xxxx</phone> | ||||
<facsimile/> | ||||
<email>kld@att.com</email> | <email>kld@att.com</email> | |||
<uri/> | ||||
</address> | </address> | |||
</author> | </author> | |||
<date day="9" month="March" year="2020"/> | <date month="November" year="2021"/> | |||
<keyword>Loss</keyword> | ||||
<keyword>Delay</keyword> | ||||
<keyword>Delay Variation</keyword> | ||||
<keyword>ICMP ping</keyword> | ||||
<keyword>DNS Response</keyword> | ||||
<keyword>Poisson</keyword> | ||||
<keyword>Periodic</keyword> | ||||
<keyword>TCP</keyword> | ||||
<abstract> | <abstract> | |||
<t>This memo defines the set of Initial Entries for the IANA Performance | <t>This memo defines the set of initial entries for the IANA Registry of P | |||
Metrics Registry. The set includes: UDP Round-trip Latency and Loss, | erformance | |||
Metrics. The set includes UDP Round-Trip Latency and Loss, | ||||
Packet Delay Variation, DNS Response Latency and Loss, UDP Poisson | Packet Delay Variation, DNS Response Latency and Loss, UDP Poisson | |||
One-way Delay and Loss, UDP Periodic One-way Delay and Loss, ICMP | One-Way Delay and Loss, UDP Periodic One-Way Delay and Loss, ICMP | |||
Round-trip Latency and Loss, and TCP round-trip Latency and Loss.</t> | Round-Trip Latency and Loss, and TCP Round-Trip Delay and Loss.</t> | |||
</abstract> | </abstract> | |||
<note title="Requirements Language"> | ||||
<t>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<xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, | ||||
they appear in all capitals, as shown here.</t> | ||||
<t/> | ||||
</note> | ||||
</front> | </front> | |||
<middle> | <middle> | |||
<section title="Introduction"> | <section numbered="true" toc="default"> | |||
<t>This memo proposes an initial set of entries for the Performance | <name>Introduction</name> | |||
Metrics Registry. It uses terms and definitions from the IPPM | <t>This memo defines an initial set of entries for the Performance | |||
literature, primarily <xref target="RFC2330"/>.</t> | Metrics Registry. | |||
It uses terms and definitions from the IP Performance Metrics (IPPM) | ||||
literature, primarily <xref target="RFC2330" format="default"/>.</t> | ||||
<t>Although there are several standard templates for organizing | <t>Although there are several standard templates for organizing | |||
specifications of performance metrics (see <xref target="RFC7679"/> for | specifications of Performance Metrics (see <xref target="RFC7679" format=" | |||
an example of the traditional IPPM template, based to large extent on | default"/> for | |||
an example of the traditional IPPM template, based to a large extent on | ||||
the Benchmarking Methodology Working Group's traditional template in | the Benchmarking Methodology Working Group's traditional template in | |||
<xref target="RFC1242"/>, and see <xref target="RFC6390"/> for a similar | <xref target="RFC1242" format="default"/>, and see <xref target="RFC6390" format="default"/> for a similar | |||
template), none of these templates were intended to become the basis for | template), none of these templates were intended to become the basis for | |||
the columns of an IETF-wide registry of metrics. While examining aspects | the columns of an IETF-wide Registry of metrics. While examining aspects | |||
of metric specifications which need to be registered, it became clear | of metric specifications that need to be registered, it became clear | |||
that none of the existing metric templates fully satisfies the | that none of the existing metric templates fully satisfy the | |||
particular needs of a registry.</t> | particular needs of a Registry.</t> | |||
<t>Therefore, <xref target="RFC8911" format="default"/> defines the | ||||
overall format for a Performance Metrics Registry. <xref target="RFC8911" | ||||
sectionFormat="of" section="5"/> also gives guidelines for those | ||||
requesting registration of a Metric -- that is, the creation of one or mor | ||||
e entries in | ||||
the Performance Metrics Registry:</t> | ||||
<t>Therefore, <xref target="I-D.ietf-ippm-metric-registry"/> defines the | <blockquote>In essence, there needs to be | |||
overall format for a Performance Metrics Registry. Section 5 of <xref | evidence that (1) a candidate Registered Performance Metric has significan | |||
target="I-D.ietf-ippm-metric-registry"/> also gives guidelines for those | t | |||
requesting registration of a Metric, that is the creation of entry(s) in | industry interest or has seen deployment and (2) there is agreement that | |||
the Performance Metrics Registry: "In essence, there needs to be | ||||
evidence that a candidate Registered Performance Metric has significant | ||||
industry interest, or has seen deployment, and there is agreement that | ||||
the candidate Registered Performance Metric serves its intended | the candidate Registered Performance Metric serves its intended | |||
purpose." The process in <xref target="I-D.ietf-ippm-metric-registry"/> | purpose.</blockquote> | |||
also requires that new entries are administered by IANA through | ||||
Specification Required policy, which will ensure that the metrics are | ||||
tightly defined.</t> | ||||
</section> | ||||
<section title="Scope"> | <t>The process defined in <xref target="RFC8911" format="default"/> | |||
also requires that new entries be administered by IANA through the | ||||
Specification Required policy <xref target="RFC8126"/>, which will | ||||
ensure that the metrics are tightly defined.</t> | ||||
<section numbered="true" toc="default"> | ||||
<name>Requirements Language</name> | ||||
<t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", | ||||
"<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", | ||||
"<bcp14>SHALL NOT</bcp14>", "<bcp14>SHOULD</bcp14>", | ||||
"<bcp14>SHOULD NOT</bcp14>", | ||||
"<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", | ||||
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document | ||||
are to be interpreted as described in BCP 14 | ||||
<xref target="RFC2119"/> <xref target="RFC8174"/> when, and only | ||||
when, they appear in all capitals, as shown here.</t> | ||||
</section> | ||||
</section> | ||||
<section numbered="true" toc="default"> | ||||
<name>Scope</name> | ||||
<t>This document defines a set of initial Performance Metrics Registry | <t>This document defines a set of initial Performance Metrics Registry | |||
entries. Most are Active Performance Metrics, which are based on RFCs | Entries. Most are Active Performance Metrics, which are based on RFCs | |||
prepared in the IPPM working group of the IETF, according to their | prepared in the IPPM Working Group of the IETF, according to their | |||
framework <xref target="RFC2330"/> and its updates.</t> | framework <xref target="RFC2330" format="default"/> and its updates.</t> | |||
</section> | </section> | |||
<!-- Section 3--> | ||||
<section title="Registry Categories and Columns"> | <section numbered="true" toc="default"> | |||
<t>This memo uses the terminology defined in <xref | <name>Registry Categories and Columns</name> | |||
target="I-D.ietf-ippm-metric-registry"/>.</t> | <t>This memo uses the terminology defined in <xref target="RFC8911" format | |||
="default"/>.</t> | ||||
<t>This section provides the categories and columns of the registry, for | <t>This section provides the categories and columns of the Registry, for | |||
easy reference. An entry (row) therefore gives a complete description of | easy reference. An entry (row) therefore gives a complete description of | |||
a Registered Metric.</t> | a Registered Metric.</t> | |||
<t><figure> | <t>Registry Categories and Columns are shown below in this format:</t> | |||
<artwork><![CDATA[Legend: | <artwork name="" type="" align="left" alt=""><![CDATA[ | |||
Registry Categories and Columns, shown as | Category | |||
Category | ------------------... | |||
------------------ | Column | Column |... | |||
Column | Column | | ]]></artwork> | |||
<artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
Summary | Summary | |||
Identifier | Name | URI | Desc. | Reference | Change Controller | Ver | | --------------------------------------------------------------- | |||
Identifier | Name | URI | Desc. | Reference | Change | Ver | | ||||
| | | | | Controller | | ||||
Metric Definition | Metric Definition | |||
----------------------------------------- | ----------------------------------------- | |||
Reference Definition | Fixed Parameters | | Reference Definition | Fixed Parameters | | |||
Method of Measurement | Method of Measurement | |||
--------------------------------------------------------------------- | --------------------------------------------------------------------- | |||
Reference | Packet | Traffic | Sampling | Run-time | Role | | Reference | Packet | Traffic | Sampling | Runtime | Role | | |||
Method | Stream | Filter | Distribution | Parameters | | | Method | Stream | Filter | Distribution | Parameters | | | |||
| Generation | | | Generation | | |||
Output | Output | |||
----------------------------------------- | ----------------------------------------- | |||
Type | Reference | Units | Calibration | | Type | Reference | Units | Calibration | | |||
| Definition | | | | | Definition | | | | |||
Administrative Information | Administrative Information | |||
Status |Requester | Rev | Rev.Date | | ------------------------------------- | |||
Status |Requester | Rev | Rev. Date | | ||||
Comments and Remarks | Comments and Remarks | |||
-------------------- | -------------------- | |||
]]></artwork> | ]]></artwork> | |||
</figure></t> | ||||
</section> | </section> | |||
<!-- Section 4 --> | ||||
<section title="UDP Round-trip Latency and Loss Registry Entries"> | <section anchor="udp-rt-latency-loss-reg-entries" numbered="true" toc="defau | |||
<t>This section specifies an initial registry entry for the UDP | lt"> | |||
Round-trip Latency, and another entry for UDP Round-trip Loss Ratio.</t> | <name>UDP Round-Trip Latency and Loss Registry Entries</name> | |||
<t>This section specifies an initial Registry Entry for UDP | ||||
<t>Note: Each Registry entry only produces a "raw" output or a | Round-Trip Latency and another entry for the UDP Round-Trip Loss Ratio.</t | |||
> | ||||
<t indent="3">Note: Each Registry Entry only produces a "raw" output or a | ||||
statistical summary. To describe both "raw" and one or more statistics | statistical summary. To describe both "raw" and one or more statistics | |||
efficiently, the Identifier, Name, and Output Categories can be split | efficiently, the Identifier, Name, and Output categories can be split, | |||
and a single section can specify two or more closely-related metrics. | and a single section can specify two or more closely related metrics. | |||
For example, this section specifies two Registry entries with many | For example, this section specifies two Registry Entries with many | |||
common columns. See Section 7 for an example specifying multiple | common columns. See <xref target="udp-poisson-owd-owl-reg"/> for an exampl | |||
Registry entries with many common columns.</t> | e specifying multiple | |||
Registry Entries with many common columns.</t> | ||||
<t>All column entries beside the ID, Name, Description, and Output | <t>All column entries besides the ID, Name, Description, and Output | |||
Reference Method categories are the same, thus this section proposes two | Reference Method categories are the same; thus, this section defines two | |||
closely-related registry entries. As a result, IANA is also asked to | closely related Registry Entries. As a result, IANA has also | |||
assign a corresponding URL to each Named Metric.</t> | assigned a corresponding URL to each of the two Named Metrics.</t> | |||
<!-- 4.1 --> | ||||
<section title="Summary"> | <section numbered="true" toc="default"> | |||
<t>This category includes multiple indexes to the registry entry: the | <name>Summary</name> | |||
element ID and metric name.</t> | <t>This category includes multiple indexes to the Registry Entries: the | |||
element ID and Metric Name.</t> | ||||
<section title="ID (Identifier)"> | <!-- 4.1.1 --> | |||
<t>IANA is asked to assign different numeric identifiers to each of | <section numbered="true" toc="default"> | |||
the two Named Metrics.</t> | <name>ID (Identifier)</name> | |||
<t>IANA has allocated the numeric Identifiers 1 and 2 for the two | ||||
Named Metric Entries in <xref | ||||
target="udp-rt-latency-loss-reg-entries"/>. See <xref target="name412"/> for | ||||
mapping to Names. | ||||
</t> | ||||
</section> | </section> | |||
<!-- 4.1.2 --> | ||||
<section title="Name"> | <section anchor="name412" numbered="true" toc="default"> | |||
<t>RTDelay_Active_IP-UDP-Periodic_RFCXXXXsec4_Seconds_95Percentile</t> | <name>Name</name> | |||
<dl> | ||||
<t>RTLoss_Active_IP-UDP-Periodic_RFCXXXXsec4_Percent_LossRatio</t> | <dt>1:</dt><dd>RTDelay_Active_IP-UDP-Periodic_RFC8912sec4_Seconds_95Pe | |||
rcentile</dd> | ||||
<dt>2:</dt><dd>RTLoss_Active_IP-UDP-Periodic_RFC8912sec4_Percent_LossR | ||||
atio</dd> | ||||
</dl> | ||||
</section> | </section> | |||
<!-- 4.1.3 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>URI</name> | ||||
<section title="URI"> | <t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay | |||
<t>URL: https://www.iana.org/ ... <name></t> | _Active_IP-UDP-Periodic_RFC8912sec4_Seconds_95Percentile"/></t> | |||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTLoss_A | ||||
ctive_IP-UDP-Periodic_RFC8912sec4_Percent_LossRatio"/></t> | ||||
</section> | </section> | |||
<!-- 4.1.4 --> | ||||
<section title="Description"> | <section numbered="true" toc="default"> | |||
<t>RTDelay: This metric assesses the delay of a stream of packets | <name>Description</name> | |||
exchanged between two hosts (which are the two measurement points), | <dl newline="false" spacing="normal"> | |||
and the Output is the Round-trip delay for all successfully | <dt>RTDelay:</dt> | |||
<dd>This metric assesses the delay of a stream of packets | ||||
exchanged between two hosts (which are the two measurement points). | ||||
The output is the round-trip delay for all successfully | ||||
exchanged packets expressed as the 95th percentile of their | exchanged packets expressed as the 95th percentile of their | |||
conditional delay distribution.</t> | conditional delay distribution.</dd> | |||
<dt>RTLoss:</dt> | ||||
<t>RTLoss: This metric assesses the loss ratio of a stream of | <dd>This metric assesses the loss ratio of a stream of | |||
packets exchanged between two hosts (which are the two measurement | packets exchanged between two hosts (which are the two measurement | |||
points), and the Output is the Round-trip loss ratio for all | points). The output is the round-trip loss ratio for all | |||
successfully exchanged packets expressed as a percentage.</t> | transmitted packets expressed as a percentage.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<section title="Change Controller"> | <!-- 4.1.5 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Change Controller</name> | ||||
<t>IETF</t> | <t>IETF</t> | |||
</section> | </section> | |||
<section title="Version (of Registry Format)"> | <!-- 4.1.6 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Version (of Registry Format)</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<!-- 4.2 --> | ||||
<section title="Metric Definition"> | <section numbered="true" toc="default"> | |||
<name>Metric Definition</name> | ||||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section title="Reference Definition"> | ||||
<t>Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay | ||||
Metric for IPPM", RFC 2681, September 1999.</t> | ||||
<t><xref target="RFC2681"/></t> | <!-- 4.2.1 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Reference Definition</name> | ||||
<t>For delay:</t> | ||||
<t indent="3">Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-tri | ||||
p Delay | ||||
Metric for IPPM", RFC 2681, DOI 10.17487/RFC2681, September 1999, | ||||
<https://www.rfc-editor.org/info/rfc2681>. | ||||
<xref target="RFC2681"/></t> | ||||
<t>Section 2.4 of <xref target="RFC2681"/> provides the reference | <t indent="3"><xref target="RFC2681" sectionFormat="of" section="2.4"/ | |||
definition of the singleton (single value) Round-trip delay metric. | > provides the reference | |||
Section 3.4 of <xref target="RFC2681"/> provides the reference | definition of the singleton (single value) round-trip delay metric. | |||
<xref target="RFC2681" sectionFormat="of" section="3.4"/> | ||||
provides the reference | ||||
definition expanded to cover a multi-singleton sample. Note that | definition expanded to cover a multi-singleton sample. Note that | |||
terms such as singleton and sample are defined in Section 11 of | terms such as "singleton" and "sample" are defined in <xref target="RF | |||
<xref target="RFC2330"/>.</t> | C2330" sectionFormat="of" section="11"/>.</t> | |||
<t indent="3">Note that although the definition of round-trip delay be | ||||
<t>Note that although the <xref target="RFC2681"/> definition of | tween the | |||
"Round-trip-Delay between Src and Dst" is directionally ambiguous in | Source (Src) and the Destination (Dst) as provided in | |||
the text, this metric tightens the definition further to recognize | <xref target="RFC2681" sectionFormat="of" section="2.4"/> | |||
that the host in the "Src" role will send the first packet to "Dst", | is directionally ambiguous in the text, this metric | |||
and ultimately receive the corresponding return packet from "Dst" | tightens the definition further to recognize that the host in the | |||
(when neither are lost).</t> | Src Role will send the first packet to the host in the Dst Role | |||
and will ultimately receive the corresponding return packet from the | ||||
<t>Finally, note that the variable "dT" is used in <xref | Dst (when neither is lost).</t> | |||
target="RFC2681"/> to refer to the value of Round-trip delay in | <t indent="3">Finally, note that the variable "dT" is used in <xref ta | |||
metric definitions and methods. The variable "dT" has been re-used | rget="RFC2681" format="default"/> to refer to the value of round-trip delay in | |||
in other IPPM literature to refer to different quantities, and | metric definitions and methods. The variable "dT" has been reused | |||
in other IPPM literature to refer to different quantities and | ||||
cannot be used as a global variable name.</t> | cannot be used as a global variable name.</t> | |||
<t>For loss:</t> | ||||
<t>Morton, A., "Round-trip Packet Loss Metrics", RFC 6673, August | <t indent="3">Morton, A., "Round-Trip Packet Loss Metrics", RFC 6673, | |||
2012.</t> | DOI 10.17487/RFC6673, August 2012, | |||
<https://www.rfc-editor.org/info/rfc6673>. | ||||
<t><xref target="RFC6673"/></t> | <xref target="RFC6673"/></t> | |||
<t>Both Delay and Loss metrics employ a maximum waiting time for | ||||
<t>Both delay and loss metrics employ a maximum waiting time for | ||||
received packets, so the count of lost packets to total packets sent | received packets, so the count of lost packets to total packets sent | |||
is the basis for the loss ratio calculation as per Section 6.1 of | is the basis for the loss ratio calculation as per <xref target="RFC66 | |||
<xref target="RFC6673"/>.</t> | 73" sectionFormat="of" section="6.1"/>.</t> | |||
</section> | </section> | |||
<!-- 4.2.2 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Fixed Parameters</name> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>Type-P as defined in <xref target="RFC2330" sectionFormat="of" sec | ||||
tion="13"/>:</dt><dd><t/> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv4 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>TTL:</dt><dd>Set to 255</dd> | ||||
<dt>Protocol:</dt><dd>Set to 17 (UDP)</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv6 header values:</dt> | ||||
<dd><t/><dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>Hop Count:</dt><dd>Set to 255</dd> | ||||
<dt>Next Header:</dt><dd>Set to 17 (UDP)</dd> | ||||
<dt>Flow Label:</dt><dd>Set to 0</dd> | ||||
<dt>Extension Headers:</dt><dd>None</dd> | ||||
</dl></dd> | ||||
</dl> | ||||
<section title="Fixed Parameters"> | <dl newline="true" spacing="normal"> | |||
<t>Type-P as defined in Section 13 of <xref target="RFC2330"/>: | <dt>UDP header values:</dt> | |||
<list style="symbols"> | <dd><t/><dl newline="false" spacing="compact"> | |||
<t>IPv4 header values: <list style="symbols"> | <dt>Checksum:</dt><dd>The checksum <bcp14>MUST</bcp14> be calculate | |||
<t>DSCP: set to 0</t> | d and the | |||
non-zero checksum included in the header</dd> | ||||
<t>TTL: set to 255</t> | </dl></dd> | |||
</dl> | ||||
<t>Protocol: set to 17 (UDP)</t> | ||||
</list></t> | ||||
<t>IPv6 header values:<list style="symbols"> | ||||
<t>DSCP: set to 0</t> | ||||
<t>Hop Count: set to 255</t> | ||||
<t>Next Header: set to 17 (UDP)</t> | ||||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>UDP header values: <list style="symbols"> | ||||
<t>Checksum: the checksum MUST be calculated and the | ||||
non-zero checksum included in the header</t> | ||||
</list></t> | ||||
<t>UDP Payload <list style="symbols"> | <dl newline="true" spacing="normal"> | |||
<t>total of 100 bytes</t> | <dt>UDP Payload:</dt> | |||
</list></t> | <dd><t/><dl newline="false" spacing="compact"> | |||
</list></t> | <dt>Total of 100 bytes</dt><dd/> | |||
</dl></dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>Other measurement parameters:<list style="symbols"> | <dl newline="true" spacing="normal"> | |||
<t>Tmax: a loss threshold waiting time<list style="symbols"> | <dt>Other measurement Parameters:</dt> | |||
<t>3.0, expressed in units of seconds, as a positive value | <dd><t/> | |||
of type decimal64 with fraction digits = 4 (see section 9.3 | <dl newline="false" spacing="normal"> | |||
of <xref target="RFC6020"/>) and with resolution of 0.0001 | <dt>Tmax:</dt><dd>A loss threshold waiting time with value 3.0, ex | |||
seconds (0.1 ms), with lossless conversion to/from the | pressed in units of seconds, as a positive value | |||
32-bit NTP timestamp as per section 6 of <xref | of type decimal64 with fraction digits = 4 (see <xref target="RFC | |||
target="RFC5905"/>.</t> | 6020" sectionFormat="of" section="9.3"/>) and with a resolution of 0.0001 | |||
</list></t> | seconds (0.1 ms), with lossless conversion to/from the | |||
</list></t> | 32-bit NTP timestamp as per <xref target="RFC5905" sectionFormat= | |||
"of" section="6"/>.</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<!-- 4.3 --> | ||||
<section title="Method of Measurement"> | <section numbered="true" toc="default"> | |||
<name>Method of Measurement</name> | ||||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<!-- 4.3.1 --> | ||||
<section title="Reference Method"> | <section numbered="true" toc="default"> | |||
<t>The methodology for this metric is defined as | <name>Reference Methods</name> | |||
Type-P-Round-trip-Delay-Poisson-Stream in section 2.6 of <xref | <t>The methodology for this metric (equivalent to Type-P-Round-trip- | |||
target="RFC2681">RFC 2681</xref> and section 3.6 of <xref | Delay and Type-P-Round-trip-Delay-Poisson-Stream) is defined as in | |||
target="RFC2681">RFC 2681</xref> using the Type-P and Tmax defined | <xref target="RFC2681" sectionFormat="of" section="2.6"/> (for | |||
under Fixed Parameters. However, the Periodic stream will be | singletons) and <xref target="RFC2681" sectionFormat="of" section="3. | |||
generated according to <xref target="RFC3432"/>.</t> | 6"/> | |||
(for samples) using the Type-P and Tmax defined in the | ||||
Fixed Parameters column. However, the Periodic stream will be | ||||
generated according to <xref target="RFC3432" format="default"/>.</t> | ||||
<t>The reference method distinguishes between long-delayed packets | <t>The reference method distinguishes between long-delayed packets | |||
and lost packets by implementing a maximum waiting time for packet | and lost packets by implementing a maximum waiting time for packet | |||
arrival. Tmax is the waiting time used as the threshold to declare a | arrival. Tmax is the waiting time used as the threshold to declare a | |||
packet lost. Lost packets SHALL be designated as having undefined | packet lost. Lost packets <bcp14>SHALL</bcp14> be designated as having | |||
delay, and counted for the RTLoss metric.</t> | undefined | |||
delay and counted for the RTLoss metric <xref target="RFC6673"/>.</t> | ||||
<t>The calculations on the delay (RTT) SHALL be performed on the | <t>The calculations on the delay (RTT) <bcp14>SHALL</bcp14> be perform | |||
ed on the | ||||
conditional distribution, conditioned on successful packet arrival | conditional distribution, conditioned on successful packet arrival | |||
within Tmax. Also, when all packet delays are stored, the process | within Tmax. Also, when all packet delays are stored, the process | |||
which calculates the RTT value MUST enforce the Tmax threshold on | that calculates the RTT value <bcp14>MUST</bcp14> enforce the Tmax thr | |||
stored values before calculations. See section 4.1 of <xref | eshold on | |||
target="RFC3393"/> for details on the conditional distribution to | stored values before calculations. See <xref target="RFC3393" sectionF | |||
exclude undefined values of delay, and Section 5 of <xref | ormat="of" section="4.1"/> for details on the conditional distribution to | |||
target="RFC6703"/> for background on this analysis choice.</t> | exclude undefined values of delay, and see <xref target="RFC6703" sect | |||
ionFormat="of" section="5"/> for background on this analysis choice.</t> | ||||
<t>The reference method requires some way to distinguish between | <t>The reference method requires some way to distinguish between | |||
different packets in a stream to establish correspondence between | different packets in a stream to establish correspondence between | |||
sending times and receiving times for each successfully-arriving | sending times and receiving times for each successfully arriving | |||
packet. Sequence numbers or other send-order identification MUST be | packet. Sequence numbers or other send-order identification <bcp14>MUS | |||
T</bcp14> be | ||||
retained at the Src or included with each packet to disambiguate | retained at the Src or included with each packet to disambiguate | |||
packet reordering if it occurs.</t> | packet reordering if it occurs.</t> | |||
<t>If a standard measurement protocol is employed, then the | <t>If a standard measurement protocol is employed, then the | |||
measurement process will determine the sequence numbers or | measurement process will determine the sequence numbers or | |||
timestamps applied to test packets after the Fixed and Runtime | timestamps applied to test packets after the Fixed and Runtime | |||
parameters are passed to that process. The chosen measurement | Parameters are passed to that process. The chosen measurement | |||
protocol will dictate the format of sequence numbers and | protocol will dictate the format of sequence numbers and | |||
time-stamps, if they are conveyed in the packet payload.</t> | timestamps, if they are conveyed in the packet payload.</t> | |||
<t>Refer to <xref target="RFC6673" sectionFormat="of" section="4.4"/> | ||||
<t>Refer to Section 4.4 of <xref target="RFC6673"/> for expanded | for an expanded | |||
discussion of the instruction to "send a Type-P packet back to the | discussion of the instruction to "send a Type-P packet back to the | |||
Src as quickly as possible" in Section 2.6 of <xref | Src as quickly as possible" in <xref target="RFC2681" sectionFormat="o | |||
target="RFC2681">RFC 2681</xref>. Section 8 of <xref | f" section="2.6"/>. <xref target="RFC6673" sectionFormat="of" section="8"/> | |||
target="RFC6673"/> presents additional requirements which MUST be | presents additional requirements that <bcp14>MUST</bcp14> be | |||
included in the method of measurement for this metric.</t> | included in the Method of Measurement for this metric.</t> | |||
</section> | </section> | |||
<!-- 4.3.2 --> | ||||
<section title="Packet Stream Generation"> | <section numbered="true" toc="default"> | |||
<t>This section gives the details of the packet traffic which is the | <name>Packet Stream Generation</name> | |||
basis for measurement. In IPPM metrics, this is called the Stream, | <t>This section provides details regarding packet traffic, which is | |||
and can easily be described by providing the list of stream | used as the basis for measurement. In IPPM Metrics, this is called | |||
parameters.</t> | the "stream"; this stream can easily be described by providing the | |||
list of stream Parameters.</t> | ||||
<t>Section 3 of <xref target="RFC3432"/> prescribes the method for | <t><xref target="RFC3432" sectionFormat="of" section="3"/> prescribes | |||
generating Periodic streams using associated parameters.</t> | the method for | |||
generating Periodic streams using associated Parameters.</t> | ||||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="incT">the nominal duration of inter-packet | <dt>incT:</dt> | |||
<dd>The nominal duration of the inter-packet | ||||
interval, first bit to first bit, with value 0.0200, expressed | interval, first bit to first bit, with value 0.0200, expressed | |||
in units of seconds, as a positive value of type decimal64 with | in units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 4 (see section 9.3 of <xref | fraction digits = 4 (see <xref target="RFC6020" sectionFormat="of" | |||
target="RFC6020"/>) and with resolution of 0.0001 seconds (0.1 | section="9.3"/>) and with a resolution of 0.0001 seconds (0.1 | |||
ms).</t> | ms).</dd> | |||
<dt>dT:</dt> | ||||
<t hangText="dT">the duration of the interval for allowed sample | <dd>The duration of the interval for allowed sample | |||
start times, with value 1.0, expressed in units of seconds, as a | start times, with value 1.0, expressed in units of seconds, as a | |||
positive value of type decimal64 with fraction digits = 4 (see | positive value of type decimal64 with fraction digits = 4 (see | |||
section 9.3 of <xref target="RFC6020"/>) and with resolution of | <xref target="RFC6020" sectionFormat="of" section="9.3"/>) and wit | |||
0.0001 seconds (0.1 ms).</t> | h a resolution of | |||
</list>NOTE: an initiation process with a number of control | 0.0001 seconds (0.1 ms).</dd> | |||
</dl> | ||||
<t indent="3">Note: An initiation process with a number of control | ||||
exchanges resulting in unpredictable start times (within a time | exchanges resulting in unpredictable start times (within a time | |||
interval) may be sufficient to avoid synchronization of periodic | interval) may be sufficient to avoid synchronization of periodic | |||
streams, and therefore a valid replacement for selecting a start | streams and is a valid replacement for selecting a start time | |||
time at random from a fixed interval.</t> | at random from a fixed interval.</t> | |||
<t>The T0 Parameter will be reported as a measured Parameter. | ||||
<t>The T0 parameter will be reported as a measured parameter. | ||||
Parameters incT and dT are Fixed Parameters.</t> | Parameters incT and dT are Fixed Parameters.</t> | |||
</section> | </section> | |||
<!-- 4.3.3 --> | ||||
<section title="Traffic Filtering (observation) Details"> | <section numbered="true" toc="default"> | |||
<t>NA</t> | <name>Traffic Filtering (Observation) Details</name> | |||
<t>N/A</t> | ||||
</section> | </section> | |||
<!-- 4.3.4 --> | ||||
<section title="Sampling Distribution"> | <section numbered="true" toc="default"> | |||
<t>NA</t> | <name>Sampling Distribution</name> | |||
<t>N/A</t> | ||||
</section> | </section> | |||
<!-- 4.3.5 --> | ||||
<section title="Run-time Parameters and Data Format"> | <section numbered="true" toc="default"> | |||
<t>Run-time Parameters are input factors that must be determined, | <name>Runtime Parameters and Data Format</name> | |||
<t>Runtime Parameters are input factors that must be determined, | ||||
configured into the measurement system, and reported with the | configured into the measurement system, and reported with the | |||
results for the context to be complete.</t> | results for the context to be complete.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Src:</dt> | |||
<t hangText="Src">the IP address of the host in the Src Role | <dd>The IP address of the host in the Src Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>Dst:</dt> | ||||
<t hangText="Dst">the IP address of the host in the Dst Role | <dd>The IP address of the host in the Dst Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>T0:</dt> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dd>A time, the start of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref | |||
target="RFC3339"/>, see also Section 3 of <xref | target="RFC3339" sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "of" section="3"/>). The | |||
time is unspecified and Tf is to be interpreted as the Duration | UTC Time Zone is required by <xref target="RFC2330" | |||
sectionFormat="of" section="6.1"/>. When T0 is "all-zeros", a star | ||||
t | ||||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Tf:</dt> | ||||
<t hangText="Tf">a time, the end of a measurement interval, | <dd>A time, the end of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a end | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time date is ignored and Tf is interpreted as the Duration of | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", an ending | |||
the measurement interval.</t> | time and date is ignored and Tf is interpreted as the duration of | |||
</list></t> | the measurement interval.</dd> | |||
</dl> | ||||
<t/> | ||||
</section> | </section> | |||
<!-- 4.3.6 --> | ||||
<section title="Roles"> | <section numbered="true" toc="default"> | |||
<t><list style="hanging"> | <name>Roles</name> | |||
<t hangText="Src">launches each packet and waits for return | <dl newline="false" spacing="normal"> | |||
transmissions from Dst.</t> | <dt>Src:</dt> | |||
<dd>Launches each packet and waits for return | ||||
<t hangText="Dst">waits for each packet from Src and sends a | transmissions from the Dst.</dd> | |||
return packet to Src.</t> | <dt>Dst:</dt> | |||
</list></t> | <dd>Waits for each packet from the Src and sends a | |||
return packet to the Src.</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<!-- 4.4 --> | ||||
<section title="Output"> | <section numbered="true" toc="default"> | |||
<t>This category specifies all details of the Output of measurements | <name>Output</name> | |||
<t>This category specifies all details of the output of measurements | ||||
using the metric.</t> | using the metric.</t> | |||
<!-- 4.4.1 --> | ||||
<section title="Type"> | <section numbered="true" toc="default"> | |||
<t>Percentile -- for the conditional distribution of all packets | <name>Type</name> | |||
with a valid value of Round-trip delay (undefined delays are | <t>Percentile: For the conditional distribution of all packets | |||
excluded), a single value corresponding to the 95th percentile, as | with a valid value of round-trip delay (undefined delays are | |||
excluded), this is a single value corresponding to the 95th percentile | ||||
, as | ||||
follows:</t> | follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for d | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | etails on the | |||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and see | |||
Section 5 of <xref target="RFC6703"/> for background on this | <xref target="RFC6703" sectionFormat="of" section="5"/> for background | |||
on this | ||||
analysis choice.</t> | analysis choice.</t> | |||
<t>The percentile = 95, meaning that the reported delay, | <t>The percentile = 95, meaning that the reported delay, | |||
"95Percentile", is the smallest value of Round-trip delay for which | "95Percentile", is the smallest value of round-trip delay for which | |||
the Empirical Distribution Function (EDF), F(95Percentile) >= 95% | the Empirical Distribution Function, EDF(95Percentile), is greater | |||
of the singleton Round-trip delay values in the conditional | than or equal to 95% of the singleton round-trip delay values in the co | |||
distribution. See section 11.3 of <xref target="RFC2330"/> for the | nditional | |||
distribution. See <xref target="RFC2330" sectionFormat="of" section="1 | ||||
1.3"/> for the | ||||
definition of the percentile statistic using the EDF.</t> | definition of the percentile statistic using the EDF.</t> | |||
<t>For LossRatio, the count of lost packets to total packets sent is | ||||
<t>LossRatio -- the count of lost packets to total packets sent is | the basis for the loss ratio calculation as per <xref target="RFC6673" | |||
the basis for the loss ratio calculation as per Section 6.1 of <xref | sectionFormat="of" section="6.1"/>.</t> | |||
target="RFC6673"/>.</t> | ||||
</section> | </section> | |||
<!-- 4.4.2 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Reference Definition</name> | ||||
<t>For all outputs:</t> | ||||
<dl newline="false" spacing="normal"> | ||||
<dt>T0:</dt> | ||||
<dd>The start of a measurement interval (format | ||||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
sectionFormat="of" section="5.6"/>; see also | ||||
"date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | ||||
"of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | ||||
tionFormat="of" section="6.1"/>.</dd> | ||||
<dt>Tf:</dt> | ||||
<dd>The end of a measurement interval (format | ||||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
sectionFormat="of" section="5.6"/>; see also | ||||
"date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | ||||
"of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | ||||
tionFormat="of" section="6.1"/>.</dd> | ||||
<dt>TotalPkts:</dt> | ||||
<dd>The count of packets sent by the Src to the | ||||
Dst during the measurement interval.</dd> | ||||
</dl> | ||||
<section title="Reference Definition"> | <dl newline="false" spacing="normal"> | |||
<t>For all outputs ---</t> | <dt>95Percentile:</dt> | |||
<dd>The time value of the result is expressed in units of seconds, a | ||||
<t><list style="hanging"> | s a positive value of type decimal64 with fraction digits = 9 (see <xref target= | |||
<t hangText="T0">the start of a measurement interval, (format | "RFC6020" sectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 s | |||
"date-and-time" as specified in Section 5.6 of <xref | econds (1.0 ns).</dd> | |||
target="RFC3339"/>, see also Section 3 of <xref | </dl> | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | ||||
6.1 of <xref target="RFC2330"/>.</t> | ||||
<t hangText="Tf">the end of a measurement interval, (format | ||||
"date-and-time" as specified in Section 5.6 of <xref | ||||
target="RFC3339"/>, see also Section 3 of <xref | ||||
target="RFC6991"/>). The UTC Time Zone is required by Section | ||||
6.1 of <xref target="RFC2330"/>.</t> | ||||
<t hangText="TotalPkts">the count of packets sent by the Src to | ||||
Dst during the measurement interval.</t> | ||||
</list></t> | ||||
<t/> | ||||
<t>For</t> | ||||
<t>RTDelay_Active_IP-UDP-Periodic_RFCXXXXsec4_Seconds_95Percentile:</t | ||||
> | ||||
<t><list style="hanging"> | ||||
<t hangText="95Percentile">The time value of the result is | ||||
expressed in units of seconds, as a positive value of type | ||||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | ||||
target="RFC6020"/>) with resolution of 0.000000001 seconds (1.0 | ||||
ns).</t> | ||||
</list></t> | ||||
<t>For</t> | ||||
<t>RTLoss_Active_IP-UDP-Periodic_RFCXXXXsec4_Percent_LossRatio:</t> | ||||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="Percentile">The numeric value of the result is | <dt>Percent_LossRatio:</dt> | |||
expressed in units of lost packets to total packets times 100%, | <dd>The numeric value of the result is expressed in units of lost pa | |||
as a positive value of type decimal64 with fraction digits = 9 | ckets to total packets times 100%, as a positive value of type decimal64 with fr | |||
(see section 9.3 of <xref target="RFC6020"/>) with resolution of | action digits = 9 (see <xref target="RFC6020" sectionFormat="of" section="9.3"/> | |||
0.0000000001.</t> | ) with a resolution of | |||
</list></t> | 0.0000000001.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<!-- 4.4.3 --> | ||||
<section title="Metric Units"> | <section numbered="true" toc="default"> | |||
<t>The 95th Percentile of Round-trip Delay is expressed in | <name>Metric Units</name> | |||
<t>The 95th percentile of round-trip delay is expressed in | ||||
seconds.</t> | seconds.</t> | |||
<t>The round-trip loss ratio is expressed as a percentage of lost | ||||
<t>The Round-trip Loss Ratio is expressed as a percentage of lost | ||||
packets to total packets sent.</t> | packets to total packets sent.</t> | |||
</section> | </section> | |||
<!-- 4.4.4 --> | ||||
<section title="Calibration"> | <section numbered="true" toc="default"> | |||
<t>Section 3.7.3 of <xref target="RFC7679"/> provides a means to | <name>Calibration</name> | |||
<t><xref target="RFC7679" sectionFormat="of" section="3.7.3"/> provide | ||||
s a means to | ||||
quantify the systematic and random errors of a time measurement. | quantify the systematic and random errors of a time measurement. | |||
In-situ calibration could be enabled with an internal loopback at | Calibration in-situ could be enabled with an internal loopback at | |||
the Source host that includes as much of the measurement system as | the Source host that includes as much of the measurement system as | |||
possible, performs address manipulation as needed, and provides some | possible, performs address manipulation as needed, and provides some | |||
form of isolation (e.g., deterministic delay) to avoid send-receive | form of isolation (e.g., deterministic delay) to avoid send-receive | |||
interface contention. Some portion of the random and systematic | interface contention. Some portion of the random and systematic | |||
error can be characterized this way.</t> | error can be characterized in this way.</t> | |||
<t>When a measurement controller requests a calibration measurement, | <t>When a measurement controller requests a calibration measurement, | |||
the loopback is applied and the result is output in the same format | the loopback is applied and the result is output in the same format | |||
as a normal measurement with additional indication that it is a | as a normal measurement, with an additional indication that it is a | |||
calibration result.</t> | calibration result.</t> | |||
<t>Both internal loopback calibration and clock synchronization can | <t>Both internal loopback calibration and clock synchronization can | |||
be used to estimate the available accuracy of the Output Metric | be used to estimate the available accuracy of the Output Metric | |||
Units. For example, repeated loopback delay measurements will reveal | Units. For example, repeated loopback delay measurements will reveal | |||
the portion of the Output result resolution which is the result of | the portion of the output result resolution that is the result of | |||
system noise, and thus inaccurate.</t> | system noise and is thus inaccurate.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<!-- 4.5 --> | ||||
<section title="Administrative items"> | <section numbered="true" toc="default"> | |||
<t/> | <name>Administrative Items</name> | |||
<!-- 4.5.1 --> | ||||
<section title="Status"> | <section numbered="true" toc="default"> | |||
<name>Status</name> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<!-- 4.5.2 --> | ||||
<section title="Requester"> | <section numbered="true" toc="default"> | |||
<t>This RFC number</t> | <name>Requester</name> | |||
<t>RFC 8912</t> | ||||
</section> | </section> | |||
<!-- 4.5.3 --> | ||||
<section title="Revision"> | <section numbered="true" toc="default"> | |||
<name>Revision</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<!-- 4.5.4 --> | ||||
<section title="Revision Date"> | <section numbered="true" toc="default"> | |||
<t>YYYY-MM-DD</t> | <name>Revision Date</name> | |||
<t>2021-11-17</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Comments and Remarks"> | <name>Comments and Remarks</name> | |||
<t>None.</t> | <t>None</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<!-- Section 5 --> | ||||
<section title="Packet Delay Variation Registry Entry"> | <section anchor="packet_delay_variation" numbered="true" toc="default"> | |||
<t>This section gives an initial registry entry for a Packet Delay | <name>Packet Delay Variation Registry Entry</name> | |||
Variation metric.</t> | <t>This section gives an initial Registry Entry for a Packet Delay | |||
Variation (PDV) metric.</t> | ||||
<section title="Summary"> | <section numbered="true" toc="default"> | |||
<t>This category includes multiple indexes to the registry entries, | <name>Summary</name> | |||
the element ID and metric name.</t> | <t>This category includes multiple indexes to the Registry Entry: | |||
the element ID and Metric Name.</t> | ||||
<section title="ID (Identifier)"> | <section numbered="true" toc="default"> | |||
<t><insert numeric identifier, an integer></t> | <name>ID (Identifier)</name> | |||
<t>IANA has allocated the numeric Identifier 3 for the | ||||
Named Metric Entry in <xref target="packet_delay_variation"/>. See <xref | ||||
target="name512"/> for mapping to Name.</t> | ||||
</section> | </section> | |||
<section title="Name"> | <section anchor="name512" numbered="true" toc="default"> | |||
<t>OWPDV_Active_IP-UDP-Periodic_RFCXXXXsec5_Seconds_95Percentile</t> | <name>Name</name> | |||
<dl> | ||||
<dt>3:</dt><dd>OWPDV_Active_IP-UDP-Periodic_RFC8912sec5_Seconds_95Per | ||||
centile</dd> | ||||
</dl> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="URI"> | <name>URI</name> | |||
<t>URL: https://www.iana.org/ ... <name></t> | <t>URL: <eref target="https://www.iana.org/performance-metrics/OWPDV_A | |||
ctive_IP-UDP-Periodic_RFC8912sec5_Seconds_95Percentile"/></t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Description"> | <name>Description</name> | |||
<t>An assessment of packet delay variation with respect to the | <t>This metric assesses packet delay variation with respect to the | |||
minimum delay observed on the periodic stream, and the Output is | minimum delay observed on the periodic stream. The output is | |||
expressed as the 95th percentile of the packet delay variation | expressed as the 95th percentile of the one-way packet delay variation | |||
distribution.</t> | distribution.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Change Controller"> | <name>Change Controller</name> | |||
<t>IETF</t> | <t>IETF</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Version (of Registry Format)"> | <name>Version (of Registry Format)</name> | |||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Metric Definition"> | <name>Metric Definition</name> | |||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Definition"> | <name>Reference Definition</name> | |||
<t>Paxson, V., Almes, G., Mahdavi, J., and M. Mathis, "Framework for | <t>Paxson, V., Almes, G., Mahdavi, J., and M. Mathis, "Framework for | |||
IP Performance Metrics", RFC 2330, May 1998. <xref | IP Performance Metrics", RFC 2330, DOI 10.17487/RFC2330, May 1998, | |||
target="RFC2330"/></t> | <https://www.rfc-editor.org/info/rfc2330>. <xref | |||
target="RFC2330"/></t> | ||||
<t>Demichelis, C. and P. Chimento, "IP Packet Delay Variation Metric | <t>Demichelis, C. and P. Chimento, "IP Packet Delay Variation Metric | |||
for IP Performance Metrics (IPPM)", RFC 3393, November 2002. <xref | for IP Performance Metrics (IPPM)", RFC 3393, DOI 10.17487/RFC3393, | |||
target="RFC3393"/></t> | November 2002, | |||
<https://www.rfc-editor.org/info/rfc3393>. <xref | ||||
target="RFC3393"/></t> | ||||
<t>Morton, A. and B. Claise, "Packet Delay Variation Applicability | <t>Morton, A. and B. Claise, "Packet Delay Variation Applicability | |||
Statement", RFC 5481, March 2009. <xref target="RFC5481"/></t> | Statement", RFC 5481, DOI 10.17487/RFC5481, March 2009, | |||
<https://www.rfc-editor.org/info/rfc5481>. <xref | ||||
<t>Mills, D., Martin, J., Burbank, J., and W. Kasch, "Network Time | target="RFC5481"/></t> | |||
Protocol Version 4: Protocol and Algorithms Specification", RFC | <t>Mills, D., Martin, J., Ed., Burbank, J., and W. Kasch, "Network | |||
5905, June 2010.<xref target="RFC5905"> </xref></t> | Time Protocol Version 4: Protocol and Algorithms Specification", RFC | |||
5905, DOI 10.17487/RFC5905, June 2010, | ||||
<t>See sections 2.4 and 3.4 of <xref target="RFC3393"/>. Singleton | <https://www.rfc-editor.org/info/rfc5905>. | |||
delay differences measured are referred to by the variable name | <xref target="RFC5905"/></t> | |||
<t>See Sections <xref target="RFC3393" section="2.4" | ||||
sectionFormat="bare"/> and <xref target="RFC3393" section="3.4" | ||||
sectionFormat="bare"/> of <xref target="RFC3393"/>. The measured singleton | ||||
delay differences are referred to by the variable name | ||||
"ddT" (applicable to all forms of delay variation). However, this | "ddT" (applicable to all forms of delay variation). However, this | |||
metric entry specifies the PDV form defined in section 4.2 of <xref | Metric Entry specifies the PDV form defined in <xref target="RFC5481" | |||
target="RFC5481"/>, where the singleton PDV for packet i is referred | sectionFormat="of" section="4.2"/>, where the singleton PDV for packet i is refe | |||
rred | ||||
to by the variable name "PDV(i)".</t> | to by the variable name "PDV(i)".</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<name>Fixed Parameters</name> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv4 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>TTL:</dt><dd>Set to 255</dd> | ||||
<dt>Protocol:</dt><dd>Set to 17 (UDP)</dd> | ||||
</dl> | ||||
</dd> | ||||
<section title="Fixed Parameters"> | <dt>IPv6 header values:</dt> | |||
<t><list style="symbols"> | <dd><t/> | |||
<t>IPv4 header values: <list style="symbols"> | <dl newline="false" spacing="compact"> | |||
<t>DSCP: set to 0</t> | <dt>DSCP:</dt><dd>Set to 0</dd> | |||
<dt>Hop Count:</dt><dd>Set to 255</dd> | ||||
<t>TTL: set to 255</t> | <dt>Next Header:</dt><dd>Set to 17 (UDP)</dd> | |||
<dt>Flow Label:</dt><dd>Set to 0</dd> | ||||
<t>Protocol: set to 17 (UDP)</t> | <dt>Extension Headers:</dt><dd>None</dd> | |||
</list></t> | </dl> | |||
</dd> | ||||
<t>IPv6 header values:<list style="symbols"> | ||||
<t>DSCP: set to 0</t> | ||||
<t>Hop Count: set to 255</t> | ||||
<t>Next Header: set to 17 (UDP)</t> | ||||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>UDP header values: <list style="symbols"> | ||||
<t>Checksum: the checksum MUST be calculated and the | ||||
non-zero checksum included in the header</t> | ||||
</list></t> | ||||
<t>UDP Payload <list style="symbols"> | <dt>UDP header values:</dt> | |||
<t>total of 200 bytes</t> | <dd><t/> | |||
</list></t> | <dl newline="false" spacing="compact"> | |||
</list></t> | <dt>Checksum:</dt><dd>The checksum <bcp14>MUST</bcp14> be calcul | |||
ated and the | ||||
non-zero checksum included in the header</dd> | ||||
</dl> | ||||
</dd> | ||||
<t>Other measurement parameters:</t> | <dt>UDP Payload:</dt> | |||
<dd><t/><dl newline="false" spacing="compact"> | ||||
<dt>Total of 200 bytes</dt><dd/> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t><list style="hanging"> | <dl newline="true" spacing="normal"> | |||
<t hangText="Tmax:">a loss threshold waiting time with value | <dt>Other measurement Parameters:</dt> | |||
<dd><t/> | ||||
<dl newline="false" spacing="normal"> | ||||
<dt>Tmax:</dt> | ||||
<dd>A loss threshold waiting time with value | ||||
3.0, expressed in units of seconds, as a positive value of type | 3.0, expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 4 (see section 9.3 of <xref | decimal64 with fraction digits = 4 (see <xref target="RFC6020" sec | |||
target="RFC6020"/>) and with resolution of 0.0001 seconds (0.1 | tionFormat="of" section="9.3"/>) and with a resolution of 0.0001 seconds (0.1 | |||
ms), with lossless conversion to/from the 32-bit NTP timestamp | ms), with lossless conversion to/from the 32-bit NTP timestamp | |||
as per section 6 of <xref target="RFC5905"/>.</t> | as per <xref target="RFC5905" sectionFormat="of" section="6"/>.</d | |||
d> | ||||
<t hangText="F">a selection function unambiguously defining the | <dt>F:</dt> | |||
packets from the stream selected for the metric. See section 4.2 | <dd>A selection function unambiguously defining the | |||
of <xref target="RFC5481"/> for the PDV form.</t> | packets from the stream selected for the metric. See <xref target= | |||
</list>See the Packet Stream generation category for two | "RFC5481" sectionFormat="of" section="4.2"/> for the PDV form.</dd> | |||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>See the Packet Stream Generation section for two | ||||
additional Fixed Parameters.</t> | additional Fixed Parameters.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Method of Measurement"> | <name>Method of Measurement</name> | |||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Method"> | <name>Reference Methods</name> | |||
<t>See section 2.6 and 3.6 of <xref target="RFC3393"/> for general | <t>See Sections <xref target="RFC3393" section="2.6" | |||
singleton element calculations. This metric entry requires | sectionFormat="bare"/> and <xref target="RFC3393" section="3.6" | |||
implementation of the PDV form defined in section 4.2 of <xref | sectionFormat="bare"/> of <xref target="RFC3393"/> for general | |||
target="RFC5481"/>. Also see measurement considerations in section 8 | singleton element calculations. This Metric Entry requires | |||
of <xref target="RFC5481"/>.</t> | implementation of the PDV form defined in <xref target="RFC5481" secti | |||
onFormat="of" section="4.2"/>. Also see measurement considerations in <xref targ | ||||
et="RFC5481" sectionFormat="of" section="8"/>.</t> | ||||
<t>The reference method distinguishes between long-delayed packets | <t>The reference method distinguishes between long-delayed packets | |||
and lost packets by implementing a maximum waiting time for packet | and lost packets by implementing a maximum waiting time for packet | |||
arrival. Tmax is the waiting time used as the threshold to declare a | arrival. Tmax is the waiting time used as the threshold to declare a | |||
packet lost. Lost packets SHALL be designated as having undefined | packet lost. Lost packets <bcp14>SHALL</bcp14> be designated as having undefined | |||
delay.</t> | delay.</t> | |||
<t>The calculations on the one-way delay <bcp14>SHALL</bcp14> be perfo | ||||
<t>The calculations on the one-way delay SHALL be performed on the | rmed on the | |||
conditional distribution, conditioned on successful packet arrival | conditional distribution, conditioned on successful packet arrival | |||
within Tmax. Also, when all packet delays are stored, the process | within Tmax. Also, when all packet delays are stored, the process | |||
which calculates the one-way delay value MUST enforce the Tmax | that calculates the one-way delay value <bcp14>MUST</bcp14> enforce th | |||
threshold on stored values before calculations. See section 4.1 of | e Tmax | |||
<xref target="RFC3393"/> for details on the conditional distribution | threshold on stored values before calculations. See <xref target="RFC3 | |||
to exclude undefined values of delay, and Section 5 of <xref | 393" sectionFormat="of" section="4.1"/> for details on the conditional distribut | |||
target="RFC6703"/> for background on this analysis choice.</t> | ion | |||
to exclude undefined values of delay, and see <xref target="RFC6703" s | ||||
ectionFormat="of" section="5"/> for background on this analysis choice.</t> | ||||
<t>The reference method requires some way to distinguish between | <t>The reference method requires some way to distinguish between | |||
different packets in a stream to establish correspondence between | different packets in a stream to establish correspondence between | |||
sending times and receiving times for each successfully-arriving | sending times and receiving times for each successfully arriving | |||
packet. Sequence numbers or other send-order identification MUST be | packet. Sequence numbers or other send-order identification <bcp14>MUS | |||
T</bcp14> be | ||||
retained at the Src or included with each packet to disambiguate | retained at the Src or included with each packet to disambiguate | |||
packet reordering if it occurs.</t> | packet reordering if it occurs.</t> | |||
<t>If a standard measurement protocol is employed, then the | <t>If a standard measurement protocol is employed, then the | |||
measurement process will determine the sequence numbers or | measurement process will determine the sequence numbers or | |||
timestamps applied to test packets after the Fixed and Runtime | timestamps applied to test packets after the Fixed and Runtime | |||
parameters are passed to that process. The chosen measurement | Parameters are passed to that process. The chosen measurement | |||
protocol will dictate the format of sequence numbers and | protocol will dictate the format of sequence numbers and | |||
time-stamps, if they are conveyed in the packet payload.</t> | timestamps, if they are conveyed in the packet payload.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Packet Stream Generation"> | <name>Packet Stream Generation</name> | |||
<t>This section gives the details of the packet traffic which is the | <t>This section provides details regarding packet traffic, which is | |||
basis for measurement. In IPPM metrics, this is called the Stream, | used as the | |||
and can easily be described by providing the list of stream | basis for measurement. In IPPM Metrics, this is called the "stream"; | |||
parameters.</t> | this stream can easily be described by providing the list of stream | |||
Parameters.</t> | ||||
<t>Section 3 of <xref target="RFC3432"/> prescribes the method for | <t><xref target="RFC3432" sectionFormat="of" section="3"/> prescribes | |||
generating Periodic streams using associated parameters.</t> | the method for | |||
generating Periodic streams using associated Parameters.</t> | ||||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="incT">the nominal duration of inter-packet | <dt>incT:</dt> | |||
<dd>The nominal duration of the inter-packet | ||||
interval, first bit to first bit, with value 0.0200, expressed | interval, first bit to first bit, with value 0.0200, expressed | |||
in units of seconds, as a positive value of type decimal64 with | in units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 4 (see section 9.3 of <xref | fraction digits = 4 (see <xref target="RFC6020" sectionFormat="of" | |||
target="RFC6020"/>) and with resolution of 0.0001 seconds (0.1 | section="9.3"/>) and with a resolution of 0.0001 seconds (0.1 | |||
ms).</t> | ms).</dd> | |||
<dt>dT:</dt> | ||||
<t hangText="dT">the duration of the interval for allowed sample | <dd>The duration of the interval for allowed sample | |||
start times, with value 1.0, expressed in units of seconds, as a | start times, with value 1.0, expressed in units of seconds, as a | |||
positive value of type decimal64 with fraction digits = 4 (see | positive value of type decimal64 with fraction digits = 4 (see | |||
section 9.3 of <xref target="RFC6020"/>) and with resolution of | <xref target="RFC6020" sectionFormat="of" section="9.3"/>) and wit | |||
0.0001 seconds (0.1 ms).</t> | h a resolution of | |||
</list>NOTE: an initiation process with a number of control | 0.0001 seconds (0.1 ms).</dd> | |||
</dl> | ||||
<t indent="3">Note: An initiation process with a number of control | ||||
exchanges resulting in unpredictable start times (within a time | exchanges resulting in unpredictable start times (within a time | |||
interval) may be sufficient to avoid synchronization of periodic | interval) may be sufficient to avoid synchronization of periodic | |||
streams, and therefore a valid replacement for selecting a start | streams and is a valid replacement for selecting a start | |||
time at random from a fixed interval.</t> | time at random from a fixed interval.</t> | |||
<t>The T0 Parameter will be reported as a measured Parameter. | ||||
<t>The T0 parameter will be reported as a measured parameter. | ||||
Parameters incT and dT are Fixed Parameters.</t> | Parameters incT and dT are Fixed Parameters.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Traffic Filtering (observation) Details"> | <name>Traffic Filtering (Observation) Details</name> | |||
<t>NA</t> | <t>N/A</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Sampling Distribution"> | <name>Sampling Distribution</name> | |||
<t>NA</t> | <t>N/A</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Run-time Parameters and Data Format"> | <name>Runtime Parameters and Data Format</name> | |||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="Src">the IP address of the host in the Src Role | <dt>Src:</dt> | |||
(format ipv4-address-no-zone value for IPv4, or | <dd>The IP address of the host in the Src Role | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
target="RFC6991"/>)</t> | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
ctionFormat="of" section="4"/>).</dd> | ||||
<t hangText="Dst">the IP address of the host in the Dst Role | <dt>Dst:</dt> | |||
(format ipv4-address-no-zone value for IPv4, or | <dd>The IP address of the host in the Dst Role | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
target="RFC6991"/>)</t> | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
ctionFormat="of" section="4"/>).</dd> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dt>T0:</dt> | |||
(format "date-and-time" as specified in Section 5.6 of <xref | <dd>A time, the start of a measurement interval | |||
target="RFC3339"/>, see also Section 3 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | sectionFormat="of" section="5.6"/>; see also | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
time is unspecified and Tf is to be interpreted as the Duration | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
tionFormat="of" section="6.1"/>. When T0 is "all-zeros", a start | ||||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Tf:</dt> | ||||
<t hangText="Tf">a time, the end of a measurement interval, | <dd>A time, the end of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a end | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time date is ignored and Tf is interpreted as the Duration of | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", an ending | |||
the measurement interval.</t> | time and date is ignored and Tf is interpreted as the duration of | |||
</list></t> | the measurement interval.</dd> | |||
</dl> | ||||
<t/> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Roles"> | <name>Roles</name> | |||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="Src">launches each packet and waits for return | <dt>Src:</dt> | |||
transmissions from Dst.</t> | <dd>Launches each packet and waits for return | |||
transmissions from the Dst.</dd> | ||||
<t hangText="Dst">waits for each packet from Src and sends a | <dt>Dst:</dt> | |||
return packet to Src.</t> | <dd>Waits for each packet from the Src and sends a return packet to | |||
</list></t> | the Src (when required by the test protocol).</dd> | |||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Output"> | <name>Output</name> | |||
<t>This category specifies all details of the Output of measurements | <t>This category specifies all details of the output of measurements | |||
using the metric.</t> | using the metric.</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Type"> | <name>Type</name> | |||
<t>Percentile -- for the conditional distribution of all packets | <t>Percentile: For the conditional distribution of all packets | |||
with a valid value of one-way delay (undefined delays are excluded), | with a valid value of one-way delay (undefined delays are excluded), | |||
a single value corresponding to the 95th percentile, as follows:</t> | this is a single value corresponding to the 95th percentile, as follow | |||
s:</t> | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | <t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for d | |||
conditional distribution to exclude undefined values of delay, and | etails on the | |||
Section 5 of <xref target="RFC6703"/> for background on this | conditional distribution to exclude undefined values of delay, and see | |||
<xref target="RFC6703" sectionFormat="of" section="5"/> for background | ||||
on this | ||||
analysis choice.</t> | analysis choice.</t> | |||
<t>The percentile = 95, meaning that the reported delay, | <t>The percentile = 95, meaning that the reported delay, | |||
"95Percentile", is the smallest value of one-way PDV for which the | "95Percentile", is the smallest value of one-way PDV for which the | |||
Empirical Distribution Function (EDF), F(95Percentile) >= 95% of | Empirical Distribution Function, EDF(95Percentile), is greater than | |||
or equal to 95% of | ||||
the singleton one-way PDV values in the conditional distribution. | the singleton one-way PDV values in the conditional distribution. | |||
See section 11.3 of <xref target="RFC2330"/> for the definition of | See <xref target="RFC2330" sectionFormat="of" section="11.3"/> for the definition of | |||
the percentile statistic using the EDF.</t> | the percentile statistic using the EDF.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Definition"> | <name>Reference Definition</name> | |||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="T0">the start of a measurement interval, (format | <dt>T0:</dt> | |||
"date-and-time" as specified in Section 5.6 of <xref | <dd>The start of a measurement interval (format | |||
target="RFC3339"/>, see also Section 3 of <xref | "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | sectionFormat="of" section="5.6"/>; see also | |||
6.1 of <xref target="RFC2330"/>.</t> | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
"of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | ||||
<t hangText="Tf">the end of a measurement interval, (format | tionFormat="of" section="6.1"/>.</dd> | |||
"date-and-time" as specified in Section 5.6 of <xref | <dt>Tf:</dt> | |||
target="RFC3339"/>, see also Section 3 of <xref | <dd>The end of a measurement interval (format | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;time" as specified in <xref target="RFC3339" | |||
6.1 of <xref target="RFC2330"/>.</t> | sectionFormat="of" section="5.6"/>; see also | |||
</list></t> | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
"of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | ||||
<t><list style="hanging"> | tionFormat="of" section="6.1"/>.</dd> | |||
<t hangText="95Percentile">The time value of the result is | </dl> | |||
<dl newline="false" spacing="normal"> | ||||
<dt>95Percentile:</dt> | ||||
<dd>The time value of the result is | ||||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RFC6020 | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds (1.0 | " sectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seconds ( | |||
1.0 | ||||
ns), and with lossless conversion to/from the 64-bit NTP | ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" section | |||
target="RFC5905">RFC</xref></t> | ="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Metric Units"> | <name>Metric Units</name> | |||
<t>The 95th Percentile of one-way PDV is expressed in seconds.</t> | <t>The 95th percentile of one-way PDV is expressed in seconds.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Calibration"> | <name>Calibration</name> | |||
<t>Section 3.7.3 of <xref target="RFC7679"/> provides a means to | <t><xref target="RFC7679" sectionFormat="of" section="3.7.3"/> provide | |||
s a means to | ||||
quantify the systematic and random errors of a time measurement. | quantify the systematic and random errors of a time measurement. | |||
In-situ calibration could be enabled with an internal loopback that | Calibration in-situ could be enabled with an internal loopback that | |||
includes as much of the measurement system as possible, performs | includes as much of the measurement system as possible, performs | |||
address manipulation as needed, and provides some form of isolation | address manipulation as needed, and provides some form of isolation | |||
(e.g., deterministic delay) to avoid send-receive interface | (e.g., deterministic delay) to avoid send-receive interface | |||
contention. Some portion of the random and systematic error can be | contention. Some portion of the random and systematic error can be | |||
characterized this way.</t> | characterized in this way.</t> | |||
<t>For one-way delay measurements, the error calibration must | <t>For one-way delay measurements, the error calibration must | |||
include an assessment of the internal clock synchronization with its | include an assessment of the internal clock synchronization with its | |||
external reference (this internal clock is supplying timestamps for | external reference (this internal clock is supplying timestamps for | |||
measurement). In practice, the time offsets <xref target="RFC5905"/> | measurement). In practice, the time offsets <xref target="RFC5905" for | |||
of clocks at both the source and destination are needed to estimate | mat="default"/> | |||
of clocks at both the Source and Destination are needed to estimate | ||||
the systematic error due to imperfect clock synchronization (the | the systematic error due to imperfect clock synchronization (the | |||
time offsets are smoothed, thus the random variation is not usually | time offsets are smoothed; thus, the random variation is not usually | |||
represented in the results).<list style="hanging"> | represented in the results).</t> | |||
<t hangText="time_offset">The time value of the result is | <dl newline="false" spacing="normal"> | |||
<dt>time_offset:</dt> | ||||
<dd>The time value of the result is | ||||
expressed in units of seconds, as a signed value of type | expressed in units of seconds, as a signed value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RF | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds (1.0 | C6020" sectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seco | |||
nds (1.0 | ||||
ns), and with lossless conversion to/from the 64-bit NTP | ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" section | |||
target="RFC5905">RFC</xref></t> | ="6"/>.</dd> | |||
</list></t> | </dl> | |||
<t>When a measurement controller requests a calibration measurement, | <t>When a measurement controller requests a calibration measurement, | |||
the loopback is applied and the result is output in the same format | the loopback is applied and the result is output in the same format | |||
as a normal measurement with additional indication that it is a | as a normal measurement, with an additional indication that it is a | |||
calibration result. In any measurement, the measurement function | calibration result. In any measurement, the measurement function | |||
SHOULD report its current estimate of time offset <xref | <bcp14>SHOULD</bcp14> report its current estimate of the time offset < | |||
target="RFC5905"/> as an indicator of the degree of | xref target="RFC5905" format="default"/> as an indicator of the degree of | |||
synchronization.</t> | synchronization.</t> | |||
<t>Both internal loopback calibration and clock synchronization can | <t>Both internal loopback calibration and clock synchronization can | |||
be used to estimate the available accuracy of the Output Metric | be used to estimate the available accuracy of the Output Metric | |||
Units. For example, repeated loopback delay measurements will reveal | Units. For example, repeated loopback delay measurements will reveal | |||
the portion of the Output result resolution which is the result of | the portion of the output result resolution that is the result of | |||
system noise, and thus inaccurate.</t> | system noise and is thus inaccurate.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Administrative items"> | <name>Administrative Items</name> | |||
<t/> | <section numbered="true" toc="default"> | |||
<name>Status</name> | ||||
<section title="Status"> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Requester"> | <name>Requester</name> | |||
<t>This RFC number</t> | <t>RFC 8912</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision"> | <name>Revision</name> | |||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision Date"> | <name>Revision Date</name> | |||
<t>YYYY-MM-DD</t> | <t>2021-11-17</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Comments and Remarks"> | <name>Comments and Remarks</name> | |||
<t>Lost packets represent a challenge for delay variation metrics. See | <t>Lost packets represent a challenge for delay variation metrics. See | |||
section 4.1 of <xref target="RFC3393"/> and the delay variation | <xref target="RFC3393" sectionFormat="of" section="4.1"/> and the delay | |||
applicability statement<xref target="RFC5481"/> for extensive analysis | variation | |||
and comparison of PDV and an alternate metric, IPDV.</t> | applicability statement <xref target="RFC5481" format="default"/> for ex | |||
tensive analysis | ||||
and comparison of PDV and an alternate metric, IPDV (Inter-Packet | ||||
Delay Variation).</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<!-- Section 6 --> | ||||
<section title="DNS Response Latency and Loss Registry Entries"> | <section anchor="dns_response_latency_and_loss" numbered="true" toc="default | |||
<t>This section gives initial registry entries for DNS Response Latency | "> | |||
<name>DNS Response Latency and Loss Registry Entries</name> | ||||
<t>This section gives initial Registry Entries for DNS Response Latency | ||||
and Loss from a network user's perspective, for a specific named | and Loss from a network user's perspective, for a specific named | |||
resource. The metric can be measured repeatedly using different names. | resource. The metric can be measured repeatedly for different named resour | |||
<xref target="RFC2681">RFC 2681</xref> defines a Round-trip delay | ces. | |||
<xref target="RFC2681" format="default"></xref> defines a round-trip delay | ||||
metric. We build on that metric by specifying several of the input | metric. We build on that metric by specifying several of the input | |||
parameters to precisely define two metrics for measuring DNS latency and | Parameters to precisely define two metrics for measuring DNS latency and | |||
loss.</t> | loss.</t> | |||
<t>Note to IANA: Each Registry "Name" below specifies a single registry | <t>All column entries besides the ID, Name, Description, and Output | |||
entry, whose output format varies in accordance with the name.</t> | Reference Method categories are the same; thus, this section defines two | |||
closely related Registry Entries. As a result, IANA has | ||||
<t>All column entries beside the ID, Name, Description, and Output | assigned corresponding URLs to each of the two Named Metrics.</t> | |||
Reference Method categories are the same, thus this section proposes two | <section numbered="true" toc="default"> | |||
closely-related registry entries. As a result, IANA is also asked to | <name>Summary</name> | |||
assign corresponding URLs to each Named Metric.</t> | <t>This category includes multiple indexes to the Registry Entries: | |||
the element ID and Metric Name.</t> | ||||
<section title="Summary"> | <section numbered="true" toc="default"> | |||
<t>This category includes multiple indexes to the registry entries, | <name>ID (Identifier)</name> | |||
the element ID and metric name.</t> | <t>IANA has allocated the numeric Identifiers 4 and 5 for the two | |||
Named Metric Entries in <xref | ||||
<section title="ID (Identifier)"> | target="dns_response_latency_and_loss"/>. See | |||
<t><insert numeric identifier, an integer></t> | <xref target="name612"/> for mapping to Names.</t> | |||
<t>IANA is asked to assign different numeric identifiers to each of | ||||
the two Named Metrics.</t> | ||||
</section> | </section> | |||
<!-- 6.1.2 --> | ||||
<section title="Name"> | <section anchor="name612" numbered="true" toc="default"> | |||
<t>RTDNS_Active_IP-UDP-Poisson_RFCXXXXsec6_Seconds_Raw</t> | <name>Name</name> | |||
<dl> | ||||
<t>RLDNS_Active_IP-UDP-Poisson_RFCXXXXsec6_Logical_Raw</t> | <dt>4:</dt><dd>RTDNS_Active_IP-UDP-Poisson_RFC8912sec6_Seconds_Raw</d | |||
d> | ||||
<dt>5:</dt><dd>RLDNS_Active_IP-UDP-Poisson_RFC8912sec6_Logical_Raw</ | ||||
dd> | ||||
</dl> | ||||
</section> | </section> | |||
<!-- 6.1.3 --> | ||||
<section title="URI"> | <section numbered="true" toc="default"> | |||
<t>URL: https://www.iana.org/ ... <name></t> | <name>URI</name> | |||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDNS_A | ||||
ctive_IP-UDP-Poisson_RFC8912sec6_Seconds_Raw"/></t> | ||||
<t>URL: <eref | ||||
target="https://www.iana.org/performance-metrics/RLDNS_Active_IP-UDP-Poisson_RFC | ||||
8912sec6_Logical_Raw"/></t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Description"> | <name>Description</name> | |||
<t>This is a metric for DNS Response performance from a network | <t>This is a metric for DNS Response performance from a network | |||
user's perspective, for a specific named resource. The metric can be | user's perspective, for a specific named resource. The metric can be | |||
measured repeatedly using different resource names.</t> | measured repeatedly using different resource names.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t>RTDNS: This metric assesses the response time, the interval from | <dt>RTDNS:</dt><dd>This metric assesses the response time, the interva | |||
the query transmission to the response.</t> | l from | |||
the query transmission to the response.</dd> | ||||
<t>RLDNS: This metric indicates that the response was deemed lost. | <dt>RLDNS:</dt><dd>This metric indicates that the response was deemed | |||
lost. | ||||
In other words, the response time exceeded the maximum waiting | In other words, the response time exceeded the maximum waiting | |||
time.</t> | time.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Change Controller"> | <name>Change Controller</name> | |||
<t>IETF</t> | <t>IETF</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Version (of Registry Format)"> | <name>Version (of Registry Format)</name> | |||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Metric Definition"> | <name>Metric Definition</name> | |||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section title="Reference Definition"> | ||||
<t>Mockapetris, P., "Domain names - implementation and | ||||
specification", STD 13, RFC 1035, November 1987. (and updates)</t> | ||||
<t><xref target="RFC1035"/></t> | ||||
<t>Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay | ||||
Metric for IPPM", RFC 2681, September 1999.</t> | ||||
<t><xref target="RFC2681"/></t> | ||||
<t>Section 2.4 of <xref target="RFC2681"/> provides the reference | <!-- 6.2.1 --> | |||
definition of the singleton (single value) Round-trip delay metric. | <section numbered="true" toc="default"> | |||
Section 3.4 of <xref target="RFC2681"/> provides the reference | <name>Reference Definition</name> | |||
<t>For Delay:</t> | ||||
<t indent="3">Mockapetris, P., "Domain names - implementation and | ||||
specification", STD 13, RFC 1035, DOI 10.17487/RFC1035, November | ||||
1987, <https://www.rfc-editor.org/info/rfc1035> (and updates). | ||||
<xref target="RFC1035"/></t> | ||||
<t indent="3">Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-tri | ||||
p Delay | ||||
Metric for IPPM", RFC 2681, DOI 10.17487/RFC2681, September 1999, | ||||
<https://www.rfc-editor.org/info/rfc2681>. | ||||
<xref target="RFC2681"/></t> | ||||
<t indent="3"><xref target="RFC2681" sectionFormat="of" section="2.4"/ | ||||
> provides the reference | ||||
definition of the singleton (single value) round-trip delay metric. | ||||
<xref target="RFC2681" sectionFormat="of" section="3.4"/> provides the | ||||
reference | ||||
definition expanded to cover a multi-singleton sample. Note that | definition expanded to cover a multi-singleton sample. Note that | |||
terms such as singleton and sample are defined in Section 11 of | terms such as "singleton" and "sample" are defined in <xref target="RF | |||
<xref target="RFC2330"/>.</t> | C2330" sectionFormat="of" section="11"/>.</t> | |||
<t indent="3">For DNS Response Latency, the entities in <xref target=" | ||||
<t>For DNS Response Latency, the entities in <xref | RFC1035" format="default"/> must be mapped to <xref target="RFC2681" format="def | |||
target="RFC1035"/> must be mapped to <xref target="RFC2681"/>. The | ault"/>. The | |||
Local Host with its User Program and Resolver take the role of | Local Host with its User Program and Resolver take the Role of | |||
"Src", and the Foreign Name Server takes the role of "Dst".</t> | "Src", and the Foreign Name Server takes the Role of "Dst".</t> | |||
<t indent="3">Note that although the definition of round-trip delay be | ||||
<t>Note that although the <xref target="RFC2681"/> definition of | tween the | |||
"Round-trip-Delay between Src and Dst at T" is directionally | Source (Src) and the Destination (Dst) at T as provided in | |||
ambiguous in the text, this metric tightens the definition further | <xref target="RFC2681" sectionFormat="of" section="2.4"/> | |||
to recognize that the host in the "Src" role will send the first | is directionally ambiguous in the text, this metric | |||
packet to "Dst", and ultimately receive the corresponding return | tightens the definition further to recognize that the host in the | |||
packet from "Dst" (when neither are lost).</t> | Src Role will send the first packet to the host in the Dst Role | |||
and will ultimately receive the corresponding return packet from the | ||||
<t>Morton, A., "Round-trip Packet Loss Metrics", RFC 6673, August | Dst (when neither is lost).</t> | |||
2012.</t> | ||||
<t><xref target="RFC6673"/></t> | <t>For Loss:</t> | |||
<t indent="3">Morton, A., "Round-Trip Packet Loss Metrics", RFC 6673, | ||||
DOI 10.17487/RFC6673, August 2012, | ||||
<https://www.rfc-editor.org/info/rfc6673>. | ||||
<xref target="RFC6673"/></t> | ||||
<t indent="3">For DNS Response Loss, the entities in <xref target="RFC1 | ||||
035"/> must be mapped | ||||
to <xref target="RFC6673"/>. The Local Host with its User Program and R | ||||
esolver | ||||
take the Role of "Src", and the Foreign Name Server takes the Role | ||||
of "Dst".</t> | ||||
<t>Both response time and loss metrics employ a maximum waiting time | <t indent="3">Both response time and Loss metrics employ a maximum wai ting time | |||
for received responses, so the count of lost packets to total | for received responses, so the count of lost packets to total | |||
packets sent is the basis for the loss determination as per Section | packets sent is the basis for the loss determination as per <xref targ | |||
4.3 of <xref target="RFC6673"/>.</t> | et="RFC6673" sectionFormat="of" section="4.3"/>.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<name>Fixed Parameters</name> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>Type-P as defined in <xref target="RFC2330" sectionFormat="of" sec | ||||
tion="13"/>:</dt><dd><t/> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv4 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>TTL:</dt><dd>Set to 255</dd> | ||||
<dt>Protocol:</dt><dd>Set to 17 (UDP)</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv6 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>Hop Count:</dt><dd>Set to 255</dd> | ||||
<dt>Next Header:</dt><dd>Set to 17 (UDP)</dd> | ||||
<dt>Flow Label:</dt><dd>Set to 0</dd> | ||||
<dt>Extension Headers:</dt><dd> None</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<section title="Fixed Parameters"> | <dl newline="true" spacing="normal"> | |||
<t>Type-P as defined in Section 13 of <xref target="RFC2330"/>: | <dt>UDP header values:</dt> | |||
<list style="symbols"> | <dd><t/> | |||
<t>IPv4 header values: <list style="symbols"> | <dl newline="false" spacing="compact"> | |||
<t>DSCP: set to 0</t> | <dt>Source port:</dt><dd>53</dd> | |||
<dt>Destination port:</dt><dd>53</dd> | ||||
<t>TTL set to 255</t> | <dt>Checksum:</dt><dd>The checksum <bcp14>MUST</bcp14> be calculate | |||
d and the | ||||
<t>Protocol: set to 17 (UDP)</t> | non-zero checksum included in the header</dd> | |||
</list></t> | </dl> | |||
</dd> | ||||
<t>IPv6 header values:<list style="symbols"> | </dl> | |||
<t>DSCP: set to 0</t> | ||||
<t>Hop Count: set to 255</t> | ||||
<t>Next Header: set to 17 (UDP)</t> | ||||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>UDP header values: <list style="symbols"> | ||||
<t>Source port: 53</t> | ||||
<t>Destination port: 53</t> | ||||
<t>Checksum: the checksum must be calculated and the | ||||
non-zero checksum included in the header</t> | ||||
</list></t> | ||||
<t>Payload: The payload contains a DNS message as defined in | ||||
<xref target="RFC1035">RFC 1035</xref> with the following | ||||
values: <list style="symbols"> | ||||
<t>The DNS header section contains: <list style="symbols"> | ||||
<t>Identification (see the Run-time column)</t> | ||||
<t>QR: set to 0 (Query)</t> | ||||
<t>OPCODE: set to 0 (standard query)</t> | ||||
<t>AA: not set</t> | ||||
<t>TC: not set</t> | ||||
<t>RD: set to one (recursion desired)</t> | ||||
<t>RA: not set</t> | ||||
<t>RCODE: not set</t> | ||||
<t>QDCOUNT: set to one (only one entry)</t> | ||||
<t>ANCOUNT: not set</t> | ||||
<t>NSCOUNT: not set</t> | ||||
<t>ARCOUNT: not set</t> | <dl newline="true" spacing="normal"> | |||
</list></t> | <dt>Payload:</dt> | |||
<dd><t>The payload contains a DNS message as defined in | ||||
<xref target="RFC1035" format="default"></xref> with the following | ||||
values:</t> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>The DNS header section contains:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>Identification (see the Runtime column)</dt><dd/> | ||||
<dt>QR:</dt><dd>Set to 0 (Query)</dd> | ||||
<dt>OPCODE:</dt><dd>Set to 0 (standard query)</dd> | ||||
<dt>AA:</dt><dd>Not set</dd> | ||||
<dt>TC:</dt><dd>Not set</dd> | ||||
<dt>RD:</dt><dd>Set to 1 (recursion desired)</dd> | ||||
<dt>RA:</dt><dd>Not set</dd> | ||||
<dt>RCODE:</dt><dd>Not set</dd> | ||||
<dt>QDCOUNT:</dt><dd>Set to 1 (only one entry)</dd> | ||||
<dt>ANCOUNT:</dt><dd>Not set</dd> | ||||
<dt>NSCOUNT:</dt><dd>Not set</dd> | ||||
<dt>ARCOUNT:</dt><dd>Not set</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>The Question section contains: <list style="symbols"> | <dl newline="true" spacing="normal"> | |||
<t>QNAME: the Fully Qualified Domain Name (FQDN) | <dt>The Question section contains:</dt> | |||
provided as input for the test, see the Run-time | <dd><t/> | |||
column</t> | <dl newline="false" spacing="normal"> | |||
<dt>QNAME:</dt><dd>The Fully Qualified Domain Name (FQDN) | ||||
provided as input for the test; see the Runtime | ||||
column</dd> | ||||
<dt>QTYPE:</dt><dd>The query type provided as input for the test; | ||||
see the Runtime column</dd> | ||||
<dt>QCLASS:</dt><dd>Set to 1 for IN</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>QTYPE: the query type provided as input for the test, | <dl newline="false" spacing="normal"> | |||
see the Run-time column</t> | <dt>The other sections do not contain any Resource | |||
Records (RRs).</dt><dd/> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>QCLASS: set to 1 for IN</t> | <dl newline="true" spacing="normal"> | |||
</list></t> | <dt>Other measurement Parameters:</dt> | |||
<dd><t/> | ||||
<t>The other sections do not contain any Resource | <dl newline="false" spacing="normal"> | |||
Records.</t> | <dt>Tmax:</dt><dd>A loss threshold waiting time (and to help disam | |||
</list></t> | biguate | |||
</list></t> | queries). The value is 5.0, expressed in units of seconds, as a po | |||
sitive value | ||||
of type decimal64 with fraction digits = 4 (see <xref target="RFC6 | ||||
020" sectionFormat="of" section="9.3"/>) and with a resolution of 0.0001 | ||||
seconds (0.1 ms), with lossless conversion to/from the | ||||
32-bit NTP timestamp as per <xref target="RFC5905" | ||||
sectionFormat="of" section="6"/>.</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>Other measurement parameters:<list style="symbols"> | <dl newline="false" spacing="normal"> | |||
<t>Tmax: a loss threshold waiting time (and to help disambiguate | <dt>Observation:</dt><dd>Reply packets will contain a DNS Response and | |||
queries)<list style="symbols"> | may contain RRs.</dd> | |||
<t>5.0, expressed in units of seconds, as a positive value | </dl> | |||
of type decimal64 with fraction digits = 4 (see section 9.3 | ||||
of <xref target="RFC6020"/>) and with resolution of 0.0001 | ||||
seconds (0.1 ms), with lossless conversion to/from the | ||||
32-bit NTP timestamp as per section 6 of <xref | ||||
target="RFC5905"/>.</t> | ||||
</list></t> | ||||
</list>Observation: reply packets will contain a DNS response and | ||||
may contain RRs.</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Method of Measurement"> | <name>Method of Measurement</name> | |||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Method"> | <name>Reference Methods</name> | |||
<t>The methodology for this metric is defined as | <t>The methodology for this metric (equivalent to | |||
Type-P-Round-trip-Delay-Poisson-Stream in section 2.6 of <xref | Type-P-Round-trip-Delay-Poisson-Stream) is defined as in <xref target= | |||
target="RFC2681">RFC 2681</xref> and section 3.6 of <xref | "RFC2681" | |||
target="RFC2681">RFC 2681</xref> using the Type-P and Timeout | sectionFormat="of" section="2.6"/> (for singletons) and <xref target=" | |||
defined under Fixed Parameters.</t> | RFC2681" | |||
sectionFormat="of" section="3.6"/> (for samples) using the Type-P and | ||||
Timeout | ||||
defined in the Fixed Parameters column.</t> | ||||
<t>The reference method distinguishes between long-delayed packets | <t>The reference method distinguishes between long-delayed packets | |||
and lost packets by implementing a maximum waiting time for packet | and lost packets by implementing a maximum waiting time for packet | |||
arrival. Tmax is the waiting time used as the threshold to declare a | arrival. Tmax is the waiting time used as the threshold to declare a | |||
response packet lost. Lost packets SHALL be designated as having | response packet lost. Lost packets <bcp14>SHALL</bcp14> be designated as having | |||
undefined delay and counted for the RLDNS metric.</t> | undefined delay and counted for the RLDNS metric.</t> | |||
<t>The calculations on the delay (RTT) <bcp14>SHALL</bcp14> be perform | ||||
<t>The calculations on the delay (RTT) SHALL be performed on the | ed on the | |||
conditional distribution, conditioned on successful packet arrival | conditional distribution, conditioned on successful packet arrival | |||
within Tmax. Also, when all packet delays are stored, the process | within Tmax. Also, when all packet delays are stored, the process | |||
which calculates the RTT value MUST enforce the Tmax threshold on | that calculates the RTT value <bcp14>MUST</bcp14> enforce the Tmax thr | |||
stored values before calculations. See section 4.1 of <xref | eshold on | |||
target="RFC3393"/> for details on the conditional distribution to | stored values before calculations. See <xref target="RFC3393" sectionF | |||
exclude undefined values of delay, and Section 5 of <xref | ormat="of" section="4.1"/> for details on the conditional distribution to | |||
target="RFC6703"/> for background on this analysis choice.</t> | exclude undefined values of delay, and see <xref target="RFC6703" sect | |||
ionFormat="of" section="5"/> for background on this analysis choice.</t> | ||||
<t>The reference method requires some way to distinguish between | <t>The reference method requires some way to distinguish between | |||
different packets in a stream to establish correspondence between | different packets in a stream to establish correspondence between | |||
sending times and receiving times for each successfully-arriving | sending times and receiving times for each successfully arriving | |||
reply.</t> | reply.</t> | |||
<t>DNS messages bearing queries provide for random ID Numbers in the | ||||
<t>DNS Messages bearing Queries provide for random ID Numbers in the | ||||
Identification header field, so more than one query may be launched | Identification header field, so more than one query may be launched | |||
while a previous request is outstanding when the ID Number is used. | while a previous request is outstanding when the ID Number is used. | |||
Therefore, the ID Number MUST be retained at the Src and included | Therefore, the ID Number <bcp14>MUST</bcp14> be retained at the Src an d included | |||
with each response packet to disambiguate packet reordering if it | with each response packet to disambiguate packet reordering if it | |||
occurs.</t> | occurs.</t> | |||
<t>If a DNS Response does not arrive within Tmax, the response time | ||||
<t>IF a DNS response does not arrive within Tmax, the response time | RTDNS is undefined, and RLDNS = 1. The Message ID <bcp14>SHALL</bcp14> | |||
RTDNS is undefined, and RLDNS = 1. The Message ID SHALL be used to | be used to | |||
disambiguate the successive queries that are otherwise | disambiguate the successive queries that are otherwise | |||
identical.</t> | identical.</t> | |||
<t>Since the ID Number field is only 16 bits in length, it places a | <t>Since the ID Number field is only 16 bits in length, it places a | |||
limit on the number of simultaneous outstanding DNS queries during a | limit on the number of simultaneous outstanding DNS queries during a | |||
stress test from a single Src address.</t> | stress test from a single Src address.</t> | |||
<t>Refer to <xref target="RFC6673" sectionFormat="of" section="4.4"/> | ||||
<t>Refer to Section 4.4 of <xref target="RFC6673"/> for expanded | for an expanded | |||
discussion of the instruction to "send a Type-P packet back to the | discussion of the instruction to "send a Type-P packet back to the | |||
Src as quickly as possible" in Section 2.6 of <xref | Src as quickly as possible" in <xref target="RFC2681" sectionFormat="o | |||
target="RFC2681">RFC 2681</xref>. However, the DNS Server is | f" section="2.6"/>. However, the DNS server is | |||
expected to perform all required functions to prepare and send a | expected to perform all required functions to prepare and send a | |||
response, so the response time will include processing time and | response, so the response time will include processing time and | |||
network delay. Section 8 of <xref target="RFC6673"/> presents | network delay. <xref target="RFC6673" sectionFormat="of" section="8"/> | |||
additional requirements which SHALL be included in the method of | presents | |||
measurement for this metric.</t> | additional requirements that <bcp14>SHALL</bcp14> be included in the M | |||
ethod of | ||||
<t>In addition to operations described in <xref target="RFC2681"/>, | Measurement for this metric.</t> | |||
the Src MUST parse the DNS headers of the reply and prepare the | <t>In addition to operations described in <xref target="RFC2681" forma | |||
t="default"/>, | ||||
the Src <bcp14>MUST</bcp14> parse the DNS headers of the reply and pre | ||||
pare the | ||||
query response information for subsequent reporting as a measured | query response information for subsequent reporting as a measured | |||
result, along with the Round-Trip Delay.</t> | result, along with the round-trip delay.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Packet Stream Generation"> | <name>Packet Stream Generation</name> | |||
<t>This section gives the details of the packet traffic which is the | <t>This section provides details regarding packet traffic, which is | |||
basis for measurement. In IPPM metrics, this is called the Stream, | used as the | |||
and can easily be described by providing the list of stream | basis for measurement. In IPPM Metrics, this is called the "stream"; | |||
parameters.</t> | this stream can easily be described by providing the list of stream | |||
Parameters.</t> | ||||
<t>Section 11.1.3 of <xref target="RFC2330">RFC 2681</xref> provides | <t><xref target="RFC2330" sectionFormat="of" section="11.1.3"/> | |||
provides | ||||
three methods to generate Poisson sampling intervals. The reciprocal | three methods to generate Poisson sampling intervals. The reciprocal | |||
of lambda is the average packet spacing, thus the Run-time Parameter | of lambda is the average packet spacing; thus, the Runtime Parameter | |||
is Reciprocal_lambda = 1/lambda, in seconds.</t> | is Reciprocal_lambda = 1&wj;/lambda, in seconds.</t> | |||
<t>Method 3 <bcp14>SHALL</bcp14> be used. Where given a start time (Ru | ||||
<t>Method 3 is used, where given a start time (Run-time Parameter), | ntime Parameter), | |||
the subsequent send times are all computed prior to measurement by | the subsequent send times are all computed prior to measurement by | |||
computing the pseudo-random distribution of inter-packet send times, | computing the pseudorandom distribution of inter-packet send times | |||
(truncating the distribution as specified in the Run-time | (truncating the distribution as specified in the Parameter Trunc), | |||
Parameters), and the Src sends each packet at the computed | and the Src sends each packet at the computed times.</t> | |||
times.</t> | ||||
<t>Note that Trunc is the upper limit on inter-packet times in the | <t>Note that Trunc is the upper limit on inter-packet times in the | |||
Poisson distribution. A random value greater than Trunc is set equal | Poisson distribution. A random value greater than Trunc is set equal | |||
to Trunc instead.</t> | to Trunc instead.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Traffic Filtering (observation) Details"> | <name>Traffic Filtering (Observation) Details</name> | |||
<t>NA</t> | <t>N/A</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Sampling Distribution"> | <name>Sampling Distribution</name> | |||
<t>NA</t> | <t>N/A</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Run-time Parameters and Data Format"> | <name>Runtime Parameters and Data Format</name> | |||
<t>Run-time Parameters are input factors that must be determined, | <t>Runtime Parameters are input factors that must be determined, | |||
configured into the measurement system, and reported with the | configured into the measurement system, and reported with the | |||
results for the context to be complete.</t> | results for the context to be complete.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Src:</dt> | |||
<t hangText="Src">the IP address of the host in the Src Role | <dd>The IP address of the host in the Src Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>Dst:</dt> | ||||
<t hangText="Dst">the IP address of the host in the Dst Role | <dd>The IP address of the host in the Dst Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>T0:</dt> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dd>A time, the start of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time is unspecified and Tf is to be interpreted as the Duration | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", a start | |||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Tf:</dt> | ||||
<t hangText="Tf">a time, the end of a measurement interval, | <dd>A time, the end of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a end | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time date is ignored and Tf is interpreted as the Duration of | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", an ending | |||
the measurement interval.</t> | time and date is ignored and Tf is interpreted as the duration of | |||
the measurement interval.</dd> | ||||
<t hangText="Reciprocal_lambda">average packet interval for | <dt>Reciprocal_lambda:</dt> | |||
Poisson Streams expressed in units of seconds, as a positive | <dd>Average packet interval for | |||
value of type decimal64 with fraction digits = 4 (see section | Poisson streams, expressed in units of seconds, as a positive | |||
9.3 of <xref target="RFC6020"/>) with resolution of 0.0001 | value of type decimal64 with fraction digits = 4 (see <xref target | |||
="RFC6020" sectionFormat="of" section="9.3"/>) with a resolution of 0.0001 | ||||
seconds (0.1 ms), and with lossless conversion to/from the | seconds (0.1 ms), and with lossless conversion to/from the | |||
32-bit NTP timestamp as per section 6 of <xref | 32-bit NTP timestamp as per <xref target="RFC5905" sectionFormat=" | |||
target="RFC5905"/>.</t> | of" section="6"/>.</dd> | |||
<dt>Trunc:</dt> | ||||
<t hangText="Trunc">Upper limit on Poisson distribution | <dd>Upper limit on Poisson distribution, | |||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 4 (see section 9.3 of <xref | decimal64 with fraction digits = 4 (see <xref target="RFC6020" sec | |||
target="RFC6020"/>) with resolution of 0.0001 seconds (0.1 ms), | tionFormat="of" section="9.3"/>) with a resolution of 0.0001 seconds (0.1 ms), | |||
and with lossless conversion to/from the 32-bit NTP timestamp as | and with lossless conversion to/from the 32-bit NTP timestamp as | |||
per section 6 of <xref target="RFC5905"/> (values above this | per <xref target="RFC5905" sectionFormat="of" section="6"/> (value | |||
limit will be clipped and set to the limit value).</t> | s above this | |||
limit will be clipped and set to the limit value).</dd> | ||||
<t hangText="ID">The 16-bit identifier assigned by the program | <dt>ID:</dt> | |||
that generates the query, and which must vary in successive | <dd>The 16-bit Identifier assigned by the program | |||
queries (a list of IDs is needed), see Section 4.1.1 of <xref | that generates the query. The ID value must vary in successive | |||
target="RFC1035"/>. This identifier is copied into the | queries (a list of IDs is needed); see <xref target="RFC1035" sect | |||
ionFormat="of" section="4.1.1"/>. This Identifier is copied into the | ||||
corresponding reply and can be used by the requester (Src) to | corresponding reply and can be used by the requester (Src) to | |||
match-up replies to outstanding queries.</t> | match replies with any outstanding queries.</dd> | |||
<dt>QNAME:</dt> | ||||
<t hangText="QNAME">The domain name of the Query, formatted as | <dd>The domain name of the query, formatted as | |||
specified in section 4 of <xref target="RFC6991"/>.</t> | specified in <xref target="RFC6991" sectionFormat="of" section="4" | |||
/>.</dd> | ||||
<t hangText="QTYPE">The Query Type, which will correspond to the | <dt>QTYPE:</dt> | |||
<dd>The query type, which will correspond to the | ||||
IP address family of the query (decimal 1 for IPv4 or 28 for | IP address family of the query (decimal 1 for IPv4 or 28 for | |||
IPv6, formatted as a uint16, as per section 9.2 of <xref | IPv6), formatted as a uint16, as per <xref target="RFC6020" sectio | |||
target="RFC6020"/>.</t> | nFormat="of" section="9.2"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Roles"> | <name>Roles</name> | |||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="Src">launches each packet and waits for return | <dt>Src:</dt> | |||
transmissions from Dst.</t> | <dd>Launches each packet and waits for return | |||
transmissions from the Dst.</dd> | ||||
<t hangText="Dst">waits for each packet from Src and sends a | <dt>Dst:</dt> | |||
return packet to Src.</t> | <dd>Waits for each packet from the Src and sends a | |||
</list></t> | return packet to the Src.</dd> | |||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Output"> | <name>Output</name> | |||
<t>This category specifies all details of the Output of measurements | <t>This category specifies all details of the output of measurements | |||
using the metric.</t> | using the metric.</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Type"> | <name>Type</name> | |||
<t>Raw -- for each DNS Query packet sent, sets of values as defined | <t>Raw: For each DNS query packet sent, sets of values as defined | |||
in the next column, including the status of the response, only | in the next column, including the status of the response, only | |||
assigning delay values to successful query-response pairs.</t> | assigning delay values to successful query-response pairs.</t> | |||
</section> | </section> | |||
<section title="Reference Definition"> | <!-- 6.4.2 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Reference Definition</name> | ||||
<t>For all outputs:</t> | <t>For all outputs:</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>T:</dt> | |||
<t hangText="T">the time the DNS Query was sent during the | <dd>The time the DNS query was sent during the | |||
measurement interval, (format "date-and-time" as specified in | measurement interval (format "date&nbhy;time" as specified in | |||
Section 5.6 of <xref target="RFC3339"/>, see also Section 3 of | <xref target="RFC3339" sectionFormat="of" section="5.6"/>; see | |||
<xref target="RFC6991"/>). The UTC Time Zone is required by | also "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFo | |||
Section 6.1 of <xref target="RFC2330"/>.</t> | rmat="of" section="3"/>). The UTC Time Zone is required by | |||
<xref target="RFC2330" sectionFormat="of" section="6.1"/>.</dd> | ||||
<t hangText="dT">The time value of the round-trip delay to | <dt>dT:</dt> | |||
receive the DNS response, expressed in units of seconds, as a | <dd>The time value of the round-trip delay to | |||
receive the DNS Response, expressed in units of seconds, as a | ||||
positive value of type decimal64 with fraction digits = 9 (see | positive value of type decimal64 with fraction digits = 9 (see | |||
section 9.3 of <xref target="RFC6020"/>) with resolution of | <xref target="RFC6020" sectionFormat="of" section="9.3"/>) with a resolution of | |||
0.000000001 seconds (1.0 ns), and with lossless conversion | 0.000000001 seconds (1.0 ns), and with lossless conversion | |||
to/from the 64-bit NTP timestamp as per section 6 of <xref | to/from the 64-bit NTP timestamp as per <xref target="RFC5905" sec | |||
target="RFC5905">RFC</xref>. This value is undefined when the | tionFormat="of" section="6"/>. This value is undefined when the | |||
response packet is not received at Src within waiting time Tmax | response packet is not received at the Src within a waiting time | |||
seconds.</t> | of Tmax seconds.</dd> | |||
<dt>RCODE:</dt> | ||||
<t hangText="Rcode">The value of the Rcode field in the DNS | <dd>The value of the RCODE field in the DNS | |||
response header, expressed as a uint64 as specified in section | Response header, expressed as a uint64 as specified in <xref targe | |||
9.2 of <xref target="RFC6020"/>. Non-zero values convey errors | t="RFC6020" sectionFormat="of" section="9.2"/>. Non-zero values convey errors | |||
in the response, and such replies must be analyzed separately | in the response, and such replies must be analyzed separately | |||
from successful requests.</t> | from successful requests.</dd> | |||
</list></t> | <dt>Logical:</dt><dd>The numeric value of the result is expressed a | |||
s a Logical | ||||
value, where 1 = Lost and 0 = Received, as a positive value of | ||||
type uint8 (represents integer values between 0 and 255, inclusivel | ||||
y | ||||
(see <xref target="RFC6020" sectionFormat="of" section="9.2"/>). No | ||||
te that for queries with outcome 1 = Lost, | ||||
dT and RCODE will be set to the maximum for decimal64 and uint64, r | ||||
espectively.</dd> | ||||
</dl> | ||||
</section> | </section> | |||
<section title="Metric Units"> | <!-- 6.4.3 --> | |||
<t>RTDNS: Round-trip Delay, dT, is expressed in seconds.</t> | <section numbered="true" toc="default"> | |||
<name>Metric Units</name> | ||||
<t>RTLDNS: the Logical value, where 1 = Lost and 0 = Received.</t> | <dl newline="false" spacing="normal"> | |||
<dt>RTDNS:</dt><dd>Round-trip delay, dT, is expressed in seconds.</dd> | ||||
<dt>RLDNS:</dt><dd>The Logical value, where 1 = Lost and 0 = | ||||
Received.</dd> | ||||
</dl> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Calibration"> | <name>Calibration</name> | |||
<t>Section 3.7.3 of <xref target="RFC7679"/> provides a means to | <t><xref target="RFC7679" sectionFormat="of" section="3.7.3"/> provide | |||
s a means to | ||||
quantify the systematic and random errors of a time measurement. | quantify the systematic and random errors of a time measurement. | |||
In-situ calibration could be enabled with an internal loopback at | Calibration in-situ could be enabled with an internal loopback at | |||
the Source host that includes as much of the measurement system as | the Source host that includes as much of the measurement system as | |||
possible, performs address and payload manipulation as needed, and | possible, performs address and payload manipulation as needed, and | |||
provides some form of isolation (e.g., deterministic delay) to avoid | provides some form of isolation (e.g., deterministic delay) to avoid | |||
send-receive interface contention. Some portion of the random and | send-receive interface contention. Some portion of the random and | |||
systematic error can be characterized this way.</t> | systematic error can be characterized in this way.</t> | |||
<t>When a measurement controller requests a calibration measurement, | <t>When a measurement controller requests a calibration measurement, | |||
the loopback is applied and the result is output in the same format | the loopback is applied and the result is output in the same format | |||
as a normal measurement with additional indication that it is a | as a normal measurement, with an additional indication that it is a | |||
calibration result.</t> | calibration result.</t> | |||
<t>Both internal loopback calibration and clock synchronization can | <t>Both internal loopback calibration and clock synchronization can | |||
be used to estimate the available accuracy of the Output Metric | be used to estimate the available accuracy of the Output Metric | |||
Units. For example, repeated loopback delay measurements will reveal | Units. For example, repeated loopback delay measurements will reveal | |||
the portion of the Output result resolution which is the result of | the portion of the output result resolution that is the result of | |||
system noise, and thus inaccurate.</t> | system noise and is thus inaccurate.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Administrative items"> | <name>Administrative Items</name> | |||
<t/> | <section numbered="true" toc="default"> | |||
<name>Status</name> | ||||
<section title="Status"> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Requester"> | <name>Requester</name> | |||
<t>This RFC number</t> | <t>RFC 8912</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision"> | <name>Revision</name> | |||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision Date"> | <name>Revision Date</name> | |||
<t>YYYY-MM-DD</t> | <t>2021-11-17</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Comments and Remarks"> | <name>Comments and Remarks</name> | |||
<t>None</t> | <t>None</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<!-- Section 7 --> | ||||
<section anchor="udp-poisson-owd-owl-reg" numbered="true" toc="default"> | ||||
<name>UDP Poisson One-Way Delay and Loss Registry Entries</name> | ||||
<t>This section specifies five initial Registry Entries for UDP | ||||
Poisson One-Way Delay and one entry for UDP Poisson One-Way Loss.</t> | ||||
<section title="UDP Poisson One-way Delay and Loss Registry Entries"> | <t>All column entries besides the ID, Name, Description, and Output | |||
<t>This section specifies five initial registry entries for the UDP | Reference Method categories are the same; thus, this section defines six | |||
Poisson One-way Delay, and one for UDP Poisson One-way Loss.</t> | closely related Registry Entries. As a result, IANA has | |||
assigned corresponding URLs to each of the Named Metrics.</t> | ||||
<t>IANA Note: Registry "Name" below specifies multiple registry entries, | <section numbered="true" toc="default"> | |||
whose output format varies according to the <statistic> element of | <!-- section 7 --> | |||
the name that specifies one form of statistical summary. There is an | <name>Summary</name> | |||
additional metric name for the Loss metric.</t> | <t>This category includes multiple indexes to the Registry Entries: | |||
the element ID and Metric Name.</t> | ||||
<t>All column entries beside the ID, Name, Description, and Output | <section numbered="true" toc="default"> | |||
Reference Method categories are the same, thus this section proposes six | <!-- section 7.1.1 --> | |||
closely-related registry entries. As a result, IANA is also asked to | <name>ID (Identifier)</name> | |||
assign corresponding URLs to each Named Metric.</t> | <t>IANA has allocated the numeric Identifiers 6-11 for the six | |||
Named Metric Entries in <xref target="udp-poisson-owd-owl-reg"/>. See <xref | ||||
<section title="Summary"> | target="name712"/> for mapping to Names.</t> | |||
<t>This category includes multiple indexes to the registry entries, | ||||
the element ID and metric name.</t> | ||||
<section title="ID (Identifier)"> | ||||
<t>IANA is asked to assign different numeric identifiers to each of | ||||
the six Metrics.</t> | ||||
</section> | </section> | |||
<!-- section 7.1.2 --> | ||||
<section anchor="name712" numbered="true" toc="default"> | ||||
<name>Name</name> | ||||
<dl spacing="normal" newline="false" indent="5"> | ||||
<dt>6:</dt><dd>OWDelay_Active_IP-UDP-Poisson-Payload250B_RFC8 | ||||
912sec7_Seconds_95Percentile</dd> | ||||
<dt>7:</dt><dd>OWDelay_Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Seco | ||||
nds_Mean</dd> | ||||
<dt>8:</dt><dd>OWDelay_Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_ | ||||
Seconds_Min</dd> | ||||
<dt>9:</dt><dd>OWDelay_Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_ | ||||
Seconds_Max</dd> | ||||
<dt>10:</dt><dd>OWDelay_Active_IP-UDP-Poisson-Payload250B_RFC8912sec7 | ||||
_Seconds_StdDev</dd> | ||||
<dt>11:</dt><dd>OWLoss_Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_ | ||||
Percent_LossRatio</dd> | ||||
</dl> | ||||
<section title="Name"> | ||||
<t>OWDelay_Active_IP-UDP-Poisson-Payload250B_RFCXXXXsec7_Seconds_<s | ||||
tatistic></t> | ||||
<t>where <statistic> is one of:</t> | ||||
<t><list style="symbols"> | ||||
<t>95Percentile</t> | ||||
<t>Mean</t> | ||||
<t>Min</t> | ||||
<t>Max</t> | ||||
<t>StdDev</t> | ||||
</list></t> | ||||
<t>OWLoss_Active_IP-UDP-Poisson-Payload250B_RFCXXXXsec7_Percent_LossRa | ||||
tio</t> | ||||
</section> | </section> | |||
<!-- section 7.1.3 --> | ||||
<section title="URI"> | <section numbered="true" toc="default"> | |||
<t>URL: https://www.iana.org/ ... <name></t> | <name>URI</name> | |||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay | ||||
_Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Seconds_95Percentile" /></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Seconds_Mean"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Seconds_Min"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Seconds_Max"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Seconds_StdDev"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWLoss_ | ||||
Active_IP-UDP-Poisson-Payload250B_RFC8912sec7_Percent_LossRatio"/></t> | ||||
</section> | </section> | |||
<section title="Description"> | <!-- section 7.1.4 --> | |||
<t>OWDelay: This metric assesses the delay of a stream of packets | <section numbered="true" toc="default"> | |||
exchanged between two hosts (or measurement points), and reports the | <name>Description</name> | |||
<statistic> One-way delay for all successfully exchanged | <dl newline="false" spacing="normal"> | |||
<dt>OWDelay:</dt><dd><t>This metric assesses the delay of a stream of | ||||
packets | ||||
exchanged between two hosts (or measurement points) and reports the | ||||
<statistic> of one-way delay for all successfully exchanged | ||||
packets based on their conditional delay distribution.</t> | packets based on their conditional delay distribution.</t> | |||
<t>where <statistic> is one of:</t> | <t>where <statistic> is one of:</t> | |||
<ul spacing="normal"> | ||||
<li>95Percentile</li> | ||||
<li>Mean</li> | ||||
<li>Min</li> | ||||
<li>Max</li> | ||||
<li>StdDev</li> | ||||
</ul> | ||||
</dd> | ||||
<dt>OWLoss:</dt><dd>This metric assesses the loss ratio of a stream of | ||||
packets exchanged between two hosts (which are the two measurement | ||||
points). The output is the one-way loss ratio for all | ||||
transmitted packets expressed as a percentage.</dd> | ||||
</dl> | ||||
</section> | ||||
<t><list style="symbols"> | <!-- section 7.1.5 --> | |||
<t>95Percentile</t> | <section numbered="true" toc="default"> | |||
<name>Change Controller</name> | ||||
<t>Mean</t> | <t>IETF</t> | |||
</section> | ||||
<t>Min</t> | ||||
<t>Max</t> | ||||
<t>StdDev</t> | ||||
</list></t> | ||||
<t>OWLoss: This metric assesses the loss ratio of a stream of | <!-- section 7.1.6 --> | |||
packets exchanged between two hosts (which are the two measurement | <section numbered="true" toc="default"> | |||
points), and the Output is the One-way loss ratio for all | <name>Version (of Registry Format)</name> | |||
successfully received packets expressed as a percentage.</t> | <t>1.0</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section title="Metric Definition"> | <!-- section 7.2 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Metric Definition</name> | ||||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section title="Reference Definition"> | ||||
<t>For Delay:</t> | ||||
<t>Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, Ed., "A | ||||
One-Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC | ||||
7679, DOI 10.17487/RFC7679, January 2016, | ||||
<http://www.rfc-editor.org/info/rfc7679>.</t> | ||||
<t><xref target="RFC7679"/></t> | ||||
<t>Morton, A., and Stephan, E., "Spatial Composition of Metrics", | ||||
RFC 6049, January 2011.</t> | ||||
<t><xref target="RFC6049"/></t> | ||||
<t>Section 3.4 of <xref target="RFC7679"/> provides the reference | <!-- section 7.2.1 --> | |||
definition of the singleton (single value) One-way delay metric. | <section numbered="true" toc="default"> | |||
Section 4.4 of <xref target="RFC7679"/> provides the reference | <name>Reference Definition</name> | |||
<t>For delay:</t> | ||||
<t indent="3">Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, | ||||
Ed., "A | ||||
One-Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC | ||||
7679, DOI 10.17487/RFC7679, January 2016, | ||||
<https://www.rfc-editor.org/info/rfc7679>. | ||||
<xref target="RFC7679"/></t> | ||||
<t indent="3">Morton, A. and E. Stephan, "Spatial Composition of Metri | ||||
cs", RFC | ||||
6049, DOI 10.17487/RFC6049, January 2011, | ||||
<https://www.rfc-editor.org/info/rfc6049>. | ||||
<xref target="RFC6049"/></t> | ||||
<t indent="3"><xref target="RFC7679" sectionFormat="of" section="3.4"/ | ||||
> provides the reference | ||||
definition of the singleton (single value) one-way delay metric. | ||||
<xref target="RFC7679" sectionFormat="of" section="4.4"/> provides the | ||||
reference | ||||
definition expanded to cover a multi-value sample. Note that terms | definition expanded to cover a multi-value sample. Note that terms | |||
such as singleton and sample are defined in Section 11 of <xref | such as "singleton" and "sample" are defined in <xref target="RFC2330" | |||
target="RFC2330"/>.</t> | sectionFormat="of" section="11"/>.</t> | |||
<t indent="3">Only successful packet transfers with finite delay are i | ||||
<t>Only successful packet transfers with finite delay are included | ncluded | |||
in the sample, as prescribed in section 4.1.2 of <xref | in the sample, as prescribed in <xref target="RFC6049" sectionFormat=" | |||
target="RFC6049"/>.</t> | of" section="4.1.2"/>.</t> | |||
<t>For loss:</t> | <t>For loss:</t> | |||
<t indent="3">Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, | ||||
<t>Almes, G., Kalidini, S., Zekauskas, M., and A. Morton, Ed., "A | Ed., "A | |||
One-Way Loss Metric for IP Performance Metrics (IPPM)", RFC 7680, | One-Way Loss Metric for IP Performance Metrics (IPPM)", STD 82, RFC | |||
DOI 10.17487/RFC7680, January 2016, | 7680, DOI 10.17487/RFC7680, January 2016, | |||
<http://www.rfc-editor.org/info/rfc7680>.</t> | <https://www.rfc-editor.org/info/rfc7680>. | |||
<xref target="RFC7680"/></t> | ||||
<t>Section 2.4 of <xref target="RFC7680"/> provides the reference | <t indent="3"><xref target="RFC7680" sectionFormat="of" section="2.4"/ | |||
definition of the singleton (single value) one-way loss metric. | > provides the reference | |||
Section 3.4 of <xref target="RFC7680"/> provides the reference | definition of the singleton (single value) one-way Loss metric. | |||
<xref target="RFC7680" sectionFormat="of" section="3.4"/> provides the | ||||
reference | ||||
definition expanded to cover a multi-singleton sample. Note that | definition expanded to cover a multi-singleton sample. Note that | |||
terms such as singleton and sample are defined in Section 11 of | terms such as "singleton" and "sample" are defined in <xref target="RF | |||
<xref target="RFC2330"/>.</t> | C2330" sectionFormat="of" section="11"/>.</t> | |||
</section> | </section> | |||
<section title="Fixed Parameters"> | <!-- section 7.2.2 --> | |||
<t>Type-P:<list style="symbols"> | <section numbered="true" toc="default"> | |||
<t>IPv4 header values: <list style="symbols"> | <name>Fixed Parameters</name> | |||
<t>DSCP: set to 0</t> | <dl newline="true" spacing ="normal"> | |||
<dt>Type-P:</dt> | ||||
<t>TTL: set to 255</t> | <dd><t/> | |||
<dl newline="true" spacing="normal"> | ||||
<t>Protocol: Set to 17 (UDP)</t> | <dt>IPv4 header values:</dt> | |||
</list></t> | <dd><t/> | |||
<dl newline="false" spacing="compact"> | ||||
<t>IPv6 header values:<list style="symbols"> | <dt>DSCP:</dt><dd>Set to 0</dd> | |||
<t>DSCP: set to 0</t> | <dt>TTL:</dt><dd>Set to 255</dd> | |||
<dt>Protocol:</dt><dd>Set to 17 (UDP)</dd> | ||||
<t>Hop Count: set to 255</t> | </dl> | |||
</dd> | ||||
<t>Next Header: set to 17 (UDP)</t> | </dl> | |||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>UDP header values: <list style="symbols"> | ||||
<t>Checksum: the checksum MUST be calculated and the | ||||
non-zero checksum included in the header</t> | ||||
</list></t> | ||||
<t>UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of | <dl newline="true" spacing="normal"> | |||
<xref target="RFC5357"/> <list style="symbols"> | <dt>IPv6 header values:</dt> | |||
<t>Security features in use influence the number of Padding | <dd><t/> | |||
octets.</t> | <dl newline="false" spacing="compact"> | |||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>Hop Count:</dt><dd>Set to 255</dd> | ||||
<dt>Next Header:</dt><dd>Set to 17 (UDP)</dd> | ||||
<dt>Flow Label:</dt><dd> Set to 0</dd> | ||||
<dt>Extension Headers:</dt><dd>None</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>250 octets total, including the TWAMP format type, which | <dl newline="true" spacing="normal"> | |||
MUST be reported.</t> | <dt>UDP header values:</dt> | |||
</list></t> | <dd><t/> | |||
</list></t> | <dl newline="false" spacing="compact"> | |||
<dt>Checksum:</dt><dd>The checksum <bcp14>MUST</bcp14> be calcul | ||||
ated and the | ||||
non-zero checksum included in the header</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>Other measurement parameters:</t> | <dl newline="false" spacing="normal"> | |||
<dt>UDP Payload:</dt><dd><t>TWAMP-Test packet formats (<xref targe | ||||
t="RFC5357" | ||||
sectionFormat="of" section="4.1.2"/>)</t> | ||||
<ul empty="true"> | ||||
<li>Security features in use influence the number of Padding | ||||
octets</li> | ||||
<li>250 octets total, including the TWAMP format type, which | ||||
<bcp14>MUST</bcp14> be reported</li> | ||||
</ul> | ||||
</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t><list style="hanging"> | <dl newline="true" spacing="normal"> | |||
<t hangText="Tmax:">a loss threshold waiting time with value | <dt>Other measurement Parameters:</dt> | |||
<dd><t/> | ||||
<dl newline="false" spacing="normal"> | ||||
<dt>Tmax:</dt> | ||||
<dd>A loss threshold waiting time with value | ||||
3.0, expressed in units of seconds, as a positive value of type | 3.0, expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 4 (see section 9.3 of <xref | decimal64 with fraction digits = 4 (see <xref target="RFC6020" sec | |||
target="RFC6020"/>) and with resolution of 0.0001 seconds (0.1 | tionFormat="of" section="9.3"/>) and with a resolution of 0.0001 seconds (0.1 | |||
ms), with lossless conversion to/from the 32-bit NTP timestamp | ms), with lossless conversion to/from the 32-bit NTP timestamp | |||
as per section 6 of <xref target="RFC5905"/>.</t> | as per <xref target="RFC5905" sectionFormat="of" section="6"/>.</d | |||
</list></t> | d> | |||
</dl> | ||||
<t>See the Packet Stream generation category for two additional | </dd> | |||
</dl> | ||||
<t>See the Packet Stream Generation section for two additional | ||||
Fixed Parameters.</t> | Fixed Parameters.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section title="Method of Measurement"> | <!-- section 7.3 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Method of Measurement</name> | ||||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<section title="Reference Method"> | ||||
<t>The methodology for this metric is defined as | ||||
Type-P-One-way-Delay-Poisson-Stream in section 3.6 of <xref | ||||
target="RFC7679"/> and section 4.6 of <xref target="RFC7679"/> using | ||||
the Type-P and Tmax defined under Fixed Parameters.</t> | ||||
<!-- section 7.3.1 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Reference Methods</name> | ||||
<t>The methodology for this metric (equivalent to | ||||
Type-P-One-way-Delay-Poisson-Stream) is defined as in <xref target="RF | ||||
C7679" | ||||
sectionFormat="of" section="3.6"/> (for singletons) and <xref | ||||
target="RFC7679" sectionFormat="of" section="4.6"/> (for samples) usin | ||||
g | ||||
the Type-P and Tmax defined in the Fixed Parameters column.</t> | ||||
<t>The reference method distinguishes between long-delayed packets | <t>The reference method distinguishes between long-delayed packets | |||
and lost packets by implementing a maximum waiting time for packet | and lost packets by implementing a maximum waiting time for packet | |||
arrival. Tmax is the waiting time used as the threshold to declare a | arrival. Tmax is the waiting time used as the threshold to declare a | |||
packet lost. Lost packets SHALL be designated as having undefined | packet lost. Lost packets <bcp14>SHALL</bcp14> be designated as having | |||
delay, and counted for the OWLoss metric.</t> | undefined | |||
delay and counted for the OWLoss metric.</t> | ||||
<t>The calculations on the one-way delay SHALL be performed on the | <t>The calculations on the one-way delay <bcp14>SHALL</bcp14> be perfo | |||
rmed on the | ||||
conditional distribution, conditioned on successful packet arrival | conditional distribution, conditioned on successful packet arrival | |||
within Tmax. Also, when all packet delays are stored, the process | within Tmax. Also, when all packet delays are stored, the process | |||
which calculates the one-way delay value MUST enforce the Tmax | that calculates the one-way delay value <bcp14>MUST</bcp14> enforce th | |||
threshold on stored values before calculations. See section 4.1 of | e Tmax | |||
<xref target="RFC3393"/> for details on the conditional distribution | threshold on stored values before calculations. See <xref target="RFC3 | |||
to exclude undefined values of delay, and Section 5 of <xref | 393" sectionFormat="of" section="4.1"/> for details on the conditional distribut | |||
target="RFC6703"/> for background on this analysis choice.</t> | ion | |||
to exclude undefined values of delay, and see <xref target="RFC6703" s | ||||
ectionFormat="of" section="5"/> for background on this analysis choice.</t> | ||||
<t>The reference method requires some way to distinguish between | <t>The reference method requires some way to distinguish between | |||
different packets in a stream to establish correspondence between | different packets in a stream to establish correspondence between | |||
sending times and receiving times for each successfully-arriving | sending times and receiving times for each successfully arriving | |||
packet.</t> | packet.</t> | |||
<t>Since a standard measurement protocol is employed <xref target="RFC | ||||
<t>Since a standard measurement protocol is employed <xref | 5357" format="default"/>, the measurement process will determine the | |||
target="RFC5357"/>, then the measurement process will determine the | ||||
sequence numbers or timestamps applied to test packets after the | sequence numbers or timestamps applied to test packets after the | |||
Fixed and Runtime parameters are passed to that process. The | Fixed and Runtime Parameters are passed to that process. The | |||
measurement protocol dictates the format of sequence numbers and | measurement protocol dictates the format of sequence numbers and | |||
time-stamps conveyed in the TWAMP-Test packet payload.</t> | timestamps conveyed in the TWAMP-Test packet payload.</t> | |||
</section> | </section> | |||
<section title="Packet Stream Generation"> | <!-- section 7.3.2 --> | |||
<t>This section gives the details of the packet traffic which is the | <section numbered="true" toc="default"> | |||
basis for measurement. In IPPM metrics, this is called the Stream, | <name>Packet Stream Generation</name> | |||
and can easily be described by providing the list of stream | <t>This section provides details regarding packet traffic, which is | |||
parameters.</t> | used as the | |||
basis for measurement. In IPPM Metrics, this is called the "stream"; | ||||
<t>Section 11.1.3 of <xref target="RFC2330">RFC 2681</xref> provides | this stream can easily be described by providing the list of stream | |||
Parameters.</t> | ||||
<t><xref target="RFC2330" sectionFormat="of" section="11.1.3"/> | ||||
provides | ||||
three methods to generate Poisson sampling intervals. The reciprocal | three methods to generate Poisson sampling intervals. The reciprocal | |||
of lambda is the average packet spacing, thus the Run-time Parameter | of lambda is the average packet spacing; thus, the Runtime Parameter | |||
is Reciprocal_lambda = 1/lambda, in seconds.</t> | is Reciprocal_lambda = 1&wj;/lambda, in seconds.</t> | |||
<t>Method 3 <bcp14>SHALL</bcp14> be used. Where given a start time (Ru | ||||
<t>Method 3 SHALL be used, where given a start time (Run-time | ntime | |||
Parameter), the subsequent send times are all computed prior to | Parameter), the subsequent send times are all computed prior to | |||
measurement by computing the pseudo-random distribution of | measurement by computing the pseudorandom distribution of | |||
inter-packet send times, (truncating the distribution as specified | inter-packet send times (truncating the distribution as specified | |||
in the Parameter Trunc), and the Src sends each packet at the | in the Parameter Trunc), and the Src sends each packet at the | |||
computed times.</t> | computed times.</t> | |||
<t>Note that Trunc is the upper limit on inter-packet times in the | <t>Note that Trunc is the upper limit on inter-packet times in the | |||
Poisson distribution. A random value greater than Trunc is set equal | Poisson distribution. A random value greater than Trunc is set equal | |||
to Trunc instead.</t> | to Trunc instead.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Reciprocal_lambda:</dt> | |||
<t hangText="Reciprocal_lambda">average packet interval for | <dd>Average packet interval for | |||
Poisson Streams expressed in units of seconds, as a positive | Poisson streams, expressed in units of seconds, as a positive | |||
value of type decimal64 with fraction digits = 4 (see section | value of type decimal64 with fraction digits = 4 (see <xref target | |||
9.3 of <xref target="RFC6020"/>) with resolution of 0.0001 | ="RFC6020" sectionFormat="of" section="9.3"/>) with a resolution of 0.0001 | |||
seconds (0.1 ms), and with lossless conversion to/from the | seconds (0.1 ms), and with lossless conversion to/from the | |||
32-bit NTP timestamp as per section 6 of <xref | 32-bit NTP timestamp as per <xref target="RFC5905" sectionFormat=" | |||
target="RFC5905"/>. Reciprocal_lambda = 1 second.</t> | of" section="6"/>. Reciprocal_lambda = 1 second.</dd> | |||
<dt>Trunc:</dt> | ||||
<t hangText="Trunc">Upper limit on Poisson distribution | <dd>Upper limit on Poisson distribution, | |||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 4 (see section 9.3 of <xref | decimal64 with fraction digits = 4 (see <xref target="RFC6020" sec | |||
target="RFC6020"/>) with resolution of 0.0001 seconds (0.1 ms), | tionFormat="of" section="9.3"/>) with a resolution of 0.0001 seconds (0.1 ms), | |||
and with lossless conversion to/from the 32-bit NTP timestamp as | and with lossless conversion to/from the 32-bit NTP timestamp as | |||
per section 6 of <xref target="RFC5905"/> (values above this | per <xref target="RFC5905" sectionFormat="of" section="6"/> (value | |||
limit will be clipped and set to the limit value). Trunc = | s above this | |||
30.0000 seconds.</t> | limit will be clipped and set to the limit value). | |||
</list></t> | Trunc = 30.0000 seconds.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<!-- section 7.3.3 --> | ||||
<section title="Traffic Filtering (observation) Details"> | <section numbered="true" toc="default"> | |||
<t>NA</t> | <name>Traffic Filtering (Observation) Details</name> | |||
<t>N/A</t> | ||||
</section> | </section> | |||
<section title="Sampling Distribution"> | <!-- section 7.3.4 --> | |||
<t>NA</t> | <section numbered="true" toc="default"> | |||
<name>Sampling Distribution</name> | ||||
<t>N/A</t> | ||||
</section> | </section> | |||
<section title="Run-time Parameters and Data Format"> | <!-- section 7.3.5 --> | |||
<t>Run-time Parameters are input factors that must be determined, | <section numbered="true" toc="default"> | |||
<name>Runtime Parameters and Data Format</name> | ||||
<t>Runtime Parameters are input factors that must be determined, | ||||
configured into the measurement system, and reported with the | configured into the measurement system, and reported with the | |||
results for the context to be complete.</t> | results for the context to be complete.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Src:</dt> | |||
<t hangText="Src">the IP address of the host in the Src Role | <dd>The IP address of the host in the Src Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>Dst:</dt> | ||||
<t hangText="Dst">the IP address of the host in the Dst Role | <dd>The IP address of the host in the Dst Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>T0:</dt> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dd>A time, the start of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time is unspecified and Tf is to be interpreted as the Duration | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", a start | |||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Tf:</dt> | ||||
<t hangText="Tf">a time, the end of a measurement interval, | <dd>A time, the end of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a end | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time date is ignored and Tf is interpreted as the Duration of | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", an ending | |||
the measurement interval.</t> | time and date is ignored and Tf is interpreted as the duration of | |||
</list></t> | the measurement interval.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<section title="Roles"> | <!-- section 7.3.6 --> | |||
<t><list style="hanging"> | <section numbered="true" toc="default"> | |||
<t hangText="Src">launches each packet and waits for return | <name>Roles</name> | |||
transmissions from Dst. This is the TWAMP Session-Sender.</t> | <dl newline="false" spacing="normal"> | |||
<dt>Src:</dt> | ||||
<t hangText="Dst">waits for each packet from Src and sends a | <!-- updated - 7.3.6 --> | |||
return packet to Src. This is the TWAMP Session-Reflector.</t> | <dd>Launches each packet and waits for return transmissions from the | |||
</list></t> | Dst. An example is the TWAMP Session-Sender.</dd> | |||
<dt>Dst:</dt> | ||||
<dd>Waits for each packet from the Src and sends a return packet to | ||||
the Src. An example is the TWAMP Session-Reflector.</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section title="Output"> | <!-- section 7.4 --> | |||
<t>This category specifies all details of the Output of measurements | <section numbered="true" toc="default"> | |||
<name>Output</name> | ||||
<t>This category specifies all details of the output of measurements | ||||
using the metric.</t> | using the metric.</t> | |||
<section title="Type"> | <!-- section 7.4.1 --> | |||
<t>See subsection titles below for Types.</t> | <section numbered="true" toc="default"> | |||
<name>Type</name> | ||||
<t>Types are discussed in the subsections below.</t> | ||||
</section> | </section> | |||
<section title="Reference Definition"> | <!-- section 7.4.2 --> | |||
<t>For all output types ---<list style="hanging"> | <section numbered="true" toc="default"> | |||
<t hangText="T0">the start of a measurement interval, (format | <name>Reference Definition</name> | |||
"date-and-time" as specified in Section 5.6 of <xref | <t>For all output types:</t> | |||
target="RFC3339"/>, see also Section 3 of <xref | <dl newline="false" spacing="normal"> | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | <dt>T0:</dt> | |||
6.1 of <xref target="RFC2330"/>.</t> | <dd>The start of a measurement interval (format | |||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
<t hangText="Tf">the end of a measurement interval, (format | sectionFormat="of" section="5.6"/>; see also | |||
"date-and-time" as specified in Section 5.6 of <xref | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
target="RFC3339"/>, see also Section 3 of <xref | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | tionFormat="of" section="6.1"/>.</dd> | |||
6.1 of <xref target="RFC2330"/>.</t> | <dt>Tf:</dt> | |||
</list></t> | <dd>The end of a measurement interval (format | |||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
<t>For LossRatio -- the count of lost packets to total packets sent | sectionFormat="of" section="5.6"/>; see also | |||
is the basis for the loss ratio calculation as per Section 4.1 of | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
<xref target="RFC7680"/>.</t> | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
tionFormat="of" section="6.1"/>.</dd> | ||||
<t>For each <statistic>, one of the following sub-sections | </dl> | |||
apply:</t> | <t>For LossRatio, the count of lost packets to total packets sent | |||
is the basis for the loss ratio calculation as per <xref target="RFC76 | ||||
<section title="Percentile95"> | 80" sectionFormat="of" section="4.1"/>.</t> | |||
<t>The 95th percentile SHALL be calculated using the conditional | <t>For each <statistic> or Percent_LossRatio, one of the followi | |||
distribution of all packets with a finite value of One-way delay | ng subsections | |||
(undefined delays are excluded), a single value as follows:</t> | applies.</t> | |||
<!-- section 7.4.2.1 --> | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | <section numbered="true" toc="default"> | |||
<name>Percentile95</name> | ||||
<t>The 95th percentile <bcp14>SHALL</bcp14> be calculated using the | ||||
conditional | ||||
distribution of all packets with a finite value of one-way delay | ||||
(undefined delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.3"/> for | ||||
<t>See section 4.3 of <xref target="RFC3393"/> for details on the | details on the | |||
percentile statistic (where Round-trip delay should be substituted | percentile statistic (where round-trip delay should be substituted | |||
for "ipdv").</t> | for "ipdv").</t> | |||
<t>The percentile = 95, meaning that the reported delay, | <t>The percentile = 95, meaning that the reported delay, | |||
"95Percentile", is the smallest value of one-way delay for which | "95Percentile", is the smallest value of one-way delay for which | |||
the Empirical Distribution Function (EDF), F(95Percentile) >= | the Empirical Distribution Function, EDF(95Percentile), is greater | |||
95% of the singleton one-way delay values in the conditional | than or equal to 95% of the singleton one-way delay values in the con | |||
distribution. See section 11.3 of <xref target="RFC2330"/> for the | ditional | |||
distribution. See <xref target="RFC2330" sectionFormat="of" section= | ||||
"11.3"/> for the | ||||
definition of the percentile statistic using the EDF.</t> | definition of the percentile statistic using the EDF.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>95Percentile:</dt> | |||
<t hangText="95Percentile">The time value of the result is | <dd>The time value of the result is | |||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RFC6020" s | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | ectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<!-- section 7.4.2.2 --> | ||||
<section title="Mean"> | <section anchor="mean-sec7422" numbered="true" toc="default"> | |||
<t>The mean SHALL be calculated using the conditional distribution | <name>Mean</name> | |||
of all packets with a finite value of One-way delay (undefined | <t>The mean <bcp14>SHALL</bcp14> be calculated using the conditional | |||
delays are excluded), a single value as follows:</t> | distribution | |||
of all packets with a finite value of one-way delay (undefined | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | delays are excluded) -- a single value, as follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.2.2"/> f | ||||
<t>See section 4.2.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.2.3 of <xref | calculating this statistic; see also <xref target="RFC6049" | |||
target="RFC6049"/>.</t> | sectionFormat="of" section="4.2.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Mean:</dt> | |||
<t hangText="Mean">The time value of the result is expressed | <dd>The time value of the result is expressed | |||
in units of seconds, as a positive value of type decimal64 | in units of seconds, as a positive value of type decimal64 | |||
with fraction digits = 9 (see section 9.3 of <xref | with fraction digits = 9 (see <xref target="RFC6020" sectionForm | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | at="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Min"> | <!-- section 7.4.2.3 --> | |||
<t>The minimum SHALL be calculated using the conditional | <section numbered="true" toc="default"> | |||
distribution of all packets with a finite value of One-way delay | <name>Min</name> | |||
(undefined delays are excluded), a single value as follows:</t> | <t>The minimum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
nal | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | distribution of all packets with a finite value of one-way delay | |||
(undefined delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.3.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.3.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Min:</dt> | |||
<t hangText="Min">The time value of the result is expressed in | <dd>The time value of the result is expressed in | |||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Max"> | <!-- section 7.4.2.4 --> | |||
<t>The maximum SHALL be calculated using the conditional | <section numbered="true" toc="default"> | |||
distribution of all packets with a finite value of One-way delay | <name>Max</name> | |||
(undefined delays are excluded), a single value as follows:</t> | <t>The maximum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
nal | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | distribution of all packets with a finite value of one-way delay | |||
(undefined delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
or a closely | ||||
related method for calculating this statistic; see also <xref target | ||||
="RFC6049" sectionFormat="of" section="4.3.3"/>. The formula is as follows:</t> | ||||
<artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
Max = (FiniteDelay[j]) | ||||
]]></artwork> | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for a closely | <ul empty="true"> | |||
related method for calculating this statistic, and 4.3.3 of <xref | <li>such that for some index, j, where 1 <= j <= N | |||
target="RFC6049"/>. The formula is as follows:</t> | FiniteDelay[j] >= FiniteDelay[n] for all n</li> | |||
</ul> | ||||
<t><figure> | <dl newline="false" spacing="normal"> | |||
<artwork><![CDATA[ Max = (FiniteDelay [j]) | <dt>Max:</dt> | |||
<dd>The time value of the result is expressed in | ||||
such that for some index, j, where 1 <= j <= N | ||||
FiniteDelay[j] >= FiniteDelay[n] for all n]]></artwork> | ||||
</figure></t> | ||||
<t><list style="hanging"> | ||||
<t hangText="Max">The time value of the result is expressed in | ||||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Std_Dev"> | <!-- section 7.4.2.5 --> | |||
<t>The Std_Dev SHALL be calculated using the conditional | <section numbered="true" toc="default"> | |||
distribution of all packets with a finite value of One-way delay | <name>Std_Dev</name> | |||
(undefined delays are excluded), a single value as follows:</t> | <t>The standard deviation (Std_Dev) <bcp14>SHALL</bcp14> be calculat | |||
ed using the conditional | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | distribution of all packets with a finite value of one&nbhy;way dela | |||
y | ||||
(undefined delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="6.1.4"/> f | ||||
<t>See section 6.1.4 of <xref target="RFC6049"/> for a closely | or a closely | |||
related method for calculating this statistic. The formula is the | related method for calculating this statistic. The formula is the | |||
classic calculation for standard deviation of a population.<figure> | classic calculation for the standard deviation of a population.</t> | |||
<artwork><![CDATA[Define Population Std_Dev_Delay as follows: | ||||
(where all packets n = 1 through N have a value for Delay[n], | ||||
and MeanDelay calculated as in 7.4.2.2), and SQRT[] is the | ||||
Square Root function: | ||||
_ _ | ||||
| N | | ||||
| --- | | ||||
| 1 \ 2 | | ||||
Std_Dev = SQRT | ------- > (Delay[n] - MeanDelay) | | ||||
| (N) / | | ||||
| --- | | ||||
| n = 1 | | ||||
|_ _| | ||||
]]></artwork> | ||||
</figure></t> | ||||
<t><list style="hanging"> | <t>Define Population Std_Dev_Delay as follows:</t> | |||
<t hangText="Std_Dev">The time value of the result is | ||||
<artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
_ _ | ||||
| N | | ||||
| --- | | ||||
| 1 \ 2 | | ||||
Std_Dev = SQRT | ------- > (Delay[n] - MeanDelay) | | ||||
| (N) / | | ||||
| --- | | ||||
| n = 1 | | ||||
|_ _| | ||||
]]></artwork> | ||||
<t>where all packets n = 1 through N have a value for Delay[n], | ||||
MeanDelay is calculated per <xref target="mean-sec7422"/>, | ||||
and SQRT[] is the Square Root function:</t> | ||||
<dl newline="false" spacing="normal"> | ||||
<dt>Std_Dev:</dt> | ||||
<dd>The time value of the result is | ||||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RFC6020" s | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | ectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<!-- 7.4.2.6 --> | ||||
<section> | ||||
<name>Percent_LossRatio</name> | ||||
<dl> | ||||
<dt>Percent_LossRatio:</dt><dd>The numeric value of the result is | ||||
expressed in units of lost packets to total packets times 100%, as | ||||
a positive value of type decimal64 with fraction digits = 9 (see | ||||
<xref target="RFC6020" sectionFormat="of" section="9.3"/>) with a | ||||
resolution of 0.0000000001.</dd></dl> | ||||
</section> | </section> | |||
</section> | ||||
<section title="Metric Units"> | <!-- section 7.4.3 --> | |||
<t>The <statistic> of One-way Delay is expressed in | <section numbered="true" toc="default"> | |||
seconds.</t> | <name>Metric Units</name> | |||
<t>The <statistic> of one-way delay is expressed in | ||||
<t>The One-way Loss Ratio is expressed as a percentage of lost | seconds, where <statistic> is one of:</t> | |||
<ul> | ||||
<li>95Percentile</li> | ||||
<li>Mean</li> | ||||
<li>Min</li> | ||||
<li>Max</li> | ||||
<li>StdDev</li> | ||||
</ul> | ||||
<t>The one-way loss ratio is expressed as a percentage of lost | ||||
packets to total packets sent.</t> | packets to total packets sent.</t> | |||
</section> | </section> | |||
<section title="Calibration"> | <!-- 7.4.4 --> | |||
<t>Section 3.7.3 of <xref target="RFC7679"/> provides a means to | <section numbered="true" toc="default"> | |||
<name>Calibration</name> | ||||
<t><xref target="RFC7679" sectionFormat="of" section="3.7.3"/> provide | ||||
s a means to | ||||
quantify the systematic and random errors of a time measurement. | quantify the systematic and random errors of a time measurement. | |||
In-situ calibration could be enabled with an internal loopback that | Calibration in-situ could be enabled with an internal loopback that | |||
includes as much of the measurement system as possible, performs | includes as much of the measurement system as possible, performs | |||
address manipulation as needed, and provides some form of isolation | address manipulation as needed, and provides some form of isolation | |||
(e.g., deterministic delay) to avoid send-receive interface | (e.g., deterministic delay) to avoid send-receive interface | |||
contention. Some portion of the random and systematic error can be | contention. Some portion of the random and systematic error can be | |||
characterized this way.</t> | characterized in this way.</t> | |||
<t>For one-way delay measurements, the error calibration must | <t>For one-way delay measurements, the error calibration must | |||
include an assessment of the internal clock synchronization with its | include an assessment of the internal clock synchronization with its | |||
external reference (this internal clock is supplying timestamps for | external reference (this internal clock is supplying timestamps for | |||
measurement). In practice, the time offsets <xref target="RFC5905"/> | measurement). In practice, the time offsets <xref target="RFC5905" for | |||
of clocks at both the source and destination are needed to estimate | mat="default"/> | |||
of clocks at both the Source and Destination are needed to estimate | ||||
the systematic error due to imperfect clock synchronization (the | the systematic error due to imperfect clock synchronization (the | |||
time offsets <xref target="RFC5905"/> are smoothed, thus the random | time offsets <xref target="RFC5905" format="default"/> are smoothed; t | |||
variation is not usually represented in the results).<list | hus, the random | |||
style="hanging"> | variation is not usually represented in the results).</t> | |||
<t hangText="time_offset">The time value of the result is | <dl newline="false" spacing="normal"> | |||
<dt>time_offset:</dt> | ||||
<dd>The time value of the result is | ||||
expressed in units of seconds, as a signed value of type | expressed in units of seconds, as a signed value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RF | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds (1.0 | C6020" sectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seco | |||
nds (1.0 | ||||
ns), and with lossless conversion to/from the 64-bit NTP | ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" section | |||
target="RFC5905">RFC</xref></t> | ="6"/>.</dd> | |||
</list></t> | </dl> | |||
<t>When a measurement controller requests a calibration measurement, | <t>When a measurement controller requests a calibration measurement, | |||
the loopback is applied and the result is output in the same format | the loopback is applied and the result is output in the same format | |||
as a normal measurement with additional indication that it is a | as a normal measurement, with an additional indication that it is a | |||
calibration result. In any measurement, the measurement function | calibration result. In any measurement, the measurement function | |||
SHOULD report its current estimate of time offset <xref | <bcp14>SHOULD</bcp14> report its current estimate of the time offset < | |||
target="RFC5905"/> as an indicator of the degree of | xref target="RFC5905" format="default"/> as an indicator of the degree of | |||
synchronization.</t> | synchronization.</t> | |||
<t>Both internal loopback calibration and clock synchronization can | <t>Both internal loopback calibration and clock synchronization can | |||
be used to estimate the available accuracy of the Output Metric | be used to estimate the available accuracy of the Output Metric | |||
Units. For example, repeated loopback delay measurements will reveal | Units. For example, repeated loopback delay measurements will reveal | |||
the portion of the Output result resolution which is the result of | the portion of the output result resolution that is the result of | |||
system noise, and thus inaccurate.</t> | system noise and is thus inaccurate.</t> | |||
<t/> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Administrative items"> | <name>Administrative Items</name> | |||
<t/> | <section numbered="true" toc="default"> | |||
<name>Status</name> | ||||
<section title="Status"> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Requester"> | <name>Requester</name> | |||
<t>This RFC number</t> | <t>RFC 8912</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision"> | <name>Revision</name> | |||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision Date"> | <name>Revision Date</name> | |||
<t>YYYY-MM-DD</t> | <t>2021-11-17</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Comments and Remarks"> | <name>Comments and Remarks</name> | |||
<t>None</t> | <t>None</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<!-- Section 8 --> | ||||
<section anchor="UDP_periodic_owd_and_loss" numbered="true" toc="default"> | ||||
<name>UDP Periodic One-Way Delay and Loss Registry Entries</name> | ||||
<t>This section specifies five initial Registry Entries for UDP | ||||
Periodic One-Way Delay and one entry for UDP Periodic One-Way Loss.</t> | ||||
<section title="UDP Periodic One-way Delay and Loss Registry Entries"> | <t>All column entries besides the ID, Name, Description, and Output | |||
<t>This section specifies five initial registry entries for the UDP | Reference Method categories are the same; thus, this section defines six | |||
Periodic One-way Delay, and one for UDP Periodic One-way Loss.</t> | closely related Registry Entries. As a result, IANA has | |||
assigned corresponding URLs to each of the six Named Metrics.</t> | ||||
<t>IANA Note: Registry "Name" below specifies multiple registry entries, | <section numbered="true" toc="default"> | |||
whose output format varies according to the <statistic> element of | <name>Summary</name> | |||
the name that specifies one form of statistical summary. There is an | <t>This category includes multiple indexes to the Registry Entries: | |||
additional metric name for the Loss metric.</t> | the element ID and Metric Name.</t> | |||
<section numbered="true" toc="default"> | ||||
<t>All column entries beside the ID, Name, Description, and Output | <name>ID (Identifier)</name> | |||
Reference Method categories are the same, thus this section proposes six | <t>IANA has allocated the numeric Identifiers 12-17 for the six | |||
closely-related registry entries. As a result, IANA is also asked to | Named Metric Entries in <xref target="UDP_periodic_owd_and_loss"/>. See | |||
assign corresponding URLs to each Named Metric.</t> | <xref target="name812"/> for mapping to Names.</t> | |||
<section title="Summary"> | ||||
<t>This category includes multiple indexes to the registry entries, | ||||
the element ID and metric name.</t> | ||||
<section title="ID (Identifier)"> | ||||
<t>IANA is asked to assign a different numeric identifiers to each | ||||
of the six Metrics.</t> | ||||
</section> | </section> | |||
<section anchor="name812" numbered="true" toc="default"> | ||||
<section title="Name"> | <name>Name</name> | |||
<t>OWDelay_Active_IP-UDP-Periodic20m-Payload142B_RFCXXXXsec8_Seconds_& | <dl spacing="normal" indent="5" newline="false"> | |||
lt;statistic></t> | <!-- 8.1.2 --> <dt>12:</dt><dd>OWDelay_Active_IP-UDP-Periodic20m-Payload142B | |||
_RFC8912sec8_Seconds_95Percentile</dd> | ||||
<t>where <statistic> is one of:</t> | <dt>13:</dt><dd>OWDelay_Active_IP-UDP-Periodic20m-Payload142B_RFC8912 | |||
sec8_Seconds_Mean</dd> | ||||
<t><list style="symbols"> | <dt>14:</dt><dd>OWDelay_Active_IP-UDP-Periodic20m-Payload142B_RFC8912 | |||
<t>95Percentile</t> | sec8_Seconds_Min</dd> | |||
<dt>15:</dt><dd>OWDelay_Active_IP-UDP-Periodic20m-Payload142B_RFC8912 | ||||
<t>Mean</t> | sec8_Seconds_Max</dd> | |||
<dt>16:</dt><dd>OWDelay_Active_IP-UDP-Periodic20m-Payload142B_RFC8912 | ||||
<t>Min</t> | sec8_Seconds_StdDev</dd> | |||
<dt>17:</dt><dd>OWLoss_Active_IP-UDP-Periodic20m-Payload142B_RFC8912 | ||||
<t>Max</t> | sec8_Percent_LossRatio</dd> | |||
</dl> | ||||
<t>StdDev</t> | ||||
</list></t> | ||||
<t>OWLoss_Active_IP-UDP-Periodic-Payload142B_RFCXXXXsec8_Percent_LossR | ||||
atio</t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="URI"> | <!-- 8.1.3 --> | |||
<t>URL: https://www.iana.org/ ... <name></t> | <name>URI</name> | |||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay | ||||
_Active_IP-UDP-Periodic20m-Payload142B_RFC8912sec8_Seconds_95Percentile"/></t> | ||||
<t>URL: <eref | ||||
target="https://www.iana.org/performance-metrics/OWDelay_Active_IP-UDP-Periodic2 | ||||
0m-Payload142B_RFC8912sec8_Seconds_Mean"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Periodic20m-Payload142B_RFC8912sec8_Seconds_Min"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Periodic20m-Payload142B_RFC8912sec8_Seconds_Max"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWDelay_ | ||||
Active_IP-UDP-Periodic20m-Payload142B_RFC8912sec8_Seconds_StdDev"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/OWLoss_A | ||||
ctive_IP-UDP-Periodic20m-Payload142B_RFC8912sec8_Percent_LossRatio"/></t> | ||||
</section> | </section> | |||
<section title="Description"> | <!-- 8.1.4 --> | |||
<t>OWDelay: This metric assesses the delay of a stream of packets | <section numbered="true" toc="default"> | |||
exchanged between two hosts (or measurement points), and reports the | <name>Description</name> | |||
<statistic> One-way delay for all successfully exchanged | <dl newline="false" spacing="normal"> | |||
<dt>OWDelay:</dt><dd><t>This metric assesses the delay of a stream of | ||||
packets | ||||
exchanged between two hosts (or measurement points) and reports the | ||||
<statistic> of one-way delay for all successfully exchanged | ||||
packets based on their conditional delay distribution.</t> | packets based on their conditional delay distribution.</t> | |||
<t>where <statistic> is one of:</t> | <t>where <statistic> is one of:</t> | |||
<ul spacing="normal"> | ||||
<t><list style="symbols"> | <li>95Percentile</li> | |||
<t>95Percentile</t> | <li>Mean</li> | |||
<li>Min</li> | ||||
<t>Mean</t> | <li>Max</li> | |||
<li>StdDev</li> | ||||
<t>Min</t> | </ul> | |||
</dd> | ||||
<t>Max</t> | <dt>OWLoss:</dt><dd>This metric assesses the loss ratio of a stream of | |||
<t>StdDev</t> | ||||
</list></t> | ||||
<t>OWLoss: This metric assesses the loss ratio of a stream of | ||||
packets exchanged between two hosts (which are the two measurement | packets exchanged between two hosts (which are the two measurement | |||
points), and the Output is the One-way loss ratio for all | points). The output is the one-way loss ratio for all | |||
successfully received packets expressed as a percentage.</t> | transmitted packets expressed as a percentage.</dd> | |||
</dl> | ||||
</section> | ||||
<!-- 8.1.5 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Change Controller</name> | ||||
<t>IETF</t> | ||||
</section> | ||||
<section numbered="true" toc="default"> | ||||
<name>Version (of Registry Format)</name> | ||||
<t>1.0</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Metric Definition"> | <name>Metric Definition</name> | |||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Definition"> | <name>Reference Definition</name> | |||
<t>For Delay:</t> | <t>For delay:</t> | |||
<t indent="3">Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, | ||||
<t>Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, Ed., "A | Ed., "A | |||
One-Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC | One-Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC | |||
7679, DOI 10.17487/RFC7679, January 2016, | 7679, DOI 10.17487/RFC7679, January 2016, | |||
<http://www.rfc-editor.org/info/rfc7679>.</t> | <https://www.rfc-editor.org/info/rfc7679>. | |||
<xref target="RFC7679"/></t> | ||||
<t><xref target="RFC7679"/></t> | <t indent="3">Morton, A. and E. Stephan, "Spatial Composition of Metri | |||
cs", RFC | ||||
<t>Morton, A., and Stephan, E., "Spatial Composition of Metrics", | 6049, DOI 10.17487/RFC6049, January 2011, | |||
RFC 6049, January 2011.</t> | <https://www.rfc-editor.org/info/rfc6049>. | |||
<xref target="RFC6049"/></t> | ||||
<t><xref target="RFC6049"/></t> | <t indent="3"><xref target="RFC7679" sectionFormat="of" section="3.4"/ | |||
> provides the reference | ||||
<t>Section 3.4 of <xref target="RFC7679"/> provides the reference | definition of the singleton (single value) one-way delay metric. | |||
definition of the singleton (single value) One-way delay metric. | <xref target="RFC7679" sectionFormat="of" section="4.4"/> provides the | |||
Section 4.4 of <xref target="RFC7679"/> provides the reference | reference | |||
definition expanded to cover a multi-value sample. Note that terms | definition expanded to cover a multi-value sample. Note that terms | |||
such as singleton and sample are defined in Section 11 of <xref | such as "singleton" and "sample" are defined in <xref target="RFC2330" | |||
target="RFC2330"/>.</t> | sectionFormat="of" section="11"/>.</t> | |||
<t indent="3">Only successful packet transfers with finite delay are i | ||||
<t>Only successful packet transfers with finite delay are included | ncluded | |||
in the sample, as prescribed in section 4.1.2 of <xref | in the sample, as prescribed in <xref target="RFC6049" sectionFormat=" | |||
target="RFC6049"/>.</t> | of" section="4.1.2"/>.</t> | |||
<t>For loss:</t> | <t>For loss:</t> | |||
<t indent="3">Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, | ||||
<t>Almes, G., Kalidini, S., Zekauskas, M., and A. Morton, Ed., "A | Ed., "A | |||
One-Way Loss Metric for IP Performance Metrics (IPPM)", RFC 7680, | One-Way Loss Metric for IP Performance Metrics (IPPM)", STD 82, RFC | |||
DOI 10.17487/RFC7680, January 2016, | 7680, DOI 10.17487/RFC7680, January 2016, | |||
<http://www.rfc-editor.org/info/rfc7680>.</t> | <https://www.rfc-editor.org/info/rfc7680>. | |||
<xref target="RFC7680"/></t> | ||||
<t>Section 2.4 of <xref target="RFC7680"/> provides the reference | <t indent="3"><xref target="RFC7680" sectionFormat="of" section="2.4"/ | |||
definition of the singleton (single value) one-way loss metric. | > provides the reference | |||
Section 3.4 of <xref target="RFC7680"/> provides the reference | definition of the singleton (single value) one-way Loss metric. | |||
<xref target="RFC7680" sectionFormat="of" section="3.4"/> provides the | ||||
reference | ||||
definition expanded to cover a multi-singleton sample. Note that | definition expanded to cover a multi-singleton sample. Note that | |||
terms such as singleton and sample are defined in Section 11 of | terms such as "singleton" and "sample" are defined in <xref target="RF | |||
<xref target="RFC2330"/>.</t> | C2330" sectionFormat="of" section="11"/>.</t> | |||
</section> | </section> | |||
<!-- 8.2.2 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Fixed Parameters</name> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>Type-P:</dt> | ||||
<dd><t/> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv4 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>TTL:</dt><dd>Set to 255</dd> | ||||
<dt>Protocol:</dt><dd>Set to 17 (UDP)</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<section title="Fixed Parameters"> | <dl newline="true" spacing="normal"> | |||
<t>Type-P: <list style="symbols"> | <dt>IPv6 header values:</dt> | |||
<t>IPv4 header values: <list style="symbols"> | <dd><t/> | |||
<t>DSCP: set to 0</t> | <dl newline="false" spacing="compact"> | |||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<t>TTL: set to 255</t> | <dt>Hop Count:</dt><dd>Set to 255</dd> | |||
<dt>Next Header:</dt><dd>Set to 17 (UDP)</dd> | ||||
<t>Protocol: Set to 17 (UDP)</t> | <dt>Flow Label:</dt><dd>Set to 0</dd> | |||
</list></t> | <dt>Extension Headers:</dt><dd>None</dd> | |||
</dl> | ||||
<t>IPv6 header values:<list style="symbols"> | </dd> | |||
<t>DSCP: set to 0</t> | </dl> | |||
<t>Hop Count: set to 255</t> | ||||
<t>Next Header: set to 17 (UDP)</t> | ||||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>UDP header values: <list style="symbols"> | ||||
<t>Checksum: the checksum MUST be calculated and the | ||||
non-zero checksum included in the header</t> | ||||
</list></t> | ||||
<t>UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of | ||||
<xref target="RFC5357"/> <list style="symbols"> | ||||
<t>Security features in use influence the number of Padding | ||||
octets.</t> | ||||
<t>142 octets total, including the TWAMP format (and format | <dl newline="true" spacing="normal"> | |||
type MUST be reported, if used)</t> | <dt>UDP header values:</dt> | |||
</list></t> | <dd><t/> | |||
</list></t> | <dl newline="false" spacing="compact"> | |||
<dt>Checksum:</dt><dd>The checksum <bcp14>MUST</bcp14> be calculat | ||||
ed and the | ||||
non-zero checksum included in the header</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>Other measurement parameters:</t> | <dl newline="false" spacing="normal"> | |||
<dt>UDP Payload:</dt><dd><t>TWAMP-Test packet formats (<xref | ||||
target="RFC5357" sectionFormat="of" section="4.1.2"/>)</t> | ||||
<ul empty="true"> | ||||
<li>Security features in use influence the number of Padding | ||||
octets</li> | ||||
<li>142 octets total, including the TWAMP format (and format | ||||
type <bcp14>MUST</bcp14> be reported, if used)</li> | ||||
</ul> | ||||
</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t><list style="hanging"> | <dl newline="true" spacing="normal"> | |||
<t hangText="Tmax:">a loss threshold waiting time with value | <dt>Other measurement Parameters:</dt> | |||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>Tmax:</dt> | ||||
<dd>A loss threshold waiting time with value | ||||
3.0, expressed in units of seconds, as a positive value of type | 3.0, expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 4 (see section 9.3 of <xref | decimal64 with fraction digits = 4 (see <xref target="RFC6020" sec | |||
target="RFC6020"/>) and with resolution of 0.0001 seconds (0.1 | tionFormat="of" section="9.3"/>) and with a resolution of 0.0001 seconds (0.1 | |||
ms), with lossless conversion to/from the 32-bit NTP timestamp | ms), with lossless conversion to/from the 32-bit NTP timestamp | |||
as per section 6 of <xref target="RFC5905"/>.</t> | as per <xref target="RFC5905" sectionFormat="of" section="6"/>.</d | |||
</list></t> | d> | |||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<t>See the Packet Stream generation category for two additional | <t>See the Packet Stream Generation section for three additional | |||
Fixed Parameters.</t> | Fixed Parameters.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section title="Method of Measurement"> | <!-- 8.3 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Method of Measurement</name> | ||||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Method"> | <name>Reference Methods</name> | |||
<t>The methodology for this metric is defined as | <t>The methodology for this metric (equivalent to | |||
Type-P-One-way-Delay-Poisson-Stream in section 3.6 of <xref | Type-P-One-way-Delay-Poisson-Stream) is defined as in <xref target="RF | |||
target="RFC7679"/> and section 4.6 of <xref target="RFC7679"/> using | C7679" | |||
the Type-P and Tmax defined under Fixed Parameters. However, a | sectionFormat="of" section="3.6"/> (for singletons) and <xref | |||
Periodic stream is used, as defined in <xref target="RFC3432"/>.</t> | target="RFC7679" sectionFormat="of" section="4.6"/> (for samples) usin | |||
g | ||||
the Type-P and Tmax defined in the Fixed Parameters column. However, a | ||||
Periodic stream is used, as defined in <xref target="RFC3432" format=" | ||||
default"/>.</t> | ||||
<t>The reference method distinguishes between long-delayed packets | <t>The reference method distinguishes between long-delayed packets | |||
and lost packets by implementing a maximum waiting time for packet | and lost packets by implementing a maximum waiting time for packet | |||
arrival. Tmax is the waiting time used as the threshold to declare a | arrival. Tmax is the waiting time used as the threshold to declare a | |||
packet lost. Lost packets SHALL be designated as having undefined | packet lost. Lost packets <bcp14>SHALL</bcp14> be designated as having | |||
delay, and counted for the OWLoss metric.</t> | undefined | |||
delay and counted for the OWLoss metric.</t> | ||||
<t>The calculations on the one-way delay SHALL be performed on the | <t>The calculations on the one-way delay <bcp14>SHALL</bcp14> be perfo | |||
rmed on the | ||||
conditional distribution, conditioned on successful packet arrival | conditional distribution, conditioned on successful packet arrival | |||
within Tmax. Also, when all packet delays are stored, the process | within Tmax. Also, when all packet delays are stored, the process | |||
which calculates the one-way delay value MUST enforce the Tmax | that calculates the one-way delay value <bcp14>MUST</bcp14> enforce th | |||
threshold on stored values before calculations. See section 4.1 of | e Tmax | |||
<xref target="RFC3393"/> for details on the conditional distribution | threshold on stored values before calculations. See <xref target="RFC3 | |||
to exclude undefined values of delay, and Section 5 of <xref | 393" sectionFormat="of" section="4.1"/> for details on the conditional distribut | |||
target="RFC6703"/> for background on this analysis choice.</t> | ion | |||
to exclude undefined values of delay, and see <xref target="RFC6703" s | ||||
ectionFormat="of" section="5"/> for background on this analysis choice.</t> | ||||
<t>The reference method requires some way to distinguish between | <t>The reference method requires some way to distinguish between | |||
different packets in a stream to establish correspondence between | different packets in a stream to establish correspondence between | |||
sending times and receiving times for each successfully-arriving | sending times and receiving times for each successfully arriving | |||
packet.</t> | packet.</t> | |||
<t>Since a standard measurement protocol is employed <xref target="RFC | ||||
<t>Since a standard measurement protocol is employed <xref | 5357" format="default"/>, the measurement process will determine the | |||
target="RFC5357"/>, then the measurement process will determine the | ||||
sequence numbers or timestamps applied to test packets after the | sequence numbers or timestamps applied to test packets after the | |||
Fixed and Runtime parameters are passed to that process. The | Fixed and Runtime Parameters are passed to that process. The | |||
measurement protocol dictates the format of sequence numbers and | measurement protocol dictates the format of sequence numbers and | |||
time-stamps conveyed in the TWAMP-Test packet payload.</t> | timestamps conveyed in the TWAMP-Test packet payload.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Packet Stream Generation"> | <name>Packet Stream Generation</name> | |||
<t>This section gives the details of the packet traffic which is the | <t>This section provides details regarding packet traffic, which is | |||
basis for measurement. In IPPM metrics, this is called the Stream, | used as the | |||
and can easily be described by providing the list of stream | basis for measurement. In IPPM Metrics, this is called the "stream"; | |||
parameters.</t> | this stream can easily be described by providing the list of stream | |||
Parameters.</t> | ||||
<t>Section 3 of <xref target="RFC3432"/> prescribes the method for | <t><xref target="RFC3432" sectionFormat="of" section="3"/> prescribes | |||
generating Periodic streams using associated parameters.</t> | the method for | |||
generating Periodic streams using associated Parameters.</t> | ||||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="incT">the nominal duration of inter-packet | <dt>incT:</dt> | |||
interval, first bit to first bit, with value 0.0200 expressed in | <dd>The nominal duration of the inter-packet | |||
interval, first bit to first bit, with value 0.0200, expressed in | ||||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 4 (see section 9.3 of <xref | fraction digits = 4 (see <xref target="RFC6020" sectionFormat="of" | |||
target="RFC6020"/>) and with resolution of 0.0001 seconds (0.1 | section="9.3"/>) and with a resolution of 0.0001 seconds (0.1 ms), with lossles | |||
ms), with lossless conversion to/from the 32-bit NTP timestamp | s conversion to/from the 32-bit NTP timestamp | |||
as per section 6 of <xref target="RFC5905"/>.</t> | as per <xref target="RFC5905" sectionFormat="of" section="6"/>.</d | |||
d> | ||||
<t hangText="dT">the duration of the interval for allowed sample | <dt>dT:</dt> | |||
<dd>The duration of the interval for allowed sample | ||||
start times, with value 1.0000, expressed in units of seconds, | start times, with value 1.0000, expressed in units of seconds, | |||
as a positive value of type decimal64 with fraction digits = 4 | as a positive value of type decimal64 with fraction digits = 4 | |||
(see section 9.3 of <xref target="RFC6020"/>) and with | (see <xref target="RFC6020" sectionFormat="of" section="9.3"/>) | |||
resolution of 0.0001 seconds (0.1 ms), with lossless conversion | and with a resolution of 0.0001 seconds (0.1 ms), with lossless co | |||
to/from the 32-bit NTP timestamp as per section 6 of <xref | nversion | |||
target="RFC5905"/>.</t> | to/from the 32-bit NTP timestamp as per <xref target="RFC5905" sec | |||
tionFormat="of" section="6"/>.</dd> | ||||
<t hangText="T0">the actual start time of the periodic stream, | <dt>T0:</dt> | |||
determined from T0 and dT.</t> | <dd>The actual start time of the periodic stream, | |||
</list>NOTE: an initiation process with a number of control | determined from T0 and dT.</dd> | |||
</dl> | ||||
<t indent="3">Note: An initiation process with a number of control | ||||
exchanges resulting in unpredictable start times (within a time | exchanges resulting in unpredictable start times (within a time | |||
interval) may be sufficient to avoid synchronization of periodic | interval) may be sufficient to avoid synchronization of periodic | |||
streams, and therefore a valid replacement for selecting a start | streams and is a valid replacement for selecting a start | |||
time at random from a fixed interval.</t> | time at random from a fixed interval.</t> | |||
<t>These stream Parameters will be specified as Runtime | ||||
<t>These stream parameters will be specified as Run-time | Parameters.</t> | |||
parameters.</t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Traffic Filtering (observation) Details"> | <name>Traffic Filtering (Observation) Details</name> | |||
<t>NA</t> | <t>N/A</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Sampling Distribution"> | <name>Sampling Distribution</name> | |||
<t>NA</t> | <t>N/A</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Run-time Parameters and Data Format"> | <name>Runtime Parameters and Data Format</name> | |||
<t>Run-time Parameters are input factors that must be determined, | <t>Runtime Parameters are input factors that must be determined, | |||
configured into the measurement system, and reported with the | configured into the measurement system, and reported with the | |||
results for the context to be complete.</t> | results for the context to be complete.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Src:</dt> | |||
<t hangText="Src">the IP address of the host in the Src Role | <dd>The IP address of the host in the Src Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>Dst:</dt> | ||||
<t hangText="Dst">the IP address of the host in the Dst Role | <dd>The IP address of the host in the Dst Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>T0:</dt> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dd>A time, the start of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time is unspecified and Tf is to be interpreted as the Duration | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", a start | |||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Tf:</dt> | ||||
<t hangText="Tf">a time, the end of a measurement interval, | <dd>A time, the end of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a end | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time date is ignored and Tf is interpreted as the Duration of | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", an ending | |||
the measurement interval.</t> | time and date is ignored and Tf is interpreted as the duration of | |||
</list></t> | the measurement interval.</dd> | |||
</dl> | ||||
<t/> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Roles"> | <name>Roles</name> | |||
<t><list style="hanging"> | <dl newline="false" spacing="normal"> | |||
<t hangText="Src">launches each packet and waits for return | <dt>Src:</dt> | |||
transmissions from Dst. This is the TWAMP Session-Sender.</t> | <!-- 8.3.6 --> | |||
<dd>Launches each packet and waits for return transmissions from the | ||||
<t hangText="Dst">waits for each packet from Src and sends a | Dst. An example is the TWAMP Session-Sender.</dd> | |||
return packet to Src. This is the TWAMP Session-Reflector.</t> | <dt>Dst:</dt> | |||
</list></t> | <dd>Waits for each packet from the Src and sends a return packet to | |||
the Src. An example is the TWAMP Session-Reflector.</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<!-- 8.4 --> | ||||
<section title="Output"> | <section numbered="true" toc="default"> | |||
<t>This category specifies all details of the Output of measurements | <name>Output</name> | |||
<t>This category specifies all details of the output of measurements | ||||
using the metric.</t> | using the metric.</t> | |||
<!-- 8.4.1 --> | ||||
<section title="Type"> | <section numbered="true" toc="default"> | |||
<t>See subsection titles in Reference Definition for Latency | <name>Type</name> | |||
Types.</t> | <t>Latency and Loss Types are discussed in the subsections below.</t> | |||
</section> | </section> | |||
<section title="Reference Definition"> | <!-- 8.4.2 --> | |||
<t>For all output types ---<list style="hanging"> | <section numbered="true" toc="default"> | |||
<t hangText="T0">the start of a measurement interval, (format | <name>Reference Definition</name> | |||
"date-and-time" as specified in Section 5.6 of <xref | <t>For all output types:</t> | |||
target="RFC3339"/>, see also Section 3 of <xref | <dl newline="false" spacing="normal"> | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | <dt>T0:</dt> | |||
6.1 of <xref target="RFC2330"/>.</t> | <dd>The start of a measurement interval (format | |||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
<t hangText="Tf">the end of a measurement interval, (format | sectionFormat="of" section="5.6"/>; see also | |||
"date-and-time" as specified in Section 5.6 of <xref | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
target="RFC3339"/>, see also Section 3 of <xref | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | tionFormat="of" section="6.1"/>.</dd> | |||
6.1 of <xref target="RFC2330"/>.</t> | <dt>Tf:</dt> | |||
</list></t> | <dd>The end of a measurement interval (format | |||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
<t>For LossRatio -- the count of lost packets to total packets sent | sectionFormat="of" section="5.6"/>; see also | |||
is the basis for the loss ratio calculation as per Section 4.1 of | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
<xref target="RFC7680"/>.</t> | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
tionFormat="of" section="6.1"/>.</dd> | ||||
<t>For each <statistic>, one of the following sub-sections | </dl> | |||
apply:</t> | <t>For LossRatio, the count of lost packets to total packets sent | |||
is the basis for the loss ratio calculation as per <xref target="RFC76 | ||||
<section title="Percentile95"> | 80" sectionFormat="of" section="4.1"/>.</t> | |||
<t>The 95th percentile SHALL be calculated using the conditional | <t>For each <statistic> or Percent_LossRatio, one of the followi | |||
distribution of all packets with a finite value of One-way delay | ng subsections | |||
(undefined delays are excluded), a single value as follows:</t> | applies.</t> | |||
<!-- 8.4.2.1 --> | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | <section numbered="true" toc="default"> | |||
<name>Percentile95</name> | ||||
<t>The 95th percentile <bcp14>SHALL</bcp14> be calculated using the | ||||
conditional | ||||
distribution of all packets with a finite value of one-way delay | ||||
(undefined delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.3"/> for | ||||
<t>See section 4.3 of <xref target="RFC3393"/> for details on the | details on the | |||
percentile statistic (where Round-trip delay should be substituted | percentile statistic (where round-trip delay should be substituted | |||
for "ipdv").</t> | for "ipdv").</t> | |||
<t>The percentile = 95, meaning that the reported delay, | <t>The percentile = 95, meaning that the reported delay, | |||
"95Percentile", is the smallest value of one-way delay for which | "95Percentile", is the smallest value of one-way delay for which | |||
the Empirical Distribution Function (EDF), F(95Percentile) >= | the Empirical Distribution Function, EDF(95Percentile), is greater | |||
95% of the singleton one-way delay values in the conditional | than or equal to 95% of the singleton one-way delay values in the co | |||
distribution. See section 11.3 of <xref target="RFC2330"/> for the | nditional | |||
distribution. See <xref target="RFC2330" sectionFormat="of" section= | ||||
"11.3"/> for the | ||||
definition of the percentile statistic using the EDF.</t> | definition of the percentile statistic using the EDF.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>95Percentile:</dt> | |||
<t hangText="95Percentile">The time value of the result is | <dd>The time value of the result is | |||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RFC6020" s | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | ectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Mean"> | <!-- 8.4.2.2 --> | |||
<t>The mean SHALL be calculated using the conditional distribution | <section anchor="mean-sec8422" numbered="true" toc="default"> | |||
of all packets with a finite value of One-way delay (undefined | <name>Mean</name> | |||
delays are excluded), a single value as follows:</t> | <t>The mean <bcp14>SHALL</bcp14> be calculated using the conditional | |||
distribution | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | of all packets with a finite value of one-way delay (undefined | |||
delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.2.2"/> f | ||||
<t>See section 4.2.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.2.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.2.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Mean:</dt> | |||
<t hangText="Mean">The time value of the result is expressed | <dd>The time value of the result is expressed | |||
in units of seconds, as a positive value of type decimal64 | in units of seconds, as a positive value of type decimal64 | |||
with fraction digits = 9 (see section 9.3 of <xref | with fraction digits = 9 (see <xref target="RFC6020" sectionForm | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | at="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Min"> | <!-- 8.4.2.3 --> | |||
<t>The minimum SHALL be calculated using the conditional | <section numbered="true" toc="default"> | |||
distribution of all packets with a finite value of One-way delay | <name>Min</name> | |||
(undefined delays are excluded), a single value as follows:</t> | <t>The minimum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
nal | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | distribution of all packets with a finite value of one-way delay | |||
(undefined delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.3.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.3.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Min:</dt> | |||
<t hangText="Min">The time value of the result is expressed in | <dd>The time value of the result is expressed in | |||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<!-- 8.4.2.4 --> | ||||
<section title="Max"> | <section numbered="true" toc="default"> | |||
<t>The maximum SHALL be calculated using the conditional | <name>Max</name> | |||
distribution of all packets with a finite value of One-way delay | <t>The maximum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
(undefined delays are excluded), a single value as follows:</t> | nal | |||
distribution of all packets with a finite value of one-way delay | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | (undefined delays are excluded) -- a single value, as follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
or a closely | ||||
related method for calculating this statistic; see also <xref target | ||||
="RFC6049" sectionFormat="of" section="4.3.3"/>. The formula is as follows:</t> | ||||
<artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
Max = (FiniteDelay[j]) | ||||
]]></artwork> | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for a closely | <ul empty="true"> | |||
related method for calculating this statistic, and 4.3.3 of <xref | <li>such that for some index, j, where 1 <= j <= N | |||
target="RFC6049"/>. The formula is as follows:</t> | FiniteDelay[j] >= FiniteDelay[n] for all n</li> | |||
</ul> | ||||
<t><figure> | <dl newline="false" spacing="normal"> | |||
<artwork><![CDATA[ Max = (FiniteDelay [j]) | <dt>Max:</dt> | |||
<dd>The time value of the result is expressed in | ||||
such that for some index, j, where 1 <= j <= N | ||||
FiniteDelay[j] >= FiniteDelay[n] for all n]]></artwork> | ||||
</figure></t> | ||||
<t><list style="hanging"> | ||||
<t hangText="Max">The time value of the result is expressed in | ||||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<!-- 8.4.2.5 --> | ||||
<section title="Std_Dev"> | <section numbered="true" toc="default"> | |||
<t>The Std_Dev SHALL be calculated using the conditional | <name>Std_Dev</name> | |||
distribution of all packets with a finite value of One-way delay | <t>Std_Dev <bcp14>SHALL</bcp14> be calculated using the conditional | |||
(undefined delays are excluded), a single value as follows:</t> | distribution of all packets with a finite value of one&nbhy;way dela | |||
y | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | (undefined delays are excluded) -- a single value, as follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="6.1.4"/> f | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for a closely | or a closely | |||
related method for calculating this statistic, and 4.3.3 of <xref | related method for calculating this statistic. The formula | |||
target="RFC6049"/>. The formula is the classic calculation for | is the classic calculation for the | |||
standard deviation of a population.</t> | standard deviation of a population.</t> | |||
<figure> | <t>Define Population Std_Dev_Delay as follows:</t> | |||
<artwork><![CDATA[Define Population Std_Dev_Delay as follows: | ||||
(where all packets n = 1 through N have a value for Delay[n], | ||||
and MeanDelay calculated as in 7.4.2.2), and SQRT[] is the | ||||
Square Root function: | ||||
_ _ | ||||
| N | | ||||
| --- | | ||||
| 1 \ 2 | | ||||
Std_Dev = SQRT | ------- > (Delay[n] - MeanDelay) | | ||||
| (N) / | | ||||
| --- | | ||||
| n = 1 | | ||||
|_ _| | ||||
]]></artwork> | ||||
</figure> | ||||
<t/> | <artwork name="" type="" align="left" alt=""><![CDATA[ | |||
_ _ | ||||
| N | | ||||
| --- | | ||||
| 1 \ 2 | | ||||
Std_Dev = SQRT | ------- > (Delay[n] - MeanDelay) | | ||||
| (N) / | | ||||
| --- | | ||||
| n = 1 | | ||||
|_ _| | ||||
]]></artwork> | ||||
<t><list style="hanging"> | <t>where all packets n = 1 through N have a value for Delay[n], | |||
<t hangText="Std_Dev">The time value of the result is | MeanDelay is calculated per <xref target="mean-sec8422"/>, | |||
and SQRT[] is the Square Root function:</t> | ||||
<dl newline="false" spacing="normal"> | ||||
<dt>Std_Dev:</dt> | ||||
<dd>The time value of the result is | ||||
expressed in units of seconds, as a positive value of type | expressed in units of seconds, as a positive value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RFC6020" s | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | ectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
</section> | <!-- 8.4.2.6 --> | |||
<section> | ||||
<name>Percent_LossRatio</name> | ||||
<section title="Metric Units"> | <dl> | |||
<t>The <statistic> of One-way Delay is expressed in seconds, | <dt>Percent_LossRatio:</dt><dd>The numeric value of the result is | |||
expressed in units of lost packets to total packets times 100%, as | ||||
a positive value of type decimal64 with fraction digits = 9 (see | ||||
<xref target="RFC6020" sectionFormat="of" section="9.3"/> with a | ||||
resolution of 0.0000000001.</dd></dl> | ||||
</section> | ||||
</section> | ||||
<!-- 8.4.3 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Metric Units</name> | ||||
<t>The <statistic> of one-way delay is expressed in seconds, | ||||
where <statistic> is one of:</t> | where <statistic> is one of:</t> | |||
<ul spacing="normal"> | ||||
<t><list style="symbols"> | <li>95Percentile</li> | |||
<t>95Percentile</t> | <li>Mean</li> | |||
<li>Min</li> | ||||
<t>Mean</t> | <li>Max</li> | |||
<li>StdDev</li> | ||||
<t>Min</t> | </ul> | |||
<t>The one-way loss ratio is expressed as a percentage of lost | ||||
<t>Max</t> | ||||
<t>StdDev</t> | ||||
</list></t> | ||||
<t>The One-way Loss Ratio is expressed as a percentage of lost | ||||
packets to total packets sent.</t> | packets to total packets sent.</t> | |||
</section> | ||||
<section title="Calibration"> | </section> | |||
<t>Section 3.7.3 of <xref target="RFC7679"/> provides a means to | <!-- 8.4.4 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Calibration</name> | ||||
<t><xref target="RFC7679" sectionFormat="of" section="3.7.3"/> provide | ||||
s a means to | ||||
quantify the systematic and random errors of a time measurement. | quantify the systematic and random errors of a time measurement. | |||
In-situ calibration could be enabled with an internal loopback that | Calibration in-situ could be enabled with an internal loopback that | |||
includes as much of the measurement system as possible, performs | includes as much of the measurement system as possible, performs | |||
address manipulation as needed, and provides some form of isolation | address manipulation as needed, and provides some form of isolation | |||
(e.g., deterministic delay) to avoid send-receive interface | (e.g., deterministic delay) to avoid send-receive interface | |||
contention. Some portion of the random and systematic error can be | contention. Some portion of the random and systematic error can be | |||
characterized this way.</t> | characterized in this way.</t> | |||
<t>For one-way delay measurements, the error calibration must | <t>For one-way delay measurements, the error calibration must | |||
include an assessment of the internal clock synchronization with its | include an assessment of the internal clock synchronization with its | |||
external reference (this internal clock is supplying timestamps for | external reference (this internal clock is supplying timestamps for | |||
measurement). In practice, the time offsets <xref target="RFC5905"/> | measurement). In practice, the time offsets <xref target="RFC5905" for | |||
of clocks at both the source and destination are needed to estimate | mat="default"/> | |||
of clocks at both the Source and Destination are needed to estimate | ||||
the systematic error due to imperfect clock synchronization (the | the systematic error due to imperfect clock synchronization (the | |||
time offsets <xref target="RFC5905"/> are smoothed, thus the random | time offsets <xref target="RFC5905" format="default"/> are smoothed; t | |||
variation is not usually represented in the results).<list | hus, the random | |||
style="hanging"> | variation is not usually represented in the results).</t> | |||
<t hangText="time_offset">The time value of the result is | <dl newline="false" spacing="normal"> | |||
<dt>time_offset:</dt> | ||||
<dd>The time value of the result is | ||||
expressed in units of seconds, as a signed value of type | expressed in units of seconds, as a signed value of type | |||
decimal64 with fraction digits = 9 (see section 9.3 of <xref | decimal64 with fraction digits = 9 (see <xref target="RF | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds (1.0 | C6020" sectionFormat="of" section="9.3"/>) with a resolution of 0.000000001 seco | |||
nds (1.0 | ||||
ns), and with lossless conversion to/from the 64-bit NTP | ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" section | |||
target="RFC5905">RFC</xref></t> | ="6"/>.</dd> | |||
</list></t> | </dl> | |||
<t>When a measurement controller requests a calibration measurement, | <t>When a measurement controller requests a calibration measurement, | |||
the loopback is applied and the result is output in the same format | the loopback is applied and the result is output in the same format | |||
as a normal measurement with additional indication that it is a | as a normal measurement, with an additional indication that it is a | |||
calibration result. In any measurement, the measurement function | calibration result. In any measurement, the measurement function | |||
SHOULD report its current estimate of time offset <xref | <bcp14>SHOULD</bcp14> report its current estimate of the time offset < | |||
target="RFC5905"/> as an indicator of the degree of | xref target="RFC5905" format="default"/> as an indicator of the degree of | |||
synchronization.</t> | synchronization.</t> | |||
<t>Both internal loopback calibration and clock synchronization can | <t>Both internal loopback calibration and clock synchronization can | |||
be used to estimate the available accuracy of the Output Metric | be used to estimate the available accuracy of the Output Metric | |||
Units. For example, repeated loopback delay measurements will reveal | Units. For example, repeated loopback delay measurements will reveal | |||
the portion of the Output result resolution which is the result of | the portion of the output result resolution that is the result of | |||
system noise, and thus inaccurate.</t> | system noise and is thus inaccurate.</t> | |||
<t/> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section title="Administrative items"> | <!-- 8.5 --> | |||
<t/> | <section numbered="true" toc="default"> | |||
<name>Administrative Items</name> | ||||
<section title="Status"> | <!-- 8.5.1 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Status</name> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<!-- 8.5.2 --> | ||||
<section title="Requester"> | <section numbered="true" toc="default"> | |||
<t>This RFC number</t> | <name>Requester</name> | |||
<t>RFC 8912</t> | ||||
</section> | </section> | |||
<!-- 8.5.3 --> | ||||
<section title="Revision"> | <section numbered="true" toc="default"> | |||
<name>Revision</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<!-- 8.5.4 --> | ||||
<section title="Revision Date"> | <section numbered="true" toc="default"> | |||
<t>YYYY-MM-DD</t> | <name>Revision Date</name> | |||
<t>2021-11-17</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<!-- 8.6 --> | ||||
<section title="Comments and Remarks"> | <section numbered="true" toc="default"> | |||
<t>None.</t> | <name>Comments and Remarks</name> | |||
<t>None</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<!-- Section 9 --> | ||||
<section title="ICMP Round-trip Latency and Loss Registry Entries"> | <section anchor="icmp_roundtrip_latency_and_loss" numbered="true" toc="defau | |||
<t>This section specifies three initial registry entries for the ICMP | lt"> | |||
Round-trip Latency, and another entry for ICMP Round-trip Loss | <name>ICMP Round-Trip Latency and Loss Registry Entries</name> | |||
<t>This section specifies three initial Registry Entries for ICMP | ||||
Round&nbhy;Trip Latency and another entry for the ICMP Round-Trip Loss | ||||
Ratio.</t> | Ratio.</t> | |||
<t>IANA Note: Registry "Name" below specifies multiple registry entries, | <t>All column entries besides the ID, Name, Description, and Output | |||
whose output format varies according to the <statistic> element of | Reference Method categories are the same; thus, this section defines four | |||
the name that specifies one form of statistical summary. There is an | closely related Registry Entries. As a result, IANA has | |||
additional metric name for the Loss metric.</t> | assigned corresponding URLs to each of the four Named Metrics.</t> | |||
<t>All column entries beside the ID, Name, Description, and Output | ||||
Reference Method categories are the same, thus this section proposes two | ||||
closely-related registry entries. As a result, IANA is also asked to | ||||
assign corresponding URLs to each Named Metric.</t> | ||||
<section title="Summary"> | ||||
<t>This category includes multiple indexes to the registry entry: the | ||||
element ID and metric name.</t> | ||||
<section title="ID (Identifier)"> | <!-- 9.1 --> | |||
<t>IANA is asked to assign different numeric identifiers to each of | <section numbered="true" toc="default"> | |||
the four Named Metrics.</t> | <name>Summary</name> | |||
<t>This category includes multiple indexes to the Registry Entries: the | ||||
element ID and Metric Name.</t> | ||||
<!-- 9.1.1 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>ID (Identifier)</name> | ||||
<t>IANA has allocated the numeric Identifiers 18-21 for the four | ||||
Named Metric Entries in <xref target="icmp_roundtrip_latency_and_loss"/ | ||||
>. | ||||
See <xref target="name912"/> for mapping to Names.</t> | ||||
</section> | </section> | |||
<section title="Name"> | <!-- 9.1.2 --> | |||
<t>RTDelay_Active_IP-ICMP-SendOnRcv_RFCXXXXsec9_Seconds_<statistic& | <section anchor="name912" numbered="true" toc="default"> | |||
gt;</t> | <name>Name</name> | |||
<dl spacing="normal" indent="5" newline="false"> | ||||
<t>where <statistic> is one of:</t> | <dt>18:</dt><dd>RTDelay_Active_IP-ICMP-SendOnRcv_RFC8912sec9_Seconds_ | |||
Mean</dd> | ||||
<t><list style="symbols"> | <dt>19:</dt><dd>RTDelay_Active_IP-ICMP-SendOnRcv_RFC8912sec9_Seconds_ | |||
<t>Mean</t> | Min</dd> | |||
<dt>20:</dt><dd>RTDelay_Active_IP-ICMP-SendOnRcv_RFC8912sec9_Seconds_ | ||||
<t>Min</t> | Max</dd> | |||
<dt>21:</dt><dd>RTLoss_Active_IP-ICMP-SendOnRcv_RFC8912sec9_Percent_ | ||||
<t>Max</t> | LossRatio</dd> | |||
</list></t> | </dl> | |||
<t>RTLoss_Active_IP-ICMP-SendOnRcv_RFCXXXXsec9_Percent_LossRatio</t> | ||||
</section> | </section> | |||
<!-- 9.1.3 --> | ||||
<section title="URI"> | <section numbered="true" toc="default"> | |||
<t>URL: https://www.iana.org/ ... <name></t> | <name>URI</name> | |||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay | ||||
_Active_IP-ICMP-SendOnRcv_RFC8912sec9_Seconds_Mean"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay_ | ||||
Active_IP-ICMP-SendOnRcv_RFC8912sec9_Seconds_Min"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay_ | ||||
Active_IP-ICMP-SendOnRcv_RFC8912sec9_Seconds_Max"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTLoss_A | ||||
ctive_IP-ICMP-SendOnRcv_RFC8912sec9_Percent_LossRatio"/></t> | ||||
</section> | </section> | |||
<!-- 9.1.4 --> | ||||
<section title="Description"> | <section numbered="true" toc="default"> | |||
<t>RTDelay: This metric assesses the delay of a stream of ICMP | <name>Description</name> | |||
<dl newline="false" spacing="normal"> | ||||
<dt>RTDelay:</dt><dd><t>This metric assesses the delay of a stream of | ||||
ICMP | ||||
packets exchanged between two hosts (which are the two measurement | packets exchanged between two hosts (which are the two measurement | |||
points), and the Output is the Round-trip delay for all successfully | points). The output is the round-trip delay for all successfully | |||
exchanged packets expressed as the <statistic> of their | exchanged packets expressed as the <statistic> of their | |||
conditional delay distribution, where <statistic> is one | conditional delay distribution, where <statistic> is one | |||
of:</t> | of:</t> | |||
<ul spacing="normal"> | ||||
<li>Mean</li> | ||||
<li>Min</li> | ||||
<li>Max</li> | ||||
</ul> | ||||
</dd> | ||||
<t><list style="symbols"> | <dt>RTLoss:</dt><dd>This metric assesses the loss ratio of a stream of | |||
<t>Mean</t> | ICMP | |||
<t>Min</t> | ||||
<t>Max</t> | ||||
</list></t> | ||||
<t>RTLoss: This metric assesses the loss ratio of a stream of ICMP | ||||
packets exchanged between two hosts (which are the two measurement | packets exchanged between two hosts (which are the two measurement | |||
points), and the Output is the Round-trip loss ratio for all | points). The output is the round-trip loss ratio for all | |||
successfully exchanged packets expressed as a percentage.</t> | transmitted packets expressed as a percentage.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<!-- 9.1.5 --> | ||||
<section title="Change Controller"> | <section numbered="true" toc="default"> | |||
<name>Change Controller</name> | ||||
<t>IETF</t> | <t>IETF</t> | |||
</section> | </section> | |||
<section title="Version (of Registry Format)"> | <!-- 9.6.1 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Version (of Registry Format)</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section title="Metric Definition"> | <!-- 9.2 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Metric Definition</name> | ||||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section title="Reference Definition"> | ||||
<t>Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay | ||||
Metric for IPPM", RFC 2681, September 1999.</t> | ||||
<t><xref target="RFC2681"/></t> | <!-- 9.2.1 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Reference Definition</name> | ||||
<t>Section 2.4 of <xref target="RFC2681"/> provides the reference | <t>For delay:</t> | |||
definition of the singleton (single value) Round-trip delay metric. | <t indent="3">Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-tri | |||
Section 3.4 of <xref target="RFC2681"/> provides the reference | p Delay | |||
Metric for IPPM", RFC 2681, DOI 10.17487/RFC2681, September 1999, | ||||
<https://www.rfc-editor.org/info/rfc2681>. | ||||
<xref target="RFC2681"/></t> | ||||
<t indent="3"><xref target="RFC2681" sectionFormat="of" section="2.4"/ | ||||
> provides the reference | ||||
definition of the singleton (single value) round-trip delay metric. | ||||
<xref target="RFC2681" sectionFormat="of" section="3.4"/> provides the | ||||
reference | ||||
definition expanded to cover a multi-singleton sample. Note that | definition expanded to cover a multi-singleton sample. Note that | |||
terms such as singleton and sample are defined in Section 11 of | terms such as "singleton" and "sample" are defined in <xref target="RF | |||
<xref target="RFC2330"/>.</t> | C2330" sectionFormat="of" section="11"/>.</t> | |||
<t indent="3">Note that although the definition of round-trip delay be | ||||
<t>Note that although the <xref target="RFC2681"/> definition of | tween the | |||
"Round-trip-Delay between Src and Dst" is directionally ambiguous in | Source (Src) and the Destination (Dst) as provided in | |||
the text, this metric tightens the definition further to recognize | <xref target="RFC2681" sectionFormat="of" section="2.4"/> | |||
that the host in the "Src" role will send the first packet to "Dst", | is directionally ambiguous in the text, this metric | |||
and ultimately receive the corresponding return packet from "Dst" | tightens the definition further to recognize that the host in the | |||
(when neither are lost).</t> | Src Role will send the first packet to the host in the Dst Role | |||
and will ultimately receive the corresponding return packet from the | ||||
<t>Finally, note that the variable "dT" is used in <xref | Dst (when neither is lost).</t> | |||
target="RFC2681"/> to refer to the value of Round-trip delay in | <t indent="3">Finally, note that the variable "dT" is used in <xref ta | |||
metric definitions and methods. The variable "dT" has been re-used | rget="RFC2681" format="default"/> to refer to the value of round-trip delay in | |||
in other IPPM literature to refer to different quantities, and | metric definitions and methods. The variable "dT" has been reused | |||
in other IPPM literature to refer to different quantities and | ||||
cannot be used as a global variable name.</t> | cannot be used as a global variable name.</t> | |||
<t>Morton, A., "Round-trip Packet Loss Metrics", RFC 6673, August | <t>For loss:</t> | |||
2012.</t> | ||||
<t><xref target="RFC6673"/></t> | ||||
<t>Both delay and loss metrics employ a maximum waiting time for | <t indent="3">Morton, A., "Round-Trip Packet Loss Metrics", RFC 6673, | |||
DOI 10.17487/RFC6673, August 2012, | ||||
<https://www.rfc-editor.org/info/rfc6673>. | ||||
<xref target="RFC6673"/></t> | ||||
<t>Both Delay and Loss metrics employ a maximum waiting time for | ||||
received packets, so the count of lost packets to total packets sent | received packets, so the count of lost packets to total packets sent | |||
is the basis for the loss ratio calculation as per Section 6.1 of | is the basis for the loss ratio calculation as per <xref target="RFC66 | |||
<xref target="RFC6673"/>.</t> | 73" sectionFormat="of" section="6.1"/>.</t> | |||
</section> | </section> | |||
<!-- 9.2.2 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Fixed Parameters</name> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>Type-P as defined in <xref target="RFC2330" sectionFormat="of" sec | ||||
tion="13"/>:</dt><dd><t/> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv4 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>TTL:</dt><dd>Set to 255</dd> | ||||
<dt>Protocol:</dt><dd>Set to 01 (ICMP)</dd> | ||||
</dl> | ||||
</dd> | ||||
<section title="Fixed Parameters"> | <dt>IPv6 header values:</dt> | |||
<t>Type-P as defined in Section 13 of <xref target="RFC2330"/>: | <dd><t/> | |||
<list style="symbols"> | <dl newline="false" spacing="compact"> | |||
<t>IPv4 header values: <list style="symbols"> | <dt>DSCP:</dt><dd>Set to 0</dd> | |||
<t>DSCP: set to 0</t> | <dt>Hop Count:</dt><dd>Set to 255</dd> | |||
<dt>Next Header:</dt><dd>Set to 128 decimal (ICMP)</dd> | ||||
<t>TTL: set to 255</t> | <dt>Flow Label:</dt><dd>Set to 0</dd> | |||
<dt>Extension Headers:</dt><dd>None</dd> | ||||
<t>Protocol: Set to 01 (ICMP)</t> | </dl> | |||
</list></t> | </dd> | |||
<t>IPv6 header values:<list style="symbols"> | ||||
<t>DSCP: set to 0</t> | ||||
<t>Hop Count: set to 255</t> | ||||
<t>Next Header: set to 128 decimal (ICMP)</t> | ||||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>ICMP header values: <list style="symbols"> | ||||
<t>Type: 8 (Echo Request)</t> | ||||
<t>Code: 0</t> | ||||
<t>Checksum: the checksum MUST be calculated and the | ||||
non-zero checksum included in the header</t> | ||||
<t>(Identifier and Sequence Number set at Run-Time)</t> | <dt>ICMP header values:</dt> | |||
</list></t> | <dd><t/> | |||
<dl newline="false" spacing="compact"> | ||||
<dt>Type:</dt><dd>8 (Echo Request)</dd> | ||||
<dt>Code:</dt><dd>0</dd> | ||||
<dt>Checksum:</dt><dd>The checksum <bcp14>MUST</bcp14> be calculate | ||||
d and the | ||||
non-zero checksum included in the header</dd> | ||||
<dt>(Identifier and sequence number set at runtime)</dt><dd/> | ||||
</dl> | ||||
</dd> | ||||
<t>ICMP Payload <list style="symbols"> | <dt>ICMP Payload:</dt> | |||
<t>total of 32 bytes of random info, constant per test.</t> | <dd>Total of 32 bytes of random information, constant per test</dd> | |||
</list></t> | </dl> | |||
</list></t> | </dd> | |||
</dl> | ||||
<t>Other measurement parameters:<list style="symbols"> | <dl newline="true" spacing="normal"> | |||
<t>Tmax: a loss threshold waiting time<list style="symbols"> | <dt>Other measurement Parameters:</dt> | |||
<t>3.0, expressed in units of seconds, as a positive value | <dd><t/> | |||
of type decimal64 with fraction digits = 4 (see section 9.3 | <dl newline="false" spacing="normal"> | |||
of <xref target="RFC6020"/>) and with resolution of 0.0001 | <dt>Tmax:</dt> | |||
seconds (0.1 ms), with lossless conversion to/from the | <dd>A loss threshold waiting time with value 3.0, expressed in un | |||
32-bit NTP timestamp as per section 6 of <xref | its of seconds, as a positive value | |||
target="RFC5905"/>.</t> | of type decimal64 with fraction digits = 4 (see <xref target="RFC | |||
</list></t> | 6020" sectionFormat="of" section="9.3"/>) and with a resolution of 0.0001 | |||
</list></t> | seconds (0.1 ms), with lossless conversion to/from the | |||
32-bit NTP timestamp as per <xref target="RFC5905" | ||||
sectionFormat="of" section="6"/>.</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section title="Method of Measurement"> | <!-- 9.3 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Method of Measurement</name> | ||||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<section title="Reference Method"> | ||||
<t>The methodology for this metric is defined as | ||||
Type-P-Round-trip-Delay-Poisson-Stream in section 2.6 of <xref | ||||
target="RFC2681">RFC 2681</xref> and section 3.6 of <xref | ||||
target="RFC2681">RFC 2681</xref> using the Type-P and Tmax defined | ||||
under Fixed Parameters.</t> | ||||
<!-- 9.3.1 --> | ||||
<section numbered="true" toc="default"> | ||||
<name>Reference Methods</name> | ||||
<t>The methodology for this metric (equivalent to | ||||
Type-P-Round-trip-Delay-Poisson-Stream) is defined as in <xref target= | ||||
"RFC2681" | ||||
sectionFormat="of" section="2.6"/> (for singletons) and <xref | ||||
target="RFC2681" sectionFormat="of" section="3.6"/> (for samples) | ||||
using the Type-P and Tmax defined in the Fixed Parameters column.</t> | ||||
<t>The reference method distinguishes between long-delayed packets | <t>The reference method distinguishes between long-delayed packets | |||
and lost packets by implementing a maximum waiting time for packet | and lost packets by implementing a maximum waiting time for packet | |||
arrival. Tmax is the waiting time used as the threshold to declare a | arrival. Tmax is the waiting time used as the threshold to declare a | |||
packet lost. Lost packets SHALL be designated as having undefined | packet lost. Lost packets <bcp14>SHALL</bcp14> be designated as having | |||
delay, and counted for the RTLoss metric.</t> | undefined | |||
delay and counted for the RTLoss metric.</t> | ||||
<t>The calculations on the delay (RTD) SHALL be performed on the | <t>The calculations on the delay (RTD) <bcp14>SHALL</bcp14> be perform | |||
ed on the | ||||
conditional distribution, conditioned on successful packet arrival | conditional distribution, conditioned on successful packet arrival | |||
within Tmax. Also, when all packet delays are stored, the process | within Tmax. Also, when all packet delays are stored, the process | |||
which calculates the RTD value MUST enforce the Tmax threshold on | that calculates the RTD value <bcp14>MUST</bcp14> enforce the Tmax thr | |||
stored values before calculations. See section 4.1 of <xref | eshold on | |||
target="RFC3393"/> for details on the conditional distribution to | stored values before calculations. See <xref target="RFC3393" sectionF | |||
exclude undefined values of delay, and Section 5 of <xref | ormat="of" section="4.1"/> for details on the conditional distribution to | |||
target="RFC6703"/> for background on this analysis choice.</t> | exclude undefined values of delay, and see <xref target="RFC6703" sect | |||
ionFormat="of" section="5"/> for background on this analysis choice.</t> | ||||
<t>The reference method requires some way to distinguish between | <t>The reference method requires some way to distinguish between | |||
different packets in a stream to establish correspondence between | different packets in a stream to establish correspondence between | |||
sending times and receiving times for each successfully-arriving | sending times and receiving times for each successfully arriving | |||
packet. Sequence numbers or other send-order identification MUST be | packet. Sequence numbers or other send-order identification <bcp14>MUS | |||
T</bcp14> be | ||||
retained at the Src or included with each packet to disambiguate | retained at the Src or included with each packet to disambiguate | |||
packet reordering if it occurs.</t> | packet reordering if it occurs.</t> | |||
<t>The measurement process will determine the sequence numbers | <t>The measurement process will determine the sequence numbers | |||
applied to test packets after the Fixed and Runtime parameters are | applied to test packets after the Fixed and Runtime Parameters are | |||
passed to that process. The ICMP measurement process and protocol | passed to that process. The ICMP measurement process and protocol | |||
will dictate the format of sequence numbers and other | will dictate the format of sequence numbers and other | |||
identifiers.</t> | Identifiers.</t> | |||
<t>Refer to <xref target="RFC6673" sectionFormat="of" section="4.4"/> | ||||
<t>Refer to Section 4.4 of <xref target="RFC6673"/> for expanded | for an expanded | |||
discussion of the instruction to "send a Type-P packet back to the | discussion of the instruction to "send a Type-P packet back to the | |||
Src as quickly as possible" in Section 2.6 of <xref | Src as quickly as possible" in <xref target="RFC2681" sectionFormat="o | |||
target="RFC2681">RFC 2681</xref>. Section 8 of <xref | f" section="2.6"/>. <xref target="RFC6673" sectionFormat="of" section="8"/> pres | |||
target="RFC6673"/> presents additional requirements which MUST be | ents additional requirements that <bcp14>MUST</bcp14> be | |||
included in the method of measurement for this metric.</t> | included in the Method of Measurement for this metric.</t> | |||
</section> | </section> | |||
<!-- 9.3.2 --> | ||||
<section title="Packet Stream Generation"> | <section numbered="true" toc="default"> | |||
<t>This section gives the details of the packet traffic which is the | <name>Packet Stream Generation</name> | |||
basis for measurement. In IPPM metrics, this is called the Stream, | <t>This section provides details regarding packet traffic, which is | |||
and can easily be described by providing the list of stream | used as the | |||
parameters.</t> | basis for measurement. In IPPM Metrics, this is called the "stream"; | |||
this stream can easily be described by providing the list of stream | ||||
Parameters.</t> | ||||
<t>The ICMP metrics use a sending discipline called "SendOnRcv" or | <t>The ICMP metrics use a sending discipline called "SendOnRcv" or | |||
Send On Receive. This is a modification of Section 3 of <xref | Send On Receive. This is a modification of <xref target="RFC3432" sect | |||
target="RFC3432"/>, which prescribes the method for generating | ionFormat="of" section="3"/>, which prescribes the method for generating | |||
Periodic streams using associated parameters as defined below for | Periodic streams using associated Parameters as defined below for | |||
this description:</t> | this description:</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>incT:</dt> | |||
<t hangText="incT">the nominal duration of inter-packet | <dd>The nominal duration of the inter-packet | |||
interval, first bit to first bit</t> | interval, first bit to first bit.</dd> | |||
<dt>dT:</dt> | ||||
<t hangText="dT">the duration of the interval for allowed sample | <dd>The duration of the interval for allowed sample | |||
start times</t> | start times.</dd> | |||
</list></t> | </dl> | |||
<t>The incT stream Parameter will be specified as a Runtime | ||||
<t>The incT stream parameter will be specified as a Run-time | Parameter, and dT is not used in SendOnRcv.</t> | |||
parameter, and dT is not used in SendOnRcv.</t> | ||||
<t>A SendOnRcv sender behaves exactly like a Periodic stream | <t>A SendOnRcv sender behaves exactly like a Periodic stream | |||
generator while all reply packets arrive with RTD < incT, and the | generator while all reply packets arrive with RTD < incT, and the | |||
inter-packet interval will be constant.</t> | inter-packet interval will be constant.</t> | |||
<t>If a reply packet arrives with RTD >= incT, then the | <t>If a reply packet arrives with RTD >= incT, then the | |||
inter-packet interval for the next sending time is nominally | inter-packet interval for the next sending time is nominally | |||
RTD.</t> | RTD.</t> | |||
<t>If a reply packet fails to arrive within Tmax, then the | <t>If a reply packet fails to arrive within Tmax, then the | |||
inter-packet interval for the next sending time is nominally | inter-packet interval for the next sending time is nominally | |||
Tmax.</t> | Tmax.</t> | |||
<t>If an immediate Send On Reply arrival is desired, then set | ||||
<t>If an immediate send on reply arrival is desired, then set | incT = 0.</t> | |||
incT=0.</t> | ||||
</section> | </section> | |||
<section title="Traffic Filtering (observation) Details"> | <!-- 9.3.3 --> | |||
<t>NA</t> | <section numbered="true" toc="default"> | |||
<name>Traffic Filtering (Observation) Details</name> | ||||
<t>N/A</t> | ||||
</section> | </section> | |||
<section title="Sampling Distribution"> | <!-- 9.3.4 --> | |||
<t>NA</t> | <section numbered="true" toc="default"> | |||
<name>Sampling Distribution</name> | ||||
<t>N/A</t> | ||||
</section> | </section> | |||
<section title="Run-time Parameters and Data Format"> | <!-- 9.3.5 --> | |||
<t>Run-time Parameters are input factors that must be determined, | <section numbered="true" toc="default"> | |||
<name>Runtime Parameters and Data Format</name> | ||||
<t>Runtime Parameters are input factors that must be determined, | ||||
configured into the measurement system, and reported with the | configured into the measurement system, and reported with the | |||
results for the context to be complete.</t> | results for the context to be complete.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Src:</dt> | |||
<t hangText="Src">the IP address of the host in the Src Role | <dd>The IP address of the host in the Src Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>Dst:</dt> | ||||
<t hangText="Dst">the IP address of the host in the Dst Role | <dd>The IP address of the host in the Dst Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>incT:</dt> | ||||
<t hangText="incT">the nominal duration of inter-packet | <dd>The nominal duration of the inter-packet | |||
interval, first bit to first bit, expressed in units of seconds, | interval, first bit to first bit, expressed in units of seconds, | |||
as a positive value of type decimal64 with fraction digits = 4 | as a positive value of type decimal64 with fraction digits = 4 | |||
(see section 9.3 of <xref target="RFC6020"/>) and with | (see <xref target="RFC6020" sectionFormat="of" section="9.3"/>) | |||
resolution of 0.0001 seconds (0.1 ms).</t> | and with a resolution of 0.0001 seconds (0.1 ms).</dd> | |||
<dt>T0:</dt> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dd>A time, the start of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time is unspecified and Tf is to be interpreted as the Duration | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", a start | |||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Count:</dt> | ||||
<t hangText="Count">The total count of ICMP Echo Requests to | <dd>The total count of ICMP Echo Requests to | |||
send, formatted as a uint16, as per section 9.2 of <xref | send, formatted as a uint16, as per <xref target="RFC6020" section | |||
target="RFC6020"/>.</t> | Format="of" section="9.2"/>.</dd> | |||
</list></t> | </dl> | |||
<t>See the Packet Stream Generation section for | ||||
<t>(see the Packet Stream Generation section for additional Run-time | additional Runtime Parameters.</t> | |||
parameters)</t> | ||||
</section> | </section> | |||
<section title="Roles"> | <!-- 9.3.6 --> | |||
<t><list style="hanging"> | <section numbered="true" toc="default"> | |||
<t hangText="Src">launches each packet and waits for return | <name>Roles</name> | |||
transmissions from Dst.</t> | <dl newline="false" spacing="normal"> | |||
<dt>Src:</dt> | ||||
<t hangText="Dst">waits for each packet from Src and sends a | <dd>Launches each packet and waits for return | |||
return packet to Src.</t> | transmissions from the Dst.</dd> | |||
</list></t> | <!-- Section 9.3.6 --> | |||
<dt>Dst:</dt> | ||||
<dd>Waits for each packet from the Src and sends a return packet to | ||||
the Src (ICMP Echo Reply, Type 0).</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section title="Output"> | <!-- 9.4 --> | |||
<t>This category specifies all details of the Output of measurements | <section numbered="true" toc="default"> | |||
<name>Output</name> | ||||
<t>This category specifies all details of the output of measurements | ||||
using the metric.</t> | using the metric.</t> | |||
<section title="Type"> | <!-- 9.4.1 --> | |||
<t>See subsection titles in Reference Definition for Latency | <section numbered="true" toc="default"> | |||
Types.</t> | <name>Type</name> | |||
<t>Latency and Loss Types are discussed in the subsections below.</t> | ||||
<t>LossRatio -- the count of lost packets to total packets sent is | ||||
the basis for the loss ratio calculation as per Section 6.1 of <xref | ||||
target="RFC6673"/>.</t> | ||||
</section> | </section> | |||
<section title="Reference Definition"> | <!-- 9.4.2 --> | |||
<t>For all output types ---<list style="hanging"> | <section numbered="true" toc="default"> | |||
<t hangText="T0">the start of a measurement interval, (format | <name>Reference Definition</name> | |||
"date-and-time" as specified in Section 5.6 of <xref | <t>For all output types:</t> | |||
target="RFC3339"/>, see also Section 3 of <xref | <dl newline="false" spacing="normal"> | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | <dt>T0:</dt> | |||
6.1 of <xref target="RFC2330"/>.</t> | <dd>The start of a measurement interval (format | |||
"date&nbhy;time" as specified in <xref target="RFC3339" | ||||
<t hangText="Tf">the end of a measurement interval, (format | sectionFormat="of" section="5.6"/>; see also | |||
"date-and-time" as specified in Section 5.6 of <xref | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
target="RFC3339"/>, see also Section 3 of <xref | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | tionFormat="of" section="6.1"/>.</dd> | |||
6.1 of <xref target="RFC2330"/>.</t> | <dt>Tf:</dt> | |||
<dd>The end of a measurement interval (format | ||||
<t hangText="TotalCount">the count of packets actually sent by | "date&nbhy;time" as specified in <xref target="RFC3339" | |||
the Src to Dst during the measurement interval.</t> | sectionFormat="of" section="5.6"/>; see also | |||
</list></t> | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
"of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | ||||
<t>For LossRatio -- the count of lost packets to total packets sent | tionFormat="of" section="6.1"/>.</dd> | |||
is the basis for the loss ratio calculation as per Section 4.1 of | <dt>TotalCount:</dt> | |||
<xref target="RFC7680"/>.</t> | <dd>The count of packets actually sent by | |||
the Src to the Dst during the measurement interval.</dd> | ||||
<t>For each <statistic>, one of the following sub-sections | </dl> | |||
apply:</t> | <t>For each <statistic> or Percent_LossRatio, one of the followi | |||
ng subsections | ||||
<section title="Mean"> | applies.</t> | |||
<t>The mean SHALL be calculated using the conditional distribution | <!-- 9.4.2.1 --> | |||
of all packets with a finite value of Round-trip delay (undefined | <section numbered="true" toc="default"> | |||
delays are excluded), a single value as follows:</t> | <name>Mean</name> | |||
<t>The mean <bcp14>SHALL</bcp14> be calculated using the conditional | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | distribution | |||
of all packets with a finite value of round-trip delay (undefined | ||||
delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.2.2"/> f | ||||
<t>See section 4.2.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.2.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.2.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Mean:</dt> | |||
<t hangText="Mean">The time value of the result is expressed | <dd>The time value of the result is expressed | |||
in units of seconds, as a positive value of type decimal64 | in units of seconds, as a positive value of type decimal64 | |||
with fraction digits = 9 (see section 9.3 of <xref | with fraction digits = 9 (see <xref target="RFC6020" sectionForm | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | at="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Min"> | <!-- 9.4.2.2 --> | |||
<t>The minimum SHALL be calculated using the conditional | <section numbered="true" toc="default"> | |||
distribution of all packets with a finite value of Round-trip | <name>Min</name> | |||
delay (undefined delays are excluded), a single value as | <t>The minimum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
nal | ||||
distribution of all packets with a finite value of round-trip | ||||
delay (undefined delays are excluded) -- a single value, as | ||||
follows:</t> | follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | details on the | |||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.3.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.3.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Min:</dt> | |||
<t hangText="Min">The time value of the result is expressed in | <dd>The time value of the result is expressed in | |||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section title="Max"> | <!-- 9.4.2.3 --> | |||
<t>The maximum SHALL be calculated using the conditional | <section numbered="true" toc="default"> | |||
distribution of all packets with a finite value of Round-trip | <name>Max</name> | |||
delay (undefined delays are excluded), a single value as | <t>The maximum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
nal | ||||
distribution of all packets with a finite value of round-trip | ||||
delay (undefined delays are excluded) -- a single value, as | ||||
follows:</t> | follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | details on the | |||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
or a closely | ||||
related method for calculating this statistic; see also <xref target | ||||
="RFC6049" sectionFormat="of" section="4.3.3"/>. The formula is as follows:</t> | ||||
<artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
Max = (FiniteDelay[j]) | ||||
]]></artwork> | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for a closely | <ul empty="true"> | |||
related method for calculating this statistic, and 4.3.3 of <xref | <li>such that for some index, j, where 1 <= j <= N | |||
target="RFC6049"/>. The formula is as follows:</t> | FiniteDelay[j] >= FiniteDelay[n] for all n</li> | |||
</ul> | ||||
<t><figure> | <dl newline="false" spacing="normal"> | |||
<artwork><![CDATA[ Max = (FiniteDelay [j]) | <dt>Max:</dt> | |||
<dd>The time value of the result is expressed in | ||||
such that for some index, j, where 1 <= j <= N | ||||
FiniteDelay[j] >= FiniteDelay[n] for all n]]></artwork> | ||||
</figure></t> | ||||
<t><list style="hanging"> | ||||
<t hangText="Max">The time value of the result is expressed in | ||||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
</section> | <!-- 9.4.2.4 --> | |||
<section> | ||||
<name>Percent_LossRatio</name> | ||||
<t>For LossRatio, the count of lost packets to total packets sent is | ||||
the basis for the loss ratio calculation as per <xref target="RFC7680" sectionFo | ||||
rmat="of" section="4.1"/>.</t> | ||||
<dl> | ||||
<dt>Percent_LossRatio:</dt><dd>The numeric value of the result is | ||||
expressed in units of lost packets to total packets times 100%, as a | ||||
positive value of type decimal64 with fraction digits = 9 (see <xref | ||||
target="RFC6020" sectionFormat="of" section="9.3"/>) with a | ||||
resolution of 0.0000000001.</dd></dl> | ||||
</section> | ||||
<section title="Metric Units"> | </section> | |||
<t>The <statistic> of Round-trip Delay is expressed in | <!-- 9.4.3 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Metric Units</name> | ||||
<t>The <statistic> of round-trip delay is expressed in | ||||
seconds, where <statistic> is one of:</t> | seconds, where <statistic> is one of:</t> | |||
<ul spacing="normal"> | ||||
<t><list style="symbols"> | <li>Mean</li> | |||
<t>Mean</t> | <li>Min</li> | |||
<li>Max</li> | ||||
<t>Min</t> | </ul> | |||
<t>The round-trip loss ratio is expressed as a percentage of lost | ||||
<t>Max</t> | ||||
</list></t> | ||||
<t>The Round-trip Loss Ratio is expressed as a percentage of lost | ||||
packets to total packets sent.</t> | packets to total packets sent.</t> | |||
</section> | ||||
<section title="Calibration"> | </section> | |||
<t>Section 3.7.3 of <xref target="RFC7679"/> provides a means to | <!-- 9.4.4 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Calibration</name> | ||||
<t><xref target="RFC7679" sectionFormat="of" section="3.7.3"/> provide | ||||
s a means to | ||||
quantify the systematic and random errors of a time measurement. | quantify the systematic and random errors of a time measurement. | |||
In-situ calibration could be enabled with an internal loopback at | Calibration in-situ could be enabled with an internal loopback at | |||
the Source host that includes as much of the measurement system as | the Source host that includes as much of the measurement system as | |||
possible, performs address manipulation as needed, and provides some | possible, performs address manipulation as needed, and provides some | |||
form of isolation (e.g., deterministic delay) to avoid send-receive | form of isolation (e.g., deterministic delay) to avoid send-receive | |||
interface contention. Some portion of the random and systematic | interface contention. Some portion of the random and systematic | |||
error can be characterized this way.</t> | error can be characterized in this way.</t> | |||
<t>When a measurement controller requests a calibration measurement, | <t>When a measurement controller requests a calibration measurement, | |||
the loopback is applied and the result is output in the same format | the loopback is applied and the result is output in the same format | |||
as a normal measurement with additional indication that it is a | as a normal measurement, with an additional indication that it is a | |||
calibration result.</t> | calibration result.</t> | |||
<t>Both internal loopback calibration and clock synchronization can | <t>Both internal loopback calibration and clock synchronization can | |||
be used to estimate the available accuracy of the Output Metric | be used to estimate the available accuracy of the Output Metric | |||
Units. For example, repeated loopback delay measurements will reveal | Units. For example, repeated loopback delay measurements will reveal | |||
the portion of the Output result resolution which is the result of | the portion of the output result resolution that is the result of | |||
system noise, and thus inaccurate.</t> | system noise and is thus inaccurate.</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section title="Administrative items"> | <!-- 9.5 --> | |||
<t/> | <section numbered="true" toc="default"> | |||
<name>Administrative Items</name> | ||||
<section title="Status"> | <!-- 9.5.1 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Status</name> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<section title="Requester"> | <!-- 9.5.2 --> | |||
<t>This RFC number</t> | <section numbered="true" toc="default"> | |||
<name>Requester</name> | ||||
<t>RFC 8912</t> | ||||
</section> | </section> | |||
<section title="Revision"> | <!-- 9.5.3 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Revision</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<section title="Revision Date"> | <!-- 9.5.4 --> | |||
<t>YYYY-MM-DD</t> | <section numbered="true" toc="default"> | |||
<name>Revision Date</name> | ||||
<t>2021-11-17</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Comments and Remarks"> | <name>Comments and Remarks</name> | |||
<t>None</t> | <t>None</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section anchor="tcp-rt-delay-loss-reg-entries" numbered="true" toc="default | ||||
"> | ||||
<!-- Section 10 --> | ||||
<name>TCP Round-Trip Delay and Loss Registry Entries</name> | ||||
<section title="TCP Round-Trip Delay and Loss Registry Entries"> | <t>This section specifies four initial Registry Entries for the Passive | |||
<t>This section specifies three initial registry entries for the Passive | assessment of TCP Round-Trip Delay (RTD) and another entry for the TCP | |||
assessment of TCP Round-Trip Delay (RTD) and another entry for TCP | Round-Trip Loss Count.</t> | |||
Round-trip Loss Count.</t> | ||||
<t>IANA Note: Registry "Name" below specifies multiple registry entries, | ||||
whose output format varies according to the <statistic> element of | ||||
the name that specifies one form of statistical summary. There are two | ||||
additional metric names for Singleton RT Delay and Packet Count | ||||
metrics.</t> | ||||
<t>All column entries beside the ID, Name, Description, and Output | ||||
Reference Method categories are the same, thus this section proposes | ||||
four closely-related registry entries. As a result, IANA is also asked | ||||
to assign corresponding URLs to each Named Metric.</t> | ||||
<section title="Summary"> | <t>All column entries besides the ID, Name, Description, and Output | |||
<t>This category includes multiple indexes to the registry entry: the | Reference Method categories are the same; thus, this section defines | |||
element ID and metric name.</t> | four closely related Registry Entries. As a result, IANA has | |||
assigned corresponding URLs to each of the four Named Metrics.</t> | ||||
<section title="ID (Identifier)"> | <section numbered="true" toc="default"> | |||
<t>IANA is asked to assign different numeric identifiers to each of | <!-- 10.1 --> | |||
the four Named Metrics.</t> | <name>Summary</name> | |||
<t>This category includes multiple indexes to the Registry Entries: the | ||||
element ID and Metric Name.</t> | ||||
<section numbered="true" toc="default"> | ||||
<!-- 10.1.1 --> | ||||
<name>ID (Identifier)</name> | ||||
<t>IANA has allocated the numeric Identifiers 22-26 for the five | ||||
Named Metric Entries in <xref target="tcp-rt-delay-loss-reg-entries"/>. See | ||||
<xref target="name1012"/> for mapping to Names.</t> | ||||
</section> | </section> | |||
<section title="Name"> | <section anchor="name1012" numbered="true" toc="default"> | |||
<t>RTDelay_Passive_IP-TCP_RFCXXXXsec10_Seconds_<statistic></t> | <!-- 10.1.2 --> | |||
<name>Name</name> | ||||
<t>where <statistic> is one of:</t> | <dl spacing="normal" newline="false" indent="5"> | |||
<dt>22:</dt><dd>RTDelay_Passive_IP-TCP_RFC8912sec10_Seconds_Mean</dd> | ||||
<t><list style="symbols"> | <dt>23:</dt><dd>RTDelay_Passive_IP-TCP_RFC8912sec10_Seconds_Min</dd> | |||
<t>Mean</t> | <dt>24:</dt><dd>RTDelay_Passive_IP-TCP_RFC8912sec10_Seconds_Max</dd> | |||
<dt>25:</dt><dd>RTDelay_Passive_IP-TCP-HS_RFC8912sec10_Seconds_Singl | ||||
<t>Min</t> | eton</dd> | |||
</dl> | ||||
<t>Max</t> | <t>Note that a midpoint observer only has the opportunity to | |||
</list></t> | compose a single RTDelay on the TCP handshake.</t> | |||
<dl spacing="normal" newline="false" indent="5"> | ||||
<t>RTDelay_Passive_IP-TCP-HS_RFCXXXXsec10_Seconds_Singleton</t> | <dt>26:</dt><dd>RTLoss_Passive_IP-TCP_RFC8912sec10_Packet_Count</dd> | |||
</dl> | ||||
<t>Note that a mid-point observer only has the opportunity to | ||||
compose a single RTDelay on the TCP Hand Shake.</t> | ||||
<t>RTLoss_Passive_IP-TCP_RFCXXXXsec10_Packet_Count</t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="URI"> | <!-- 10.1.3 --> | |||
<t>URL: https://www.iana.org/ ... <name></t> | <name>URI</name> | |||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay | ||||
_Passive_IP-TCP_RFC8912sec10_Seconds_Mean" /></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay_ | ||||
Passive_IP-TCP_RFC8912sec10_Seconds_Min"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay_ | ||||
Passive_IP-TCP_RFC8912sec10_Seconds_Max"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTDelay_ | ||||
Passive_IP-TCP-HS_RFC8912sec10_Seconds_Singleton"/></t> | ||||
<t>URL: <eref target="https://www.iana.org/performance-metrics/RTLoss_P | ||||
assive_IP-TCP_RFC8912sec10_Packet_Count"/></t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Description"> | <!-- 10.1.4 --> | |||
<t>RTDelay: This metric assesses the round-trip delay of TCP packets | <name>Description</name> | |||
<dl newline="false" spacing="normal"> | ||||
<dt>RTDelay:</dt><dd><t>This metric assesses the round-trip delay of T | ||||
CP packets | ||||
constituting a single connection, exchanged between two hosts. We | constituting a single connection, exchanged between two hosts. We | |||
consider the measurement of round-trip delay based on a single | consider the measurement of round-trip delay based on a single | |||
Observation Point <xref target="RFC7011"/> somewhere in the network. | Observation Point (OP) <xref target="RFC7011" format="default"/> somew | |||
The Output is the Round-trip delay for all successfully exchanged | here in the network. | |||
The output is the round-trip delay for all successfully exchanged | ||||
packets expressed as the <statistic> of their conditional | packets expressed as the <statistic> of their conditional | |||
delay distribution, where <statistic> is one of:</t> | delay distribution, where <statistic> is one of:</t> | |||
<t><list style="symbols"> | <ul spacing="normal"> | |||
<t>Mean</t> | <li>Mean</li> | |||
<li>Min</li> | ||||
<t>Min</t> | <li>Max</li> | |||
</ul> | ||||
<t>Max</t> | </dd> | |||
</list></t> | <dt>RTDelay Singleton:</dt><dd><t>This metric assesses the round-trip del | |||
ay of TCP packets | ||||
initiating a single connection (or 3-way handshake), exchanged between tw | ||||
o hosts. We | ||||
consider the measurement of round-trip delay based on a single | ||||
Observation Point (OP) <xref target="RFC7011"/> somewhere in the network. | ||||
The | ||||
output is the single measurement of Round-trip delay, or Singleton.</t></dd | ||||
> | ||||
<t>RTLoss: This metric assesses the estimated loss count for TCP | <dt>RTLoss:</dt><dd>This metric assesses the estimated loss count for TCP | |||
packets constituting a single connection, exchanged between two | packets constituting a single connection, exchanged between two | |||
hosts. We consider the measurement of round-trip delay based on a | hosts. We consider the measurement of round-trip delay based on a | |||
single Observation Point <xref target="RFC7011"/> somewhere in the | single OP <xref target="RFC7011" format="default"/> somewhere in the | |||
network. The Output is the estimated Loss Count for the measurement | network. The output is the estimated loss count for the measurement | |||
interval.</t> | interval.</dd> | |||
</dl> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Change Controller"> | <!-- 10.1.5 --> | |||
<name>Change Controller</name> | ||||
<t>IETF</t> | <t>IETF</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Version (of Registry Format)"> | <!-- 10.1.6 --> | |||
<name>Version (of Registry Format)</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Metric Definition"> | <!-- 10.2 --> | |||
<name>Metric Definition</name> | ||||
<t>This category includes columns to prompt the entry of all necessary | <t>This category includes columns to prompt the entry of all necessary | |||
details related to the metric definition, including the RFC reference | details related to the metric definition, including the RFC reference | |||
and values of input factors, called fixed parameters.</t> | and values of input factors, called "Fixed Parameters".</t> | |||
<section numbered="true" toc="default" anchor="s10.2.1"> | ||||
<section title="Reference Definitions"> | <!-- 10.2.1 --> | |||
<t>Although there is no RFC that describes passive measurement of | <name>Reference Definition</name> | |||
Round-Trip Delay, the parallel definition for Active measurement | ||||
is:</t> | ||||
<t>Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay | <t>Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay | |||
Metric for IPPM", RFC 2681, September 1999.</t> | Metric for IPPM", RFC 2681, DOI 10.17487/RFC2681, September 1999, | |||
<https://www.rfc-editor.org/info/rfc2681>. | ||||
<t><xref target="RFC2681"/></t> | <xref target="RFC2681"/></t> | |||
<t>Although there is no RFC that describes Passive Measurement of | ||||
<t>This metric definition uses the terms singleton and sample as | round-trip delay, the parallel definition for Active Measurement | |||
defined in Section 11 of <xref target="RFC2330"/>. (Section 2.4 of | is provided in <xref target="RFC2681"/>.</t> | |||
<xref target="RFC2681"/> provides the reference definition of the | <t>This metric definition uses the term "wire time" as defined in <xre | |||
singleton (single value) Round-trip delay metric. Section 3.4 of | f target="RFC2330" sectionFormat="of" section="10.2"/>, and the terms "singleton | |||
<xref target="RFC2681"/> provides the reference definition expanded | " and "sample" as | |||
defined in <xref target="RFC2330" sectionFormat="of" section="11"/>. | ||||
(<xref target="RFC2681" sectionFormat="of" section="2.4"/> | ||||
provides the reference definition of the | ||||
singleton (single value) round-trip delay metric. <xref target="RFC268 | ||||
1" sectionFormat="of" section="3.4"/> provides the reference definition expanded | ||||
to cover a multi-singleton sample.)</t> | to cover a multi-singleton sample.)</t> | |||
<t>With the OP <xref target="RFC7011" format="default"/> | ||||
<t>With the Observation Point <xref target="RFC7011"/> (OP) | ||||
typically located between the hosts participating in the TCP | typically located between the hosts participating in the TCP | |||
connection, the Round-trip Delay metric requires two individual | connection, the round-trip delay metric requires two individual | |||
measurements between the OP and each host, such that the Spatial | measurements between the OP and each host, such that the Spatial | |||
Composition <xref target="RFC6049"/>of the measurements yields a | Composition <xref target="RFC6049" format="default"/> of the measureme | |||
Round-trip Delay singleton (we are extending the composition of | nts yields a | |||
round-trip delay singleton (we are extending the composition of | ||||
one-way subpath delays to subpath round-trip delay).</t> | one-way subpath delays to subpath round-trip delay).</t> | |||
<t>Using the direction of TCP SYN transmission to anchor the | <t>Using the direction of TCP SYN transmission to anchor the | |||
nomenclature, host A sends the SYN and host B replies with SYN-ACK | nomenclature, host A sends the SYN, and host B replies with SYN-ACK | |||
during connection establishment. The direction of SYN transfer is | during connection establishment. The direction of SYN transfer is | |||
considered the Forward direction of transmission, from A through OP | considered the Forward direction of transmission, from A through the O | |||
to B (Reverse is B through OP to A).</t> | P | |||
to B (the Reverse direction is B through the OP to A).</t> | ||||
<t>Traffic filters reduce the packet stream at the OP to a Qualified | <t>Traffic Filters reduce the packet streams at the OP to a Qualified | |||
bidirectional flow of packets.</t> | bidirectional flow of packets.</t> | |||
<t>In the definitions below, Corresponding Packets are transferred | <t>In the definitions below, Corresponding Packets are transferred | |||
in different directions and convey a common value in a TCP header | in different directions and convey a common value in a TCP header | |||
field that establishes correspondence (to the extent possible). | field that establishes correspondence (to the extent possible). | |||
Examples may be found in the TCP timestamp fields.</t> | Examples may be found in the TCP timestamp fields.</t> | |||
<t>For a real number, RTD_fwd, >> the round-trip delay in the | ||||
<t>For a real number, RTD_fwd, >> the Round-trip Delay in the | Forward direction from the OP to host B at time T' is RTD_fwd << | |||
Forward direction from OP to host B at time T' is RTD_fwd << | it is <bcp14>REQUIRED</bcp14> that the OP observed a Qualified Packet | |||
it is REQUIRED that OP observed a Qualified Packet to host B at | to host B at | |||
wire-time T', that host B received that packet and sent a | wire time T', that host B received that packet and sent a | |||
Corresponding Packet back to host A, and OP observed the | Corresponding Packet back to host A, and the OP observed the | |||
Corresponding Packet at wire-time T' + RTD_fwd.</t> | Corresponding Packet at wire time T' + RTD_fwd.</t> | |||
<t>For a real number, RTD_rev, >> the round-trip delay in the | ||||
<t>For a real number, RTD_rev, >> the Round-trip Delay in the | Reverse direction from the OP to host A at time T'' is RTD_rev << | |||
Reverse direction from OP to host A at time T'' is RTD_rev << | ; | |||
it is REQUIRED that OP observed a Qualified Packet to host A at | it is <bcp14>REQUIRED</bcp14> that the OP observed a Qualified Packet | |||
wire-time T'', that host A received that packet and sent a | to host A at | |||
Corresponding Packet back to host B, and that OP observed the | wire time T'', that host A received that packet and sent a | |||
Corresponding Packet at wire-time T'' + RTD_rev.</t> | Corresponding Packet back to host B, and that the OP observed the | |||
Corresponding Packet at wire time T'' + RTD_rev.</t> | ||||
<t>Ideally, the packet sent from host B to host A in both | <t>Ideally, the packet sent from host B to host A in both | |||
definitions above SHOULD be the same packet (or, when measuring | definitions above <bcp14>SHOULD</bcp14> be the same packet (or, when m easuring | |||
RTD_rev first, the packet from host A to host B in both definitions | RTD_rev first, the packet from host A to host B in both definitions | |||
should be the same).</t> | should be the same).</t> | |||
<t>The <bcp14>REQUIRED</bcp14> Composition Function for a singleton of | ||||
<t>The REQUIRED Composition Function for a singleton of Round-trip | round-trip | |||
Delay at time T (where T is the earliest of T' and T'' above) | delay at time T (where T is the earliest of T' and T'' above) | |||
is:</t> | is:</t> | |||
<t>RTDelay = RTD_fwd + RTD_rev</t> | <t>RTDelay = RTD_fwd + RTD_rev</t> | |||
<t>Note that when the OP is located at host A or host B, one of the | ||||
<t>Note that when OP is located at host A or host B, one of the | ||||
terms composing RTDelay will be zero or negligible.</t> | terms composing RTDelay will be zero or negligible.</t> | |||
<t>Using the abbreviation HS to refer to the TCP handshake: when the Q | ||||
<t>When the Qualified and Corresponding Packets are a TCP-SYN and a | ualified and Corresponding Packets are a TCP-SYN and a | |||
TCP-SYN-ACK, then RTD_fwd == RTD_HS_fwd.</t> | TCP&nbhy;SYN-ACK, RTD_fwd == RTD_HS_fwd.</t> | |||
<t>When the Qualified and Corresponding Packets are a TCP-SYN-ACK | <t>When the Qualified and Corresponding Packets are a TCP-SYN-ACK | |||
and a TCP-ACK, then RTD_rev == RTD_HS_rev.</t> | and a TCP-ACK, RTD_rev == RTD_HS_rev.</t> | |||
<t>The <bcp14>REQUIRED</bcp14> Composition Function for a singleton of | ||||
<t>The REQUIRED Composition Function for a singleton of Round-trip | round-trip | |||
Delay for the connection Hand Shake:</t> | delay for the connection handshake is:</t> | |||
<t>RTDelay_HS = RTD_HS_fwd + RTD_HS_rev</t> | <t>RTDelay_HS = RTD_HS_fwd + RTD_HS_rev</t> | |||
<t>The definition of round-trip loss count uses the nomenclature | ||||
<t>The definition of Round-trip Loss Count uses the nomenclature | ||||
developed above, based on observation of the TCP header sequence | developed above, based on observation of the TCP header sequence | |||
numbers and storing the sequence number gaps observed. Packet Losses | numbers and storing the sequence number gaps observed. Packet losses | |||
can be inferred from:<list style="symbols"> | can be inferred from:</t> | |||
<t>Out-of-order segments: TCP segments are transmitted with | <dl newline="false" spacing="normal"> | |||
<dt>Out-of-order segments:</dt><dd>TCP segments are transmitted with | ||||
monotonically increasing sequence numbers, but these segments | monotonically increasing sequence numbers, but these segments | |||
may be received out of order. Section 3 of <xref | may be received out of order. <xref target="RFC4737" sectionFormat | |||
target="RFC4737"/> describes the notion of "next expected" | ="of" section="3"/> describes the notion of "next expected" | |||
sequence numbers which can be adapted to TCP segments (for the | sequence numbers, which can be adapted to TCP segments (for the | |||
purpose of detecting reordered packets). Observation of | purpose of detecting reordered packets). Observation of | |||
out-of-order segments indicates loss on the path prior to the | out-of-order segments indicates loss on the path prior to the | |||
OP, and creates a gap.</t> | OP and creates a gap.</dd> | |||
<dt>Duplicate segments:</dt><dd><xref target="RFC5560" | ||||
<t>Duplicate segments: Section 2 of <xref target="RFC5560"/> | sectionFormat="of" section="2"/> defines identical packets and is | |||
defines identical packets and is suitable for evaluation of TCP | suitable for evaluation of TCP packets to detect | |||
packets to detect duplication. Observation of duplicate segments | duplication. Observation of a segment duplicates a segment | |||
*without a corresponding gap* indicates loss on the path | previously observed (and thus no corresponding observed segment | |||
following the OP (because they overlap part of the delivered | gap) indicates loss on the path following the OP (e.g., the | |||
sequence numbers already observed at OP).</t> | segment overlaps part of the octet stream already observed at the | |||
</list></t> | OP).</dd> | |||
</dl> | ||||
<t>Each observation of an out-of-order or duplicate infers a | <t>Each observation of an out-of-order or duplicate segment infers a | |||
singleton of loss, but composition of Round-trip Loss Counts will be | singleton of loss, but the composition of round-trip loss counts will | |||
conducted over a measurement interval which is synonymous with a | be | |||
conducted over a measurement interval that is synonymous with a | ||||
single TCP connection.</t> | single TCP connection.</t> | |||
<t>With the above observations in the Forward direction over a | <t>With the above observations in the Forward direction over a | |||
measurement interval, the count of out-of-order and duplicate | measurement interval, the count of out-of-order and duplicate | |||
segments is defined as RTL_fwd. Comparable observations in the | segments is defined as RTL_fwd. Comparable observations in the | |||
Reverse direction are defined as RTL_rev.</t> | Reverse direction are defined as RTL_rev.</t> | |||
<t>For a measurement interval (corresponding to a single TCP | <t>For a measurement interval (corresponding to a single TCP | |||
connection), T0 to Tf, the REQUIRED Composition Function for a the | connection) T0 to Tf, the <bcp14>REQUIRED</bcp14> Composition Function for the | |||
two single-direction counts of inferred loss is:</t> | two single-direction counts of inferred loss is:</t> | |||
<t>RTLoss = RTL_fwd + RTL_rev</t> | <t>RTLoss = RTL_fwd + RTL_rev</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<!-- 10.2.2 --> | ||||
<name>Fixed Parameters</name> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>Traffic Filters:</dt> | ||||
<dd><t/> | ||||
<dl newline="true" spacing="normal"> | ||||
<dt>IPv4 header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>DSCP:</dt><dd>Set to 0</dd> | ||||
<dt>Protocol:</dt><dd>Set to 06 (TCP)</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
<section title="Fixed Parameters"> | <dl newline="true" spacing="normal"> | |||
<t/> | <dt>IPv6 header values:</dt> | |||
<dd><t/> | ||||
<t>Traffic Filters: <list style="symbols"> | <dl newline="false" spacing="compact"> | |||
<t>IPv4 header values: <list style="symbols"> | <dt>DSCP:</dt><dd>Set to 0</dd> | |||
<t>DSCP: set to 0</t> | <dt>Hop Count:</dt><dd>Set to 255</dd> | |||
<dt>Next Header:</dt><dd>Set to 6 (TCP)</dd> | ||||
<t>Protocol: Set to 06 (TCP)</t> | <dt>Flow Label:</dt><dd>Set to 0</dd> | |||
</list></t> | <dt>Extension Headers:</dt><dd>None</dd> | |||
</dl> | ||||
<t>IPv6 header values:<list style="symbols"> | </dd> | |||
<t>DSCP: set to 0</t> | </dl> | |||
<t>Hop Count: set to 255</t> | ||||
<t>Next Header: set to 6 (TCP)</t> | ||||
<t>Flow Label: set to zero</t> | ||||
<t>Extension Headers: none</t> | ||||
</list></t> | ||||
<t>TCP header values: <list style="symbols"> | ||||
<t>Flags: ACK, SYN, FIN, set as required</t> | ||||
<t>Timestamp Option (TSopt): Set <list style="symbols"> | ||||
<t><xref target="RFC7323">Section 3.2 of </xref></t> | ||||
</list></t> | ||||
</list></t> | ||||
</list></t> | ||||
<t/> | <dl newline="true" spacing="normal"> | |||
<dt>TCP header values:</dt> | ||||
<dd><t/> | ||||
<dl newline="false" spacing="compact"> | ||||
<dt>Flags:</dt><dd>ACK, SYN, FIN, set as required</dd> | ||||
<dt>Timestamps Option (TSopt):</dt><dd>Set. See <xref | ||||
target="RFC7323" sectionFormat="of" section="3.2"/></dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Method of Measurement"> | <!-- 10.3 --> | |||
<name>Method of Measurement</name> | ||||
<t>This category includes columns for references to relevant sections | <t>This category includes columns for references to relevant sections | |||
of the RFC(s) and any supplemental information needed to ensure an | of the RFC(s) and any supplemental information needed to ensure | |||
unambiguous methods for implementations.</t> | an unambiguous method for implementations.</t> | |||
<section anchor="ref-methods-10.3.1" numbered="true" toc="default"> | ||||
<section title="Reference Methods"> | <!-- 10.3.1 --> | |||
<t>The foundation methodology for this metric is defined in Section | <name>Reference Methods</name> | |||
4 of <xref target="RFC7323"/> using the Timestamp Option with | <t>The foundational methodology for this metric is defined in <xref ta | |||
modifications that allow application at a mid-path Observation Point | rget="RFC7323" sectionFormat="of" section="4"/> using the Timestamps option with | |||
(OP) <xref target="RFC7011"/>. Further details and applicable | modifications that allow application at a mid-path OP <xref target="RF | |||
heuristics were derived from <xref target="Strowes"/> and <xref | C7011" format="default"/>. Further details and applicable | |||
target="Trammell-14"/>.</t> | heuristics were derived from <xref target="Strowes" format="default"/> | |||
and <xref target="Trammell-14" format="default"/>.</t> | ||||
<t>The Traffic Filter at the OP is configured to observe a single | <t>The Traffic Filter at the OP is configured to observe a single | |||
TCP connection. When the SYN, SYN-ACK, ACK handshake occurs, it | TCP connection. When the SYN/SYN-ACK/ACK handshake occurs, it | |||
offers the first opportunity to measure both RTD_fwd (on the SYN to | offers the first opportunity to measure both RTD_fwd (on the SYN to | |||
SYN-ACK pair) and RTD_rev (on the SYN-ACK to ACK pair). Label this | SYN-ACK pair) and RTD_rev (on the SYN-ACK to ACK pair). Label this | |||
singleton of RTDelay as RTDelay_HS (composed using the forward and | singleton of RTDelay as RTDelay_HS (composed using the Forward and | |||
reverse measurement pair). RTDelay_HS SHALL be treated separately | Reverse measurement pair). RTDelay_HS <bcp14>SHALL</bcp14> be treated | |||
separately | ||||
from other RTDelays on data-bearing packets and their ACKs. The | from other RTDelays on data-bearing packets and their ACKs. The | |||
RTDelay_HS value MAY be used as a sanity check on other Composed | RTDelay_HS value <bcp14>MAY</bcp14> be used as a consistency check on | |||
values of RTDelay.</t> | the composed | |||
values of RTDelay for payload-bearing packets.</t> | ||||
<t>For payload bearing packets, the OP measures the time interval | <t>For payload-bearing packets, the OP measures the time interval | |||
between observation of a packet with Sequence Number s, and the | between observation of a packet with sequence number "s" and the | |||
corresponding ACK with same Sequence number. When the payload is | corresponding ACK with the same sequence number. When the payload is | |||
transferred from host A to host B, the observed interval is | transferred from host A to host B, the observed interval is RTD_fwd.</ | |||
RTD_fwd.</t> | t> | |||
<t>For payload-bearing packets, each observation of an out-of-order or | ||||
duplicate segment | ||||
infers a loss count, but the composition of round-trip loss counts will | ||||
be conducted over a measurement interval that is synonymous with a | ||||
single TCP connection.</t> | ||||
<t>Because many data transfers are unidirectional (say, in the | <t>Because many data transfers are unidirectional (say, in the | |||
Forward direction from host A to host B), it is necessary to use | Forward direction from host A to host B), it is necessary to use | |||
pure ACK packets with Timestamp (TSval) and their Timestamp value | pure ACK packets with Timestamp (TSval) and packets with the Timestamp value | |||
echo to perform a RTD_rev measurement. The time interval between | echo to perform a RTD_rev measurement. The time interval between | |||
observation of the ACK from B to A, and the corresponding packet | observation of the ACK from B to A, and the Corresponding Packet | |||
with Timestamp echo (TSecr) is the RTD_rev.</t> | with a Timestamp Echo Reply (TSecr) field <xref target="RFC7323"/>, is | |||
the RTD_rev.</t> | ||||
<t>Delay Measurement Filtering Heuristics:</t> | <t>Delay Measurement Filtering Heuristics:</t> | |||
<ul spacing="normal"> | ||||
<t>If Data payloads were transferred in both Forward and Reverse | <li>If data payloads were transferred in both Forward and Reverse | |||
directions, then the Round-Trip Time Measurement Rule in Section 4.1 | directions, then the Round-Trip Time Measurement rule in <xref target= | |||
of <xref target="RFC7323"/> could be applied. This rule essentially | "RFC7323" sectionFormat="of" section="4.1"/> could be applied. This rule essenti | |||
ally | ||||
excludes any measurement using a packet unless it makes progress in | excludes any measurement using a packet unless it makes progress in | |||
the transfer (advances the left edge of the send window, consistent | the transfer (advances the left edge of the send window, consistent | |||
with <xref target="Strowes"/>).</t> | with <xref target="Strowes" format="default"/>).</li> | |||
<li>A different heuristic from <xref target="Trammell-14" format="defa | ||||
<t>A different heuristic from <xref target="Trammell-14"/> is to | ult"/> is to | |||
exclude any RTD_rev that is larger than previously observed values. | exclude any RTD_rev that is larger than previously observed values. | |||
This would tend to exclude Reverse measurements taken when the | This would tend to exclude Reverse measurements taken when the | |||
Application has no data ready to send, because considerable time | application has no data ready to send, because considerable time | |||
could be added to RTD_rev from this source of error.</t> | could be added to RTD_rev from this source of error.</li> | |||
<li>Note that the above heuristic assumes that host A is sending | ||||
<t>Note that the above Heuristic assumes that host A is sending | ||||
data. Host A expecting a download would mean that this heuristic | data. Host A expecting a download would mean that this heuristic | |||
should be applied to RTD_fwd.</t> | should be applied to RTD_fwd.</li> | |||
<li>The statistic calculations to summarize the delay (RTDelay) <bcp14 | ||||
<t>The statistic calculations to summarize the delay (RTDelay) SHALL | >SHALL</bcp14> | |||
be performed on the conditional distribution, conditioned on | be performed on the conditional distribution, conditioned on | |||
successful Forward and Reverse measurements which follow the | successful Forward and Reverse measurements that follow the | |||
Heuristics.</t> | heuristics.</li> | |||
</ul> | ||||
<t>Method for Inferring Loss:</t> | <t>Method for Inferring Loss:</t> | |||
<ul spacing="normal"> | ||||
<t>The OP tracks sequence numbers and stores gaps for each direction | <li>The OP tracks sequence numbers and stores gaps for each direction | |||
of transmission, as well as the next-expected sequence number as in | of transmission, as well as the next expected sequence number as discu | |||
<xref target="Trammell-14"/> and <xref target="RFC4737"/>. Loss is | ssed in | |||
inferred from Out-of-order segments and Duplicate segments.</t> | <xref target="Trammell-14" format="default"/> and <xref target="RFC473 | |||
7" format="default"/>. Loss is | ||||
inferred from out-of-order segments and duplicate segments.</li> | ||||
</ul> | ||||
<t>Loss Measurement Filtering Heuristics:</t> | <t>Loss Measurement Filtering Heuristics:</t> | |||
<ul spacing="normal"> | ||||
<t><xref target="Trammell-14"/> adds a window of evaluation based on | <li><xref target="Trammell-14" format="default"/> adds a window of eva | |||
the RTDelay.</t> | luation based on | |||
the RTDelay.</li> | ||||
<t>Distinguish Re-ordered from OOO due to loss, because sequence | <li>Distinguish reordered packets from out-of-order segments due to | |||
loss, because the sequence | ||||
number gap is filled during the same RTDelay window. Segments | number gap is filled during the same RTDelay window. Segments | |||
detected as re-ordered according to <xref target="RFC4737"/> MUST | detected as reordered according to <xref target="RFC4737" format="defa | |||
reduce the Loss Count inferred from Out-of-order segments.</t> | ult"/> <bcp14>MUST</bcp14> | |||
reduce the loss count inferred from out-of-order segments.</li> | ||||
<t>Spurious (unneeded) retransmissions (observed as duplicates) can | <li>Spurious (unneeded) retransmissions (observed as duplicates) can | |||
also be reduced this way, as described in <xref | also be reduced in this way, as described in <xref target="Trammell-14 | |||
target="Trammell-14"/>.</t> | " | |||
format="default"/>.</li> | ||||
</ul> | ||||
<t>Sources of Error:</t> | <t>Sources of Error:</t> | |||
<ul spacing="normal"> | ||||
<t>The principal source of RTDelay error is the host processing time | <li>The principal source of RTDelay error is the host processing time | |||
to return a packet that defines the termination of a time interval. | to return a packet that defines the termination of a time interval. | |||
The heuristics above intend to mitigate these errors by excluding | The heuristics above intend to mitigate these errors by excluding | |||
measurements where host processing time is a significant part of | measurements where host processing time is a significant part of | |||
RTD_fwd or RTD_rev.</t> | RTD_fwd or RTD_rev.</li> | |||
<li>A key source of RTLoss error is observation loss, as described in | ||||
<t>A key source of RTLoss error is observation loss, described in | Section 3 of <xref target="Trammell-14"/>.</li> | |||
section 3 of <xref target="Trammell-14"/>.</t> | </ul> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Packet Stream Generation"> | <!-- 10.3.2 --> | |||
<t>NA</t> | <name>Packet Stream Generation</name> | |||
<t>N/A</t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Traffic Filtering (observation) Details"> | <!-- 10.3.3 --> | |||
<name>Traffic Filtering (Observation) Details</name> | ||||
<t>The Fixed Parameters above give a portion of the Traffic Filter. | <t>The Fixed Parameters above give a portion of the Traffic Filter. | |||
Other aspects will be supplied as Run-time Parameters (below).</t> | Other aspects will be supplied as Runtime Parameters (below).</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Sampling Distribution"> | <!-- 10.3.4 --> | |||
<name>Sampling Distribution</name> | ||||
<t>This metric requires a complete sample of all packets that | <t>This metric requires a complete sample of all packets that | |||
qualify according to the Traffic Filter criteria.</t> | qualify according to the Traffic Filter criteria.</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Run-time Parameters and Data Format"> | <!-- 10.3.5 --> | |||
<t>Run-time Parameters are input factors that must be determined, | <name>Runtime Parameters and Data Format</name> | |||
<t>Runtime Parameters are input factors that must be determined, | ||||
configured into the measurement system, and reported with the | configured into the measurement system, and reported with the | |||
results for the context to be complete.</t> | results for the context to be complete.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Src:</dt> | |||
<t hangText="Src">the IP address of the host in the host A Role | <dd>The IP address of the host in the host A Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see Section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>Dst:</dt> | ||||
<t hangText="Dst">the IP address of the host in the host B | <dd>The IP address of the host in the host B Role | |||
(format ipv4-address-no-zone value for IPv4, or | (format ipv4&nbhy;address-no-zone value for IPv4 or | |||
ipv6-address-no-zone value for IPv6, see section 4 of <xref | ipv6-address-no-zone value for IPv6; see <xref target="RFC6991" se | |||
target="RFC6991"/>)</t> | ctionFormat="of" section="4"/>).</dd> | |||
<dt>T0:</dt> | ||||
<t hangText="T0">a time, the start of a measurement interval, | <dd>A time, the start of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
6.1 of <xref target="RFC2330"/>. When T0 is "all-zeros", a start | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
time is unspecified and Td is to be interpreted as the Duration | tionFormat="of" section="6.1"/>. When T0 is "all-zeros", a start | |||
time is unspecified and Tf is to be interpreted as the duration | ||||
of the measurement interval. The start time is controlled | of the measurement interval. The start time is controlled | |||
through other means.</t> | through other means.</dd> | |||
<dt>Tf:</dt> | ||||
<t hangText="Td">Optionally, the end of a measurement interval, | <dd>Optionally, the end of a measurement interval | |||
(format "date-and-time" as specified in Section 5.6 of <xref | (format "date&nbhy;time" as specified in <xref target="RFC3339" | |||
target="RFC3339"/>, see also Section 3 of <xref | sectionFormat="of" section="5.6"/>; see also | |||
target="RFC6991"/>), or the duration (see T0). The UTC Time Zone | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
is required by Section 6.1 of <xref target="RFC2330"/>. | "of" section="3"/>), or the duration (see T0). The UTC Time Zone | |||
Alternatively, the end of the measurement interval MAY be | is required by <xref target="RFC2330" sectionFormat="of" section=" | |||
6.1"/>. | ||||
Alternatively, the end of the measurement interval <bcp14>MAY</bcp | ||||
14> be | ||||
controlled by the measured connection, where the second pair of | controlled by the measured connection, where the second pair of | |||
FIN and ACK packets exchanged between host A and B effectively | FIN and ACK packets exchanged between host A and host B effectivel | |||
ends the interval.</t> | y | |||
ends the interval.</dd> | ||||
<t hangText="TTL or Hop Limit">Set at desired value.</t> | <dt>TTL or Hop Limit:</dt> | |||
</list></t> | <dd>Set at desired value.</dd> | |||
</dl> | ||||
<t/> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Roles"> | <!-- 10.3.6 --> | |||
<t><list style="hanging"> | <name>Roles</name> | |||
<t hangText="host A">launches the SYN packet to open the | <dl newline="false" spacing="normal"> | |||
connection, and synonymous with an IP address.</t> | <dt>host A:</dt> | |||
<dd>Launches the SYN packet to open the | ||||
<t hangText="host B">replies with the SYN-ACK packet to open the | connection. The Role of "host A" is synonymous with the IP | |||
connection, and synonymous with an IP address.</t> | address used at host A.</dd> | |||
</list></t> | <dt>host B:</dt> | |||
<dd>Replies with the SYN-ACK packet to open the | ||||
connection. The Role of "host B" is synonymous with the IP | ||||
address used at host B.</dd> | ||||
</dl> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Output"> | <!-- 10.4 --> | |||
<t>This category specifies all details of the Output of measurements | <name>Output</name> | |||
<t>This category specifies all details of the output of measurements | ||||
using the metric.</t> | using the metric.</t> | |||
<section numbered="true" toc="default"> | ||||
<section title="Type"> | <!-- 10.4.1 --> | |||
<t>See subsection titles in Reference Definition for RTDelay | <name>Type</name> | |||
Types.</t> | <t>RTDelay Types are discussed in the subsections below.</t> | |||
<t>For RTLoss: The count of lost packets.</t> | ||||
<t>For RTLoss -- the count of lost packets.</t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Reference Definition"> | <!-- 10.4.2 --> | |||
<t>For all output types ---<list style="hanging"> | <name>Reference Definition</name> | |||
<t hangText="T0">the start of a measurement interval, (format | <t>For all output types:</t> | |||
"date-and-time" as specified in Section 5.6 of <xref | <dl newline="false" spacing="normal"> | |||
target="RFC3339"/>, see also Section 3 of <xref | <dt>T0:</dt> | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | <dd>The start of a measurement interval (format | |||
6.1 of <xref target="RFC2330"/>.</t> | "date&nbhy;time" as specified in <xref target="RFC3339" | |||
sectionFormat="of" section="5.6"/>; see also | ||||
<t hangText="Tf">the end of a measurement interval, (format | "date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | |||
"date-and-time" as specified in Section 5.6 of <xref | "of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | |||
target="RFC3339"/>, see also Section 3 of <xref | tionFormat="of" section="6.1"/>.</dd> | |||
target="RFC6991"/>). The UTC Time Zone is required by Section | <dt>Tf:</dt> | |||
6.1 of <xref target="RFC2330"/>. The end of the measurement | <dd>The end of a measurement interval (format | |||
interval MAY be controlled by the measured connection, where the | "date&nbhy;time" as specified in <xref target="RFC3339" | |||
sectionFormat="of" section="5.6"/>; see also | ||||
"date&nbhy;and&nbhy;time" in <xref target="RFC6991" sectionFormat= | ||||
"of" section="3"/>). The UTC Time Zone is required by <xref target="RFC2330" sec | ||||
tionFormat="of" section="6.1"/>. The end of the measurement | ||||
interval <bcp14>MAY</bcp14> be controlled by the measured connecti | ||||
on, where the | ||||
second pair of FIN and ACK packets exchanged between host A and | second pair of FIN and ACK packets exchanged between host A and | |||
B effectively ends the interval.</t> | host B effectively ends the interval.</dd> | |||
<t hangText="...">...</t> | ||||
</list></t> | ||||
<t>For RTDelay_HS -- the Round trip delay of the Handshake.</t> | ||||
<t>For RTLoss -- the count of lost packets.</t> | ||||
<t>For each <statistic>, one of the following sub-sections | <dt>RTDelay_Passive_IP-TCP-HS:</dt> | |||
apply:</t> | <dd>The round-trip delay of the handshake is a Singleton.</dd> | |||
<dt>RTLoss:</dt><dd>The count of lost packets.</dd> | ||||
</dl> | ||||
<section title="Mean"> | <t>For each <statistic>, Singleton, or Loss Count, one of the fo | |||
<t>The mean SHALL be calculated using the conditional distribution | llowing subsections | |||
of all packets with a finite value of Round-trip delay (undefined | applies.</t> | |||
delays are excluded), a single value as follows:</t> | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | <section numbered="true" toc="default"> | |||
<!-- 10.4.2.1 --> | ||||
<name>Mean</name> | ||||
<t>The mean <bcp14>SHALL</bcp14> be calculated using the conditional | ||||
distribution | ||||
of all packets with a finite value of round-trip delay (undefined | ||||
delays are excluded) -- a single value, as follows:</t> | ||||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
details on the | ||||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.2.2"/> f | ||||
<t>See section 4.2.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.2.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.2.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Mean:</dt> | |||
<t hangText="Mean">The time value of the result is expressed | <dd>The time value of the result is expressed | |||
in units of seconds, as a positive value of type decimal64 | in units of seconds, as a positive value of type decimal64 | |||
with fraction digits = 9 (see section 9.3 of <xref | with fraction digits = 9 (see <xref target="RFC6020" sectionForm | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | at="of" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Min"> | <!-- 10.4.2.2 --> | |||
<t>The minimum SHALL be calculated using the conditional | <name>Min</name> | |||
distribution of all packets with a finite value of Round-trip | <t>The minimum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
delay (undefined delays are excluded), a single value as | nal | |||
distribution of all packets with a finite value of round-trip | ||||
delay (undefined delays are excluded) -- a single value, as | ||||
follows:</t> | follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | details on the | |||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for details on | or details on | |||
calculating this statistic, and 4.3.3 of <xref | calculating this statistic; see also <xref target="RFC6049" sectionF | |||
target="RFC6049"/>.</t> | ormat="of" section="4.3.3"/>.</t> | |||
<dl newline="false" spacing="normal"> | ||||
<t><list style="hanging"> | <dt>Min:</dt> | |||
<t hangText="Min">The time value of the result is expressed in | <dd>The time value of the result is expressed in | |||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Max"> | <!-- 10.4.2.3 --> | |||
<t>The maximum SHALL be calculated using the conditional | <name>Max</name> | |||
distribution of all packets with a finite value of Round-trip | <t>The maximum <bcp14>SHALL</bcp14> be calculated using the conditio | |||
delay (undefined delays are excluded), a single value as | nal | |||
distribution of all packets with a finite value of round-trip | ||||
delay (undefined delays are excluded) -- a single value, as | ||||
follows:</t> | follows:</t> | |||
<t>See <xref target="RFC3393" sectionFormat="of" section="4.1"/> for | ||||
<t>See section 4.1 of <xref target="RFC3393"/> for details on the | details on the | |||
conditional distribution to exclude undefined values of delay, and | conditional distribution to exclude undefined values of delay, and | |||
Section 5 of <xref target="RFC6703"/> for background on this | see <xref target="RFC6703" sectionFormat="of" section="5"/> for back ground on this | |||
analysis choice.</t> | analysis choice.</t> | |||
<t>See <xref target="RFC6049" sectionFormat="of" section="4.3.2"/> f | ||||
or a closely | ||||
related method for calculating this statistic; see also <xref target | ||||
="RFC6049" sectionFormat="of" section="4.3.3"/>. The formula is as follows:</t> | ||||
<artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
Max = (FiniteDelay[j]) | ||||
]]></artwork> | ||||
<t>See section 4.3.2 of <xref target="RFC6049"/> for a closely | <ul empty="true"> | |||
related method for calculating this statistic, and 4.3.3 of <xref | <li>such that for some index, j, where 1 <= j <= N | |||
target="RFC6049"/>. The formula is as follows:</t> | FiniteDelay[j] >= FiniteDelay[n] for all n</li> | |||
</ul> | ||||
<t><figure> | <dl newline="false" spacing="normal"> | |||
<artwork><![CDATA[ Max = (FiniteDelay [j]) | <dt>Max:</dt> | |||
<dd>The time value of the result is expressed in | ||||
such that for some index, j, where 1 <= j <= N | ||||
FiniteDelay[j] >= FiniteDelay[n] for all n]]></artwork> | ||||
</figure></t> | ||||
<t><list style="hanging"> | ||||
<t hangText="Max">The time value of the result is expressed in | ||||
units of seconds, as a positive value of type decimal64 with | units of seconds, as a positive value of type decimal64 with | |||
fraction digits = 9 (see section 9.3 of <xref | fraction digits = 9 (see <xref target="RFC6020" sectionFormat="o | |||
target="RFC6020"/>) with resolution of 0.000000001 seconds | f" section="9.3"/>) with a resolution of 0.000000001 seconds | |||
(1.0 ns), and with lossless conversion to/from the 64-bit NTP | (1.0 ns), and with lossless conversion to/from the 64-bit NTP | |||
timestamp as per section 6 of <xref | timestamp as per <xref target="RFC5905" sectionFormat="of" secti | |||
target="RFC5905">RFC</xref></t> | on="6"/>.</dd> | |||
</list></t> | </dl> | |||
</section> | </section> | |||
</section> | <!-- 10.4.2.4 --> | |||
<section numbered="true" toc="default"> | ||||
<name>Singleton</name> | ||||
<t>The singleton SHALL be calculated using the successful RTD_fwd | ||||
(on the SYN to SYN-ACK pair) and RTD_rev (on the SYN-ACK to ACK pair), | ||||
see <xref target="ref-methods-10.3.1"/>.</t> | ||||
<section title="Metric Units"> | <!-- <t>For RTDelay_Passive_IP-TCP-HS: The round-trip delay of the handshake | |||
<t>The <statistic> of Round-trip Delay is expressed in | .</t> | |||
seconds, where <statistic> is one of:</t> | removed because not in ACM's Registry Entry as of 6/27 --> | |||
<t>The singleton time value of the result is expressed in units of seconds, | ||||
as a positive value of type decimal64 with fraction digits = 9 | ||||
(see <xref target="RFC6020" sectionFormat="of" section="9.3"/>) with resolu | ||||
tion of 0.000000001 | ||||
seconds (1.0 ns), and with lossless conversion to/from the 64-bit | ||||
NTP timestamp as per <xref target="RFC5905" sectionFormat="of" section="6" | ||||
/>.</t> | ||||
</section> | ||||
<t><list style="symbols"> | <!-- 10.4.2.5 --> | |||
<t>Mean</t> | <section numbered="true" toc="default"> | |||
<name>Loss Counts</name> | ||||
<t>RTLoss_Passive_IP-TCP_RFC8912sec10_Packet_Count: The count of lost packets.</ | ||||
t> | ||||
<t>Min</t> | <t>Observation of an out-of-order segment or duplicate segment infers a loss cou nt, after application of the Definitions of <xref target="s10.2.1"/> and the Los s Measurement Filtering Heuristics of <xref target="ref-methods-10.3.1"/>. The c omposition of round-trip loss counts will be conducted over a measurement interv al that is synonymous with a single TCP connection.</t> | |||
<t>Max</t> | <t>For a measurement interval (corresponding to a single TCP connection) | |||
</list></t> | T0 to Tf, the REQUIRED Composition Function for the two single- | |||
direction counts of inferred loss is:</t> | ||||
<t>The Round-trip Delay of the Hand Shake is expressed in | <t>RTLoss = RTL_fwd + RTL_rev</t> | |||
seconds.</t> | ||||
<t>The Round-trip Loss Count is expressed as a number of | <dl><dt>Packet count:</dt><dd>The numeric value of the result is expressed in un | |||
its | ||||
of lost packets, as a positive value of type uint64 (represents | ||||
integer values between 0 and 18446744073709551615, inclusively | ||||
(see Section 9.2 of [RFC6020]).</dd> | ||||
</dl> | ||||
</section> | ||||
</section> | ||||
<section numbered="true" toc="default"> | ||||
<!-- 10.4.3 --> | ||||
<name>Metric Units</name> | ||||
<t>The <statistic> of round-trip delay is expressed in | ||||
seconds, where <statistic> is one of:</t> | ||||
<ul spacing="normal"> | ||||
<li>Mean</li> | ||||
<li>Min</li> | ||||
<li>Max</li> | ||||
</ul> | ||||
<t>The round-trip delay of the TCP handshake singleton is expressed in | ||||
seconds.</t> | ||||
<t>The round-trip loss count is expressed as a number of | ||||
packets.</t> | packets.</t> | |||
</section> | <!-- <t>RTLoss_Passive_IP-TCP_RFC8912sec10_Packet_Count</t> | |||
<dl> | ||||
<dt>Packet count:</dt><dd>The numeric value of the result is | ||||
expressed in units of lost packets, as a positive value of type | ||||
uint64 (represents integer values between 0 and | ||||
18446744073709551615, inclusively (see <xref target="RFC6020" | ||||
sectionFormat="of" section="9.2"/>).</dd></dl> --> | ||||
<section title="Calibration"> | </section> | |||
<t>Passive measurements at an OP could be calibrated against an | <section numbered="true" toc="default"> | |||
active measurement (with loss emulation) at host A or B, where the | <!-- 10.4.4 --> | |||
active measurement represents the ground-truth.</t> | <name>Calibration</name> | |||
<t>Passive Measurements at an OP could be calibrated against an | ||||
Active Measurement (with loss emulation) at host A or host B, where th | ||||
e | ||||
Active Measurement represents the ground truth.</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Administrative items"> | <!-- 10.5 --> | |||
<t/> | <name>Administrative Items</name> | |||
<section numbered="true" toc="default"> | ||||
<section title="Status"> | <!-- 10.5.1 --> | |||
<name>Status</name> | ||||
<t>Current</t> | <t>Current</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Requester"> | <!-- 10.5.2 --> | |||
<t>This RFC number</t> | <name>Requester</name> | |||
<t>RFC 8912</t> | ||||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision"> | <!-- 10.5.3 --> | |||
<name>Revision</name> | ||||
<t>1.0</t> | <t>1.0</t> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Revision Date"> | <!-- 10.5.4 --> | |||
<t>YYYY-MM-DD</t> | <name>Revision Date</name> | |||
<t>2021-11-17</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Comments and Remarks"> | <!-- 10.6 --> | |||
<t>None.</t> | <name>Comments and Remarks</name> | |||
<t>None</t> | ||||
</section> | </section> | |||
</section> | </section> | |||
<section numbered="true" toc="default"> | ||||
<section title="Security Considerations"> | <name>Security Considerations</name> | |||
<t>These registry entries represent no known implications for Internet | <t>These Registry Entries represent no known implications for Internet | |||
Security. Each RFC referenced above contains a Security Considerations | security. With the exception of <xref target="RFC1035"/>, each RFC referen | |||
section. Further, the LMAP Framework <xref target="RFC7594"/> provides | ced above contains a Security Considerations | |||
section. Further, the Large-scale Measurement of Broadband Performance (LM | ||||
AP) framework <xref target="RFC7594" format="default"/> provides | ||||
both security and privacy considerations for measurements.</t> | both security and privacy considerations for measurements.</t> | |||
<t>There are potential privacy considerations for observed traffic, | <t>There are potential privacy considerations for observed traffic, | |||
particularly for passive metrics in section 10. An attacker that knows | particularly for Passive Metrics as discussed in <xref target="tcp-rt-dela y-loss-reg-entries"/>. An attacker that knows | |||
that its TCP connection is being measured can modify its behavior to | that its TCP connection is being measured can modify its behavior to | |||
skew the measurement results.</t> | skew the measurement results.</t> | |||
</section> | </section> | |||
<section anchor="IANA" numbered="true" toc="default"> | ||||
<name>IANA Considerations</name> | ||||
<section anchor="IANA" title="IANA Considerations"> | <t>IANA has populated the Performance Metrics Registry | |||
<!-- <t>Metrics previously defined in IETF were registered in the IANA | defined in <xref target="RFC8911" format="default"/> with the | |||
IPPM | values defined in Sections <xref target="udp-rt-latency-loss-reg-entr | |||
METRICS REGISTRY, however this process was discontinued when the | ies" format="counter"/> | |||
registry structure was found to be inadequate, and the registry was | through <xref target="tcp-rt-delay-loss-reg-entries" format="counter"/>.</ | |||
declared Obsolete <xref target="RFC6248"/>.</t> | t> | |||
<t>The form of metric registration will finalized in this and other | ||||
memos, and IANA Action will be requested when the initial contents of | ||||
the registry are prepared.</t>--> | ||||
<t>IANA is requested to populate The Performance Metrics Registry | ||||
defined in <xref target="I-D.ietf-ippm-metric-registry"/> with the | ||||
values defined in sections 4 through 10.</t> | ||||
<t>See the IANA Considerations section of <xref | ||||
target="I-D.ietf-ippm-metric-registry"/> for additional requests and | ||||
considerations.</t> | ||||
</section> | ||||
<section title="Acknowledgements"> | ||||
<t>The authors thank Brian Trammell for suggesting the term "Run-time | ||||
Parameters", which led to the distinction between run-time and fixed | ||||
parameters implemented in this memo, for identifying the IPFIX metric | ||||
with Flow Key as an example, for suggesting the Passive TCP RTD metric | ||||
and supporting references, and for many other productive suggestions. | ||||
Thanks to Peter Koch, who provided several useful suggestions for | ||||
disambiguating successive DNS Queries in the DNS Response time | ||||
metric.</t> | ||||
<t>The authors also acknowledge the constructive reviews and helpful | <t>See the IANA Considerations section of <xref target="RFC8911" | |||
suggestions from Barbara Stark, Juergen Schoenwaelder, Tim Carey, Yaakov | format="default"/> for additional considerations.</t> | |||
Stein, and participants in the LMAP working group. Thanks to Michelle | ||||
Cotton for her early IANA reviews, and to Amanda Barber for answering | ||||
questions related to the presentation of the registry and accessibility | ||||
of the complete template via URL.</t> | ||||
</section> | </section> | |||
</middle> | </middle> | |||
<back> | <back> | |||
<references title="Normative References"> | <references> | |||
<?rfc include="reference.RFC.1035"?> | <name>References</name> | |||
<references> | ||||
<?rfc include="reference.RFC.2119"?> | <name>Normative References</name> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.1035. | ||||
<?rfc include="reference.RFC.2330"?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.2119. | ||||
<?rfc ?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.2330. | ||||
<?rfc ?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.2681. | ||||
<?rfc ?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.3339. | ||||
<?rfc ?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.3393. | ||||
<?rfc include='reference.RFC.2681'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.3432. | ||||
<?rfc include='reference.RFC.3393'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5560. | ||||
<?rfc include='reference.RFC.3339'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5905. | ||||
<?rfc include='reference.RFC.3432'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.4737. | ||||
<?rfc include='reference.RFC.5560'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5357. | ||||
<?rfc include='reference.RFC.5905'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.5481. | ||||
<?rfc include='reference.RFC.4737'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6020. | ||||
<?rfc include='reference.RFC.5357'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6049. | ||||
<?rfc include='reference.RFC.5481'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6673. | ||||
<?rfc include='reference.RFC.6020'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6991. | ||||
<?rfc include='reference.RFC.6049'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7011. | ||||
<?rfc include='reference.RFC.6673'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7323. | ||||
<?rfc include='reference.RFC.6991'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7679. | ||||
<?rfc include='reference.RFC.7011'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7680. | ||||
<?rfc include='reference.RFC.7323'?> | xml"/> | |||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8174. | ||||
<?rfc include='reference.RFC.7679'?> | xml"/> | |||
<?rfc include='reference.RFC.7680'?> | ||||
<?rfc include='reference.RFC.8174'?> | ||||
<reference anchor="I-D.ietf-ippm-metric-registry"> | ||||
<front> | ||||
<title>Registry for Performance Metrics</title> | ||||
<author fullname="Marcelo Bagnulo" initials="M." surname="Bagnulo"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Benoit Claise" initials="B." surname="Claise"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Phil Eardley" initials="P." surname="Eardley"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Al Morton" initials="A." surname="Morton"> | ||||
<organization/> | ||||
</author> | ||||
<date year="2019"/> | ||||
</front> | ||||
<seriesInfo name="Internet Draft (work in progress)" | ||||
value="draft-ietf-ippm-metric-registry"/> | ||||
<format type="TXT"/> | <!-- draft-ietf-ippm-metric-registry (RFC 8911) --> | |||
<reference anchor="RFC8911" target="https://www.rfc-editor.org/info/rfc8 | ||||
911"> | ||||
<front> | ||||
<title>Registry for Performance Metrics</title> | ||||
<author fullname="Marcelo Bagnulo" initials="M." surname="Bagnulo"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Benoit Claise" initials="B." surname="Claise"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Phil Eardley" initials="P." surname="Eardley"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Al Morton" initials="A." surname="Morton"> | ||||
<organization/> | ||||
</author> | ||||
<author fullname="Aamer Akhter" initials="A." surname="Akhter"> | ||||
<organization/> | ||||
</author> | ||||
<date month="November" year="2021"/> | ||||
</front> | ||||
<seriesInfo name="RFC" value="8911"/> | ||||
<seriesInfo name="DOI" value="10.17487/RFC8911"/> | ||||
</reference> | </reference> | |||
<reference anchor="Strowes"> | <reference anchor="Strowes" target="https://dl.acm.org/doi/10.1145/25077 | |||
<front> | 71.2507781"> | |||
<title>Passively Measuring TCP Round Trip Times, Communications of | <front> | |||
the ACM, Vol. 56 No. 10, Pages 57-64</title> | <title>Passively Measuring TCP Round-Trip Times</title> | |||
<author fullname="Stephen Strowes" initials="S." surname="Strowes"> | ||||
<author fullname="S.Strowes" initials="S." surname="Strowes"> | <organization></organization> | |||
<organization>Communications of the ACM, Vol. 56 No. 10, Pages | </author> | |||
57-64.</organization> | <date month="October" year="2013"/> | |||
</author> | </front> | |||
<refcontent>Communications of the ACM, Vol. 56 No. 10, Pages 57-64</ref | ||||
<date month="September" year="2013"/> | content> | |||
</front> | <seriesInfo name="DOI" value="10.1145/2507771.2507781"/> | |||
</reference> | </reference> | |||
<reference anchor="Trammell-14"> | <reference anchor="Trammell-14" target="https://link.springer.com/chapte | |||
<front> | r/10.1007/978-3-642-54999-1_2"> | |||
<title>Inline Data Integrity Signals for Passive Measurement, In: | <front> | |||
Dainotti A., Mahanti A., Uhlig S. (eds) Traffic Monitoring and | <title>Inline Data Integrity Signals for Passive Measurement</title> | |||
Analysis. TMA 2014. Lecture Notes in Computer Science, vol 8406. | <author fullname="Brian Trammell" initials="B." surname="Trammell"> | |||
Springer, Berlin, Heidelberg | <organization></organization> | |||
https://link.springer.com/chapter/10.1007/978-3-642-54999-1_2</title> | </author> | |||
<author fullname="David Gugelmann" initials="D." surname="Gugelmann"> | ||||
<organization></organization> | ||||
</author> | ||||
<author fullname="Nevil Brownlee" initials="N." surname="Brownlee"> | ||||
<organization></organization> | ||||
</author> | ||||
<date month="March" year="2014"/> | ||||
</front> | ||||
<refcontent>In: Dainotti A., Mahanti A., Uhlig S. (eds) | ||||
Traffic Monitoring and Analysis. TMA 2014. Lecture Notes in | ||||
Computer Science, vol 8406. Springer, Berlin, Heidelberg</refcontent> | ||||
<seriesInfo name="DOI" value="10.1007/978-3-642-54999-1_2"/> | ||||
</reference> | ||||
</references> | ||||
<author fullname="B.Trammell, et al." initials="B." | <references> | |||
surname="Trammell"> | <name>Informative References</name> | |||
<organization>TMA 2014 In: Dainotti A., Mahanti A., Uhlig S. (eds) | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.1242. | |||
Traffic Monitoring and Analysis. TMA 2014. Lecture Notes in | xml"/> | |||
Computer Science, vol 8406. Springer, Berlin, | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6390. | |||
Heidelberg</organization> | xml"/> | |||
</author> | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.6703. | |||
xml"/> | ||||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.7594. | ||||
xml"/> | ||||
<xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.RFC.8126. | ||||
xml"/> | ||||
<date month="March" year="2014"/> | </references> | |||
</front> | ||||
</reference> | ||||
</references> | </references> | |||
<section numbered="false" toc="default"> | ||||
<name>Acknowledgments</name> | ||||
<t>The authors thank <contact fullname="Brian Trammell"/> for suggesting t | ||||
he term "Runtime | ||||
Parameters", which led to the distinction between Runtime and Fixed | ||||
Parameters implemented in this memo, for identifying the IP Flow | ||||
Information Export (IPFIX) metric | ||||
with Flow Key as an example, for suggesting the Passive TCP RTD Metric | ||||
and supporting references, and for many other productive suggestions. Than | ||||
ks to <contact fullname="Peter Koch"/>, who provided several useful suggestions | ||||
for | ||||
disambiguating successive DNS queries in the DNS Response time | ||||
metric.</t> | ||||
<t>The authors also acknowledge the constructive reviews and helpful | ||||
suggestions from <contact fullname="Barbara Stark"/>, <contact fullname="J | ||||
uergen Schoenwaelder"/>, <contact fullname="Tim Carey"/>, <contact fullname="Yaa | ||||
kov | ||||
Stein"/>, and participants in the LMAP Working Group. Thanks to <contact | ||||
fullname="Michelle Cotton"/> for her early IANA reviews, and to <contact f | ||||
ullname="Amanda Baber"/> for answering | ||||
questions related to the presentation of the Registry and accessibility | ||||
of the complete template via URL.</t> | ||||
<references title="Informative References"> | </section> | |||
<?rfc include='reference.RFC.1242'?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc include='reference.RFC.6390'?> | ||||
<?rfc include='reference.RFC.6703'?> | ||||
<?rfc include='reference.RFC.7594'?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
<?rfc ?> | ||||
</references> | ||||
</back> | </back> | |||
</rfc> | </rfc> | |||
End of changes. 648 change blocks. | ||||
2926 lines changed or deleted | 3449 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ |