Initial Performance Metric Registry Entries Part 2: MBM
draft-morton-ippm-mbm-registry-01

Versions: 00 01                                                         
Network Working Group                                          A. Morton
Internet-Draft                                                 AT&T Labs
Intended status: Standards Track                               M. Mathis
Expires: May 3, 2017                                              Google
                                                        October 30, 2016


        Initial Performance Metric Registry Entries Part 2: MBM
                   draft-morton-ippm-mbm-registry-00

Abstract

   This memo defines a Registry Entry for the Performance Metrics
   Registry based on Model Based Metrics.  This entry will be combined
   with the "initial-registry" draft after review.

Requirements Language

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119 [RFC2119].

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on May 3, 2017.

Copyright Notice

   Copyright (c) 2016 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents



Morton & Mathis            Expires May 3, 2017                  [Page 1]


Internet-Draft           Initial Registry Part 2            October 2016


   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
   3.  MBM Registry Entry  . . . . . . . . . . . . . . . . . . . . .   4
     3.1.  Summary . . . . . . . . . . . . . . . . . . . . . . . . .   4
       3.1.1.  ID (Identifier) . . . . . . . . . . . . . . . . . . .   4
       3.1.2.  Name  . . . . . . . . . . . . . . . . . . . . . . . .   4
       3.1.3.  URIs  . . . . . . . . . . . . . . . . . . . . . . . .   4
       3.1.4.  Description . . . . . . . . . . . . . . . . . . . . .   4
       3.1.5.  Reference . . . . . . . . . . . . . . . . . . . . . .   4
       3.1.6.  Change Controller . . . . . . . . . . . . . . . . . .   4
       3.1.7.  Version (of Registry Format)  . . . . . . . . . . . .   4
     3.2.  Metric Definition . . . . . . . . . . . . . . . . . . . .   5
       3.2.1.  Reference Definition  . . . . . . . . . . . . . . . .   5
       3.2.2.  Fixed Parameters  . . . . . . . . . . . . . . . . . .   6
     3.3.  Method of Measurement . . . . . . . . . . . . . . . . . .   7
       3.3.1.  Reference Method  . . . . . . . . . . . . . . . . . .   7
       3.3.2.  Packet Stream Generation  . . . . . . . . . . . . . .   7
       3.3.3.  Traffic Filtering (observation) Details . . . . . . .   8
       3.3.4.  Sampling Distribution . . . . . . . . . . . . . . . .   8
       3.3.5.  Run-time Parameters and Data Format . . . . . . . . .   8
       3.3.6.  Roles . . . . . . . . . . . . . . . . . . . . . . . .  10
     3.4.  Output  . . . . . . . . . . . . . . . . . . . . . . . . .  10
       3.4.1.  Type  . . . . . . . . . . . . . . . . . . . . . . . .  10
       3.4.2.  Reference Definition  . . . . . . . . . . . . . . . .  10
       3.4.3.  Metric Units  . . . . . . . . . . . . . . . . . . . .  11
       3.4.4.  Calibration . . . . . . . . . . . . . . . . . . . . .  11
     3.5.  Administrative items  . . . . . . . . . . . . . . . . . .  11
       3.5.1.  Status  . . . . . . . . . . . . . . . . . . . . . . .  11
       3.5.2.  Requestor . . . . . . . . . . . . . . . . . . . . . .  12
       3.5.3.  Revision  . . . . . . . . . . . . . . . . . . . . . .  12
       3.5.4.  Revision Date . . . . . . . . . . . . . . . . . . . .  12
     3.6.  Comments and Remarks  . . . . . . . . . . . . . . . . . .  12
   4.  ver08 BLANK Registry Entry  . . . . . . . . . . . . . . . . .  12
     4.1.  Summary . . . . . . . . . . . . . . . . . . . . . . . . .  12
       4.1.1.  ID (Identifier) . . . . . . . . . . . . . . . . . . .  12
       4.1.2.  Name  . . . . . . . . . . . . . . . . . . . . . . . .  12
       4.1.3.  URIs  . . . . . . . . . . . . . . . . . . . . . . . .  12
       4.1.4.  Description . . . . . . . . . . . . . . . . . . . . .  12
       4.1.5.  Reference . . . . . . . . . . . . . . . . . . . . . .  12
       4.1.6.  Change Controller . . . . . . . . . . . . . . . . . .  13



