Network Working Group W. Sun Internet-Draft SJTU Intended status: Standards Track T. Nadeau Expires: January 3, 2012 Lucidvision M. Morrow Cisco Systems G. Zhang CATR W. Hu SJTU July 2, 2011 Label Switched Path (LSP) Provisioning Performance Management Information Base for Generalized MPLS (GMPLS) / MPLS-TE networks draft-sun-ccamp-gmpls-perf-mib-00.txt Abstract This memo defines Management Information Bases (MIBs) for performances of provisioning Label Switched Paths (LSPs) in Generalized MPLS or MPLS-TE networks. When Generalized MPLS/MPLS-TE is used to provision LSPs, it is useful to record the performance of the provisioning process, such as the delay in creating and deleting the LSPs. The managed information may be retrieved by the Management System and visualized on the GUI, so that the performance of dynamic provisioning may be monitored in a timely manner. This work is a continuation of the work in [RFC5814] and [I-D.ietf-ccamp-dpm], where the provisioning performance values are obtained through active measurements. 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." Sun, et al. Expires January 3, 2012 [Page 1] Internet-Draft LSP Performance MIB July 2011 This Internet-Draft will expire on January 3, 2012. Copyright Notice Copyright (c) 2011 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English. Sun, et al. Expires January 3, 2012 [Page 2] Internet-Draft LSP Performance MIB July 2011 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Conventions Used in This Document . . . . . . . . . . . . . . 5 3. The Internet-Standard Management Framework . . . . . . . . . . 6 4. Brief Description of LSP performance MIB Objects . . . . . . . 7 4.1. gmplsPerfMaxEntries . . . . . . . . . . . . . . . . . . . 7 4.2. gmplsPerfTunnelConfigured . . . . . . . . . . . . . . . . 7 4.3. gmplsPerfTable . . . . . . . . . . . . . . . . . . . . . . 7 5. GMPLS Performance MIB Module . . . . . . . . . . . . . . . . . 8 6. References . . . . . . . . . . . . . . . . . . . . . . . . . . 15 6.1. Normative References . . . . . . . . . . . . . . . . . . . 15 6.2. Informative References . . . . . . . . . . . . . . . . . . 15 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 16 Sun, et al. Expires January 3, 2012 [Page 3] Internet-Draft LSP Performance MIB July 2011 1. Introduction When Label Switched Paths (LSPs) are provisioned dynamically within an operational network, it is helpful to monitor and record the related performance information, such as the experienced provisioning delay and error events. Such information may help operators to ensure correct operation of dynamic LSP provisioning in their network, or possibly identify performance degradation in the control plane. This memo defines a set of objects that can reveal the performance of an operational network in terms of dynamic LSP provisioning. It is intended to complement the performance objects, such as the number of packets received and sent, per LSP tunnel, in [RFC3812] and [RFC4802]. Unlike the work in [RFC5814] and [I-D.ietf-ccamp-dpm], where the performance values are obtained through active measurements, this document focuses on the performance values in operational environments. The actual value of the performance in this document is recorded only when an LSP is provisioned, and is thus collected passively. Hence such information reflects only the performance at specific and discrete times. However, when properly used, they can be helpful in identifying performance degradation, or even malfunctioning, in the network control plane. Sun, et al. Expires January 3, 2012 [Page 4] Internet-Draft LSP Performance MIB July 2011 2. Conventions Used in This Document 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 [RFC2119]. Sun, et al. Expires January 3, 2012 [Page 5] Internet-Draft LSP Performance MIB July 2011 3. The Internet-Standard Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of [RFC3410]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, RFC 2578[RFC2578], STD 58, RFC 2579[RFC2579] and STD 58, RFC 2580[RFC2580]. Sun, et al. Expires January 3, 2012 [Page 6] Internet-Draft LSP Performance MIB July 2011 4. Brief Description of LSP performance MIB Objects 4.1. gmplsPerfMaxEntries Defines the maximum number of rows stored in the gmplsPerfTable. An implementation MUST start assigning gmplsPerfEntryIndex values at 1 and wrap after exceeding the maximum possible value, as defined by the limit of this object. 4.2. gmplsPerfTunnelConfigured Defines the The total number of tunnels configured. 4.3. gmplsPerfTable The performance of past LSP provisioning process is stored in this table. To handle possible provisioning failures, start and complete timestamp of a provisioning operation is recorded. For example, for LSP creation process, the timestamps of creation initiation and completion are recorded seperatly. It is up to the users to determine the actual performance value, or identify a possible creation/deletion failure. The maximum number of entries stored in this table is determined by the value of gmplsPerfMaxEntries. Sun, et al. Expires January 3, 2012 [Page 7] Internet-Draft LSP Performance MIB July 2011 5. GMPLS Performance MIB Module GMPLS-PROV-PERF-STD-MIB DEFINITIONS ::= BEGIN IMPORTS gmplsTeStdMIB FROM GMPLS-TE-STD-MIB mplsStdMIB, MplsTunnelIndex, MplsExtendedTunnelId FROM MPLS-TC-STD-MIB -- RFC 3811 TimeStamp FROM SNMPv2-TC MODULE-IDENTITY, OBJECT-TYPE, Gauge32, Unsigned32 FROM SNMPv2-SMI OBJECT-GROUP FROM SNMPv2-CONF; gmplsPerfMIB MODULE-IDENTITY LAST-UPDATED "201104180654Z" -- Apr 18, 2011 6:54:00 AM ORGANIZATION "IETF Common Control and Measurement Plane Working Group" CONTACT-INFO "Weiqiang Sun Shanghai Jiao Tong University (SJTU) Email: sunwq@mit.edu Thomas D. Nadeau Email: thomas.nadeau@huawei.com" DESCRIPTION "Copyright (C) The Internet Society (2011). This version of this MIB module is part of RFC XXX; see the RFC itself for full legal notices. This MIB module defines managed object definitions for dynamic LSP provisioning." REVISION "201104180654Z" -- Apr 18, 2011 6:54:00 AM DESCRIPTION "Initial version." -- 1.3.6.1.2.1.10.166.13.1 ::= { gmplsTeStdMIB 1 } gmplsPerfTunnelConfigured OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current Sun, et al. Expires January 3, 2012 [Page 8] Internet-Draft LSP Performance MIB July 2011 DESCRIPTION "The total number of tunnels configured." -- 1.3.6.1.2.1.10.166.13.1.3 ::= { gmplsPerfMIB 3 } gmplsPerfMaxEntries OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "An implementation MUST start assigning gmplsPerfEntryIndex values at 1 and wrap after exceeding the maximum possible value, as defined by the limit of this object. A value of 0 for this object disables creation of gmplsPerfEntry." -- 1.3.6.1.2.1.10.166.13.1.2 ::= { gmplsPerfMIB 2 } --Performance Table gmplsPerfTable OBJECT-TYPE SYNTAX SEQUENCE OF GmplsPerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines a table for storing the results of LSP provisioning operations. It allows the provisioning performance be retrieved later for monitoring or diagnostic purposes. The recorded performance information is intended to complement the existing performance statistics in the MPLS-TE-STD-MIB and GMPLS-TE-STD-MIB. Note that the creation and tear-down operation performances are stored in one table, ie., gmplsPerfTable. When an LSP tunnel creation operation is initiated, an entry MUST be added in this table and Tunnel ID as well as the time of initiation MUST be recorded. Upon completion of the creation process, ie., a positive signaling feedback is received by the ingress LSR, this complete time object in this entry MUST be updated. When an LSP tunnel deletion process is initiated, the corresponding entry with the same tunnel ID MUST be located and updated with time of the deletion initiation time. When the deletion operation is complete, the entry MUST again Sun, et al. Expires January 3, 2012 [Page 9] Internet-Draft LSP Performance MIB July 2011 be updated with the completion time. Under circumstances that the creation or deletion operation may fail, an entry may be partially updated. Eg., when a creation operation timeouts without a positive signaling feedback, the creation completion time may never be updated. When a tear-down operation is caused by nodes other than the Ingress LSR, the tear-down start time may not be known to the ingress LSR. In such cases, the user of the MIB MUST be aware of such events and treat the performance information accordingly. The number of entries in this table is limited by the value of the corresponding gmplsPerfMaxEntries object. An implementation MUST start assigning gmplsPerfEntryIndex at 1 and wrap after exceeding the maximum possible value, as defined by the limit of gmplsPerfMaxEntries. An implementation of this MIB will remove the oldest entry in the gmplsPerfTable to allow the addition of a new entry once the number of rows in the gmplsPerfTable reaches the value specified by gmplsPerfMaxEntries." -- 1.3.6.1.2.1.10.166.13.1.1 ::= { gmplsPerfMIB 1 } gmplsPerfEntry OBJECT-TYPE SYNTAX GmplsPerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines an entry in the gmplsPerfTable. An entry can be created when an LSP tunnel is signaled. An implementation of this MIB MAY choose to disable the creation of performance entry, when an LSP is provisioned through SNMP." INDEX { gmplsPerfEntryIndex, gmplsPerfTunnelID } -- 1.3.6.1.2.1.10.166.13.1.1.1 ::= { gmplsPerfTable 1 } GmplsPerfEntry ::= SEQUENCE { gmplsPerfEntryIndex Gauge32, gmplsPerfTunnelID MplsTunnelIndex, gmplsPerfCurrentStatus INTEGER, gmplsPerfSrcID MplsExtendedTunnelId, Sun, et al. Expires January 3, 2012 [Page 10] Internet-Draft LSP Performance MIB July 2011 gmplsPerfDstID MplsExtendedTunnelId, gmplsPerfCreateStartTime TimeStamp, gmplsPerfCreateCompleteTime TimeStamp, gmplsPerfDeleteStartTime TimeStamp, gmplsPerfDeleteCompleteTime TimeStamp } gmplsPerfEntryIndex OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index of the performance entry. The number of entries in this table is limited by the value of the corresponding gmplsPerfMaxEntries object. An implementation MUST start assigning gmplsPerfEntryIndex at 1 and wrap after exceeding the maximum possible value, as defined by the limit of gmplsPerfMaxEntries. An implementation of this MIB will remove the oldest entry in the gmplsPerfTable to allow the addition of an new entry once the number of rows in the gmplsPerfTable reaches the value specified by gmplsPerfMaxEntries." -- 1.3.6.1.2.1.10.166.13.1.1.1.1 ::= { gmplsPerfEntry 1 } gmplsPerfTunnelID OBJECT-TYPE SYNTAX MplsTunnelIndex MAX-ACCESS read-create STATUS current DESCRIPTION "The ID of the tunnel being provisioned." REFERENCE "RFC 3812" -- 1.3.6.1.2.1.10.166.13.1.1.1.2 ::= { gmplsPerfEntry 2 } gmplsPerfCurrentStatus OBJECT-TYPE SYNTAX INTEGER { CreationInProgress(0), Up(1), DeletionInProgress(2), Deleted(3) } MAX-ACCESS read-create STATUS current DESCRIPTION "This object defines the current status of the LSP tunnel. Sun, et al. Expires January 3, 2012 [Page 11] Internet-Draft LSP Performance MIB July 2011 CreationInProgress The corresponding LSP tunnel is being created, but the creation operation has not finished yet. Up The corresponding LSP tunnel has been created successfully. DeletionInProgress The corresponding LSP tunnel is being deleted, but the deletion process has not finished yet. Deleted The corresponding LSP tunnel has been deleted." -- 1.3.6.1.2.1.10.166.13.1.1.1.3 ::= { gmplsPerfEntry 3 } gmplsPerfSrcID OBJECT-TYPE SYNTAX MplsExtendedTunnelId MAX-ACCESS read-create STATUS current DESCRIPTION "The address of the ingress LSR ID." -- 1.3.6.1.2.1.10.166.13.1.1.1.5 ::= { gmplsPerfEntry 5 } gmplsPerfDstID OBJECT-TYPE SYNTAX MplsExtendedTunnelId MAX-ACCESS read-create STATUS current DESCRIPTION "The address of the egress LSR ID." -- 1.3.6.1.2.1.10.166.13.1.1.1.6 ::= { gmplsPerfEntry 6 } gmplsPerfCreateStartTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-create STATUS current DESCRIPTION "The time when the tunnel setup operation is initiated." -- 1.3.6.1.2.1.10.166.13.1.1.1.7 ::= { gmplsPerfEntry 7 } Sun, et al. Expires January 3, 2012 [Page 12] Internet-Draft LSP Performance MIB July 2011 gmplsPerfCreateCompleteTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-create STATUS current DESCRIPTION "The time when the LSP tunnel create operation is complete." -- 1.3.6.1.2.1.10.166.13.1.1.1.8 ::= { gmplsPerfEntry 8 } gmplsPerfDeleteStartTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-create STATUS current DESCRIPTION "The time when the LSP Tunnel tear-down operation is initiated." -- 1.3.6.1.2.1.10.166.13.1.1.1.9 ::= { gmplsPerfEntry 9 } gmplsPerfDeleteCompleteTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-create STATUS current DESCRIPTION "The time when an LSP tear-down operation is complete." -- 1.3.6.1.2.1.10.166.13.1.1.1.10 ::= { gmplsPerfEntry 10 } gmplsPerfGroups OBJECT IDENTIFIER -- 1.3.6.1.2.1.10.166.13.1.4 ::= { gmplsPerfMIB 4 } gmplsDeletionGroup OBJECT-GROUP OBJECTS { gmplsPerfTunnelID, gmplsPerfCurrentStatus, gmplsPerfSrcID, gmplsPerfDstID, gmplsPerfDeleteStartTime, gmplsPerfDeleteCompleteTime } STATUS current DESCRIPTION "The group of object that constitute the LSP tunnel Sun, et al. Expires January 3, 2012 [Page 13] Internet-Draft LSP Performance MIB July 2011 deletion performance." -- 1.3.6.1.2.1.10.166.13.1.4.1 ::= { gmplsPerfGroups 1 } gmplsCreationGroup OBJECT-GROUP OBJECTS { gmplsPerfTunnelID, gmplsPerfCurrentStatus, gmplsPerfSrcID, gmplsPerfDstID, gmplsPerfCreateStartTime, gmplsPerfCreateCompleteTime } STATUS current DESCRIPTION "The group of object that constitute the LSP tunnel creation performance." -- 1.3.6.1.2.1.10.166.13.1.4.2 ::= { gmplsPerfGroups 2 } gmplsPerfBasicGroup OBJECT-GROUP OBJECTS { gmplsPerfEntryIndex, gmplsPerfTunnelID, gmplsPerfMaxEntries, gmplsPerfCurrentStatus, gmplsPerfCreateStartTime, gmplsPerfCreateCompleteTime, gmplsPerfDeleteStartTime, gmplsPerfDeleteCompleteTime, gmplsPerfDstID, gmplsPerfSrcID, gmplsPerfTunnelConfigured, gmplsPerfErrThreshold } STATUS current DESCRIPTION "Basic objects." -- 1.3.6.1.2.1.10.166.13.1.4.3 ::= { gmplsPerfGroups 3 } END Sun, et al. Expires January 3, 2012 [Page 14] Internet-Draft LSP Performance MIB July 2011 6. References 6.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999. [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, December 2002. [RFC3812] Srinivasan, C., Viswanathan, A., and T. Nadeau, "Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) Management Information Base (MIB)", RFC 3812, June 2004. [RFC4802] Nadeau, T. and A. Farrel, "Generalized Multiprotocol Label Switching (GMPLS) Traffic Engineering Management Information Base", RFC 4802, February 2007. 6.2. Informative References [I-D.ietf-ccamp-dpm] Sun, W. and G. Zhang, "Label Switched Path (LSP) Data Path Delay Metrics in Generalized MPLS/ MPLS-TE Networks", draft-ietf-ccamp-dpm-03 (work in progress), May 2011. [RFC5814] Sun, W. and G. Zhang, "Label Switched Path (LSP) Dynamic Provisioning Performance Metrics in Generalized MPLS Networks", RFC 5814, March 2010. Sun, et al. Expires January 3, 2012 [Page 15] Internet-Draft LSP Performance MIB July 2011 Authors' Addresses Weiqiang Sun Shanghai Jiao Tong University 800 Dongchuan Road Shanghai 200240 China Phone: +86 21 3420 5359 Email: sunwq@mit.edu Thomas D. Nadeau Lucidvision Email: tnadeau@lucidvision.com Monique Morrow Cisco Systems Richistrasse 7 CH-8304 Zurich-Wallisellen Switzerland Phone: +41 44 878 9412 Email: mmorrow@cisco.com Guoying Zhang China Academy of Telecommunication Research,MII. No.52 Hua Yuan Bei Lu,Haidian District Beijing 100083 China Phone: +86-1062300106 Email: zhangguoying@mail.ritt.com.cn Weisheng Hu Shanghai Jiao Tong University 800 Dongchuan Road Shanghai 200240 China Phone: +86 21 3420 5419 Email: wshu@sjtu.edu.cn Sun, et al. Expires January 3, 2012 [Page 16]