view Side-By-Side changes
Network Working Group Steve Kille, WG Chair Internet Draft Ned Freed, Editordraft-ietf-madman-mail-monitor-mib-00.txt<draft-ietf-madman-mail-monitor-mib-02.txt> Mail Monitoring MIBNovember 1995August 1996 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. Internet-Drafts may be updated, replaced, or obsoleted by other documents at any time. It is not appropriate to use Internet-Drafts as reference material or to cite them other than as a ``working draft'' or ``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). 1. Introduction This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, this memo extends the basic Network Services Monitoring MIB [5] to allow monitoring of Message Transfer Agents (MTAs). It may also be used to monitor MTA components within gateways. Internet Draft Mail Monitoring MIBNovember 1995August 1996 2. Table of Contents 1 Introduction .................................................... 1 2 Table of Contents ............................................... 2 3 The SNMPv2 Network Management Framework ......................... 2 3.1 Object Definitions ............................................ 2 4 Message Flow Model .............................................. 3 5 MTA Objects ..................................................... 3 6 Definitions .....................................................54 7 Changes made sinceRFC1565 ...................................... 22RFC 1566 ..................................... 27 8 Acknowledgements ................................................2328 9 References ......................................................2328 10 Security Considerations ........................................2329 11 Authors' Addresses .............................................2429 3. The SNMPv2 Network Management Framework The SNMPv2 Network Management Framework consists of four major components. They are: o RFC14421902 [1] which defines the SMI, the mechanisms used for describing and naming objects for the purpose of management. o RFC 1213 [2] defines MIB-II, the core set of managed objects for the Internet suite of protocols. o RFC 1445 [3] which defines the administrative and other architectural aspects of the framework. o RFC14481905 [4] which defines the protocol used for network access to managed objects. The Framework permits new objects to be defined for the purpose of experimentation and evaluation. 3.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. 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 ExpiresMay 1996Frebruary 1997 [Page 2] Internet Draft Mail Monitoring MIBNovember 1995August 1996 object. For human convenience, we often use a textual string, termed the descriptor, to refer to the object type. 4. Message Flow Model A general model of message flow inside an MTA has to be presented before a MIB can be described. Generally speaking, message flow occurs in four steps: (1) Messages are received by the MTA from User Agents, Message Stores, other MTAs, and gateways. (2) The "next hop" for the each message is determined. This is simply the destination the message is to be transmitted to; it may or may not be the final destination of the message. Multiple "next hops" may exist for a single message (as a result of either having multiple recipients or distribution list expansion); this may make it necessary to duplicate messages. (3)MessagesIf necessary messages are converted into the format that's appropriate for the next hop. Conversion operations may be successful or unsuccessful. (4) Messages are transmitted to the appropriate destination, which may be a User Agent, Message Store, another MTA, or gateway. Storage of messages in the MTA occurs at some point during this process. However, it is important to note that storage may occur at different and possibly even multiple points during this process. For example, some MTAs expand messages into multiple copies as they are received. In this case (1), (2), and (3) may all occur prior to storage. Other MTAs store messages precisely as they are received and perform all expansions and conversions during retransmission processing. So here only (1) occurs prior to storage. This leads to situations where, in general, a measurement of messages received may not equal a measurement of messages in store, or a measurement of messages stored may not equal a measurement of messages retransmitted, or both. 5. MTA Objects If there are one or more MTAs on the host, the followingmta groupMIB may be used to monitor them. Any number of the MTAs on a host may be monitored. Each MTA is dealt with as a separate application and has its own applTableentry in the Network Services Monitoring MIB.ExpiresMay 1996Frebruary 1997 [Page 3] Internet Draft Mail Monitoring MIBNovember 1995August 1996 entry in the Network Services Monitoring MIB. The MIB described in this document covers only the portion which is specific to the monitoring of MTAs. The network service related part of the MIB is covered in a separate document [5]. 6. Definitions MTA-MIB DEFINITIONS ::= BEGIN IMPORTS OBJECT-TYPE, Counter32, Gauge32, MODULE-IDENTITY FROM SNMPv2-SMI DisplayString, TimeInterval FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF mib-2 FROM RFC1213-MIB applIndex FROM APPLICATION-MIB; -- Textual conventions -- Uniform Resource Locators are stored in URLStrings. URLString ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "A Uniform Resource Locator represented in accordance with RFC 1738 [7]." SYNTAX DisplayString Expires Frebruary 1997 [Page 4] Internet Draft Mail Monitoring MIB August 1996 mta MODULE-IDENTITY LAST-UPDATED"9511170000Z""9608270000Z" ORGANIZATION "IETF Mail and Directory Management Working Group" CONTACT-INFO " Ned Freed Postal: Innosoft International, Inc. 1050 East Garvey Avenue South West Covina, CA 91790 US Tel: +1 818 919 3600 Fax: +1 818 919 3614 E-Mail: ned@innosoft.com" DESCRIPTION "The MIB module describing Message Transfer Agents (MTAs)" ::= {mib-2 28}Expires May 1996 [Page 4] Internet Draft Mail Monitoring MIB November 1995mtaTable OBJECT-TYPE SYNTAX SEQUENCE OF MtaEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table holding information specific to an MTA." ::= {mta 1} mtaStatusCode OBJECT-TYPE SYNTAX INTEGER (40000..59999) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index capable of representing an Enhanced Mail System Status Code. Enhanced Mail System Status Codes are defined in RFC 1893 [11]. Both SMTP error response codes and X.400 reason and diagnostic codes can be mapped into these codes. Specifically, given a status code of the form class.subject.detail, the corresponding index value is defined to be ((class * 100) + subject) * 100 + detail." Expires Frebruary 1997 [Page 5] Internet Draft Mail Monitoring MIB August 1996 mtaEntry OBJECT-TYPE SYNTAX MtaEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The entry associated with each MTA." INDEX {applIndex} ::= {mtaTable 1} MtaEntry ::= SEQUENCE { mtaReceivedMessages Counter32, mtaStoredMessages Gauge32, mtaTransmittedMessages Counter32, mtaReceivedVolume Counter32, mtaStoredVolume Gauge32, mtaTransmittedVolume Counter32, mtaReceivedRecipients Counter32, mtaStoredRecipients Gauge32, mtaTransmittedRecipientsCounter32Counter32, mtaSuccessfulConvertedMessages Counter32, mtaFailedConvertedMessages Counter32, mtaLoopsDetected Counter32, mtaDescription DisplayString, mtaURL, URLString } Expires Frebruary 1997 [Page 6] Internet Draft Mail Monitoring MIB August 1996 mtaReceivedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of messages received since MTA initialization. This includes messages transmitted to this MTA from otherExpires May 1996 [Page 5] Internet Draft Mail Monitoring MIB November 1995MTAs as well as messages that have been submitted to the MTA directly by end-users or applications." ::= {mtaEntry 1} mtaStoredMessages OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of messages currently stored in the MTA. This includes messages that are awaiting transmission to some other MTA or are waiting for delivery to an end-user or application." ::= {mtaEntry 2} mtaTransmittedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of messages transmitted since MTA initialization. This includes messages that were transmitted to some other MTA or are waiting for delivery to an end-user or application." ::= {mtaEntry 3} Expires Frebruary 1997 [Page 7] Internet Draft Mail Monitoring MIB August 1996 mtaReceivedVolume OBJECT-TYPE SYNTAX Counter32 UNITS "K-octets" MAX-ACCESS read-only STATUS current DESCRIPTION "The total volume of messages received since MTA initialization, measured in kilo-octets. This volume should include all transferred data that is logically above the mail transport protocol level. For example, an SMTP-based MTA should use the number of kilo-octets in the message header and body, while an X.400-based MTA should use the number of kilo-octets of P2 data. This includes messages transmitted to this MTA from other MTAs as well as messages that have been submitted to the MTA directly by end-users or applications." ::= {mtaEntry 4}Expires May 1996 [Page 6] Internet Draft Mail Monitoring MIB November 1995mtaStoredVolume OBJECT-TYPE SYNTAX Gauge32 UNITS "K-octets" MAX-ACCESS read-only STATUS current DESCRIPTION "The total volume of messages currently stored in the MTA, measured in kilo-octets. This volume should include all stored data that is logically above the mail transport protocol level. For example, an SMTP-based MTA should use the number of kilo-octets in the message header and body, while an X.400-based MTA would use the number of kilo-octets of P2 data. This includes messages that are awaiting transmission to some other MTA or are waiting for delivery to an end-user or application." ::= {mtaEntry 5} Expires Frebruary 1997 [Page 8] Internet Draft Mail Monitoring MIB August 1996 mtaTransmittedVolume OBJECT-TYPE SYNTAX Counter32 UNITS "K-octets" MAX-ACCESS read-only STATUS current DESCRIPTION "The total volume of messages transmitted since MTA initialization, measured in kilo-octets. This volume should include all transferred data that is logically above the mail transport protocol level. For example, an SMTP-based MTA should use the number of kilo-octets in the message header and body, while an X.400-based MTA should use the number of kilo-octets of P2 data. This includes messages that were transmitted to some other MTA or are waiting for delivery to an end-user or application." ::= {mtaEntry 6} mtaReceivedRecipients OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of recipients specified in all messages received since MTA initialization. Recipients this MTA has no responsibility for, i.e. inactive envelope recipients or ones referred to in message headers, should not be counted even if information about such recipients is available. This includes messagesExpires May 1996 [Page 7] Internet Draft Mail Monitoring MIB November 1995transmitted to this MTA from other MTAs as well as messages that have been submitted to the MTA directly by end-users or applications." ::= {mtaEntry 7} mtaStoredRecipients OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of recipients specified in all messages currently stored in the MTA. Recipients this MTA has no responsibility for, i.e. inactive envelope recipients or ones referred to in message headers, should not be counted. This includes messages that are awaiting transmission to some other MTA or are waiting for delivery to an end-user or application." Expires Frebruary 1997 [Page 9] Internet Draft Mail Monitoring MIB August 1996 ::= {mtaEntry 8} mtaTransmittedRecipients OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of recipients specified in all messages transmitted since MTA initialization. Recipients this MTA had no responsibility for, i.e. inactive envelope recipients or ones referred to in message headers, should not be counted. This includes messages that were transmitted to some other MTA or are waiting for delivery to an end-user or application." ::= {mtaEntry 9}-- MTAs typically group inbound reception, queue storage, and -- outbound transmission in some way. In the most extreme case -- information will be maintained for each different entity that -- receives messages and for each entity the MTA stores messages for -- and deliversmtaSuccessfulConvertedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of messagesto. Other MTAs may electthat have been successfully converted from one form totreat all -- reception equally, all queue storage equally, all deliveries -- equally, or some combinationanother since MTA initialization." ::= {mtaEntry 10} mtaFailedConvertedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number ofthis. -- In any case, a grouping abstraction is an extremely usefulmessages for-- breaking down the activities ofwhich anMTA. For purposes of labelling -- this will be called a "group" in this MIB.unsuccessful attempt was made to convert them from one form to another since MTA initialization." ::= {mtaEntry 11} ExpiresMay 1996Frebruary 1997 [Page8]10] Internet Draft Mail Monitoring MIBNovember 1995 -- Each group contains allAugust 1996 mtaLoopsDetected OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "A message loop is defined as a situation where thevariables neededMTA decides that a given message will never be delivered tomonitor all aspects --one or more recipients and instead will continue to loop endlessly through one or more MTAs. This variable counts the number ofan MTA's operation. However,times thefact that all groups contain -- all possible variables does not implyMTA has detected such a situation since MTA initialization. Note thatall groups mustthe mechanism MTAs useall -- possible variables. For example, a single group might be usedto-- monitor only one kinddetect loops (e.g. trace field counting, count ofevent (inbound processing, outbound -- processing, or storage). Inreferences to thissort of configuration all unused -- counters would be inaccessible; e.g., returning eitherMTA in a-- noSuchName error (for an SNMPv1 get),trace field, examination of DNS or other directory information, etc.), the level at which loops are detected (e.g. per message, per recipient, per directory entry, etc.), and the handling of anoSuchInstance -- exception (for an SNMPv2 get). -- Groupsloop once it is detected (e.g. looping messages arenot necessarily mutually exclusive. A given event may --held, looping messages are bounced or sent to the postmaster, messages that the MTA knows will loop won't berecorded by more than one group, a message may be seen as -- stored by more thanaccepted, etc.) vary widely from onegroup,MTA to the next andso on. Groups shouldcannot beall -- inclusive, however: if groups are implemented all aspectsinferred from this variable." ::= {mtaEntry 12} mtaDescription OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "A description ofan -- MTA's operation should be registered in at least one group.the MTA. This-- freedom lets implementors use different sets of groupsinformation is intended to-- provide differents "views"identify the MTA in a status display." ::= {mtaEntry 13} mtaURL OBJECT-TYPE SYNTAX URLString MAX-ACCESS read-only STATUS current DESCRIPTION "A URL pointing to a description ofanthe MTA.-- The possibility of overlap between groups means that summing -- variables across groups may not produce values equalThis information is intended tothoseidentify and describe the MTA in a status display." ::= {mtaEntry 14} Expires Frebruary 1997 [Page 11] Internet Draft Mail Monitoring MIB August 1996 --the mtaTable. mtaTable should always provide accurate informationMTAs typically group inbound reception, queue storage, and --aboutoutbound transmission in some way, rather than accounting for -- such operations only across the MTA as a whole. In the most --The term "channel" is often used inextreme case separate information will be maintained for each -- different entity that receives messages and for each entity -- the MTAimplementations; channelsstores messages for and delivers messages to. Other --are usually, but not always, equivalentMTAs may elect toa group. However,treat all reception equally, all queue --this MIB does not use the term "channel" because there is nostorage equally, all deliveries equally, or some combination --requirement thatof this. Overlapped groupings are also possible, where an MTA -- decomposes its traffic in different ways for different -- purposes. -- In any case, a grouping abstraction is an extremely useful for -- breaking down the activities of an MTA. For purposes of -- labelling this will be called a "group" in this MIB. -- Each group contains all the variables needed to monitor all -- aspects of an MTA's operation. However, the fact that all -- groups contain all possible variables does not imply that all -- groups must use all possible variables. For example, a single -- group might be used to monitor only one kind of event (inbound -- processing, outbound processing, or storage). In this sort of -- configuration all unused counters would be inaccessible; e.g., -- returning either a noSuchName error (for an SNMPv1 get), or a -- noSuchInstance exception (for an SNMPv2 get). -- Groups can be created at any time after MTA initialization. Once -- a group is created it should not be deleted or its mtaGroupIndex -- changed unless the MTA is reinitialized. -- Groups are not necessarily mutually exclusive. A given event may -- be recorded by more than one group, a message may be seen as -- stored by more than one group, and so on. Groups should be all -- inclusive, however: if groups are implemented all aspects of an -- MTA's operation should be registered in at least one group. This -- freedom lets implementors use different sets of groups to -- provide differents "views" of an MTA. -- The possibility of overlap between groups means that summing -- variables across groups may not produce values equal to those in -- the mtaTable. mtaTable should always provide accurate information -- about the MTA as a whole. Expires Frebruary 1997 [Page 12] Internet Draft Mail Monitoring MIB August 1996 -- The term "channel" is often used in MTA implementations; channels -- are usually, but not always, equivalent to a group. However, -- this MIB does not use the term "channel" because there is no -- requirement that an MTA supporting this MIB has to map its -- "channel" abstraction one-to-one onto the MIB's group abstration. -- An MTA may create a group or group of groups at any time. Once -- created, however, an MTA cannot delete an entry for a group from -- the group table. Deletation is only allowed when the MTA is -- reinitialized, and is not required even then. This restriction -- is imposed so that monitoring agents can rely on group -- assignments being consistent across multiple query operations. -- Groups may be laid out so as to form a hierarchical arrangement, -- with some groups acting as subgroups for other groups. -- Alternately, disjoint groups of groups may be used to provide -- different sorts of "snapshots" of MTA operation. The -- mtaGroupHierarchy variable provides an indication of how each -- group fits into the overall arrangement being used. mtaGroupTable OBJECT-TYPE SYNTAX SEQUENCE OF MtaGroupEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table holding information specific to each MTA group." ::= {mta 2} mtaGroupEntry OBJECT-TYPE SYNTAX MtaGroupEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The entry associated with each MTA group." INDEX {applIndex, mtaGroupIndex} ::= {mtaGroupTable 1} MtaGroupEntry ::= SEQUENCE { mtaGroupIndex INTEGER, mtaGroupReceivedMessages Counter32, mtaGroupRejectedMessages Counter32, mtaGroupStoredMessages Expires Frebruary 1997 [Page 13] Internet Draft Mail Monitoring MIB August 1996 Gauge32, mtaGroupTransmittedMessages Counter32, mtaGroupReceivedVolume Counter32, mtaGroupStoredVolume Gauge32, mtaGroupTransmittedVolume Counter32, mtaGroupReceivedRecipients Counter32, mtaGroupStoredRecipients Gauge32, mtaGroupTransmittedRecipients Counter32, mtaGroupOldestMessageStored TimeInterval, mtaGroupInboundAssociations Gauge32, mtaGroupOutboundAssociations Gauge32, mtaGroupAccumulatedInboundAssociations Counter32, mtaGroupAccumulatedOutboundAssociations Counter32, mtaGroupLastInboundActivity TimeInterval, mtaGroupLastOutboundActivity TimeInterval, mtaGroupLastOutboundAssociationAttempt TimeInterval, mtaGroupRejectedInboundAssociations Counter32, mtaGroupFailedOutboundAssociations Counter32, mtaGroupInboundRejectionReason DisplayString, mtaGroupOutboundConnectFailureReason DisplayString, mtaGroupScheduledRetry TimeInterval, mtaGroupMailProtocol OBJECT IDENTIFIER, mtaGroupName DisplayString, Expires Frebruary 1997 [Page 14] Internet Draft Mail Monitoring MIB August 1996 mtaGroupSuccessfulConvertedMessages Counter32, mtaGroupFailedConvertedMessages Counter32, mtaGroupDescription DisplayString, mtaGroupURL URLString, mtaGroupCreationTime TimeInterval, mtaGroupHierarchy INTEGER, mtaGroupOldestMessageId DisplayString, mtaGroupLoopsDetected Counter32 } mtaGroupIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index associated with a group for a given MTA." ::= {mtaGroupEntry 1} mtaGroupReceivedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of messages received to this group since group creation." ::= {mtaGroupEntry 2} mtaGroupRejectedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of messages rejected by this group since group creation." ::= {mtaGroupEntry 3} Expires Frebruary 1997 [Page 15] Internet Draft Mail Monitoring MIB August 1996 mtaGroupStoredMessages OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of messages currently stored in this group's queue." ::= {mtaGroupEntry 4} mtaGroupTransmittedMessages OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of messages transmitted by this group since group creation." ::= {mtaGroupEntry 5} mtaGroupReceivedVolume OBJECT-TYPE SYNTAX Counter32 UNITS "K-octets" MAX-ACCESS read-only STATUS current DESCRIPTION "The total volume of messages received to this group since group creation, measured in kilo-octets. This volume should include all transferred data that is logically above the mail transport protocol level. For example, an SMTP-based MTA should use the number of kilo-octets in the message header and body, while an X.400-based MTA should use the number of kilo-octets of P2 data." ::= {mtaGroupEntry 6} Expires Frebruary 1997 [Page 16] Internet Draft Mail Monitoring MIB August 1996 mtaGroupStoredVolume OBJECT-TYPE SYNTAX Gauge32 UNITS "K-octets" MAX-ACCESS read-only STATUS current DESCRIPTION "The total volume of messages currently stored in this group's queue, measured in kilo-octets. This volume should include all stored data that is logically above the mail transport protocol level. For example, an SMTP-based MTA should use the number of kilo-octets in the message header and body, while an X.400-based MTA would use the number of kilo-octets of P2 data." ::= {mtaGroupEntry 7} mtaGroupTransmittedVolume OBJECT-TYPE SYNTAX Counter32 UNITS "K-octets" MAX-ACCESS read-only STATUS current DESCRIPTION "The total volume of messages transmitted by this group since group creation, measured in kilo-octets. This volume should include all transferred data that is logically above the mail transport protocol level. For example, an SMTP-based MTA should use the number of kilo-octets in the message header and body, while an X.400-based MTAsupporting this MIB has to map its -- "channel" abstraction one-to-one ontoshould use theMIB's group abstration. mtaGroupTable OBJECT-TYPE SYNTAX SEQUENCE OF MtaGroupEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table holding information specific to each MTA group."number of kilo-octets of P2 data." ::={mta 2} mtaGroupEntry{mtaGroupEntry 8} mtaGroupReceivedRecipients OBJECT-TYPE SYNTAXMtaGroupEntryCounter32 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION "Theentry associated with eachtotal number of recipients specified in all messages received to this group since group creation. Recipients this MTAgroup." INDEX {applIndex, mtaGroupIndex}has no responsibility for should not be counted." ::={mtaGroupTable 1}{mtaGroupEntry 9} ExpiresMay 1996Frebruary 1997 [Page9]17] Internet Draft Mail Monitoring MIBNovember 1995 MtaGroupEntry ::= SEQUENCE { mtaGroupIndex INTEGER, mtaGroupReceivedMessages Counter32, mtaGroupRejectedMessages Counter32, mtaGroupStoredMessages Gauge32, mtaGroupTransmittedMessages Counter32, mtaGroupReceivedVolume Counter32, mtaGroupStoredVolume Gauge32, mtaGroupTransmittedVolume Counter32, mtaGroupReceivedRecipients Counter32, mtaGroupStoredRecipients Gauge32, mtaGroupTransmittedRecipients Counter32, mtaGroupOldestMessageStored TimeInterval, mtaGroupInboundAssociations Gauge32, mtaGroupOutboundAssociations Gauge32, mtaGroupAccumulatedInboundAssociations Counter32, mtaGroupAccumulatedOutboundAssociations Counter32, mtaGroupLastInboundActivity TimeInterval, mtaGroupLastOutboundActivity TimeInterval, mtaGroupRejectedInboundAssociations Counter32, mtaGroupFailedOutboundAssociations Counter32, mtaGroupInboundRejectionReason DisplayString, mtaGroupOutboundConnectFailureReason DisplayString, Expires MayAugust 1996[Page 10] Internet Draft Mail Monitoring MIB November 1995 mtaGroupScheduledRetry TimeInterval, mtaGroupMailProtocol OBJECT IDENTIFIER, mtaGroupName DisplayString } mtaGroupIndexmtaGroupStoredRecipients OBJECT-TYPE SYNTAXINTEGER (1..2147483647)Gauge32 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION "Theindex associated with a grouptotal number of recipients specified in all messages currently stored in this group's queue. Recipients this MTA has no responsibility fora given MTA."should not be counted." ::= {mtaGroupEntry1} mtaGroupReceivedMessages10} mtaGroupTransmittedRecipients OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of recipients specified in all messagesreceived totransmitted by this group since group creation. Recipients this MTAinitialization."had no responsibility for should not be counted." ::= {mtaGroupEntry2} mtaGroupRejectedMessages11} mtaGroupOldestMessageStored OBJECT-TYPE SYNTAXCounter32TimeInterval MAX-ACCESS read-only STATUS current DESCRIPTION"The number of messages rejected by this group"Time sinceMTA initialization."the oldest message in this group's queue was placed in the queue." ::= {mtaGroupEntry3} mtaGroupStoredMessages12} mtaGroupInboundAssociations OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "Thetotalnumber ofmessages currently stored in this group's queue."current associations to the group, where the group is the responder." ::= {mtaGroupEntry4}13} ExpiresMay 1996Frebruary 1997 [Page11]18] Internet Draft Mail Monitoring MIBNovember 1995 mtaGroupTransmittedMessagesAugust 1996 mtaGroupOutboundAssociations OBJECT-TYPE SYNTAXCounter32Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number ofmessages transmitted by thiscurrent associations to the group, where the groupsince MTA initialization."is the initiator." ::= {mtaGroupEntry5} mtaGroupReceivedVolume14} mtaGroupAccumulatedInboundAssociations OBJECT-TYPE SYNTAX Counter32UNITS "K-octets"MAX-ACCESS read-only STATUS current DESCRIPTION "The totalvolumenumber ofmessages receivedassociations tothisthe group sinceMTA initialization, measured in kilo-octets. This volume should include all transferred data that is logically abovegroup creation, where themail transport protocol level. For example, an SMTP-basedMTAshould usewas the responder." ::= {mtaGroupEntry 15} mtaGroupAccumulatedOutboundAssociations OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number ofkilo-octets inassociations from the group since group creation, where themessage header and body, while an X.400-basedMTAshould usewas thenumber of kilo-octets of P2 data."initiator." ::= {mtaGroupEntry6} mtaGroupStoredVolume16} mtaGroupLastInboundActivity OBJECT-TYPE SYNTAXGauge32 UNITS "K-octets"TimeInterval MAX-ACCESS read-only STATUS current DESCRIPTION"The total volume of messages currently stored in this group's queue, measured in kilo-octets. This volume should include all stored data that is logically above"Time since themail transport protocol level. For example,last time that this group had anSMTP-based MTA should use the numberactive inbound association for purposes ofkilo-octets in themessageheader and body, while an X.400-based MTA would usereception." ::= {mtaGroupEntry 17} mtaGroupLastOutboundActivity OBJECT-TYPE SYNTAX TimeInterval MAX-ACCESS read-only STATUS current DESCRIPTION "Time since thenumber of kilo-octetslast time that this group had a successful outbound association for purposes ofP2 data."message delivery." ::= {mtaGroupEntry7}18} ExpiresMay 1996Frebruary 1997 [Page12]19] Internet Draft Mail Monitoring MIBNovember 1995 mtaGroupTransmittedVolumeAugust 1996 mtaGroupLastOutboundAssociationAttempt OBJECT-TYPE SYNTAXCounter32 UNITS "K-octets"TimeInterval MAX-ACCESS read-only STATUS current DESCRIPTION"The total volume of messages transmitted by"Time since the last time that this groupsince MTA initialization, measured in kilo-octets. This volume should include all transferred data that is logically above the mail transport protocol level. For example,attempted to make anSMTP-based MTA should use the numberoutbound association for purposes ofkilo-octets in themessageheader and body, while an X.400-based MTA should use the number of kilo-octets of P2 data."delivery." ::= {mtaGroupEntry8} mtaGroupReceivedRecipients34} mtaGroupRejectedInboundAssociations OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number ofrecipients specified in all messages received to thisinbound associations the groupsince MTA initialization. Recipients this MTAhasno responsibility for shouldrejected, since group creation. Rejected associations are notbe counted."counted in the accumulated association totals." ::= {mtaGroupEntry9} mtaGroupStoredRecipients19} mtaGroupFailedOutboundAssociations OBJECT-TYPE SYNTAXGauge32Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total numberof recipients specified in all messages currently stored in this group's queue. Recipients this MTAassociations where the group was the initiator and association establishment hasno responsibility for shouldfailed, since group creation. Failed associations are notbe counted."counted in the accumulated association totals." ::= {mtaGroupEntry10} mtaGroupTransmittedRecipients20} mtaGroupInboundRejectionReason OBJECT-TYPE SYNTAXCounter32DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Thetotal number of recipients specified in all messages transmitted byfailure reason, if any, for the last association this group refused to respond to. An empty string indicates that the last attempt was successful. If no association attempt has been made since the MTAinitialization. Recipients this MTA had no responsibility forwas initialized the value shouldnotbecounted."'never'." ::= {mtaGroupEntry 21} ExpiresMay 1996Frebruary 1997 [Page13]20] Internet Draft Mail Monitoring MIBNovember 1995 ::= {mtaGroupEntry 11} mtaGroupOldestMessageStoredAugust 1996 mtaGroupOutboundConnectFailureReason OBJECT-TYPE SYNTAXTimeIntervalDisplayString MAX-ACCESS read-only STATUS current DESCRIPTION"Time since"The failure reason, if any, for theoldest message inlast association attempt thisgroup's queuegroup initiated. An empty string indicates that the last attempt was successful. If no association attempt has been made since the MTA wasplaced ininitialized thequeue."value should be 'never'." ::= {mtaGroupEntry12} mtaGroupInboundAssociations22} mtaGroupScheduledRetry OBJECT-TYPE SYNTAXGauge32TimeInterval MAX-ACCESS read-only STATUS current DESCRIPTION "Thenumber of current associations to the group, where thetime when this group isthe responder."scheduled to next attempt to make an association." ::= {mtaGroupEntry13} mtaGroupOutboundAssociations23} mtaGroupMailProtocol OBJECT-TYPE SYNTAXGauge32OBJECT IDENTIFIER MAX-ACCESS read-only STATUS current DESCRIPTION"The number"An identification ofcurrent associations to the group, wherethe protocol being used by this group. For an groupisemploying OSI protocols, this will be theinitiator." ::= {mtaGroupEntry 14} mtaGroupAccumulatedInboundAssociations OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total numberApplication Context. For Internet applications, the IANA maintains a registry ofassociations tothegroup since MTA initialization, whereOIDs which correspond to well-known message transfer protocols. If thegroupapplication protocol is not listed in theresponder."registry, an OID value of the form {applTCPProtoID port} or {applUDProtoID port} are used for TCP-based and UDP-based protocols, respectively. In either case 'port' corresponds to the primary port number being used by the group. applTCPProtoID and applUDPProtoID are defined in [5]." ::= {mtaGroupEntry15}24} ExpiresMay 1996Frebruary 1997 [Page14]21] Internet Draft Mail Monitoring MIBNovember 1995 mtaGroupAccumulatedOutboundAssociationsAugust 1996 mtaGroupName OBJECT-TYPE SYNTAXCounter32DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION"The total number of associations from"A descriptive name for the group. If this groupsinceconnects to a single remote MTAinitialization, wherethis should be thegroup wasname of that MTA. If this in turn is an Internet MTA this should be theinitiator."domain name. For an OSI MTA it should be the string encoded distinguished name of the managed object using the format defined in RFC 1779 [6]. For X.400(1984) MTAs which do not have a Distinguished Name, the RFC 1327 [9] syntax 'mta in globalid' should be used." ::= {mtaGroupEntry16} mtaGroupLastInboundActivity25} mtaGroupSuccessfulConvertedMessages OBJECT-TYPE SYNTAXTimeIntervalCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION"Time since the last time"The number of messages that have been successfully converted from one form to another in this grouphad an active inbound association for purposes of message reception."since group creation." ::= {mtaGroupEntry17} mtaGroupLastOutboundActivity26} mtaGroupFailedConvertedMessages OBJECT-TYPE SYNTAXTimeIntervalCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION"Time since the last time that"The number of messages for which an unsuccessful attempt was made to convert them from one form to another in this grouphad an outbound association for purposes of message delivery."since group creation." ::= {mtaGroupEntry18} mtaGroupRejectedInboundAssociations27} mtaGroupDescription OBJECT-TYPE SYNTAXCounter32DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION"The total number"A description ofinbound associationsthe group's purpose. This information is intended to identify the grouphas rejected, since MTA initialization. Rejected associations are not countedinthe accumulated association totals."a status display." ::= {mtaGroupEntry19}28} ExpiresMay 1996Frebruary 1997 [Page15]22] Internet Draft Mail Monitoring MIBNovember 1995 mtaGroupFailedOutboundAssociationsAugust 1996 mtaGroupURL OBJECT-TYPE SYNTAXCounter32URLString MAX-ACCESS read-only STATUS current DESCRIPTION"The total number associations where the group was"A URL pointing to a description of theinitiatorgroup. This information is intended to identify andassociation establishment has failed, since MTA initialization. Failed associations are not counted in the accumulated association totals." ::= {mtaGroupEntry 20} mtaGroupInboundRejectionReason OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The failure reason, if any, fordescribe thelast association thisgrouprefused to respond to. An empty string indicates that the last attempt was successful. If no association attempt has been made since the MTA was initialized the value should be 'never'."in a status display." ::={mtaGroupEntry 21} mtaGroupOutboundConnectFailureReason{mtaEntry 29} mtaGroupCreationTime OBJECT-TYPE SYNTAXDisplayStringTimeInterval MAX-ACCESS read-only STATUS current DESCRIPTION"The failure reason, if any, for the last association attempt"Time since this groupinitiated. An empty string indicates that the last attempt was successful. If no association attempt has been made since the MTAwasinitialized the value should be 'never'."first created." ::= {mtaGroupEntry22} mtaGroupScheduledRetry30} mtaGroupHierarchy OBJECT-TYPE SYNTAXTimeIntervalINTEGER (-2147483648..2147483647) MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"The time when"Describes how this group fits into the hierarchy. A positive value isscheduled to next attempt to makeinterpreted as anassociation."mtaGroupIndex value for some other group whose variables include those of this group (and usually others). A negative value is interpreted as a group collection code: Groups with common negative hierarchy values comprise one particular breakdown of MTA activity as a whole. A zero value means that this MIB implementation doesn't implement hierarchy indicators and thus the overall group hierarchy cannot be determined." ::= {mtaGroupEntry23} Expires May 1996 [Page 16] Internet Draft Mail Monitoring MIB November 1995 mtaGroupMailProtocol31} mtaGroupOldestMessageId OBJECT-TYPE SYNTAXOBJECT IDENTIFIERDisplayString MAX-ACCESS read-only STATUS current DESCRIPTION"An identification of the protocol being used by this group. For an group employing OSI protocols, this will be the Application Context. For Internet applications, the IANA maintains a registry"Message ID of theOIDs which correspond to well-knownoldest messagetransfer protocols. If the application protocol is not listedin theregistry, an OID value ofgroup's queue. Whenever possible this should be in the form{applTCPProtoID port} or {applUDProtoID port} are used for TCP-based and UDP-based protocols, respectively. In either case 'port' correspondsof an RFC 822 [10] msg-id; X.400 may convert X.400 message identifiers tothe primary port number being usedthis form by following thegroup. applTCPProtoID and applUDPProtoID are definedrules laid out in[5]."RFC1327 [9]." Expires Frebruary 1997 [Page 23] Internet Draft Mail Monitoring MIB August 1996 ::= {mtaGroupEntry24} mtaGroupName32} mtaGroupLoopsDetected OBJECT-TYPE SYNTAXDisplayStringCounter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Adescriptive name for the group. If this group connects tomessage loop is defined as asingle remotesituation where the MTAthis shoulddecides that a given message will never be delivered to one or more recipients and instead will continue to loop endlessly through one or more MTAs. This variable counts thenamenumber ofthat MTA. If this in turn is an Internettimes the MTA has detected such a situation in conjunction with something associated with thisshould begroup since group creation. Note that thedomain name. For an OSImechanism MTAs use to detect loops (e.g. trace field counting, count of references to this MTAit should be the string encoded distinguished namein a trace field, examination of DNS or other directory information, etc.), themanaged object using the format defined in RFC-1485. For X.400(1984) MTAslevel at whichdo not haveloops are detected (e.g. per message, per recipient, per directory entry, etc.), and the handling of aDistinguished Name,loop once it is detected (e.g. looping messages are held, looping messages are bounced or sent to theRFC-1327 syntax 'mta in globalid' shouldpostmaster, messages that the MTA knows will loop won't beused."accepted, etc.) vary widely from one MTA to the next and cannot be inferred from this variable." ::= {mtaGroupEntry25}33} mtaGroupAssociationTable OBJECT-TYPE SYNTAX SEQUENCE OF MtaGroupAssociationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table holding information regarding the associations for each MTA group." ::= {mta 3}Expires May 1996 [Page 17] Internet Draft Mail Monitoring MIB November 1995mtaGroupAssociationEntry OBJECT-TYPE SYNTAX MtaGroupAssociationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The entry holding information regarding the associations for each MTA group." INDEX {applIndex, mtaGroupIndex, mtaGroupAssociationIndex} ::= {mtaGroupAssociationTable 1} Expires Frebruary 1997 [Page 24] Internet Draft Mail Monitoring MIB August 1996 MtaGroupAssociationEntry ::= SEQUENCE { mtaGroupAssociationIndex INTEGER } mtaGroupAssociationIndex OBJECT-TYPE SYNTAX INTEGER (1..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "Reference into association table to allow correlation of this group's active associations with the association table." ::= {mtaGroupAssociationEntry 1} -- Conformance information mtaConformance OBJECT IDENTIFIER ::= {mta 4} mtaGroups OBJECT IDENTIFIER ::= {mtaConformance 1} mtaCompliances OBJECT IDENTIFIER ::= {mtaConformance 2} -- Compliance statements mtaCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMPv2 entities which implement the Mail Monitoring MIB for basic monitoring of MTAs." MODULE -- this module MANDATORY-GROUPS {mtaGroup} ::= {mtaCompliances 1}Expires May 1996 [Page 18] Internet Draft Mail Monitoring MIB November 1995mtaAssocCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMPv2 entities which implement the Mail Monitoring MIB for monitoring of MTAs and their associations." MODULE -- this module MANDATORY-GROUPS {mtaGroup, mtaAssocGroup} ::= {mtaCompliances 2} Expires Frebruary 1997 [Page 25] Internet Draft Mail Monitoring MIB August 1996 -- Units of conformance mtaGroup OBJECT-GROUP OBJECTS { mtaReceivedMessages, mtaStoredMessages, mtaTransmittedMessages, mtaReceivedVolume, mtaStoredVolume, mtaTransmittedVolume, mtaReceivedRecipients, mtaStoredRecipients, mtaTransmittedRecipients, mtaSuccessfulConvertedMessages, mtaFailedConvertedMessages, mtaLoopsDetected, mtaDescription, mtaURL, mtaGroupReceivedMessages, mtaGroupRejectedMessages, mtaGroupStoredMessages, mtaGroupTransmittedMessages, mtaGroupReceivedVolume, mtaGroupStoredVolume, mtaGroupTransmittedVolume, mtaGroupReceivedRecipients, mtaGroupStoredRecipients, mtaGroupTransmittedRecipients, mtaGroupOldestMessageStored, mtaGroupInboundAssociations, mtaGroupOutboundAssociations, mtaGroupAccumulatedInboundAssociations, mtaGroupAccumulatedOutboundAssociations, mtaGroupLastInboundActivity, mtaGroupLastOutboundActivity, mtaGroupLastOutboundAssociationAttempt, mtaGroupRejectedInboundAssociations, mtaGroupFailedOutboundAssociations, mtaGroupInboundRejectionReason, mtaGroupOutboundConnectFailureReason, mtaGroupScheduledRetry, mtaGroupMailProtocol,mtaGroupName}mtaGroupName, mtaGroupSuccessfulConvertedMessages, mtaGroupFailedConvertedMessages, mtaGroupDescription, mtaGroupURL, mtaGroupCreationTime, mtaGroupHierarchy, mtaGroupOldestMessageId, mtaGroupLoopsDetected} STATUS current DESCRIPTION "A collection of objects providing basic monitoring of MTAs." ::= {mtaGroups 1}Expires May 1996 [Page 19] Internet Draft Mail Monitoring MIB November 1995mtaAssocGroup OBJECT-GROUP OBJECTS { mtaGroupAssociationIndex} STATUS current DESCRIPTION "A collection of objects providing monitoring of MTA associations." ::= {mtaGroups 2} END ExpiresMay 1996Frebruary 1997 [Page20]26] Internet Draft Mail Monitoring MIBNovember 1995August 1996 7. Changes made sinceRFC1565RFC 1566 The only changes made to this document since it was issued asRFC1566RFC 1566 [8] are the following: (1) A number of DESCRIPTION fields have been reworded, hopefully making them clearer. (2) mtaDescription, mtaURL, mtaGroupDescription, mtaGroupURL fields have been added. These fields are intended to identify and describe the MTA and the various MTA groups. (3) The time since the last outbound association attempt is now distinct from the time since the last successfuol outbound association attempt. (4) Conversion operation counters have been added. (5) A mechanism to explicitly describe group hierarchies has been added. (6) A field for the ID of the oldest message in a group's queue has been added. (7) Per-MTA and per-group message loop counters have been added. ExpiresMay 1996Frebruary 1997 [Page21]27] Internet Draft Mail Monitoring MIBNovember 1995August 1996 8. Acknowledgements This document is a product of the Mail and Directory Management (MADMAN) Working Group. It is based on an earlier MIB designed by S. Kille, T. Lenggenhager, D. Partain, and W. Yeong. The Electronic Mail Association's TSC committee was instrumental in providing feedback on and suggesting enhancements to RFC 1566 [8] that have led to the present document. 9. References [1] Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Structure of Management Information forversionVersion 2 of the Simple Network Management Protocol (SNMPv2)",RFC1442, SNMP Research, Inc., Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, April 1993.RFC 1902, January 1996. [2] McCloghrie, K., and Rose, M., 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] Galvin, J., McCloghrie, K., " Administrative Model for version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,Trusted Information Systems, Hughes LAN Systems,April 1993. [4] Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Protocol Operations forversionVersion 2 of the Simple Network Management Protocol (SNMPv2)",RFC1448, SNMP Research, Inc., Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon University, April 1993.RFC 1905, January 1996. [5] Freed, N., Kille, S., "The Network Services Monitoring MIB", Internet Draft,November,March 1996. [6] Kille, S., "A String Representation of Distinguished Names", RFC 1779, March 1995. [7] Berners-Lee, T., Masinter, L., McCahill, M., iform Resource Locators (URL)", RFC 1738, December 1994. [8] Freed, N., Kille, S., "Mail Monitoring MIB", RFC 1566, January 1994. [9] Kille, S., "Mapping between X.400(1988) / ISO 10021 and RFC 822", RFC 1327, May 1992. [10] Crocker, D., "Standard for the Format of ARPA Internet Text Message", August 1982. Expires Frebruary 1997 [Page 28] Internet Draft Mail Monitoring MIB August 1996 [11] Vaudreuil, G., "Enhanced Mail System Status Codes", RFC 1893, Octel Network Services, January 1996. 10. Security Considerations Security issues are not discussed in this memo.Expires May 1996 [Page 22] Internet Draft Mail Monitoring MIB November 199511. Authors' Addresses Ned Freed, Editor Innosoft International, Inc. 1050 East Garvey Avenue South West Covina, CA 91790 USA tel: +1 818 919 3600 fax: +1 818 919 3614 email: ned@innosoft.com Steve Kille, WG Chair ISODE Consortium The Dome, The Square Richmond TW9 1DT UK tel: +4481181 332 9091 email: S.Kille@isode.com ExpiresMay 1996Frebruary 1997 [Page23]29] ----