Morton & Mathis            Expires May 3, 2017                  [Page 2]


Internet-Draft           Initial Registry Part 2            October 2016


       4.1.7.  Version (of Registry Format)  . . . . . . . . . . . .  13
     4.2.  Metric Definition . . . . . . . . . . . . . . . . . . . .  13
       4.2.1.  Reference Definition  . . . . . . . . . . . . . . . .  13
       4.2.2.  Fixed Parameters  . . . . . . . . . . . . . . . . . .  13
     4.3.  Method of Measurement . . . . . . . . . . . . . . . . . .  13
       4.3.1.  Reference Method  . . . . . . . . . . . . . . . . . .  13
       4.3.2.  Packet Stream Generation  . . . . . . . . . . . . . .  13
       4.3.3.  Traffic Filtering (observation) Details . . . . . . .  13
       4.3.4.  Sampling Distribution . . . . . . . . . . . . . . . .  14
       4.3.5.  Run-time Parameters and Data Format . . . . . . . . .  14
       4.3.6.  Roles . . . . . . . . . . . . . . . . . . . . . . . .  14
     4.4.  Output  . . . . . . . . . . . . . . . . . . . . . . . . .  14
       4.4.1.  Type  . . . . . . . . . . . . . . . . . . . . . . . .  14
       4.4.2.  Reference Definition  . . . . . . . . . . . . . . . .  14
       4.4.3.  Metric Units  . . . . . . . . . . . . . . . . . . . .  14
       4.4.4.  Calibration . . . . . . . . . . . . . . . . . . . . .  14
     4.5.  Administrative items  . . . . . . . . . . . . . . . . . .  14
       4.5.1.  Status  . . . . . . . . . . . . . . . . . . . . . . .  14
       4.5.2.  Requestor . . . . . . . . . . . . . . . . . . . . . .  14
       4.5.3.  Revision  . . . . . . . . . . . . . . . . . . . . . .  15
       4.5.4.  Revision Date . . . . . . . . . . . . . . . . . . . .  15
     4.6.  Comments and Remarks  . . . . . . . . . . . . . . . . . .  15
   5.  Security Considerations . . . . . . . . . . . . . . . . . . .  15
   6.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  15
   7.  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . .  15
   8.  References  . . . . . . . . . . . . . . . . . . . . . . . . .  15
     8.1.  Normative References  . . . . . . . . . . . . . . . . . .  15
     8.2.  Informative References  . . . . . . . . . . . . . . . . .  17
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  19

1.  Introduction

   Note: Efforts to synchronize structure and terminology with
   [I-D.ietf-ippm-metric-registry] will likely be incomplete until both
   drafts are stable.

   This memo proposes a (set of) entry(ies) for the Performance Metric
   Registry, based on Model-Based Metrics (MBM).  It uses terms and
   definitions from the IPPM literature, primarily [RFC2330].

2.  Scope

   This document defines one of the initial set of Performance Metrics
   Registry entries, for which IETF approval (following development in
   the IP Performance Metrics (IPPM) Working Group) will satisfy the
   requirement for Expert Review.  Note that all are Active Performance
   Metrics, which are based on RFCs prepared in the IPPM working group
   of the IETF, according to their framework [RFC2330] and its updates.



Morton & Mathis            Expires May 3, 2017                  [Page 3]


Internet-Draft           Initial Registry Part 2            October 2016


3.  MBM Registry Entry

   This section gives an initial registry entry for a Model-Based Metric
   (MBM) Sustained Burst Metric.

3.1.  Summary

   This category includes multiple indexes to the registry entries, the
   element ID and metric name.

3.1.1.  ID (Identifier)

   <insert numeric identifier, an integer>

3.1.2.  Name

   <insert name according to metric naming convention>

   OWMBM_Active_IP-TCP-SustainedBurst_RFCXXXXsecY_Enumerated_PFI

3.1.3.  URIs

   URI: Prefix urn:ietf:metric

   URL: http://<TBD by IANA>/<name>

3.1.4.  Description

   TBD.

3.1.5.  Reference

   <reference to the RFC of spec where the registry entry is defined>

   RFCXXXXsecY

3.1.6.  Change Controller

   <org or person >

3.1.7.  Version (of Registry Format)

   <currently 1.0>








Morton & Mathis            Expires May 3, 2017                  [Page 4]


