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-applmib-wwwmib-05.txt < prev    next >
Text File  |  1997-09-26  |  79KB  |  2,397 lines
  1.  
  2.  
  3. Internet-Draft               WWW Service MIB              September 1997
  4.  
  5.  
  6.             Definitions of Managed Objects for WWW Services
  7.  
  8.                            September 26, 1997
  9.  
  10.                    <draft-ietf-applmib-wwwmib-05.txt>
  11.  
  12.                            Harrie Hazewinkel
  13.                    Joint Research Centre of the E.C.
  14.                         harrie.hazewinkel@jrc.it
  15.  
  16.                           Carl W. Kalbfleisch
  17.                               Verio, Inc.
  18.                              cwk@verio.net
  19.  
  20.                          Juergen Schoenwaelder
  21.                           University of Twente
  22.                          schoenw@cs.utwente.nl
  23.  
  24.  
  25.  
  26.  
  27.  
  28. Status of this Memo
  29.  
  30.    This document is an Internet-Draft.  Internet-Drafts are working
  31.    documents of the Internet Engineering Task Force (IETF), its areas,
  32.    and its working groups.  Note that other groups may also distribute
  33.    working documents as Internet-Drafts.
  34.  
  35.    Internet-Drafts are draft documents valid for a maximum of six months
  36.    and may be updated, replaced, or obsoleted by other documents at any
  37.    time.  It is inappropriate to use Internet-Drafts as reference
  38.    material or to cite them other than as ``work in progress.''
  39.  
  40.    To learn the current status of any Internet-Draft, please check the
  41.    ``1id-abstracts.txt'' listing contained in the Internet-Drafts Shadow
  42.    Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe),
  43.    munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  44.    ftp.isi.edu (US West Coast).
  45.  
  46.    Distribution of this document is unlimited. Please send comments to
  47.    the Application MIB Working Group, <applmib@emi-summit.com>.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Expires March 1998                                              [Page 1]
  59.  
  60. Internet-Draft               WWW Service MIB              September 1997
  61.  
  62.  
  63. 1.  Abstract
  64.  
  65.    This memo defines an experimental portion of the Management
  66.    Information Base (MIB) for use with network management protocols in
  67.    the Internet Community. In particular it describes a set of objects
  68.    for managing World-Wide Web (WWW) services. This MIB extends the
  69.    application management framework defined by the System Application
  70.    Management MIB (SYSAPPL-MIB) and the Application Management MIB
  71.    (APPLICATION-MIB). The protocol statistics defined in the WWW Service
  72.    MIB are based on an abstract document transfer protocol (DTP). This
  73.    memo also defines a mapping of the abstract DTP to HTTP and FTP.
  74.    Additional mappings may be defined in the future in order to use this
  75.    MIB with other document transfer protocols. It is anticipated that
  76.    such future mappings will be defined in separate RFCs.
  77.  
  78.  
  79. 2.  The SNMPv2 Network Management Framework
  80.  
  81.    The SNMP Network Management Framework presently consists of three
  82.    major components. They are:
  83.  
  84.    o    the SMI, described in RFC 1902 [1] - the mechanisms used for
  85.         describing and naming objects for the purpose of management.
  86.  
  87.    o    the MIB-II, STD 17, RFC 1213 [2] - the core set of managed
  88.         objects for the Internet suite of protocols.
  89.  
  90.    o    the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol
  91.         for accessing managed objects.
  92.  
  93.    The Framework permits new objects to be defined for the purpose of
  94.    experimentation and evaluation.
  95.  
  96.  
  97.  
  98. 2.1.  Object Definitions
  99.  
  100.    Managed objects are accessed via a virtual information store, termed
  101.    the Management Information Base or MIB. Objects in the MIB are
  102.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  103.    defined in the SMI [1]. In particular, each object type is named by
  104.    an OBJECT IDENTIFIER, an administratively assigned name. The object
  105.    type together with an object instance serves to uniquely identify a
  106.    specific instantiation of the object. For human convenience, we often
  107.    use a textual string, termed the object descriptor, to refer to the
  108.    object type.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. Expires March 1998                                              [Page 2]
  116.  
  117. Internet-Draft               WWW Service MIB              September 1997
  118.  
  119.  
  120. 3.  Terminology
  121.  
  122.    This section defines the terminology used throughout this document.
  123.  
  124.    o    The 'World-Wide Web' (WWW) is a world wide information system
  125.         which is based on the concept of documents that are linked
  126.         together by embedding references (links) to other local or
  127.         remote documents.
  128.  
  129.    o    A 'document' is a coherent piece of data which is accessible in
  130.         the World-Wide Web. No assumptions are made about the content or
  131.         the type of a document.
  132.  
  133.    o    A 'Uniform Resource Locator' (URL) is a formatted string
  134.         representation for a document available via the Internet. URLs
  135.         are used to express references between documents. For the syntax
  136.         and semantics of the URL string representation is referred to
  137.         RFC 1630 [5] and RFC 1738 [6]
  138.  
  139.    o    A 'Document Transfer Protocol' (DTP) is a protocol used within
  140.         the World-Wide Web to invoke actions on documents. The DTP is an
  141.         abstraction from real protocols, such as HTTP [7,8] or FTP [9].
  142.  
  143.    o    A 'request' is a DTP protocol operation which is targeted to a
  144.         'document' and invokes an action on the target document.  The
  145.         request type specifies the action that should be performed. A
  146.         request can have a document associated to it.
  147.  
  148.    o    A 'response' is a DTP protocol operation which is returned as a
  149.         result of a previous (and associated) request. The response
  150.         status indicates if the requested action was successful or if
  151.         errors occurred. A response can have a document associated to
  152.         it.
  153.  
  154.    o    A 'WWW service' is a set of actions that can be invoked on a
  155.         document. Typical actions are the transfer of documents or the
  156.         retrieval of administrative information about documents. WWW
  157.         services are provided by means of a DTP. A WWW service can be
  158.         identified by the DTP protocol used to invoke services and the
  159.         transport endpoint used by that protocol.
  160.  
  161.    o    A 'client' is a program which establishes connections for the
  162.         purpose of sending requests and receiving responses.
  163.  
  164.    o    A 'server' is a program that accepts connections in order to
  165.         service requests by sending back responses.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172. Expires March 1998                                              [Page 3]
  173.  
  174. Internet-Draft               WWW Service MIB              September 1997
  175.  
  176.  
  177.    o    A 'proxy' is an intermediary program which acts as both a server
  178.         and a client for the purpose of making requests on behalf of
  179.         other clients.  Requests are serviced internally or by passing
  180.         them on, with possible translation, to other servers.
  181.  
  182.    o    A 'caching proxy' is a proxy with the capability of locally
  183.         storing responses to associated requests. A caching proxy can
  184.         respond to similar requests with a previously stored response.
  185.  
  186.  
  187. 4.  Overview
  188.  
  189.    The World-Wide Web (WWW) is a global network of information.
  190.    Information is stored in documents, which can have various formats,
  191.    including hyper-text and multi-media documents. Access to these
  192.    documents is provided by servers which are located all around the
  193.    world and are linked to each other via hyper-links embedded in
  194.    documents.
  195.  
  196.    The usability of the World-Wide Web depends largely on the
  197.    performance of the services realized by these servers. The services
  198.    are typically monitored through log files. This becomes a difficult
  199.    task when a single organization is responsible for a large number of
  200.    services. It is therefore desirable to treat WWW services as objects
  201.    that can be managed by using the Internet network management
  202.    framework [10].
  203.  
  204.  
  205. 4.1.  Purpose and Requirements
  206.  
  207.    The goal of this MIB is to define a standardized set of objects which
  208.    lead to integrated and improved performance and fault management in a
  209.    heterogenous environment of WWW services. This MIB focuses on the
  210.    service oriented view. It does not deal with the process oriented
  211.    view, which is covered by the System Application MIB [11] and the
  212.    Application MIB [12].
  213.  
  214.    This document defines a set of managed objects to monitor WWW
  215.    services for short-term operational purposes, such as problem
  216.    detection and troubleshooting. No attempts are made here to cover
  217.    accounting or hit metering issues.
  218.  
  219.    The scope of the MIB is further limited by the requirement that an
  220.    implementation conforming to this MIB must be possible without
  221.    putting a huge CPU or memory burden on the WWW server implementation.
  222.  
  223.    In addition, this MIB does not cover WWW service configuration.
  224.  
  225.  
  226.  
  227.  
  228.  
  229. Expires March 1998                                              [Page 4]
  230.  
  231. Internet-Draft               WWW Service MIB              September 1997
  232.  
  233.  
  234.    Server software has become an open market where competing vendors
  235.    constantly invent new features in order to shape their products. It
  236.    is therefore not possible to reach consensus on a common way to
  237.    configure WWW services at this point in time.
  238.  
  239.  
  240. 4.2.  Relationship to other Standards Efforts
  241.  
  242.    The WWW service MIB fits into the application management architecture
  243.    defined in the System Application MIB [11]. The System Application
  244.    MIB and the Application MIB [12] use a process oriented view, where
  245.    an application is viewed as a collection of processes. The WWW
  246.    service MIB described in this memo uses a service oriented view,
  247.    which looks at the services provided by a set of processes.
  248.  
  249.    The relationship between the process oriented view and the service
  250.    oriented view is a many-to-many relationship, because one process can
  251.    implement multiple services and multiple services can be implemented
  252.    by a single set of processes. The Application Management MIB [12]
  253.    contains generic mapping tables, which map back and forth between
  254.    both views.
  255.  
  256.  
  257. 4.3.  WWW Services
  258.  
  259.    The MIB is organized around the concept of WWW services. WWW services
  260.    are a set of actions that can be invoked on a document. A WWW service
  261.    is provided or used by either a client, a server or a proxy. Clients
  262.    send out requests for information to server or proxy server. Servers
  263.    receive, process and respond to requests received from clients.
  264.    Servers usually have access to local documents, which can be
  265.    transfered to clients.
  266.  
  267.    A proxy is a special server, who acts as both a server and a client
  268.    for the purpose of making requests on behalf of other clients. A
  269.    proxy is able to translate between the client and the origin server.
  270.    A proxy might also interact with other information retrieval system,
  271.    like for example databases.
  272.  
  273.    The MIB defined in this memo distinguishes between outgoing and
  274.    incoming requests and responses. This allows to obtain statistics for
  275.    clients, servers and proxies with a single set of objects.
  276.  
  277.    A special proxy server is the caching proxy, which maintains a cache
  278.    of previously received documents in order to reduce the bandwidth
  279.    used by World-Wide Web clients. One interesting piece of management
  280.    information is the percentage of requests that were served from the
  281.  
  282.  
  283.  
  284.  
  285.  
  286. Expires March 1998                                              [Page 5]
  287.  
  288. Internet-Draft               WWW Service MIB              September 1997
  289.  
  290.  
  291.    cache of the caching proxy (hits/miss-ratio). This ratio is not
  292.    contained explicitly in this MIB. Instead, the ratio can be derived
  293.    from the objects that count incoming and outgoing requests and
  294.    responses.
  295.  
  296.  
  297. 4.4.  Document Transfer Protocol
  298.  
  299.    The MIB is based on the concept of an abstract document transfer
  300.    protocol (DTP). The purpose of the abstract document transfer
  301.    protocol is to make the MIB definitions independent from concrete
  302.    protocols, like the Hypertext Transfer Protocol (HTTP) [7,8] or the
  303.    File Transfer Protocol (FTP) [9].
  304.  
  305.    The abstract document transfer protocol makes the following
  306.    assumptions about a concrete transfer protocol:
  307.  
  308.    o    The transfer protocol uses a request/response style of
  309.         interactions.
  310.  
  311.    o    Every request contains a request type, which defines the
  312.         operations performed by the receiving server. The request type
  313.         is represented by an OCTET STRING. It might be necessary to
  314.         define a translation into an OCTET STRING value for protocols
  315.         that use numbers to identify request types.
  316.  
  317.    o    A response contains a status code, which indicates if the
  318.         request was processed successfully or which error occured. The
  319.         status code is represented as an INTEGER value. It might be
  320.         necessary to define a mapping for protocols that do not use an
  321.         INTEGER status code.
  322.  
  323.    o    A transfer protocol can send multiple responses for a single
  324.         request.  Multiple responses are counted separately in the
  325.         protocol statistics group.
  326.  
  327.         A primary response has to be identified for the document
  328.         statistics. The primary response is the response that indicates
  329.         whether the request was successful.
  330.  
  331.    Section 7 of this memo defines a mapping of the document transfer
  332.    protocol to the HTTP protocol and the FTP protocol. Mappings to other
  333.    protocols, like NNTP [13] or WebNFS [14,15] might be defined in the
  334.    future.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343. Expires March 1998                                              [Page 6]
  344.  
  345. Internet-Draft               WWW Service MIB              September 1997
  346.  
  347.  
  348. 5.  Structure of the MIB
  349.  
  350.    This section presents the structure of the MIB. The objects are
  351.    arranged into the following groups:
  352.  
  353.    o    service information
  354.  
  355.    o    protocol statistics
  356.  
  357.    o    document statistics
  358.  
  359.  
  360. 5.1.  Service Information Group
  361.  
  362.    The service information group consists of a single table describing
  363.    all the WWW services managed by the SNMP agent. The service table
  364.    contains administrative network management information for
  365.    (potentially) multiple WWW services running on a single host. It also
  366.    contains information for all services within virtual domains of a
  367.    host. The columnar objects in the table can be divided into two main
  368.    groups:
  369.  
  370.    o    global administrative information of the service, such as
  371.         service contact person, and
  372.  
  373.    o    network information, such as the transfer protocol.
  374.  
  375.  
  376. 5.2.  Protocol Statistics Group
  377.  
  378.    The protocol statistics group provides network management information
  379.    about the traffic received or transmitted by a WWW service. This
  380.    group contains counters related to DTP protocol operations and
  381.    consists of five tables:
  382.  
  383.    o    The wwwSummaryTable contains a set of network traffic related
  384.         counters. The table provides a summarization of the network
  385.         traffic and protocol operations related to a WWW service. It is
  386.         well recognized that certain variables are redundant with
  387.         respect to the request and response tables, but they are added
  388.         to provide an operator a quick overview and to reduce SNMP
  389.         network traffic.
  390.  
  391.    o    The wwwRequestInTable contains detailed information about
  392.         incoming requests. Every particular request type is counted
  393.         separately.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. Expires March 1998                                              [Page 7]
  401.  
  402. Internet-Draft               WWW Service MIB              September 1997
  403.  
  404.  
  405.    o    The wwwRequestOutTable contains detailed information about
  406.         outgoing requests. Every particular request type is counted
  407.         separately.
  408.  
  409.    o    The wwwResponseInTable contains detailed information about
  410.         incoming responses. Every particular response type is counted
  411.         separately.
  412.  
  413.    o    The wwwResponseOutTable contains detailed information about
  414.         outgoing responses. Every particular response type is counted
  415.         separately.
  416.  
  417.  
  418. 5.3.  Document Statistics Group
  419.  
  420.    The document group contains information about the documents which
  421.    were accessed in the past. The group provides four types of
  422.    statistics.
  423.  
  424.    1.   Details about the last N attempts to invoke actions on
  425.         documents.
  426.  
  427.    2.   The Top N documents sorted by the number of actions invoked on
  428.         them computed over a time interval.
  429.  
  430.    3.   The Top N documents sorted by the number of content bytes
  431.         transferred computed over a time interval.
  432.  
  433.    4.   Summary statistics computed over a time interval.
  434.  
  435.    The Top N document statistics are collected in buckets in order to
  436.    reduce agent resources and to allow a manager to detect changes in
  437.    the service usage pattern. Buckets are filled over a configurable
  438.    time interval. The agent computes the Top N statistics and starts a
  439.    new bucket once the time interval for the bucket has passed. The time
  440.    interval if configurable for each WWW service.
  441.  
  442.    The document statistics group associates a response type to the
  443.    request which invoked an action. In case a DTP sends multiple
  444.    responses, the primary response must be used to derive the response
  445.    type of the request/response interaction.
  446.  
  447.    The group consist of the following tables:
  448.  
  449.    o    The wwwDocCtrlTable provides the manager a means to limit the
  450.         document statistic tables in size and to control the expiration
  451.         and creation of buckets.
  452.  
  453.  
  454.  
  455.  
  456.  
  457. Expires March 1998                                              [Page 8]
  458.  
  459. Internet-Draft               WWW Service MIB              September 1997
  460.  
  461.  
  462.    o    The wwwDocLastNTable provides the manager information about the
  463.         last N documents which where accessed. The table lists the
  464.         documents attempted to read together with the request and
  465.         response type of the DTP and a status message. The request and
  466.         response types provide a manager information of how attempts to
  467.         invoke actions were handled by the DTP. The status message
  468.         object provides human readable text to further describe the
  469.         response type.
  470.  
  471.         The number of documents in the wwwDocLastNTable is controlled by
  472.         the wwwDocCtrlLastNSize object in the wwwDocCtrlTable. The
  473.         wwwDocCtrlLastNStatus object of the wwwDocCtrlTable allows the
  474.         management application to disable table updates so that it can
  475.         read a consistent snapshot of a fast changing wwwDocLastNTable.
  476.  
  477.    o    The wwwDocBucketTable lists the buckets of statistical
  478.         information that have been collected. An entry in the
  479.         wwwDocBucketTable contains the creation timestamp of the bucket
  480.         as well as summary information (number of accesses, number of
  481.         documents accessed and number of bytes transferred).
  482.  
  483.         The time interval is controlled by the
  484.         wwwDocCtrlBucketTimeInterval object of the wwwDocCtrlTable. The
  485.         maximum number of buckets maintained by the SNMP agent for a
  486.         particular WWW service is controlled by the wwwDocCtrlBuckets
  487.         object of the wwwDocCtrlTable.
  488.  
  489.    o    The wwwDocAccessTopNTable provides the manager an overview of
  490.         the top N documents which were accessed while statistics were
  491.         collected for a particular bucket. The wwwDocAccessTopNTable is
  492.         sorted by the number of read attempts per document. The maximum
  493.         number of entries in the wwwDocAccessTopNTable is controlled by
  494.         the wwwDocCtrlTopNSize object.
  495.  
  496.    o    The wwwDocBytesTopNTable provides the manager an overview of the
  497.         top N documents which caused most of the network traffic while
  498.         statistics were collected for a particular bucket. The
  499.         wwwDocBytesTopNTable is sorted by the number of bytes
  500.         transfered. The maximum number of entries in the
  501.         wwwDocBytesTopNTable is controlled by the wwwDocCtrlTopNSize
  502.         object.
  503.  
  504.  
  505.    The Top N statistics and the parameters of the underlying bucket are
  506.    not visible in the MIB as long as the bucket is filled up. Instead,
  507.    the following steps must be taken when the time interval for a
  508.    buckets has passed:
  509.  
  510.  
  511.  
  512.  
  513.  
  514. Expires March 1998                                              [Page 9]
  515.  
  516. Internet-Draft               WWW Service MIB              September 1997
  517.  
  518.  
  519.    1.   A new entry in the wwwDocBucketTable is created to summarize the
  520.         document statistics for that time interval.
  521.  
  522.    2.   The corresponding entries in the wwwDocAccessTopNTable and the
  523.         wwwDocBytesTopNTable are computed and made available.
  524.  
  525.    3.   If the resulting number of entries in the wwwDocBucketTable for
  526.         the WWW service now exceeds wwwDocCtrlBuckets, then the oldest
  527.         bucket for this WWW service and all corresponding entries in the
  528.         wwwDocBucketTable, wwwDocAccessTopNTable, and
  529.         wwwDocBytesTopNTable are deleted.
  530.  
  531.  
  532.    Note that a bucket usually contains much more data than displayed in
  533.    the Top N tables. The number of entries in the Top N table for a
  534.    bucket is controlled by wwwDocCtrlTopNSize, while the number of
  535.    entries in a bucket depends on the number of actions invoked on
  536.    documents within the time interval over which a bucket is filled up.
  537.    It is therefore suggested to discard the data associated with a
  538.    bucket once the entries for the wwwDocBucketTable,
  539.    wwwDocAccessTopNTable and wwwDocBytesTopNTable have been calculated.
  540.  
  541.  
  542. 6.  Definitions
  543.  
  544.    WWW-MIB DEFINITIONS ::= BEGIN
  545.  
  546.    IMPORTS
  547.        mib-2,
  548.        MODULE-IDENTITY,
  549.        OBJECT-TYPE,
  550.        Counter32,
  551.        Counter64,
  552.        Integer32,
  553.        Unsigned32
  554.            FROM SNMPv2-SMI
  555.  
  556.        TEXTUAL-CONVENTION,
  557.        DisplayString,
  558.        TimeStamp,
  559.        DateAndTime,
  560.        TimeInterval
  561.            FROM SNMPv2-TC
  562.  
  563.        MODULE-COMPLIANCE,
  564.        OBJECT-GROUP
  565.            FROM SNMPv2-CONF
  566.  
  567.  
  568.  
  569.  
  570.  
  571. Expires March 1998                                             [Page 10]
  572.  
  573. Internet-Draft               WWW Service MIB              September 1997
  574.  
  575.  
  576.        Utf8String
  577.            FROM SYSAPPL-MIB;
  578.  
  579.    wwwMIB MODULE-IDENTITY
  580.        LAST-UPDATED "9709260000Z"
  581.        ORGANIZATION "Application MIB Working Group"
  582.        CONTACT-INFO
  583.            "        Harrie Hazewinkel
  584.  
  585.             Postal: MUSIQ/DESIRE/CEO Program
  586.                     Centre for Earth Observation
  587.                     Institute for Space Applications
  588.                     Joint Research Centre of the E.C.
  589.                     via Fermi - Ispra 21020 (VA)
  590.                     Italy
  591.  
  592.                Tel: +39+(0)332+789384
  593.                Fax: +39+(0)332+785500
  594.             E-mail: harrie.hazewinkel@jrc.it
  595.  
  596.                     Carl W. Kalbfleisch
  597.  
  598.             Postal: Verio, Inc.
  599.                     1950 Stemmons Freeway
  600.                     Suite 2004 - Infomart
  601.                     Dallas, TX 75207
  602.                     US
  603.  
  604.                Tel: +1 972 238-8303
  605.                Fax: +1 972 238-0268
  606.             E-mail: cwk@verio.net
  607.  
  608.                     Juergen Schoenwaelder
  609.  
  610.             Postal: Computer Science Department
  611.                     University of Twente
  612.                     P.O. Box 217, NL-7500 AE Enschede
  613.                     The Netherlands.
  614.  
  615.                Tel: +31 53 489-3678
  616.                Fax: +31 53 489-3247
  617.             E-mail: schoenw@cs.utwente.nl"
  618.        DESCRIPTION
  619.            "This WWW service MIB module is applicable to services
  620.             realized by a family of 'Document Transfer Protocols'
  621.             (DTP). Examples of DTPs are HTTP and FTP."
  622.        REVISION "9709260000Z"
  623.  
  624.  
  625.  
  626.  
  627.  
  628. Expires March 1998                                             [Page 11]
  629.  
  630. Internet-Draft               WWW Service MIB              September 1997
  631.  
  632.  
  633.        DESCRIPTION
  634.            "The initial revision."
  635.  
  636.        ::= { mib-2 8080 } -- TBD
  637.  
  638.    --
  639.    --  Object Identifier Assignments
  640.    --
  641.  
  642.    wwwMIBObjects     OBJECT IDENTIFIER ::= { wwwMIB 1 }
  643.    wwwMIBConformance OBJECT IDENTIFIER ::= { wwwMIB 2 }
  644.  
  645.    --
  646.    -- Textual Conventions
  647.    --
  648.  
  649.    WwwRequestType ::= TEXTUAL-CONVENTION
  650.        STATUS      current
  651.        DESCRIPTION
  652.            "The WwwRequestType defines the textual identification of
  653.             request types used by a document transfer protocol. For
  654.             the proper values for a given DTP, refer to the protocol
  655.             mappings for that DTP."
  656.        SYNTAX      OCTET STRING (SIZE (1..40))
  657.  
  658.    WwwResponseType ::= TEXTUAL-CONVENTION
  659.        STATUS      current
  660.        DESCRIPTION
  661.            "The WwwResponseType defines the different response values
  662.             used by document transfer protocols. For the proper values
  663.             for a given DTP, refer to the protocol mappings for that
  664.             DTP."
  665.        SYNTAX      Integer32 (0..2147483647)
  666.  
  667.    WwwOperStatus ::= TEXTUAL-CONVENTION
  668.        STATUS      current
  669.        DESCRIPTION
  670.            "The operational status of a WWW service. 'down' indicates
  671.             that the service is not available. 'running' indicates
  672.             that the service is operational and available. 'halted'
  673.             indicates that the service is operational but not
  674.             available. 'congested' indicates that the service is
  675.             operational but no additional inbound associations can be
  676.             accommodated. 'restarting' indicates that the service is
  677.             currently unavailable but is in the process of restarting
  678.             and will be available soon."
  679.        SYNTAX      INTEGER {
  680.  
  681.  
  682.  
  683.  
  684.  
  685. Expires March 1998                                             [Page 12]
  686.  
  687. Internet-Draft               WWW Service MIB              September 1997
  688.  
  689.  
  690.                        down(1),
  691.                        running(2),
  692.                        halted(3),
  693.                        congested(4),
  694.                        restarting(5)
  695.                    }
  696.  
  697.    WwwDocName ::= TEXTUAL-CONVENTION
  698.        STATUS      current
  699.        DESCRIPTION
  700.            "The server relative name of a document. If the URL were
  701.             http://www.x.org/standards/search/search.cgi?string=test
  702.             then the value of this textual convention would resolve
  703.             to '/standards/search/search.cgi'."
  704.        SYNTAX      DisplayString
  705.  
  706.  
  707.    -- The WWW Service Information Group
  708.    --
  709.    -- The WWW service information group contains information about
  710.    -- the WWW services known by the SNMP agent.
  711.  
  712.    wwwService OBJECT IDENTIFIER ::= { wwwMIBObjects 1 }
  713.  
  714.    wwwServiceTable OBJECT-TYPE
  715.        SYNTAX      SEQUENCE OF WwwServiceEntry
  716.        MAX-ACCESS  not-accessible
  717.        STATUS      current
  718.        DESCRIPTION
  719.            "The table of the WWW services known by the SNMP agent."
  720.        ::= { wwwService 1 }
  721.  
  722.    wwwServiceEntry OBJECT-TYPE
  723.        SYNTAX      WwwServiceEntry
  724.        MAX-ACCESS  not-accessible
  725.        STATUS      current
  726.        DESCRIPTION
  727.            "Details about a particular WWW service."
  728.        INDEX       { wwwServiceIndex }
  729.        ::= { wwwServiceTable 1 }
  730.  
  731.    WwwServiceEntry ::= SEQUENCE {
  732.        wwwServiceIndex             Unsigned32,
  733.        wwwServiceDescription       Utf8String,
  734.        wwwServiceContact           Utf8String,
  735.        wwwServiceProtocol          OBJECT IDENTIFIER,
  736.        wwwServiceName              DisplayString,
  737.  
  738.  
  739.  
  740.  
  741.  
  742. Expires March 1998                                             [Page 13]
  743.  
  744. Internet-Draft               WWW Service MIB              September 1997
  745.  
  746.  
  747.        wwwServiceType              INTEGER,
  748.        wwwServiceUptime            TimeStamp,
  749.        wwwServiceOperStatus        WwwOperStatus,
  750.        wwwServiceLastChange        TimeStamp
  751.    }
  752.  
  753.    wwwServiceIndex OBJECT-TYPE
  754.        SYNTAX      Unsigned32      -- needs to be aligned to applSrvInst
  755.        MAX-ACCESS  not-accessible
  756.        STATUS      current
  757.        DESCRIPTION
  758.            "An integer used to uniquely identify a WWW service. The
  759.             value must be the same as the corresponding value of the
  760.             applSrvInst defined in the Application Management MIB
  761.             (APPLICATION-MIB) if the applSrvInst object is available.
  762.             It might be necessary to manually configure sub-agents in
  763.             order to meet this requirement."
  764.        ::= { wwwServiceEntry 1 }
  765.  
  766.    wwwServiceDescription OBJECT-TYPE
  767.        SYNTAX      Utf8String
  768.        MAX-ACCESS  read-only
  769.        STATUS      current
  770.        DESCRIPTION
  771.            "Textual description of the WWW service. This shall include
  772.             at least the vendor and version number of the application
  773.             realizing the WWW service. In a minimal case, this might
  774.             be the Product Token (see RFC 2086) for the application."
  775.        ::= { wwwServiceEntry 2 }
  776.  
  777.    wwwServiceContact OBJECT-TYPE
  778.        SYNTAX      Utf8String
  779.        MAX-ACCESS  read-only
  780.        STATUS      current
  781.        DESCRIPTION
  782.            "The textual identification of the contact person for this
  783.             service, together with information on how to contact this
  784.             person. For instance, this might be a string containing an
  785.             email address, e.g. '<webmaster@domain.name>'."
  786.        ::= { wwwServiceEntry 3 }
  787.  
  788.    wwwServiceProtocol OBJECT-TYPE
  789.        SYNTAX      OBJECT IDENTIFIER
  790.        MAX-ACCESS  read-only
  791.        STATUS      current
  792.        DESCRIPTION
  793.            "An identification of the primary protocol in use by this
  794.  
  795.  
  796.  
  797.  
  798.  
  799. Expires March 1998                                             [Page 14]
  800.  
  801. Internet-Draft               WWW Service MIB              September 1997
  802.  
  803.  
  804.             service. For Internet applications, the IANA maintains
  805.             a registry of the OIDs which correspond to well-known
  806.             application protocols.  If the application protocol is not
  807.             listed in the registry, an OID value of the form
  808.             {applTCPProtoID port} or {applUDProtoID port} are used for
  809.             TCP-based and UDP-based protocols, respectively. In either
  810.             case 'port' corresponds to the primary port number being
  811.             used by the protocol."
  812.        ::= { wwwServiceEntry 4 }
  813.  
  814.    wwwServiceName OBJECT-TYPE
  815.        SYNTAX      DisplayString
  816.        MAX-ACCESS  read-only
  817.        STATUS      current
  818.        DESCRIPTION
  819.            "The fully qualified domain name by which this service is
  820.             known. This object must contain the virtual host name if
  821.             the service is realized for a virtual host."
  822.        ::= { wwwServiceEntry 5 }
  823.  
  824.    wwwServiceType OBJECT-TYPE
  825.        SYNTAX      INTEGER {
  826.                        wwwServer(1),
  827.                        wwwClient(2),
  828.                        wwwProxy(3),
  829.                        wwwCachingProxy(4),
  830.                        wwwOther(5)
  831.                    }
  832.        MAX-ACCESS  read-only
  833.        STATUS      current
  834.        DESCRIPTION
  835.            "The application type using or realizing this WWW service."
  836.        ::= { wwwServiceEntry 6 }
  837.  
  838.    wwwServiceUptime OBJECT-TYPE
  839.        SYNTAX      TimeStamp
  840.        MAX-ACCESS  read-only
  841.        STATUS      current
  842.        DESCRIPTION
  843.            "The value of sysUpTime at the time the WWW service was last
  844.             initialized. If the application was last initialized prior
  845.             to the last initialization of the network management
  846.             subsystem, then this object contains a zero value."
  847.        ::= { wwwServiceEntry 7 }
  848.  
  849.    wwwServiceOperStatus OBJECT-TYPE
  850.        SYNTAX      WwwOperStatus
  851.  
  852.  
  853.  
  854.  
  855.  
  856. Expires March 1998                                             [Page 15]
  857.  
  858. Internet-Draft               WWW Service MIB              September 1997
  859.  
  860.  
  861.        MAX-ACCESS  read-only
  862.        STATUS      current
  863.        DESCRIPTION
  864.            "Indicates the operational status of the WWW service."
  865.        ::= { wwwServiceEntry 8 }
  866.  
  867.    wwwServiceLastChange OBJECT-TYPE
  868.        SYNTAX      TimeStamp
  869.        MAX-ACCESS  read-only
  870.        STATUS      current
  871.        DESCRIPTION
  872.            "The value of sysUpTime at the time the WWW service entered
  873.             its current operational state. If the current state was
  874.             entered prior to the last initialization of the local
  875.             network management subsystem, then this object contains
  876.             a zero value."
  877.        ::= { wwwServiceEntry 9 }
  878.  
  879.  
  880.    -- The WWW Protocol Statistics Group
  881.    --
  882.    -- The WWW protocol statistics group contains statistics about
  883.    -- the DTP requests and responses send or received.
  884.  
  885.    wwwProtocolStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 2 }
  886.  
  887.    wwwSummaryTable OBJECT-TYPE
  888.        SYNTAX      SEQUENCE OF WwwSummaryEntry
  889.        MAX-ACCESS  not-accessible
  890.        STATUS      current
  891.        DESCRIPTION
  892.            "The table providing overview statistics for the
  893.             WWW services on this system."
  894.        ::= { wwwProtocolStatistics 1 }
  895.  
  896.    wwwSummaryEntry OBJECT-TYPE
  897.        SYNTAX      WwwSummaryEntry
  898.        MAX-ACCESS  not-accessible
  899.        STATUS      current
  900.        DESCRIPTION
  901.            "Overview statistics for an individual service."
  902.        INDEX       { wwwServiceIndex }
  903.        ::= { wwwSummaryTable 1 }
  904.  
  905.    WwwSummaryEntry ::= SEQUENCE {
  906.        wwwSummaryInRequests        Counter32,
  907.        wwwSummaryOutRequests       Counter32,
  908.  
  909.  
  910.  
  911.  
  912.  
  913. Expires March 1998                                             [Page 16]
  914.  
  915. Internet-Draft               WWW Service MIB              September 1997
  916.  
  917.  
  918.        wwwSummaryInResponses       Counter32,
  919.        wwwSummaryOutResponses      Counter32,
  920.        wwwSummaryInBytes           Counter64,
  921.        wwwSummaryInBytesLow        Counter32,
  922.        wwwSummaryOutBytes          Counter64,
  923.        wwwSummaryOutBytesLow       Counter32
  924.    }
  925.  
  926.    wwwSummaryInRequests OBJECT-TYPE
  927.        SYNTAX      Counter32
  928.        MAX-ACCESS  read-only
  929.        STATUS      current
  930.        DESCRIPTION
  931.            "The number of requests successfully received."
  932.        ::= { wwwSummaryEntry 1 }
  933.  
  934.    wwwSummaryOutRequests OBJECT-TYPE
  935.        SYNTAX      Counter32
  936.        MAX-ACCESS  read-only
  937.        STATUS      current
  938.        DESCRIPTION
  939.            "The number of requests generated."
  940.        ::= { wwwSummaryEntry 2 }
  941.  
  942.    wwwSummaryInResponses OBJECT-TYPE
  943.        SYNTAX      Counter32
  944.        MAX-ACCESS  read-only
  945.        STATUS      current
  946.        DESCRIPTION
  947.            "The number of responses successfully received."
  948.        ::= { wwwSummaryEntry 3 }
  949.  
  950.    wwwSummaryOutResponses OBJECT-TYPE
  951.        SYNTAX      Counter32
  952.        MAX-ACCESS  read-only
  953.        STATUS      current
  954.        DESCRIPTION
  955.            "The number of responses generated."
  956.        ::= { wwwSummaryEntry 4 }
  957.  
  958.    wwwSummaryInBytes OBJECT-TYPE
  959.        SYNTAX      Counter64
  960.        MAX-ACCESS  read-only
  961.        STATUS      current
  962.        DESCRIPTION
  963.            "The number of content bytes received."
  964.        ::= { wwwSummaryEntry 5 }
  965.  
  966.  
  967.  
  968.  
  969.  
  970. Expires March 1998                                             [Page 17]
  971.  
  972. Internet-Draft               WWW Service MIB              September 1997
  973.  
  974.  
  975.    wwwSummaryInBytesLow OBJECT-TYPE
  976.        SYNTAX      Counter32
  977.        MAX-ACCESS  read-only
  978.        STATUS      current
  979.        DESCRIPTION
  980.            "The lowest thirty-two bits of wwwSummaryInBytes."
  981.        ::= { wwwSummaryEntry 6 }
  982.  
  983.    wwwSummaryOutBytes OBJECT-TYPE
  984.        SYNTAX      Counter64
  985.        MAX-ACCESS  read-only
  986.        STATUS      current
  987.        DESCRIPTION
  988.            "The number of content bytes transmitted."
  989.        ::= { wwwSummaryEntry 7 }
  990.  
  991.    wwwSummaryOutBytesLow OBJECT-TYPE
  992.        SYNTAX      Counter32
  993.        MAX-ACCESS  read-only
  994.        STATUS      current
  995.        DESCRIPTION
  996.            "The lowest thirty-two bits of wwwSummaryOutBytes."
  997.        ::= { wwwSummaryEntry 8 }
  998.  
  999.    -- The WWW request tables contain detailed information about
  1000.    -- requests send or received by WWW services.
  1001.  
  1002.    wwwRequestInTable OBJECT-TYPE
  1003.        SYNTAX      SEQUENCE OF WwwRequestInEntry
  1004.        MAX-ACCESS  not-accessible
  1005.        STATUS      current
  1006.        DESCRIPTION
  1007.            "The table providing detailed statistics for requests
  1008.             received by WWW services on this system."
  1009.        ::= { wwwProtocolStatistics 2 }
  1010.  
  1011.    wwwRequestInEntry OBJECT-TYPE
  1012.        SYNTAX      WwwRequestInEntry
  1013.        MAX-ACCESS  not-accessible
  1014.        STATUS      current
  1015.        DESCRIPTION
  1016.            "Request statistics for an individual service."
  1017.        INDEX       { wwwServiceIndex, wwwRequestInIndex }
  1018.        ::= { wwwRequestInTable 1 }
  1019.  
  1020.    WwwRequestInEntry ::= SEQUENCE {
  1021.        wwwRequestInIndex           WwwRequestType,
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027. Expires March 1998                                             [Page 18]
  1028.  
  1029. Internet-Draft               WWW Service MIB              September 1997
  1030.  
  1031.  
  1032.        wwwRequestInCount           Counter32,
  1033.        wwwRequestInBytes           Counter32,
  1034.        wwwRequestInLastTime        TimeStamp
  1035.    }
  1036.  
  1037.    wwwRequestInIndex OBJECT-TYPE
  1038.        SYNTAX      WwwRequestType
  1039.        MAX-ACCESS  not-accessible
  1040.        STATUS      current
  1041.        DESCRIPTION
  1042.            "The particular request type the statistics apply to."
  1043.        ::= { wwwRequestInEntry 1 }
  1044.  
  1045.    wwwRequestInCount OBJECT-TYPE
  1046.        SYNTAX      Counter32
  1047.        MAX-ACCESS  read-only
  1048.        STATUS      current
  1049.        DESCRIPTION
  1050.            "The number of requests of this type received by this
  1051.             WWW service."
  1052.        ::= { wwwRequestInEntry 2 }
  1053.  
  1054.    wwwRequestInBytes OBJECT-TYPE
  1055.        SYNTAX      Counter32
  1056.        MAX-ACCESS  read-only
  1057.        STATUS      current
  1058.        DESCRIPTION
  1059.            "The number of content bytes per request type received
  1060.             by this WWW service."
  1061.        ::= { wwwRequestInEntry 3 }
  1062.  
  1063.    wwwRequestInLastTime OBJECT-TYPE
  1064.        SYNTAX      TimeStamp
  1065.        MAX-ACCESS  read-only
  1066.        STATUS      current
  1067.        DESCRIPTION
  1068.            "The value of sysUpTime when the last byte of the last
  1069.             complete request of this type was received by this WWW
  1070.             service."
  1071.        ::= { wwwRequestInEntry 4 }
  1072.  
  1073.    wwwRequestOutTable OBJECT-TYPE
  1074.        SYNTAX      SEQUENCE OF WwwRequestOutEntry
  1075.        MAX-ACCESS  not-accessible
  1076.        STATUS      current
  1077.        DESCRIPTION
  1078.            "The table providing detailed statistics for requests
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084. Expires March 1998                                             [Page 19]
  1085.  
  1086. Internet-Draft               WWW Service MIB              September 1997
  1087.  
  1088.  
  1089.             generated by the services on this system."
  1090.        ::= { wwwProtocolStatistics 3 }
  1091.  
  1092.    wwwRequestOutEntry OBJECT-TYPE
  1093.        SYNTAX      WwwRequestOutEntry
  1094.        MAX-ACCESS  not-accessible
  1095.        STATUS      current
  1096.        DESCRIPTION
  1097.            "Request statistics for an individual service."
  1098.        INDEX       { wwwServiceIndex, wwwRequestOutIndex }
  1099.        ::= { wwwRequestOutTable 1 }
  1100.  
  1101.    WwwRequestOutEntry ::= SEQUENCE {
  1102.        wwwRequestOutIndex          WwwRequestType,
  1103.        wwwRequestOutCount          Counter32,
  1104.        wwwRequestOutBytes          Counter32,
  1105.        wwwRequestOutLastTime       TimeStamp
  1106.    }
  1107.  
  1108.    wwwRequestOutIndex OBJECT-TYPE
  1109.        SYNTAX      WwwRequestType
  1110.        MAX-ACCESS  not-accessible
  1111.        STATUS      current
  1112.        DESCRIPTION
  1113.            "The particular request type the statistics apply to."
  1114.        ::= { wwwRequestOutEntry 1 }
  1115.  
  1116.    wwwRequestOutCount OBJECT-TYPE
  1117.        SYNTAX      Counter32
  1118.        MAX-ACCESS  read-only
  1119.        STATUS      current
  1120.        DESCRIPTION
  1121.            "The number of requests of this type generated by this
  1122.             WWW service."
  1123.        ::= { wwwRequestOutEntry 2 }
  1124.  
  1125.    wwwRequestOutBytes OBJECT-TYPE
  1126.        SYNTAX      Counter32
  1127.        MAX-ACCESS  read-only
  1128.        STATUS      current
  1129.        DESCRIPTION
  1130.            "The number of content bytes per requests type generated
  1131.             by this WWW service."
  1132.        ::= { wwwRequestOutEntry 3 }
  1133.  
  1134.    wwwRequestOutLastTime OBJECT-TYPE
  1135.        SYNTAX      TimeStamp
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141. Expires March 1998                                             [Page 20]
  1142.  
  1143. Internet-Draft               WWW Service MIB              September 1997
  1144.  
  1145.  
  1146.        MAX-ACCESS  read-only
  1147.        STATUS      current
  1148.        DESCRIPTION
  1149.            "The value of sysUpTime when the first byte of the last
  1150.             request of this type was send by this WWW service."
  1151.        ::= { wwwRequestOutEntry 4 }
  1152.  
  1153.    -- The WWW response tables contain detailed information about
  1154.    -- responses send or received by WWW services.
  1155.  
  1156.    wwwResponseInTable OBJECT-TYPE
  1157.        SYNTAX      SEQUENCE OF WwwResponseInEntry
  1158.        MAX-ACCESS  not-accessible
  1159.        STATUS      current
  1160.        DESCRIPTION
  1161.            "The table providing detailed statistics for responses
  1162.             received by WWW services on this system."
  1163.        ::= { wwwProtocolStatistics 4 }
  1164.  
  1165.    wwwResponseInEntry OBJECT-TYPE
  1166.        SYNTAX      WwwResponseInEntry
  1167.        MAX-ACCESS  not-accessible
  1168.        STATUS      current
  1169.        DESCRIPTION
  1170.            "Response statistics for an individual service."
  1171.        INDEX       { wwwServiceIndex, wwwResponseInIndex }
  1172.        ::= { wwwResponseInTable 1 }
  1173.  
  1174.    WwwResponseInEntry ::= SEQUENCE {
  1175.        wwwResponseInIndex          WwwResponseType,
  1176.        wwwResponseInCount          Counter32,
  1177.        wwwResponseInBytes          Counter32,
  1178.        wwwResponseInLastTime       TimeStamp
  1179.    }
  1180.  
  1181.    wwwResponseInIndex OBJECT-TYPE
  1182.        SYNTAX      WwwResponseType
  1183.        MAX-ACCESS  not-accessible
  1184.        STATUS      current
  1185.        DESCRIPTION
  1186.            "The particular response type the statistics apply to."
  1187.        ::= { wwwResponseInEntry 1 }
  1188.  
  1189.    wwwResponseInCount OBJECT-TYPE
  1190.        SYNTAX      Counter32
  1191.        MAX-ACCESS  read-only
  1192.        STATUS      current
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198. Expires March 1998                                             [Page 21]
  1199.  
  1200. Internet-Draft               WWW Service MIB              September 1997
  1201.  
  1202.  
  1203.        DESCRIPTION
  1204.            "The number of responses of this type received by this
  1205.             WWW service."
  1206.        ::= { wwwResponseInEntry 2 }
  1207.  
  1208.    wwwResponseInBytes OBJECT-TYPE
  1209.        SYNTAX      Counter32
  1210.        MAX-ACCESS  read-only
  1211.        STATUS      current
  1212.        DESCRIPTION
  1213.            "The number of content bytes per response type received
  1214.             by this WWW service."
  1215.        ::= { wwwResponseInEntry 3 }
  1216.  
  1217.    wwwResponseInLastTime OBJECT-TYPE
  1218.        SYNTAX      TimeStamp
  1219.        MAX-ACCESS  read-only
  1220.        STATUS      current
  1221.        DESCRIPTION
  1222.            "The value of sysUpTime when the last byte of the last
  1223.             complete response of this type was received by this WWW
  1224.             service."
  1225.        ::= { wwwResponseInEntry 4 }
  1226.  
  1227.    wwwResponseOutTable OBJECT-TYPE
  1228.        SYNTAX      SEQUENCE OF WwwResponseOutEntry
  1229.        MAX-ACCESS  not-accessible
  1230.        STATUS      current
  1231.        DESCRIPTION
  1232.            "The table providing detailed statistics for responses
  1233.             generated by services on this system."
  1234.        ::= { wwwProtocolStatistics 5 }
  1235.  
  1236.    wwwResponseOutEntry OBJECT-TYPE
  1237.        SYNTAX      WwwResponseOutEntry
  1238.        MAX-ACCESS  not-accessible
  1239.        STATUS      current
  1240.        DESCRIPTION
  1241.            "Response statistics for an individual service."
  1242.        INDEX       { wwwServiceIndex, wwwResponseOutIndex }
  1243.        ::= { wwwResponseOutTable 1 }
  1244.  
  1245.    WwwResponseOutEntry ::= SEQUENCE {
  1246.        wwwResponseOutIndex         WwwResponseType,
  1247.        wwwResponseOutCount         Counter32,
  1248.        wwwResponseOutBytes         Counter32,
  1249.        wwwResponseOutLastTime      TimeStamp
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255. Expires March 1998                                             [Page 22]
  1256.  
  1257. Internet-Draft               WWW Service MIB              September 1997
  1258.  
  1259.  
  1260.    }
  1261.  
  1262.    wwwResponseOutIndex OBJECT-TYPE
  1263.        SYNTAX      WwwResponseType
  1264.        MAX-ACCESS  not-accessible
  1265.        STATUS      current
  1266.        DESCRIPTION
  1267.            "The particular response type the statistics apply to."
  1268.        ::= { wwwResponseOutEntry 1 }
  1269.  
  1270.    wwwResponseOutCount OBJECT-TYPE
  1271.        SYNTAX      Counter32
  1272.        MAX-ACCESS  read-only
  1273.        STATUS      current
  1274.        DESCRIPTION
  1275.            "The number of responses of this type generated by this
  1276.             WWW service."
  1277.        ::= { wwwResponseOutEntry 2 }
  1278.  
  1279.    wwwResponseOutBytes OBJECT-TYPE
  1280.        SYNTAX      Counter32
  1281.        MAX-ACCESS  read-only
  1282.        STATUS      current
  1283.        DESCRIPTION
  1284.            "The number of content bytes per response type generated
  1285.             by this WWW service."
  1286.        ::= { wwwResponseOutEntry 3 }
  1287.  
  1288.    wwwResponseOutLastTime OBJECT-TYPE
  1289.        SYNTAX      TimeStamp
  1290.        MAX-ACCESS  read-only
  1291.        STATUS      current
  1292.        DESCRIPTION
  1293.            "The value of sysUpTime when the first byte of the last
  1294.             response of this type was sent by this WWW service."
  1295.        ::= { wwwResponseOutEntry 4 }
  1296.  
  1297.  
  1298.    -- The WWW Document Statistics Group
  1299.    --
  1300.    -- The WWW document statistics group contains statistics about
  1301.    -- document read attempts.
  1302.  
  1303.    wwwDocumentStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 3 }
  1304.  
  1305.    wwwDocCtrlTable OBJECT-TYPE
  1306.        SYNTAX      SEQUENCE OF WwwDocCtrlEntry
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312. Expires March 1998                                             [Page 23]
  1313.  
  1314. Internet-Draft               WWW Service MIB              September 1997
  1315.  
  1316.  
  1317.        MAX-ACCESS  not-accessible
  1318.        STATUS      current
  1319.        DESCRIPTION
  1320.            "A table which controls how the MIB implementation
  1321.             collects and maintains document statistics."
  1322.        ::= { wwwDocumentStatistics 1 }
  1323.  
  1324.    wwwDocCtrlEntry OBJECT-TYPE
  1325.        SYNTAX      WwwDocCtrlEntry
  1326.        MAX-ACCESS  not-accessible
  1327.        STATUS      current
  1328.        DESCRIPTION
  1329.            "An entry which allows to configure the wwwDocLastNTable,
  1330.             the wwwDocBucketTable, the wwwDocAccessTopNTable, and
  1331.             the wwwDocBytesTopNTable."
  1332.        INDEX       { wwwServiceIndex }
  1333.        ::= { wwwDocCtrlTable 1 }
  1334.  
  1335.    WwwDocCtrlEntry ::= SEQUENCE {
  1336.        wwwDocCtrlLastNSize           Unsigned32,
  1337.        wwwDocCtrlLastNStatus         INTEGER,
  1338.        wwwDocCtrlBuckets             Unsigned32,
  1339.        wwwDocCtrlBucketTimeInterval  TimeInterval,
  1340.        wwwDocCtrlTopNSize            Unsigned32
  1341.    }
  1342.  
  1343.    wwwDocCtrlLastNSize OBJECT-TYPE
  1344.        SYNTAX      Unsigned32
  1345.        MAX-ACCESS  read-write
  1346.        STATUS      current
  1347.        DESCRIPTION
  1348.            "The maximum number of entries in the wwwDocLastNTable."
  1349.        DEFVAL { 25 }
  1350.        ::= { wwwDocCtrlEntry 1 }
  1351.  
  1352.    wwwDocCtrlLastNStatus OBJECT-TYPE
  1353.        SYNTAX      INTEGER { enabled(1), disabled(2) }
  1354.        MAX-ACCESS  read-write
  1355.        STATUS      current
  1356.        DESCRIPTION
  1357.            "Indicates whether the wwwDocLastNTable is currently updated
  1358.             by the agent or not. This object allows a manager to
  1359.             suspend the update process in order to retrieve the
  1360.             wwwDocLastNTable in a consistent state. The agent is
  1361.             expected to take a snapshot of the wwwDocLastNTable and to
  1362.             continue updating the table so that recent information is
  1363.             available as soon as the value is changed back to enabled.
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369. Expires March 1998                                             [Page 24]
  1370.  
  1371. Internet-Draft               WWW Service MIB              September 1997
  1372.  
  1373.  
  1374.             Setting this object to enabled if it has not been set to
  1375.             disabled previously by the same manager can interfere with
  1376.             an operation in progress initiated by another manager. It
  1377.             is therefore necessary that managers synchronize their
  1378.             usage of this object."
  1379.        DEFVAL { enabled }
  1380.        ::= { wwwDocCtrlEntry 2 }
  1381.  
  1382.    wwwDocCtrlBuckets OBJECT-TYPE
  1383.        SYNTAX      Unsigned32
  1384.        MAX-ACCESS  read-write
  1385.        STATUS      current
  1386.        DESCRIPTION
  1387.            "The maximum number of buckets maintained by the agent
  1388.             before the oldest bucket is deleted. The buckets are used
  1389.             to populate the wwwDocAccessTopNTable and the
  1390.             wwwDocBytesTopNTable."
  1391.        DEFVAL { 2 }
  1392.        ::= { wwwDocCtrlEntry 3 }
  1393.  
  1394.    wwwDocCtrlBucketTimeInterval OBJECT-TYPE
  1395.        SYNTAX      TimeInterval
  1396.        MAX-ACCESS  read-write
  1397.        STATUS      current
  1398.        DESCRIPTION
  1399.            "The time interval after which a new bucket is created.
  1400.             Changing this object has no effect on existing buckets."
  1401.        DEFVAL { 90000 }    -- 15 minutes (resolution .01 s)
  1402.        ::= { wwwDocCtrlEntry 4 }
  1403.  
  1404.    wwwDocCtrlTopNSize OBJECT-TYPE
  1405.        SYNTAX      Unsigned32
  1406.        MAX-ACCESS  read-write
  1407.        STATUS      current
  1408.        DESCRIPTION
  1409.            "The maximum number of entries shown in the
  1410.             wwwDocAccessTopNTable of the wwwDocBytesTopNTable.
  1411.             Changing this object has no effect on existing buckets."
  1412.        DEFVAL { 25 }
  1413.        ::= { wwwDocCtrlEntry 5 }
  1414.  
  1415.  
  1416.    wwwDocLastNTable OBJECT-TYPE
  1417.        SYNTAX      SEQUENCE OF WwwDocLastNEntry
  1418.        MAX-ACCESS  not-accessible
  1419.        STATUS      current
  1420.        DESCRIPTION
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426. Expires March 1998                                             [Page 25]
  1427.  
  1428. Internet-Draft               WWW Service MIB              September 1997
  1429.  
  1430.  
  1431.            "The table which logs the last N access attempts."
  1432.        ::= { wwwDocumentStatistics 2 }
  1433.  
  1434.    wwwDocLastNEntry OBJECT-TYPE
  1435.        SYNTAX      WwwDocLastNEntry
  1436.        MAX-ACCESS  not-accessible
  1437.        STATUS      current
  1438.        DESCRIPTION
  1439.            "An entry which describes a recent access attempt."
  1440.        INDEX       { wwwServiceIndex, wwwDocLastNIndex }
  1441.        ::= { wwwDocLastNTable 1 }
  1442.  
  1443.    WwwDocLastNEntry ::= SEQUENCE {
  1444.        wwwDocLastNIndex            Unsigned32,
  1445.        wwwDocLastNName             WwwDocName,
  1446.        wwwDocLastNTimeStamp        DateAndTime,
  1447.        wwwDocLastNRequestType      WwwRequestType,
  1448.        wwwDocLastNResponseType     WwwResponseType,
  1449.        wwwDocLastNStatusMsg        DisplayString,
  1450.        wwwDocLastNBytes            Unsigned32
  1451.    }
  1452.  
  1453.    wwwDocLastNIndex OBJECT-TYPE
  1454.        SYNTAX      Unsigned32
  1455.        MAX-ACCESS  not-accessible
  1456.        STATUS      current
  1457.        DESCRIPTION
  1458.            "An arbitrary monotonically increasing integer number used
  1459.             for indexing the wwwDocLastNTable. The first document
  1460.             accessed appears in the table with this index value equal
  1461.             to one. Each subsequent document is indexed with the next
  1462.             sequential index value. The Nth document accessed will be
  1463.             indexed by N. This table presents a sliding window of the
  1464.             last N documents accessed where N is the value of
  1465.             wwwDocCtrlLastNSize. Thus at any given time, the entries in
  1466.             this table will be indexed by N-wwwDocCtrlLastNSize thru
  1467.             N. The wwwDocCtrlLastNStatus attribute should be used to
  1468.             control the updating of this table to allow the manager to
  1469.             read its contents."
  1470.        ::= { wwwDocLastNEntry 1 }
  1471.  
  1472.    wwwDocLastNName OBJECT-TYPE
  1473.        SYNTAX      WwwDocName
  1474.        MAX-ACCESS  read-only
  1475.        STATUS      current
  1476.        DESCRIPTION
  1477.            "The name of the document which was attempted to access."
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483. Expires March 1998                                             [Page 26]
  1484.  
  1485. Internet-Draft               WWW Service MIB              September 1997
  1486.  
  1487.  
  1488.        ::= { wwwDocLastNEntry 2 }
  1489.  
  1490.    wwwDocLastNTimeStamp OBJECT-TYPE
  1491.        SYNTAX      DateAndTime
  1492.        MAX-ACCESS  read-only
  1493.        STATUS      current
  1494.        DESCRIPTION
  1495.            "The date and time that this document was attempted
  1496.             to access."
  1497.        ::= { wwwDocLastNEntry 3 }
  1498.  
  1499.    wwwDocLastNRequestType OBJECT-TYPE
  1500.        SYNTAX      WwwRequestType
  1501.        MAX-ACCESS  read-only
  1502.        STATUS      current
  1503.        DESCRIPTION
  1504.            "The protocol request type which was received by the
  1505.             server when this document access was attempted."
  1506.        ::= { wwwDocLastNEntry 4 }
  1507.  
  1508.    wwwDocLastNResponseType OBJECT-TYPE
  1509.        SYNTAX      WwwResponseType
  1510.        MAX-ACCESS  read-only
  1511.        STATUS      current
  1512.        DESCRIPTION
  1513.            "The protocol response type which was sent to the client
  1514.             as a result of this attempt to access a document. This
  1515.             object contains the type of the primary response in case
  1516.             there were multiple responses to a single request."
  1517.        ::= { wwwDocLastNEntry 5 }
  1518.  
  1519.    wwwDocLastNStatusMsg OBJECT-TYPE
  1520.        SYNTAX      DisplayString
  1521.        MAX-ACCESS  read-only
  1522.        STATUS      current
  1523.        DESCRIPTION
  1524.            "This object contains a human readable description of the
  1525.             reason why the wwwDocLastNResponseType has been returned to
  1526.             the client. This object defines the implementation specific
  1527.             reason if the value of wwwDocLastNResponseType indicates an
  1528.             error. For example, this object can indicate that the
  1529.             requested document could not be transferred due to a
  1530.             timeout condition or the document could not be transferred
  1531.             because a 'soft link' pointing to the document could not be
  1532.             resolved."
  1533.        ::= { wwwDocLastNEntry 6 }
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540. Expires March 1998                                             [Page 27]
  1541.  
  1542. Internet-Draft               WWW Service MIB              September 1997
  1543.  
  1544.  
  1545.    wwwDocLastNBytes OBJECT-TYPE
  1546.        SYNTAX      Unsigned32
  1547.        MAX-ACCESS  read-only
  1548.        STATUS      current
  1549.        DESCRIPTION
  1550.            "The number of content bytes that were returned as a
  1551.             result of this attempt to access a document."
  1552.        ::= { wwwDocLastNEntry 7 }
  1553.  
  1554.  
  1555.    wwwDocBucketTable OBJECT-TYPE
  1556.        SYNTAX      SEQUENCE OF WwwDocBucketEntry
  1557.        MAX-ACCESS  not-accessible
  1558.        STATUS      current
  1559.        DESCRIPTION
  1560.            "This table provides administrative summary information for
  1561.             the buckets maintained per WWW service."
  1562.        ::= { wwwDocumentStatistics 3 }
  1563.  
  1564.    wwwDocBucketEntry OBJECT-TYPE
  1565.        SYNTAX      WwwDocBucketEntry
  1566.        MAX-ACCESS  not-accessible
  1567.        STATUS      current
  1568.        DESCRIPTION
  1569.            "An entry which describes the parameters associated with a
  1570.             particular bucket."
  1571.        INDEX       { wwwServiceIndex, wwwDocBucketIndex }
  1572.        ::= { wwwDocBucketTable 1 }
  1573.  
  1574.    WwwDocBucketEntry ::= SEQUENCE {
  1575.        wwwDocBucketIndex           Unsigned32,
  1576.        wwwDocBucketTimeStamp       TimeStamp,
  1577.        wwwDocBucketAccesses        Unsigned32,
  1578.        wwwDocBucketDocuments       Unsigned32,
  1579.        wwwDocBucketBytes           Unsigned32
  1580.    }
  1581.  
  1582.    wwwDocBucketIndex OBJECT-TYPE
  1583.        SYNTAX      Unsigned32
  1584.        MAX-ACCESS  not-accessible
  1585.        STATUS      current
  1586.        DESCRIPTION
  1587.            "An arbitrary monotonically increasing integer number
  1588.             used for indexing the wwwDocBucketTable. The index number
  1589.             wraps to 1 whenever the maximum value is reached."
  1590.        ::= { wwwDocBucketEntry 1 }
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597. Expires March 1998                                             [Page 28]
  1598.  
  1599. Internet-Draft               WWW Service MIB              September 1997
  1600.  
  1601.  
  1602.    wwwDocBucketTimeStamp OBJECT-TYPE
  1603.        SYNTAX      TimeStamp
  1604.        MAX-ACCESS  read-only
  1605.        STATUS      current
  1606.        DESCRIPTION
  1607.            "The value of sysUpTime when the bucket was made available."
  1608.        ::= { wwwDocBucketEntry 2 }
  1609.  
  1610.    wwwDocBucketAccesses OBJECT-TYPE
  1611.        SYNTAX      Unsigned32
  1612.        MAX-ACCESS  read-only
  1613.        STATUS      current
  1614.        DESCRIPTION
  1615.            "The total number of access attempts for any document
  1616.             provided by this WWW service during the time interval
  1617.             over which this bucket was created."
  1618.        ::= { wwwDocBucketEntry 3 }
  1619.  
  1620.    wwwDocBucketDocuments OBJECT-TYPE
  1621.        SYNTAX      Unsigned32
  1622.        MAX-ACCESS  read-only
  1623.        STATUS      current
  1624.        DESCRIPTION
  1625.            "The total number of different documents which were
  1626.             attempted to be read from this this WWW service during
  1627.             the time interval over which this bucket was created."
  1628.        ::= { wwwDocBucketEntry 4 }
  1629.  
  1630.    wwwDocBucketBytes OBJECT-TYPE
  1631.        SYNTAX      Unsigned32
  1632.        MAX-ACCESS  read-only
  1633.        STATUS      current
  1634.        DESCRIPTION
  1635.            "The total number of content bytes which were transferred
  1636.             from this WWW service during the time interval over which
  1637.             this bucket was created."
  1638.        ::= { wwwDocBucketEntry 5 }
  1639.  
  1640.  
  1641.    wwwDocAccessTopNTable OBJECT-TYPE
  1642.        SYNTAX      SEQUENCE OF WwwDocAccessTopNEntry
  1643.        MAX-ACCESS  not-accessible
  1644.        STATUS      current
  1645.        DESCRIPTION
  1646.            "The table of the most frequently accessed documents in a
  1647.             given bucket."
  1648.        ::= { wwwDocumentStatistics 4 }
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654. Expires March 1998                                             [Page 29]
  1655.  
  1656. Internet-Draft               WWW Service MIB              September 1997
  1657.  
  1658.  
  1659.    wwwDocAccessTopNEntry OBJECT-TYPE
  1660.        SYNTAX      WwwDocAccessTopNEntry
  1661.        MAX-ACCESS  not-accessible
  1662.        STATUS      current
  1663.        DESCRIPTION
  1664.            "An entry in the top N table sorted by document accesses."
  1665.        INDEX       { wwwServiceIndex, wwwDocBucketIndex,
  1666.                      wwwDocAccessTopNIndex }
  1667.        ::= { wwwDocAccessTopNTable 1 }
  1668.  
  1669.    WwwDocAccessTopNEntry ::= SEQUENCE {
  1670.        wwwDocAccessTopNIndex             Unsigned32,
  1671.        wwwDocAccessTopNName              WwwDocName,
  1672.        wwwDocAccessTopNAccesses          Unsigned32,
  1673.        wwwDocAccessTopNBytes             Unsigned32,
  1674.        wwwDocAccessTopNLastResponseType  WwwResponseType
  1675.    }
  1676.  
  1677.    wwwDocAccessTopNIndex OBJECT-TYPE
  1678.        SYNTAX      Unsigned32
  1679.        MAX-ACCESS  not-accessible
  1680.        STATUS      current
  1681.        DESCRIPTION
  1682.            "An arbitrary monotonically increasing integer number
  1683.             used for indexing the wwwDocAccessTopNTable. The index is
  1684.             inversely correlated to the sorting order of the table. The
  1685.             document with the highest access count will get the index
  1686.             value 1."
  1687.        ::= { wwwDocAccessTopNEntry 1 }
  1688.  
  1689.    wwwDocAccessTopNName OBJECT-TYPE
  1690.        SYNTAX      WwwDocName
  1691.        MAX-ACCESS  read-only
  1692.        STATUS      current
  1693.        DESCRIPTION
  1694.            "The name of the document which was attempted to access."
  1695.        ::= { wwwDocAccessTopNEntry 2 }
  1696.  
  1697.    wwwDocAccessTopNAccesses OBJECT-TYPE
  1698.        SYNTAX      Unsigned32
  1699.        MAX-ACCESS  read-only
  1700.        STATUS      current
  1701.        DESCRIPTION
  1702.            "The total number of access attempts for this document."
  1703.        ::= { wwwDocAccessTopNEntry 3 }
  1704.  
  1705.    wwwDocAccessTopNBytes OBJECT-TYPE
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711. Expires March 1998                                             [Page 30]
  1712.  
  1713. Internet-Draft               WWW Service MIB              September 1997
  1714.  
  1715.  
  1716.        SYNTAX      Unsigned32
  1717.        MAX-ACCESS  read-only
  1718.        STATUS      current
  1719.        DESCRIPTION
  1720.            "The total number of content bytes that were transmitted
  1721.             as a result of attempts to access this document."
  1722.        ::= { wwwDocAccessTopNEntry 4 }
  1723.  
  1724.    wwwDocAccessTopNLastResponseType OBJECT-TYPE
  1725.        SYNTAX      WwwResponseType
  1726.        MAX-ACCESS  read-only
  1727.        STATUS      current
  1728.        DESCRIPTION
  1729.            "The protocol response type which was sent to the client
  1730.             as a result of the last attempt to access this document.
  1731.             This object contains the type of the primary response in
  1732.             case there were multiple responses to a single request."
  1733.        ::= { wwwDocAccessTopNEntry 5 }
  1734.  
  1735.  
  1736.    wwwDocBytesTopNTable OBJECT-TYPE
  1737.        SYNTAX      SEQUENCE OF WwwDocBytesTopNEntry
  1738.        MAX-ACCESS  not-accessible
  1739.        STATUS      current
  1740.        DESCRIPTION
  1741.            "The table of the documents which caused most of the network
  1742.             traffic in a given bucket."
  1743.        ::= { wwwDocumentStatistics 5 }
  1744.  
  1745.    wwwDocBytesTopNEntry OBJECT-TYPE
  1746.        SYNTAX      WwwDocBytesTopNEntry
  1747.        MAX-ACCESS  not-accessible
  1748.        STATUS      current
  1749.        DESCRIPTION
  1750.            "An entry in the top N table sorted by network traffic."
  1751.        INDEX       { wwwServiceIndex, wwwDocBucketIndex,
  1752.                      wwwDocBytesTopNIndex }
  1753.        ::= { wwwDocBytesTopNTable 1 }
  1754.  
  1755.    WwwDocBytesTopNEntry ::= SEQUENCE {
  1756.        wwwDocBytesTopNIndex             Unsigned32,
  1757.        wwwDocBytesTopNName              WwwDocName,
  1758.        wwwDocBytesTopNAccesses          Unsigned32,
  1759.        wwwDocBytesTopNBytes             Unsigned32,
  1760.        wwwDocBytesTopNLastResponseType  WwwResponseType
  1761.    }
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768. Expires March 1998                                             [Page 31]
  1769.  
  1770. Internet-Draft               WWW Service MIB              September 1997
  1771.  
  1772.  
  1773.    wwwDocBytesTopNIndex OBJECT-TYPE
  1774.        SYNTAX      Unsigned32
  1775.        MAX-ACCESS  not-accessible
  1776.        STATUS      current
  1777.        DESCRIPTION
  1778.            "An arbitrary monotonically increasing integer number
  1779.             used for indexing the wwwDocBytesTopNTable. The index is
  1780.             inversely correlated to the sorting order of the table. The
  1781.             document with the highest byte count will get the index
  1782.             value 1."
  1783.        ::= { wwwDocBytesTopNEntry 1 }
  1784.  
  1785.    wwwDocBytesTopNName OBJECT-TYPE
  1786.        SYNTAX      WwwDocName
  1787.        MAX-ACCESS  read-only
  1788.        STATUS      current
  1789.        DESCRIPTION
  1790.            "The name of the document which was attempted to access."
  1791.        ::= { wwwDocBytesTopNEntry 2 }
  1792.  
  1793.    wwwDocBytesTopNAccesses OBJECT-TYPE
  1794.        SYNTAX      Unsigned32
  1795.        MAX-ACCESS  read-only
  1796.        STATUS      current
  1797.        DESCRIPTION
  1798.            "The total number of access attempts for this document."
  1799.        ::= { wwwDocBytesTopNEntry 3 }
  1800.  
  1801.    wwwDocBytesTopNBytes OBJECT-TYPE
  1802.        SYNTAX      Unsigned32
  1803.        MAX-ACCESS  read-only
  1804.        STATUS      current
  1805.        DESCRIPTION
  1806.            "The total number of content bytes that were transmitted
  1807.             as a result of attempts to access this document."
  1808.        ::= { wwwDocBytesTopNEntry 4 }
  1809.  
  1810.    wwwDocBytesTopNLastResponseType OBJECT-TYPE
  1811.        SYNTAX      WwwResponseType
  1812.        MAX-ACCESS  read-only
  1813.        STATUS      current
  1814.        DESCRIPTION
  1815.            "The protocol response type which was sent to the client
  1816.             as a result of the last attempt to access this document.
  1817.             This object contains the type of the primary response in
  1818.             case there were multiple responses to a single request."
  1819.        ::= { wwwDocBytesTopNEntry 5 }
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825. Expires March 1998                                             [Page 32]
  1826.  
  1827. Internet-Draft               WWW Service MIB              September 1997
  1828.  
  1829.  
  1830.    --
  1831.    -- Conformance Definitions
  1832.    --
  1833.  
  1834.    wwwMIBCompliances OBJECT IDENTIFIER ::= { wwwMIBConformance 1 }
  1835.    wwwMIBGroups      OBJECT IDENTIFIER ::= { wwwMIBConformance 2 }
  1836.  
  1837.    wwwMinimalCompliance MODULE-COMPLIANCE
  1838.        STATUS      current
  1839.        DESCRIPTION
  1840.            "The compliance statement for SNMP agents which implement
  1841.             the minimal subset of the WWW-MIB. Implementors might
  1842.             choose this subset for high-performance server where
  1843.             full compliance might be to expensive."
  1844.        MODULE  -- this module
  1845.        MANDATORY-GROUPS {
  1846.            wwwServiceGroup,
  1847.            wwwSummaryGroup
  1848.        }
  1849.        ::= { wwwMIBCompliances 1 }
  1850.  
  1851.    wwwFullCompliance MODULE-COMPLIANCE
  1852.        STATUS      current
  1853.        DESCRIPTION
  1854.            "The compliance statement for SNMP agents which implement
  1855.             the full WWW-MIB.
  1856.  
  1857.             The wwwRequestInTable and wwwResponseOutTable tables will
  1858.             always be empty for a pure WWW client implementation and
  1859.             wwwSummaryInRequests and wwwSummaryOutResponses will both
  1860.             be zero.
  1861.  
  1862.             The wwwRequestOutTable and wwwResponseInTable tables will
  1863.             always be empty for a pure WWW server implementation and
  1864.             wwwSummaryOutRequests and wwwSummaryInResponses will both
  1865.             be zero.
  1866.  
  1867.             An implementation for a WWW proxy must be capable to
  1868.             populate all tables."
  1869.        MODULE  -- this module
  1870.        MANDATORY-GROUPS {
  1871.            wwwServiceGroup,
  1872.            wwwSummaryGroup,
  1873.            wwwRequestInGroup,
  1874.            wwwRequestOutGroup,
  1875.            wwwResponseInGroup,
  1876.            wwwResponseOutGroup,
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882. Expires March 1998                                             [Page 33]
  1883.  
  1884. Internet-Draft               WWW Service MIB              September 1997
  1885.  
  1886.  
  1887.            wwwDocumentGroup
  1888.        }
  1889.        ::= { wwwMIBCompliances 2 }
  1890.  
  1891.    wwwServiceGroup OBJECT-GROUP
  1892.        OBJECTS {
  1893.            wwwServiceDescription,
  1894.            wwwServiceContact,
  1895.            wwwServiceProtocol,
  1896.            wwwServiceName,
  1897.            wwwServiceType,
  1898.            wwwServiceUptime,
  1899.            wwwServiceOperStatus,
  1900.            wwwServiceLastChange
  1901.        }
  1902.        STATUS      current
  1903.        DESCRIPTION
  1904.            "A collection of objects providing information about
  1905.             the WWW services known by the SNMP agent."
  1906.        ::= { wwwMIBGroups 1 }
  1907.  
  1908.    wwwSummaryGroup OBJECT-GROUP
  1909.        OBJECTS {
  1910.            wwwSummaryInRequests,
  1911.            wwwSummaryOutRequests,
  1912.            wwwSummaryInResponses,
  1913.            wwwSummaryOutResponses,
  1914.            wwwSummaryInBytes,
  1915.            wwwSummaryInBytesLow,
  1916.            wwwSummaryOutBytes,
  1917.            wwwSummaryOutBytesLow
  1918.        }
  1919.        STATUS      current
  1920.        DESCRIPTION
  1921.            "A collection of objects providing summary statistics
  1922.             about requests and responses generated and received
  1923.             by a WWW service."
  1924.        ::= { wwwMIBGroups 2 }
  1925.  
  1926.    wwwRequestInGroup OBJECT-GROUP
  1927.        OBJECTS {
  1928.            wwwRequestInCount,
  1929.            wwwRequestInBytes,
  1930.            wwwRequestInLastTime
  1931.        }
  1932.        STATUS      current
  1933.        DESCRIPTION
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939. Expires March 1998                                             [Page 34]
  1940.  
  1941. Internet-Draft               WWW Service MIB              September 1997
  1942.  
  1943.  
  1944.            "A collection of objects providing detailed statistics
  1945.             about requests received by a WWW service."
  1946.        ::= { wwwMIBGroups 3 }
  1947.  
  1948.    wwwRequestOutGroup OBJECT-GROUP
  1949.        OBJECTS {
  1950.            wwwRequestOutCount,
  1951.            wwwRequestOutBytes,
  1952.            wwwRequestOutLastTime
  1953.        }
  1954.        STATUS      current
  1955.        DESCRIPTION
  1956.            "A collection of objects providing detailed statistics
  1957.             about requests generated by a WWW service."
  1958.        ::= { wwwMIBGroups 4 }
  1959.  
  1960.    wwwResponseInGroup OBJECT-GROUP
  1961.        OBJECTS {
  1962.            wwwResponseInCount,
  1963.            wwwResponseInBytes,
  1964.            wwwResponseInLastTime
  1965.        }
  1966.        STATUS      current
  1967.        DESCRIPTION
  1968.            "A collection of objects providing detailed statistics
  1969.             about responses received by a WWW service."
  1970.        ::= { wwwMIBGroups 5 }
  1971.  
  1972.    wwwResponseOutGroup OBJECT-GROUP
  1973.        OBJECTS {
  1974.            wwwResponseOutCount,
  1975.            wwwResponseOutBytes,
  1976.            wwwResponseOutLastTime
  1977.        }
  1978.        STATUS      current
  1979.        DESCRIPTION
  1980.            "A collection of objects providing detailed statistics
  1981.             about responses generated by a WWW service."
  1982.        ::= { wwwMIBGroups 6 }
  1983.  
  1984.    wwwDocumentGroup OBJECT-GROUP
  1985.        OBJECTS {
  1986.            wwwDocCtrlLastNSize,
  1987.            wwwDocCtrlLastNStatus,
  1988.            wwwDocCtrlBuckets,
  1989.            wwwDocCtrlBucketTimeInterval,
  1990.            wwwDocCtrlTopNSize,
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996. Expires March 1998                                             [Page 35]
  1997.  
  1998. Internet-Draft               WWW Service MIB              September 1997
  1999.  
  2000.  
  2001.            wwwDocLastNName,
  2002.            wwwDocLastNTimeStamp,
  2003.            wwwDocLastNRequestType,
  2004.            wwwDocLastNResponseType,
  2005.            wwwDocLastNStatusMsg,
  2006.            wwwDocLastNBytes,
  2007.            wwwDocBucketTimeStamp,
  2008.            wwwDocBucketAccesses,
  2009.            wwwDocBucketDocuments,
  2010.            wwwDocBucketBytes,
  2011.            wwwDocAccessTopNName,
  2012.            wwwDocAccessTopNAccesses,
  2013.            wwwDocAccessTopNBytes,
  2014.            wwwDocAccessTopNLastResponseType,
  2015.            wwwDocBytesTopNName,
  2016.            wwwDocBytesTopNAccesses,
  2017.            wwwDocBytesTopNBytes,
  2018.            wwwDocBytesTopNLastResponseType
  2019.        }
  2020.        STATUS  current
  2021.        DESCRIPTION
  2022.            "A collection of objects providing information about
  2023.             accesses to documents."
  2024.        ::= { wwwMIBGroups 7 }
  2025.  
  2026.    END
  2027.  
  2028.  
  2029. 7.  Document Transfer Protocol Mappings
  2030.  
  2031.    This section describes how existing protocols such as HTTP [7,8] and
  2032.    FTP [9] can be mapped on the abstract Document Transfer Protocol
  2033.    (DTP) used within the definitions of the WWW MIB. Every mapping must
  2034.    define the identifier which is used to uniquely identify the transfer
  2035.    protocol. In addition, the mappings must define how requests and
  2036.    responses are identified.
  2037.  
  2038.  
  2039. 7.1.  The HyperText Transfer Protocol
  2040.  
  2041.    The HyperText Transfer Protocol (HTTP) [7,8] is an application-level
  2042.    protocol used to transfer hypermedia documents in a distributed
  2043.    networked environment. HTTP is based on the request/response paradigm
  2044.    and can be mapped on the abstract DTP easily.
  2045.  
  2046.    The HTTP protocol usually runs over TCP and uses the well-known TCP
  2047.    port 80. Therefore, the default value for the wwwServiceProtocol
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053. Expires March 1998                                             [Page 36]
  2054.  
  2055. Internet-Draft               WWW Service MIB              September 1997
  2056.  
  2057.  
  2058.    object is { applTCPProtoID 80 }.
  2059.  
  2060.    HTTP allows for both requests and responses an open-ended set of
  2061.    message types. The general messages syntax of HTTP is therefore used
  2062.    for the protocol mapping. The BNF specification of the general HTTP
  2063.    message syntax as defined in [8] is as follows:
  2064.  
  2065.        HTTP-message = start-line
  2066.                       *message-header
  2067.                       CRLF
  2068.                       [ message-body ]
  2069.  
  2070.        start-line   = Request-Line | Status-Line
  2071.  
  2072.        Request-Line = Method SP Request-URI SP HTTP-Version CRLF
  2073.  
  2074.        Status-Line  = HTTP-Version SP Status-Code SP Reason-Phrase CRLF
  2075.  
  2076.    Every HTTP-message where the start-line is a Request-Line is
  2077.    considered a request in the abstract DTP. Every HTTP-message where
  2078.    the start-line is a Status-Line is considered a response in the
  2079.    abstract DTP. The mappings of wwwRequestType and wwwResponseType are
  2080.    defined as follows:
  2081.  
  2082.    o    The wwwRequestType corresponds to the method token in the
  2083.         Request-Line.
  2084.  
  2085.    o    The wwwResponseType corresponds to the Status-Code in the
  2086.         Status-Line.
  2087.  
  2088.  
  2089. 7.2.  The File Transfer Protocol
  2090.  
  2091.    The File Transfer Protocol (FTP) [9] is an application-level protocol
  2092.    used to transfer files between hosts connected by the TCP/IP suite of
  2093.    protocols. FTP is based on a request/response paradigm and is mapped
  2094.    on the abstract DTP as defined in this section. The FTP model as
  2095.    defined in [9] is depicted below.
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110. Expires March 1998                                             [Page 37]
  2111.  
  2112. Internet-Draft               WWW Service MIB              September 1997
  2113.  
  2114.  
  2115.                                               -------------
  2116.                                               |+---------+|
  2117.                                               ||   User  ||    --------
  2118.                                               ||Interface|<--->| User |
  2119.                                               |+----|----+|    --------
  2120.                 ----------                    |     |     |
  2121.                 |+------+| control connection |+----|----+|
  2122.                 ||Server|<------------------->||  Client ||
  2123.                 ||  PI  ||  Commands/Replies  ||    PI   ||
  2124.                 |+--|---+|                    |+----|----+|
  2125.                 |   |    |                    |     |     |
  2126.     --------    |+--|---+|        Data        |+----|----+|    --------
  2127.     | File |<--->|Server|<------------------->||  Client |<--->| File |
  2128.     |System|    || DTP  ||     Connection     ||   DTP   ||    |System|
  2129.     --------    |+------+|                    |+---------+|    --------
  2130.                 ----------                    -------------
  2131.  
  2132.    FTP uses two different connection types between a client and a server
  2133.    to transfer files. The control connection is persistent during a FTP
  2134.    session and used to exchange FTP commands and associated replies. The
  2135.    data connection is only available when bulk data has to be
  2136.    transferred.
  2137.  
  2138.    The FTP protocol usually runs over TCP and uses the well-known TCP
  2139.    port 21 to setup the control connection. Therefore, the default value
  2140.    for the wwwServiceProtocol object is { applTCPProtoID 21 }.
  2141.  
  2142.    Every FTP command is considered a request in the abstract DTP. Every
  2143.    FTP reply is considered a response in the abstract DTP. It should be
  2144.    noted that a single FTP command can result in multiple FTP replies
  2145.    (e.g. preliminary positive replies). The primary response for a FTP
  2146.    request contains a status code of the form 2xy, 3xy, 4xy or 5xy.  See
  2147.    section 4.2 in [9] for the exact meaning of these status codes.  The
  2148.    mappings for wwwRequestType and wwwResponseType are defined as
  2149.    follows:
  2150.  
  2151.    o    The wwwRequestType corresponds to the FTP command token.
  2152.  
  2153.    o    The wwwResponseType corresponds to the three-digit code which
  2154.         starts a reply. Multi-line replies with the same three-digit
  2155.         code are counted as a single DTP response.
  2156.  
  2157.  
  2158. 8.  Security Considerations
  2159.  
  2160.    The MIB objects defined in the memo might disclose information that
  2161.    should be protected. In particular, the document statistics group
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167. Expires March 1998                                             [Page 38]
  2168.  
  2169. Internet-Draft               WWW Service MIB              September 1997
  2170.  
  2171.  
  2172.    contains traffic information, which includes the names of documents
  2173.    that were a target of protocol operations. It is therefore adviced to
  2174.    use SNMP access control and SNMP security mechanism (where available)
  2175.    in order to protect this information in sensitive environments.
  2176.  
  2177.    The protocol statistics are less sensitive, because they do not
  2178.    contain details about the target of individual requests/responses.
  2179.    However, it is suggested that sites configure MIB views so that a
  2180.    user of this MIB can only see the portion of the statistics that
  2181.    belong to the WWW services managed by that user.
  2182.  
  2183.  
  2184. 9.  Acknowledgments
  2185.  
  2186.    This document was produced by the Application MIB working group.  The
  2187.    editors gratefully acknowledge the comments of the following
  2188.    individuals:
  2189.  
  2190.        Mark Gamble, Cheryl Krupczak, Randy Preshun, John Saperia,
  2191.        Bob Stewart, Martin Toet, Chris Wellens
  2192.  
  2193.  
  2194. 10.  Editors' Address
  2195.  
  2196.  
  2197.      Harrie Hazewinkel
  2198.      MUSIQ/DESIRE/CEO Program
  2199.      Institute for Space Applications
  2200.      Joint Research Centre of the E.C.
  2201.      via Fermi - Ispra 21020 (VA)
  2202.      Italy                               Tel: +39 (0)332 789384
  2203.      harrie.hazewinkel@jrc.it            Fax: +39 (0)332 785500
  2204.  
  2205.      Carl W. Kalbfleisch
  2206.      Verio, Inc.
  2207.      1950 Stemmons Frwy
  2208.      2004 INFOMART
  2209.      Dallas, TX 75207
  2210.      USA                                 Tel: +1 972 238-8303
  2211.      cwk@verio.net                       Fax: +1 972 238-0268
  2212.  
  2213.      Juergen Schoenwaelder
  2214.      Computer Science Department
  2215.      University of Twente
  2216.      P.O. Box 217, NL-7500 AE Enschede
  2217.      The Netherlands                     Tel: +31 53 489-3678
  2218.      schoenw@cs.utwente.nl               Fax: +31 53 489-3247
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224. Expires March 1998                                             [Page 39]
  2225.  
  2226. Internet-Draft               WWW Service MIB              September 1997
  2227.  
  2228.  
  2229. 11.  References
  2230.  
  2231. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2232.      Waldbusser, "Structure of Management Information for Version 2 of
  2233.      the Simple Network Management Protocol (SNMPv2)", RFC1902, SNMP
  2234.      Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  2235.      International Network Services, January 1996.
  2236.  
  2237. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  2238.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  2239.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  2240.      March 1991.
  2241.  
  2242. [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  2243.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  2244.      International, Performance Systems International, MIT Laboratory
  2245.      for Computer Science, May 1990.
  2246.  
  2247. [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  2248.      Waldbusser, "Protocol Operations for Version 2 of the Simple
  2249.      Network Management Protocol (SNMPv2)", RFC1905, SNMP Research,Inc.,
  2250.      Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  2251.      Network Services, January 1996.
  2252.  
  2253. [5]  T. Berners-Lee, "Universal Resource Identifiers in WWW", RFC 1630,
  2254.      CERN, June 1994.
  2255.  
  2256. [6]  Berners-Lee, T., Masinter, L., and M. McCahill, "Uniform Resource
  2257.      Locators (URL)", RFC 1738, CERN, Xerox Corporation, University of
  2258.      Minnesota, December 1994.
  2259.  
  2260. [7]  Berners-Lee, T., Fielding, R., and H. Frystyk, "Hypertext Transfer
  2261.      Protocol -- HTTP/1.0", RFC 1945, MIT/LCS, UC Irvine, MIT/LCS, May
  2262.      1996.
  2263.  
  2264. [8]  Fielding, R., Gettys, J., Mogul, J., Frystyk, H., and T. Berners-
  2265.      Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC 2068, UC
  2266.      Irvine, DEC, DEC, MIT/LCS, January 1997.
  2267.  
  2268. [9]  Postel, J., and J.K. Reynolds, "File Transfer Protocol (FTP)", STD
  2269.      9, RFC 959, USC/ISI, October 1985.
  2270.  
  2271. [10] C. Kalbfleisch, "Applicability of Standards Track MIBs to
  2272.      Management of World Wide Web Servers", RFC 2039, OnRamp
  2273.      Technologies, November 1996.
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281. Expires March 1998                                             [Page 40]
  2282.  
  2283. Internet-Draft               WWW Service MIB              September 1997
  2284.  
  2285.  
  2286. [11] Krupczak, C., and J. Saperia, "Definitions of System-Level Managed
  2287.      Objects for Applications", draft-ietf-applmib-sysapplmib-08.txt,
  2288.      Empire Technologies, BGS Systems, March 1997.
  2289.  
  2290. [12] Kalbfleisch, C., Krupczak, C., Preshun, R., and J. Saperia,
  2291.      "Application Management MIB", draft-ietf-applmib-mib-04.txt, Verio,
  2292.      Empire Technologies, BMC Software, BGS Systems, July 1997.
  2293.  
  2294. [13] Kantor, B., and P. Lapsley, "Network News Transfer Protocol: A
  2295.      Proposed Standard for the Stream-Based Transmission of News", RFC
  2296.      977, UC San Diego & UC Berkeley, February 1986.
  2297.  
  2298. [14] Callaghan, B., "WebNFS Client Specification", RFC 2054, Sun
  2299.      Microsystems, October 1996
  2300.  
  2301. [15] Callaghan, B., "WebNFS Server Specification", RFC 2055, Sun
  2302.      Microsystems, October 1996
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338. Expires March 1998                                             [Page 41]
  2339.  
  2340. Internet-Draft               WWW Service MIB              September 1997
  2341.  
  2342.  
  2343.    Table of Contents
  2344.  
  2345.  
  2346.    1 Abstract .....................................................    2
  2347.    2 The SNMPv2 Network Management Framework ......................    2
  2348.    2.1 Object Definitions .........................................    2
  2349.    3 Terminology ..................................................    3
  2350.    4 Overview .....................................................    4
  2351.    4.1 Purpose and Requirements ...................................    4
  2352.    4.2 Relationship to other Standards Efforts ....................    5
  2353.    4.3 WWW Services ...............................................    5
  2354.    4.4 Document Transfer Protocol .................................    6
  2355.    5 Structure of the MIB .........................................    7
  2356.    5.1 Service Information Group ..................................    7
  2357.    5.2 Protocol Statistics Group ..................................    7
  2358.    5.3 Document Statistics Group ..................................    8
  2359.    6 Definitions ..................................................   10
  2360.    7 Document Transfer Protocol Mappings ..........................   36
  2361.    7.1 The HyperText Transfer Protocol ............................   36
  2362.    7.2 The File Transfer Protocol .................................   37
  2363.    8 Security Considerations ......................................   38
  2364.    9 Acknowledgments ..............................................   39
  2365.    10 Editors' Address ............................................   39
  2366.    11 References ..................................................   40
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395. Expires March 1998                                             [Page 42]
  2396.  
  2397.