rfc2594.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.

   Section 7 of this memo defines a mapping of the document transfer
   protocol to the HTTP protocol and the FTP protocol. Mappings to other
   protocols, like NNTP [25] or WebNFS [26,27] might be defined in the
   future.


5.  Structure of the MIB

   This section presents the structure of the MIB. The objects are
   arranged into the following groups:

   o    service information

   o    protocol statistics

   o    document statistics


5.1.  Service Information Group

   The service information group consists of a single table describing
   all the WWW services managed by the SNMP agent. The service table
   contains administrative network management information for
   (potentially) multiple WWW services running on a single host. It also
   contains information for all services within virtual domains of a
   host. The columnar objects in the table can be divided into two main
   groups:

   o    global administrative information of the service, such as
        service contact person, and

   o    network information, such as the transfer protocol.





Hazewinkel, et al.          Standards Track                     [Page 7]

RFC 2594                    WWW Service MIB                     May 1999


5.2.  Protocol Statistics Group

   The protocol statistics group provides network management information
   about the traffic received or transmitted by a WWW service. This
   group contains counters related to DTP protocol operations and
   consists of five tables:

   o    The wwwSummaryTable contains a set of network traffic related
        counters. The table provides a summarization of the network
        traffic and protocol operations related to a WWW service. It is
        well recognized that certain variables are redundant with
        respect to the request and response tables, but they are added
        to provide an operator a quick overview and to reduce SNMP
        network traffic.

   o    The wwwRequestInTable contains detailed information about
        incoming requests. Every particular request type is counted
        separately.

   o    The wwwRequestOutTable contains detailed information about
        outgoing requests. Every particular request type is counted
        separately.

   o    The wwwResponseInTable contains detailed information about
        incoming responses. Every particular response type is counted
        separately.

   o    The wwwResponseOutTable contains detailed information about
        outgoing responses. Every particular response type is counted
        separately.


5.3.  Document Statistics Group

   The document group contains information about the documents which
   were accessed in the past. The group provides four types of
   statistics.

   1.   Details about the last N attempts to invoke actions on
        documents.

   2.   The Top N documents sorted by the number of actions invoked on
        them computed over a time interval.

   3.   The Top N documents sorted by the number of content bytes
        transferred computed over a time interval.

   4.   Summary statistics computed over a time interval.



Hazewinkel, et al.          Standards Track                     [Page 8]

RFC 2594                    WWW Service MIB                     May 1999


   The Top N document statistics are collected in buckets in order to
   reduce agent resources and to allow a manager to detect changes in
   the service usage pattern. Buckets are filled over a configurable
   time interval. The agent computes the Top N statistics and starts a
   new bucket once the time interval for the bucket has passed. The time
   interval is configurable for each WWW service.

   The document statistics group associates a response type to the
   request which invoked an action. In case a DTP sends multiple
   responses, the primary response must be used to derive the response
   type of the request/response interaction.

   The group consist of the following tables:

   o    The wwwDocCtrlTable provides the manager a means to limit the
        document statistic tables in size and to control the expiration
        and creation of buckets.

   o    The wwwDocLastNTable provides the manager information about the
        last N documents which where accessed. The table lists the
        documents for which access was attempted along with the request
        and response type of the DTP and a status message. The request
        and response types provide a manager information of how attempts
        to invoke actions were handled by the DTP. The status message
        object provides human readable text to further describe the
        response type.

        The number of documents in the wwwDocLastNTable is controlled by
        the wwwDocCtrlLastNSize object in the wwwDocCtrlTable. The
        wwwDocCtrlLastNLock object of the wwwDocCtrlTable allows a
        management application to lock the wwwDocLastNTable in order to
        retrieve a consistent snapshot of the fast changing
        wwwDocLastNTable.

   o    The wwwDocBucketTable lists the buckets of statistical
        information that have been collected. An entry in the
        wwwDocBucketTable contains the creation timestamp of the bucket
        as well as summary information (number of accesses, number of
        documents accessed and number of bytes transferred).

        The time interval is controlled by the
        wwwDocCtrlBucketTimeInterval object of the wwwDocCtrlTable. The
        maximum number of buckets maintained by the SNMP agent for a
        particular WWW service is controlled by the wwwDocCtrlBuckets
        object of the wwwDocCtrlTable.

   o    The wwwDocAccessTopNTable provides the manager an overview of
        the top N documents which were accessed while statistics were
        collected for a particular bucket. The wwwDocAccessTopNTable is


Hazewinkel, et al.          Standards Track                     [Page 9]

RFC 2594                    WWW Service MIB                     May 1999


        sorted by the number of read attempts per document. The maximum
        number of entries in the wwwDocAccessTopNTable is controlled by
        the wwwDocCtrlTopNSize object.

   o    The wwwDocBytesTopNTable provides the manager an overview of the
        top N documents which caused most of the network traffic while
        statistics were collected for a particular bucket. The
        wwwDocBytesTopNTable is sorted by the number of bytes
        transferred. The maximum number of entries in the
        wwwDocBytesTopNTable is controlled by the wwwDocCtrlTopNSize
        object.


   The Top N statistics and the parameters of the underlying bucket are
   not visible in the MIB as long as the bucket is filling up. Instead,
   the following steps must be taken when the time interval for a
   buckets has passed:


   1.   A new entry in the wwwDocBucketTable is created to summarize the
        document statistics for that time interval.

   2.   The corresponding entries in the wwwDocAccessTopNTable and the
        wwwDocBytesTopNTable are computed and made available.

   3.   If the resulting number of entries in the wwwDocBucketTable for
        the WWW service now exceeds wwwDocCtrlBuckets, then the oldest
        bucket for this WWW service and all corresponding entries in the
        wwwDocBucketTable, wwwDocAccessTopNTable, and
        wwwDocBytesTopNTable are deleted.


   Note that a bucket usually contains much more data than displayed in
   the Top N tables. The number of entries in the Top N table for a
   bucket is controlled by wwwDocCtrlTopNSize, while the number of
   entries in a bucket depends on the number of actions invoked on
   documents within the time interval over which a bucket is filled up.
   It is therefore suggested to discard the data associated with a
   bucket once the entries for the wwwDocBucketTable,
   wwwDocAccessTopNTable and wwwDocBytesTopNTable have been calculated.