Internet-Draft           Initial Registry Part 2            October 2016


3.2.  Metric Definition

   This category includes columns to prompt the entry of all necessary
   details related to the metric definition, including the RFC reference
   and values of input factors, called fixed parameters.

3.2.1.  Reference Definition

   <Full bibliographic reference to an immutable doc.>

   <specific section reference and additional clarifications, if needed>

   Mathis, M. and A.  Morton, "Model Based Metrics for Bulk Transport
   Capacity", draft-ietf-ippm-model-based- metrics-08 (work in
   progress), July 2016.

   The primary metrics of measurement are round-trip delay and one-way
   loss, measured under the conditions described in Section 8.5.1 of
   [I-D.ietf-ippm-model-based-metrics].

   For loss:

   Almes, G., Kalidindi, S., and M.  Zekauskas, "A One-way Packet Loss
   Metric for IPPM", RFC 2680, DOI 10.17487/RFC2680, September 1999,
   <http://www.rfc-editor.org/info/rfc2680>.

   Section 2.4 of [RFC7680] provides the reference definition of the
   singleton (single value) one-way loss metric.  Section 3.4 of
   [RFC7680] provides the reference definition expanded to cover a
   multi-singleton sample.  Note that terms such as singleton and sample
   are defined in Section 11 of [RFC2330].

   For round-trip delay:

   Almes, G., Kalidindi, S., Zekauskas, M., and A.  Morton, Ed., "A One-
   Way Delay Metric for IP Performance Metrics (IPPM)", STD 81, RFC
   7679, DOI 10.17487/RFC7679, January 2016, <http://www.rfc-
   editor.org/info/rfc7679>.

   [RFC2681]

   <specific section reference and additional clarifications, if needed>

   Section 2.4 of [RFC2681] provides the reference definition of the
   singleton (single value) Round-trip delay metric.  Section 3.4 of
   [RFC2681] provides the reference definition expanded to cover a
   multi-singleton sample.  Note that terms such as singleton and sample
   are defined in Section 11 of [RFC2330].



Morton & Mathis            Expires May 3, 2017                  [Page 5]


Internet-Draft           Initial Registry Part 2            October 2016


   Note that although the definition of "Round-trip-Delay between Src
   and Dst" is directionally ambiguous in the text, this metric tightens
   the definition further to recognize that the host in the "Src" role
   will send the first packet to "Dst", and ultimately receive the
   corresponding return packet from "Dst" (when neither are lost).

   Finally, note that the variable "dT" is used in [RFC2681] to refer to
   the value of Round-trip delay in metric definitions and methods.  The
   variable "dT" has been re-used in other IPPM literature to refer to
   different quantities, and cannot be used as a global variable name.

3.2.2.  Fixed Parameters

   <list and specify Fixed Parameters, input factors that must be
   determined and embedded in the measurement system for use when
   needed>

   Type-P as defined in Section 13 of [RFC2330]:

   o  IPv4 header values:

      *  DSCP: set to 0

      *  TTL: set to 255

      *  Protocol: Set to 6 (TCP)

   o  IPv6 header values:

      *  DSCP: set to 0

      *  Hop Count: set to 255

      *  Protocol: Set to 6 (TCP)

   o  TCP header values:

      *  Checksum: the checksum MUST be calculated

   o  TCP Payload

      *  see target_MTU in Run-time parameters.

   Other measurement parameters:

   o  Tmax: a loss threshold waiting time





Morton & Mathis            Expires May 3, 2017                  [Page 6]


Internet-Draft           Initial Registry Part 2            October 2016


      *  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].

3.3.  Method of Measurement

   This category includes columns for references to relevant sections of
   the RFC(s) and any supplemental information needed to ensure an
   unambiguous methods for implementations.

3.3.1.  Reference Method

   <for metric, insert relevant section references and supplemental
   info>

   The method of measurement is described in Section 8.1.5 of
   [I-D.ietf-ippm-model-based-metrics].

   @@@@<more could be said here about loss and RTT methods>

