REPORT-SAMPLED-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Gauge32, Integer32, experimental FROM SNMPv2-SMI -- [RFC2578] TimeStamp FROM SNMPv2-TC -- [RFC2579] MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF -- [RFC2580] usrHistoryControlEntry, usrHistoryObjectEntry, usrHistoryControlIndex, usrHistoryControlOwner, usrHistoryObjectIndex -- usrHistoryControlObjects, usrHistoryControlBucketsRequested, -- usrHistoryControlBucketsGranted, usrHistoryControlInterval, -- usrHistoryControlStatus, -- usrHistoryObjectVariable, usrHistoryObjectSampleType FROM RMON2-MIB -- [RFC2021] InetAddress, InetAddressType FROM INET-ADDRESS-MIB -- [RFC4001] ; reportSampledMIB MODULE-IDENTITY LAST-UPDATED "201110311300Z" -- October 31, 2011 ORGANIZATION "IETF MANET Working Group" CONTACT-INFO "WG E-Mail: manet@ietf.org WG Chairs: ian.chakeres@gmail.com jmacker@nrl.navy.mil Editors: Robert G. Cole US Army CERDEC 6010 Frankford Road Aberdeen Proving Ground, MD 21005 USA +1 443 395-8744 robert.g.cole@us.army.mil Joseph Macker Naval Research Laboratory Washington, D.C. 20375 USA macker@itd.nrl.navy.mil Andy Bierman Brocade andy.bierman@brocade.com" DESCRIPTION "This MIB module contains managed object definitions for the autonmous reporting of performance object counters. Copyright (C) The IETF Trust (2009). This version of this MIB module is part of RFC xxxx; see the RFC itself for full legal notices." -- Revision History REVISION "201110311300Z" -- October 31, 2011 DESCRIPTION "The sixth draft of this MIB module published as draft-ietf-manet-report-mib-02.txt. Revisions to this draft include a) Pulled the statistical and historical reporting from the MIB module and left only the sampled reporting, in order to greatly simplify the first instance of this reporting MIB module. b) Renamed the module, the REPORT-SAMPLED-MIB module. c) Leveraged the RMON2-MIB module more effectively through the use of the AUGMENTS clause. d) Changed the module to 'experimental'. " REVISION "201102171300Z" -- February 17, 2011 DESCRIPTION "The fifth draft of this MIB module published as draft-ietf-manet-report-mib-01.txt. This document has been promoted to a MANET Working Group draft. Revisions to this draft include a) Proposed changes to the statsReport table to simplify communications between device and mgmt application, b) Added Notifications, c) Changed the reporting structure of the Sampled and the History reporting to align with the structure of the Statistics reports for the purpose of allowing for efficient notification and collection of data reports. d) Ran through smilint to clean up all errors and most warning. A few still remain. " REVISION "201007051300Z" -- July 05, 2010 DESCRIPTION "The fourth draft of this MIB module published as draft-ietf-manet-report-mib-00.txt. This document has been promoted to a MANET Working Group draft. Significant revisions to this draft include a) added support for proxy configurations through the addition of address objects associated with the referenced counter objects associated with the performance reports." REVISION "201003021300Z" -- March 02, 2010 DESCRIPTION "The third draft of this MIB module published as draft-cole-manet-report-mib-02.txt. Significant revisions to this draft include a) changed naming of usrHistoryGroup to sampledGroup and b) added a historyGroup." REVISION "200910251300Z" -- October 25, 2009 DESCRIPTION "The second draft of this MIB module published as draft-cole-manet-report-mib-01.txt. Significant revisions to this draft include a) the inclusion of raw data collection borrow blatently from the usrHistory Group within RMON2, b) the deletion of the CurrentHistoryTable from version -00, c) modifications to the overall structure of the MIB, and d) the definition of various Compliance options for implementations related to this MIB." REVISION "200904281300Z" -- April 28, 2009 DESCRIPTION "Initial draft of this MIB module published as draft-cole-manet-report-mib-00.txt." -- RFC-Editor assigns XXXX ::= { experimental 998 } -- to be assigned by IANA -- TEXTUAL CONVENTIONs -- None -- -- Top-Level Object Identifier Assignments -- reportSampledMIBNotifications OBJECT IDENTIFIER ::= { reportSampledMIB 0 } reportSampledMIBObjects OBJECT IDENTIFIER ::= { reportSampledMIB 1 } reportSampledMIBConformance OBJECT IDENTIFIER ::= { reportSampledMIB 2 } reportSampledGroup OBJECT IDENTIFIER ::= { reportSampledMIBObjects 1 } -- Then, the reportSampledGroup assignments are : -- reportSampledControlTable - 1 -- reportSampledObjectTable - 2 -- reportSampledDataTable - 3 reportSampledControlTable OBJECT-TYPE SYNTAX SEQUENCE OF SampledControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A list of data-collection configuration entries." ::= { reportSampledGroup 1 } reportSampledControlEntry OBJECT-TYPE SYNTAX SampledControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A list of parameters that set up a group of user-defined MIB objects to be sampled periodically (called a bucket-group). For example, an instance of reportSampledControlInterval might be named reportSampledControlInterval.1" AUGMENTS { usrHistoryControlEntry } ::= { reportSampledControlTable 1 } SampledControlEntry ::= SEQUENCE { reportSampledControlRequestedNumber Integer32, reportSampledControlReportNumber Integer32 } reportSampledControlRequestedNumber OBJECT-TYPE SYNTAX Integer32 (1..127) MAX-ACCESS read-create STATUS current DESCRIPTION "The number of reports to be generated and stored by this agent for this report request. This object may not be modified if the associated reportSampledControlStatus object is equal to active(1)." DEFVAL { 1 } ::= { reportSampledControlEntry 1 } reportSampledControlReportNumber OBJECT-TYPE SYNTAX Integer32 (1..127) MAX-ACCESS read-only STATUS current DESCRIPTION "The number of the current report in progress. The first report is assigned a number equal to '1'. Each successive report number is incremented by unity. When the last report is completed, this value is set to reportSampledControlRequestedNumber + 1." ::= { reportSampledControlEntry 2 } -- Object table reportSampledObjectTable OBJECT-TYPE SYNTAX SEQUENCE OF SampledObjectEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A list of data-collection configuration entries." ::= { reportSampledGroup 2 } reportSampledObjectEntry OBJECT-TYPE SYNTAX SampledObjectEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A list of MIB instances to be sampled periodically. Entries in this table are created when an associated reportSampledControlObjects object is created. The usrHistoryControlIndex value in the index is that of the associated reportSampledControlEntry. For example, an instance of reportSampledObjectVariable might be reportSampledObjectVariable.1.3" AUGMENTS { usrHistoryObjectEntry } ::= { reportSampledObjectTable 1 } SampledObjectEntry ::= SEQUENCE { reportSampledObjectIpAddrType InetAddressType, reportSampledObjectIPAddress InetAddress } reportSampledObjectIpAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "This identifies the IP address type of the IP address associated with the secondary counter object to be monitored within this report. This object may not be modified if the associated reportStatsControlStatus object is equal to active(1)." ::= { reportSampledObjectEntry 1 } reportSampledObjectIPAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "This identifies the IP addree of the secondary counter object to be monitored within this report. This object may not be modified if the associated reportStatsControlStatus object is equal to active(1)." ::= { reportSampledObjectEntry 2 } -- data table reportSampledTable OBJECT-TYPE SYNTAX SEQUENCE OF SampledEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A list of user defined history entries." ::= { reportSampledGroup 3 } reportSampledEntry OBJECT-TYPE SYNTAX SampledEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A historical sample of user-defined variables. This sample is associated with the reportSampledControlEntry which set up the parameters for a regular collection of these samples. The usrHistoryControlIndex value in the index identifies the reportSampledControlEntry on whose behalf this entry was created. The usrHistoryObjectIndex value in the index identifies the reportSampledObjectEntry on whose behalf this entry was created. For example, an instance of reportSampledAbsValue, which represents the 14th sample of a variable collected as specified by reportSampledControlEntry.1 and reportSampledObjectEntry.1.5, would be named reportSampledAbsValue.1.14.5" INDEX { usrHistoryControlIndex, reportSampledReportIndex, reportSampledSampleIndex, usrHistoryObjectIndex } ::= { reportSampledTable 1 } SampledEntry ::= SEQUENCE { reportSampledReportIndex Integer32, reportSampledSampleIndex Integer32, reportSampledIntervalStart TimeStamp, reportSampledIntervalEnd TimeStamp, reportSampledAbsValue Gauge32, reportSampledValStatus INTEGER } reportSampledReportIndex OBJECT-TYPE SYNTAX Integer32 (1..127) MAX-ACCESS read-only STATUS current DESCRIPTION "An index that uniquely identifies the particular report this entry is associated with among the set of reports requested through the reportSampledControlNumber in the reportSampledControlEntry. This index starts at 1 and increases by one as each new report is generated." ::= { reportSampledEntry 1 } reportSampledSampleIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that uniquely identifies the particular sample this entry represents among all samples associated with the same reportSampledControlEntry. This index starts at 1 and increases by one as each new sample is taken." ::= { reportSampledEntry 2 } reportSampledIntervalStart OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the start of the interval over which this sample was measured. If the probe keeps track of the time of day, it should start the first sample of the history at a time such that when the next hour of the day begins, a sample is started at that instant. Note that following this rule may require the probe to delay collecting the first sample of the history, as each sample must be of the same interval. Also note that the sample which is currently being collected is not accessible in this table until the end of its interval." ::= { reportSampledEntry 3 } reportSampledIntervalEnd OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the end of the interval over which this sample was measured." ::= { reportSampledEntry 4 } reportSampledAbsValue OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The absolute value (i.e. unsigned value) of the user-specified statistic during the last sampling period. The value during the current sampling period is not made available until the period is completed. To obtain the true value for this sampling interval, the associated instance of reportSampledValStatus must be checked, and reportSampledAbsValue adjusted as necessary. If the MIB instance could not be accessed during the sampling interval, then this object will have a value of zero and the associated instance of reportSampledValStatus will be set to 'valueNotAvailable(1)'." ::= { reportSampledEntry 5 } reportSampledValStatus OBJECT-TYPE SYNTAX INTEGER { valueNotAvailable(1), valuePositive(2), valueNegative(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the validity and sign of the data in the associated instance of reportSampledAbsValue. If the MIB instance could not be accessed during the sampling interval, then 'valueNotAvailable(1)' will be returned. If the sample is valid and actual value of the sample is greater than or equal to zero then 'valuePositive(2)' is returned. If the sample is valid and the actual value of the sample is less than zero, 'valueNegative(3)' will be returned. The associated instance of reportSampledAbsValue should be multiplied by -1 to obtain the true sample value." ::= { reportSampledEntry 6 } -- -- Notifications -- reportSampledNotificationObjects OBJECT IDENTIFIER ::= {reportSampledMIBNotifications 1} -- reportSampledNotificationObjects reportSampledNewDataReport NOTIFICATION-TYPE OBJECTS { usrHistoryControlOwner, -- The entity that -- configured this entry reportSampledReportIndex -- The index of the -- data table for this report } STATUS current DESCRIPTION "reportSampledNewDataReport is a notification sent when a new report is completed from the reportSampledControlTable. The notification carries the index from the control table that established this report and the index from the data table that holds this report. Indication of the new report is when the reportSampledControlReportNumber is incremented." ::= { reportSampledNotificationObjects 1 } -- -- Compliance Statements -- -- Mandatory for Sampled will include all. reportSampledCompliances OBJECT IDENTIFIER ::= { reportSampledMIBConformance 1 } reportSampledMIBGroups OBJECT IDENTIFIER ::= { reportSampledMIBConformance 2 } reportSampledCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The Sampled basic implementation requirements for managed network entities that implement the REPORT Sampled process." MODULE -- this module MANDATORY-GROUPS { reportSampledLocalGroup } ::= { reportSampledCompliances 1 } reportSampledNotificationCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The Sampled Notification implementation requirements for managed network entities that implement the REPORT process." MODULE -- this module MANDATORY-GROUPS { reportSampledNotificationObjectGroup } ::= { reportSampledCompliances 2 } -- Units of Conformance reportSampledLocalGroup OBJECT-GROUP OBJECTS { reportSampledControlRequestedNumber, reportSampledControlReportNumber, reportSampledObjectIpAddrType, reportSampledObjectIPAddress, reportSampledReportIndex, reportSampledIntervalStart, reportSampledIntervalEnd, reportSampledAbsValue, reportSampledValStatus } STATUS current DESCRIPTION "Set of REPORT state objects implemented in this module." ::= { reportSampledMIBGroups 1 } --reportSampledImportedGroup OBJECT-GROUP -- OBJECTS { -- usrHistoryControlObjects, -- usrHistoryControlBucketsRequested, -- usrHistoryControlBucketsGranted, -- usrHistoryControlInterval, -- usrHistoryControlOwner, -- usrHistoryControlStatus, -- usrHistoryObjectVariable, -- usrHistoryObjectSampleType -- } -- STATUS current -- DESCRIPTION -- "Set of REPORT state objects implemented -- in this module." --::= { reportSampledMIBGroups 2 } reportSampledNotificationObjectGroup NOTIFICATION-GROUP NOTIFICATIONS { reportSampledNewDataReport } STATUS current DESCRIPTION "Set of REPORT notifications implemented in this module for the Sampled reports." ::= { reportSampledMIBGroups 3 } END