wdiff draft-ietf-ippm-metrics-registry-00.txt draft-ietf-ippm-metrics-registry-01.txt

Network Working Group E. Stephan

Internet Draft France Telecom R&D

Document: draft-ietf-ippm-metrics-registry-00.txt draft-ietf-ippm-metrics-registry-01.txt June 18, 24, 2002

IPPM metrics registry

Status of this Memo

This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC2026 [1].

Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that other
groups may also distribute working documents as Internet-Drafts.
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."

The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.

The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.

Abstract

This memo defines a registry of the IPPM working group metrics. It
provides an OBJECT IDENTIFIER to each metric currently standardized
by the IPPM WG. It defines the rules for the identification of the
metrics standardized in the future.

Table of Contents

1. Introduction................................................2
2. The IPPM Framework..........................................2
3. Overview....................................................2
4. IPPM metrics Registry framework.............................2
4.1. Metrics registry format.....................................3
4.2. Metrics specified in a RFC..................................3
4.2.
4.3. Metrics specified in a WG draft.............................4
4.3.
4.4. Metrics specified in other documents........................5
5. Initial IPPM registry.......................................5
6. References..................................................6 References.................................................12
7. Author's Addresses..........................................7 Addresses.........................................12

1. Introduction

2. The IPPM Framework

The IPPM Framework consists in four major components:

+ A general framework for defining performance metrics,
described in the Framework for IP Performance Metrics, RFC
2330;

+ A set of standardized metrics, which conform to this
framework. The IPPM Metrics for Measuring Connectivity, RFC 2678
[2]. The One-way Delay Metric for IPPM, RFC 2679 [3]. The One-
way Packet Loss Metric for IPPM, RFC 2680 [4]. The Round-trip
Delay Metric for IPPM, RFC 2681 [5];

+ Emerging metrics which are being specified in respect of this
framework;

+ The IPPM-REPORTING-MIB for reporting the results of the
measures and for interfacing heterogeneous measurement systems
with management entities.

3. Overview

This memo defines a registry of the current metrics and a framework
for the integration of the future metrics for the following reasons:

+ to permit metrics to be clearly referenced by MIBs or other
data models;

+ Metrics identifiers are needed to allow measurement
interoperability;

+ Specification of new metrics is a continuous process, special
care must be taken for the integration of the future
standardized metrics.

4. IPPM metrics Registry framework

MIBs need OBJECT INDENTIFIER to refer precisely to the standardized
metrics. The registry associates an OBJECT IDENTIFIER to each metric. As
an example onewayDelay oneWayDelay and onewayDelayPoissonStream oneWayDelayPoissonStream have different
identifiers.

The registry has three root branches. The category of the document
determines the node the branch the metric is identified in:

+ Metrics defined in a RFC are identified in the 'rfc' tree;
+ Metrics defined in a draft of a working group are identified in
the 'draft' tree;
+ Metrics defined elsewhere may be identified in the 'other' tree.
The name of the metric has to respect ASN.1 constraints. The name has to
start with a lower case. The letter - is forbidden (more or less) in the
name. In a way to preserve the readability of the metric name the
letters following a - are forced to upper case.

Sometime the name of the metric starts with 'Type-P'. It depends on the
document not the semantic of the metric. In the registry it is removed
from the name of the metric to reduce the length of the name and to
uniforms the metrics names.

Each sub-tree has specific rules to assign a node to a metric.

Each metrics specification will include a section describing its metrics
identifiers.

IPPM metrics are numbered using the specifications submissions order and
the metrics definitions order in each memo.

4.1. Metrics registry format

Each memo includes a registry where are identified the metrics. The name
of the section where is defined the registry terminate by 'metrics
registry'. The registry is defined using a MODULE-IDENTITY macro. Each
metric is identify in the registry using a OBJECT-IDENTITY macro. The
identification defines the metric name, status, reference and OBJECT
IDENTIFIER.

4.2. Metrics specified in a RFC

4.1.1.

4.2.1. Rules

The metrics specified in a RFC are registered in the node rfc(1).

They are numbered using the RFC order and the metrics definitions order
in each memo.

The value assigned to a metric is definitive and can not be reused.

4.1.2.

4.2.2. Current WG RFC integration in the registry

These rules are applied to initiate the registry. The metrics already
standardized are identified in the section 5 'IPPM metrics registry' of
this memo.

4.1.3. The registry definition should be respectful of the format
defined in "4.1 Metrics registry format".

4.2.3. Identification of the metrics standardized in future RFC

