draft-ietf-ippm-initial-registry-02.txt   draft-ietf-ippm-initial-registry-03.txt
Network Working Group A. Morton Network Working Group A. Morton
Internet-Draft AT&T Labs Internet-Draft AT&T Labs
Intended status: Standards Track M. Bagnulo Intended status: Standards Track M. Bagnulo
Expires: UC3M Expires: September 10, 2017 UC3M
P. Eardley P. Eardley
BT BT
K. D'Souza K. D'Souza
AT&T Labs AT&T Labs
March 9, 2017
Initial Performance Metric Registry Entries Initial Performance Metric Registry Entries
draft-ietf-ippm-initial-registry-0 draft-ietf-ippm-initial-registry-03
Abstract Abstract
This memo defines the Initial Entries for the Performance Metrics This memo defines the Initial Entries for the Performance Metrics
Registry. This version includes: Registry. This version includes:
* All section and parameters reference YANG types for alternate * All section 4, 5, 6, 7, and 8 parameters reference YANG types for
data formats. alternate data formats.
* implementation of standard naming format for parameters. * implementation of standard naming format for parameters.
Still need: * implementation of many IANA early-review comments.
Still need: Add MBM metric entry.
Requirements Language Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in RFC 2119 [RFC2119].
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
skipping to change at page 2, line 4 skipping to change at page 2, line 4
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on , 2017. This Internet-Draft will expire on September 10, 2017.
Copyright (c) 201 IETF Trust and the persons identified as the Copyright (c) 2017 IETF Trust and the persons identified as the
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
skipping to change at page 2, line 40 skipping to change at page 2, line 40
4.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 9 4.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1.4. Description . . . . . . . . . . . . . . . . . . . . . 9 4.1.4. Description . . . . . . . . . . . . . . . . . . . . . 9
4.1.5. Change Controller . . . . . . . . . . . . . . . . . . 9 4.1.5. Change Controller . . . . . . . . . . . . . . . . . . 9
4.1.6. Version (of Registry Format) . . . . . . . . . . . . 9 4.1.6. Version (of Registry Format) . . . . . . . . . . . . 9
4.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 9 4.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 9
4.2.1. Reference Definition . . . . . . . . . . . . . . . . 9 4.2.1. Reference Definition . . . . . . . . . . . . . . . . 9
4.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 10 4.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 10
4.3. Method of Measurement . . . . . . . . . . . . . . . . . . 11 4.3. Method of Measurement . . . . . . . . . . . . . . . . . . 11
4.3.1. Reference Method . . . . . . . . . . . . . . . . . . 11 4.3.1. Reference Method . . . . . . . . . . . . . . . . . . 11
4.3.2. Packet Stream Generation . . . . . . . . . . . . . . 12 4.3.2. Packet Stream Generation . . . . . . . . . . . . . . 12
4.3.3. Traffic Filtering (observation) Details . . . . . . . 1 4.3.3. Traffic Filtering (observation) Details . . . . . . . 13
4.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 13 4.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 13
4.3.5. Run-time Parameters and Data Format . . . . . . . . . 13 4.3.5. Run-time Parameters and Data Format . . . . . . . . . 13
4.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 14 4.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 14
4.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 14 4.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 14
4.4.2. Reference Definition . . . . . . . . . . . . . . . . 1 4.4.2. Reference Definition . . . . . . . . . . . . . . . . 15
4.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 15 4.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 15
4.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 15 4.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 15
4.5. Administrative items . . . . . . . . . . . . . . . . . . 16 4.5. Administrative items . . . . . . . . . . . . . . . . . . 16
4.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 16 4.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 16
4.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 16 4.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 16
4.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 16 4.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 16
4.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 16 4.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 16
4.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 16 4.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 16
5. Packet Delay Variation Registry Entry . . . . . . . . . . . . 16 5. Packet Delay Variation Registry Entry . . . . . . . . . . . . 16
5.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 16 5.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 5.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 17
5.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 5.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 17
5.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 17 5.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 17
5.1.4. Description . . . . . . . . . . . . . . . . . . . . . 17 5.1.4. Description . . . . . . . . . . . . . . . . . . . . . 17
5.1.5. Change Controller . . . . . . . . . . . . . . . . . . 17 5.1.5. Change Controller . . . . . . . . . . . . . . . . . . 17
5.1.6. Version (of Registry Format) . . . . . . . . . . . . 17 5.1.6. Version (of Registry Format) . . . . . . . . . . . . 17
5.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 17 5.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 17
5.2.1. Reference Definition . . . . . . . . . . . . . . . . 17 5.2.1. Reference Definition . . . . . . . . . . . . . . . . 17
5.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 18 5.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 18
5.3. Method of Measurement . . . . . . . . . . . . . . . . . . 19 5.3. Method of Measurement . . . . . . . . . . . . . . . . . . 19
5.3.1. Reference Method . . . . . . . . . . . . . . . . . . 19 5.3.1. Reference Method . . . . . . . . . . . . . . . . . . 19
5.3.2. Packet Stream Generation . . . . . . . . . . . . . . 20 5.3.2. Packet Stream Generation . . . . . . . . . . . . . . 20
5.3.3. Traffic Filtering (observation) Details . . . . . . . 5.3.3. Traffic Filtering (observation) Details . . . . . . . 21
5.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 5.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 21
5.3.5. Run-time Parameters and Data Format . . . . . . . . . 5.3.5. Run-time Parameters and Data Format . . . . . . . . . 21
5.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 21 5.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 21
5.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 22 5.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 22 5.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 22
5.4.2. Reference Definition . . . . . . . . . . . . . . . . 22 5.4.2. Reference Definition . . . . . . . . . . . . . . . . 22
5.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 23 5.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 23
5.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 23 5.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 23
5.5. Administrative items . . . . . . . . . . . . . . . . . . 24 5.5. Administrative items . . . . . . . . . . . . . . . . . . 24
5.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 24 5.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 24
5.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 24 5.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 24
5.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 24 5.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 24
skipping to change at page 3, line 47 skipping to change at page 3, line 47
6.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 24 6.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 24 6.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 24
6.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 25 6.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 25
6.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . . 25 6.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.1.4. Description . . . . . . . . . . . . . . . . . . . . . 25 6.1.4. Description . . . . . . . . . . . . . . . . . . . . . 25
6.1.5. Change Controller . . . . . . . . . . . . . . . . . . 25 6.1.5. Change Controller . . . . . . . . . . . . . . . . . . 25
6.1.6. Version (of Registry Format) . . . . . . . . . . . . 25 6.1.6. Version (of Registry Format) . . . . . . . . . . . . 25
6.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 25 6.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 25
6.2.1. Reference Definition . . . . . . . . . . . . . . . . 25 6.2.1. Reference Definition . . . . . . . . . . . . . . . . 25
6.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 26 6.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 26
6.3. Method of Measurement . . . . . . . . . . . . . . . . . . 6.3. Method of Measurement . . . . . . . . . . . . . . . . . . 28
6.3.1. Reference Method . . . . . . . . . . . . . . . . . . 6.3.1. Reference Method . . . . . . . . . . . . . . . . . . 28
6.3.2. Packet Stream . . . . . . . . . . . . . . 6.3.2. Packet Stream Generation . . . . . . . . . . . . . . 29
6.3.3. Traffic Filtering (observation) Details . . . . . . . 6.3.3. Traffic Filtering (observation) Details . . . . . . . 30
6.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 6.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 30
6.3.5. Run-time Parameters and Data Format . . . . . . . . . 6.3.5. Run-time Parameters and Data Format . . . . . . . . . 30
6.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 6.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 31
6.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 6.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.4.1. . . . . . . . . . . 6.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 31
6.4.2. Reference Definition . . . . . . . . . . . . . . . . 6.4.2. Reference Definition . . . . . . . . . . . . . . . . 32
6.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 6.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 32
6.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 32 6.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 32
6.5. Administrative items . . . . . . . . . . . . . . . . . . 6.5. Administrative items . . . . . . . . . . . . . . . . . . 33
6.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 6.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 33
6.5.2. Requestor . . . . . . . . . . . . . . . . . . 6.5.2. Requestor . . . . . . . . . . . . . . . . . . . . . . 33
6.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 6.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 33
6.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 6.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 33
6.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 6.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 33
7. UDP Poisson One-way Delay Registry Entries . . . . . . . . . 7. UDP Poisson One-way Delay Registry Entries . . . . . . . . . 33
7.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 7.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 34
7.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 7.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 34
7.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 7.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 34
7.1.3. URI and URL . . . . . . . . . . . . . . . . . . . . . 7.1.3. URI and URL . . . . . . . . . . . . . . . . . . . . . 34
7.1.4. Description . . . . . . . . . . . . . . . . . . . . . 7.1.4. Description . . . . . . . . . . . . . . . . . . . . . 34
7.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 7.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 35
7.2.1. Reference Definition . . . . . . . . . . . . . . . . 7.2.1. Reference Definition . . . . . . . . . . . . . . . . 35
7.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 7.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 35
7.3. Method of Measurement . . . . . . . . . . . . . . . . . . 7.3. Method of Measurement . . . . . . . . . . . . . . . . . . 36
7.3.1. Reference Method . . . . . . . . . . . . . . . . . . 7.3.1. Reference Method . . . . . . . . . . . . . . . . . . 36
7.3.2. Packet Stream . . . . . . . . . . . . . . 7.3.2. Packet Stream Generation . . . . . . . . . . . . . . 37
7.3.3. Traffic Filtering (observation) Details . . . . . . . 7.3.3. Traffic Filtering (observation) Details . . . . . . . 38
7.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 7.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 38
7.3.5. Run-time Parameters and Data Format . . . . . . . . . 7.3.5. Run-time Parameters and Data Format . . . . . . . . . 38
7.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 7.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 39
7.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 7.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 39
7.4.1. . . . . . . . . . . 7.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 39
7.4.2. Reference Definition . . . . . . . . . . . . . . . . 7.4.2. Reference Definition . . . . . . . . . . . . . . . . 39
7.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 7.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 42
7.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 7.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 42
7.5. Administrative items . . . . . . . . . . . . . . . . . . 7.5. Administrative items . . . . . . . . . . . . . . . . . . 43
7.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 7.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 43
7.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 7.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 43
7.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 7.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 43
7.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 7.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 43
7.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 7.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 43
8. UDP Periodic One-way Delay Registry Entries . . . . . . . . . 8. UDP Periodic One-way Delay Registry Entries . . . . . . . . . 43
8.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 8.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 44
8.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 8.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 44
8.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 8.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 44
8.1.3. . . . . . . . . . . . . . . . . . . . . . 8.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 44
8.1.4. Description . . . . . . . . . . . . . . . . . . . . . 8.1.4. Description . . . . . . . . . . . . . . . . . . . . . 45
8.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 8.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 45
8.2.1. Reference Definition . . . . . . . . . . . . . . . . 8.2.1. Reference Definition . . . . . . . . . . . . . . . . 45
8.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 8.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 46
8.3. Method of Measurement . . . . . . . . . . . . . . . . . . 8.3. Method of Measurement . . . . . . . . . . . . . . . . . . 47
8.3.1. Reference Method . . . . . . . . . . . . . . . . . . 8.3.1. Reference Method . . . . . . . . . . . . . . . . . . 47
8.3.2. Packet Stream . . . . . . . . . . . . . . 8.3.2. Packet Stream Generation . . . . . . . . . . . . . . 48
8.3.3. Traffic Filtering (observation) Details . . . . . . . 8.3.3. Traffic Filtering (observation) Details . . . . . . . 48
8.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 8.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 48
8.3.5. Run-time Parameters and Data Format . . . . . . . . . 8.3.5. Run-time Parameters and Data Format . . . . . . . . . 48
8.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 8.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 49
8.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 8.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 49
8.4.1. . . . . . . . . . . 8.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 49
. . . . . . . . . . . . . . . . . . . . . 8.4.2. Reference Definition . . . . . . . . . . . . . . . . 49
8.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 8.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 52
8.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 8.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 52
8.5. Administrative items . . . . . . . . . . . . . . . . . . 8.5. Administrative items . . . . . . . . . . . . . . . . . . 53
8.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 8.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 53
8.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 8.5.2. Requestor (keep?) . . . . . . . . . . . . . . . . . . 53
8.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 8.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 53
8.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 8.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 53
8.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 8.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 53
9. ver08 BLANK Registry Entry . . . . . . . . . . . . . . . . . 9. ver08 BLANK Registry Entry . . . . . . . . . . . . . . . . . 54
9.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 9.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . 54
9.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 9.1.1. ID (Identifier) . . . . . . . . . . . . . . . . . . . 54
9.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 9.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 54
9.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 9.1.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . 54
9.1.4. Description . . . . . . . . . . . . . . . . . . . . . 9.1.4. Description . . . . . . . . . . . . . . . . . . . . . 54
9.1.5. Reference . . . . . . . . . . . . . . . . . . . . . . 9.1.5. Reference . . . . . . . . . . . . . . . . . . . . . . 54
9.1.6. Change Controller . . . . . . . . . . . . . . . . . . 9.1.6. Change Controller . . . . . . . . . . . . . . . . . . 54
9.1.7. Version (of Registry Format) . . . . . . . . . . . . 9.1.7. Version (of Registry Format) . . . . . . . . . . . . 54
9.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 9.2. Metric Definition . . . . . . . . . . . . . . . . . . . . 54
9.2.1. Reference Definition . . . . . . . . . . . . . . . . 9.2.1. Reference Definition . . . . . . . . . . . . . . . . 55
9.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 9.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 55
9.3. Method of Measurement . . . . . . . . . . . . . . . . . . 9.3. Method of Measurement . . . . . . . . . . . . . . . . . . 55
9.3.1. Reference Method . . . . . . . . . . . . . . . . . . 9.3.1. Reference Method . . . . . . . . . . . . . . . . . . 55
9.3.2. Packet Stream Generation . . . . . . . . . . . . . . 9.3.2. Packet Stream Generation . . . . . . . . . . . . . . 55
9.3.3. Traffic Filtering (observation) Details . . . . . . . 9.3.3. Traffic Filtering (observation) Details . . . . . . . 55
9.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 9.3.4. Sampling Distribution . . . . . . . . . . . . . . . . 55
9.3.5. Run-time Parameters and Data Format . . . . . . . . . 9.3.5. Run-time Parameters and Data Format . . . . . . . . . 55
9.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 9.3.6. Roles . . . . . . . . . . . . . . . . . . . . . . . . 55
9.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 9.4. Output . . . . . . . . . . . . . . . . . . . . . . . . . 56
9.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 9.4.1. Type . . . . . . . . . . . . . . . . . . . . . . . . 56
9.4.2. Reference Definition . . . . . . . . . . . . . . . . 9.4.2. Reference Definition . . . . . . . . . . . . . . . . 56
9.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 9.4.3. Metric Units . . . . . . . . . . . . . . . . . . . . 56
9.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 9.4.4. Calibration . . . . . . . . . . . . . . . . . . . . . 56
9.5. Administrative items . . . . . . . . . . . . . . . . . . 9.5. Administrative items . . . . . . . . . . . . . . . . . . 56
9.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 9.5.1. Status . . . . . . . . . . . . . . . . . . . . . . . 56
9.5.2. Requestor . . . . . . . . . . . . . . . . . . . . . . 9.5.2. Requestor . . . . . . . . . . . . . . . . . . . . . . 56
9.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 9.5.3. Revision . . . . . . . . . . . . . . . . . . . . . . 56
9.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 9.5.4. Revision Date . . . . . . . . . . . . . . . . . . . . 56
9.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 9.6. Comments and Remarks . . . . . . . . . . . . . . . . . . 56
10. Example RTCP-XR Registry Entry . . . . . . . . . . . . . . . 10. Example RTCP-XR Registry Entry . . . . . . . . . . . . . . . 57
10.1. Registry Indexes . . . . . . . . . . . . . . . . . . . . 10.1. Registry Indexes . . . . . . . . . . . . . . . . . . . . 57
10.1.1. Identifier . . . . . . . . . . . . . . . . . . . . . 10.1.1. Identifier . . . . . . . . . . . . . . . . . . . . . 57
10.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 10.1.2. Name . . . . . . . . . . . . . . . . . . . . . . . . 57
10.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . 10.1.3. URI . . . . . . . . . . . . . . . . . . . . . . . . 57
10.1.4. Status . . . . . . . . . . . . . . . . . . . . . . . 10.1.4. Status . . . . . . . . . . . . . . . . . . . . . . . 57
10.1.5. Requestor . . . . . . . . . . . . . . . . . . . . . 10.1.5. Requestor . . . . . . . . . . . . . . . . . . . . . 57
10.1.6. Revision . . . . . . . . . . . . . . . . . . . . . . 10.1.6. Revision . . . . . . . . . . . . . . . . . . . . . . 57
10.1.7. Revision Date . . . . . . . . . . . . . . . . . . . 10.1.7. Revision Date . . . . . . . . . . . . . . . . . . . 57
10.1.8. Description . . . . . . . . . . . . . . . . . . . . 10.1.8. Description . . . . . . . . . . . . . . . . . . . . 57
10.1.9. Reference Specification(s) . . . . . . . . . . . . . 10.1.9. Reference Specification(s) . . . . . . . . . . . . . 58
10.2. Metric Definition . . . . . . . . . . . . . . . . . . . 10.2. Metric Definition . . . . . . . . . . . . . . . . . . . 58
10.2.1. Reference Definition . . . . . . . . . . . . . . . . 10.2.1. Reference Definition . . . . . . . . . . . . . . . . 58
10.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 10.2.2. Fixed Parameters . . . . . . . . . . . . . . . . . . 58
10.3. Method of Measurement . . . . . . . . . . . . . . . . . 10.3. Method of Measurement . . . . . . . . . . . . . . . . . 59
10.3.1. Reference Method . . . . . . . . . . . . . . . . . . 10.3.1. Reference Method . . . . . . . . . . . . . . . . . . 59
10.3.2. Stream Type and Stream Parameters . . . . . . . . . 10.3.2. Stream Type and Stream Parameters . . . . . . . . . 59
10.3.3. Output Type and Data Format . . . . . . . . . . . . 10.3.3. Output Type and Data Format . . . . . . . . . . . . 59
10.3.4. Metric Units . . . . . . . . . . . . . . . . . . . . 10.3.4. Metric Units . . . . . . . . . . . . . . . . . . . . 59
10.3.5. Run-time Parameters and Data Format . . . . . . . . 10.3.5. Run-time Parameters and Data Format . . . . . . . . 60
10.4. Comments and Remarks . . . . . . . . . . . . . . . . . . 10.4. Comments and Remarks . . . . . . . . . . . . . . . . . . 61
11. Revision History . . . . . . . . . . . . . . . . . . . . . . 11. Revision History . . . . . . . . . . . . . . . . . . . . . . 61
12. Security Considerations . . . . . . . . . . . . . . . . . . . 12. Security Considerations . . . . . . . . . . . . . . . . . . . 62
13. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 13. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 62
14. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 14. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 62
15. References . . . . . . . . . . . . . . . . . . . . . . . . . 15. References . . . . . . . . . . . . . . . . . . . . . . . . . 62
15.1. Normative References . . . . . . . . . . . . . . . . . . 15.1. Normative References . . . . . . . . . . . . . . . . . . 63
15.2. Informative References . . . . . . . . . . . . . . . . . 15.2. Informative References . . . . . . . . . . . . . . . . . 64
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 66
1. Introduction 1. Introduction
Note: Efforts to synchronize structure and terminology with Note: Efforts to synchronize structure and terminology with
[I-D.ietf-ippm-metric-registry] will likely be incomplete until both [I-D.ietf-ippm-metric-registry] will likely be incomplete until both
drafts are stable. drafts are stable.
This memo proposes an initial set of entries for the Performance This memo proposes an initial set of entries for the Performance
Metric Registry. It uses terms and definitions from the IPPM Metric Registry. It uses terms and definitions from the IPPM
literature, primarily [RFC2330]. Proponents of Passive Performance literature, primarily [RFC2330]. Proponents of Passive Performance
skipping to change at page 8, line 43 skipping to change at page 8, line 43
-------------------- --------------------
4. UDP Round-trip Latency Registry Entry 4. UDP Round-trip Latency Registry Entry
This section gives an initial registry entry for the UDP Round-trip This section gives an initial registry entry for the UDP Round-trip
Latency. Latency.
Note: Each Registry entry only produces a "raw" output or a Note: Each Registry entry only produces a "raw" output or a
statistical summary. To describe both "raw" and one or more statistical summary. To describe both "raw" and one or more
statistics efficiently, the Identifier, Name, and Output Categories statistics efficiently, the Identifier, Name, and Output Categories
can be split and section can two or more can be split and a single section can specify two or more closely-
metrics. See Section 7 for an example specifying multiple Registry related metrics. See Section 7 for an example specifying multiple
entries with many common columns. Registry entries with many common columns.
4.1. Summary 4.1. Summary
This category includes multiple indexes to the registry entry: the This category includes multiple indexes to the registry entry: the
element ID and metric name. element ID and metric name.
4.1.1. ID (Identifier) 4.1.1. ID (Identifier)
<insert a numeric identifier, an integer, TBD> <insert a numeric identifier, an integer, TBD>
4.1.2. Name 4.1.2. Name
<insert name according to metric naming convention> <insert name according to metric naming convention>
RTDelay_Active_IP-UDP-Poisson_RFCXXXXsecY_Seconds_95Percentile RTDelay_Active_IP-UDP-Poisson_RFCXXXXsecY_Seconds_95Percentile
4.1.3. URIs 4.1.3. URIs
URN: Prefix urn:ietf::<name> URN: Prefix urn:ietf:metrics:perf:<name>
URL: http://<TBD by IANA>/<name> URL: http://<TBD by IANA>/<name>
4.1.4. Description 4.1.4. Description
This metric assesses the delay of a stream of packets exchanged This metric assesses the delay of a stream of packets exchanged
between two hosts (which are the two measurement points), and the between two hosts (which are the two measurement points), and the
Output is the Round-trip delay for all successfully exchanged packets Output is the Round-trip delay for all successfully exchanged packets
expressed as the 95th percentile of their conditional delay expressed as the 95th percentile of their conditional delay
distribution. distribution.
skipping to change at page 10, line 10 skipping to change at page 10, line 10
[RFC2681] [RFC2681]
<specific section reference and additional clarifications, if needed> <specific section reference and additional clarifications, if needed>
Section 2.4 of [RFC2681] provides the reference definition of the Section 2.4 of [RFC2681] provides the reference definition of the
singleton (single value) Round-trip delay metric. Section 3.4 of singleton (single value) Round-trip delay metric. Section 3.4 of
[RFC2681] provides the reference definition expanded to cover a [RFC2681] provides the reference definition expanded to cover a
multi-singleton sample. Note that terms such as singleton and sample multi-singleton sample. Note that terms such as singleton and sample
are defined in Section 11 of [RFC2330]. are defined in Section 11 of [RFC2330].
Note that although the definition of "Round-trip-Delay between Src Note that although the [RFC2681] definition of "Round-trip-Delay
and Dst" is directionally ambiguous in the text, this metric tightens between Src and Dst" is directionally ambiguous in the text, this
the definition further to recognize that the host in the "Src" role metric tightens the definition further to recognize that the host in
will send the first packet to "Dst", and ultimately receive the the "Src" role will send the first packet to "Dst", and ultimately
corresponding return packet from "Dst" (when neither are lost). receive the corresponding return packet from "Dst" (when neither are
lost).
Finally, note that the variable "dT" is used in [RFC2681] to refer to 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 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 variable "dT" has been re-used in other IPPM literature to refer to
different quantities, and cannot be used as a global variable name. different quantities, and cannot be used as a global variable name.
4.2.2. Fixed Parameters 4.2.2. Fixed Parameters
<list and specify Fixed Parameters, input factors that must be <list and specify Fixed Parameters, input factors that must be
determined and embedded in the measurement system for use when determined and embedded in the measurement system for use when
skipping to change at page 10, line 47 skipping to change at page 10, line 48
* DSCP: set to 0 * DSCP: set to 0
* Hop Count: set to 255 * Hop Count: set to 255
* Protocol: Set to 17 (UDP) * Protocol: Set to 17 (UDP)
* Checksum: the checksum MUST be calculated * Checksum: the checksum MUST be calculated and included in the
* total of 9 bytes * total of 9 bytes
Other measurement parameters: Other measurement parameters:
o Tmax: a loss threshold waiting time o Tmax: a loss threshold waiting time
* 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 = 5 (see section 9.3 of decimal64 with fraction digits = 5 (see section 9.3 of
[RFC6020]) and with resolution of 0.0001 seconds (0.1 ms), with [RFC6020]) and with resolution of 0.0001 seconds (0.1 ms), with
lossless conversion to/from the 32-bit NTP timestamp as per lossless conversion to/from the 32-bit NTP timestamp as per
skipping to change at page 15, line 35 skipping to change at page 15, line 42
<insert units for the measured results, and the reference <insert units for the measured results, and the reference
specification>. specification>.
The 95th Percentile of Round-trip Delay is expressed in seconds. The 95th Percentile of Round-trip Delay is expressed in seconds.
4.4.4. Calibration 4.4.4. Calibration
Section 3.7.3 of [RFC7679] provides a means to quantify the Section 3.7.3 of [RFC7679] provides a means to quantify the
systematic and random errors of a time measurement. In-situ systematic and random errors of a time measurement. In-situ
calibration could be enabled with an internal loopback that includes calibration could be enabled with an internal loopback at the Source
as much of the measurement system as possible, performs address host that includes as much of the measurement system as possible,
manipulation as needed, and provides some form of isolation (e.g., performs address manipulation as needed, and provides some form of
deterministic delay) to avoid send-receive interface contention. isolation (e.g., deterministic delay) to avoid send-receive interface
Some portion of the random and systematic error can be characterized contention. Some portion of the random and systematic error can be
this way. characterized this way.
When a measurement controller requests a calibration measurement, the When a measurement controller requests a calibration measurement, the
loopback is applied and the result is output in the same format as a loopback is applied and the result is output in the same format as a
normal measurement with additional indication that it is a normal measurement with additional indication that it is a
calibration result. calibration result.
Both internal loopback calibration and clock synchronization can be Both internal loopback calibration and clock synchronization can be
used to estimate the *available accuracy* of the Output Metric Units. used to estimate the *available accuracy* of the Output Metric Units.
For example, repeated loopback delay measurements will reveal the For example, repeated loopback delay measurements will reveal the
portion of the Output result resolution which is the result of system portion of the Output result resolution which is the result of system
skipping to change at page 17, line 7 skipping to change at page 17, line 17
<insert numeric identifier, an integer> <insert numeric identifier, an integer>
5.1.2. Name 5.1.2. Name
<insert name according to metric naming convention> <insert name according to metric naming convention>
OWPDV_Active_IP-UDP-Poisson_RFCXXXXsecY_Seconds_95Percentile OWPDV_Active_IP-UDP-Poisson_RFCXXXXsecY_Seconds_95Percentile
5.1.3. URIs 5.1.3. URIs
URI: Prefix urn:ietf:metric:<name> URI: Prefix urn:ietf:metrics:perf:<name>
URL: http://<TBD by IANA>/<name> URL: http://<TBD by IANA>/<name>
5.1.4. Description 5.1.4. Description
An assessment of packet delay variation with respect to the minimum An assessment of packet delay variation with respect to the minimum
delay observed on the stream, and the Output is expressed as the 95th delay observed on the stream, and the Output is expressed as the 95th
percentile of the packet delay variation distribution. percentile of the packet delay variation distribution.
5.1.5. Change Controller 5.1.5. Change Controller
<org or person > <org or person >
IETF
5.1.6. Version (of Registry Format) 5.1.6. Version (of Registry Format)
1.0 1.0
5.2. Metric Definition 5.2. Metric Definition
This category includes columns to prompt the entry of all necessary 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. and values of input factors, called fixed parameters.
skipping to change at page 18, line 32 skipping to change at page 18, line 43
* DSCP: set to 0 * DSCP: set to 0
* Hop Count: set to 255 * Hop Count: set to 255
* Protocol: Set to 17 (UDP) * Protocol: Set to 17 (UDP)
* Checksum: the checksum MUST be calculated * Checksum: the checksum MUST be calculated and included in the
* total of 200 bytes * total of 200 bytes
Other measurement parameters: Other measurement parameters:
Tmax: a loss threshold waiting time with value 3.0, expressed in Tmax: a loss threshold waiting time with value 3.0, 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 = 5 (see section 9.3 of [RFC6020]) and with fraction digits = 5 (see section 9.3 of [RFC6020]) and with
resolution of 0.0001 seconds (0.1 ms), with lossless conversion resolution of 0.0001 seconds (0.1 ms), with lossless conversion
to/from the 32-bit NTP timestamp as per section 6 of [RFC5905]. to/from the 32-bit NTP timestamp as per section 6 of [RFC5905].
F a selection function unambiguously defining the packets from the F a selection function unambiguously defining the packets from the
stream selected for the metric. See section 4.2 of [RFC5481] for stream selected for the metric. See section 4.2 of [RFC5481] for
the PDV form. the PDV form.
See the Packet Stream generation category for two additional Fixed
Parameters.
5.3. Method of Measurement 5.3. Method of Measurement
This category includes columns for references to relevant sections of This category includes columns for references to relevant sections of
the RFC(s) and any supplemental information needed to ensure an the RFC(s) and any supplemental information needed to ensure an
unambiguous methods for implementations. unambiguous methods for implementations.
5.3.1. Reference Method 5.3.1. Reference Method
<for metric, insert relevant section references and supplemental <for metric, insert relevant section references and supplemental
info> info>
skipping to change at page 20, line 20 skipping to change at page 20, line 29
Poisson sampling intervals. the reciprocal of lambda is the average Poisson sampling intervals. the reciprocal of lambda is the average
packet spacing, thus the Run-time Parameter is Reciprocal_lambda = 1/ packet spacing, thus the Run-time Parameter is Reciprocal_lambda = 1/
lambda, in seconds. lambda, in seconds.
>>> Check with Sam, most likely it is this... >>> Check with Sam, most likely it is this...
Method 3 SHALL be used, where given a start time (Run-time Method 3 SHALL be used, where given a start time (Run-time
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 inter- measurement by computing the pseudo-random distribution of inter-
packet send times, (truncating the distribution as specified in the packet send times, (truncating the distribution as specified in the
Trunc), and the Src sends each packet at the Parameter Trunc), and the Src sends each packet at the computed
computed times. times.
Note that Trunc is the upper limit on inter-packet times in the 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
in seconds Reciprocal_lambda average packet interval for Poisson Streams
= 1 packet per expressed in units of seconds, as a positive value of type
decimal64 with fraction digits = 5 (see section 9.3 of [RFC6020])
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]. Reciprocal_lambda = 1 packet per second.
Upper limit on Poisson distribution (values above this limit will Trunc Upper limit on Poisson distribution expressed in units of
be clipped and set to the limit value). = seconds. seconds, as a positive value of type decimal64 with fraction
digits = 5 (see section 9.3 of [RFC6020]) 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). Trunc =
30.0000 seconds.
5.3.3. Traffic Filtering (observation) Details 5.3.3. Traffic Filtering (observation) Details
<insert the measured results based on a filtered version of the <insert the measured results based on a filtered version of the
packets observed, and this section provides the filter details (when packets observed, and this section provides the filter details (when
present), and section reference>. present), and section reference>.
NA NA
5.3.4. Sampling Distribution 5.3.4. Sampling Distribution
skipping to change at page 21, line 25 skipping to change at page 21, line 45
[RFC2330]. When T0 is "all-zeros", a start time is unspecified [RFC2330]. When T0 is "all-zeros", a start time is unspecified
and Tf is to be interpreted as the Duration of the measurement and Tf is to be interpreted as the Duration of the measurement
interval. The start time is controlled through other means. interval. The start time is controlled through other means.
Tf a time, the end of a measurement interval, (format "date-and-time" 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 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 [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 [RFC2330]. When T0 is "all-zeros", a end time date is ignored and
Tf is interpreted as the Duration of the measurement interval. Tf is interpreted as the Duration of the measurement interval.
5.3.6. Roles 5.3.6. Roles
<lists the names of the different roles from the measurement method> <lists the names of the different roles from the measurement method>
Src launches each packet to Dst. Src launches each packet to Dst.
Dst waits for each packet from Src. Dst waits for each packet from Src.
5.4. Output 5.4. Output
skipping to change at page 25, line 9 skipping to change at page 25, line 9
<skipping some admin columns for now> <skipping some admin columns for now>
6.1.1. ID (Identifier) 6.1.1. ID (Identifier)
<insert numeric identifier, an integer> <insert numeric identifier, an integer>
6.1.2. Name 6.1.2. Name
<insert name according to metric naming convention> <insert name according to metric naming convention>
RTDNS_Active_IP-UDP-Poisson_RFCXXXXsecY_Seconds_ RTDNS_Active_IP-UDP-Poisson_RFCXXXXsecY_Seconds_Raw
6.1.3. URI 6.1.3. URI
URI: Prefix urn:ietf:metric:<name> URI: Prefix urn:ietf:metrics:perf:<name>
URL: http://<TBD by IANA>/<name> URL: http://<TBD by IANA>/<name>
6.1.4. Description 6.1.4. Description
This metric assesses the response time, the interval from the query This metric assesses the response time, the interval from the query
transmission to the response. transmission to the response.
6.1.5. Change Controller 6.1.5. Change Controller
skipping to change at page 26, line 7 skipping to change at page 26, line 7
Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip Delay
Metric for IPPM", RFC 2681, September 1999. Metric for IPPM", RFC 2681, September 1999.
[RFC2681] [RFC2681]
<specific section reference and additional clarifications, if needed> <specific section reference and additional clarifications, if needed>
Section 2.4 of [RFC2681] provides the reference definition of the Section 2.4 of [RFC2681] provides the reference definition of the
singleton (single value) Round-trip delay metric. Section 3.4 of singleton (single value) Round-trip delay metric. Section 3.4 of
[RFC2681] provides the reference definition expanded to cover a [RFC2681] provides the reference definition expanded to cover a
sample. Note that terms such as singleton and sample are multi-singleton sample. Note that terms such as singleton and sample
defined in Section 11 of [RFC2330]. are defined in Section 11 of [RFC2330].
For DNS Response Latency, the entities in [RFC1035] must be mapped to For DNS Response Latency, the entities in [RFC1035] must be mapped to
[RFC2681]. The Local Host with its User Program and Resolver take [RFC2681]. The Local Host with its User Program and Resolver take
the role of "Src", and the Foreign Name Server takes the role of the role of "Src", and the Foreign Name Server takes the role of
"Dst". "Dst".
Note that although the definition of "Round-trip-Delay between Src Note that although the [RFC2681] definition of "Round-trip-Delay
and Dst at T" is directionally ambiguous in the text, this metric between Src and Dst at T" is directionally ambiguous in the text,
tightens the definition further to recognize that the host in the this metric tightens the definition further to recognize that the
"Src" role will send the first packet to "Dst", and ultimately host in the "Src" role will send the first packet to "Dst", and
receive the corresponding return packet from "Dst" (when neither are ultimately receive the corresponding return packet from "Dst" (when
lost). neither are lost).
6.2.2. Fixed Parameters 6.2.2. Fixed Parameters
<list and specify Fixed Parameters, input factors that must be <list and specify Fixed Parameters, input factors that must be
determined and embedded in the measurement system for use when determined and embedded in the measurement system for use when
needed> needed>
Type-P: Type-P as defined in Section 13 of [RFC2330]:
* DSCP: set to 0 * DSCP: set to 0
* TTL set to 255 * TTL set to 255
* Protocol: Set to 17 (UDP) * Protocol: Set to 17 (UDP)
* DSCP: set to 0
* Hop Count: set to 255
* Protocol: Set to 17 (UDP)
* Source port: 53 * Source port: 53
* Destination port: 53 * Destination port: 53
* Checksum: the checksum must be calculated and included in the
* Checksum: the checksum must be calculated header
o Payload: The payload contains a DNS message as defined in RFC 1035 o Payload: The payload contains a DNS message as defined in RFC 1035
[RFC1035] with the following values: [RFC1035] with the following values:
* The DNS header section contains: * The DNS header section contains:
+ Identification (see the Run-time column)
+ QR: set to 0 (Query) + QR: set to 0 (Query)
+ OPCODE: set to 0 (standard query) + OPCODE: set to 0 (standard query)
+ AA: not set + AA: not set
+ TC: not set + TC: not set
+ RD: set to one (recursion desired) + RD: set to one (recursion desired)
+ RA: not set + RA: not set
skipping to change at page 27, line 26 skipping to change at page 27, line 38
+ QDCOUNT: set to one (only one entry) + QDCOUNT: set to one (only one entry)
+ ANCOUNT: not set + ANCOUNT: not set
+ NSCOUNT: not set + NSCOUNT: not set
+ ARCOUNT: not set + ARCOUNT: not set
* The Question section contains: * The Question section contains:
+ QNAME: the provided as input for the + QNAME: the Fully Qualified Domain Name (FQDN) provided as
input for the test, see the Run-time column
+ QTYPE: the query type provided as input for the + QTYPE: the query type provided as input for the test, see
the Run-time column
+ QCLASS: set to IN + QCLASS: set to 1 for IN
* The other sections do not contain any Resource Records. * The other sections do not contain any Resource Records.
Other measurement parameters:
o Tmax: a loss threshold waiting time (and to help disambiguate
queries)
* 5.0, expressed in units of seconds, as a positive value of type
decimal64 with fraction digits = 5 (see section 9.3 of
[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 [RFC5905].
Observation: reply packets will contain a DNS response and may Observation: reply packets will contain a DNS response and may
contain RRs. contain RRs.
6.3. Method of Measurement 6.3. Method of Measurement
This category includes columns for references to relevant sections of This category includes columns for references to relevant sections of
the RFC(s) and any supplemental information needed to ensure an the RFC(s) and any supplemental information needed to ensure an
unambiguous methods for implementations. unambiguous methods for implementations.
6.3.1. Reference Method 6.3.1. Reference Method
<for metric, insert relevant section references and supplemental <for metric, insert relevant section references and supplemental
info> info>
The methodology for this metric is defined as Type-P-Round-trip- 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 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 3.6 of RFC 2681 [RFC2681] using the Type-P and Timeout defined under
Fixed Parameters. Fixed Parameters.
The method The reference method distinguishes between long-delayed packets and
lost packets by implementing a maximum waiting time for packet
packet is arrival. Tmax is the waiting time used as the threshold to declare a
the packet lost. Lost packets SHALL be designated as having undefined
delay.
DNS Messages bearing Queries provide for random ID so more The calculations on the delay (RTT) SHALL be performed on the
than one query may be launched while a previous request is conditional distribution, conditioned on successful packet arrival
outstanding when the ID Number is used. 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 to establish correspondence between
sending times and receiving times for each successfully-arriving
reply. Therefore, sequence numbers or other send-order
identification MUST be retained at the Src or included with each
packet to dis-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 in the
Identification header field, 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 IF a DNS response does not arrive within Tmax, the result is
undefined. The Message ID SHALL be used to disambiguate the undefined. The Message ID SHALL be used to disambiguate the
successive queries. successive queries.
>>> This would require support of ID generation and population in the >>> This would require support of ID generation and population in the
Message. An alternative would be to use a random Source port on the Message. An alternative would be to use a random Source port on the
Query Message, but we would choose ONE before proceding. Query Message, but we would choose ONE before proceding.
Refer to Section 4.4 of [RFC6673] for expanded discussion of the 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 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 possible" in Section 2.6 of RFC 2681 [RFC2681]. Section 8 of
[RFC6673] presents additional requirements which shall be included in [RFC6673] presents additional requirements which shall be included in
the method of measurement for this metric. the method of measurement for this metric.
6.3.2. Packet Stream In addition to operations described in [RFC2681], the Src MUST parse
subsequent reporting as a measured result, along with the Round-Trip
Delay.
6.3.2. Packet Stream Generation
This section gives the details of the packet traffic which is the This section gives the details of the packet traffic which is the
basis for measurement. In IPPM metrics, this is called the Stream, basis for measurement. In IPPM metrics, this is called the Stream,
and can easily be dscribed by providing the list of stream and can easily be dscribed by providing the list of stream
parameters. parameters.
<list of generation parameters and section/spec references if needed> <list of generation parameters and section/spec references if needed>
Section 11.1.3 of RFC 2681 [RFC2330] provides three methods to Section 11.1.3 of RFC 2681 [RFC2330] provides three methods to
generate Poisson sampling intervals. reciprocal of lambda is the generate Poisson sampling intervals. The reciprocal of lambda is the
average packet rate, thus the Run-time Parameter is average packet rate, thus the Run-time Parameter is Reciprocal_lambda
= 1/lambda, in seconds.
Method 3 is used, where given a start time (Run-time Parameter), the Method 3 is used, where given a start time (Run-time Parameter), the
subsequent send times are all computed prior to measurement by subsequent send times are all computed prior to measurement by
computing the pseudo-random distribution of inter-packet send times, computing the pseudo-random distribution of inter-packet send times,
(truncating the distribution as specified in the Run-time (truncating the distribution as specified in the Run-time
Parameters), and the Src sends each packet at the computed times. Parameters), 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
6.3.3. Traffic Filtering (observation) Details 6.3.3. Traffic Filtering (observation) Details
The measured results based on a filtered version of the packets The measured results based on a filtered version of the packets
observed, and this section provides the filter details (when observed, and this section provides the filter details (when
present). present).
<section reference>. <section reference>.
NA NA
skipping to change at page 29, line 30 skipping to change at page 30, line 30
NA NA
6.3.5. Run-time Parameters and Data Format 6.3.5. Run-time Parameters and Data Format
Run-time Parameters are input factors that must be determined, Run-time Parameters are input factors that must be determined,
configured into the measurement system, and reported with the results configured into the measurement system, and reported with the results
for the context to be complete. for the context to be complete.
<list of run-time parameters, and their data formats> <list of run-time parameters, and their data formats>
the IP address of host value for IPv4, Src the IP address of the host in the Src Role (format ipv4-address-
value for no-zone value for IPv4, or ipv6-address-no-zone value for IPv6,
see Section 4 of [RFC6991])
the IP address of host value for IPv4, Dst the IP address of the host in the Dst Role (format ipv4-address-
value for no-zone value for IPv4, or ipv6-address-no-zone value for IPv6,
see section 4 of [RFC6991])
a of measurement interval, T0 a time, the start of a measurement interval, (format "date-and-
see of When T0 is "all-zeros", a time" as specified in Section 5.6 of [RFC3339], see also Section 3
start time is unspecified and Tf is to be interpreted as the of [RFC6991]). The UTC Time Zone is required by Section 6.1 of
Duration of the measurement interval. [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.
a of measurement interval, Tf a time, the end of a measurement interval, (format "date-and-time"
see of interpreted as the Duration of the as specified in Section 5.6 of [RFC3339], see also Section 3 of
measurement interval. [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.
average packet Poisson = Reciprocal_lambda average packet interval for Poisson Streams
per expressed in units of seconds, as a positive value of type
decimal64 with fraction digits = 5 (see section 9.3 of [RFC6020])
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].
Upper limit on Poisson distribution (values above this limit will Trunc Upper limit on Poisson distribution expressed in units of
be clipped and set to the limit value). (if fixed, = seconds, as a positive value of type decimal64 with fraction
seconds.) digits = 5 (see section 9.3 of [RFC6020]) 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.)
16-bit identifier assigned by the program that generates ID The 16-bit identifier assigned by the program that generates the
the query, and which must vary in successive queries, see query, and which must vary in successive queries, see
Section 4.1.1 of [RFC1035]. This identifier is copied into the Section 4.1.1 of [RFC1035]. This identifier is copied into the
corresponding reply and can be used by the requester to match-up corresponding reply and can be used by the requester (Src) to
replies to outstanding queries. match-up replies to outstanding queries.
The of the QNAME The domain name of the Query, formatted as specified in
as section 4 of [RFC6991].
of
QTYPE The Query Type, which will correspond to the IP address family
a of of the query (decimal 1 for IPv4 or 28 for IPv6, formatted as a
uint16, as per section 9.2 of [RFC6020].
6.3.6. Roles 6.3.6. Roles
<lists the names of the different roles from the measurement method> <lists the names of the different roles from the measurement method>
Src launches each packet and waits for return transmissions from Src launches each packet and waits for return transmissions from
Dst. Dst.
Dst waits for each packet from Src and sends a return packet to Dst waits for each packet from Src and sends a return packet to Src.
Src.
6.4. Output 6.4. Output
This category specifies all details of the Output of measurements This category specifies all details of the Output of measurements
using the metric. using the metric.
6.4.1. Type 6.4.1. Type
<insert name of the output type, raw or a selected summary statistic> <insert name of the output type, raw or a selected summary statistic>
Raw -- for each DNS Query packet sent, sets of values as defined in
the next column, including the status of the response, only assigning
delay values to successful query-response pairs.
Raw -- for each packet sent, of
the status of the response, only assigning values to
successful query-response pairs.
6.4.2. Reference Definition 6.4.2. Reference Definition
<describe the data format for each type of result> <describe the data format for each type of result>
For all outputs:
all
the T the time the DNS Query was sent during the 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].
The = dT 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 section 9.3 of
[RFC6020]) with resolution of 0.000000001 seconds (1.0 ns), and
with lossless conversion to/from the 64-bit NTP timestamp as per
section 6 of RFC [RFC5905]. This value is undefined when the
response packet is not received at Src within waiting time Tmxax
seconds.
Rcode The value of the Rcode field in the DNS response header,
of expressed as a uint64 as specified in section 9.2 of [RFC6020].
the the of Non-zero values convey errors in the response, and such replies
the must be analyzed separately from successful requests.
6.4.3. Metric Units 6.4.3. Metric Units
<insert units for the measured results, and the reference <insert units for the measured results, and the reference
specification>. specification>.
Round-trip Delay, dT, is expressed in seconds. Round-trip Delay, dT, is expressed in seconds.
6.4.4. Calibration 6.4.4. Calibration
to Section 3.7.3 of [RFC7679] provides a means to quantify the
systematic and random errors of a time measurement. In-situ
calibration could be enabled with an internal loopback at the Source
host that includes as much of the measurement system as possible,
some form of isolation (e.g., deterministic delay) to avoid send-
receive interface contention. Some portion of the random and
systematic error can be characterized this way.
When a measurement controller requests a calibration measurement, the
loopback is applied and the result is output in the same format as a
normal measurement with additional indication that it is a
calibration result.
Both internal loopback calibration and clock synchronization can be
used to estimate the *available accuracy* of the Output Metric Units.
For example, repeated loopback delay measurements will reveal the
portion of the Output result resolution which is the result of system
noise, and thus inaccurate.
6.5.1. Status 6.5.1. Status
<current or depricated> <current or depricated>
6.5.2. Requestor 6.5.2. Requestor
name or RFC, etc. name or RFC, etc.
6.5.3. Revision 6.5.3. Revision
1.0 1.0
6.5.4. Revision Date 6.5.4. Revision Date
YYYY-MM-DD YYYY-MM-DD
Additional (Informational) details for this entry Additional (Informational) details for this entry
7. UDP Poisson One-way Delay Registry Entries 7. UDP Poisson One-way Delay Registry Entries
This section initial registry for the UDP Poisson This section specifies five initial registry entries for the UDP
Delay. Poisson One-way Delay.
Note: Each Registry "Name" below specifies a single registry entry, Note: Each Registry "Name" below specifies a single registry entry,
whose output format varies according to of the name that whose output format varies according to the <statistic> element of
specifies one form of statistical summary. the name that specifies one form of statistical summary.
IANA is asked to assign a different numeric identifiers to each IANA is asked to assign a different numeric identifiers to each of
All column entries beside the and Output categories are the the five Metrics. All column entries beside the ID, Name,
same, thus this section proposes five closely-related registry Description, and Output Reference Method categories are the same,
entries. As a result, IANA is also asked to assign corresponding thus this section proposes five closely-related registry entries. As
and a result, IANA is also asked to assign corresponding URNs and URLs to
each Named Metric.
7.1. Summary 7.1. Summary
This category includes multiple indexes to the registry entries, the This category includes multiple indexes to the registry entries, the
element ID and metric name. element ID and metric name.
7.1.1. ID (Identifier) 7.1.1. ID (Identifier)
<insert numeric identifier, an integer, one corresponding to each <insert numeric identifier, an integer, one corresponding to each
name below> name below>
7.1.2. Name 7.1.2. Name
<insert name according to metric naming convention> <insert name according to metric naming convention>
OWDelay_Active_IP-UDP-Poisson- OWDelay_Active_IP-UDP-Poisson-
where <statistic> is one of:
o 95Percentile
n o Mean
o Min
o Max
o StdDev
7.1.3. URI and URL 7.1.3. URI and URL
URI: Prefix urn:ietf:<name> URI: Prefix urn:ietf:metrics:perf:<name>
URL: http:\\www.iana.org\ ... <name> URL: http:\\www.iana.org\ ... <name>
7.1.4. Description 7.1.4. Description
This metric assesses the delay of a stream of packets exchanged This metric assesses the delay of a stream of packets exchanged
between two hosts (or measurement points), and reports the between two hosts (or measurement points), and reports the
<statistic> One-way delay for all successfully exchanged packets <statistic> One-way delay for all successfully exchanged packets
based on their conditional delay distribution. based on their conditional delay distribution.
where <statistic> is one of:
o 95Percentile
o Mean
o Min
o Max
o StdDev
7.2. Metric Definition 7.2. Metric Definition
This category includes columns to prompt the entry of all necessary 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. and values of input factors, called fixed parameters.
7.2.1. Reference Definition 7.2.1. Reference Definition
<Full bibliographic reference to an immutable doc.> <Full bibliographic reference to an immutable doc.>
Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, Ed., "A One- Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, Ed., "A One-
Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC
7679, DOI 10.17487/RFC7679, January 2016, <http://www.rfc- 7679, DOI 10.17487/RFC7679, January 2016, <http://www.rfc-
editor.org/info/rfc7679>. editor.org/info/rfc7679>.
[RFC679] [RFC7679]
Morton, A., and Stephan, E., "Spatial Composition of Metrics", RFC Morton, A., and Stephan, E., "Spatial Composition of Metrics", RFC
6049, January 2011. 6049, January 2011.
[RFC6049] [RFC6049]
<specific section reference and additional clarifications, if needed> <specific section reference and additional clarifications, if needed>
Section 3.4 of [RFC679] provides the reference definition of the Section 3.4 of [RFC7679] provides the reference definition of the
singleton (single value) One-way delay metric. Section 4.4 of singleton (single value) One-way delay metric. Section 4.4 of
[RFC679] provides the reference definition expanded to cover a [RFC7679] provides the reference definition expanded to cover a
multi-value sample. Note that terms such as singleton and sample are multi-value sample. Note that terms such as singleton and sample are
defined in Section 11 of [RFC2330]. defined in Section 11 of [RFC2330].
Only successful packet transfers with finite delay are included in Only successful packet transfers with finite delay are included in
the sample, as prescribed in section 4.1.2 of [RFC6049]. the sample, as prescribed in section 4.1.2 of [RFC6049].
7.2.2. Fixed Parameters 7.2.2. Fixed Parameters
<list and specify Fixed Parameters, input factors that must be <list and specify Fixed Parameters, input factors that must be
determined and embedded in the measurement system for use when determined and embedded in the measurement system for use when
needed> needed>
Type-P: Type-P:
* DSCP: set to 0 * DSCP: set to 0
* set to 255 * TTL: set to 255
* Protocol: Set to 17 (UDP)
* DSCP: set to 0
* Hop Count: set to 255
* Protocol: Set to 17 (UDP) * Protocol: Set to 17 (UDP)
* Checksum: the checksum be calculated * Checksum: the checksum MUST be calculated and included in the
o UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of [RFC5357] o UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of [RFC5357]
* Security features in use influence the number of Padding * Security features in use influence the number of Padding
octets. octets.
* 250 octets total, including the TWAMP format * 250 octets total, including the TWAMP format
Tmax: seconds Other measurement parameters:
Tmax: a loss threshold waiting time with value 3.0, expressed in
units of seconds, as a positive value of type decimal64 with
fraction digits = 5 (see section 9.3 of [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 [RFC5905].
See the Packet Stream generation category for two additional Fixed
Parameters.
7.3. Method of Measurement 7.3. Method of Measurement
This category includes columns for references to relevant sections of This category includes columns for references to relevant sections of
the RFC(s) and any supplemental information needed to ensure an the RFC(s) and any supplemental information needed to ensure an
unambiguous methods for implementations. unambiguous methods for implementations.
7.3.1. Reference Method 7.3.1. Reference Method
<for metric, insert relevant section references and supplemental <for metric, insert relevant section references and supplemental
skipping to change at page 35, line 19 skipping to change at page 37, line 4
7.3. Method of Measurement 7.3. Method of Measurement
This category includes columns for references to relevant sections of This category includes columns for references to relevant sections of
the RFC(s) and any supplemental information needed to ensure an the RFC(s) and any supplemental information needed to ensure an
unambiguous methods for implementations. unambiguous methods for implementations.
7.3.1. Reference Method 7.3.1. Reference Method
<for metric, insert relevant section references and supplemental <for metric, insert relevant section references and supplemental
info> info>
The methodology for this metric is defined as Type-P-One-way-Delay- The methodology for this metric is defined as Type-P-One-way-Delay-
Poisson-Stream in section 3.6 of and section 4.6 of Poisson-Stream in section 3.6 of [RFC7679] and section 4.6 of
using the Type-P and defined under Fixed [RFC7679] using the Type-P and Tmax defined under Fixed Parameters.
Parameters.
The method The reference method distinguishes between long-delayed packets and
lost packets by implementing a maximum waiting time for packet
packet is arrival. Tmax is the waiting time used as the threshold to declare a
the packet lost. Lost packets SHALL be designated as having undefined
delay.
7.3.2. Packet Stream The calculations on the one-way delay 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 one-way delay 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 to establish correspondence between
sending times and receiving times for each successfully-arriving
packet. Sequence numbers or other send-order identification MUST be
retained at the Src or included with each packet to dis-ambiguate
packet reordering if it occurs.
Since a standard measurement protocol is employed [RFC5357], then the
measurement process will determine the sequence numbers or timestamps
applied to test packets after the Fixed and Runtime parameters are
passed to that process. The measurement protocol dictates the format
of sequence numbers and time-stamps conveyed in the TWAMP-Test packet
7.3.2. Packet Stream Generation
This section gives the details of the packet traffic which is the This section gives the details of the packet traffic which is the
basis for measurement. In IPPM metrics, this is called the Stream, basis for measurement. In IPPM metrics, this is called the Stream,
and can easily be dscribed by providing the list of stream and can easily be dscribed by providing the list of stream
parameters. parameters.
<list of generation parameters and section/spec references if needed> <list of generation parameters and section/spec references if needed>
Section 11.1.3 of RFC 2681 [RFC2330] provides three methods to Section 11.1.3 of RFC 2681 [RFC2330] provides three methods to
generate Poisson sampling intervals. reciprocal of lambda is the generate Poisson sampling intervals. the reciprocal of lambda is the
average packet thus the Run-time Parameter is average packet spacing, thus the Run-time Parameter is
Reciprocal_lambda = 1/lambda, in seconds.
Method 3 used, where given a start time (Run-time Method 3 SHALL be used, where given a start time (Run-time
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 inter- measurement by computing the pseudo-random distribution of inter-
packet send times, (truncating the distribution as specified in the packet send times, (truncating the distribution as specified in the
), and the Src sends each packet at the computed Parameter Trunc), and the Src sends each packet at the computed
times. 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
Reciprocal_lambda average packet interval for Poisson Streams
expressed in units of seconds, as a positive value of type
decimal64 with fraction digits = 5 (see section 9.3 of [RFC6020])
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]. Reciprocal_lambda = 1 packet per second.
Trunc Upper limit on Poisson distribution expressed in units of
seconds, as a positive value of type decimal64 with fraction
digits = 5 (see section 9.3 of [RFC6020]) 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). Trunc =
30.0000 seconds.
7.3.3. Traffic Filtering (observation) Details 7.3.3. Traffic Filtering (observation) Details
NA NA
7.3.4. Sampling Distribution 7.3.4. Sampling Distribution
NA NA
7.3.5. Run-time Parameters and Data Format 7.3.5. Run-time Parameters and Data Format
Run-time Parameters are input factors that must be determined, Run-time Parameters are input factors that must be determined,
configured into the measurement system, and reported with the results configured into the measurement system, and reported with the results
for the context to be complete. for the context to be complete.
<list of run-time parameters, and their data formats> <list of run-time parameters, and their data formats>
the IP address of 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])
the host value for IPv4,
value for
see of
Dst the IP address of the host in the Dst Role (format ipv4-address-
the no-zone value for IPv4, or ipv6-address-no-zone value for IPv6,
see section 4 of [RFC6991])
the T0 a time, the start of a measurement interval, (format "date-and-
in and is as time" as specified in Section 5.6 of [RFC3339], see also Section 3
the of the 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"
a of in the 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.
7.3.6. Roles 7.3.6. Roles
<lists the names of the different roles from the measurement method> <lists the names of the different roles from the measurement method>
Src launches each packet and waits for return transmissions from Src launches each packet and waits for return transmissions from
Dst. This is the TWAMP Session-Sender. Dst. This is the TWAMP Session-Sender.
Dst waits for each packet from Src and sends a return packet to Dst waits for each packet from Src and sends a return packet to Src.
Src. This is the TWAMP Session-Reflector. This is the TWAMP Session-Reflector.
7.4. Output 7.4. Output
This category specifies all details of the Output of measurements This category specifies all details of the Output of measurements
using the metric. using the metric.
7.4.1. Type 7.4.1. Type
<insert name of the output type, raw or a selected summary statistic> <insert name of the output type, raw or a selected summary statistic>
See subsection titles below for Types. See subsection titles below for Types.
7.4.2. Reference Definition 7.4.2. Reference Definition
<describe the data format for each type of result> <describe the data format for each type of result>
For all output types --- For all output types ---
of measurement interval, T0 the start of a measurement interval, (format "date-and-time" as
see of 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].
of measurement interval, Tf the end of a measurement interval, (format "date-and-time" as
see of 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].
For each <statistic>, one of the following sub-sections apply:
7.4.2.1. Percentile95 7.4.2.1. Percentile95
The 95th percentile SHALL be calculated using the conditional The 95th percentile SHALL be calculated using the conditional
distribution of all packets with a finite value of One-way delay distribution of all packets with a finite value of One-way delay
(undefined delays are excluded), a single value as follows: (undefined delays are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.3 of [RFC3393] for details on the percentile statistic See section 4.3 of [RFC3393] for details on the percentile statistic
(where Round-trip delay should be substituted for "ipdv"). (where Round-trip delay should be substituted for "ipdv").
The percentile = The percentile = 95, meaning that the reported delay, "95Percentile",
is the smallest value of one-way delay for which the Empirical
Distribution Function (EDF), F(95Percentile) >= 95% of the singleton
one-way delay values in the conditional distribution. See section
11.3 of [RFC2330] for the definition of the percentile statistic
using the EDF.
The time value of the result is expressed in units of seconds, as a 95Percentile The time value of the result is expressed in units of
positive value of type decimal64 with fraction digits = 9 (see seconds, as a positive value of type decimal64 with fraction
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 digits = 9 (see section 9.3 of [RFC6020]) with resolution of
ns), and with lossless conversion to/from the 64-bit NTP timestamp as 0.000000001 seconds (1.0 ns), and with lossless conversion to/from
per section 6 of RFC the 64-bit NTP timestamp as per section 6 of RFC [RFC5905]
7.4.2.2. Mean 7.4.2.2. Mean
The mean SHALL be calculated using the conditional distribution of The mean SHALL be calculated using the conditional distribution of
all packets with a finite value of One-way delay (undefined delays all packets with a finite value of One-way delay (undefined delays
are excluded), a single value as follows: are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.2.2 of [RFC6049] for details on calculating this See section 4.2.2 of [RFC6049] for details on calculating this
statistic, and 4.2.3 of [RFC6049]. statistic, and 4.2.3 of [RFC6049].
The time value of the result is expressed in units of seconds, as a Mean The time value of the result is expressed in units of seconds,
positive value of type decimal64 with fraction digits = 9 (see as a positive value of type decimal64 with fraction digits = 9
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
ns), and with lossless conversion to/from the 64-bit NTP timestamp as seconds (1.0 ns), and with lossless conversion to/from the 64-bit
per section 6 of RFC NTP timestamp as per section 6 of RFC [RFC5905]
7.4.2.3. Min 7.4.2.3. Min
The minimum SHALL be calculated using the conditional distribution of The minimum SHALL be calculated using the conditional distribution of
all packets with a finite value of One-way delay (undefined delays all packets with a finite value of One-way delay (undefined delays
are excluded), a single value as follows: are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.3.2 of [RFC6049] for details on calculating this See section 4.3.2 of [RFC6049] for details on calculating this
statistic, and 4.3.3 of [RFC6049]. statistic, and 4.3.3 of [RFC6049].
The time value of the result is expressed in units of seconds, as a Min The time value of the result is expressed in units of seconds,
positive value of type decimal64 with fraction digits = 9 (see as a positive value of type decimal64 with fraction digits = 9
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
ns), and with lossless conversion to/from the 64-bit NTP timestamp as seconds (1.0 ns), and with lossless conversion to/from the 64-bit
per section 6 of RFC NTP timestamp as per section 6 of RFC [RFC5905]
7.4.2.4. Max 7.4.2.4. Max
The maximum SHALL be calculated using the conditional distribution of The maximum SHALL be calculated using the conditional distribution of
all packets with a finite value of One-way delay (undefined delays all packets with a finite value of One-way delay (undefined delays
are excluded), a single value as follows: are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.3.2 of [RFC6049] for a closely related method for 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 calculating this statistic, and 4.3.3 of [RFC6049]. The formula is
as follows: as follows:
Max = (FiniteDelay [j]) Max = (FiniteDelay [j])
such that for some index, j, where 1 <= j <= N such that for some index, j, where 1 <= j <= N
FiniteDelay[j] >= FiniteDelay[n] for all n FiniteDelay[j] >= FiniteDelay[n] for all n
The time value of the result is expressed in units of seconds, as a Max The time value of the result is expressed in units of seconds,
positive value of type decimal64 with fraction digits = 9 (see as a positive value of type decimal64 with fraction digits = 9
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
ns), and with lossless conversion to/from the 64-bit NTP timestamp as seconds (1.0 ns), and with lossless conversion to/from the 64-bit
per section 6 of RFC NTP timestamp as per section 6 of RFC [RFC5905]
7.4.2.5. Std_Dev 7.4.2.5. Std_Dev
The Std_Dev 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
the classic calculation for standard deviation of a population.
Std_Dev 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 [RFC6020]) with resolution of
0.000000001 seconds (1.0 ns), and with lossless conversion to/from
the 64-bit NTP timestamp as per section 6 of RFC [RFC5905]
7.4.3. Metric Units 7.4.3. Metric Units
<insert units for the measured results, and the reference <insert units for the measured results, and the reference
specification>. specification>.
The <statistic> of One-way Delay is expressed in seconds. The <statistic> of One-way Delay is expressed in seconds.
7.4.4. Calibration 7.4.4. Calibration
to Section 3.7.3 of [RFC7679] provides a means to quantify the
systematic and random errors of a time measurement. In-situ
calibration could be enabled with an internal loopback that includes
as much of the measurement system as possible, performs address
manipulation as needed, and provides some form of isolation (e.g.,
deterministic delay) to avoid send-receive interface contention.
Some portion of the random and systematic error can be characterized
this way.
For one-way delay measurements, the error calibration must include an
assessment of the internal clock synchronization with its external
reference (this internal clock is supplying timestamps for
measurement). In practice, the time offsets of clocks at both the
source and destination are needed to estimate the systematic error
due to imperfect clock synchronization (the time offsets are
smoothed, thus the random variation is not usually represented in the
results).
time_offset The time value of the result is expressed in units of
seconds, as a signed value of type decimal64 with fraction digits
= 9 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
seconds (1.0 ns), and with lossless conversion to/from the 64-bit
NTP timestamp as per section 6 of RFC [RFC5905]
When a measurement controller requests a calibration measurement, the
loopback is applied and the result is output in the same format as a
normal measurement with additional indication that it is a
calibration result. In any measurement, the measurement function
SHOULD report its current estimate of time offset as an indicator of
the degree of synchronization.
Both internal loopback calibration and clock synchronization can be
used to estimate the *available accuracy* of the Output Metric Units.
For example, repeated loopback delay measurements will reveal the
portion of the Output result resolution which is the result of system
noise, and thus inaccurate.
7.5.1. Status 7.5.1. Status
<current or depricated> <current or depricated>
7.5.2. Requestor (keep?) 7.5.2. Requestor (keep?)
name or RFC, etc. name or RFC, etc.
skipping to change at page 40, line 23 skipping to change at page 43, line 48
7.5.4. Revision Date 7.5.4. Revision Date
YYYY-MM-DD YYYY-MM-DD
Additional (Informational) details for this entry Additional (Informational) details for this entry
8. UDP Periodic One-way Delay Registry Entries 8. UDP Periodic One-way Delay Registry Entries
This section initial registry for the UDP Periodic This section specifies five initial registry entries for the UDP
One-way Delay. Periodic One-way Delay.
Note: Each Registry "Name" below specifies a single registry entry, Note: Each Registry "Name" below specifies a single registry entry,
whose output format varies according to of the name that whose output format varies according to the <statistic> element of
specifies one form of statistical summary. the name that specifies one form of statistical summary.
IANA is asked to assign a different numeric identifiers to each IANA is asked to assign a different numeric identifiers to each of
All column entries are the same, thus this section proposes the five Metrics. All column entries beside the ID, Name,
five closely-related registry entries. As a result, IANA is also Description, and Output Reference Method categories are the same,
asked to assign corresponding and thus this section proposes five closely-related registry entries. As
a result, IANA is also asked to assign corresponding URNs and URLs to
each Named Metric.
8.1. Summary 8.1. Summary
This category includes multiple indexes to the registry entries, the This category includes multiple indexes to the registry entries, the
element ID and metric name. element ID and metric name.
8.1.1. ID (Identifier) 8.1.1. ID (Identifier)
<insert numeric identifier, an integer, one corresponding to each <insert numeric identifier, an integer, one corresponding to each
name below> name below>
8.1.2. Name 8.1.2. Name
<insert name according to metric naming convention> <insert name according to metric naming convention>
OWDelay_Active_IP-UDP-Periodic- OWDelay_Active_IP-UDP-Periodic-
where <statistic> is one of:
o 95Percentile
o Mean
o Min
o Max
URI: Prefix o StdDev
8.1.3. URIs
URI: Prefix urn:ietf:metrics:perf:<name>
URL: http:\\www.iana.org\ ... <name> URL: http:\\www.iana.org\ ... <name>
8.1.4. Description 8.1.4. Description
This metric assesses the delay of a stream of packets exchanged This metric assesses the delay of a stream of packets exchanged
between two hosts (or measurement points), and reports the between two hosts (or measurement points), and reports the
<statistic> One-way delay for all successfully exchanged packets <statistic> One-way delay for all successfully exchanged packets
based on their conditional delay distribution. based on their conditional delay distribution.
where <statistic> is one of:
o 95Percentile
o Mean
o Min
o Max
o StdDev
8.2. Metric Definition 8.2. Metric Definition
This category includes columns to prompt the entry of all necessary 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. and values of input factors, called fixed parameters.
8.2.1. Reference Definition 8.2.1. Reference Definition
<Full bibliographic reference to an immutable doc.> <Full bibliographic reference to an immutable doc.>
Almes, G., Kalidindi, S., Zekauskas, "A Delay Metric Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton, Ed., "A One-
for RFC 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>.
[RFC679] [RFC7679]
Morton, A., and Stephan, E., "Spatial Composition of Metrics", RFC Morton, A., and Stephan, E., "Spatial Composition of Metrics", RFC
6049, January 2011. 6049, January 2011.
[RFC6049] [RFC6049]
<specific section reference and additional clarifications, if needed> <specific section reference and additional clarifications, if needed>
Section 3.4 of [RFC679] provides the reference definition of the Section 3.4 of [RFC7679] provides the reference definition of the
singleton (single value) One-way delay metric. Section 4.4 of singleton (single value) One-way delay metric. Section 4.4 of
[RFC7679] provides the reference definition expanded to cover a
provides the reference definition expanded to cover a
multi-value sample. Note that terms such as singleton and sample are multi-value sample. Note that terms such as singleton and sample are
defined in Section 11 of [RFC2330]. defined in Section 11 of [RFC2330].
Only successful packet transfers with finite delay are included in Only successful packet transfers with finite delay are included in
the sample, as prescribed in section 4.1.2 of [RFC6049]. the sample, as prescribed in section 4.1.2 of [RFC6049].
8.2.2. Fixed Parameters 8.2.2. Fixed Parameters
<list and specify Fixed Parameters, input factors that must be <list and specify Fixed Parameters, input factors that must be
determined and embedded in the measurement system for use when determined and embedded in the measurement system for use when
needed> needed>
Type-P: Type-P:
* DSCP: set to 0 * DSCP: set to 0
* set to 255 * TTL: set to 255
* Protocol: Set to 17 (UDP)
* DSCP: set to 0
* Hop Count: set to 255
* Protocol: Set to 17 (UDP) * Protocol: Set to 17 (UDP)
* Checksum: the checksum be calculated * Checksum: the checksum MUST be calculated and included in the
o UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of [RFC5357] o UDP Payload: TWAMP Test Packet Formats, Section 4.1.2 of [RFC5357]
* Security features in use influence the number of Padding * Security features in use influence the number of Padding
octets. octets.
* 142 octets total, including the TWAMP format * 142 octets total, including the TWAMP format
Tmax: seconds Other measurement parameters:
Tmax: a loss threshold waiting time with value 3.0, expressed in
units of seconds, as a positive value of type decimal64 with
fraction digits = 5 (see section 9.3 of [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 [RFC5905].
See the Packet Stream generation category for two additional Fixed
Parameters.
8.3. Method of Measurement 8.3. Method of Measurement
This category includes columns for references to relevant sections of This category includes columns for references to relevant sections of
the RFC(s) and any supplemental information needed to ensure an the RFC(s) and any supplemental information needed to ensure an
unambiguous methods for implementations. unambiguous methods for implementations.
8.3.1. Reference Method 8.3.1. Reference Method
<for metric, insert relevant section references and supplemental <for metric, insert relevant section references and supplemental
info> info>
The methodology for this metric is defined as Type-P-One-way-Delay- The methodology for this metric is defined as Type-P-One-way-Delay-
Poisson-Stream in section 3.6 of and section 4.6 of Poisson-Stream in section 3.6 of [RFC7679] and section 4.6 of
using the Type-P and defined under Fixed [RFC7679] using the Type-P and Tmax defined under Fixed Parameters.
Parameters.
The method The reference method distinguishes between long-delayed packets and
lost packets by implementing a maximum waiting time for packet
packet is arrival. Tmax is the waiting time used as the threshold to declare a
the packet lost. Lost packets SHALL be designated as having undefined
delay.
8.3.2. Packet Stream The calculations on the one-way delay 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 one-way delay 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 to establish correspondence between
sending times and receiving times for each successfully-arriving
packet. Sequence numbers or other send-order identification MUST be
retained at the Src or included with each packet to dis-ambiguate
packet reordering if it occurs.
Since a standard measurement protocol is employed [RFC5357], then the
measurement process will determine the sequence numbers or timestamps
applied to test packets after the Fixed and Runtime parameters are
passed to that process. The measurement protocol dictates the format
of sequence numbers and time-stamps conveyed in the TWAMP-Test packet
8.3.2. Packet Stream Generation
<list of generation parameters and section/spec references if needed>
This section gives the details of the packet traffic which is the This section gives the details of the packet traffic which is the
basis for measurement. In IPPM metrics, this is called the Stream, basis for measurement. In IPPM metrics, this is called the Stream,
and can easily be dscribed by providing the list of stream and can easily be described by providing the list of stream
parameters. parameters.
Section 3 of [RFC3432] prescribes the method for generating Periodic Section 3 of [RFC3432] prescribes the method for generating Periodic
streams using associated parameters. streams using associated parameters.
the nominal duration of inter-packet interval, first bit to incT the nominal duration of inter-packet interval, first bit to
first bit first bit
the duration of the interval for allowed sample start times dT the duration of the interval for allowed sample start times
T0 the actual start time of the periodic stream
NOTE: an initiation process with a number of control exchanges NOTE: an initiation process with a number of control exchanges
resulting in unpredictable start times (within a time interval) may resulting in unpredictable start times (within a time interval) may
be sufficient to avoid synchronization of periodic streams, and be sufficient to avoid synchronization of periodic streams, and
therefore a valid replacement for selecting a start time at random therefore a valid replacement for selecting a start time at random
from a fixed interval. from a fixed interval.
These stream parameters will be specified as Run-time parameters. These stream parameters will be specified as Run-time parameters.
8.3.3. Traffic Filtering (observation) Details 8.3.3. Traffic Filtering (observation) Details
skipping to change at page 44, line 17 skipping to change at page 48, line 48
NA NA
8.3.5. Run-time Parameters and Data Format 8.3.5. Run-time Parameters and Data Format
Run-time Parameters are input factors that must be determined, Run-time Parameters are input factors that must be determined,
configured into the measurement system, and reported with the results configured into the measurement system, and reported with the results
for the context to be complete. for the context to be complete.
<list of run-time parameters, and their data formats> <list of run-time parameters, and their data formats>
the IP address of 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])
the host value for IPv4,
value for
see of
the of 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])
the of the start 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.
the in Tf a time, the end of a measurement interval, (format "date-and-time"
and is as the as specified in Section 5.6 of [RFC3339], see also Section 3 of
of the [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.
>>> should Periodic run-time params be fixed instead? probably yes if >>> should Periodic run-time params be fixed instead? probably yes if
modeling a specific version of tests. Note in the NAME, i.e. modeling a specific version of tests. Note in the NAME, i.e.
Poisson3.3 Poisson3.3
8.3.6. Roles 8.3.6. Roles
<lists the names of the different roles from the measurement method> <lists the names of the different roles from the measurement method>
Src launches each packet and waits for return transmissions from Src launches each packet and waits for return transmissions from
Dst. This is the TWAMP Session-Sender. Dst. This is the TWAMP Session-Sender.
Dst waits for each packet from Src and sends a return packet to Dst waits for each packet from Src and sends a return packet to Src.
Src. This is the TWAMP Session-Reflector. This is the TWAMP Session-Reflector.
8.4. Output 8.4. Output
This category specifies all details of the Output of measurements This category specifies all details of the Output of measurements
using the metric. using the metric.
8.4.1. Type 8.4.1. Type
<insert name of the output type, raw or a selected summary statistic> <insert name of the output type, raw or a selected summary statistic>
See subsection titles in Data Format for Types. See subsection titles in Data Format for Types.
8.4.2. 8.4.2. Reference Definition
<describe the data format for each type of result> <describe the data format for each type of result>
For all output types --- For all output types ---
T0 the start of a measurement interval, (format "date-and-time" as
[RFC6991]). The UTC Time Zone is required by Section 6.1 of
[RFC2330].
of measurement interval, Tf the end of a measurement interval, (format "date-and-time" as
see of 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].
of For each <statistic>, one of the following sub-sections apply:
8.4.2.1. 8.4.2.1. Percentile95
The 95th percentile SHALL be calculated using the conditional The 95th percentile SHALL be calculated using the conditional
distribution of all packets with a finite value of One-way delay distribution of all packets with a finite value of One-way delay
(undefined delays are excluded), a single value as follows: (undefined delays are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.3 of [RFC3393] for details on the percentile statistic See section 4.3 of [RFC3393] for details on the percentile statistic
(where Round-trip delay should be substituted for "ipdv"). (where Round-trip delay should be substituted for "ipdv").
The percentile = The percentile = 95, meaning that the reported delay, "95Percentile",
is the smallest value of one-way delay for which the Empirical
is Distribution Function (EDF), F(95Percentile) >= 95% of the singleton
of the one-way delay values in the conditional distribution. See section
of the 11.3 of [RFC2330] for the definition of the percentile statistic
the of using the EDF.
The time value of the result is expressed in units of seconds, as a 95Percentile The time value of the result is expressed in units of
positive value of type decimal64 with fraction digits = 9 (see seconds, as a positive value of type decimal64 with fraction
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 digits = 9 (see section 9.3 of [RFC6020]) with resolution of
ns), and with lossless conversion to/from the 64-bit NTP timestamp as 0.000000001 seconds (1.0 ns), and with lossless conversion to/from
per section 6 of RFC the 64-bit NTP timestamp as per section 6 of RFC [RFC5905]
8.4.2.2. Mean 8.4.2.2. Mean
The mean SHALL be calculated using the conditional distribution of The mean SHALL be calculated using the conditional distribution of
all packets with a finite value of One-way delay (undefined delays all packets with a finite value of One-way delay (undefined delays
are excluded), a single value as follows: are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.2.2 of [RFC6049] for details on calculating this See section 4.2.2 of [RFC6049] for details on calculating this
statistic, and 4.2.3 of [RFC6049]. statistic, and 4.2.3 of [RFC6049].
The time value of the result is expressed in units of seconds, as a Mean The time value of the result is expressed in units of seconds,
positive value of type decimal64 with fraction digits = 9 (see as a positive value of type decimal64 with fraction digits = 9
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
ns), and with lossless conversion to/from the 64-bit NTP timestamp as seconds (1.0 ns), and with lossless conversion to/from the 64-bit
per section 6 of RFC NTP timestamp as per section 6 of RFC [RFC5905]
8.4.2.3. Min 8.4.2.3. Min
The minimum SHALL be calculated using the conditional distribution of The minimum SHALL be calculated using the conditional distribution of
all packets with a finite value of One-way delay (undefined delays all packets with a finite value of One-way delay (undefined delays
are excluded), a single value as follows: are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.3.2 of [RFC6049] for details on calculating this See section 4.3.2 of [RFC6049] for details on calculating this
statistic, and 4.3.3 of [RFC6049]. statistic, and 4.3.3 of [RFC6049].
The time value of the result is expressed in units of seconds, as a Min The time value of the result is expressed in units of seconds,
positive value of type decimal64 with fraction digits = 9 (see as a positive value of type decimal64 with fraction digits = 9
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
ns), and with lossless conversion to/from the 64-bit NTP timestamp as seconds (1.0 ns), and with lossless conversion to/from the 64-bit
per section 6 of RFC NTP timestamp as per section 6 of RFC [RFC5905]
8.4.2.4. Max 8.4.2.4. Max
The maximum SHALL be calculated using the conditional distribution of The maximum SHALL be calculated using the conditional distribution of
all packets with a finite value of One-way delay (undefined delays all packets with a finite value of One-way delay (undefined delays
are excluded), a single value as follows: are excluded), a single value as follows:
See section 4.1 of [RFC3393] for details on the conditional See section 4.1 of [RFC3393] for details on the conditional
distribution to exclude undefined values of delay, and Section 5 of distribution to exclude undefined values of delay, and Section 5 of
[RFC6703] for background on this analysis choice. [RFC6703] for background on this analysis choice.
See section 4.3.2 of [RFC6049] for a closely related method for 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 calculating this statistic, and 4.3.3 of [RFC6049]. The formula is
as follows: as follows:
Max = (FiniteDelay [j]) Max = (FiniteDelay [j])
such that for some index, j, where 1 <= j <= N such that for some index, j, where 1 <= j <= N
FiniteDelay[j] >= FiniteDelay[n] for all n FiniteDelay[j] >= FiniteDelay[n] for all n
The time value of the result is expressed in units of seconds, as a Max The time value of the result is expressed in units of seconds,
positive value of type decimal64 with fraction digits = 9 (see as a positive value of type decimal64 with fraction digits = 9
section 9.3 of [RFC6020]) with resolution of 0.000000001 seconds (1.0 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
ns), and with lossless conversion to/from the 64-bit NTP timestamp as seconds (1.0 ns), and with lossless conversion to/from the 64-bit
per section 6 of RFC NTP timestamp as per section 6 of RFC [RFC5905]
8.4.2.5. Std_Dev 8.4.2.5. Std_Dev
The Std_Dev 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
the classic calculation for standard deviation of a population.
Std_Dev 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 [RFC6020]) with resolution of
0.000000001 seconds (1.0 ns), and with lossless conversion to/from
the 64-bit NTP timestamp as per section 6 of RFC [RFC5905]
8.4.3. Metric Units 8.4.3. Metric Units
<insert units for the measured results, and the reference <insert units for the measured results, and the reference
specification>. specification>.
The <statistic> of One-way Delay is expressed in seconds. The <statistic> of One-way Delay is expressed in seconds.
8.4.4. Calibration 8.4.4. Calibration
to Section 3.7.3 of [RFC7679] provides a means to quantify the
systematic and random errors of a time measurement. In-situ
calibration could be enabled with an internal loopback that includes
as much of the measurement system as possible, performs address
manipulation as needed, and provides some form of isolation (e.g.,
deterministic delay) to avoid send-receive interface contention.
Some portion of the random and systematic error can be characterized
this way.
For one-way delay measurements, the error calibration must include an
assessment of the internal clock synchronization with its external
reference (this internal clock is supplying timestamps for
measurement). In practice, the time offsets of clocks at both the
source and destination are needed to estimate the systematic error
due to imperfect clock synchronization (the time offsets are
smoothed, thus the random variation is not usually represented in the
results).
time_offset The time value of the result is expressed in units of
seconds, as a signed value of type decimal64 with fraction digits
= 9 (see section 9.3 of [RFC6020]) with resolution of 0.000000001
seconds (1.0 ns), and with lossless conversion to/from the 64-bit
NTP timestamp as per section 6 of RFC [RFC5905]
When a measurement controller requests a calibration measurement, the
loopback is applied and the result is output in the same format as a
normal measurement with additional indication that it is a
calibration result. In any measurement, the measurement function
SHOULD report its current estimate of time offset as an indicator of
the degree of synchronization.
Both internal loopback calibration and clock synchronization can be
used to estimate the *available accuracy* of the Output Metric Units.
For example, repeated loopback delay measurements will reveal the
portion of the Output result resolution which is the result of system
noise, and thus inaccurate.
8.5.1. Status 8.5.1. Status
<current or depricated> <current or depricated>
8.5.2. Requestor (keep?) 8.5.2. Requestor (keep?)
name or RFC, etc. name or RFC, etc.
skipping to change at page 48, line 32 skipping to change at page 54, line 24
9.1.1. ID (Identifier) 9.1.1. ID (Identifier)
<insert numeric identifier, an integer> <insert numeric identifier, an integer>
9.1.2. Name 9.1.2. Name
<insert name according to metric naming convention> <insert name according to metric naming convention>
9.1.3. URIs 9.1.3. URIs
URI: Prefix urn:ietf: URI: Prefix urn:ietf:metrics:perf:<name>
URL: URL:
9.1.4. Description 9.1.4. Description
TBD. TBD.
9.1.5. Reference 9.1.5. Reference
<reference to the RFC of spec where the registry entry is defined> <reference to the RFC of spec where the registry entry is defined>
skipping to change at page 51, line 37 skipping to change at page 57, line 29
An integer having enough digits to uniquely identify each entry in An integer having enough digits to uniquely identify each entry in
the Registry. the Registry.
10.1.2. Name 10.1.2. Name
A metric naming convention is TBD. A metric naming convention is TBD.
10.1.3. URI 10.1.3. URI
Prefix urn:ietf: Prefix urn:ietf:metrics:param:<name>
10.1.4. Status 10.1.4. Status
current current
10.1.5. Requestor 10.1.5. Requestor
Alcelip Mornuley Alcelip Mornuley
10.1.6. Revision 10.1.6. Revision
skipping to change at page 56, line 26 skipping to change at page 62, line 14
measurement has been removed. * Explanation of Conditional delay measurement has been removed. * Explanation of Conditional delay
distribution. distribution.
sections 1-4. and resolved the definition of Percentiles. sections 1-4. and resolved the definition of Percentiles.
Version 04 * All section 4 parameters reference YANG types for Version 04 * All section 4 parameters reference YANG types for
alternate data formats. * Discussion has concluded that usecase(s) alternate data formats. * Discussion has concluded that usecase(s)
for machine parse-able registry columns are not needed. for machine parse-able registry columns are not needed.
12. Security Considerations 12. Security Considerations
These registry entries represent no known security implications for These registry entries represent no known security implications for
Internet Security. Each referenced Metric contains a Security Internet Security. Each referenced Metric contains a Security
Considerations section. Considerations section.
13. IANA Considerations 13. IANA Considerations
IANA is requested to populate The Performance Metric Registry defined IANA is requested to populate The Performance Metric Registry defined
in [I-D.ietf-ippm-metric-registry] with the values defined above. in [I-D.ietf-ippm-metric-registry] with the values defined above.
See the IANA Considerations section of
considerations.
14. Acknowledgements 14. Acknowledgements
The authors thank Brian Trammell for suggesting the term "Run-time The authors thank Brian Trammell for suggesting the term "Run-time
Parameters", which led to the distinction between run-time and fixed Parameters", which led to the distinction between run-time and fixed
parameters implemented in this memo, for identifying the IPFIX metric parameters implemented in this memo, for identifying the IPFIX metric
with Flow Key as an example, and for many other productive with Flow Key as an example, and for many other productive
suggestions. Thanks to Peter Koch, who provided several useful suggestions. Thanks to Peter Koch, who provided several useful
suggestions for disambiguating successive DNS Queries in the DNS suggestions for disambiguating successive DNS Queries in the DNS
Response time metric. Response time metric.
The authors also acknowledge the constructive reviews and helpful The authors also acknowledge the constructive reviews and helpful
suggestions from Barbara Stark, Juergen Schoenwaelder, Tim Carey, and suggestions from Barbara Stark, Juergen Schoenwaelder, Tim Carey, and
participants in the LMAP working group. participants in the LMAP working group. Thanks to Michelle Cotton
for her early IANA review, and to Amanda Barber for answering
questions related to the presentation of the registry and
accessibility of the complete template via URL.
15. References 15. References
15.1. Normative References 15.1. Normative References
[I-D.ietf-ippm-metric-registry] [I-D.ietf-ippm-metric-registry]
Bagnulo, M., Claise, B., Eardley, P., and A. Morton, Bagnulo, M., Claise, B., Eardley, P., and A. Morton,
"Registry for Performance Metrics", Internet Draft (work "Registry for Performance Metrics", Internet Draft (work
in progress) draft-ietf-ippm-metric-registry, 2014. in progress) draft-ietf-ippm-metric-registry, 2014.
[RFC1035] Mockapetris, P., "Domain names - implementation and [RFC1035] Mockapetris, P., "Domain names - implementation and
specification", STD 13, RFC 1035, DOI 10.17487/RFC1035, specification", STD 13, RFC 1035, DOI 10.17487/RFC1035,
November 1987, <http://www.rfc-editor.org/info/rfc1035>. November 1987, <http://www.rfc-editor.org/info/rfc1035>.
End of changes. 162 change blocks.
510 lines changed or deleted 787 lines changed or added

This html diff was produced by rfcdiff 1.45. The latest version is available from http://tools.ietf.org/tools/rfcdiff/