3.3.2.  Packet Stream Generation

   <list of generation parameters and section/spec references if needed>

   The stream generation parameters are described in Section 3 of
   [I-D.ietf-ippm-model-based-metrics].  They are dependent on the
   target parameters described in the Run-time parameters section below.

   packet_headway  Time interval between packets, specified from the
      start of one to the start of the next.

   burst_headway  Time interval between bursts, specified from the start
      of the first packet one burst to the start of the first packet of
      the next burst.

   paced_single_packets  Send individual packets at the specified rate
      or packet headway.

   paced_bursts  Send bursts on a timer.  Specify any 3 of: average data
      rate, packet size, burst size (number of packets) and burst
      headway (burst start to start).

   slowstart_rate  Mimic TCP slowstart by sending 4 packet paced bursts
      at an average data rate equal to twice the implied bottleneck IP
      capacity (but not more than the sender interface rate).




Morton & Mathis            Expires May 3, 2017                  [Page 7]


Internet-Draft           Initial Registry Part 2            October 2016


   slowstart_burst  Mimic one round of TCP slowstart by sending a
      specified number of packets packets in a two level burst pattern
      that resembles slowstart.

   repeated_slowstart_burst  Repeat Slowstart bursts once per
      target_RTT.

3.3.3.  Traffic Filtering (observation) Details

   <insert the measured results based on a filtered version of the
   packets observed, and this section provides the filter details (when
   present), and section reference>.

   NA

3.3.4.  Sampling Distribution

   <insert time distribution details, or how this is diff from the
   filter>

   NA

3.3.5.  Run-time Parameters and Data Format

   <list of run-time parameters, and any reference(s)>.

   The following parameters are described in [RFC2330]

   Src  the IP address of the host in the Src Role (format ipv4-address-
      no-zone value for IPv4, or ipv6-address-no-zone value for IPv6,
      see Section 4 of [RFC6991])

   Dst  the IP address of the host in the Dst Role (format ipv4-address-
      no-zone value for IPv4, or ipv6-address-no-zone value for IPv6,
      see section 4 of [RFC6991])

   T0 a time, the start of a measurement interval, (format "date-and-
      time" as specified in Section 5.6 of [RFC3339], see also Section 3
      of [RFC6991]).  The UTC Time Zone is required by Section 6.1 of
      [RFC2330].  When T0 is "all-zeros", a start time is unspecified
      and Tf is to be interpreted as the Duration of the measurement
      interval.  The start time is controlled through other means.

   Tf a time, the end of a measurement interval, (format "date-and-time"
      as specified in Section 5.6 of [RFC3339], see also Section 3 of
      [RFC6991]).  The UTC Time Zone is required by Section 6.1 of
      [RFC2330].  When T0 is "all-zeros", a end time date is ignored and
      Tf is interpreted as the Duration of the measurement interval.



Morton & Mathis            Expires May 3, 2017                  [Page 8]


Internet-Draft           Initial Registry Part 2            October 2016


   The following MBM-specific parameters are as defined in Section 3 of
   [I-D.ietf-ippm-model-based-metrics], and subsequent sections of the
   memo.

   target_rate  The specified application data rate required for an
      application's proper operation.

   target_RTT  The specified baseline (minimum) RTT of the longest
      complete path over which the user expects to be able meet the
      target performance.

   target_MTU  The specified maximum MTU supported by the complete path
      the over which the application expects to meet the target
      performance.

   target_window_size  The average number of packets in flight (the
      window size) needed to meet the Target Data Rate, for the
      specified Target RTT, and MTU.  It implies the scale of the bursts
      that the network might experience.

   subpath_???  Do we need a subpath-specific parameter?

   derating  The modeling framework permits some latitude in relaxing or
      "derating" some test parameters as described in Section 5.3 in
      exchange for a more stringent TIDS validation procedures,
      described in Section 10 of [I-D.ietf-ippm-model-based-metrics].

   test_window  The smallest window sufficient to meet or exceeded the
      target_rate when operating with a pure self clock over a test
      path.



   The following MBM-specific parameters are as defined in Section of
   7.2 [I-D.ietf-ippm-model-based-metrics]:

   H0H1_ratio  The value of the multiplier on the Null Hypothesis loss
      ratio used to calculate the Alternate Hypothesis loss ratio.

   alpha_TI_err  Measurements support accepting H0 with the specified
      Type I error = alpha (= 0.05 for example).

   beta_TII_err  Measurements support accepting H1 with the specified
      Type II error = beta (= 0.05 for example).

   Additional MBM-specific parameters may be calculated by the
   measurement system itself, or they may be supplied as additional Run-
   time parameters:



Morton & Mathis            Expires May 3, 2017                  [Page 9]


Internet-Draft           Initial Registry Part 2            October 2016


3.3.6.  Roles

   <lists the names of the different roles from the measurement method>

   data_sender  Host sending data and receiving ACKs.

   data_receiver  Host receiving data and sending ACKs.

   as described in Section 3 of [I-D.ietf-ippm-model-based-metrics].

3.4.  Output

   This category specifies all details of the Output of measurements
   using the metric.

3.4.1.  Type

   <insert name of the output type, raw or a selected summary statistic>

   The primary output type is PFI, or Pass, Fail, Inconclusive,
   referring to the conclusion of the test.

   Two secondary output types MAY be reported to support the primary
   output.

   Loss Ratio: Singleton

   Mean Round-trip Time: Singleton

3.4.2.  Reference Definition

   <pointer to section/spec where output type/format is defined>

   For all outputs ---

   T0 the start of a measurement interval, (format "date-and-time" as
      specified in Section 5.6 of [RFC3339], see also Section 3 of
      [RFC6991]).  The UTC Time Zone is required by Section 6.1 of
      [RFC2330].

   Tf the end of a measurement interval, (format "date-and-time" as
      specified in Section 5.6 of [RFC3339], see also Section 3 of
      [RFC6991]).  The UTC Time Zone is required by Section 6.1 of
      [RFC2330].

   PFI:

   @@@@<TBP>@@@@



Morton & Mathis            Expires May 3, 2017                 [Page 10]


Internet-Draft           Initial Registry Part 2            October 2016


   Loss Ratio:

   @@@@<TBP>@@@@

   Mean Round-trip Time:

   The mean SHALL be calculated using the conditional distribution of
   all packets with a finite value of round-trip delay (undefined delays
   are excluded), a single value as follows:

   See section 4.1 of [RFC3393] for details on the conditional
   distribution to exclude undefined values of delay, and Section 5 of
   [RFC6703] for background on this analysis choice.

   See section 4.2.2 of [RFC6049] for details on calculating this
   statistic, and 4.2.3 of [RFC6049].

   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].

3.4.3.  Metric Units

   <insert units for the measured results, and the reference
   specification>.

   PFI: Enumerated{Pass, Fail, Inconclusive}

   Loss Ratio: RatioPercent

   Mean Round-trip Time: Seconds

3.4.4.  Calibration

   <describe the error calibration, a way to indicate that the results
   were collected in a calbration mode of operation, and a way to report
   internal status metrics related to calibration, such as time offset>

3.5.  Administrative items

3.5.1.  Status

   <current or depricated>






Morton & Mathis            Expires May 3, 2017                 [Page 11]


Internet-Draft           Initial Registry Part 2            October 2016


3.5.2.  Requestor

   <name of individual or Internet Draft, etc.>

3.5.3.  Revision

   1.0

3.5.4.  Revision Date

   YYYY-MM-DD

3.6.  Comments and Remarks

   Additional (Informational) details for this entry

4.  ver08 BLANK Registry Entry

   This section gives an initial registry entry for ....

4.1.  Summary

   This category includes multiple indexes to the registry entries, the
   element ID and metric name.

4.1.1.  ID (Identifier)

   <insert numeric identifier, an integer>

4.1.2.  Name

   <insert name according to metric naming convention>

4.1.3.  URIs

   URI: Prefix urn:ietf:params:performance:metric

   URL:

4.1.4.  Description

   TBD.

4.1.5.  Reference

   <reference to the RFC of spec where the registry entry is defined>





Morton & Mathis            Expires May 3, 2017                 [Page 12]


Internet-Draft           Initial Registry Part 2            October 2016


4.1.6.  Change Controller

   <org or person >

4.1.7.  Version (of Registry Format)

   <currently 1.0>

4.2.  Metric Definition

   This category includes columns to prompt the entry of all necessary
   details related to the metric definition, including the RFC reference
   and values of input factors, called fixed parameters.

4.2.1.  Reference Definition

   <Full bibliographic reference to an immutable doc.>

   <specific section reference and additional clarifications, if needed>

4.2.2.  Fixed Parameters

   <list and specify Fixed Parameters, input factors that must be
   determined and embedded in the measurement system for use when
   needed>

4.3.  Method of Measurement

   This category includes columns for references to relevant sections of
   the RFC(s) and any supplemental information needed to ensure an
   unambiguous methods for implementations.

