Internet Draft HTTP MIB April 22,1996 Definitions of Managed Objects for HTTP April 22, 1996 Harrie Hazewinkel University of Twente hazewink@cs.utwente.nl Eric van Hengstum University of Twente hengstum@cs.utwente.nl Aiko Pras University of Twente pras@cs.utwente.nl Status of this Memo This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as ``work in progress.'' To learn the current status of any Internet-Draft, please check the ``1id-abstracts.txt'' listing contained in the Internet- Drafts Shadow Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim). Expires October 22, 1996 [Page 1] Internet Draft HTTP MIB April 22,1996 1. Abstract This draft defines a MIB to manage the HTTP protocol. The HTTP protocol is used by World Wide Web applications to transfer information between WWW clients and WWW servers. HTTP is based on the request/response paradigm. The HTTP MIB is especially useful to manage the WWW server-side. The MIB is defined in such a way that it allows multiple servers to run within a single system. Expires October 22, 1996 [Page 2] Internet Draft HTTP MIB April 22,1996 2. The SNMPv2 Network Management Framework The SNMPv2 Network Management Framework consists of four major components. They are: o STD 17, RFC 1213 [2] defines MIB-II, the core set of managed objects for the Internet suite of protocols. o RFC 1901 Introduction to Community-based SNMPv2 o RFC 1902 Structure of Management Information for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1903 Textual Conventions for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1904 Conformance Statements for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1907 Management Information Base for Version 2 of the Simple Network Management Protocol (SNMPv2) o RFC 1908 Coexistence between Version 1 and Version 2 of the Internet-standard Network Management Framework The Framework permits new objects to be defined for the purpose of experimentation and evaluation. 2.1. Object Definitions Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI[1]. In particular, each object type is named by an OBJECT IDENTIFIER, an administratively assigned name. The object type together with an object instance serves to uniquely identify a specific instantiation of the object. For human convenience, we often use a textual string, termed the object descriptor, to refer to the object type. Expires October 22, 1996 [Page 3] Internet Draft HTTP MIB April 22,1996 3. Introduction. The HTTP protocol instantiates the information transport in the WWW application which is done with protocol entities exchanging information with each other via the underlying service. The work performed for this MIB is a result of a project performed for the Centre of Earth Observations. The document should not be considered to be complete, but should be seen as a first step towards standardization of WWW management. An implementation of this MIB already exists. Due to the use of a commercial development package it cannot be distributed. However, a public domain version is now being developed. Expires October 22, 1996 [Page 4] Internet Draft HTTP MIB April 22,1996 4. HyperText Transfer Protocol MIB structure The HTTP MIB module contains detailed network management information concerning HTTP. The MIB module is divided into entity- and traffic-related information. The HTTP MIB consists of three groups: 1. httpSystem, 2. httpStatistics, and 3. httpTimeOuts. 4.1. System group The System group consists of the httpEntityTable. This table contains not only basic network management information for (potentially) multiple HTTP entities running on a single host machine, but also entity information for virtual domains which give the physical interface of the host multiple addresses. The table is indexed with a unique number specifying the entity in the table which is also used as index of the other tables in this MIB. For each entity the following information is provided and: - The protocol implemented by the entity; this value should be derived from the assigned number for the service; in the case of HTTP, this would be 80. - A brief description of the entity and a contact e-mail address for the person responsible. - The version of the protocol implemented by the entity, the producer of the software, the release version, and (optionally) an object identifier for the producer. - Configuration information such as the address of the host machine (both in text form and as an IP address), the port in use, the time of last initialization, and whether the entity is a client, server, proxy, or a caching proxy. 4.2. Statistics group The Statistics group provides network management information for the network traffic received and transmitted by the entity. The group consists of the httpSummaryTable, the httpRequestTable, and the httpResponseTable. - The SummaryTable contains a set of counters for each HTTP entity which provide a quick summary of the number of requests received, bytes transmitted, and so on. The SummaryTable also holds counters for Requests and Responses which have been discarded or received in error. However certain variables are redundant with respect to the Request and Response tables, they are added to reduce network traffic. Expires October 22, 1996 [Page 5] Internet Draft HTTP MIB April 22,1996 - The Request and Response tables provide much more detailed information broken down by entity and the type of Request or Response. For each entity, each type of Request or Response has a separate entry giving a count of the number received, sent, and time stamps for the last interaction. These tables are not only indexed by an entityIndex pointing to an entry in the httpEntityTable, but also with the Request c.q. Response type. The main reason to define this in a table is that the MIB objects are not dependent on the protocol standard. Only the textual convention should be changed then new types can simply be added by the implementation. 2.3. TimeOuts group The final group in the HTTP module contains timeout information for each of the HTTP entities. The information is presented in the form of a table which may be resized by the Network Management System, and contains the address of the remote entity and the time at which the timeout occurred. Expires October 22, 1996 [Page 6] Internet Draft HTTP MIB April 22,1996 5. HyperText Transfer Protocol MIB definition HTTP-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, experimental, Counter32 FROM SNMPv2-SMI TEXTUAL-CONVENTION, DisplayString, TimeStamp FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF; httpMIB MODULE-IDENTITY LAST-UPDATED "9511080000Z" ORGANIZATION "HTTP MIB Interest Group" CONTACT-INFO " Mark Gamble Post: ESYS Limited Berkeley House London Square Cross Lanes GUILDFORD Surrey UK Tel: +44 1483 304545 Fax: +44 1483 303878 Email: mgamble@esys.co.uk" DESCRIPTION "The MIB module for http Servers and Clients. The http in the module name is intended to cover a family of `Networked Information Retrieval' protocols such as http, nntp, ftp, gopher and so on. Membership of this family is difficult to define exactly, but all members share a similar request-response structure used to retrieve information (in the form of files, documents, articles) from a remote server." ::= { enterprises universityOfTwente(785) 2 } httpMIBObjects OBJECT IDENTIFIER ::= { httpMIB 1 } httpMIBConformance OBJECT IDENTIFIER ::= { httpMIB 2 } httpMIBCompliances OBJECT IDENTIFIER ::= { httpMIBConformance 1 } httpMIBGroups OBJECT IDENTIFIER ::= { httpMIBConformance 2 } Expires October 22, 1996 [Page 7] Internet Draft HTTP MIB April 22,1996 HttpMethod ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This data type is used to describe http methods. The value of a variable of this type is exactly the same method token usedin an http request. The currently defined methods for http areGET, HEAD and POST. For ftp, this type would cover the access control, transfer parameter, and service commands." SYNTAX INTEGER { get(1), head(2), put(3), post(4), delete(5), link(6), unlink(7) } HttpStatusCode ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The status code of an http response as defined in the RFC specification. The StatusCode (or reply code) is structured as a three digit code of the attempt to understand and satisfy the request. The following description is derived from the HyperText Transfer Protocol RFC: The first digit of the Status-Code defines the class of response. The last two digits do not have any categorization role. There are 5 values for the first digit: 1xx: Informational - Not used, but reserved for future use. 2xx: Success - The action was successfully received, understood, and accepted. 3xx: Redirection - Further action must be taken in order to complete the request. 4xx: Client Error - The request contains bad syntax or cannot be full filed. 5xx: Server Error - The server failed to fulfill an apparently valid request. Currently defined values for http are: ok(200), created(201), accepted(202), noContent(204), movedPermanently(301), movedTemporarily(302), notModified(304), badRequest(400), unauthorized(401), forbidden(403), notFound(404), internalServerError(500), notImplemented(501), badGateway(502), serviceUnavailable(503)." SYNTAX INTEGER (100..999) Expires October 22, 1996 [Page 8] Internet Draft HTTP MIB April 22,1996 -- -- The http System Group -- -- The http System group contains information about the http -- protocol entity. -- httpSystem OBJECT IDENTIFIER ::= { httpMIBObjects 1 } httpEntityTable OBJECT-TYPE SYNTAX SEQUENCE OF HttpEntityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table of http Servers and Clients present on the system." ::= { httpSystem 1 } httpEntityEntry OBJECT-TYPE SYNTAX HttpEntityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Details of a particular http Server or Client." INDEX { httpEntityIndex } ::= { httpEntityTable 1 } HttpEntityEntry ::= SEQUENCE { httpEntityIndex INTEGER, httpEntityProtocol INTEGER, httpEntityDescription DisplayString, httpEntityContact DisplayString, httpEntityProtocolVersion DisplayString, httpEntityVendor DisplayString, httpEntityVersion DisplayString, httpEntityObjectID OBJECT IDENTIFIER, httpEntityAddress DisplayString, httpEntityPort INTEGER, httpEntityIpAddress IpAddress, httpEntityLastInitialisation TimeStamp, httpEntityType INTEGER } httpEntityIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique (on this machine) identifier for this entity." ::= { httpEntityEntry 1 } -- Instrumentation: Agent internal. Expires October 22, 1996 [Page 9] Internet Draft HTTP MIB April 22,1996 httpEntityProtocol OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "This should be the number from /etc/services (or its equivalent) which is associated with the service implemented. For example, the value of this variable would be 21 for ftp, 80 for http." ::= { httpEntityEntry 2 } -- Instrumentation: System file. httpEntityDescription OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Textual description of the http Server or Client." ::= { httpEntityEntry 3 } -- Instrumentation: Configuration file. httpEntityContact OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The textual identification of the contact person for this http Server or Client, together with information on how to contact this person." ::= { httpEntityEntry 4 } -- Instrumentation: Configuration file. httpEntityProtocolVersion OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Textual description of the version of the protocol implemented." ::= { httpEntityEntry 5 } -- Instrumentation: Log file httpEntityVendor OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Textual description of the organization which implemented the protocol." ::= { httpEntityEntry 6 } -- Instrumentation: Log file Expires October 22, 1996 [Page 10] Internet Draft HTTP MIB April 22,1996 httpEntityVersion OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Textual description of the implementated version." ::= { httpEntityEntry 7 } -- Instrumentation: Log file httpEntityObjectID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-only STATUS current DESCRIPTION "The authoritative identification for the private MIB for this http Entity, presumably based on the vendor. If no OBJECT IDENTIFIER exists for the private MIB, attempts to access this object will return noSuchName (SNMPv1) or noSuchInstance (SNMPv2)." ::= { httpEntityEntry 8 } -- Instrumentation: Direct access httpEntityAddress OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The DNS address at which the http Entity listens for Requests or Responses. This is variable is useful when the entity listens to a virtual domain (address)." ::= { httpEntityEntry 9 } -- Instrumentation: Config file httpEntityPort OBJECT-TYPE SYNTAX INTEGER (0..4096) MAX-ACCESS read-only STATUS current DESCRIPTION "The TCP port at which the http Entity listens for Requests or Responses." ::= { httpEntityEntry 10 } -- Instrumentation: Config file httpEntityIpAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The IP Address at which the http Entity listens for Requests or Responses." ::= { httpEntityEntry 11 } -- Instrumentation: System Expires October 22, 1996 [Page 11] Internet Draft HTTP MIB April 22,1996 httpEntityLastInitialisation OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time the http Entity was last initialised. If the http Entity was last initialised prior to the last initialisation of the network management subsystem, then this object contains a zero value." ::= { httpEntityEntry 12 } -- Instrumentation: Config file httpEntityType OBJECT-TYPE SYNTAX INTEGER { server(1), client(2), proxy(3), cachingProxy(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Identification of the role of the http Entity." ::= { httpEntityEntry 13 } -- Instrumentation: Direct access -- -- The http Statistics Group -- -- The http Statistics group contains information concerning the -- utilization of the http protocol entity. -- httpStatistics OBJECT IDENTIFIER ::= { httpMIBObjects 2 } httpSummaryTable OBJECT-TYPE SYNTAX SEQUENCE OF HttpSummaryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table providing overview statistics for the http protocol entities on this system." ::= { httpStatistics 1 } httpSummaryEntry OBJECT-TYPE SYNTAX HttpSummaryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Overview statistics for an individual http entity." INDEX { httpSummaryEntityIndex } ::= { httpSummaryTable 1 } Expires October 22, 1996 [Page 12] Internet Draft HTTP MIB April 22,1996 HttpSummaryEntry ::= SEQUENCE { httpSummaryEntityIndex INTEGER, httpSummaryRequests Counter32, httpSummaryRequestErrors Counter32, httpSummaryRequestDiscards Counter32, httpSummaryResponses Counter32, httpSummaryResponseErrors Counter32, httpSummaryResponseDiscards Counter32, httpSummaryInUnknowns Counter32, httpSummaryInBytes Counter32, httpSummaryOutBytes Counter32, httpSummaryTimeOuts Counter32 } httpSummaryEntityIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The unique (on this machine) identifier for this entity. This Index corresponds to httpEntityIndex in the System group." ::= { httpSummaryEntry 1 } -- Instrumentation: Agent internal httpSummaryRequests OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of Requests generated or received by this entity." ::= { httpSummaryEntry 2 } -- Instrumentation: Log file httpSummaryRequestErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of Request errors detected by this entity (server only.)" ::= { httpSummaryEntry 3 } -- Instrumentation: Log file httpSummaryRequestDiscards OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of Requests discarded by this entity (server only)." ::= { httpSummaryEntry 4 } -- Instrumentation: Direct Access Expires October 22, 1996 [Page 13] Internet Draft HTTP MIB April 22,1996 httpSummaryResponses OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of Responses generated or received by this entity." ::= { httpSummaryEntry 5 } -- Instrumentation: Log file httpSummaryResponseErrors OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of Response errors detected by this entity (client only)." ::= { httpSummaryEntry 6 } -- Instrumentation: Direct Access httpSummaryResponseDiscards OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of Responses discarded by this entity (client only.)" ::= { httpSummaryEntry 7 } -- Instrumentation: Direct Access httpSummaryInUnknowns OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of unknown messages received by this entity." ::= { httpSummaryEntry 8 } -- Instrumentation: Log file httpSummaryInBytes OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of bytes received by this entity." ::= { httpSummaryEntry 9 } -- Instrumentation: Log file Expires October 22, 1996 [Page 14] Internet Draft HTTP MIB April 22,1996 httpSummaryOutBytes OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of bytes generated by this entity." ::= { httpSummaryEntry 10 } -- Instrumentation: Log file httpSummaryTimeOuts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of timeouts for this entities." ::= { httpSummaryEntry 11 } --Instrumentation: Log file httpRequestTable OBJECT-TYPE SYNTAX SEQUENCE OF HttpRequestEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table providing detailed request statistics for the http protocol entities on this system." ::= { httpStatistics 2 } httpRequestEntry OBJECT-TYPE SYNTAX HttpRequestEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Request statistics for an individual http entity." INDEX { httpRequestEntityIndex, httpRequestMethodIndex } ::= { httpRequestTable 1 } HttpRequestEntry ::= SEQUENCE { httpRequestEntityIndex INTEGER, httpRequestMethodIndex HttpMethod, httpRequestInCount Counter32, httpRequestInLastTime TimeStamp, httpRequestOutCount Counter32, httpRequestOutLastTime TimeStamp } Expires October 22, 1996 [Page 15] Internet Draft HTTP MIB April 22,1996 httpRequestEntityIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The unique (on this machine) identifier for this entity. This Index corresponds to httpEntityIndex in the System group." ::= { httpRequestEntry 1 } -- Instrumentation: Agent internal httpRequestMethodIndex OBJECT-TYPE SYNTAX HttpMethod MAX-ACCESS not-accessible STATUS current DESCRIPTION "The particular request method the statistics apply to." ::= { httpRequestEntry 2 } -- Instrumentation: Log file httpRequestInCount OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of requests of this type received by this entity." ::= { httpRequestEntry 3 } -- Instrumentation: Log file httpRequestInLastTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time the last request was received." ::= { httpRequestEntry 4 } -- Instrumentation: Log file httpRequestOutCount OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of requests of this type generated by this entity." ::= { httpRequestEntry 5 } -- Instrumentation: Log file Expires October 22, 1996 [Page 16] Internet Draft HTTP MIB April 22,1996 httpRequestOutLastTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time the last request was generated." ::= { httpRequestEntry 6 } -- Instrumentation: Log file httpResponseTable OBJECT-TYPE SYNTAX SEQUENCE OF HttpResponseEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table providing detailed response statistics for the http protocol entities on this system." ::= { httpStatistics 3 } httpResponseEntry OBJECT-TYPE SYNTAX HttpResponseEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Response statistics for an individual http Server or Client." INDEX { httpResponseEntityIndex, httpResponseStatusIndex } ::= { httpResponseTable 1 } HttpResponseEntry ::= SEQUENCE { httpResponseEntityIndex INTEGER, httpResponseStatusIndex HttpStatusCode, httpResponseInCount Counter32, httpResponseInLastTime TimeStamp, httpResponseOutCount Counter32, httpResponseOutLastTime TimeStamp } httpResponseEntityIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The unique (on this machine) identifier for this entity. This Index corresponds to httpEntityIndex in the System group." ::= { httpResponseEntry 1 } -- Instrumentation: Agent internal Expires October 22, 1996 [Page 17] Internet Draft HTTP MIB April 22,1996 httpResponseStatusIndex OBJECT-TYPE SYNTAX HttpStatusCode MAX-ACCESS not-accessible STATUS current DESCRIPTION "The particular response status the statistics apply to." ::= { httpResponseEntry 2 } -- Instrumentation: Log file httpResponseInCount OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of responses of this type received by this entity." ::= { httpResponseEntry 3 } -- Instrumentation: Log file httpResponseInLastTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time the last response was received." ::= { httpResponseEntry 4 } -- Instrumentation: Log file httpResponseOutCount OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of responses of this type generated by this entity." ::= { httpResponseEntry 5 } -- Instrumentation: Log file httpResponseOutLastTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time the last response was generated." ::= { httpResponseEntry 6 } -- Instrumentation: Log file Expires October 22, 1996 [Page 18] Internet Draft HTTP MIB April 22,1996 -- -- The Time Out group contains information about the time outs occurred -- with the protocol entity. -- httpTimeOuts OBJECT IDENTIFIER ::= { httpMIBObjects 3 } httpTimeoutTableSize OBJECT-TYPE SYNTAX INTEGER (0..64) MAX-ACCESS read-write STATUS current DESCRIPTION "The number of last TimeOuts contained by the httpTimeOutTable." ::= { httpTimeOuts 1 } -- Instrumentation: Log file httpTimeoutTable OBJECT-TYPE SYNTAX SEQUENCE OF HttpTimeoutEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table providing detailed timeout statistics for the http protocol entities on this system." ::= { httpTimeOuts 2 } httpTimeoutEntry OBJECT-TYPE SYNTAX HttpTimeoutEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Timeout statistics for a particular http entity." INDEX { httpTimeoutEntityIndex, httpTimeoutNumber } ::= { httpTimeoutTable 1 } HttpTimeoutEntry ::= SEQUENCE { httpTimeoutEntityIndex INTEGER, httpTimeoutNumber INTEGER, httpTimeoutRemoteAddress DisplayString, httpTimeoutTime TimeStamp } httpTimeoutEntityIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The unique (on this machine) identifier for this entity. This Index corresponds to httpEntityIndex in the http System group." ::= { httpTimeoutEntry 1 } -- Instrumentation: Agent internal Expires October 22, 1996 [Page 19] Internet Draft HTTP MIB April 22,1996 httpTimeoutNumber OBJECT-TYPE SYNTAX INTEGER (0..64) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The unique identifier for the last Timeout." ::= { httpTimeoutEntry 2 } -- Instrumentation: Agent internal httpTimeoutRemoteAddress OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The address of the remote entity." ::= { httpTimeoutEntry 3 } -- Instrumentation: Log file httpTimeoutTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The time when the time out occured with the remote entity." ::= { httpTimeoutEntry 4 } -- Instrumentation: Log file -- -- Conformance and compliance definitions. -- httpMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement the HTTP MIB." MODULE -- this module MANDATORY-GROUPS { httpMIBGroup } ::= { httpMIBCompliances 4 } Expires October 22, 1996 [Page 20] Internet Draft HTTP MIB April 22,1996 httpMIBGroup OBJECT-GROUP OBJECTS { httpEntityIndex, httpEntityProtocol, httpEntityDescription, httpEntityContact, httpEntityProtocolVersion, httpEntityVendor, httpEntityVersion, httpEntityObjectID, httpEntityAddress, httpEntityPort, httpEntityIpAddress, httpEntityLastInitialisation, httpEntityType, httpSummaryEntityIndex, httpSummaryRequests, httpSummaryRequestErrors, httpSummaryRequestDiscards, httpSummaryResponses, httpSummaryResponseErrors, httpSummaryResponseDiscards, httpSummaryInUnknowns, httpSummaryInBytes, httpSummaryOutBytes, httpSummaryTimeOuts, httpRequestEntityIndex, httpRequestMethodIndex, httpRequestInCount, httpRequestInLastTime, httpRequestOutCount, httpResponseEntityIndex, httpResponseStatusIndex, httpResponseInCount, httpResponseInLastTime, httpResponseOutCount, httpResponseOutLastTime, httpTimeoutNumber, httpTimeoutEntityIndex, httpTimeoutRemoteAddress, httpTimeoutTime } STATUS current DESCRIPTION "The collection of objects allowing the management of HTTP servers and clients." ::= { httpMIBGroups 1 } END Expires October 22, 1996 [Page 21] Internet Draft HTTP MIB April 22,1996 6. Acknowledgments This document has been produced by the University of Twente (The Netherlands), together with ESYS Limited (The United Kingdom), as part of a `proof of concept' study for the `Centre of Earth Observation' (CEO) of the `Joint Research Centre' (JRC) of the European Community. This document has benefited greatly to the comments of: Carl W. Kalbfleisch Mark Gamble Rui Meneses Juergen Schoenwaelder Expires October 22, 1996 [Page 22] Internet Draft HTTP MIB April 22,1996 7. References [1] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure of Management Information for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1902, January 1996. [2] McCloghrie, K., and M. Rose, Editors, "Management Information Base for Network Management of TCP/IP-based internets: MIB-II", STD 17, RFC 1213, Hughes LAN Systems, Performance Systems International, March 1991. [3] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual Conventions for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1903, January 1996. [4] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1905, January 1996. [5] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Conformance Statements for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1904, January 1996. [6] Case, J., M. Fedor, M. Schoffstall, J. Davin, "Simple Network Management Protocol", RFC 1157, SNMP Research, Performance Systems International, MIT Laboratory for Computer Science, May 1990. [7] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901, January 1996. [8] HTTP Working Group, Berners-Lee, T., Fielding R. and Frystyk, H., "Hypertext Transfer Protocol -- HTTP/1.0", Internet draft, October 1995. 8. Security Considerations Security issues are not discussed in this memo. 9. Authors' Addresses Harrie Hazewinkel / Eric van Hengstum / Aiko Pras University of Twente Centre for Telematics and Information Technology (CTIT) POBox 217 7500 AE Enschede, The Netherlands Phone: +31-53-4893778 Email: hazewink@cs.utwente.nl hengstum@cs.utwente.nl pras@cs.utwente.nl Expires October 22, 1996 [Page 23] Internet Draft HTTP MIB April 22,1996 Table of Contents 1 Abstract .................................................. 2 2 The SNMPv2 Network Management Framework ................... 3 2.1 Object Definitions ...................................... 3 3 Introduction .............................................. 4 4 HyperText Transfer Protocol MIB structure ................. 5 4.1 System group ............................................ 5 4.2 Statistics group ........................................ 5 4.3 TimeOuts group .......................................... 6 5 HyperText Transfer Protocol MIB definition ................ 7 6 Acknowledgements .......................................... 22 7 References ................................................ 23 8 Security Considerations ................................... 23 9 Authors' Addresses ........................................ 23 Expires October 22, 1996 [Page 24]