The specification of metrics is a continuous process. The same rules are
applied to number the metrics of the new RFC. The identifiers are
included in the section 'Standard metrics registry' of the RFC which
lists the identifier RFC.

The status of the metrics at the format 'metricName OBJECT
IDENTIFIER ::= { rfc <metricNode> }'

The temporary identifiers assigned previously to the draft
corresponding to the new RFC are considered obsolete set up to 'obsolete' and may not be
reassigned.

4.2.

4.3. Metrics specified in a WG draft

Usually, metrics are implemented during the specification process. At
this step, a metric is not identified as an IPPM metric. There is a need
to provide temporary metric identifiers to facilitate software
integration and to permit interoperability measurement among different
implementations. Otherwise the interoperability will be extremely
limited du to the fact that implementers will choose arbitrary values to
identify the new metrics.

4.2.1.

4.3.1. Rules

The metrics specified in an IPPM draft are registered in the node
draft(2).

A draft is more or less released two times a year. It looks ambiguous to
use the chronological order of the successive drafts submissions to
numbered the metrics because usually the metric name does not change
among the different releases. On the other hand new metrics may be added
in successive releases of a draft.

When a draft disappears the temporary identifiers assigned to the
metrics defined in the draft are considered obsolete and may be
reassigned.

4.2.2.

4.3.2. Current WG drafts integration in the registry

The current drafts are numbered using the submission orders of their
current release and using the order of the metrics definition in each
memo.

The previous rules are applied to initiate the registry. The metrics
specified in current WG drafts are identified in the section 5 'IPPM 'draft
metrics registry' of this memo.

4.2.3. The registry definition should be
respectful of the format defined in "4.1 Metrics registry format".

4.3.3. Identification of a metric added to an existing WG draft

Despite new metrics are rarely created in successive releases of a
draft, an arbitrary metric identifier may be provided by the IPPM WG to
identify the new metric.

The identifier is added in the section named 'Draft metrics registry' of
the draft. This section list the identifier The registry definition should be respectful of the metrics at the format
'draftMetricName OBJECT IDENTIFIER ::= { draft <metricNode> }'

4.2.4.
defined in "4.1 Metrics registry format".

4.3.4. Identification of the metrics defined in future WG drafts

They are numbered using the chronological orders of the first submission
of the draft and using the order of the metrics definition in each memo.

These identifiers are included in the draft in a section named 'Draft
metrics registry'. This section list The registry definition should be respectful of the identifier
format defined in "4.1 Metrics registry format".

The name of the metrics at metric starts with 'draft' to clearly distinguish the format 'draftMetricName
draft OBJECT IDENTIFIER ::= { INDENTIFIER from the its future standard OBJECT
INDENTIFIER.

Example:

Consider a IPPM WG draft <metricNode>
}'

4.3. that defines the multicast metric Type-P-
Multicast-Instantaneous-Hop-One-way-Delay.

The name of this metric in the section 'Draft metrics registry' is
'draftMulticastInstantaneousHopOneWayDelay'. When this draft will go to
RFC, the metric name will become 'multicastInstantaneousHopOneWayDelay'.

4.4. Metrics specified in other documents

Other metrics may be associated with identifiers in the sub tree
other(4). The identifiers are provided by the IPPM WG.

These identifiers are included in the corresponding document in a
section named 'IPPM registry identifiers'. This section list the
identifier The registry definition
should be respectful of the metrics at the format 'MetricName OBJECT IDENTIFIER
::= { other <metricNode> }' defined in "4.1 Metrics registry
format".

5. Initial IPPM registry

ippm OBJECT IDENTIFIER

IPPM-METRICS-REGISTRY DEFINITIONS ::= XXXX BEGIN

IMPORTS
MODULE-IDENTITY
FROM SNMPv2-SMI;

ippmMetricsRegistry MODULE-IDENTITY
LAST-UPDATED "200206241100Z" -- To be assigned June 24, 2002
ORGANIZATION "IPPM working Group"
CONTACT-INFO "ippm@advanced.org"
DESCRIPTION
" This memo defines a portion of the Management Information Base
(MIB) for use with network management protocols in TCP/IP-based
internets. In particular, it defines a registry of the IPPM working
group metrics."
REVISION "200206241100z"
DESCRIPTION
"Each metric identifier is defined in a OBJECT IDENTIFIER IDENTITY macro."
::= { ippm 1 }

--
-- ippm OBJECT IDENTIFIER ::= XXXX -- To be assigned
--