6.  Definitions

   WWW-MIB DEFINITIONS ::= BEGIN

   IMPORTS
       MODULE-IDENTITY, OBJECT-TYPE, mib-2,
       Counter32, Counter64, Integer32, Unsigned32, TimeTicks
           FROM SNMPv2-SMI


Hazewinkel, et al.          Standards Track                    [Page 10]

RFC 2594                    WWW Service MIB                     May 1999


       TEXTUAL-CONVENTION, DisplayString, DateAndTime, TimeInterval
           FROM SNMPv2-TC

       MODULE-COMPLIANCE, OBJECT-GROUP
           FROM SNMPv2-CONF

       Utf8String
           FROM SYSAPPL-MIB;

   wwwMIB MODULE-IDENTITY
       LAST-UPDATED "9902251400Z"
       ORGANIZATION "IETF Application MIB Working Group"
       CONTACT-INFO
           "        Harrie Hazewinkel

            Postal: Joint Research Centre of the E.C.
                    via Fermi - Ispra 21020 (VA)
                    Italy

               Tel: +39+(0)332 786322
               Fax: +39+(0)332 785641
            E-mail: [e-mail]

                    Carl W. Kalbfleisch

            Postal: Verio, Inc.
                    1950 Stemmons Freeway
                    Suite 2006
                    Dallas, TX 75207
                    US

               Tel: [phone]
               Fax: [phone]
            E-mail: [e-mail]

                    Juergen Schoenwaelder

            Postal: TU Braunschweig
                    Bueltenweg 74/75
                    38106 Braunschweig
                    Germany

               Tel: [phone]
               Fax: [phone]
            E-mail: [e-mail]"
       DESCRIPTION
           "This WWW service MIB module is applicable to services
            realized by a family of 'Document Transfer Protocols'
            (DTP). Examples of DTPs are HTTP and FTP."


Hazewinkel, et al.          Standards Track                    [Page 11]

RFC 2594                    WWW Service MIB                     May 1999


          -- revision history

          REVISION    "9902251400Z"
          DESCRIPTION "Initial version, published as RFC2594."

          ::= { mib-2 65 }

   --
   --  Object Identifier Assignments
   --

   wwwMIBObjects     OBJECT IDENTIFIER ::= { wwwMIB 1 }
   wwwMIBConformance OBJECT IDENTIFIER ::= { wwwMIB 2 }

   --
   -- Textual Conventions
   --

   WwwRequestType ::= TEXTUAL-CONVENTION
       STATUS      current
       DESCRIPTION
           "The WwwRequestType defines the textual identification of
            request types used by a document transfer protocol. For
            the proper values for a given DTP, refer to the protocol
            mappings for that DTP."
       SYNTAX      OCTET STRING (SIZE (1..40))

   WwwResponseType ::= TEXTUAL-CONVENTION
       STATUS      current
       DESCRIPTION
           "The WwwResponseType defines the different response values
            used by document transfer protocols. For the proper values
            for a given DTP, refer to the protocol mappings for that
            DTP."
       SYNTAX      Integer32 (0..2147483647)

   WwwOperStatus ::= TEXTUAL-CONVENTION
       STATUS      current
       DESCRIPTION
           "The operational status of a WWW service. 'down' indicates
            that the service is not available. 'running' indicates
            that the service is operational and available. 'halted'
            indicates that the service is operational but not
            available. 'congested' indicates that the service is
            operational but no additional inbound associations can be
            accommodated. 'restarting' indicates that the service is
            currently unavailable but is in the process of restarting
            and will be available soon."
       SYNTAX      INTEGER {
                       down(1),


Hazewinkel, et al.          Standards Track                    [Page 12]

RFC 2594                    WWW Service MIB                     May 1999


                       running(2),
                       halted(3),
                       congested(4),
                       restarting(5)
                   }

   WwwDocName ::= TEXTUAL-CONVENTION
       DISPLAY-HINT "255a"
       STATUS      current
       DESCRIPTION
           "The server relative name of a document. If the URL were
            http://www.x.org/standards/search/search.cgi?string=test
            then the value of this textual convention would resolve
            to '/standards/search/search.cgi'. This textual convention
            uses the character set for URIs as defined in RFC 2396
            section 2."
       SYNTAX      OCTET STRING (SIZE (0..255))


   -- The WWW Service Information Group
   --
   -- The WWW service information group contains information about
   -- the WWW services known by the SNMP agent.

   wwwService OBJECT IDENTIFIER ::= { wwwMIBObjects 1 }

   wwwServiceTable OBJECT-TYPE
       SYNTAX      SEQUENCE OF WwwServiceEntry