<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="3"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<rfc category="info" docName="draft-morton-lmap-examples-01" ipr="trust200902"
     updates="">
  <front>
    <title abbrev="LMAP Examples of IPPM">Examples of LMAP Objects using IPPM
    Metrics and Protocols</title>

    <author fullname="Al Morton" initials="A." surname="Morton">
      <organization>AT&amp;T Labs</organization>

      <address>
        <postal>
          <street>200 Laurel Avenue South</street>

          <city>Middletown</city>

          <region>NJ</region>

          <code>07748</code>

          <country>USA</country>
        </postal>

        <phone>+1 732 420 1571</phone>

        <facsimile>+1 732 368 1192</facsimile>

        <email>acmorton@att.com</email>

        <uri>http://home.comcast.net/~acmacm/</uri>
      </address>
    </author>

    <date day="21" month="March" year="2016"/>

    <abstract>
      <t>In order to examine the completeness and coverage of the LMAP info
      and data models, we present examples expressing information from IP
      Performance Metric working group metrics and protocols, and the
      Performance Metrics Registry. The main update in the version provides a
      more realistic and useful example of the Cycle_ID in measurement
      instruction and reporting.</t>
    </abstract>

    <note title="Requirements Language">
      <t>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 <xref
      target="RFC2119">RFC 2119</xref>.</t>
    </note>
  </front>

  <middle>
    <section title="Introduction">
      <t>The Large-scale Measurement of Broadband Performance (LMAP) working
      group has completed a Framework <xref target="RFC7594"/> and Use cases,
      and now proceeds with development of an information model <xref
      target="I-D.ietf-lmap-information-model"/> and data model.</t>

      <t>The IETF IP Performance Metrics (IPPM) working group first created a
      framework for metric development in <xref target="RFC2330"/>. This
      framework has largely stood the test of time and enabled development of
      many fundamental metrics. It has been updated once in the area of metric
      composition <xref target="RFC5835"/>, and again in several areas related
      to active stream measurement of modern networks with reactive
      propoerties <xref target="RFC7312"/>. The Working Group has developed an
      extensive set of Standards Track Metrics and Measurment Protocols. Among
      the work especially relevant to LMAP is the development of a Performance
      Metrics Registry <xref target="I-D.ietf-ippm-metric-registry"/>, and a
      proposal for the initial regsitry contents <xref
      target="I-D.morton-ippm-initial-registry"/>.</t>

      <t>This memo is orgainzed into sections that present an example of LMAP
      Control and Reporting by populating the various information model
      objects for measurement Tasks and Reporting Tasks (and eventually
      Schedule, Event, Action, etc).</t>

      <t>The first example is a UDP Round Trip Latency Metric.</t>
    </section>

    <section title="Scope and Purpose">
      <t>The purpose of this memo is to examine the features and capabilities
      of the LMAP information model <xref
      target="I-D.ietf-lmap-information-model"/> by populating the models with
      example data intended to enable measurement of IPPM metrics.</t>

      <t>The scope is to create the examples for Active Metrics and their
      Methods of Measurement, as defined in the IPPM literature of Standards
      Track Metrics. Specifically, Metrics in the proposed initial contents
      for the Performance Metrics Registry <xref
      target="I-D.ietf-ippm-metric-registry"/> contined in <xref
      target="I-D.ietf-ippm-metric-registry"/> are the primary focus, along
      with existing standards track measurement protocols developed in IPPM
      <xref target="RFC4656"/> <xref target="RFC5357"/>.</t>
    </section>

    <section title="UDP Round Trip Latency">
      <t>This draft presents information in a conceptual form. Safeguarding
      correct syntax is a collosal non-goal in the early drafts.</t>

      <section title="Measurement Task Capabilities">
        <t><figure>
            <artwork><![CDATA[Example:
Measurement Capability [
   Measurement Protocol [
       Protocol Roles [ ]
   ]
   Registry URI  [
       Method Roles [ ]
   ]
]
so, an example would be

Measurement Capability [
    TWAMP [
       Control-Client; Session-Sender; Server; Session-Reflector;
       ]
    Prefix:Act_IP_UDP_Round-trip_Delay_95th-percentile_Poisson [
       Src; Dst;
    ... more URIs and Roles ...
       ]
]
for a fully-capable MA.
]]></artwork>
          </figure></t>
      </section>

      <section title="Instruction Object">
        <t><figure>
            <artwork><![CDATA[3.3.1.  Definition of ma-instruction-obj
     object {
         ma-task-obj         ma-instruction-tasks<0..*>;
            name:UDP_RT_Metrics_001;
         ma-channel-obj      ma-report-channels<0..*>;
         ma-schedule-obj     ma-instruction-schedules<0..*>;
         ma-suppression-obj  ma-suppression;
     } ma-instruction-obj;
]]></artwork>
          </figure></t>
      </section>

      <section title="Measurement Task">
        <t><figure>
            <artwork><![CDATA[3.9.1.  Definition of ma-task-obj
     object {
         string              ma-task-name;
           task-name: UDP_RT_Metrics_001;
         uri                 ma-task-registry-entries<1..*>;
           Prefix: Act_IP_UDP_Round-trip_Delay_95th-percentile_Poisson;
           Prefix: Act_IP_UDP_Round-trip_Delay_Mean_Poisson;
        [ma-option-obj       ma-task-options<0..*>];
           option-role: Src;  option-meas_point: mp100;
           option-measurement_protocol: TWAMP;
           option-meas_protocol_roles: Control-Client; Session-Sender;
           option-Src_IP: xxx.xxx.xxx;
           option-Dst_IP: xxx.xxx.xxx;
           option-T0:  0;  option-lambda: 1 second;
           option-Tf:  15 min; option-truncate: 30 seconds;
        [boolean             ma-task-suppress-by-default;]
           suppress: true;
        [string              ma-task-cycle-id;]
           cycle-id: Access_2016-03-21-0930;
     } ma-task-obj;

Prefix = urn:ietf:params:performance:metric
]]></artwork>
          </figure></t>
      </section>

      <section title="Report">
        <t><figure>
            <artwork><![CDATA[3.6.1.  Definition of ma-report-obj

     object {
         datetime            ma-report-date;
        [uuid                ma-report-agent-id;]
        [string              ma-report-group-id;]
        [ma-report-task-obj  ma-report-tasks<0..*>];
            name:UDP_RT_Metrics_REPORT_001;
     } ma-report-obj;
]]></artwork>
          </figure></t>
      </section>

      <section title="Report Task">
        <t><figure>
            <artwork><![CDATA[3.6.2.  Definition of ma-report-task-obj
     object {
         string              ma-report-task-name;
            task-name: UDP_RT_Metrics_REPORT_001;
        [uri                 ma-report-task-registry-entries<1..*>;]
           Prefix: Act_IP_UDP_Round-trip_Delay_95th-percentile_Poisson;
           Prefix: Act_IP_UDP_Round-trip_Delay_Mean_Poisson;
        [ma-option-obj       ma-report-task-options<0..*>];
           option-role: Src;  option-meas_point: mp100;
           option-measurement_protocol: TWAMP;
           option-meas_protocol_roles: Control-Client; Session-Sender;
           option-Src_IP: xxx.xxx.xxx;
           option-Dst_IP: xxx.xxx.xxx;
           option-T0:  0;
           option-Tf:  15 minutes;
        [ma-option-obj       ma-report-task-action-options<0..*>];
        [string              ma-report-task-cycle-id;]
           cycle-id: Access_2016-03-21-0930;
        [string              ma-report-task-column-labels<0..*>;]
           label: Mean; label: 95%-tile; 
        [ma-report-row-obj   ma-report-task-rows<0..*>;]
           row(0): 0.25; 0.34;
     } ma-report-task-obj; 
]]></artwork>
          </figure></t>
      </section>

      <section title="Schedule">
        <t>TBD</t>
      </section>
    </section>

    <section anchor="Security" title="Security Considerations">
      <t>The security considerations that apply to any active measurement of
      live paths are relevant here as well. See <xref target="RFC4656"/> and
      <xref target="RFC5357"/>.</t>

      <t>When considering privacy of those involved in measurement or those
      whose traffic is measured, the sensitive information available to
      potential observers is greatly reduced when using active techniques
      which are within this scope of work. Passive observations of user
      traffic for measurement purposes raise many privacy issues. We refer the
      reader to the privacy considerations described in the Large Scale
      Measurement of Broadband Performance (LMAP) Framework <xref
      target="RFC7594"/>, which covers active and passive techniques.</t>
    </section>

    <section anchor="IANA" title="IANA Considerations">
      <t>This memo makes no requests of IANA.</t>
    </section>

    <section anchor="Acknowledgements" title="Acknowledgements">
      <t>The author thanks LMAP Participants for their comments.</t>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      <?rfc include="reference.RFC.2119"?>

      <?rfc include='reference.RFC.2330'?>

      <?rfc include='reference.RFC.2679'?>

      <?rfc include='reference.RFC.3432'?>

      <?rfc include='reference.RFC.4656'?>

      <?rfc include='reference.RFC.5357'?>

      <?rfc include='reference.RFC.5835'?>

      <?rfc include='reference.RFC.6049'?>

      <?rfc include='reference.RFC.6576'?>

      <?rfc include='reference.RFC.6703'?>

      <?rfc include='reference.RFC.7312'?>
    </references>

    <references title="Informative References">
      <?rfc include='reference.RFC.6808'?>

      <?rfc include='reference.RFC.6985'?>

      <?rfc include='reference.RFC.3148'?>

      <?rfc include='reference.RFC.7594'?>

      <?rfc include='reference.I-D.ietf-ippm-metric-registry'?>

      <?rfc include='reference.I-D.morton-ippm-initial-registry'?>

      <?rfc include='reference.I-D.ietf-lmap-information-model'?>

      <reference anchor="IBD">
        <front>
          <title>The Illusion of Being Deterministic &ndash; Application-Level
          Considerations on Delay in 3G HSPA Networks</title>

          <author fullname="Joachim Fabini" initials="J.F." surname="Fabini">
            <!-- fullname="J.Fabini"-->

            <organization>Vienna University of Technology</organization>
          </author>

          <author fullname="Wolfgang Karner" initials="W.K." surname="Karner">
            <!-- fullname="W.Karner" -->

            <organization>Mobilkom Austria AG</organization>
          </author>

          <author fullname="Lukas Wallentin" initials="L.W."
                  surname="Wallentin">
            <!-- fullname="L.Wallentin" -->

            <organization>Vienna University of Technology</organization>
          </author>

          <author fullname="Thomas Baumgartner" initials="T.B."
                  surname="Baumgartner">
            <!-- fullname="T.Baumgartner" -->

            <organization>Mobilkom Austria AG</organization>
          </author>

          <date day="" month="May" year="2009"/>
        </front>

        <seriesInfo name="Lecture Notes in Computer Science,"
                    value=" Springer, Volume 5550, 2009, pp 301-312 "/>
      </reference>

      <reference anchor="IRR">
        <front>
          <title>The Importance of Being Really Random: Methodological Aspects
          of IP-Layer 2G and 3G Network Delay Assessment</title>

          <author fullname="Joachim Fabini" initials="J.F." surname="Fabini">
            <!-- fullname="J.Fabini" -->

            <organization>Vienna University of Technology</organization>
          </author>

          <author fullname="Lukas Wallentin" initials="L.W."
                  surname="Wallentin">
            <!-- fullname="L.Wallentin" -->

            <organization>Vienna University of Technology</organization>
          </author>

          <author fullname="Peter Reichl" initials="P.R." surname="Reichl">
            <!-- fullname="P.Reichl" -->

            <organization>Telecommunications Research Center Vienna,
            ftw</organization>
          </author>

          <date month="June" year="2009"/>
        </front>

        <seriesInfo name="ICC'09 Proceedings of the 2009 IEEE International Conference on Communications,"
                    value="doi: 10.1109/ICC.2009.5199514"/>
      </reference>

      <reference anchor="TSRC">
        <front>
          <title>Delay Measurement Methodology Revisited: Time-slotted
          Randomness Cancellation</title>

          <author fullname="Joachim Fabini et al." initials="J.F."
                  surname="Fabini">
            <!-- fullname="J.Fabini" -->

            <organization>Vienna University of Technology</organization>
          </author>

          <author fullname="Michael Abmayer" initials="M.A." surname="Abmayer">
            <!-- fullname="M.Abmayer" -->

            <organization>Vienna University of Technology</organization>
          </author>

          <date day="01" month="October" year="2013"/>
        </front>

        <seriesInfo name="IEEE Transactions on Instrumentation and Measurement"
                    value="doi:10.1109/TIM.2013.2263914"/>
      </reference>

      <reference anchor="RRC">
        <front>
          <title>Theory and Practice of RRC State Transitions in UMTS
          Networks</title>

          <author fullname="Pekka H.J. Per&auml;l&auml;" initials="P.H.J."
                  surname="Per&auml;l&auml;">
            <!-- fullname="P.Per?l?" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <author fullname="Antonio Barbuzzi" initials="A." surname="Barbuzzi">
            <!-- fullname="A.Barbuzzi" -->

            <organization>DEE - Politecnico di Bari</organization>
          </author>

          <author fullname="Gennaro Boggia" initials="G." surname="Boggia">
            <!-- fullname="G.Boggia" -->

            <organization>DEE - Politecnico di Bari</organization>
          </author>

          <author fullname="Kostas Pentikousis" initials="K."
                  surname="Pentikousis">
            <!-- fullname="K.Pentikousis" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <date day="30" month="November" year="2009"/>
        </front>

        <seriesInfo name="IEEE Globecom 2009 Workshops"
                    value="doi: 10.1109/GLOCOMW.2009.5360763"/>
      </reference>

      <reference anchor="EEAW">
        <front>
          <title>Empirical Evaluation of VoIP Aggregation over a Fixed WiMAX
          Testbed</title>

          <author fullname="Kostas Pentikousis" initials="K."
                  surname="Pentikousis">
            <!-- fullname="K.Pentikousis" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <author fullname="Esa Piri" initials="E." surname="Piri">
            <!-- fullname="E.Piri" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <author fullname="Jarno Pinola" initials="J." surname="Pinola">
            <!-- fullname="J.Pinola" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <author fullname="Frerk Fitzek" initials="F." surname="Fitzek">
            <!-- fullname="F.Fitzek" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <author fullname="Tuomas Nissil&auml;" initials="T."
                  surname="Nissil&auml;">
            <!-- fullname="T.Nissil?" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <author fullname="Ilkka Harjula" initials="I." surname="Harjula">
            <!-- fullname="I.Harjula" -->

            <organization>VTT Technical Research Centre of
            Finland</organization>
          </author>

          <date day="18" month="March" year="2008"/>
        </front>

        <seriesInfo name="Proceedings of the 4th International Conference on Testbeds and research infrastructures for the development of networks and communities (TridentCom '08)"
                    value="http://dl.acm.org/citation.cfm?id=1390599"/>
      </reference>

      <reference anchor="Mat98">
        <front>
          <title>Empirical Bulk Transfer Capacity</title>

          <author fullname="Matt Mathis" initials="M." surname="Mathis">
            <!-- fullname="M.Mathis" -->

            <organization>Pittsburgh Supercomputing Center</organization>
          </author>

          <date day="" month="December" year="1998"/>
        </front>

        <seriesInfo name="IP Performance Metrics Working Group report in Proceeding of the Forty Third Internet Engineering Task Force, Orlando, FL."
                    value="http://www.ietf.org/proceedings/98dec/slides/ippm-mathis-98dec.pdf"/>
      </reference>
    </references>
  </back>
</rfc>