rfc OBJECT IDENTIFIER ::= { registry 1 }
draft OBJECT IDENTIFIER ::= { registry 2 }
other OBJECT IDENTIFIER ::= { registry 4 }

--
-- Registry of the metrics of the IPPM WG RFCs
--

--
-- RFC 2678 " IPPM Metrics for Measuring Connectivity"
--

instantaneousUnidirectionalConnectivity OBJECT IDENTIFIER::={rfc OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Instantaneous-Unidirectional-
Connectivity metric."
REFERENCE "RFC2678, section 2."
::={rfc 1}

instantaneousBidirectionalConnectivity OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Instantaneous-Bidirectional-
Connectivity metric."
REFERENCE "RFC2678, section 3."
::={rfc 2}

intervalUnidirectionalConnectivity OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Interval-Unidirectional-
Connectivity metric."
REFERENCE "RFC2678, section 4."
::= { rfc 3 }

intervalBidirectionalConnectivity OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Interval-Bidirectional-
Connectivity metric."
REFERENCE "RFC2678, section 5."
::= { rfc 4 }

intervalTemporalConnectivity OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P1-P2-Interval-Temporal-
Connectivity metric. "
REFERENCE "RFC2678, section 6."
Type-P-One-way-Delay
::= { rfc 5 }
onewayDelay OBJECT IDENTIFIER

--
-- RFC 2679 "A One-way Delay Metric for IPPM"
--

oneWayDelay OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Delay metric. "
REFERENCE "RFC2679, section 3."
::= { rfc 6 }
onewayDelayPoissonStream OBJECT IDENTIFIER

oneWayDelayPoissonStream OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Delay-Poisson-Stream
metric. "
REFERENCE "RFC2679, section 4"
::= { rfc 7 }
onewayDelayPercentile OBJECT IDENTIFIER

oneWayDelayPercentile OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Delay-Percentile metric."
REFERENCE "RFC2679, section 5.1."
::= { rfc 8 }
onewayDelayMedian OBJECT IDENTIFIER

oneWayDelayMedian OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Delay-Median metric."
REFERENCE "RFC2679, section 5.2."
::= { rfc 9 }
onewayDelayMinimum OBJECT IDENTIFIER

oneWayDelayMinimum OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Delay-Minimum metric. "
REFERENCE "RFC2679, section 5.3."
::= { rfc 10 }
onewayDelayInversePercentile OBJECT IDENTIFIER

oneWayDelayInversePercentile OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Delay-Inverse-Percentile
metric. "
REFERENCE "RFC2679, section 5.4."
::= { rfc 11 }
onewayPacketLoss OBJECT IDENTIFIER

--
-- RFC 2680 "One Way Packet Loss Metric for IPPM"
--

oneWayPacketLoss OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Packet-Loss metric."
REFERENCE "RFC2680, section 2."
::= { rfc 12 }
onewayPacketLossPoissonStream OBJECT IDENTIFIER

oneWayPacketLossPoissonStream OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Packet-Loss-Poisson-
Stream metric."
REFERENCE "RFC2680, section 3."
::= { rfc 13 }
onewayPacketLossAverage OBJECT IDENTIFIER

oneWayPacketLossAverage OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-One-way-Packet-Loss-Average
metric."
REFERENCE "RFC2680, section 4."
::= { rfc 14 }

--
-- RFC2681 "A Round-trip Delay Metric for IPPM"
--

roundtripDelay OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Round-trip-Delay metric."
REFERENCE " section 2 of the rfc2681."
::= { rfc 15 }

roundtripDelayPoissonStream OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Round-trip-Delay-Poisson-Stream
metric."
REFERENCE "RFC2681, section 4."
::= { rfc 16 }

roundtripDelayPercentile OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Round-trip-Delay-Percentile
metric."
REFERENCE "RFC2681, section 4.1."
::= { rfc 17 }

roundtripDelayMedian OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Round-trip-Delay-Median metric."
REFERENCE "RFC2681, section 4.2."
::= { rfc 18 }

roundtripDelayMinimum OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Round-trip-Delay-Minimum metric."
REFERENCE "RFC2681, section 4.3."
::= { rfc 19 }

roundtripDelayInversePercentile OBJECT IDENTIFIER OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The identifier for the Type-P-Round-trip-Inverse-Percentile
metric."
REFERENCE "RFC2681, section 4.4."
::= { rfc 20 }

--
-- Registry of the metrics of the IPPM WG drafts
--

--
-- One-way Loss Pattern Sample Metrics draft
--

oneWayLossDistanceStream OBJECT IDENTIFIER::={draft

draftOneWayLossDistanceStream OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-Way-Loss-Distance-
Stream metric."
REFERENCE "Work in progress"
::={draft 1}
oneWayLossPeriodStream OBJECT IDENTIFIER

draftOneWayLossPeriodStream OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-Way-Loss-Period-Stream
metric."
REFERENCE "Work in progress"
::={draft 2}
oneWayLossDistanceStream OBJECT IDENTIFIER ::= {

draftOneWayLossNoticeableRate OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft 3 }
oneWayLossPeriodStream OBJECT IDENTIFIER identifier for the Type-P-One-Way-Loss-Noticeable-
Rate metric."
REFERENCE "Work in progress"
::= { draft 4 3 }
oneWayLossDistanceStream OBJECT IDENTIFIER ::= {

draftOneWayLossPeriodTotal OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft 5 }
oneWayLossPeriodStream OBJECT IDENTIFIER identifier for the Type-P-One-Way-Loss-Period-Total
metric."
REFERENCE "Work in progress"
::= { draft 6 4 }
oneWayLossNoticeableRate OBJECT IDENTIFIER ::= {

draftOneWayLossPeriodLengths OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft 7 }
oneWayLossPeriodTotal OBJECT IDENTIFIER identifier for the Type-P-One-Way-Loss-Period-Lengths
metric."
REFERENCE "Work in progress"
::= { draft 8 5 }
oneWayLossPeriodLengths OBJECT IDENTIFIER ::= {

draftOneWayInterLossPeriodLengths OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft 9 }
oneWayInterLossPeriodLengths OBJECT IDENTIFIER identifier for the Type-P-One-Way-Inter-Loss-Period-
Lengths metric."
REFERENCE "Work in progress"
::= { draft 10 6 }

--
-- Network performance measurement with periodic streams draft
--

oneWayDelayPeriodicStream OBJECT IDENTIFIER

draftOneWayDelayPeriodicStream OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-way-Delay-Periodic-
Stream metric."
REFERENCE "Work in progress"
::= { draft 11 7 }

--
-- IP Packet Delay Variation Metrics draft
--

oneWayIpdv OBJECT IDENTIFIER

draftOneWayIpdv OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-way-ipdv metric."
REFERENCE "Work in progress"
::= { draft 12 8 }
oneWayIpdvPoissonStream OBJECT IDENTIFIER

draftOneWayIpdvPoissonStream OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-way-ipdv-Poisson-stream
metric."
REFERENCE "Work in progress"
::= { draft 13 9 }
oneWayIpdvPercentile OBJECT IDENTIFIER

draftOneWayIpdvPercentile OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-way-ipdv-percentile
metric."
REFERENCE "Work in progress"
::= { draft 14 10 }
oneWayIpdvJitter OBJECT IDENTIFIER

draftOneWayIpdvJitter OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-way-ipdv-jitter
metric."
REFERENCE "Work in progress"
::= { draft 15 11 }
oneWayPeakToPeakIpdv OBJECT IDENTIFIER

draftOneWayPeakToPeakIpdv OBJECT-IDENTITY
STATUS current
DESCRIPTION
"The draft identifier for the Type-P-One-way-peak-to-peak-ipdv
metric."
REFERENCE "Work in progress"
::= { draft 16 12 }

--
-- Metrics registry from other documents
--

END

6. References

[1] Bradner, S., "The Internet Standards Process -- Revision 3", BCP
9, RFC 2026, October 1996.

[2] Mahdavi J. and V. Paxson, "IPPM Metrics for Measuring
Connectivity", RFC 2678, September 1999.

[3] Almes, G., Kalidindi, S. and M. Zekauskas, "A One-way Delay
Metric for IPPM", RFC 2679, September 1999.

[4] Almes, G., Kalidindi, S. and M. Zekauskas, "A One-way Packet
Loss Metric for IPPM", RFC 2680, September 1999.

[5]Almes, G., Kalidindi, S. and M. Zekauskas, "A Round-trip Delay
Metric for IPPM.", RFC 2681, September 1999.

7. Author's Addresses

Emile STEPHAN
France Telecom R & D
2 avenue Pierre Marzin
F-22307 Lannion cedex
Phone: (+ 33) 2 96 05 11 11
Email: emile.stephan@francetelecom.com

Full Copyright Statement

This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it
or assist its implementation may be prepared, copied, published and
distributed, in whole or in part, without restriction of any kind,
provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process must be
followed, or as required to translate it into languages other than
English.

The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns.

This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.