Network Working Group A. Morton Internet-Draft AT&T Labs Intended status: Standards Track M. Bagnulo Expires: June 15, 2016 UC3M P. Eardley BT K. D'Souza AT&T Labs December 13, 2015 Initial Performance Metric Registry Entries draft-morton-ippm-initial-registry-02 Abstract This memo defines the Initial Entries for the Performance Metrics Registry. Section 4 has been edited to reflect recent discussion on the ippm- list: * Removed the combination or "Raw" and left 95th percentile. * Hanging Indent on Run-time parameters (Fixed parameters use bullet lists and other indenting formats. * Payload format for measurement has been removed. * Explanation of Conditional delay distribution. Still need: * suggestion of standard naming format for parameters. * usecase(s) for machine parse-able registry columns. * Contribution of YANG references for alternate data formats. Note: lambda parameter description is correct in section 4, elsewhere needs fix. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [RFC2119]. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at http://datatracker.ietf.org/drafts/current/. Morton, et al. Expires June 15, 2016 [Page 1] Internet-Draft Initial Registry December 2015 Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on June 15, 2016. Copyright Notice Copyright (c) 2015 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 7 2. Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 3. Registry Categories and Columns . . . . . . . . . . . . . . . 8 4. UDP Round-trip Latency Registry Entry . . . . . . . . . . . . 9 4.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 10 4.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1.4. Description . . . . . . . . . . . . . . . . . . . . . 10 4.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 10 4.2.1. Reference Definition . . . . . . . . . . . . . . . . 10 4.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 11 4.3. Method of Measurement . . . . . . . . . . . . . . . . . . 12 4.3.1. Reference Method . . . . . . . . . . . . . . . . . . 12 4.3.2. Packet Generation Stream . . . . . . . . . . . . . . 13 4.3.3. Traffic Filtering (observation) Details . . . . . . . 13 4.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 13 4.3.5. Run-time Parameters and Data Format . . . . . . . . . 14 4.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 15 4.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 15 4.4.2. Data Format . . . . . . . . . . . . . . . . . . . . . 15 4.4.3. Reference . . . . . . . . . . . . . . . . . . . . . . 16 4.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 16 Morton, et al. Expires June 15, 2016 [Page 2] Internet-Draft Initial Registry December 2015 4.5. Administrative items . . . . . . . . . . . . . . . . . . 16 4.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 16 4.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 16 4.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 16 4.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 16 4.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 16 5. Packet Delay Variation Registry Entry . . . . . . . . . . . . 17 5.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 17 5.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 17 5.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 17 5.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . . 17 5.1.4. Description . . . . . . . . . . . . . . . . . . . . . 17 5.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 17 5.2.1. Reference Definition . . . . . . . . . . . . . . . . 17 5.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 18 5.3. Method of Measurement . . . . . . . . . . . . . . . . . . 18 5.3.1. Reference Method . . . . . . . . . . . . . . . . . . 19 5.3.2. Packet Generation Stream . . . . . . . . . . . . . . 19 5.3.3. Traffic Filtering (observation) Details . . . . . . . 19 5.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 19 5.3.5. Run-time Parameters and Data Format . . . . . . . . . 19 5.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 20 5.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 20 5.4.1. Type/Value (two diff terms used) . . . . . . . . . . 20 5.4.2. Data Format . . . . . . . . . . . . . . . . . . . . . 20 5.4.3. Reference . . . . . . . . . . . . . . . . . . . . . . 21 5.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 21 5.5. Administrative items . . . . . . . . . . . . . . . . . . 22 5.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 22 5.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 22 5.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 22 5.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 22 5.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 22 6. DNS Response Latency Registry Entry . . . . . . . . . . . . . 22 6.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 23 6.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 23 6.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . . 23 6.1.4. Description . . . . . . . . . . . . . . . . . . . . . 23 6.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 23 6.2.1. Reference Definition . . . . . . . . . . . . . . . . 23 6.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 24 6.3. Method of Measurement . . . . . . . . . . . . . . . . . . 25 6.3.1. Reference Method . . . . . . . . . . . . . . . . . . 25 6.3.2. Packet Generation Stream . . . . . . . . . . . . . . 26 6.3.3. Traffic Filtering (observation) Details . . . . . . . 26 6.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 27 6.3.5. Run-time Parameters and Data Format . . . . . . . . . 27 Morton, et al. Expires June 15, 2016 [Page 3] Internet-Draft Initial Registry December 2015 6.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 28 6.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 28 6.4.1. Type/Value (two diff terms used) . . . . . . . . . . 28 6.4.2. Data Format . . . . . . . . . . . . . . . . . . . . . 29 6.4.3. Reference . . . . . . . . . . . . . . . . . . . . . . 29 6.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 29 6.5. Administrative items . . . . . . . . . . . . . . . . . . 30 6.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 30 6.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 30 6.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 30 6.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 30 6.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 30 7. UDP Poisson One-way Delay Registry Entries . . . . . . . . . 30 7.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 30 7.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 31 7.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 31 7.1.3. URI and URL . . . . . . . . . . . . . . . . . . . . . 31 7.1.4. Description . . . . . . . . . . . . . . . . . . . . . 31 7.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 31 7.2.1. Reference Definition . . . . . . . . . . . . . . . . 31 7.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 32 7.3. Method of Measurement . . . . . . . . . . . . . . . . . . 33 7.3.1. Reference Method . . . . . . . . . . . . . . . . . . 33 7.3.2. Packet Generation Stream . . . . . . . . . . . . . . 33 7.3.3. Traffic Filtering (observation) Details . . . . . . . 33 7.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 34 7.3.5. Run-time Parameters and Data Format . . . . . . . . . 34 7.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 34 7.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 35 7.4.1. Type/Value (two diff terms used) . . . . . . . . . . 35 7.4.2. Data Format . . . . . . . . . . . . . . . . . . . . . 35 7.4.3. Reference . . . . . . . . . . . . . . . . . . . . . . 37 7.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 37 7.5. Administrative items . . . . . . . . . . . . . . . . . . 37 7.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 37 7.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 37 7.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 37 7.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 38 7.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 38 8. UDP Periodic One-way Delay Registry Entries . . . . . . . . . 38 8.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 38 8.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 38 8.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 38 8.1.3. URI and URL . . . . . . . . . . . . . . . . . . . . . 39 8.1.4. Description . . . . . . . . . . . . . . . . . . . . . 39 8.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 39 8.2.1. Reference Definition . . . . . . . . . . . . . . . . 39 8.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 40 Morton, et al. Expires June 15, 2016 [Page 4] Internet-Draft Initial Registry December 2015 8.3. Method of Measurement . . . . . . . . . . . . . . . . . . 40 8.3.1. Reference Method . . . . . . . . . . . . . . . . . . 40 8.3.2. Packet Generation Stream . . . . . . . . . . . . . . 41 8.3.3. Traffic Filtering (observation) Details . . . . . . . 41 8.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 41 8.3.5. Run-time Parameters and Data Format . . . . . . . . . 41 8.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 42 8.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 42 8.4.1. Type/Value (two diff terms used) . . . . . . . . . . 42 8.4.2. Data Format . . . . . . . . . . . . . . . . . . . . . 43 8.4.3. Reference . . . . . . . . . . . . . . . . . . . . . . 45 8.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 45 8.5. Administrative items . . . . . . . . . . . . . . . . . . 45 8.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 45 8.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 45 8.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 45 8.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 45 8.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 45 9. partly BLANK Registry Entry . . . . . . . . . . . . . . . . . 45 9.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 45 9.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 46 9.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 46 9.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . . 46 9.1.4. Description . . . . . . . . . . . . . . . . . . . . . 46 9.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 46 9.2.1. Reference Definition . . . . . . . . . . . . . . . . 46 9.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 47 9.3. Method of Measurement . . . . . . . . . . . . . . . . . . 47 9.3.1. Reference Method . . . . . . . . . . . . . . . . . . 47 9.3.2. Packet Generation Stream . . . . . . . . . . . . . . 47 9.3.3. Traffic Filtering (observation) Details . . . . . . . 48 9.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 48 9.3.5. Run-time Parameters and Data Format . . . . . . . . . 48 9.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 48 9.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 48 9.4.1. Type/Value (two diff terms used) . . . . . . . . . . 48 9.4.2. Data Format . . . . . . . . . . . . . . . . . . . . . 48 9.4.3. Reference . . . . . . . . . . . . . . . . . . . . . . 49 9.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 49 9.5. Administrative items . . . . . . . . . . . . . . . . . . 49 9.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 49 9.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 49 9.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 49 9.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 49 9.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 49 10. BLANK Registry Entry . . . . . . . . . . . . . . . . . . . . 49 10.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . 49 10.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . 50 Morton, et al. Expires June 15, 2016 [Page 5] Internet-Draft Initial Registry December 2015 10.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 50 10.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . 50 10.1.4. Description . . . . . . . . . . . . . . . . . . . . 50 10.2. Metric Definition . . . . . . . . . . . . . . . . . . . 50 10.2.1. Reference Definition . . . . . . . . . . . . . . . . 50 10.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 50 10.3. Method of Measurement . . . . . . . . . . . . . . . . . 50 10.3.1. Reference Method . . . . . . . . . . . . . . . . . . 50 10.3.2. Packet Generation Stream . . . . . . . . . . . . . . 51 10.3.3. Traffic Filtering (observation) Details . . . . . . 51 10.3.4. Sampling Distribution . . . . . . . . . . . . . . . 51 10.3.5. Run-time Parameters and Data Format . . . . . . . . 51 10.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . 51 10.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 51 10.4.1. Type/Value (two diff terms used) . . . . . . . . . . 51 10.4.2. Data Format . . . . . . . . . . . . . . . . . . . . 51 10.4.3. Reference . . . . . . . . . . . . . . . . . . . . . 51 10.4.4. Metric Units . . . . . . . . . . . . . . . . . . . . 51 10.5. Administrative items . . . . . . . . . . . . . . . . . . 52 10.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 52 10.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . 52 10.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 52 10.5.4. Revision Date . . . . . . . . . . . . . . . . . . . 52 10.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 52 11. Example RTCP-XR Registry Entry . . . . . . . . . . . . . . . 52 11.1. Registry Indexes . . . . . . . . . . . . . . . . . . . . 52 11.1.1. Identifier . . . . . . . . . . . . . . . . . . . . . 52 11.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 52 11.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . 53 11.1.4. Status . . . . . . . . . . . . . . . . . . . . . . . 53 11.1.5. Requestor . . . . . . . . . . . . . . . . . . . . . 53 11.1.6. Revision . . . . . . . . . . . . . . . . . . . . . . 53 11.1.7. Revision Date . . . . . . . . . . . . . . . . . . . 53 11.1.8. Description . . . . . . . . . . . . . . . . . . . . 53 11.1.9. Reference Specification(s) . . . . . . . . . . . . . 53 11.2. Metric Definition . . . . . . . . . . . . . . . . . . . 53 11.2.1. Reference Definition . . . . . . . . . . . . . . . . 53 11.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 54 11.3. Method of Measurement . . . . . . . . . . . . . . . . . 54 11.3.1. Reference Method . . . . . . . . . . . . . . . . . . 54 11.3.2. Stream Type and Stream Parameters . . . . . . . . . 55 11.3.3. Output Type and Data Format . . . . . . . . . . . . 55 11.3.4. Metric Units . . . . . . . . . . . . . . . . . . . . 55 11.3.5. Run-time Parameters and Data Format . . . . . . . . 55 11.4. Comments and Remarks . . . . . . . . . . . . . . . . . . 57 12. Security Considerations . . . . . . . . . . . . . . . . . . . 57 13. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 57 14. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 57 Morton, et al. Expires June 15, 2016 [Page 6] Internet-Draft Initial Registry December 2015 15. References . . . . . . . . . . . . . . . . . . . . . . . . . 58 15.1. Normative References . . . . . . . . . . . . . . . . . . 58 15.2. Informative References . . . . . . . . . . . . . . . . . 59 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 61 1. Introduction Note: Efforts to synchronize structure and terminology with [I-D.ietf-ippm-metric-registry] will likely be incomplete until both drafts are stable. This memo defines the Initial set of entries for the Performance Metric Registry. The registry will contain Active Performance Metrics, especially those defined in RFCs prepared in the IP Performance Metrics (IPPM) Working Group of the IETF, according to their framework [RFC2330]. Three aspects make IPPM metric registration difficult: (1) Use of the Type-P notion to allow users to specify their own packet types. (2) Use of Flexible input variables, called Parameters in IPPM definitions, some which determine the quantity measured and others which should not be specified until execution of the measurement. (3) Allowing flexibility in choice of statistics to summarize the results on a stream of measurement packets. This memo uses terms and definitions from the IPPM literature, primarily [RFC2330], and the reader is assumed familiar with them or may refer questions there as necessary. Although there are several standard templates for organizing specifications of performance metrics (see [RFC2679] for an example of the traditional IPPM template, based to large extent on the Benchmarking Methodology Working Group's traditional template in [RFC1242], and see [RFC6390] for a similar template), none of these templates were intended to become the basis for the columns of an IETF-wide registry of metrics. While examinating aspects of metric specifications which need to be registered, it was clear that none of the existing metric templates fully satisfies the particular needs of a registry. 2. Scope [I-D.ietf-ippm-metric-registry] defines the overall structure for a Performance Metric Registry and provides guidance for the process to examine proposed metrics and maitain Registered Metrics. This document defines the initial set of Performance Metrics Registry entries; all are active metrics, or those where the packets measured have been specially generated for the purpose of measurement. Morton, et al. Expires June 15, 2016 [Page 7] Internet-Draft Initial Registry December 2015 A row in the registry corresponds to one Registered Performance Metric, with entries in the various columns specifying the metric. As discussed in [I-D.ietf-ippm-metric-registry], each entry (row) must be tightly defined; the definition must leave open only a few parameters that do not change the fundamental nature of the measurement (such as source and destination addresses), and so promotes comparable results across independent implementations. Also, each registered entry must be based on existing reference RFCs (or other standards) for performance metrics, and must be operationally useful and have significant industry interest. This is ensured by expert review for every entry before IANA action. 3. Registry Categories and Columns This section defines the categories and columns of the registry. Below, categories are described at the 3.x heading level, and columns are at the 3.x.y heading level. The Figure below illustrates this organization. An entry (row) therefore gives a complete description of a Registered Metric. Each column serves as a check-list item and helps to avoid omissions during registration and expert review. In some cases an entry (row) may have some columns without specific entries, marked Not Applicable (NA). Morton, et al. Expires June 15, 2016 [Page 8] Internet-Draft Initial Registry December 2015 Registry Categories and Columns, shown as Category ------------------ Column | Column | Summary -------------------------------- ID | Name | URIs | Description | Metric Definition ----------------------------------------- Reference Definition | Fixed Parameters | Method of Measurement --------------------------------------------------------------- Reference | Packet | Traffic | Sampling | Run-time | Role | Method | Generation | Filter | dist. | Param | | | Stream | Output ---------------------------- Type | Reference | Units | | Definition | | Administrative information ---------------------------------- Status |Request | Rev | Rev.Date | Comments and Remarks -------------------- 4. UDP Round-trip Latency Registry Entry This section gives an initial registry entry for the UDP Round-trip Latency. Note: If each Registry entry should only produce a "raw" output or a statistical summary, then the "Output" Category can be split and this section can become two closely-related metrics. Morton, et al. Expires June 15, 2016 [Page 9] Internet-Draft Initial Registry December 2015 4.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. 4.1.1. ID (Identifier) 4.1.2. Name Act_IP_UDP_Round-trip_Delay_95th-percentile_Poisson 4.1.3. URIs URN: Prefix urn:ietf:params:performance:metric... URL: http:/// 4.1.4. Description This metric assesses the delay of a stream of packets exchanged between two hosts (or measurement points), and the Output is the Round-trip delay for all successfully exchanged packets expressed as the 95th percentile of their conditional delay distribution. 4.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 4.2.1. Reference Definition Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay Metric for IPPM", RFC 2681, September 1999. [RFC2681] Section 2.4 of [RFC2681] provides the reference definition of the singleton (single value) Round-trip delay metric. Section 3.4 of [RFC2681] provides the reference definition expanded to cover a Morton, et al. Expires June 15, 2016 [Page 10] Internet-Draft Initial Registry December 2015 multi-value sample. Note that terms such as singleton and sample are defined in Section 11 of [RFC2330]. Note that although the definition of "Round-trip-Delay between Src and Dst at T" is directionally ambiguous in the text, this metric tightens the definition further to recognize that the host in the "Src" role will send the first packet to "Dst", and ultimately receive the corresponding return packet from "Dst" (when neither are lost). Finally, note that the variable "dT" is used in [RFC2681] to refer to the value of Round-trip delay in metric definitions and methods. The variable "dT" has been re-used in other IPPM literature to refer to different quantities, and cannot be used as a global variable name. 4.2.2. Fixed Parameters Type-P: o IPv4 header values: * DSCP: set to 0 * TTL: set to 255 * Protocol: Set to 17 (UDP) o IPv6 header values: * DSCP: set to 0 * Hop Count: set to 255 * Protocol: Set to 17 (UDP) o UDP header values: * Checksum: the checksum MUST be calculated o UDP Payload * total of 9 bytes Tmax: a loss threshold waiting time Morton, et al. Expires June 15, 2016 [Page 11] Internet-Draft Initial Registry December 2015 o 3.0000, expressed in units of seconds, with resolution of 0.0001 seconds (0.1 ms), with lossless conversion to/from the 32-bit NTP timestamp as per section 6 of RFC 5905 [RFC5905] 4.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. 4.3.1. Reference Method The methodology for this metric is defined as Type-P-Round-trip- Delay-Poisson-Stream in section 2.6 of RFC 2681 [RFC2681] and section 3.6 of RFC 2681 [RFC2681] using the Type-P and Tmax defined under Fixed Parameters. The reference method distinguishes between long-delayed packets and lost packets by implementing a maximum waiting time for packet arrival. Tmax is the waiting time used as the threshold to declare a packet lost. Lost packets SHALL be designated as having undefined delay. The calculations on the delay (RTT) SHALL be performed on the conditional distribution, conditioned on successful packet arrival within Tmax. Also, when all packet delays are stored, the process which calculates the RTT value MAY enforce the Tmax threshold on stored values before calculations. See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. The reference method requires some way to distinguish between different packets in a stream and establish correspondence between sending times and receiving times for each successfully-arriving packet. Sequence numbers or other send-order information MUST be retained at the Src or included with each packet to dis-ambiguate packet reordering if it occurs. The chosen measurement protocol will dictate the format of sequence numbers and time-stamps, if they are conveyed in the packet payload. The sequence numbers or timestamps MUST be determined by the measurement process itself after the Fixed and Runtime parameters are passed to that process. Refer to Section 4.4 of [RFC6673] for expanded discussion of the instruction to "send a Type-P packet back to the Src as quickly as Morton, et al. Expires June 15, 2016 [Page 12] Internet-Draft Initial Registry December 2015 possible" in Section 2.6 of RFC 2681 [RFC2681]. Section 8 of [RFC6673] presents additional requirements which shall be included in the method of measurement for this metric. 4.3.2. Packet Generation Stream This section gives the details of the packet traffic which is the basis for measurement. In IPPM metrics, this is called the Stream, and can easily be described by providing the list of stream parameters.
Section 11.1.3 of [RFC2330] provides three methods to generate Poisson sampling intervals. the reciprocal of lambda is the average packet spacing, thus the Run-time Parameter is Reciprocal_lambda = 1/ lambda, in seconds. >>> Check with Sam, most likely it is this... Method 3 SHALL be used, where given a start time (Run-time Parameter), the subsequent send times are all computed prior to measurement by computing the pseudo-random distribution of inter- packet send times, (truncating the distribution as specified in the Run-time Parameter, Trunc), and the Src sends each packet at the computed times. Note that Trunc is the upper limit on inter-packet times in the Poisson distribution. A random value greater than Trunc is set equal to Trunc instead. 4.3.3. Traffic Filtering (observation) Details The measured results based on a filtered version of the packets observed, and this section provides the filter details (when present).
. NA 4.3.4. Sampling Distribution NA Morton, et al. Expires June 15, 2016 [Page 13] Internet-Draft Initial Registry December 2015 4.3.5. Run-time Parameters and Data Format Run-time Parameters are input factors that must be determined, configured into the measurement system, and reported with the results for the context to be complete. Src the IP address of the host in the Src Role (format ipv4-address- no-zone value for IPv4, or ipv6-address-no-zone value for IPv6, see Section 4 of [RFC6991]) Dst the IP address of the host in the Dst Role (format ipv4-address- no-zone value for IPv4, or ipv6-address-no-zone value for IPv6, see section 4 of [RFC6991]) T0 a time, the start of a measurement interval, (format "date-and- time" as specified in Section 5.6 of [RFC3339], see also Section 3 of [RFC6991]). The UTC Time Zone is required by Section 6.1 of [RFC2330]. 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 through other means. Tf a time, the end of a measurement interval, (format "date-and-time" as specified in Section 5.6 of [RFC3339], see also Section 3 of [RFC6991]). The UTC Time Zone is required by Section 6.1 of [RFC2330]. When T0 is "all-zeros", a end time date is ignored and Tf is interpreted as the Duration of the measurement interval. Reciprocal_lambda average packet interval for Poisson Streams expressed in units of seconds, with resolution of 0.0001 seconds (0.1 ms), and with lossless conversion to/from the 32-bit NTP timestamp as per section 6 of RFC [RFC5905]. (Reciprocal_lambda = 1.0000 second, if fixed) Trunc Upper limit on Poisson distribution expressed in units of seconds, with resolution of 0.0001 seconds (0.1 ms), and with lossless conversion to/from the 32-bit NTP timestamp as per section 6 of [RFC5905] (values above this limit will be clipped and set to the limit value). (if fixed, Trunc = 30.0000 seconds.) >>> should Poisson run-time params be fixed instead? probably yes if modeling a specific version of MBA tests. Morton, et al. Expires June 15, 2016 [Page 14] Internet-Draft Initial Registry December 2015 4.3.6. Roles Src launches each packet and waits for return transmissions from Dst. Dst waits for each packet from Src and sends a return packet to Src. 4.4. Output This category specifies all details of the Output of measurements using the metric. 4.4.1. Type Percentile -- for the conditional distribution of all packets with a valid value of Round-trip delay (undefined delays are excluded), a single value corresponding to the 95th percentile. 4.4.2. Data Format For all outputs --- T0 the start of a measurement interval, (format "date-and-time" as specified in Section 5.6 of [RFC3339], see also Section 3 of [RFC6991]). The UTC Time Zone is required by Section 6.1 of [RFC2330]. Tf the start of a measurement interval, (format "date-and-time" as specified in Section 5.6 of [RFC3339], see also Section 3 of [RFC6991]). The UTC Time Zone is required by Section 6.1 of [RFC2330]. Raw -- REMOVED IN VERSION 01 Percentile -- for the conditional distribution of all packets with a valid value of Round-trip delay (undefined delays are excluded), a single value as follows: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. Morton, et al. Expires June 15, 2016 [Page 15] Internet-Draft Initial Registry December 2015 See section 4.3 of [RFC3393] for details on the percentile statistic (where Round-trip delay should be substituted for "ipdv"). The percentile = 95. The time value of the result is expressed in units of seconds, with resolution of 0.0001 seconds (0.1 ms), and with lossless conversion to/from the 32-bit NTP timestamp as per section 6 of RFC [RFC5905] 4.4.3. Reference See the Data Format column for references. 4.4.4. Metric Units . The 95th Percentile of Round-trip Delay is expressed in seconds. 4.5. Administrative items 4.5.1. Status 4.5.2. Requestor (keep?) name or RFC, etc. 4.5.3. Revision 1.0 4.5.4. Revision Date YYYY-MM-DD 4.6. Comments and Remarks Additional (Informational) details for this entry Morton, et al. Expires June 15, 2016 [Page 16] Internet-Draft Initial Registry December 2015 5. Packet Delay Variation Registry Entry This section gives an initial registry entry for a Packet Delay Variation metric. Note: If each Registry entry should only produce a "raw" output or a statistical summary, then the "Output" Category can be split and this section can become two closely-related metrics. 5.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. 5.1.1. ID (Identifier) 5.1.2. Name Act_IP-UDP-One-way-pdv-95th-percentile-Poisson URL: ?? 5.1.3. URI URI: Prefix urn:ietf:params:performance:metric 5.1.4. Description An assessment of packet delay variation with respect to the minimum delay observed on the stream. 5.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 5.2.1. Reference Definition Morton, et al. Expires June 15, 2016 [Page 17] Internet-Draft Initial Registry December 2015 Paxson, V., Almes, G., Mahdavi, J., and M. Mathis, "Framework for IP Performance Metrics", RFC 2330, May 1998. [RFC2330] Demichelis, C. and P. Chimento, "IP Packet Delay Variation Metric for IP Performance Metrics (IPPM)", RFC 3393, November 2002. [RFC3393] Morton, A. and B. Claise, "Packet Delay Variation Applicability Statement", RFC 5481, March 2009. [RFC5481] Mills, D., Martin, J., Burbank, J., and W. Kasch, "Network Time Protocol Version 4: Protocol and Algorithms Specification", RFC 5905, June 2010.[RFC5905] See sections 2.4 and 3.4 of [RFC3393]. Singleton delay differences measured are referred to by the variable name "ddT". 5.2.2. Fixed Parameters o F, a selection function defining unambiguously the packets from the stream selected for the metric. See section 4.2 of [RFC5481] for the PDV form. o L, a packet length in bits. L = 200 bits. o Tmax, a maximum waiting time for packets to arrive at Dst, set sufficiently long to disambiguate packets with long delays from packets that are discarded (lost). Tmax = 3 seconds. o Type-P, as defined in [RFC2330], which includes any field that may affect a packet's treatment as it traverses the network. The packets are IP/UDP, with DSCP = 0 (BE). 5.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. Morton, et al. Expires June 15, 2016 [Page 18] Internet-Draft Initial Registry December 2015 5.3.1. Reference Method See section 2.6 and 3.6 of [RFC3393] for singleton elements. 5.3.2. Packet Generation Stream Poisson distributed as described in [RFC2330], with the following Parameters. o lambda, a rate in reciprocal seconds (for Poisson Streams). lambda = 1 packet per second o Upper limit on Poisson distribution (values above this limit will be clipped and set to the limit value). Upper limit = 30 seconds. 5.3.3. Traffic Filtering (observation) Details . NA 5.3.4. Sampling Distribution NA 5.3.5. Run-time Parameters and Data Format . o Src, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o Dst, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o T, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]). When T0 is "all-zeros", a start time Morton, et al. Expires June 15, 2016 [Page 19] Internet-Draft Initial Registry December 2015 is unspecified and Tf is to be interpreted as the Duration of the measurement interval. o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]), interpreted as the Duration of the measurement interval. 5.3.6. Roles Src - the host that sends the stream of packets. Dst - the host that receives the stream of packets. 5.4. Output This category specifies all details of the Output of measurements using the metric. 5.4.1. Type/Value (two diff terms used) Raw -- for each packet sent, pairs of values. Percentile -- for the conditional distribution of all packets with a valid value of one-way delay (undefined delays are excluded), a single value corresponding to the 95th percentile of the singletons, ddT. 5.4.2. Data Format For all Output types o T, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) Raw - o T1, the wire time of the first packet in a pair, measured at MP(Src) as it leaves for Dst (64-bit NTP Timestamp Format, see section 6 of [RFC5905]). Morton, et al. Expires June 15, 2016 [Page 20] Internet-Draft Initial Registry December 2015 o T2, the wire time of the second packet in a pair, measured at MP(Src) as it leaves for Dst (64-bit NTP Timestamp Format, see section 6 of [RFC5905]). o I(i),I(i+1), i >=0, pairs of times which mark the beginning and ending of the intervals in which the packet stream from which the measurement is taken occurs. Here, I(0) = T0 and assuming that n is the largest index, I(n) = Tf (pairs of 64-bit NTP Timestamp Format, see section 6 of [RFC5905]). o When the one-way delay of a packet in the calculation pair for ddT is undefined, then ddT is undefined for that pair. Percentile -- for the conditional distribution of all packets with a valid value of one-way delay (undefined delays are excluded), a single value as follows: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3 of [RFC3393] for details on the percentile statistic (where pdv should be substituted for "ipdv"). The percentile = 95. Data format is a 32-bit signed floating point value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 5.4.3. Reference see Data Format column. 5.4.4. Metric Units . See section 3.3 of [RFC3393] for singleton elements, ddT. The units are seconds, and the same units are used for 95th percentile. [RFC2330] recommends that when a time is given, it will be expressed in UTC. Morton, et al. Expires June 15, 2016 [Page 21] Internet-Draft Initial Registry December 2015 The timestamp format (for T, Tf, etc.) is the same as in [RFC5905] (64 bits) and is as follows: the first 32 bits represent the unsigned integer number of seconds elapsed since 0h on 1 January 1900; the next 32 bits represent the fractional part of a second that has elapsed since then. 5.5. Administrative items 5.5.1. Status 5.5.2. Requestor (keep?) 5.5.3. Revision 1.0 5.5.4. Revision Date YYYY-MM-DD 5.6. Comments and Remarks Lost packets represent a challenge for delay variation metrics. See section 4.1 of [RFC3393] and the delay variation applicability statement[RFC5481] for extensive analysis and comparison of PDV and an alternate metric, IPDV. 6. DNS Response Latency Registry Entry This section gives an initial registry entry for DNS Response Latency. RFC 2681 [RFC2681] defines a Round-trip delay metric. We build on that metric by specifying several of the input parameters to precisely define a metric for measuring DNS latency. 6.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. Morton, et al. Expires June 15, 2016 [Page 22] Internet-Draft Initial Registry December 2015 6.1.1. ID (Identifier) 6.1.2. Name URL: ?? 6.1.3. URI URI: Prefix urn:ietf:params:performance:metric 6.1.4. Description This metric assesses the response time, the interval from the query transmission to the response. 6.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 6.2.1. Reference Definition Mockapetris, P., "Domain names - implementation and specification", STD 13, RFC 1035, November 1987. (and updates) [RFC1035] Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay Metric for IPPM", RFC 2681, September 1999. [RFC2681] Section 2.4 of [RFC2681] provides the reference definition of the singleton (single value) Round-trip delay metric. Section 3.4 of [RFC2681] provides the reference definition expanded to cover a multi-value sample. Note that terms such as singleton and sample are defined in Section 11 of [RFC2330]. Morton, et al. Expires June 15, 2016 [Page 23] Internet-Draft Initial Registry December 2015 For DNS Response Latency, the entities in [RFC1035] must be mapped to [RFC2681]. The Local Host with its User Program and Resolver take the role of "Src", and the Foreign Name Server takes the role of "Dst". Note that although the definition of "Round-trip-Delay between Src and Dst at T" is directionally ambiguous in the text, this metric tightens the definition further to recognize that the host in the "Src" role will send the first packet to "Dst", and ultimately receive the corresponding return packet from "Dst" (when neither are lost). 6.2.2. Fixed Parameters Type-P: o IPv4 header values: * DSCP: set to 0 * TTL set to 255 * Protocol: Set to 17 (UDP) o UDP header values: * Source port: 53 * Destination port: 53 * Checksum: the checksum must be calculated o Payload: The payload contains a DNS message as defined in RFC 1035 [RFC1035] with the following values: * The DNS header section contains: + QR: set to 0 (Query) + OPCODE: set to 0 (standard query) + AA: not set + TC: not set Morton, et al. Expires June 15, 2016 [Page 24] Internet-Draft Initial Registry December 2015 + RD: set to one (recursion desired) + RA: not set + RCODE: not set + QDCOUNT: set to one (only one entry) + ANCOUNT: not set + NSCOUNT: not set + ARCOUNT: not set * The Question section contains: + QNAME: the FQDN provided as input for the test + QTYPE: the query type provided as input for the test + QCLASS: set to IN * The other sections do not contain any Resource Records. Observation: reply packets will contain a DNS response and may contain RRs. Timeout: Tmax = 5 seconds (to help disambiguate queries) 6.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. 6.3.1. Reference Method The methodology for this metric is defined as Type-P-Round-trip- Delay-Poisson-Stream in section 2.6 of RFC 2681 [RFC2681] and section 3.6 of RFC 2681 [RFC2681] using the Type-P and Timeout defined under Fixed Parameters. The method requires sequence numbers or other send-order information to be retained at the Src or included with each packet to dis- Morton, et al. Expires June 15, 2016 [Page 25] Internet-Draft Initial Registry December 2015 ambiguate packet reordering if it occurs. Sequence number is part of the payload described under Fixed Parameters. DNS Messages bearing Queries provide for random ID Numbers, so more than one query may be launched while a previous request is outstanding when the ID Number is used. IF a DNS response does not arrive within Tmax, the result is undefined. The Message ID SHALL be used to disambiguate the successive queries. >>> This would require support of ID generation and population in the Message. An alternative would be to use a random Source port on the Query Message, but we would choose ONE before proceding. Refer to Section 4.4 of [RFC6673] for expanded discussion of the instruction to "send a Type-P packet back to the Src as quickly as possible" in Section 2.6 of RFC 2681 [RFC2681]. Section 8 of [RFC6673] presents additional requirements which shall be included in the method of measurement for this metric. 6.3.2. Packet Generation Stream This section gives the details of the packet traffic which is the basis for measurement. In IPPM metrics, this is called the Stream, and can easily be dscribed by providing the list of stream parameters. Section 11.1.3 of RFC 2681 [RFC2330] provides three methods to generate Poisson sampling intervals. the reciprocal of lambda is the average packet rate, thus the Run-time Parameter is 1/lambda. >>> Check with Sam, most likely it is this... Method 3 is used, where given a start time (Run-time Parameter), the subsequent send times are all computed prior to measurement by computing the pseudo-random distribution of inter-packet send times, (truncating the distribution as specified in the Run-time Parameters), and the Src sends each packet at the computed times. 6.3.3. Traffic Filtering (observation) Details The measured results based on a filtered version of the packets observed, and this section provides the filter details (when present). Morton, et al. Expires June 15, 2016 [Page 26] Internet-Draft Initial Registry December 2015
. NA 6.3.4. Sampling Distribution NA 6.3.5. Run-time Parameters and Data Format Run-time Parameters are input factors that must be determined, configured into the measurement system, and reported with the results for the context to be complete. o Src, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o Dst, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o T0, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]). When T0 is "all-zeros", a start time is unspecified and Tf is to be interpreted as the Duration of the measurement interval. o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]), interpreted as the Duration of the measurement interval. o 1/lambda, average packet rate (for Poisson Streams). (1/lambda = 0.1 packet per second, if fixed) o Upper limit on Poisson distribution (values above this limit will be clipped and set to the limit value). (if fixed, Upper limit = 300 seconds.) o ID, the 16-bit identifier assigned by the program that generates the query, and which must vary in successive queries, see Section 4.1.1 of [RFC1035]. This identifier is copied into the corresponding reply and can be used by the requester to match-up replies to outstanding queries. Morton, et al. Expires June 15, 2016 [Page 27] Internet-Draft Initial Registry December 2015 The format for 1/lambda and Upper limit of Poisson Dist. are the short format in [RFC5905] (32 bits) and is as follows: the first 16 bits represent the integer number of seconds; the next 16 bits represent the fractional part of a second. >>> should Poisson run-time params be fixed instead? probably yes if modeling a specific version of MBA tests. 6.3.6. Roles Src - launches each packet and waits for return transmissions from Dst. Dst - waits for each packet from Src and sends a return packet to Src. 6.4. Output This category specifies all details of the Output of measurements using the metric. 6.4.1. Type/Value (two diff terms used) For all output types: o T0, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) Raw -- for each packet sent, pairs of values. >>> and the status of the response, only assigning values to successful query-response pairs. Percentile -- for the conditional distribution of all packets with a valid value of Round-trip delay (undefined delays are excluded), a single value corresponding to the 95th percentile. Morton, et al. Expires June 15, 2016 [Page 28] Internet-Draft Initial Registry December 2015 6.4.2. Data Format Raw -- for each packet sent, pairs of values as follows: o T, the time when the packet was sent from Src, 128-bit NTP Date Format, see section 6 of [RFC5905]) o dT, a value of Round-trip delay, format is *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. o dT is undefined when the packet is not received at Src in waiting time Tmxax seconds (need undefined code for no-response or un- successful response) Percentile -- for the conditional distribution of all packets with a valid value of Round-trip delay (undefined delays are excluded), a single value as follows: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3 of [RFC3393] for details on the percentile statistic (where Round-trip delay should be substituted for "ipdv"). The percentile = 95. Data format is a 32-bit signed floating point value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 6.4.3. Reference See the Data Format column for references. 6.4.4. Metric Units . Morton, et al. Expires June 15, 2016 [Page 29] Internet-Draft Initial Registry December 2015 Round-trip Delay, dT, is expressed in seconds. The 95th Percentile of Round-trip Delay is expressed in seconds. 6.5. Administrative items 6.5.1. Status 6.5.2. Requestor (keep?) name or RFC, etc. 6.5.3. Revision 1.0 6.5.4. Revision Date YYYY-MM-DD 6.6. Comments and Remarks Additional (Informational) details for this entry 7. UDP Poisson One-way Delay Registry Entries This section gives an initial registry entry for the UDP Poisson One- way Delay. Note: Each Registry "Name" below specifies a single registry entry, whose output format varies according to a component of the name that specifies one form of statistical summary. IANA is asked to assign a different numeric identifiers to each Name. All other column entries are the same, thus this section is proposes five closely-related registry entries. As a result, IANA is also asked to assign corresponding URIs and URLs. 7.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. Morton, et al. Expires June 15, 2016 [Page 30] Internet-Draft Initial Registry December 2015 7.1.1. ID (Identifier) 7.1.2. Name Act_IP_UDP_Poisson_UDP-Payload-250_One-way_Delay_ Act_IP_UDP_Poisson_UDP-Payload-250_One-way_Delay_Percentile95 Act_IP_UDP_Poisson_UDP-Payload-250_One-way_Delay_Mean Act_IP_UDP_Poisson_UDP-Payload-250_One-way_Delay_Min Act_IP_UDP_Poisson_UDP-Payload-250_One-way_Delay_Max Act_IP_UDP_Poisson_UDP-Payload-250_One-way_Delay_Std_Dev 7.1.3. URI and URL URI: Prefix urn:ietf:params:performance:metric... URL: http:\\www.iana.org\ ... 7.1.4. Description This metric assesses the delay of a stream of packets exchanged between two hosts (or measurement points), and reports the One-way delay for all successfully exchanged packets based on their conditional delay distribution. 7.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 7.2.1. Reference Definition Almes, G., Kalidindi, S., and M. Zekauskas, "A One-way Delay Metric for IPPM", RFC 2679, September 1999. [RFC2679] Morton, et al. Expires June 15, 2016 [Page 31] Internet-Draft Initial Registry December 2015 Morton, A., and Stephan, E., "Spatial Composition of Metrics", RFC 6049, January 2011. [RFC6049] Section 3.4 of [RFC2679] provides the reference definition of the singleton (single value) One-way delay metric. Section 4.4 of [RFC2679] provides the reference definition expanded to cover a multi-value sample. Note that terms such as singleton and sample are defined in Section 11 of [RFC2330]. Only successful packet transfers with finite delay are included in the sample, as prescribed in section 4.1.2 of [RFC6049]. NOTE: RFC2679 will be replaced by 2679-bis on approval, see draft- ietf-ippm-2679-bis-01. 7.2.2. Fixed Parameters Type-P: o IPv4 header values: * DSCP: set to 0 * TTL set to 255 * Protocol: Set to 17 (UDP) o UDP header values: * Checksum: the checksum must be calculated o UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of [RFC5357] * Security features in use influence the number of Padding octets. * 250 octets total, including the TWAMP format Timeout, Tmax: 3 seconds Morton, et al. Expires June 15, 2016 [Page 32] Internet-Draft Initial Registry December 2015 7.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. 7.3.1. Reference Method The methodology for this metric is defined as Type-P-One-way-Delay- Poisson-Stream in section 3.6 of [RFC2679] and section 4.6 of [RFC2679] using the Type-P and Timeout defined under Fixed Parameters. The method requires sequence numbers or other send-order information to be retained at the Src or included with each packet to dis- ambiguate packet reordering if it occurs. Sequence number is part of the TWAMP payload described under Fixed Parameters. 7.3.2. Packet Generation Stream This section gives the details of the packet traffic which is the basis for measurement. In IPPM metrics, this is called the Stream, and can easily be dscribed by providing the list of stream parameters. Section 11.1.3 of RFC 2681 [RFC2330] provides three methods to generate Poisson sampling intervals. The reciprocal of lambda is the average packet rate, thus the Run-time Parameter is 1/lambda. Method 3 or equivalent SHALL used, where given a start time (Run-time Parameter), the subsequent send times are all computed prior to measurement by computing the pseudo-random distribution of inter- packet send times, (truncating the distribution as specified in the Run-time Parameters), and the Src sends each packet at the computed times. 7.3.3. Traffic Filtering (observation) Details NA Morton, et al. Expires June 15, 2016 [Page 33] Internet-Draft Initial Registry December 2015 7.3.4. Sampling Distribution NA 7.3.5. Run-time Parameters and Data Format Run-time Parameters are input factors that must be determined, configured into the measurement system, and reported with the results for the context to be complete. o Src, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o Dst, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o T0, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]). When T0 is "all-zeros", a start time is unspecified and Tf is to be interpreted as the Duration of the measurement interval. o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]), interpreted as the Duration of the measurement interval. o 1/lambda, average packet rate (for Poisson Streams). (1/lambda = 1 packet per second, if fixed) o Upper limit on Poisson distribution (values above this limit will be clipped and set to the limit value). (if fixed, Upper limit = 30 seconds.) The format for 1/lambda and Upper limit of Poisson Dist. are the short format in [RFC5905] (32 bits) and is as follows: the first 16 bits represent the integer number of seconds; the next 16 bits represent the fractional part of a second. >>> should Poisson run-time params be fixed instead? probably yes if modeling a specific version of tests. Note in the NAME, i.e. Poisson3.3 7.3.6. Roles Morton, et al. Expires June 15, 2016 [Page 34] Internet-Draft Initial Registry December 2015 Src - launches each packet and waits for return transmissions from Dst. This is the TWAMP Session-Sender. Dst - waits for each packet from Src and sends a return packet to Src. This is the TWAMP Session-Reflector. 7.4. Output This category specifies all details of the Output of measurements using the metric. 7.4.1. Type/Value (two diff terms used) See subsection titles below for Types. 7.4.2. Data Format For all output types --- o T0, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) 7.4.2.1. Percentile95 The 95th percentile SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3 of [RFC3393] for details on the percentile statistic (where Round-trip delay should be substituted for "ipdv"). The percentile = 95. Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. Morton, et al. Expires June 15, 2016 [Page 35] Internet-Draft Initial Registry December 2015 7.4.2.2. Mean The mean SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.2.2 of [RFC6049] for details on calculating this statistic, and 4.2.3 of [RFC6049]. Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 7.4.2.3. Min The minimum SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3.2 of [RFC6049] for details on calculating this statistic, and 4.3.3 of [RFC6049]. Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 7.4.2.4. Max The maximum SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. Morton, et al. Expires June 15, 2016 [Page 36] Internet-Draft Initial Registry December 2015 See section 4.3.2 of [RFC6049] for a closely related method for calculating this statistic, and 4.3.3 of [RFC6049]. The formula is as follows: Max = (FiniteDelay [j]) such that for some index, j, where 1 <= j <= N FiniteDelay[j] >= FiniteDelay[n] for all n Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 7.4.2.5. Std_Dev 7.4.3. Reference See the Data Format column for references. 7.4.4. Metric Units . The of One-way Delay is expressed in seconds. The 95th Percentile of One-way Delay is expressed in seconds. 7.5. Administrative items 7.5.1. Status 7.5.2. Requestor (keep?) name or RFC, etc. 7.5.3. Revision 1.0 Morton, et al. Expires June 15, 2016 [Page 37] Internet-Draft Initial Registry December 2015 7.5.4. Revision Date YYYY-MM-DD 7.6. Comments and Remarks Additional (Informational) details for this entry 8. UDP Periodic One-way Delay Registry Entries This section gives an initial registry entry for the UDP Periodic One-way Delay. Note: Each Registry "Name" below specifies a single registry entry, whose output format varies according to a component of the name that specifies one form of statistical summary. IANA is asked to assign a different numeric identifiers to each Name. All other column entries are the same, thus this section is proposes five closely-related registry entries. As a result, IANA is also asked to assign corresponding URIs and URLs. 8.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. 8.1.1. ID (Identifier) 8.1.2. Name Act_IP_UDP_Periodic-var_UDP-Payload-142_One-way_Delay_ Act_IP_UDP_Periodic-var_UDP-Payload-142_One-way_Delay_Percentile95 Act_IP_UDP_Periodic-var_UDP-Payload-142_One-way_Delay_Mean Act_IP_UDP_Periodic-var_UDP-Payload-142_One-way_Delay_Min Act_IP_UDP_Periodic-var_UDP-Payload-142_One-way_Delay_Max Act_IP_UDP_Periodic-var_UDP-Payload-142_One-way_Delay_Std_Dev Morton, et al. Expires June 15, 2016 [Page 38] Internet-Draft Initial Registry December 2015 8.1.3. URI and URL URI: Prefix urn:ietf:params:performance:metric... URL: http:\\www.iana.org\ ... 8.1.4. Description This metric assesses the delay of a stream of packets exchanged between two hosts (or measurement points), and reports the One-way delay for all successfully exchanged packets based on their conditional delay distribution. 8.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 8.2.1. Reference Definition Almes, G., Kalidindi, S., and M. Zekauskas, "A One-way Delay Metric for IPPM", RFC 2679, September 1999. [RFC2679] Morton, A., and Stephan, E., "Spatial Composition of Metrics", RFC 6049, January 2011. [RFC6049] Section 3.4 of [RFC2679] provides the reference definition of the singleton (single value) One-way delay metric. Section 4.4 of [RFC2679] provides the reference definition expanded to cover a multi-value sample. Note that terms such as singleton and sample are defined in Section 11 of [RFC2330]. Only successful packet transfers with finite delay are included in the sample, as prescribed in section 4.1.2 of [RFC6049]. NOTE: RFC2679 will be replaced by 2679-bis on approval, see draft- ietf-ippm-2679-bis-01. ANY other conditions, ... Morton, et al. Expires June 15, 2016 [Page 39] Internet-Draft Initial Registry December 2015 8.2.2. Fixed Parameters Type-P: o IPv4 header values: * DSCP: set to 0 * TTL set to 255 * Protocol: Set to 17 (UDP) o UDP header values: * Checksum: the checksum must be calculated o UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of [RFC5357] * Security features in use influence the number of Padding octets. * 142 octets total, including the TWAMP format Timeout, Tmax: 3 seconds 8.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. 8.3.1. Reference Method The methodology for this metric is defined as Type-P-One-way-Delay- Poisson-Stream in section 3.6 of [RFC2679] and section 4.6 of [RFC2679] using the Type-P and Timeout defined under Fixed Parameters. The method requires sequence numbers or other send-order information to be retained at the Src or included with each packet to dis- Morton, et al. Expires June 15, 2016 [Page 40] Internet-Draft Initial Registry December 2015 ambiguate packet reordering if it occurs. Sequence number is part of the TWAMP payload described under Fixed Parameters. 8.3.2. Packet Generation Stream This section gives the details of the packet traffic which is the basis for measurement. In IPPM metrics, this is called the Stream, and can easily be dscribed by providing the list of stream parameters. Section 3 of [RFC3432] prescribes the method for generating Periodic streams using associated parameters. o incT, the nominal duration of inter-packet interval, first bit to first bit o dT, the duration of the interval for allowed sample start times o T0, the actual start time NOTE: an initiation process with a number of control exchanges resulting in unpredictable start times (within a time interval) may be sufficient to avoid synchronization of periodic streams, and therefore a valid replacement for selecting a start time at random from a fixed interval. These stream parameters will be specified as Run-time parameters. 8.3.3. Traffic Filtering (observation) Details NA 8.3.4. Sampling Distribution NA 8.3.5. Run-time Parameters and Data Format Run-time Parameters are input factors that must be determined, configured into the measurement system, and reported with the results for the context to be complete. o Src, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) Morton, et al. Expires June 15, 2016 [Page 41] Internet-Draft Initial Registry December 2015 o Dst, the IP address of a host (32-bit value for IPv4, 128-bit value for IPv6) o T0, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]). When T0 is "all-zeros", a start time is unspecified and Tf is to be interpreted as the Duration of the measurement interval. o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]), interpreted as the Duration of the measurement interval. o incT, the nominal duration of inter-packet interval, first bit to first bit o dT, the duration of the interval for allowed sample start times The format for incT and dT are the short format in [RFC5905] (32 bits) and is as follows: the first 16 bits represent the integer number of seconds; the next 16 bits represent the fractional part of a second. >>> should Periodic run-time params be fixed instead? probably yes if modeling a specific version of tests. Note in the NAME, i.e. Poisson3.3 8.3.6. Roles Src - launches each packet and waits for return transmissions from Dst. This is the TWAMP Session-Sender. Dst - waits for each packet from Src and sends a return packet to Src. This is the TWAMP Session-Reflector. 8.4. Output This category specifies all details of the Output of measurements using the metric. 8.4.1. Type/Value (two diff terms used) See subsection titles in Data Format for Types. Morton, et al. Expires June 15, 2016 [Page 42] Internet-Draft Initial Registry December 2015 8.4.2. Data Format For all output types --- o T0, a time (start of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) o Tf, a time (end of measurement interval, 128-bit NTP Date Format, see section 6 of [RFC5905]) 8.4.2.1. Percentile95 The 95th percentile SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3 of [RFC3393] for details on the percentile statistic (where Round-trip delay should be substituted for "ipdv"). The percentile = 95. Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 8.4.2.2. Mean The mean SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.2.2 of [RFC6049] for details on calculating this statistic, and 4.2.3 of [RFC6049]. Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the Morton, et al. Expires June 15, 2016 [Page 43] Internet-Draft Initial Registry December 2015 first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 8.4.2.3. Min The minimum SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3.2 of [RFC6049] for details on calculating this statistic, and 4.3.3 of [RFC6049]. Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. 8.4.2.4. Max The maximum SHALL 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: See section 4.1 of [RFC3393] for details on the conditional distribution to exclude undefined values of delay, and Section 5 of [RFC6703] for background on this analysis choice. See section 4.3.2 of [RFC6049] for a closely related method for calculating this statistic, and 4.3.3 of [RFC6049]. The formula is as follows: Max = (FiniteDelay [j]) such that for some index, j, where 1 <= j <= N FiniteDelay[j] >= FiniteDelay[n] for all n Data format is a 32-bit signed value, *similar to* the 32-bit short NTP Time format in Section 6 of [RFC5905] and is as follows: the first 16 bits represent the *signed* integer number of seconds; the next 16 bits represent the fractional part of a second. Morton, et al. Expires June 15, 2016 [Page 44] Internet-Draft Initial Registry December 2015 8.4.2.5. Std_Dev 8.4.3. Reference See the Data Format column for references. 8.4.4. Metric Units . The of One-way Delay is expressed in seconds. 8.5. Administrative items 8.5.1. Status 8.5.2. Requestor (keep?) name or RFC, etc. 8.5.3. Revision 1.0 8.5.4. Revision Date YYYY-MM-DD 8.6. Comments and Remarks Additional (Informational) details for this entry 9. partly BLANK Registry Entry This section gives an initial registry entry for .... 9.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. Morton, et al. Expires June 15, 2016 [Page 45] Internet-Draft Initial Registry December 2015 9.1.1. ID (Identifier) 9.1.2. Name URL: ?? 9.1.3. URI URI: Prefix urn:ietf:params:performance:metric 9.1.4. Description TBD. 9.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 9.2.1. Reference Definition Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay Metric for IPPM", RFC 2681, September 1999. Section 2.4 of [RFC2681] provides the reference definition of the singleton (single value) Round-trip delay metric. Section 3.4 of [RFC2681] provides the reference definition expanded to cover a multi-value sample. Note that terms such as singleton and sample are defined in Section 11 of [RFC2330]. Note that although the definition of "Round-trip-Delay between Src and Dst at T" is directionally ambiguous in the text, this metric tightens the definition further to recognize that the host in the "Src" role will send the first packet to "Dst", and ultimately receive the corresponding return packet from "Dst" (when neither are lost). <<< Check how the Methodology also makes this clear (or not) >>> Morton, et al. Expires June 15, 2016 [Page 46] Internet-Draft Initial Registry December 2015 9.2.2. Fixed Parameters Type-P: o IPv4 header values: * DSCP: set to 0 * TTL set to 255 * Protocol: Set to 17 (UDP) o UDP header values: * Checksum: the checksum must be calculated o Payload * Sequence number: 8-byte integer * Timestamp: 8 byte integer. Expressed as 64-bit NTP timestamp as per section 6 of RFC 5905 [RFC5905] * No padding (total of 9 bytes) Timeout: 3 seconds 9.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. 9.3.1. Reference Method 9.3.2. Packet Generation Stream This section gives the details of the packet traffic which is the basis for measurement. In IPPM metrics, this is called the Stream, and can easily be dscribed by providing the list of stream parameters. Morton, et al. Expires June 15, 2016 [Page 47] Internet-Draft Initial Registry December 2015 9.3.3. Traffic Filtering (observation) Details The measured results based on a filtered version of the packets observed, and this section provides the filter details (when present).
. 9.3.4. Sampling Distribution 9.3.5. Run-time Parameters and Data Format Run-time Parameters are input factors that must be determined, configured into the measurement system, and reported with the results for the context to be complete. . 9.3.6. Roles 9.4. Output This category specifies all details of the Output of measurements using the metric. 9.4.1. Type/Value (two diff terms used) 9.4.2. Data Format o Value: o Data Format: (There may be some precedent to follow here, but otherwise use 64-bit NTP Timestamp Format, see section 6 of [RFC5905]). Morton, et al. Expires June 15, 2016 [Page 48] Internet-Draft Initial Registry December 2015 o Reference:
9.4.3. Reference 9.4.4. Metric Units . 9.5. Administrative items 9.5.1. Status 9.5.2. Requestor (keep?) name or RFC, etc. 9.5.3. Revision 1.0 9.5.4. Revision Date YYYY-MM-DD 9.6. Comments and Remarks Additional (Informational) details for this entry 10. BLANK Registry Entry This section gives an initial registry entry for .... 10.1. Summary This category includes multiple indexes to the registry entries, the element ID and metric name. Morton, et al. Expires June 15, 2016 [Page 49] Internet-Draft Initial Registry December 2015 10.1.1. ID (Identifier) 10.1.2. Name URL: ?? 10.1.3. URI URI: Prefix urn:ietf:params:performance:metric 10.1.4. Description TBD. 10.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. 10.2.1. Reference Definition 10.2.2. Fixed Parameters 10.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. 10.3.1. Reference Method Morton, et al. Expires June 15, 2016 [Page 50] Internet-Draft Initial Registry December 2015 10.3.2. Packet Generation Stream 10.3.3. Traffic Filtering (observation) Details . 10.3.4. Sampling Distribution 10.3.5. Run-time Parameters and Data Format . 10.3.6. Roles 10.4. Output This category specifies all details of the Output of measurements using the metric. 10.4.1. Type/Value (two diff terms used) 10.4.2. Data Format 10.4.3. Reference 10.4.4. Metric Units . Morton, et al. Expires June 15, 2016 [Page 51] Internet-Draft Initial Registry December 2015 10.5. Administrative items 10.5.1. Status 10.5.2. Requestor (keep?) 10.5.3. Revision 1.0 10.5.4. Revision Date YYYY-MM-DD 10.6. Comments and Remarks Additional (Informational) details for this entry 11. Example RTCP-XR Registry Entry This section is MAY BE DELETED or adapted before submission. This section gives an example registry entry for the end-point metric described in RFC 7003 [RFC7003], for RTCP-XR Burst/Gap Discard Metric reporting. 11.1. Registry Indexes This category includes multiple indexes to the registry entries, the element ID and metric name. 11.1.1. Identifier An integer having enough digits to uniquely identify each entry in the Registry. 11.1.2. Name A metric naming convention is TBD. Morton, et al. Expires June 15, 2016 [Page 52] Internet-Draft Initial Registry December 2015 11.1.3. URI Prefix urn:ietf:params:performance:metric 11.1.4. Status current 11.1.5. Requestor Alcelip Mornuley 11.1.6. Revision 1.0 11.1.7. Revision Date 2014-07-04 11.1.8. Description TBD. 11.1.9. Reference Specification(s) [RFC3611][RFC4566][RFC6776][RFC6792][RFC7003] 11.2. Metric Definition This category includes columns to prompt the entry of all necessary details related to the metric definition, including the RFC reference and values of input factors, called fixed parameters. Section 3.2 of [RFC7003] provides the reference information for this category. 11.2.1. Reference Definition Packets Discarded in Bursts: The total number of packets discarded during discard bursts. The measured value is unsigned value. If the measured value exceeds 0xFFFFFD, the value 0xFFFFFE MUST be reported to indicate an over- range measurement. If the measurement is unavailable, the value 0xFFFFFF MUST be reported. Morton, et al. Expires June 15, 2016 [Page 53] Internet-Draft Initial Registry December 2015 11.2.2. Fixed Parameters Fixed Parameters are input factors that must be determined and embedded in the measurement system for use when needed. The values of these parameters is specified in the Registry. Threshold: 8 bits, set to value = 3 packets. The Threshold is equivalent to Gmin in [RFC3611], i.e., the number of successive packets that must not be discarded prior to and following a discard packet in order for this discarded packet to be regarded as part of a gap. Note that the Threshold is set in accordance with the Gmin calculation defined in Section 4.7.2 of [RFC3611]. Interval Metric flag: 2 bits, set to value 11=Cumulative Duration This field is used to indicate whether the burst/gap discard metrics are Sampled, Interval, or Cumulative metrics [RFC6792]: I=10: Interval Duration - the reported value applies to the most recent measurement interval duration between successive metrics reports. I=11: Cumulative Duration - the reported value applies to the accumulation period characteristic of cumulative measurements. Senders MUST NOT use the values I=00 or I=01. 11.3. Method of Measurement This category includes columns for references to relevant sections of the RFC(s) and any supplemental information needed to ensure an unambiguous methods for implementations. For the Burst/Gap Discard Metric, it appears that the only guidance on methods of measurement is in Section 3.0 of [RFC7003] and its supporting references. Relevant information is repeated below, although there appears to be no section titled "Method of Measurement" in [RFC7003]. 11.3.1. Reference Method Metrics in this block report on burst/gap discard in the stream arriving at the RTP system. Measurements of these metrics are made at the receiving end of the RTP stream. Instances of this metrics block use the synchronization source (SSRC) to refer to the separate auxiliary Measurement Information Block [RFC6776], which describes measurement periods in use (see [RFC6776], Section 4.2). Morton, et al. Expires June 15, 2016 [Page 54] Internet-Draft Initial Registry December 2015 This metrics block relies on the measurement period in the Measurement Information Block indicating the span of the report. Senders MUST send this block in the same compound RTCP packet as the Measurement Information Block. Receivers MUST verify that the measurement period is received in the same compound RTCP packet as this metrics block. If not, this metrics block MUST be discarded. 11.3.2. Stream Type and Stream Parameters Since RTCP-XR Measurements are conducted on live RTP traffic, the complete description of the stream is contained in SDP messages that proceed the establishment of a compatible stream between two or more communicating hosts. See Run-time Parameters, below. 11.3.3. Output Type and Data Format The output type defines the type of result that the metric produces. o Value: Packets Discarded in Bursts o Data Format: 24 bits o Reference: Section 3.2 of [RFC7003] 11.3.4. Metric Units The measured results are apparently expressed in packets, although there is no section of [RFC7003] titled "Metric Units". 11.3.5. Run-time Parameters and Data Format Run-Time Parameters are input factors that must be determined, configured into the measurement system, and reported with the results for the context to be complete. However, the values of these parameters is not specified in the Registry, rather these parameters are listed as an aid to the measurement system implementor or user (they must be left as variables, and supplied on execution). The Data Format of each Run-time Parameter SHALL be specified in this column, to simplify the control and implementation of measurement devices. SSRC of Source: 32 bits As defined in Section 4.1 of [RFC3611]. SDP Parameters: As defined in [RFC4566] Session description v= (protocol version number, currently only 0) Morton, et al. Expires June 15, 2016 [Page 55] Internet-Draft Initial Registry December 2015 o= (originator and session identifier : username, id, version number, network address) s= (session name : mandatory with at least one UTF-8-encoded character) i=* (session title or short information) u=* (URI of description) e=* (zero or more email address with optional name of contacts) p=* (zero or more phone number with optional name of contacts) c=* (connection information--not required if included in all media) b=* (zero or more bandwidth information lines) One or more Time descriptions ("t=" and "r=" lines; see below) z=* (time zone adjustments) k=* (encryption key) a=* (zero or more session attribute lines) Zero or more Media descriptions (each one starting by an "m=" line; see below) m= (media name and transport address) i=* (media title or information field) c=* (connection information -- optional if included at session level) b=* (zero or more bandwidth information lines) k=* (encryption key) a=* (zero or more media attribute lines -- overriding the Session attribute lines) An example Run-time SDP description follows: v=0 o=jdoe 2890844526 2890842807 IN IP4 192.0.2.5 s=SDP Seminar i=A Seminar on the session description protocol Morton, et al. Expires June 15, 2016 [Page 56] Internet-Draft Initial Registry December 2015 u=http://www.example.com/seminars/sdp.pdf e=j.doe@example.com (Jane Doe) c=IN IP4 233.252.0.12/127 t=2873397496 2873404696 a=recvonly m=audio 49170 RTP/AVP 0 m=video 51372 RTP/AVP 99 a=rtpmap:99 h263-1998/90000 11.4. Comments and Remarks TBD. 12. Security Considerations These registry entries represent no known security implications for Internet Security. Each referenced Metric contains a Security Considerations section. 13. IANA Considerations IANA is requested to populate The Performance Metric Registry defined in [I-D.ietf-ippm-metric-registry] with the values defined above. 14. Acknowledgements 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, 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. The authors also acknowledge the constructive reviews and helpful suggestions from Barbara Stark, Juergen Schoenwaelder, Tim Carey, and participants in the LMAP working group. Morton, et al. Expires June 15, 2016 [Page 57] Internet-Draft Initial Registry December 2015 15. References 15.1. Normative References [I-D.ietf-ippm-metric-registry] Bagnulo, M., Claise, B., Eardley, P., and A. Morton, "Registry for Performance Metrics", Internet Draft (work in progress) draft-ietf-ippm-metric-registry, 2014. [RFC1035] Mockapetris, P., "Domain names - implementation and specification", STD 13, RFC 1035, DOI 10.17487/RFC1035, November 1987, . [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC2330] Paxson, V., Almes, G., Mahdavi, J., and M. Mathis, "Framework for IP Performance Metrics", RFC 2330, DOI 10.17487/RFC2330, May 1998, . [RFC2679] Almes, G., Kalidindi, S., and M. Zekauskas, "A One-way Delay Metric for IPPM", RFC 2679, DOI 10.17487/RFC2679, September 1999, . [RFC2680] Almes, G., Kalidindi, S., and M. Zekauskas, "A One-way Packet Loss Metric for IPPM", RFC 2680, DOI 10.17487/RFC2680, September 1999, . [RFC2681] Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay Metric for IPPM", RFC 2681, DOI 10.17487/RFC2681, September 1999, . [RFC3339] Klyne, G. and C. Newman, "Date and Time on the Internet: Timestamps", RFC 3339, DOI 10.17487/RFC3339, July 2002, . [RFC3393] Demichelis, C. and P. Chimento, "IP Packet Delay Variation Metric for IP Performance Metrics (IPPM)", RFC 3393, DOI 10.17487/RFC3393, November 2002, . Morton, et al. Expires June 15, 2016 [Page 58] Internet-Draft Initial Registry December 2015 [RFC3432] Raisanen, V., Grotefeld, G., and A. Morton, "Network performance measurement with periodic streams", RFC 3432, DOI 10.17487/RFC3432, November 2002, . [RFC4737] Morton, A., Ciavattone, L., Ramachandran, G., Shalunov, S., and J. Perser, "Packet Reordering Metrics", RFC 4737, DOI 10.17487/RFC4737, November 2006, . [RFC5357] Hedayat, K., Krzanowski, R., Morton, A., Yum, K., and J. Babiarz, "A Two-Way Active Measurement Protocol (TWAMP)", RFC 5357, DOI 10.17487/RFC5357, October 2008, . [RFC5905] Mills, D., Martin, J., Ed., Burbank, J., and W. Kasch, "Network Time Protocol Version 4: Protocol and Algorithms Specification", RFC 5905, DOI 10.17487/RFC5905, June 2010, . [RFC6049] Morton, A. and E. Stephan, "Spatial Composition of Metrics", RFC 6049, DOI 10.17487/RFC6049, January 2011, . [RFC6673] Morton, A., "Round-Trip Packet Loss Metrics", RFC 6673, DOI 10.17487/RFC6673, August 2012, . [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6991, DOI 10.17487/RFC6991, July 2013, . 15.2. Informative References [Brow00] Brownlee, N., "Packet Matching for NeTraMet Distributions", March 2000. [RFC1242] Bradner, S., "Benchmarking Terminology for Network Interconnection Devices", RFC 1242, DOI 10.17487/RFC1242, July 1991, . [RFC3611] Friedman, T., Ed., Caceres, R., Ed., and A. Clark, Ed., "RTP Control Protocol Extended Reports (RTCP XR)", RFC 3611, DOI 10.17487/RFC3611, November 2003, . Morton, et al. Expires June 15, 2016 [Page 59] Internet-Draft Initial Registry December 2015 [RFC4148] Stephan, E., "IP Performance Metrics (IPPM) Metrics Registry", BCP 108, RFC 4148, DOI 10.17487/RFC4148, August 2005, . [RFC4566] Handley, M., Jacobson, V., and C. Perkins, "SDP: Session Description Protocol", RFC 4566, DOI 10.17487/RFC4566, July 2006, . [RFC5472] Zseby, T., Boschi, E., Brownlee, N., and B. Claise, "IP Flow Information Export (IPFIX) Applicability", RFC 5472, DOI 10.17487/RFC5472, March 2009, . [RFC5477] Dietz, T., Claise, B., Aitken, P., Dressler, F., and G. Carle, "Information Model for Packet Sampling Exports", RFC 5477, DOI 10.17487/RFC5477, March 2009, . [RFC5481] Morton, A. and B. Claise, "Packet Delay Variation Applicability Statement", RFC 5481, DOI 10.17487/RFC5481, March 2009, . [RFC6248] Morton, A., "RFC 4148 and the IP Performance Metrics (IPPM) Registry of Metrics Are Obsolete", RFC 6248, DOI 10.17487/RFC6248, April 2011, . [RFC6390] Clark, A. and B. Claise, "Guidelines for Considering New Performance Metric Development", BCP 170, RFC 6390, DOI 10.17487/RFC6390, October 2011, . [RFC6703] Morton, A., Ramachandran, G., and G. Maguluri, "Reporting IP Network Performance Metrics: Different Points of View", RFC 6703, DOI 10.17487/RFC6703, August 2012, . [RFC6776] Clark, A. and Q. Wu, "Measurement Identity and Information Reporting Using a Source Description (SDES) Item and an RTCP Extended Report (XR) Block", RFC 6776, DOI 10.17487/RFC6776, October 2012, . [RFC6792] Wu, Q., Ed., Hunt, G., and P. Arden, "Guidelines for Use of the RTP Monitoring Framework", RFC 6792, DOI 10.17487/RFC6792, November 2012, . Morton, et al. Expires June 15, 2016 [Page 60] Internet-Draft Initial Registry December 2015 [RFC7003] Clark, A., Huang, R., and Q. Wu, Ed., "RTP Control Protocol (RTCP) Extended Report (XR) Block for Burst/Gap Discard Metric Reporting", RFC 7003, DOI 10.17487/RFC7003, September 2013, . [RFC7594] Eardley, P., Morton, A., Bagnulo, M., Burbridge, T., Aitken, P., and A. Akhter, "A Framework for Large-Scale Measurement of Broadband Performance (LMAP)", RFC 7594, DOI 10.17487/RFC7594, September 2015, . Authors' Addresses Al Morton AT&T Labs 200 Laurel Avenue South Middletown,, NJ 07748 USA Phone: +1 732 420 1571 Fax: +1 732 368 1192 Email: acmorton@att.com URI: http://home.comcast.net/~acmacm/ Marcelo Bagnulo Universidad Carlos III de Madrid Av. Universidad 30 Leganes, Madrid 28911 SPAIN Phone: 34 91 6249500 Email: marcelo@it.uc3m.es URI: http://www.it.uc3m.es Philip Eardley BT Adastral Park, Martlesham Heath Ipswich ENGLAND Email: philip.eardley@bt.com Morton, et al. Expires June 15, 2016 [Page 61] Internet-Draft Initial Registry December 2015 Kevin D'Souza AT&T Labs 200 Laurel Avenue South Middletown,, NJ 07748 USA Phone: +1 732 420 xxxx Email: kld@att.com Morton, et al. Expires June 15, 2016 [Page 62]