4.3.1.  Reference Method

   <for metric, insert relevant section references and supplemental
   info>

4.3.2.  Packet Stream Generation

   <list of generation parameters and section/spec references if needed>

4.3.3.  Traffic Filtering (observation) Details

   <insert the measured results based on a filtered version of the
   packets observed, and this section provides the filter details (when
   present), and section reference>.





Morton & Mathis            Expires May 3, 2017                 [Page 13]


Internet-Draft           Initial Registry Part 2            October 2016


4.3.4.  Sampling Distribution

   <insert time distribution details, or how this is diff from the
   filter>

4.3.5.  Run-time Parameters and Data Format

   <list of run-time parameters, and any reference(s)>.

4.3.6.  Roles

   <lists the names of the different roles from the measurement method>

4.4.  Output

   This category specifies all details of the Output of measurements
   using the metric.

4.4.1.  Type

   <insert name of the output type, raw or a selected summary statistic>

4.4.2.  Reference Definition

   <pointer to section/spec where output type/format is defined>

4.4.3.  Metric Units

   <insert units for the measured results, and the reference
   specification>.

4.4.4.  Calibration

   <describe the error calibration, a way to indicate that the results
   were collected in a calbration mode of operation, and a way to report
   internal status metrics related to calibration, such as time offset>

4.5.  Administrative items

4.5.1.  Status

   <current or depricated>

4.5.2.  Requestor

   <name of individual or Internet Draft, etc.>





Morton & Mathis            Expires May 3, 2017                 [Page 14]


Internet-Draft           Initial Registry Part 2            October 2016


4.5.3.  Revision

   1.0

4.5.4.  Revision Date

   YYYY-MM-DD

4.6.  Comments and Remarks

   Additional (Informational) details for this entry

5.  Security Considerations

   These registry entries represent no known security implications for
   Internet Security.  Each referenced Metric contains a Security
   Considerations section.

6.  IANA Considerations

   IANA is requested to populate The Performance Metric Registry defined
   in [I-D.ietf-ippm-metric-registry] with the values defined above.

   <more is needed here>

7.  Acknowledgements

   The authors thank Brian Trammell for suggesting the term "Run-time
   Parameters", which led to the distinction between run-time and fixed
   parameters implemented in this memo, for identifying the IPFIX metric
   with Flow Key as an example, and for many other productive
   suggestions.  Thanks to Peter Koch, who provided several useful
   suggestions for disambiguating successive DNS Queries in the DNS
   Response time metric.

   The authors also acknowledge the constructive reviews and helpful
   suggestions from Barbara Stark, Juergen Schoenwaelder, Tim Carey, and
   participants in the LMAP working group.

8.  References

8.1.  Normative References

   [I-D.ietf-ippm-metric-registry]
              Bagnulo, M., Claise, B., Eardley, P., and A. Morton,
              "Registry for Performance Metrics", Internet Draft (work
              in progress) draft-ietf-ippm-metric-registry, 2014.




Morton & Mathis            Expires May 3, 2017                 [Page 15]


Internet-Draft           Initial Registry Part 2            October 2016


   [I-D.ietf-ippm-model-based-metrics]
              Mathis, M. and A. Morton, "Model Based Metrics for Bulk
              Transport Capacity", draft-ietf-ippm-model-based-
              metrics-08 (work in progress), July 2016.

   [RFC1035]  Mockapetris, P., "Domain names - implementation and
              specification", STD 13, RFC 1035, DOI 10.17487/RFC1035,
              November 1987, <http://www.rfc-editor.org/info/rfc1035>.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <http://www.rfc-editor.org/info/rfc2119>.

   [RFC2330]  Paxson, V., Almes, G., Mahdavi, J., and M. Mathis,
              "Framework for IP Performance Metrics", RFC 2330,
              DOI 10.17487/RFC2330, May 1998,
              <http://www.rfc-editor.org/info/rfc2330>.

   [RFC2679]  Almes, G., Kalidindi, S., and M. Zekauskas, "A One-way
              Delay Metric for IPPM", RFC 2679, DOI 10.17487/RFC2679,
              September 1999, <http://www.rfc-editor.org/info/rfc2679>.

   [RFC2680]  Almes, G., Kalidindi, S., and M. Zekauskas, "A One-way
              Packet Loss Metric for IPPM", RFC 2680,
              DOI 10.17487/RFC2680, September 1999,
              <http://www.rfc-editor.org/info/rfc2680>.

   [RFC2681]  Almes, G., Kalidindi, S., and M. Zekauskas, "A Round-trip
              Delay Metric for IPPM", RFC 2681, DOI 10.17487/RFC2681,
              September 1999, <http://www.rfc-editor.org/info/rfc2681>.

   [RFC3339]  Klyne, G. and C. Newman, "Date and Time on the Internet:
              Timestamps", RFC 3339, DOI 10.17487/RFC3339, July 2002,
              <http://www.rfc-editor.org/info/rfc3339>.

   [RFC3393]  Demichelis, C. and P. Chimento, "IP Packet Delay Variation
              Metric for IP Performance Metrics (IPPM)", RFC 3393,
              DOI 10.17487/RFC3393, November 2002,
              <http://www.rfc-editor.org/info/rfc3393>.

   [RFC3432]  Raisanen, V., Grotefeld, G., and A. Morton, "Network
              performance measurement with periodic streams", RFC 3432,
              DOI 10.17487/RFC3432, November 2002,
              <http://www.rfc-editor.org/info/rfc3432>.






