home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-atommib-perfhistTC-01.txt < prev    next >
Text File  |  1996-10-30  |  13KB  |  592 lines
  1. INTERNET-DRAFT
  2. <draft-ietf-atommib-perfhistTC-01.txt>
  3.  
  4.  
  5.  
  6.  
  7.  
  8.           Textual Conventions for MIB Modules Using Performance History
  9.                            Based on 15 Minute Intervals
  10.  
  11.                                  October 24, 1996
  12.  
  13.  
  14.  
  15.                                Kaj Tesink  (editor)
  16.                            Bell Communications Research
  17.                                kaj@cc.bellcore.com
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.           1.  Status of this Memo
  25.  
  26.           This document is an Internet-Draft.  Internet-Drafts are
  27.           working documents of the Internet Engineering Task Force
  28.           (IETF), its Areas, and its Working Groups.  Note that other
  29.           groups may also distribute working documents as Internet-
  30.           Drafts.
  31.  
  32.           Internet-Drafts are draft documents valid for a maximum of six
  33.           months and may be updated, replaced, or obsoleted by other
  34.           documents at any time.  It is inappropriate to use Internet-
  35.           Drafts as reference material or to cite them other than as a
  36.           "work in progress".
  37.  
  38.           To learn the current status of any Internet-Draft, please
  39.           check the "1id-abstracts.txt" listing contained in the
  40.           Internet-Drafts Shadow Directories on ds.internic.net (US East
  41.           Coast), nic.nordu.net (Europe), ftp.isi.edu (US West Coast),
  42.           or munnari.oz.au (Pacific Rim).
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           draft      15 Minute Based Performance History TCs    10/24/96
  65.  
  66.  
  67.           2.  Introduction
  68.  
  69.           When designing a MIB module, it is often useful to define new
  70.           types similar to those defined in the SMI.  In comparison to a
  71.           type defined in the SMI, each of these new types has a
  72.           different name, a similar syntax, but a more precise
  73.           semantics.  These newly defined types are termed textual
  74.           conventions, and are used for the convenience of humans
  75.           reading the MIB module.  This is done through Textual
  76.           Conventions as defined in RFC1903[1].  It is the purpose of
  77.           this document to define the set of textual conventions to be
  78.           used when performance history based on 15 minute intervals is
  79.           kept. See for example the Trunk MIB modules [3][4][5].
  80.  
  81.           This memo does not specify a standard for the Internet
  82.           community.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.           Expires 4/24/97                                       [Page 2]
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           draft      15 Minute Based Performance History TCs    10/24/96
  124.  
  125.  
  126.           3.  Definitions
  127.  
  128.                PerfHist-TC-MIB DEFINITIONS ::= BEGIN
  129.  
  130.                IMPORTS
  131.                   MODULE-IDENTITY,
  132.                   Gauge32, experimental
  133.                       FROM SNMPv2-SMI
  134.                   TEXTUAL-CONVENTION
  135.                       FROM SNMPv2-TC
  136.                   mib-2
  137.                       FROM RFC1213-MIB;
  138.  
  139.  
  140.                perfHistTCMIB MODULE-IDENTITY
  141.                     LAST-UPDATED "9610241100Z"
  142.                     ORGANIZATION "IETF AToMMIB and TrunkMIB WGs"
  143.                     CONTACT-INFO
  144.                                  "Kaj Tesink
  145.                         Postal:  Bell Communications Research
  146.                                  331 Newman Springs Road
  147.                                  Red Bank, NJ 07701
  148.                                  USA
  149.                         Tel:     +1 908 758 5254
  150.                         Fax:     +1 908 758 4177
  151.                         E-mail:  kaj@cc.bellcore.com"
  152.                     DESCRIPTION
  153.                      "This MIB Module provides Textual Conventions
  154.                        to be used by systems supporting 15 minute
  155.                        based performance history counts."
  156.                     ::= { mib-2 xxx }
  157.  
  158.                               -- ****************************************
  159.                               -- * Note to RFC editor                   *
  160.                               -- * Assign a number for xxx              *
  161.                               -- * from IANA when publishing this       *
  162.                               -- * MIB as RFC                           *
  163.                               -- ****************************************
  164.  
  165.  
  166.  
  167.                -- The Textual Conventions defined below are organized
  168.                -- alphabetically
  169.  
  170.                -- Use of these TCs assumes the following:
  171.  
  172.  
  173.  
  174.  
  175.  
  176.           Expires 4/24/97                                       [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182.           draft      15 Minute Based Performance History TCs    10/24/96
  183.  
  184.  
  185.                -- 0  The agent supports 15 minute based history
  186.                --    counters.
  187.                -- 0  The agent is capable of keeping a history of n
  188.                --    intervals of 15 minute performance data. The
  189.                --    value of n is defined by the media-specific MIB
  190.                --    module but shall be 0 < n =< 96.
  191.                -- 0  The agent may optionally support performance
  192.                --    data aggregating the history intervals.
  193.                -- 0  The agent will keep separate tables for the
  194.                --    current interval, the history intervals, and
  195.                --    the total aggregates.
  196.                -- 0  The agent will keep the following objects per
  197.                --    interface:
  198.                --
  199.                -- xyzTimeElapsed OBJECT-TYPE
  200.                --       SYNTAX  INTEGER (0..899)
  201.                --       MAX-ACCESS  read-only
  202.                --       STATUS  current
  203.                --       DESCRIPTION
  204.                --       "The number of seconds that have elapsed since
  205.                --       the beginning of the current error-measurement
  206.                --       period."
  207.                --       ::= { xxx }
  208.  
  209.                -- xyzValidIntervals OBJECT-TYPE
  210.                --       SYNTAX  INTEGER (0..<n>)
  211.                --            -- 1 =< n =< 96
  212.                --       MAX-ACCESS  read-only
  213.                --       STATUS  current
  214.                --       DESCRIPTION
  215.                --       "The number of previous near end intervals
  216.                --       for which valid data was collected.  The value
  217.                --       will be <n> unless the interface was brought
  218.                --       online within the last 24 hours, in which case
  219.                --       the value will be the number of complete 15
  220.                --       minute near end intervals since the interface
  221.                --       has been online.  In the case where the agent
  222.                --       is a proxy, it is possible that some intervals
  223.                --       are unavailable.  In this case, this
  224.                --       interval is the maximum interval number for
  225.                --       which valid data is available."
  226.                --       ::= { xxx }
  227.  
  228.                -- xyzInvalidIntervals OBJECT-TYPE
  229.                --     SYNTAX  INTEGER (0..<n>)
  230.  
  231.  
  232.  
  233.  
  234.  
  235.           Expires 4/24/97                                       [Page 4]
  236.  
  237.  
  238.  
  239.  
  240.  
  241.           draft      15 Minute Based Performance History TCs    10/24/96
  242.  
  243.  
  244.                --     MAX-ACCESS  read-only
  245.                --     STATUS  current
  246.                --     DESCRIPTION
  247.                --       "The number of intervals for which no valid
  248.                --       data is available."
  249.                --       ::= { xxx }
  250.  
  251.                PerfCurrentCount ::= TEXTUAL-CONVENTION
  252.                      STATUS  current
  253.                      DESCRIPTION
  254.                         "A counter associated with interface
  255.                          performance measurements in a current 15
  256.                          minute measurement interval. The value
  257.                          of this counter start from zero and is
  258.                          increased when associated events occur,
  259.                          until the end of the 15 minute interval.
  260.                          At that time the value of the counter is
  261.                          stored in the first 15 minute history
  262.                          interval, and the CurrentCount is
  263.                          restarted at zero."
  264.                       SYNTAX  Gauge32
  265.  
  266.                PerfIntervalCount ::= TEXTUAL-CONVENTION
  267.                      STATUS  current
  268.                      DESCRIPTION
  269.                         "A counter associated with interface
  270.                          performance measurements in a previous
  271.                          15 minute measurement interval. In the
  272.                          case where the agent has no valid data
  273.                          available for a particular interval the
  274.                          corresponding object instance is not
  275.                          available and upon a retrieval request
  276.                          a corresponding error message (noSuch*)
  277.                          shall be returned. In a system supporting
  278.                          a history of n intervals with
  279.                          IntervalCount(1) and IntervalCount(n) the
  280.                          most and least recent intervals
  281.                          respectively, the following applies at
  282.                          the end of a 15 minute interval:
  283.                          - discard the value of IntervalCount(n)
  284.                          - the value of IntervalCount(i) becomes that
  285.                            of IntervalCount(i-1) for n >= i > 1
  286.                          - the value of IntervalCount(1) becomes that
  287.                            of CurrentCount
  288.                          - the TotalCount, if supported, is adjusted."
  289.  
  290.  
  291.  
  292.  
  293.  
  294.           Expires 4/24/97                                       [Page 5]
  295.  
  296.  
  297.  
  298.  
  299.  
  300.           draft      15 Minute Based Performance History TCs    10/24/96
  301.  
  302.  
  303.                       SYNTAX  Gauge32
  304.  
  305.                PerfTotalCount ::= TEXTUAL-CONVENTION
  306.                      STATUS  current
  307.                      DESCRIPTION
  308.                         "A counter associated with interface
  309.                          performance measurements agggregating the
  310.                          previous valid 15 minute measurement
  311.                          intervals. Intervals for which no valid
  312.                          data was available are counted as 0."
  313.                       SYNTAX  Gauge32
  314.  
  315.  
  316.                END
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.           Expires 4/24/97                                       [Page 6]
  354.  
  355.  
  356.  
  357.  
  358.  
  359.           draft      15 Minute Based Performance History TCs    10/24/96
  360.  
  361.  
  362.           4.  Acknowledgments
  363.  
  364.           This document is a product of the AToMMIB and TrunkMIB Working
  365.           Groups.
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.           Expires 4/24/97                                       [Page 7]
  413.  
  414.  
  415.  
  416.  
  417.  
  418.           draft      15 Minute Based Performance History TCs    10/24/96
  419.  
  420.  
  421.           5.  References
  422.  
  423.           [1]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  424.                "Textual Conventions for Version 2 of the Simple Network
  425.                Management Protocol (SNMPv2)", RFC1903, SNMP
  426.                Research,Inc., Cisco Systems, Inc., Dover Beach
  427.                Consulting, Inc., International Network Services, January
  428.                1996.
  429.  
  430.           [2]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  431.                "Structure of Management Information for Version 2 of the
  432.                Simple Network Management Protocol (SNMPv2)", RFC1902,
  433.                SNMP Research,Inc., Cisco Systems, Inc., Dover Beach
  434.                Consulting, Inc., International Network Services, January
  435.                1996.
  436.  
  437.           [3]  Fowler, D., "Definitions of Managed Objects for the DS1,
  438.                E1, DS2 and E2 Interface Types", RFCxxxx, Newbridge
  439.                Networks, ????? 1996.
  440.  
  441.           [4]  Fowler, D., "Definitions of Managed Objects for the
  442.                DS3/E3 Interface Type", RFCxxxx, Newbridge Networks, ????
  443.                1996.
  444.  
  445.           [5]  Tesink, K., "Definitions of Managed Objects for the
  446.                SONET/SDH Interface Type", RFCxxxx, Newbridge Networks,
  447.                ???? 1996.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.           Expires 4/24/97                                       [Page 8]
  472.  
  473.  
  474.  
  475.  
  476.  
  477.           draft      15 Minute Based Performance History TCs    10/24/96
  478.  
  479.  
  480.           6.  Security Considerations
  481.  
  482.           Security issues are not discussed in this memo.
  483.  
  484.  
  485.           7.  Authors' Addresses
  486.  
  487.                             Kaj Tesink
  488.                             Bell Communications Research
  489.                             Room 1A-427
  490.                             331 Newman Springs Road
  491.                             P.O. Box 7020
  492.                             Red Bank, NJ  07701-7020
  493.                             Phone: (908) 758-5254
  494.                             EMail: kaj@cc.bellcore.com
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.           Expires 4/24/97                                       [Page 9]
  531.  
  532.  
  533.  
  534.  
  535.  
  536.           draft      15 Minute Based Performance History TCs    10/24/96
  537.  
  538.  
  539.           Table of Contents
  540.  
  541.  
  542.           1 Status of this Memo ...................................    1
  543.           2 Introduction ..........................................    2
  544.           3 Definitions ...........................................    3
  545.           4 Acknowledgments .......................................    7
  546.           5 References ............................................    8
  547.           6 Security Considerations ...............................    9
  548.           7 Authors' Addresses ....................................    9
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.           Expires 4/24/97                                      [Page 10]
  590.  
  591.  
  592.