Morton & Mathis            Expires May 3, 2017                 [Page 16]


Internet-Draft           Initial Registry Part 2            October 2016


   [RFC4737]  Morton, A., Ciavattone, L., Ramachandran, G., Shalunov,
              S., and J. Perser, "Packet Reordering Metrics", RFC 4737,
              DOI 10.17487/RFC4737, November 2006,
              <http://www.rfc-editor.org/info/rfc4737>.

   [RFC5357]  Hedayat, K., Krzanowski, R., Morton, A., Yum, K., and J.
              Babiarz, "A Two-Way Active Measurement Protocol (TWAMP)",
              RFC 5357, DOI 10.17487/RFC5357, October 2008,
              <http://www.rfc-editor.org/info/rfc5357>.

   [RFC5905]  Mills, D., Martin, J., Ed., Burbank, J., and W. Kasch,
              "Network Time Protocol Version 4: Protocol and Algorithms
              Specification", RFC 5905, DOI 10.17487/RFC5905, June 2010,
              <http://www.rfc-editor.org/info/rfc5905>.

   [RFC6020]  Bjorklund, M., Ed., "YANG - A Data Modeling Language for
              the Network Configuration Protocol (NETCONF)", RFC 6020,
              DOI 10.17487/RFC6020, October 2010,
              <http://www.rfc-editor.org/info/rfc6020>.

   [RFC6049]  Morton, A. and E. Stephan, "Spatial Composition of
              Metrics", RFC 6049, DOI 10.17487/RFC6049, January 2011,
              <http://www.rfc-editor.org/info/rfc6049>.

   [RFC6673]  Morton, A., "Round-Trip Packet Loss Metrics", RFC 6673,
              DOI 10.17487/RFC6673, August 2012,
              <http://www.rfc-editor.org/info/rfc6673>.

   [RFC6991]  Schoenwaelder, J., Ed., "Common YANG Data Types",
              RFC 6991, DOI 10.17487/RFC6991, July 2013,
              <http://www.rfc-editor.org/info/rfc6991>.

   [RFC7679]  Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton,
              Ed., "A One-Way Delay Metric for IP Performance Metrics
              (IPPM)", STD 81, RFC 7679, DOI 10.17487/RFC7679, January
              2016, <http://www.rfc-editor.org/info/rfc7679>.

   [RFC7680]  Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton,
              Ed., "A One-Way Loss Metric for IP Performance Metrics
              (IPPM)", STD 82, RFC 7680, DOI 10.17487/RFC7680, January
              2016, <http://www.rfc-editor.org/info/rfc7680>.

8.2.  Informative References

   [Brow00]   Brownlee, N., "Packet Matching for NeTraMet
              Distributions", March 2000.





Morton & Mathis            Expires May 3, 2017                 [Page 17]


Internet-Draft           Initial Registry Part 2            October 2016


   [RFC1242]  Bradner, S., "Benchmarking Terminology for Network
              Interconnection Devices", RFC 1242, DOI 10.17487/RFC1242,
              July 1991, <http://www.rfc-editor.org/info/rfc1242>.

   [RFC3611]  Friedman, T., Ed., Caceres, R., Ed., and A. Clark, Ed.,
              "RTP Control Protocol Extended Reports (RTCP XR)",
              RFC 3611, DOI 10.17487/RFC3611, November 2003,
              <http://www.rfc-editor.org/info/rfc3611>.

   [RFC4148]  Stephan, E., "IP Performance Metrics (IPPM) Metrics
              Registry", BCP 108, RFC 4148, DOI 10.17487/RFC4148, August
              2005, <http://www.rfc-editor.org/info/rfc4148>.

   [RFC4566]  Handley, M., Jacobson, V., and C. Perkins, "SDP: Session
              Description Protocol", RFC 4566, DOI 10.17487/RFC4566,
              July 2006, <http://www.rfc-editor.org/info/rfc4566>.

   [RFC5472]  Zseby, T., Boschi, E., Brownlee, N., and B. Claise, "IP
              Flow Information Export (IPFIX) Applicability", RFC 5472,
              DOI 10.17487/RFC5472, March 2009,
              <http://www.rfc-editor.org/info/rfc5472>.

   [RFC5477]  Dietz, T., Claise, B., Aitken, P., Dressler, F., and G.
              Carle, "Information Model for Packet Sampling Exports",
              RFC 5477, DOI 10.17487/RFC5477, March 2009,
              <http://www.rfc-editor.org/info/rfc5477>.

   [RFC5481]  Morton, A. and B. Claise, "Packet Delay Variation
              Applicability Statement", RFC 5481, DOI 10.17487/RFC5481,
              March 2009, <http://www.rfc-editor.org/info/rfc5481>.

   [RFC6248]  Morton, A., "RFC 4148 and the IP Performance Metrics
              (IPPM) Registry of Metrics Are Obsolete", RFC 6248,
              DOI 10.17487/RFC6248, April 2011,
              <http://www.rfc-editor.org/info/rfc6248>.

   [RFC6390]  Clark, A. and B. Claise, "Guidelines for Considering New
              Performance Metric Development", BCP 170, RFC 6390,
              DOI 10.17487/RFC6390, October 2011,
              <http://www.rfc-editor.org/info/rfc6390>.

   [RFC6703]  Morton, A., Ramachandran, G., and G. Maguluri, "Reporting
              IP Network Performance Metrics: Different Points of View",
              RFC 6703, DOI 10.17487/RFC6703, August 2012,
              <http://www.rfc-editor.org/info/rfc6703>.






Morton & Mathis            Expires May 3, 2017                 [Page 18]


Internet-Draft           Initial Registry Part 2            October 2016


   [RFC6776]  Clark, A. and Q. Wu, "Measurement Identity and Information
              Reporting Using a Source Description (SDES) Item and an
              RTCP Extended Report (XR) Block", RFC 6776,
              DOI 10.17487/RFC6776, October 2012,
              <http://www.rfc-editor.org/info/rfc6776>.

   [RFC6792]  Wu, Q., Ed., Hunt, G., and P. Arden, "Guidelines for Use
              of the RTP Monitoring Framework", RFC 6792,
              DOI 10.17487/RFC6792, November 2012,
              <http://www.rfc-editor.org/info/rfc6792>.

   [RFC7003]  Clark, A., Huang, R., and Q. Wu, Ed., "RTP Control
              Protocol (RTCP) Extended Report (XR) Block for Burst/Gap
              Discard Metric Reporting", RFC 7003, DOI 10.17487/RFC7003,
              September 2013, <http://www.rfc-editor.org/info/rfc7003>.

   [RFC7594]  Eardley, P., Morton, A., Bagnulo, M., Burbridge, T.,
              Aitken, P., and A. Akhter, "A Framework for Large-Scale
              Measurement of Broadband Performance (LMAP)", RFC 7594,
              DOI 10.17487/RFC7594, September 2015,
              <http://www.rfc-editor.org/info/rfc7594>.

Authors' Addresses

   Al Morton
   AT&T Labs
   200 Laurel Avenue South
   Middletown,, NJ  07748
   USA

   Phone: +1 732 420 1571
   Fax:   +1 732 368 1192
   Email: acmorton@att.com
   URI:   http://home.comcast.net/~acmacm/


   Matt Mathis
   Google

   Email: mattmathis@google.com











Morton & Mathis            Expires May 3, 2017                 [Page 19]