draft-ietf-manet-report-mib-01.txt   draft-ietf-manet-report-mib-02.txt 
Internet Engineering Task Force R. Cole Internet Engineering Task Force R. Cole
Internet-Draft US Army CERDEC Internet-Draft US Army CERDEC
Intended status: Standards Track J. Macker Intended status: Experimental J. Macker
Expires: August 21, 2011 Naval Research Laboratory Expires: August 3, 2012 Naval Research Laboratory
A. Morton A. Bierman
AT&T Laboratories Brocade
February 17, 2011 January 31, 2012
Definition of Managed Objects for Performance Reporting Definition of Managed Objects for Performance Reporting
draft-ietf-manet-report-mib-01 draft-ietf-manet-report-mib-02
Abstract Abstract
This memo defines a portion of the Management Information Base (MIB) This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community. for use with network management protocols in the Internet community.
In particular, it describes objects for configuring autonomous report In particular, it describes objects for configuring autonomous report
generation on any device that supports MIBs containing counter and generation on any device that supports MIBs containing counter and
gauge objects for performance monitoring. This allows a management gauge objects for performance monitoring. This allows a management
station to instruct a device to build off-line reports to be station to instruct a device to build off-line reports to be
collected asynchronously by the management station. Further, this collected asynchronously by the management station. Further, this
REPORT-MIB can be configured in a proxy configuration where the REPORT-SAMPLED-MIB can be configured in a proxy configuration where
report generation is performed on a device in close network proximity the report generation is performed on a device in close network
to the device containing the referenced counter objects. Hence, this proximity to the device containing the referenced counter objects.
capability allows network operators to reduce the SNMP polling Hence, this capability allows network operators to reduce the SNMP
traffic burden on Mobile Ad-Hoc and Disruption Tolerant Networks polling traffic burden on Mobile Ad-Hoc and Disruption Tolerant
which is typical of SNMP performance management applications. This Networks which is typical of SNMP performance management
capability also improves the accuracy of the performance reports by applications.
minimizing the delay variation between the reporting agent (this MIB)
and the data monitor (the MIB containing the monitored counter
objects).
Status of This Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on August 21, 2011. This Internet-Draft will expire on August 3, 2012.
Copyright Notice Copyright Notice
Copyright (c) 2012 IETF Trust and the persons identified as the
Copyright (c) 2011 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The Internet-Standard Management Framework . . . . . . . . . . 4 2. The Internet-Standard Management Framework . . . . . . . . . . 3
3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4
4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4.1. REPORT-MIB Management Model . . . . . . . . . . . . . . . 4 4.1. REPORT-SAMPLED-MIB Management Model . . . . . . . . . . . 4
4.2. Terms . . . . . . . . . . . . . . . . . . . . . . . . . . 8 4.2. Terms . . . . . . . . . . . . . . . . . . . . . . . . . . 6
5. Structure of the MIB Module . . . . . . . . . . . . . . . . . 9 5. Structure of the MIB Module . . . . . . . . . . . . . . . . . 6
5.1. Textual Conventions . . . . . . . . . . . . . . . . . . . 9 5.1. Textual Conventions . . . . . . . . . . . . . . . . . . . 6
5.2. The Statistics Group . . . . . . . . . . . . . . . . . . . 9 5.2. The Sampled Group . . . . . . . . . . . . . . . . . . . . 7
5.3. The Sampled Group . . . . . . . . . . . . . . . . . . . . 10 5.3. The Notifications Group . . . . . . . . . . . . . . . . . 7
5.4. The History Group . . . . . . . . . . . . . . . . . . . . 11 6. Relationship to Other MIB Modules . . . . . . . . . . . . . . 7
5.5. The Notifications Group . . . . . . . . . . . . . . . . . 11 6.1. Relationship to the SNMPv2-MIB . . . . . . . . . . . . . . 7
6. Relationship to Other MIB Modules . . . . . . . . . . . . . . 11 6.2. Relationship to the RMON2-MIB . . . . . . . . . . . . . . 8
6.1. Relationship to the SNMPv2-MIB . . . . . . . . . . . . . . 11 6.3. MIB modules required for IMPORTS . . . . . . . . . . . . . 8
6.2. Relationship to the RMON2-MIB . . . . . . . . . . . . . . 11 7. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 8
6.3. Relationship to the TPM-MIB . . . . . . . . . . . . . . . 12 8. Security Considerations . . . . . . . . . . . . . . . . . . . 19
6.4. MIB modules required for IMPORTS . . . . . . . . . . . . . 12 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 22
7. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 12 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 22
8. Security Considerations . . . . . . . . . . . . . . . . . . . 67 11. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 22
9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 69 12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 22
10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 70 12.1. Normative References . . . . . . . . . . . . . . . . . . . 22
11. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 70 12.2. Informative References . . . . . . . . . . . . . . . . . . 23
12. References . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 23
12.1. Normative References . . . . . . . . . . . . . . . . . . . 70 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . . 25
12.2. Informative References . . . . . . . . . . . . . . . . . . 71 Appendix C. . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 71
Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . . 73
Appendix C. . . . . . . . . . . . . . . . . . . . . . . . . . . 74
1. Introduction 1. Introduction
This memo defines a portion of the Management Information Base (MIB) This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community. for use with network management protocols in the Internet community.
In particular, it describes objects for configuring autonomous, off- In particular, it describes objects for configuring autonomous, off-
line report generation for performance monitoring on any device line report generation for performance monitoring on any device
supporting MIBs containing variables that resolve to type Integer32 supporting MIBs containing variables that resolve to type Integer32
(i.e., Integer32, Counter, Gauge, or TimeTicks). This REPORT-MIB (i.e., Integer32, Counter, Gauge, or TimeTicks). This REPORT-
allows for the report generation to occur on the same device as SAMPLED-MIB allows for the report generation to occur on the same
containing the referenced counter object or on a device in close device as containing the referenced counter object or on a device in
network proximity to the device with the referenced counter object. close network proximity to the device with the referenced counter
This should be useful to devices or networks where efficient use of object. This should be useful to devices or networks where efficient
bandwidth is of concern or where intermittent connectivity is common. use of bandwidth is of concern or where intermittent connectivity is
Hence, the REPORT-MIB is useful for devices managed over some Mobile common. Hence, the REPORT-SAMPLED-MIB is useful for devices managed
Ad-Hoc Networks (MANETs) or Disruption Tolerant Networks (DTNs). over some Mobile Ad-Hoc Networks (MANETs) or Disruption Tolerant
Networks (DTNs).
The REPORT-MIB offers three types of off-line reporting. One type
offering reports which present statistical analysis of the objects
being tracked; found within the reportStatsGroup. The second type
offering a means to collect sampled data related to defined MIB
objects. This second type of reporting is contained in the
reportSampledGroup. The third offering reports which present
(collect) raw data values and their time of change from the objects
being tracked; found within the reportHistoryGroup.
For statistical reporting, the REPORT-MIB borrows from the RMON This version of the REPORT-SAMPLED-MIB offers one type of off-line
[RFC1757] ReportsControl and Reports Tables. Here the reporting. The MIB offers a means to collect sampled data related to
reportStatsCapabilitiesGroup defines the capabilities of the device defined MIB objects. This type of reporting is contained in the
with respect performance monitoring and statistical analysis. Some reportSampledGroup. Other types of report data are possible,
analysis is hard-coded into the definition of the including statistical data and historical data. However, it was felt
reportStatsDataGroup while the device can also advertise extended wise to focus on a more limited scope off-line reporting capability
statistical reporting via the reportMetricExtDefTable. The and gain experimental use and application prior to expending energy
reportsControlTable specifies the report metrics, the Object ID to developing a more extensive capability.
monitor and other aspects of the statistical report development and
storage.
For the collection of sampled data, the REPORT-MIB draws directly For the collection of sampled data, the REPORT-SAMPLED-MIB draws
from the usrHistoryGroup from RMON 2 [RFC2021]. Here the directly from the usrHistoryGroup from RMON 2 [RFC2021] through
application of the 'AUGMENTS' clause. . Here the
reportSampledControlTable allows the user to define aspects of the reportSampledControlTable allows the user to define aspects of the
report for sampled data, including the number of MIB objects to be report for sampled data, including the number of MIB objects to be
sampled and the nature of the sampling frequency and overall report sampled and the nature of the sampling frequency and overall report
duration. This group uses the notion of buckets, which contained duration. This group uses the notion of buckets, which contain
sampled data from a set of identified MIB objects sampled at the same sampled data from a set of identified MIB objects sampled at the same
time point. The report consists of the buckets, each containing sets time point. The report consists of the buckets, each containing sets
of sampled data from the selected MIB objects but at the specific of sampled data from the selected MIB objects but at the specific
sampling times. The reportSampledObjectTable allows the user to sampling times. The reportSampledObjectTable allows the user to
identify the multiple MIB objects to be sampled. The identify the multiple MIB objects to be sampled. The
reportSampledDataTable contains the storage of the reported sampled reportSampledDataTable contains the storage of the reported sampled
data contained within buckets, one bucket for each time sampling data contained within buckets, one bucket for each time sampling
instance. instance.
For the collection of raw data, the REPORT-MIB contains a
reportHistoryGroup comprised of the reportHistoryControlTable for
control of historical data reports and the reportHistoryDataTable for
the storage of the historical reports.
Various compliance groups are defined which allow for development of
raw data collection reports, collection of sampled data reports or
only statistical data reports, or all combinations.
2. The Internet-Standard Management Framework 2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410]. RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP). accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the Objects in the MIB are defined using the mechanisms defined in the
skipping to change at page 4, line 39 skipping to change at page 4, line 22
[RFC2580]. [RFC2580].
3. Conventions 3. Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119]. document are to be interpreted as described in RFC 2119 [RFC2119].
4. Overview 4. Overview
The REPORT-MIB references performance objects in other MIBs (and in The REPORT-SAMPLED-MIB references performance objects in other MIBs
other devices) and generates offline performance reports on those (and in other devices) and generates off-line performance reports
referenced objects. The REPORT-MIB can be coincident with the other related to those referenced objects. The REPORT-SAMPLED-MIB can be
MIB or can reside on another device in close network proximity to the coincident with the other MIB or can reside on another device in
device containing the referenced performance related object. close network proximity to the device containing the referenced
performance related object.
4.1. REPORT-MIB Management Model 4.1. REPORT-SAMPLED-MIB Management Model
This section describes the management model for the REPORT-MIB This section describes the management model for the REPORT-SAMPLED-
process. First, the model for the reportStatsGroup is presented. MIB process.
Then the models for the reportSampledGroup and the reportHistoryGroup
are presented.
Figure 1 illustrates a potential use of the REPORT-MIB for the Figure 1 illustrates a potential use of the REPORT-SAMPLED-MIB for
generation of off-line, remotely generated reports. The management the generation of off-line, remotely generated reports. The
station on the left hand side of the illustration instructs the management station on the left hand side of the illustration
remote device to create reports through manipulation of the instructs the remote device to create reports through manipulation of
ReportCntrl Objects in the REPORT-MIB resident on the remote device. the ReportCntrl Objects in the REPORT-SAMPLED-MIB resident on the
The reports instruct the device to monitor the status of specified remote device. The reports instruct the device to monitor the status
counters (on other MIBs and potentially on other devices in close of specified counters (on other MIBs and potentially on other devices
network proximity) periodically and to generate a set of metrics in close network proximity) periodically. The reports are stored
describing the temporal behavior of those counter values. The locally until the management station decides to pull them off the
reports are stored locally until the management station decides to device. The figure shows a case where the REPORT-SAMPLED-MIB
pull them off the device. The figure shows a case where the REPORT- generates a notification that Report_2 has completed, prompting the
MIB generates a notification that Report_2 has completed, prompting management station to pull Report_2 from the device.
the management station to pull Report_2 from the device.
Mgmt Device Mgmt Device
Station Station
REPORT-MIB MIB_1 REPORT-SAMPLED-MIB MIB_1
+---------+ +-----+ +---------+ +-----+
| | | | | | | |
Build_Rep_1 |+-------+| +--+ | Build_Rep_1 |+-------+| +--+ |
+----------------->||cntrl_1||<------>|PC| | +----------------->||cntrl_1||<------>|PC| |
|+-------+|<-+ +--+--+ |+-------+|<-+ +--+--+
| | | | | |
| | | MIB_2 | | | MIB_2
| | | +-----+ | | | +-----+
| | | | | | | |
| | | +--+ | | | | +--+ |
skipping to change at page 6, line 45 skipping to change at page 5, line 45
| | | |
|+-----+ | |+-----+ |
||Rep_3| | ||Rep_3| |
|+-----+ | |+-----+ |
Get_Rep_2 | | Get_Rep_2 | |
+----------------->| | +----------------->| |
| | | |
<-----------------+| | <-----------------+| |
Send_Rep_2 +---------+ Send_Rep_2 +---------+
Figure 1: REPORT-MIB front-end report generation process. Figure 1: REPORT-SAMPLED-MIB front-end report generation process.
The REPORT-MIB's reportStatsGroup defines specifically a set of
metrics which are computed within all reports. It also allows for
the specification of metric extensions which are local to the
specific implementation of the REPORT-MIB. These are identified in
the reportStatsCapabilitiesGroup metricExtension Table.
Each metric has an associated Object ID of type counter associated
with it. The control table specifies a report interval and a bin
interval. The report interval is an integral multiple of the bin
interval. For each bin interval, the device identifies the change in
the counter value over the bin interval (called x_i) and then
computes the associated metric, e.g., sum, sum of the square, etc,
over the set {x_i}. It maintains the sum of these computations
within the metric objects in the 'reportStatsDataTable'. Once the
report interval is complete, the management station has enough
information to compute a set of interesting and useful statistics.
The computational model of the reportStatsGroup of the REPORT-MIB is
illustrated in the figure below. The important controls are a) the
contrlInterval, b) the cntrlBinInterval, c) the specific
counterObjectId, and d) the metric. In the figure x_i represents the
ith value of the counter change, i.e., x_i = counterValue(t_i+1) -
counterValue(t_i). The metrics reported are then computed from the
set (x_i). Three examples are identified in the figure, e.g.,
StatSumX, StatSumSq and StatMaxX. Other existing and potential
metrics are discussed below.
|
|<--------------------- cntrlInterval ---------------------------->|
| |
| | | | | | | |
| x_0 | x_1 | x_2 | x_3 | ... |x_n-2|x_n-1|
+-----+-----+-----+-----+--- ---+-----+-----+
^ ^ ^ ^ ^ ^ ^ ^
t_0 t_1 t_2 t_3 t_4 t_n-2 t_n-1 t_n
where t_i - t_i-1 = cntrlBinInterval
n = cntrlInterval / cntrlBinInterval
StatSumX = Sum(x_i) from i=0, ..., n-1
StatSumSq = Sum((x_i)^2) from i=0, ..., n-1
StatMaxX = Max(x_i) for i=0, ..., n-1
Figure 2: REPORT-MIB statistical analysis computation process.
This capability then allows for the computation of various
significant statistics related to the behavior of the referenced
object.
o Maximum and Minimum - the maximum and the minimum change in the
referenced object during a single cntrlBinInterval during the
cntrlInterval.
o Arithmetic Mean - the mean change in the referenced object over
all control bin intervals during the cntrlInterval. This is
derived from the StatSumX quantity.
o Variance - the variance in the change of the referenced object
over all control bin intervals within the cntrlInterval. This is
derived from the StatSumSq and the StatSumX quantities.
These are accessible from the statistical datum provided by this MIB
module. Other statistics are derivable including, e.g., the slope of
a least-squares fit to the rate of change of the referenced object.
These are described below.
The REPORT-MIB also provides for the collection of sampled data This version of the REPORT-SAMPLED-MIB provides for the collection of
instead of statistical data. It does this by importing (copying) the sampled data instead of statistical data. It does this by augmenting
usrHistory group from RMON2 [RFC2021] which allows for the generation the usrHistory group from RMON2 [RFC2021] which allows for the
of reports collecting the sampled object values binned for the generation of reports collecting the sampled object values binned for
purpose of aggregation and efficiency of collection. These are the purpose of aggregation and efficiency of collection. These are
defined within the reportSampledGroup. The model used for this type defined within the reportSampledGroup. The model used for this type
of report generation is based upon three tables. The of report generation is based upon three tables. The
reportSampledControlTable defines aspects of the report generation reportSampledControlTable defines aspects of the report generation
related to duration of the reporting interval, the bin (or bucket) related to duration of the reporting interval, the bin (or bucket)
sizes for the report, and the number of object values collected for sizes for the report, and the number of object values collected for
each bucket. The reportUsrHistoryObjectTable identifies the specific each bucket. The reportUsrHistoryObjectTable identifies the specific
MIB objects whose values are binned within the report. And the MIB objects whose values are binned within the report. And the
reportSampledDataTable contains the binned data values collected for reportSampledDataTable contains the binned data values collected for
the report. the report.
The REPORT-MIB also provides for the collection of historical data
instead of statistical or sampled data. It does this by defining the
reportHistoryControlTable for the control of the historical reports
and the reportHistoryDataTable for the storage of the historical
reports.
4.2. Terms 4.2. Terms
The following definitions apply throughout this document: The following definitions apply throughout this document:
o Capabilities - Objects related to the capabilities of the device
and MIB implemented on the device. Some objects are explicitly
defined within the REPORT-MIB. Other capabilities can be exposed
through the REPORT-MIB, but which are not explicitly defined
within this document. These later capabilities include objects,
e.g., for new metrics.
o Control - Objects defined within this document which set the o Control - Objects defined within this document which set the
parameters for specific reports to be generated offline on the the parameters for specific reports to be generated offline on the the
remote managed device. remote managed device.
o Data - Objects which hold the report data, either statistical, o Data - Objects which hold the sampled report data.
sampled or raw history data.
5. Structure of the MIB Module 5. Structure of the MIB Module
This section presents the structure of the REPORT-MIB module. The This section presents the structure of the REPORT-SAMPLED-MIB module.
objects are arranged into the following groups: The objects are arranged into the following groups:
o reportMIBNotifications - defines the notifications associated with o reportSampledMIBNotifications - defines the notifications
the REPORT-MIB. associated with the REPORT-SAMPLED-MIB.
o reportMIBObjects - defines the objects forming the basis for the o reportSampledMIBObjects - defines the objects forming the basis
REPORT MIB. These objects are divided up by function into the for the REPORT-SAMPLED-MIB. These objects are divided up by
following groups: function into the following groups (currently only one group is
defined):
o o
* Statistics Group - This group contains the objects which
support the generation of reports of a statistical nature.
* Sampled Group - This group contains the objects which support * Sampled Group - This group contains the objects which support
the generation (collection) of reports exposing sampled data the generation (collection) of reports exposing sampled data
values. values.
* History Group - This group contains the objects which support o reportSampledMIBConformance - Defines a variety of conformance of
the generation (collection) of historical reports exposing raw implementations of this REPORT-SAMPLED-MIB.
data values.
o reportMIBConformance - Defines a variety of conformance of
implementations of this REPORT-MIB.
5.1. Textual Conventions 5.1. Textual Conventions
The textual conventions used in the REPORT-MIB are as follows. The No textual conventions are used in the REPORT-SAMPLED-MIB.
RowStatus textual convention is imported from RFC 2579 [RFC2579].
5.2. The Statistics Group
The REPORT-MIB Statistics Group contains objects which allows for the
generation of statistical analysis reports. For example, this group
can be exercised to generate the mean and variance of the referenced
counter object. The Statistics Group is composed of:
o reportStatsCapabilitiesGroup - lists the statistics collections
capabilities of this device. Certain statistics are mandatory,
i.e., hard coded into the MIB definitions. While, the
capabilities group allows the developer to add additional
statistical analysis capabilities.
o reportStatsControlGroup - allows the management application to
define the parameters of the reports.
o reportStatsDataGroup - presents the data from the specified
reports.
As an example of how the metrics are to be computed within the
REPORT-MIB, consider the standard metric object
'reportStatsDataStatSumX'. For each bin interval defined by the
object reportCntrlReportsBinInterval, the change in the value of the
counter pointed to by the Object ID reportCntrlReportsPriObjID is
calculated. Then this (delta) value is added to the current value of
the value contained in the object 'reportStatsDataStatSumX'. Then,
if interested in computing the average change in this object (sampled
each bin interval) for the duration of the report, the management
station simply divides reportStatsDataStatSumX by
reportStatsDataStatN. Although this is a trivial example because the
value of reportAggrReportStatSumX is simple the difference in the
counter reportCntrolReportsPriObjID at the start and the end of the
total report interval, the other metrics defined are not as trivial.
The objects 'reportStatsDataOverflowStatSumX' and
'reportStatsDataHCSumX' are borrowed from RMON [RFC2021] and exist to
handle integer overflow situations where, e.g.,
'reportStatsDataStatSumX' overruns its maximum value numerous times.
Computation of the least-square fit of the data collected for a
report can be accomplished. (NOTE: describe this capability here.)
5.3. The Sampled Group 5.2. The Sampled Group
The Sampled Group contains tables which allows for the development of The Sampled Group contains tables which allows for the development of
reports based upon sampling the referenced counter objects at reports based upon sampling the referenced counter objects at
specified intervals. The development of this group within the specified intervals. The development of this group within the
REPORT-MIB follows exactly the User History group from the RMON 2 MIB REPORT-SAMPLED-MIB which augments the User History group from the
[RFC2021]. The Sampled Group is composed of: RMON 2 MIB [RFC2021]. The Sampled Group is composed of:
o reportSampledControlTable - allows for the setting of the o reportSampledControlTable - allows for the setting of the
parameters of the report. parameters of the report.
o reportSampledObjectTable - sets the referenced objects to be o reportSampledObjectTable - sets the referenced objects to be
sampled during the test. With this capability, the management sampled during the test. With this capability, the management
application can reference multiple objects, all of which are application can reference multiple objects, all of which are
sampled during the test and reported out through the sampled during the test and reported out through the
reportSampledData Table. reportSampledData Table.
o reportSampledDataTable - contains the reports. o reportSampledDataTable - contains the reports.
5.4. The History Group 5.3. The Notifications Group
The History Group contains tables which capture information on change
events for the referenced objects. Depending upon the referenced
objects, this could force the generation of large amounts of data.
Care should be exercised when considering the use of this capability.
o reportHistoryControlTable - defines the parameters for the test.
o reportHistoryDataTable - presents the reports associated with the
constructed tests.
5.5. The Notifications Group
The Notifications Sub-tree contains the list of notifications The Notifications Sub-tree contains the list of notifications
supported within the REPORT-MIB and their intended purpose or supported within the REPORT-SAMPLED-MIB and their intended purpose or
utility. (Note: This group is currently empty.) utility. The single notification defined within this MIB module is
the 'reportSampledNewDataReport'. This notification is sent by the
agent upon completion of a given report on the device. The
notification contains the following objects:
'usrHistoryControlOwner', the entity that configured this report
entry, and the 'reportSampledReportIndex', the index of the data
table for this report. Collectively, these objects allow the
management application to pull the completed report from the agent.
6. Relationship to Other MIB Modules 6. Relationship to Other MIB Modules
[TODO]: The text of this section specifies the relationship of the The text of this section specifies the relationship of the MIB
MIB modules contained in this document to other standards, modules contained in this document to other standards, particularly
particularly to standards containing other MIB modules. Definitions to standards containing other MIB modules. Definitions imported from
imported from other MIB modules and other MIB modules that SHOULD be other MIB modules and other MIB modules that SHOULD be implemented in
implemented in conjunction with the MIB module contained within this conjunction with the MIB module contained within this document are
document are identified in this section. identified in this section.
6.1. Relationship to the SNMPv2-MIB 6.1. Relationship to the SNMPv2-MIB
The 'system' group in the SNMPv2-MIB [RFC3418] is defined as being The 'system' group in the SNMPv2-MIB [RFC3418] is defined as being
mandatory for all systems, and the objects apply to the entity as a mandatory for all systems, and the objects apply to the entity as a
whole. The 'system' group provides identification of the management whole. The 'system' group provides identification of the management
entity and certain other system-wide data. The REPORT-MIB does not entity and certain other system-wide data. The REPORT-SAMPLED-MIB
duplicate those objects. does not duplicate those objects.
6.2. Relationship to the RMON2-MIB 6.2. Relationship to the RMON2-MIB
The REPORT-MIB is closely related in many aspects to the RMON2-MIB The REPORT-SAMPLED-MIB is closely related to the RMON2-MIB [RFC2021]
[RFC2021]. Specifically, the reportSampledGroup is a direct copy of usrHistoryGroup. Specifically, the reportSampledGroup is a direct
the RMON2 User History Group, with the names changed to comply with copy of the RMON2 User History Group, with the names changed to
the naming conventions within the REPORT-MIB. Further, the design comply with the naming conventions within the REPORT-SAMPLED-MIB.
and use of the control tables within the REPORT-MIB draw exactly from Further, the design and use of the control tables within the REPORT-
the definition of these table structures in the earlier RMON MIBs. SAMPLED-MIB draw exactly from the definition of these table
structures in the earlier RMON MIBs through the use of the 'AUGMENTS'
6.3. Relationship to the TPM-MIB clause within the 'reportSampledControlTable' and the
'reportSampledTable' in this MIB module.
The REPORT-MIB pulled the reportStatsGroup directory from the TPM-MIB
[RFC4150]. The table structures and the choice of statistics draws
directly from the earlier TPM-MIB developed within the RMON Working
Group.
6.4. MIB modules required for IMPORTS 6.3. MIB modules required for IMPORTS
[TODO]: Citations are not permitted within a MIB module, but any Citations are not permitted within a MIB module, but any module
module mentioned in an IMPORTS clause or document mentioned in a mentioned in an IMPORTS clause or document mentioned in a REFERENCE
REFERENCE clause is a Normative reference, and must be cited clause is a Normative reference, and must be cited someplace within
someplace within the narrative sections. If there are imported items the narrative sections. Therefore, the imported items in this MIB
in the MIB module, such as Textual Conventions, that are not already module, such as Textual Conventions, that are not already cited, are
cited, they can be cited in text here. Since relationships to other cited in this section. Since relationships to other MIB modules
MIB modules should be described in the narrative text, this section should be described in the narrative text, this section will cite
is typically used to cite modules from which Textual Conventions are modules from which Textual Conventions are imported.
imported.
The REPORT-MIB module IMPORTS objects from SNMPv2-SMI [RFC2578], The REPORT-SAMPLED-MIB module IMPORTS objects from SNMPv2-SMI
SNMPv2-TC [RFC2579], SNMPv2-CONF [RFC2580], and IF-MIB [RFC2863] [RFC2578], SNMPv2-TC [RFC2579], SNMPv2-CONF [RFC2580], IF-MIB
[RFC2863], and INET-ADDRESS-MIB [RFC4001]. Significantly, the
REPORT-SAMPLED-MIB module also IMPORTS objects from the RMON2-MIB
module [RFC2021].
7. Definitions 7. Definitions
REPORT-MIB DEFINITIONS ::= BEGIN REPORT-SAMPLED-MIB DEFINITIONS ::= BEGIN
IMPORTS
ZeroBasedCounter32
FROM RMON2-MIB -- [RFC2021]
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Counter32, Gauge32, Unsigned32, Integer32, mib-2
FROM SNMPv2-SMI -- [RFC2578]
TEXTUAL-CONVENTION, RowStatus,
TimeStamp, StorageType
FROM SNMPv2-TC -- [RFC2579]
MODULE-COMPLIANCE, OBJECT-GROUP,
NOTIFICATION-GROUP
FROM SNMPv2-CONF -- [RFC2580]
OwnerString
FROM RMON-MIB -- [RFC2819]
ZeroBasedCounter64
FROM HCNUM-TC -- [RFC2856]
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB -- [RFC3411]
InetAddress, InetAddressType IMPORTS
FROM INET-ADDRESS-MIB -- [RFC4001]
SspmClockSource, SspmClockMaxSkew, MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
SspmMicroSeconds Gauge32, Integer32, experimental
FROM SSPM-MIB -- [RFC4149] FROM SNMPv2-SMI -- [RFC2578]
;
reportMIB MODULE-IDENTITY TimeStamp
LAST-UPDATED "201102171300Z" -- February 17, 2011 FROM SNMPv2-TC -- [RFC2579]
ORGANIZATION "IETF MANET Working Group"
CONTACT-INFO
"WG E-Mail: manet@ietf.org
WG Chairs: ian.chakeres@gmail.com MODULE-COMPLIANCE, OBJECT-GROUP,
jmacker@nrl.navy.mil NOTIFICATION-GROUP
FROM SNMPv2-CONF -- [RFC2580]
Editors: Robert G. Cole usrHistoryControlEntry, usrHistoryObjectEntry,
US Army CERDEC usrHistoryControlIndex, usrHistoryControlOwner,
328 Hopkins Road usrHistoryObjectIndex
Aberdeen Proving Ground, MD 21005 -- usrHistoryControlObjects, usrHistoryControlBucketsRequested,
USA -- usrHistoryControlBucketsGranted, usrHistoryControlInterval,
+1 410 278-6779 -- usrHistoryControlStatus,
robert.g.cole@us.army.mil -- usrHistoryObjectVariable, usrHistoryObjectSampleType
FROM RMON2-MIB -- [RFC2021]
Joseph Macker InetAddress, InetAddressType
Naval Research Laboratory FROM INET-ADDRESS-MIB -- [RFC4001]
Washington, D.C. 20375 ;
USA
macker@itd.nrl.navy.mil
Al Morton reportSampledMIB MODULE-IDENTITY
AT&T Laboratories LAST-UPDATED "201201311300Z" -- January 31, 2012
Middletown, N.J. 07724 ORGANIZATION "IETF MANET Working Group"
USA CONTACT-INFO
amorton@att.com" "WG E-Mail: manet@ietf.org
DESCRIPTION
"This MIB module contains managed object definitions for
the autonmous reporting of performance object counters.
Copyright (C) The IETF Trust (2009). This version WG Chairs: ian.chakeres@gmail.com
of this MIB module is part of RFC xxxx; see the RFC jmacker@nrl.navy.mil
itself for full legal notices."
-- Revision History Editors: Robert G. Cole
REVISION "201102171300Z" -- February 17, 2011 US Army CERDEC
DESCRIPTION 6010 Frankford Road
"The fifth draft of this MIB module published as Aberdeen Proving Ground, MD 21005
draft-ietf-manet-report-mib-01.txt. This document USA
has been promoted to a MANET Working Group +1 443 395-8744
draft. robert.g.cole@us.army.mil
Revisions to this draft include Joseph Macker
a) Proposed changes to the statsReport table to Naval Research Laboratory
simplify communications between device and Washington, D.C. 20375
mgmt application, USA
b) Added Notifications, macker@itd.nrl.navy.mil
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 Andy Bierman
a) added support for proxy configurations through Brocade
the addition of address objects associated with andy.bierman@brocade.com"
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 DESCRIPTION
"Initial draft of this MIB module published as "This MIB module contains managed object definitions for
draft-cole-manet-report-mib-00.txt." the autonmous reporting of performance object counters.
-- RFC-Editor assigns XXXX Copyright (C) The IETF Trust (2009). This version
::= { mib-2 998 } -- to be assigned by IANA of this MIB module is part of RFC xxxx; see the RFC
itself for full legal notices."
ReportMetricDefID ::= TEXTUAL-CONVENTION -- Revision History
DISPLAY-HINT "d" REVISION "201201311300Z" -- January 31, 2012
STATUS current
DESCRIPTION DESCRIPTION
"An index that identifies through reference to a specific "The sixth draft of this MIB module published as
statistical metrics. draft-ietf-manet-report-mib-02.txt.
"
SYNTAX Unsigned32 (1..2147483647)
reportMIBNotifications OBJECT IDENTIFIER ::= { reportMIB 0 }
reportMIBObjects OBJECT IDENTIFIER ::= { reportMIB 1 }
reportMIBConformance OBJECT IDENTIFIER ::= { reportMIB 2 }
reportStatsGroup OBJECT IDENTIFIER ::= { reportMIBObjects 1 }
reportCapabilitiesGroup OBJECT IDENTIFIER ::= { reportStatsGroup 1 }
reportClockResolution OBJECT-TYPE
SYNTAX SspmMicroSeconds
MAX-ACCESS read-only
STATUS current
-- UNITS Microseconds
DESCRIPTION
"A read-only variable indicating the resolution
of the measurements possible by this device."
::= { reportCapabilitiesGroup 1 }
reportClockMaxSkew OBJECT-TYPE
SYNTAX SspmClockMaxSkew
MAX-ACCESS read-only
STATUS current
-- UNITS Seconds
DESCRIPTION
"A read-only variable indicating the maximum
offset error due to skew of the local clock
over the time interval 86400 seconds, in seconds."
::= { reportCapabilitiesGroup 2 }
reportClockSource OBJECT-TYPE
SYNTAX SspmClockSource
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A read-only variable indicating the source of the clock.
This is provided to allow a user to determine how accurate
the timing mechanism is compared with other devices."
::= { reportCapabilitiesGroup 3 }
reportMetricDirLastChange OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time the
reportTransMetricDirTable was last modified, through
modifications of the reportTransMetricDirConfig object."
::= { reportCapabilitiesGroup 4 }
reportMetricExtDefTable OBJECT-TYPE
SYNTAX SEQUENCE OF ReportMetricExtDefEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The reportMetricExtDefTable describes the metrics
available to the REPORT-MIB. The reportMetricExtDefTable
can define metrics by referencing existing IETF,
ITU, and other standards organizations' documents,
including enterprise-specific documents.
Examples of appropriate references include the
ITU-T Recommendation Y.1540 [Y.1540] on IP
packet transfer performance metrics and the
IETF documents from the IPPM WG; e.g., RFC2681
on the round trip delay metric [RFC2681] or
RFC3393 on the delay variation metric [RFC3393].
Other examples include RFC2679 [RFC2679], RFC2680
[RFC2680], and RFC3432 [RFC3432]. Although no
specific metric is mandatory, implementations
should, at a minimum, support a round-trip delay
and a round-trip loss metric.
This table contains one row per metric supported by this
agent, and it should be populated during system
initialization."
::= { reportCapabilitiesGroup 5 }
reportMetricExtDefEntry OBJECT-TYPE
SYNTAX ReportMetricExtDefEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a particular metric."
INDEX { reportMetricExtDefID }
::= { reportMetricExtDefTable 1 }
ReportMetricExtDefEntry ::= SEQUENCE {
reportMetricExtDefID ReportMetricDefID,
reportMetricExtDefType INTEGER,
reportMetricExtDefName SnmpAdminString,
reportMetricExtDefOperation SnmpAdminString,
reportMetricExtDefReference SnmpAdminString
}
reportMetricExtDefID OBJECT-TYPE
SYNTAX ReportMetricDefID
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index for this entry. This object identifies
the particular metric in this MIB module."
::= { reportMetricExtDefEntry 1 }
reportMetricExtDefType OBJECT-TYPE
SYNTAX INTEGER {
other(1),
singleObjMetric(2),
multipleObjMetric(3)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The basic type of metric indicated by this entry.
The value 'other(1)' indicates that this metric cannot be
characterized by any of the remaining enumerations specified
for this object.
The value 'connectMetric(2)' indicates that this metric
measures connectivity characteristics.
The value 'delayMetric(3)' indicates that this metric
measures delay characteristics.
"
::= { reportMetricExtDefEntry 2 }
reportMetricExtDefName OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The textual name of this metric. For example, if
this reportMetricDefEntry identified the IPPM metric for
round trip delay, then this object should contain
the value, e.g., 'Type-P-Round-Trip-Delay'."
::= { reportMetricExtDefEntry 3 }
reportMetricExtDefOperation OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The textual description of the operations necessary
to compute this metric. For example, if
this reportMetricDefEntry identified the IPPM metric for
round trip delay, then this object should contain
the value, e.g., 'Type-P-Round-Trip-Delay'."
::= { reportMetricExtDefEntry 4 }
reportMetricExtDefReference OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object contains a reference to the document that
defines this metric. If this document is available online
via electronic download, then a de-referencable URL
should be specified in this object. The implementation
must support an HTTP URL type and may support additional
types of de-referencable URLs such as an FTP type.
For example, if this reportMetricDefName identified the IPPM
metric 'Type-P-Round-Trip-Delay', then this object should
contain the value, e.g.,
'http://www.ietf.org/rfc/rfc2681.txt'."
::= { reportMetricExtDefEntry 5 }
reportStatsControlGroup OBJECT IDENTIFIER ::= {reportStatsGroup 2}
reportStatsControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF ReportStatsControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The reportStatsControlTable is the controlling entry
that manages the population of studies in the
Report for selected time intervals.
Note that this is not like the typical RMON
controlTable and dataTable in which each entry creates
its own data table. Each entry in this table enables the
creation of multiple data tables on a study basis. For each
interval, the study is updated in place, and the current
data content of the table becomes invalid.
The control table entries are persistent across
system reboots."
::= { reportStatsControlGroup 1 }
reportStatsControlEntry OBJECT-TYPE
SYNTAX ReportStatsControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the reportStatsControlTable.
An example of the indexing of this entry is
reportGenReportCntrInterval.1"
INDEX { reportStatsControlIndex }
::= { reportStatsControlTable 1 }
ReportStatsControlEntry ::= SEQUENCE {
reportStatsControlIndex Unsigned32,
reportStatsControlInterval Unsigned32,
reportStatsControlBinInterval Unsigned32,
reportStatsControlPriObjID OBJECT IDENTIFIER,
reportStatsControlPriObjIpAddrType InetAddressType,
reportStatsControlPriObjIPAddr InetAddress,
reportStatsControlSecObj1ID OBJECT IDENTIFIER,
reportStatsControlSecObj1IpAddrType InetAddressType,
reportStatsControlSecObj1IPAddr InetAddress,
reportStatsControlSecObj2ID OBJECT IDENTIFIER,
reportStatsControlSecObj2IpAddrType InetAddressType,
reportStatsControlSecObj2IPAddr InetAddress,
reportStatsControlSecObj3ID OBJECT IDENTIFIER,
reportStatsControlSecObj3IpAddrType InetAddressType,
reportStatsControlSecObj3IPAddr InetAddress,
reportStatsControlSecObj4ID OBJECT IDENTIFIER,
reportStatsControlSecObj4IpAddrType InetAddressType,
reportStatsControlSecObj4IPAddr InetAddress,
reportStatsControlSecObj5ID OBJECT IDENTIFIER,
reportStatsControlSecObj5IpAddrType InetAddressType,
reportStatsControlSecObj5IPAddr InetAddress,
reportStatsControlMetricExt1 ReportMetricDefID,
reportStatsControlMetricExt2 ReportMetricDefID,
reportStatsControlMetricExt3 ReportMetricDefID,
reportStatsControlMetricExt4 ReportMetricDefID,
reportStatsControlMetricExt5 ReportMetricDefID,
reportStatsControlReqReports Unsigned32,
reportStatsControlGrantedReports Unsigned32,
reportStatsControlStartTime TimeStamp,
reportStatsControlReportNumber Unsigned32,
reportStatsControlInsertsDenied Counter32,
reportStatsControlOwner OwnerString,
reportStatsControlStorageType StorageType,
reportStatsControlStatus RowStatus
}
reportStatsControlIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
reportStatsControlTable. Each such entry defines a unique
report whose results are placed in the reportGenReportTable
on behalf of this reportStatsControlEntry."
::= { reportStatsControlEntry 1 }
reportStatsControlInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "Seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The interval in seconds over which data is accumulated before
being aggregated into a report in the reportGenReportTable.
All reports with the same reportStatsControlIndex will be
based on the same interval.
The value of the reportStatsControlInterval should be
an integral multiple of the value of the
reportStatsControlBinInterval.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
DEFVAL { 3600 }
::= { reportStatsControlEntry 2 }
reportStatsControlBinInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "Seconds"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The interval in seconds between which the value of the
reportStatsControlPriObjID and SecObjIDs are polled
for the purpose of generating the metric values associated
with this report. All reports with the same
reportStatsControlIndex will be based on the
same bin interval.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
DEFVAL { 3600 }
::= { reportStatsControlEntry 3 }
reportStatsControlPriObjID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the primary counter object to be
monitored within this report.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 4 }
reportStatsControlPriObjIpAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the IP address type
of the IP address associated with the
primary counter object to be
monitored within this report.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 5 }
reportStatsControlPriObjIPAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the IP addree of the
primary counter object to be
monitored within this report.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 6 }
reportStatsControlSecObj1ID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the secondary counter object to be
monitored within this report associated with the
specified reportStatsControlMetricExt1. If the
reportStatsControlMetricExt1 is a simple metric, then
the value of this reportStatsControlSecObj1ID is
set to '0'.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 7 }
reportStatsControlSecObj1IpAddrType 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)."
::= { reportStatsControlEntry 8 }
reportStatsControlSecObj1IPAddr 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)."
::= { reportStatsControlEntry 9 }
reportStatsControlSecObj2ID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the secondary counter object to be
monitored within this report associated with the
specified reportStatsControlMetricExt2. If the
reportStatsControlMetricExt2 is a simple metric, then
the value of this reportStatsControlSecObj2ID is
set to '0'.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 10 }
reportStatsControlSecObj2IpAddrType 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)."
::= { reportStatsControlEntry 11 }
reportStatsControlSecObj2IPAddr 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)."
::= { reportStatsControlEntry 12 }
reportStatsControlSecObj3ID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the secondary counter object to be
monitored within this report associated with the
specified reportStatsControlMetricExt3. If the
reportStatsControlMetricExt3 is a simple metric, then
the value of this reportStatsControlSecObj3ID is
set to '0'.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 13 }
reportStatsControlSecObj3IpAddrType 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)."
::= { reportStatsControlEntry 14 }
reportStatsControlSecObj3IPAddr 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)."
::= { reportStatsControlEntry 15 }
reportStatsControlSecObj4ID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the secondary counter object to be
monitored within this report associated with the
specified reportStatsControlMetricExt4. If the
reportStatsControlMetricExt4 is a simple metric, then
the value of this reportStatsControlSecObj4ID is
set to '0'.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 16 }
reportStatsControlSecObj4IpAddrType 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)."
::= { reportStatsControlEntry 17 }
reportStatsControlSecObj4IPAddr 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)."
::= { reportStatsControlEntry 18 }
reportStatsControlSecObj5ID OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the secondary counter object to be
monitored within this report associated with the
specified reportStatsControlMetricExt5. If the
reportStatsControlMetricExt5 is a simple metric, then
the value of this reportStatsControlSecObj5ID is
set to '0'.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 19 }
reportStatsControlSecObj5IpAddrType 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)."
::= { reportStatsControlEntry 20 }
reportStatsControlSecObj5IPAddr 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)."
::= { reportStatsControlEntry 21 }
reportStatsControlMetricExt1 OBJECT-TYPE
SYNTAX ReportMetricDefID
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the first metric extension placed
in the reportGenReportTable. If no metric extension
is requested, then this object value is set to '0'.
If this metric is defined on a single counter object,
then only the reportStatsControlPriObjID is set, while
the value of the reportStatsControlSecObjID is
set to '0'. Else, the reportStatsControlSecObjID
is set in accoradance with the instruction in the
definition of the metric extension found in the
reportCapabilitiesMetwircExtTable above.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 22 }
reportStatsControlMetricExt2 OBJECT-TYPE
SYNTAX ReportMetricDefID
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the second metric extension placed
in the reportGenReportTable. If no metric extension
is requested, then this object value is set to '0'.
If this metric is defined on a single counter object,
then only the reportStatsControlPriObjID is set, while
the value of the reportStatsControlSecObjID is
set to '0'. Else, the reportStatsControlSecObjID
is set in accoradance with the instruction in the
definition of the metric extension found in the
reportCapabilitiesMetwircExtTable above.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 23 }
reportStatsControlMetricExt3 OBJECT-TYPE
SYNTAX ReportMetricDefID
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the third metric extension placed
in the reportGenReportTable. If no metric extension
is requested, then this object value is set to '0'.
If this metric is defined on a single counter object,
then only the reportStatsControlPriObjID is set, while
the value of the reportStatsControlSecObjID is
set to '0'. Else, the reportStatsControlSecObjID
is set in accoradance with the instruction in the
definition of the metric extension found in the
reportCapabilitiesMetwircExtTable above.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 24 }
reportStatsControlMetricExt4 OBJECT-TYPE
SYNTAX ReportMetricDefID
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the fourth metric extension placed
in the reportGenReportTable. If no metric extension
is requested, then this object value is set to '0'.
If this metric is defined on a single counter object,
then only the reportStatsControlPriObjID is set, while
the value of the reportStatsControlSecObjID is
set to '0'. Else, the reportStatsControlSecObjID
is set in accoradance with the instruction in the
definition of the metric extension found in the
reportCapabilitiesMetwircExtTable above.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 25 }
reportStatsControlMetricExt5 OBJECT-TYPE
SYNTAX ReportMetricDefID
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This identifies the fifth metric extension placed
in the reportGenReportTable. If no metric extension
is requested, then this object value is set to '0'.
If this metric is defined on a single counter object,
then only the reportStatsControlPriObjID is set, while
the value of the reportStatsControlSecObjID is
set to '0'. Else, the reportStatsControlSecObjID
is set in accoradance with the instruction in the
definition of the metric extension found in the
reportCapabilitiesMetwircExtTable above.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 26 }
reportStatsControlReqReports OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of saved reports requested to be allocated on
behalf of this entry.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 27 }
reportStatsControlGrantedReports OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of saved reports the agent has allocated based
on the requested amount in reportStatsControlReqReports.
Because each report can have many entries, the total number
of entries allocated will be this number multiplied by the
value of reportStatsControlGrantedSize, or by 1 if that
object doesn't exist.
When the associated reportStatsControlReqReports object is
created or modified, the agent should set this object as
closely to the requested value as is possible for the
particular implementation and available resources. When
considering available resources, the agent must consider its
ability to allocate this many reports, each with the number
of entries represented by reportStatsControlGrantedSize, or
by 1 if that object doesn't exist.
Note that although the storage required for each report may
fluctuate due to changing conditions, the agent must continue
to have storage available to satisfy the full report size for
all reports, when necessary. Further, the agent must not
lower this value except as a result of a set to the
associated reportStatsControlReqSize object."
::= { reportStatsControlEntry 28 }
reportStatsControlStartTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when the system began processing the
report in progress. Note that the report in progress is not
available.
This object may be used by the management station to figure
out the start time for all previous reports saved for this
reportStatsControlEntry, as reports are started at fixed
intervals."
::= { reportStatsControlEntry 29 }
reportStatsControlReportNumber OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of the report in progress. When an
reportStatsControlEntry is activated, the first report will
be numbered zero."
::= { reportStatsControlEntry 30 }
reportStatsControlInsertsDenied OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of attempts to add an entry to reports for
this ReportStatsControlEntry that failed because the
number of entries would have exceeded
reportStatsControlGrantedSize.
This number is valuable in determining if enough
entries have been allocated for reports
in light of fluctuating network
usage. Note that an entry that is denied will
often be attempted again, so this number will
not predict the exact number of additional entries
needed, but it can be used to
understand the relative magnitude of the problem.
Also note that there is no ordering specified for
the entries in the report;
thus, there are no rules for which entries
will be omitted when not enough entries are available.
As a consequence, the agent is not required
to delete 'least valuable' entries first."
::= { reportStatsControlEntry 31 }
reportStatsControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is
therefore using the resources assigned to it.
This object may not be modified if the associated
reportStatsControlStatus object is equal to active(1)."
::= { reportStatsControlEntry 32 }
reportStatsControlStorageType OBJECT-TYPE
SYNTAX StorageType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The storage type of this reportStatsControlEntry. If the
value of this object is 'permanent', no objects in this row
need to be writable."
::= { reportStatsControlEntry 33 }
reportStatsControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this performance control entry.
An entry may not exist in the active state unless each
object in the entry has an appropriate value.
Once this object is set to active(1), no objects in the
reportStatsControlTable can be changed.
If this object is not equal to active(1), all associated
entries in the reportGenReportTable shall be deleted."
::= { reportStatsControlEntry 34 }
reportStatsDataGroup OBJECT IDENTIFIER ::= { reportStatsGroup 3 }
reportStatsDataTable OBJECT-TYPE
SYNTAX SEQUENCE OF ReportStatsDataEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains completed
studies for each of the control table entries in
reportAggrReportCntrlTable. These studies are
provided based on the selections and parameters
found for the entry in the
reportAggregateReportsCntrlTable.
The performance statistics are specified in the
reportTransMetricDirTable associated with the
application in question and indexed by
appLocalIndex and reportTransMetricIndex."
::= { reportStatsDataGroup 1 }
reportStatsDataEntry OBJECT-TYPE
SYNTAX ReportStatsDataEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row in the reportStatsDataTable.
The reportStatsControlIndex value in the
index identifies the reportStatsControlEntry
on whose behalf this entry was created.
The reportStatsDataIndex value in the index
identifies which report
(in the series of reports) this entry is a part of.
The reportStatsDataServerAddress value in the
index identifies the network layer address of the
device generatung this report.
An example of the indexing of this entry is
reportStatsDataStatN.3.15.34.262.18.4.128.2.6.7.3256521"
INDEX { reportStatsControlIndex,
reportStatsDataIndex
}
::= { reportStatsDataTable 1 }
ReportStatsDataEntry ::= SEQUENCE {
reportStatsDataIndex Unsigned32,
-- reportStatsDataServerAddrType inetAddressType,
-- reportStatsDataServerAddress inetAddress,
reportStatsDataServerAddress OCTET STRING,
-- reportStatsDataReportStartTime TimeStamp,
-- reportStatsDataReportInterval Unsigned32,
reportStatsDataStatN ZeroBasedCounter32,
reportStatsDataStatSumX ZeroBasedCounter32,
reportStatsDataOverflowStatSumX ZeroBasedCounter32,
reportStatsDataHCStatSumX ZeroBasedCounter64,
reportStatsDataStatMaximum ZeroBasedCounter32,
reportStatsDataStatMinimum ZeroBasedCounter32,
reportStatsDataStatSumSq ZeroBasedCounter32,
reportStatsDataOverflowStatSumSq ZeroBasedCounter32,
reportStatsDataHCStatSumSq ZeroBasedCounter64,
reportStatsDataStatSumIX ZeroBasedCounter32,
reportStatsDataOverflowStatSumIX ZeroBasedCounter32,
reportStatsDataHCStatSumIX ZeroBasedCounter64,
reportStatsDataStatSumIXSq ZeroBasedCounter32,
reportStatsDataOverflowStatSumIXSq ZeroBasedCounter32,
reportStatsDataHCStatSumIXSq ZeroBasedCounter64,
reportStatsDataStatMetricExt1 ZeroBasedCounter32,
reportStatsDataStatMetricExt2 ZeroBasedCounter32,
reportStatsDataStatMetricExt3 ZeroBasedCounter32,
reportStatsDataStatMetricExt4 ZeroBasedCounter32,
reportStatsDataStatMetricExt5 ZeroBasedCounter32
}
reportStatsDataIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..2147483647)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of reportStatsControlReportNumber for the report to
which this entry belongs."
::= { reportStatsDataEntry 1 }
reportStatsDataServerAddress OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..108))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The network layer address of the server host in this
conversation.
This is represented as an octet string with specific
semantics and length as identified by the
protocolDirLocalIndex component of the index.
Because this object is an index variable, it is encoded in
the index according to the index encoding rules. For
example, if the protocolDirLocalIndex indicates an
encapsulation of IPv4, this object is encoded as a length
octet of 4, followed by the 4 octets of the IPv4 address,
in network byte order.
If the associated reportAggrReportCntrlAggrType is equal to
application(4) or client(2), then this object will be a null
string and will be encoded simply as a length octet of 0."
::= { reportStatsDataEntry 2 }
reportStatsDataStatN OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The count of the total number of data points for the
specified metric. This number is simply the value of
reportCntrlReportsInterval divided by the value of
reportCntrlReportsBinInterval, which should be integer
valued.
"
::= { reportStatsDataEntry 3 }
reportStatsDataStatSumX OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The sum of all the data point values for the specified
metric. This number always represents the total values
of the statistical datum analyzed. Each metric
specifies the exact meaning of this object.
This value represents the results of one metric and is
related directly to the specific parameters of the metric
and the Server and Client addresses involved."
::= { reportStatsDataEntry 4 }
reportStatsDataOverflowStatSumX OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated
reportAggrReportStatSumX counter has overflowed.
Note that this object will only be instantiated if the
associated reportAggrReportHCStatSumX object is also
instantiated for a particular dataSource."
::= { reportStatsDataEntry 5 }
reportStatsDataHCStatSumX OBJECT-TYPE
SYNTAX ZeroBasedCounter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The high-capacity version of reportAggrReportStatSumX.
Note that this object will only be instantiated if the
agent supports High Capacity monitoring for a particular
dataSource."
::= { reportStatsDataEntry 6 }
reportStatsDataStatMaximum OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The single maximum data point value observed during the
study period for the specified metric. This number always
represents the maximum value of any single statistical
datum analyzed. Each metric specifies the exact meaning
of this object.
This value represents the results of one metric and is
related directly to the specific parameters of the metric
and the Server and Client addresses involved."
::= { reportStatsDataEntry 7 }
reportStatsDataStatMinimum OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The single minimum data point value observed during the
study period for the specified metric. This number always
represents the minimum value of any single statistical
datum analyzed. Each metric specifies the exact meaning
of this object.
This value represents the results of one metric and is
related directly to the specific parameters of the metric
and the Server and Client addresses involved."
::= { reportStatsDataEntry 8 }
reportStatsDataStatSumSq OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The sum of all the squared data point values for the
specified metric. This number always represents the
total of the squared values of the statistical datum
analyzed. Each metric specifies the exact meaning of
this object.
This value represents the results of one metric and is
related directly to the specific parameters of the metric
and the Server and Client addresses involved."
::= { reportStatsDataEntry 9 }
reportStatsDataOverflowStatSumSq OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated
reportAggrReportStatSumSq counter has overflowed.
Note that this object will only be instantiated if
the associated reportAggrReportHCStatSumSq object
is also instantiated for a particular dataSource."
::= { reportStatsDataEntry 10 }
reportStatsDataHCStatSumSq OBJECT-TYPE
SYNTAX ZeroBasedCounter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The high-capacity version of reportAggrReportStatSumSq.
Note that this object will only be instantiated if the
agent supports High Capacity monitoring for a particular
dataSource."
::= { reportStatsDataEntry 11 }
reportStatsDataStatSumIX OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"For each interval, each data point is associated with a
value I, I = 1..N where N is the number of data points;
reportAggrReportStatSumIX is the multiplication of the
data point value with the current I. This value
along with the other statistics values allow the
calculation of the slope of the least-squares line
through the data points."
::= { reportStatsDataEntry 12 }
reportStatsDataOverflowStatSumIX OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated
reportAggrReportStatSumIX counter has overflowed.
Note that this object will only be instantiated if the
associated reportAggrReportHCStatSumIX object is also
instantiated for a particular dataSource."
::= { reportStatsDataEntry 13 }
reportStatsDataHCStatSumIX OBJECT-TYPE
SYNTAX ZeroBasedCounter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The high-capacity version of reportAggrReportStatSumIX.
Note that this object will only be instantiated if the
agent supports High Capacity monitoring for a particular
dataSource."
::= { reportStatsDataEntry 14 }
reportStatsDataStatSumIXSq OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"For each interval, each data point is associated with a
value I, I = 1..N where N is the number of data points;
reportAggrReportStatSumIXSq is the multiplication
of the data point value squared with the current I.
This value along with the other statistics
values allow the calculation of the slope of
the least-squares line through the data points."
::= { reportStatsDataEntry 15 }
reportStatsDataOverflowStatSumIXSq OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times the associated
reportAggrReportStatSumIXSq counter has overflowed.
Note that this object will only be instantiated if the
associated reportAggrReportHCStatSumIXSq object is also
instantiated for a particular dataSource."
::= { reportStatsDataEntry 16 }
reportStatsDataHCStatSumIXSq OBJECT-TYPE
SYNTAX ZeroBasedCounter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The high-capacity version of reportAggrReportStatSumIXSq.
Note that this object will only be instantiated if the
agent supports High Capacity monitoring for a particular
dataSource."
::= { reportStatsDataEntry 17 }
reportStatsDataStatMetricExt1 OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The .... for the MetricExt1.
"
::= { reportStatsDataEntry 18 }
reportStatsDataStatMetricExt2 OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The .... for the MetricExt2.
"
::= { reportStatsDataEntry 19 }
reportStatsDataStatMetricExt3 OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The .... for the MetricExt3.
"
::= { reportStatsDataEntry 20 }
reportStatsDataStatMetricExt4 OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The .... for the MetricExt4.
"
::= { reportStatsDataEntry 21 }
reportStatsDataStatMetricExt5 OBJECT-TYPE
SYNTAX ZeroBasedCounter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The .... for the MetricExt5.
"
::= { reportStatsDataEntry 22 }
reportSampledGroup OBJECT IDENTIFIER ::= { reportMIBObjects 2 }
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"
INDEX { reportSampledControlIndex }
::= { reportSampledControlTable 1 }
SampledControlEntry ::= SEQUENCE {
reportSampledControlIndex Integer32,
reportSampledControlObjects Integer32,
reportSampledControlBucketsRequested Integer32,
reportSampledControlBucketsGranted Integer32,
reportSampledControlInterval Integer32,
reportSampledControlRequestedNumber Integer32,
reportSampledControlReportNumber Integer32,
reportSampledControlOwner OwnerString,
reportSampledControlStatus RowStatus
}
reportSampledControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
reportSampledControlTable. Each such entry defines a
set of samples at a particular interval for a specified
set of MIB instances available from the managed system."
::= { reportSampledControlEntry 1 }
reportSampledControlObjects OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The number of MIB objects to be collected
in the portion of reportSampledTable associated with this
reportSampledControlEntry.
This object may not be modified if the associated instance
of reportSampledControlStatus is equal to active(1)."
::= { reportSampledControlEntry 2 }
reportSampledControlBucketsRequested OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The requested number of discrete time intervals
over which data is to be saved in the part of the
reportSampledTable associated with this
reportSampledControlEntry.
When this object is created or modified, the probe
should set reportSampledControlBucketsGranted as closely to
this object as is possible for the particular probe
implementation and available resources."
DEFVAL { 50 }
::= { reportSampledControlEntry 3 }
reportSampledControlBucketsGranted OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of discrete sampling intervals
over which data shall be saved in the part of
the reportSampledTable associated with this
reportSampledControlEntry.
When the associated reportSampledControlBucketsRequested
object is created or modified, the probe should set
this object as closely to the requested value as is
possible for the particular probe implementation and
available resources. The probe must not lower this
value except as a result of a modification to the associated
reportSampledControlBucketsRequested object.
The associated reportSampledControlBucketsRequested object
should be set before or at the same time as this object
to allow the probe to accurately estimate the resources
required for this reportSampledControlEntry.
There will be times when the actual number of buckets
associated with this entry is less than the value of
this object. In this case, at the end of each sampling
interval, a new bucket will be added to the
reportSampledTable.
When the number of buckets reaches the value of this object,
this report is complete and a new report is begun."
::= { reportSampledControlEntry 4 }
reportSampledControlInterval OBJECT-TYPE
SYNTAX Integer32 (1..2147483647)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The interval in seconds over which the data is
sampled for each bucket in the part of the reportSampled
table associated with this reportSampledControlEntry.
Because the counters in a bucket may overflow at their
maximum value with no indication, a prudent manager will
take into account the possibility of overflow in any of
the associated counters. It is important to consider the
minimum time in which any counter could overflow on a
particular media type and set the
reportSampledControlInterval object to a value less
than this interval.
This object may not be modified if the associated
reportSampledControlStatus object is equal to active(1)."
DEFVAL { 1800 }
::= { reportSampledControlEntry 5 }
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 6 }
reportSampledControlReportNumber OBJECT-TYPE
SYNTAX Integer32 (1..127)
MAX-ACCESS read-create
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 7 }
reportSampledControlOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is
therefore using the resources assigned to it."
::= { reportSampledControlEntry 8 }
reportSampledControlStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this variable history control entry.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value.
If this object is not equal to active(1), all associated
entries in the reportSampledTable shall be deleted."
::= { reportSampledControlEntry 9 }
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 reportSampledControlIndex value in the index is
that of the associated reportSampledControlEntry.
For example, an instance of reportSampledObjectVariable
might be reportSampledObjectVariable.1.3"
INDEX { reportSampledControlIndex, reportSampledObjectIndex }
::= { reportSampledObjectTable 1 }
SampledObjectEntry ::= SEQUENCE {
reportSampledObjectIndex Integer32,
reportSampledObjectVariable OBJECT IDENTIFIER,
reportSampledObjectIpAddrType InetAddressType,
reportSampledObjectIPAddress InetAddress,
reportSampledObjectSampleType INTEGER
}
reportSampledObjectIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index used to uniquely identify an entry in the
reportSampledObject table. Each such entry defines a
MIB instance to be collected periodically."
::= { reportSampledObjectEntry 1 }
reportSampledObjectVariable OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The object identifier of the particular variable to be
sampled.
Only variables that resolve to an ASN.1 primitive type of
Integer32 (Integer32, Counter, Gauge, or TimeTicks) may be
sampled.
Because SNMP access control is articulated entirely in terms
of the contents of MIB views, no access control mechanism
exists that can restrict the value of this object to identify
only those objects that exist in a particular MIB view.
Because there is thus no acceptable means of restricting the
read access that could be obtained through the user history
mechanism, the probe must only grant write access to this
object in those views that have read access to all objects on
the probe.
During a set operation, if the supplied variable name is not
available in the selected MIB view, a badValue error must be
returned.
This object may not be modified if the associated
reportSampledControlStatus object is equal to active(1)."
::= { reportSampledObjectEntry 2 }
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 3 }
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 4 }
reportSampledObjectSampleType OBJECT-TYPE
SYNTAX INTEGER {
absoluteValue(1),
deltaValue(2)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The method of sampling the selected variable for storage in
the reportSampledTable.
If the value of this object is absoluteValue(1), the value of
the selected variable will be copied directly into the history
bucket.
If the value of this object is deltaValue(2), the value of the
selected variable at the last sample will be subtracted from
the current value, and the difference will be stored in the
history bucket. If the associated reportSampledObjectVariable
instance could not be obtained at the previous sample
interval, then a delta sample is not possible, and the value
of the associated reportSampledValStatus object for this
interval will be valueNotAvailable(1).
This object may not be modified if the associated
reportSampledControlStatus object is equal to active(1)."
::= { reportSampledObjectEntry 5 }
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 reportSampledControlIndex value in the index identifies
the reportSampledControlEntry on whose behalf this entry
was created.
The reportSampledObjectIndex 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 { reportSampledControlIndex, reportSampledReportIndex,
reportSampledSampleIndex, reportSampledObjectIndex }
::= { 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 }
reportHistoryGroup OBJECT IDENTIFIER ::= { reportMIBObjects 3 }
reportHistoryControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF HistoryControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of data-collection configuration entries."
::= { reportHistoryGroup 1 }
reportHistoryControlEntry OBJECT-TYPE
SYNTAX HistoryControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of parameters that set up the collection
of a history of changes
in the user-defined MIB objects.
For example, an instance of reportHistoryControlObject
might be named reportHistoryControlObject.1"
INDEX { reportHistoryControlIndex }
::= { reportHistoryControlTable 1 }
HistoryControlEntry ::= SEQUENCE {
reportHistoryControlIndex Integer32,
reportHistoryControlObject OBJECT IDENTIFIER,
reportHistoryControlObjectIpAddrType InetAddressType,
reportHistoryControlObjectIPAddress InetAddress,
reportHistoryControlSizeRequested Integer32,
reportHistoryControlSizeGranted Integer32,
reportHistoryControlRequestedNumber Integer32,
reportHistoryControlReportNumber Integer32,
reportHistoryControlOwner OwnerString,
reportHistoryControlStatus RowStatus
}
reportHistoryControlIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An index that uniquely identifies an entry in the
reportHistoryControlTable. Each such entry defines a
set of histories at a particular interval for a specified
MIB object instance available from the managed system."
::= { reportHistoryControlEntry 1 }
reportHistoryControlObject OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The MIB object to be monitored for the collection
histories in the reportHistoryDataTable associated with this
reportHistoryControlEntry.
This object may not be modified if the associated instance
of reportHistoryControlStatus is equal to active(1)."
::= { reportHistoryControlEntry 2 }
reportHistoryControlObjectIpAddrType 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)."
::= { reportHistoryControlEntry 3 }
reportHistoryControlObjectIPAddress 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)."
::= { reportHistoryControlEntry 4 }
reportHistoryControlSizeRequested OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The requested maximum number of history entries
to be saved in the
reportHistoryDataTable associated with this
reportHistoryControlEntry.
When this object is created or modified, the device
should set reportHistoryControlSizeGranted as closely to
this object as is possible for the particular device
implementation and available resources."
DEFVAL { 50 }
::= { reportHistoryControlEntry 5 }
reportHistoryControlSizeGranted OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum allowed number of discrete history entries
in the reportHistoryTable associated with this
reportHistoryControlEntry.
When the associated reportHistoryControlSizeRequested
object is created or modified, the device should set
this object as closely to the requested value as is
possible for the particular device implementation and
available resources. The device must not lower this
value except as a result of a modification to the associated
reportHistoryControlSizeRequested object.
The associated reportHistoryControlSizeRequested object
should be set before or at the same time as this object
to allow the device to accurately estimate the resources
required for this reportHistoryControlEntry.
When the number of histories reaches the value of this object
and a new history is to be added to the reportHistoryTable,
the oldest history associated with this
reportHistoryControlEntry shall be deleted by the agent
so that the new history can be added."
::= { reportHistoryControlEntry 6 }
reportHistoryControlRequestedNumber 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 Revisions to this draft include
reportHistoryControlStatus object is equal to active(1)." a) Pulled the statistical and historical reporting
DEFVAL { 1 } from the MIB module and left only the sampled
::= { reportHistoryControlEntry 7 } 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.
reportHistoryControlReportNumber OBJECT-TYPE Revisions to this draft include
SYNTAX Integer32 (1..127) a) Proposed changes to the statsReport table to
MAX-ACCESS read-create simplify communications between device and
STATUS current mgmt application,
DESCRIPTION b) Added Notifications,
"The number of the current report in progress. The first c) Changed the reporting structure of the
report is assigned a number equal to '1'. Each successive Sampled and the History reporting
report number is incremented by unity. When the last report to align with the structure of the
is completed, this value is set to Statistics reports for the purpose of
reportSampledControlRequestedNumber + 1." 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.
::= { reportHistoryControlEntry 8 } 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
reportHistoryControlOwner OBJECT-TYPE -- TEXTUAL CONVENTIONs
SYNTAX OwnerString -- None
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this entry and is
therefore using the resources assigned to it."
::= { reportHistoryControlEntry 9 }
reportHistoryControlStatus OBJECT-TYPE --
SYNTAX RowStatus -- Top-Level Object Identifier Assignments
MAX-ACCESS read-create --
STATUS current
DESCRIPTION
"The status of this variable history control entry.
An entry may not exist in the active state unless all reportSampledMIBNotifications OBJECT IDENTIFIER
objects in the entry have an appropriate value. ::= { reportSampledMIB 0 }
reportSampledMIBObjects OBJECT IDENTIFIER
::= { reportSampledMIB 1 }
reportSampledMIBConformance OBJECT IDENTIFIER
::= { reportSampledMIB 2 }
If this object is not equal to active(1), all associated reportSampledGroup OBJECT IDENTIFIER
entries in the reportHistoryTable shall be deleted." ::= { reportSampledMIBObjects 1 }
::= { reportHistoryControlEntry 10 }
-- Then, the reportSampledGroup assignments are :
reportHistoryTable OBJECT-TYPE -- reportSampledControlTable - 1
SYNTAX SEQUENCE OF HistoryEntry -- reportSampledObjectTable - 2
MAX-ACCESS not-accessible -- reportSampledDataTable - 3
STATUS current
DESCRIPTION
"A list of user defined history entries."
::= { reportHistoryGroup 3 }
reportHistoryEntry OBJECT-TYPE reportSampledControlTable OBJECT-TYPE
SYNTAX HistoryEntry SYNTAX SEQUENCE OF SampledControlEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A historical trail of user-defined variables. This list "A list of data-collection configuration entries."
is associated with the reportHistoryControlEntry which set ::= { reportSampledGroup 1 }
up the parameters for a regular collection of these samples.
The reportHistoryControlIndex value in the index identifies reportSampledControlEntry OBJECT-TYPE
the reportHistoryControlEntry on whose behalf this entry SYNTAX SampledControlEntry
was created. This also identifies the MIB object MAX-ACCESS not-accessible
being tracked by this reportHistoryEntry. 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 reportHistory... For example, an instance of reportSampledControlInterval
" might be named reportSampledControlInterval.1"
INDEX { reportHistoryControlIndex, AUGMENTS { usrHistoryControlEntry }
reportHistoryDataIndex } ::= { reportSampledControlTable 1 }
::= { reportHistoryTable 1 }
HistoryEntry ::= SEQUENCE { SampledControlEntry ::= SEQUENCE {
reportHistoryDataIndex Integer32, reportSampledControlRequestedNumber Integer32,
reportHistoryDataChangeTime TimeStamp, reportSampledControlReportNumber Integer32
reportHistoryDataValueType INTEGER, }
reportHistoryDataValue OCTET STRING,
reportHistoryDataValStatus INTEGER
}
reportHistoryDataIndex OBJECT-TYPE reportSampledControlRequestedNumber OBJECT-TYPE
SYNTAX Integer32 (1..2147483647) SYNTAX Integer32 (1..127)
MAX-ACCESS read-only MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An index that uniquely identifies the particular sample this "The number of reports to be generated and stored by this
entry represents among all historical entries agent for this report request.
associated with the same
reportHistoryControlEntry. This index starts at 1 and
increases by one as each new sample is taken."
::= { reportHistoryEntry 1 }
reportHistoryDataChangeTime OBJECT-TYPE This object may not be modified if the associated
SYNTAX TimeStamp reportSampledControlStatus object is equal to active(1)."
MAX-ACCESS read-only DEFVAL { 1 }
STATUS current ::= { reportSampledControlEntry 1 }
DESCRIPTION
"The value of sysUpTime at the time that the MIB object was
updated."
::= { reportHistoryEntry 2 }
reportHistoryDataValueType OBJECT-TYPE reportSampledControlReportNumber OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32 (1..127)
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The type of the data value stored in the "The number of the current report in progress. The first
reportHistoryDataValue string. The user identifies report is assigned a number equal to '1'. Each successive
the MIB object to be tracked by this table. report number is incremented by unity. When the last report
Various types of objects can be track, so the is completed, this value is set to
application needs to know the data type being reportSampledControlRequestedNumber + 1."
stored. Types supported include counter, gauge, ::= { reportSampledControlEntry 2 }
integer, float.
"
::= { reportHistoryEntry 3 }
reportHistoryDataValue OBJECT-TYPE -- Object table
SYNTAX OCTET STRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The absolute value of the
user-specified MIB object tracked by this
table entry. This holds the new object
value following this change in value.
If the MIB instance could not be accessed .... reportSampledObjectTable OBJECT-TYPE
" SYNTAX SEQUENCE OF SampledObjectEntry
::= { reportHistoryEntry 4 } MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A list of data-collection configuration entries."
::= { reportSampledGroup 2 }
reportHistoryDataValStatus OBJECT-TYPE reportSampledObjectEntry OBJECT-TYPE
SYNTAX INTEGER { SYNTAX SampledObjectEntry
valueAvailable(1), MAX-ACCESS not-accessible
valueDelayed(2) STATUS current
} DESCRIPTION
MAX-ACCESS read-only "A list of MIB instances to be sampled periodically.
STATUS current
DESCRIPTION
"This object indicates the validity of the data in
the associated instance of reportHistoryAbsValue.
If the MIB instance could not be accessed promptely, Entries in this table are created when an associated
then 'valueDelayed(2)' will be returned. reportSampledControlObjects object is created.
If the sample is valid and actual value of the sample The usrHistoryControlIndex value in the index is
was promptly recorded, then 'valueAvailable(1)' is that of the associated reportSampledControlEntry.
returned.
"
::= { reportHistoryEntry 5 }
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.
reportNotificationControl OBJECT IDENTIFIER This object may not be modified if the associated
::= {reportMIBNotifications 1} reportStatsControlStatus object is equal to active(1)."
reportNotificationObjects OBJECT IDENTIFIER ::= { reportSampledObjectEntry 1 }
::= {reportMIBNotifications 2}
reportNotificationStates OBJECT IDENTIFIER
::= {reportMIBNotifications 3}
-- reportNotificationControl 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.
reportSetNotification OBJECT-TYPE This object may not be modified if the associated
SYNTAX OCTET STRING (SIZE(4)) reportStatsControlStatus object is equal to active(1)."
MAX-ACCESS read-write ::= { reportSampledObjectEntry 2 }
STATUS current
DESCRIPTION
"A 4-octet string serving as a bit map for
the notification events defined by the REPORT
notifications. This object is used to enable
and disable specific REPORT notifications where
a 1 in the bit field represents enabled. The
right-most bit (least significant) represents
notification 0.
This object is persistent and when written -- data table
the entity SHOULD save the change to reportSampledTable OBJECT-TYPE
non-volatile storage. SYNTAX SEQUENCE OF SampledEntry
" MAX-ACCESS not-accessible
::= { reportNotificationControl 1 } STATUS current
DESCRIPTION
"A list of user defined history entries."
::= { reportSampledGroup 3 }
-- reportNotificationObjects 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.
reportNewStatsDataReport NOTIFICATION-TYPE The usrHistoryControlIndex value in the index identifies
OBJECTS { reportStatsControlIndex, -- The index of the the reportSampledControlEntry on whose behalf this entry
-- control table for this report was created.
reportStatsDataIndex -- The index of the
-- data table for this report
}
STATUS current
DESCRIPTION
"reportNewStatsDataReport is a notification sent
when a new report is completed from the
reportStatsControlTable. The notification carries
the index from the control table that established
this report and the index from the data table that
holds this report."
::= { reportNotificationObjects 1 }
reportNewSampledDataReport NOTIFICATION-TYPE The usrHistoryObjectIndex value in the index identifies
OBJECTS { reportSampledControlIndex, -- The index of the the reportSampledObjectEntry on whose behalf this entry
-- control table for this report was created.
reportSampledReportIndex -- The index of the
-- data table for this report
}
STATUS current
DESCRIPTION
"reportNewSampledDataReport 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."
::= { reportNotificationObjects 2 }
reportNewHistoryDataReport NOTIFICATION-TYPE For example, an instance of reportSampledAbsValue, which
OBJECTS { reportHistoryControlIndex, -- The index of the represents the 14th sample of a variable collected as
-- control table for this report specified by reportSampledControlEntry.1 and
reportHistoryDataIndex -- The index of the reportSampledObjectEntry.1.5, would be named
-- data table for this report reportSampledAbsValue.1.14.5"
} INDEX { usrHistoryControlIndex, reportSampledReportIndex,
STATUS current reportSampledSampleIndex, usrHistoryObjectIndex }
DESCRIPTION ::= { reportSampledTable 1 }
"reportNewHistoryDataReport is a notification sent
when a new report is completed from the
reportHistoryControlTable. 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 reportHistoryControlReportNumber
is incremented."
::= { reportNotificationObjects 3 }
-- reportNotificationStates SampledEntry ::= SEQUENCE {
-- none to define 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 }
reportCompliances OBJECT IDENTIFIER ::= { reportMIBConformance 1 } reportSampledIntervalStart OBJECT-TYPE
reportMIBGroups OBJECT IDENTIFIER ::= { reportMIBConformance 2 } 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.
reportStatsBasicCompliance MODULE-COMPLIANCE Note that following this rule may require the probe to delay
STATUS current collecting the first sample of the history, as each sample
DESCRIPTION "The Stats basic implementation requirements for must be of the same interval. Also note that the sample which
managed network entities that implement is currently being collected is not accessible in this table
the REPORT process." until the end of its interval."
::= { reportSampledEntry 3 }
MODULE -- this module reportSampledIntervalEnd OBJECT-TYPE
MANDATORY-GROUPS {reportStatsCapabilitiesBaseObjectsGroup, SYNTAX TimeStamp
reportStatsControlBaseObjectsGroup, MAX-ACCESS read-only
reportStatsDataBaseObjectsGroup, STATUS current
reportNotificationGroup, DESCRIPTION
reportStatsNotificationGroup } "The value of sysUpTime at the end of the interval over which
::= { reportCompliances 1 } this sample was measured."
::= { reportSampledEntry 4 }
reportStatsHCCompliance MODULE-COMPLIANCE reportSampledAbsValue OBJECT-TYPE
STATUS current SYNTAX Gauge32
DESCRIPTION "The HC implementation requirements for MAX-ACCESS read-only
managed network entities that implement STATUS current
the REPORT process." DESCRIPTION
MODULE -- this module "The absolute value (i.e. unsigned value) of the
MANDATORY-GROUPS {reportStatsCapabilitiesBaseObjectsGroup, user-specified statistic during the last sampling period. The
reportStatsControlBaseObjectsGroup, value during the current sampling period is not made available
reportStatsDataBaseObjectsGroup, until the period is completed.
reportNotificationGroup,
reportStatsNotificationGroup,
reportStatsDataHCObjectsGroup }
::= { reportCompliances 2 }
reportStatsExtendedMetricsCompliance MODULE-COMPLIANCE To obtain the true value for this sampling interval, the
STATUS current associated instance of reportSampledValStatus must
DESCRIPTION "The extended metrics implementation requirements for be checked, and reportSampledAbsValue adjusted as necessary.
managed network entities that implement
the REPORT process."
MODULE -- this module
MANDATORY-GROUPS {reportStatsCapabilitiesBaseObjectsGroup,
reportStatsControlBaseObjectsGroup,
reportStatsDataBaseObjectsGroup,
reportNotificationGroup,
reportStatsNotificationGroup,
reportStatsExtendedMetricsCapabilitiesObjectsGroup,
reportStatsExtendedMetricsControlObjectsGroup,
reportStatsExtendedMetricsDataObjectsGroup }
::= { reportCompliances 3 }
reportSampledBasicCompliance MODULE-COMPLIANCE If the MIB instance could not be accessed during the sampling
STATUS current interval, then this object will have a value of zero and the
DESCRIPTION "The Sampled basic implementation requirements for associated instance of reportSampledValStatus will be set to
managed network entities that implement 'valueNotAvailable(1)'."
the REPORT process." ::= { reportSampledEntry 5 }
MODULE -- this module
MANDATORY-GROUPS {reportSampledControlBaseObjectsGroup,
reportSampledObjectIDBaseObjectsGroup,
reportSampledDataBaseObjectsGroup,
reportNotificationGroup,
reportSampledNotificationGroup }
::= { reportCompliances 4 }
reportHistoryBasicCompliance MODULE-COMPLIANCE reportSampledValStatus OBJECT-TYPE
STATUS current SYNTAX INTEGER {
DESCRIPTION "The History basic implementation requirements for valueNotAvailable(1),
managed network entities that implement valuePositive(2),
the REPORT process." valueNegative(3)
MODULE -- this module }
MANDATORY-GROUPS {reportHistoryControlBaseObjectsGroup, MAX-ACCESS read-only
reportHistoryDataBaseObjectsGroup, STATUS current
reportNotificationGroup, DESCRIPTION
reportHistoryNotificationGroup } "This object indicates the validity and sign of the data in
::= { reportCompliances 5 } the associated instance of reportSampledAbsValue.
If the MIB instance could not be accessed during the sampling
interval, then 'valueNotAvailable(1)' will be returned.
reportStatsCapabilitiesBaseObjectsGroup OBJECT-GROUP If the sample is valid and actual value of the sample is
OBJECTS { greater than or equal to zero then 'valuePositive(2)' is
reportClockResolution, returned.
reportClockMaxSkew,
reportClockSource
}
STATUS current
DESCRIPTION
"Set of REPORT configuration objects implemented
in this module."
::= { reportMIBGroups 1 }
reportStatsControlBaseObjectsGroup OBJECT-GROUP If the sample is valid and the actual value of the sample is
OBJECTS { less than zero, 'valueNegative(3)' will be returned. The
reportStatsControlIndex, associated instance of reportSampledAbsValue should be
reportStatsControlInterval, multiplied by -1 to obtain the true sample value."
reportStatsControlBinInterval, ::= { reportSampledEntry 6 }
reportStatsControlPriObjID,
reportStatsControlPriObjIpAddrType,
reportStatsControlPriObjIPAddr,
reportStatsControlReqReports,
reportStatsControlGrantedReports,
reportStatsControlStartTime,
reportStatsControlReportNumber,
reportStatsControlInsertsDenied,
reportStatsControlOwner,
reportStatsControlStorageType,
reportStatsControlStatus
} --
STATUS current -- Notifications
DESCRIPTION --
"Set of REPORT Stats Control base objects implemented
in this module."
::= { reportMIBGroups 2 }
reportStatsDataBaseObjectsGroup OBJECT-GROUP reportSampledNotificationObjects OBJECT IDENTIFIER
OBJECTS { ::= {reportSampledMIBNotifications 1}
reportStatsDataIndex,
reportStatsDataStatN,
reportStatsDataStatSumX,
reportStatsDataOverflowStatSumX,
reportStatsDataStatMaximum,
reportStatsDataStatMinimum,
reportStatsDataStatSumSq,
reportStatsDataOverflowStatSumSq,
reportStatsDataStatSumIX,
reportStatsDataOverflowStatSumIX,
reportStatsDataStatSumIXSq,
reportStatsDataOverflowStatSumIXSq
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 3 }
reportNotificationGroup OBJECT-GROUP -- reportSampledNotificationObjects
OBJECTS {
reportSetNotification
}
STATUS current
DESCRIPTION
"Set of REPORT notifications implemented
in this module for the Statistics reports."
::= { reportMIBGroups 4 }
reportStatsNotificationGroup NOTIFICATION-GROUP reportSampledNewDataReport NOTIFICATION-TYPE
NOTIFICATIONS { OBJECTS { usrHistoryControlOwner, -- The entity that
reportNewStatsDataReport -- configured this entry
} reportSampledReportIndex -- The index of the
STATUS current -- data table for this report
DESCRIPTION }
"Set of REPORT notifications implemented STATUS current
in this module for the Statistics reports." DESCRIPTION
::= { reportMIBGroups 5 } "reportSampledNewDataReport is a notification sent
reportStatsDataHCObjectsGroup OBJECT-GROUP when a new report is completed from the
OBJECTS { reportSampledControlTable. The notification carries
reportStatsDataHCStatSumX, the index from the control table that established
reportStatsDataHCStatSumSq, this report and the index from the data table that
reportStatsDataHCStatSumIX, holds this report. Indication of the new report
reportStatsDataHCStatSumIXSq is when the reportSampledControlReportNumber
} is incremented."
STATUS current ::= { reportSampledNotificationObjects 1 }
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 6 }
reportStatsExtendedMetricsCapabilitiesObjectsGroup OBJECT-GROUP --
OBJECTS { -- Compliance Statements
reportMetricExtDefType, --
reportMetricExtDefName,
reportMetricExtDefOperation,
reportMetricExtDefReference,
reportMetricDirLastChange
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 7 }
reportStatsExtendedMetricsControlObjectsGroup OBJECT-GROUP -- Mandatory for Sampled will include all.
OBJECTS {
reportStatsControlSecObj1ID,
reportStatsControlSecObj1IpAddrType,
reportStatsControlSecObj1IPAddr,
reportStatsControlSecObj2ID,
reportStatsControlSecObj2IpAddrType,
reportStatsControlSecObj2IPAddr,
reportStatsControlSecObj3ID,
reportStatsControlSecObj3IpAddrType,
reportStatsControlSecObj3IPAddr,
reportStatsControlSecObj4ID,
reportStatsControlSecObj4IpAddrType,
reportStatsControlSecObj4IPAddr,
reportStatsControlSecObj5ID,
reportStatsControlSecObj5IpAddrType,
reportStatsControlSecObj5IPAddr,
reportStatsControlMetricExt1,
reportStatsControlMetricExt2,
reportStatsControlMetricExt3,
reportStatsControlMetricExt4,
reportStatsControlMetricExt5
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 8 }
reportStatsExtendedMetricsDataObjectsGroup OBJECT-GROUP reportSampledCompliances OBJECT IDENTIFIER
OBJECTS { ::= { reportSampledMIBConformance 1 }
reportStatsDataStatMetricExt1, reportSampledMIBGroups OBJECT IDENTIFIER
reportStatsDataStatMetricExt2, ::= { reportSampledMIBConformance 2 }
reportStatsDataStatMetricExt3,
reportStatsDataStatMetricExt4,
reportStatsDataStatMetricExt5
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 9 }
reportSampledControlBaseObjectsGroup OBJECT-GROUP reportSampledCompliance MODULE-COMPLIANCE
OBJECTS { STATUS current
reportSampledControlIndex, DESCRIPTION "The Sampled basic implementation requirements for
reportSampledControlObjects, managed network entities that implement
reportSampledControlBucketsRequested, the REPORT Sampled process."
reportSampledControlBucketsGranted, MODULE -- this module
reportSampledControlInterval, MANDATORY-GROUPS { reportSampledLocalGroup }
reportSampledControlRequestedNumber, ::= { reportSampledCompliances 1 }
reportSampledControlReportNumber,
reportSampledControlOwner,
reportSampledControlStatus
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 10 }
reportSampledObjectIDBaseObjectsGroup OBJECT-GROUP reportSampledNotificationCompliance MODULE-COMPLIANCE
OBJECTS { STATUS current
reportSampledObjectVariable, DESCRIPTION "The Sampled Notification implementation
reportSampledObjectIpAddrType, requirements for managed network entities
reportSampledObjectIPAddress, that implement the REPORT process."
reportSampledObjectSampleType MODULE -- this module
} MANDATORY-GROUPS { reportSampledNotificationObjectGroup }
STATUS current ::= { reportSampledCompliances 2 }
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 11 }
reportSampledDataBaseObjectsGroup OBJECT-GROUP -- Units of Conformance
OBJECTS {
reportSampledReportIndex,
reportSampledIntervalStart,
reportSampledIntervalEnd,
reportSampledAbsValue,
reportSampledValStatus
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 12 }
reportSampledNotificationGroup NOTIFICATION-GROUP reportSampledLocalGroup OBJECT-GROUP
NOTIFICATIONS { OBJECTS {
reportNewSampledDataReport reportSampledControlRequestedNumber,
} reportSampledControlReportNumber,
STATUS current reportSampledObjectIpAddrType,
DESCRIPTION reportSampledObjectIPAddress,
"Set of REPORT notifications implemented reportSampledReportIndex,
in this module for the Sampled reports." reportSampledIntervalStart,
::= { reportMIBGroups 13 } reportSampledIntervalEnd,
reportSampledAbsValue,
reportSampledValStatus
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportSampledMIBGroups 1 }
reportHistoryControlBaseObjectsGroup OBJECT-GROUP --reportSampledImportedGroup OBJECT-GROUP
OBJECTS { -- OBJECTS {
reportHistoryControlIndex, -- usrHistoryControlObjects,
reportHistoryControlObject, -- usrHistoryControlBucketsRequested,
reportHistoryControlObjectIpAddrType, -- usrHistoryControlBucketsGranted,
reportHistoryControlObjectIPAddress, -- usrHistoryControlInterval,
reportHistoryControlSizeRequested, -- usrHistoryControlOwner,
reportHistoryControlSizeGranted, -- usrHistoryControlStatus,
reportHistoryControlRequestedNumber, -- usrHistoryObjectVariable,
reportHistoryControlReportNumber, -- usrHistoryObjectSampleType
reportHistoryControlOwner, -- }
reportHistoryControlStatus -- STATUS current
} -- DESCRIPTION
STATUS current -- "Set of REPORT state objects implemented
DESCRIPTION -- in this module."
"Set of REPORT state objects implemented --::= { reportSampledMIBGroups 2 }
in this module."
::= { reportMIBGroups 14 }
reportHistoryDataBaseObjectsGroup OBJECT-GROUP
OBJECTS {
reportHistoryDataIndex,
reportHistoryDataChangeTime,
reportHistoryDataValueType,
reportHistoryDataValue,
reportHistoryDataValStatus
}
STATUS current
DESCRIPTION
"Set of REPORT state objects implemented
in this module."
::= { reportMIBGroups 15 }
reportHistoryNotificationGroup NOTIFICATION-GROUP reportSampledNotificationObjectGroup NOTIFICATION-GROUP
NOTIFICATIONS { NOTIFICATIONS {
reportNewHistoryDataReport reportSampledNewDataReport
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Set of REPORT notifications implemented "Set of REPORT notifications implemented
in this module for the History reports." in this module for the Sampled reports."
::= { reportMIBGroups 16 } ::= { reportSampledMIBGroups 3 }
END END
8. Security Considerations 8. Security Considerations
[TODO] Each specification that defines one or more MIB modules MUST This REPORT-SAMPLED-MIB defines a capability where the local device
contain a section that discusses security considerations relevant to may poll other remote devices to collect performance data accessible
those modules. This section MUST be patterned after the latest through other MIB modules on the remote devices. These capabilities
approved template (available at defined within the REPORT-SAMPLED-MIB are control-able by a network
http://www.ops.ietf.org/mib-security.html). Remember that the management application through SNMP. As such, a network management
objective is not to blindly copy text from the template, but rather application could potentially use the REPORT-SAMPLED-MIB as a
to think and evaluate the risks/vulnerabilities and then state/ mechanism to implement a Distributed Denial-of-Service (DDoS) attack
document the result of this evaluation. against remote devices. Care should be taken to secure access to the
REPORT-SAMPLED-MIB agent. Specifically, access control mechanisms
[TODO] if you have any read-write and/or read-create objects, please and authentication mechanisms (via SNMPv3) should always be used for
include the following boilerplate paragraph. SNMP SET operations. Further, some objects may contain data deemed
sensitive and authentication and encryption mechanisms (via SNMPv3)
should be used for SNMP GET operations.
There are a number of management objects defined in this MIB module There are a number of management objects defined in this MIB module
with a MAX-ACCESS clause of read-write and/or read-create. Such with a MAX-ACCESS clause of read-write and/or read-create. Such
objects may be considered sensitive or vulnerable in some network objects may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on environment without proper protection can have a negative effect on
network operations. These are the tables and objects and their network operations.
sensitivity/vulnerability:
o [TODO] writable MIB objects that could be especially disruptive if These are the tables and objects and their sensitivity/vulnerability:
abused MUST be explicitly listed by name and the associated
security risks MUST be spelled out; RFC 2669 has a very good
example.
o [TODO] list the writable tables and objects and state why they are o The reportSampledControlTable is a writable table whose columnar
sensitive. objects are read-create. The following objects with MAX ACCESS of
read-create and their security sensitivities are:
[TODO] else if there are no read-write objects in your MIB module, o
use the following boilerplate paragraph.
There are no management objects defined in this MIB module that have * usrHistoryControlBucketRequested - this object identifies the
a MAX-ACCESS clause of read-write and/or read-create. So, if this requested number of buckets (or intervals) requested for each
MIB module is implemented correctly, then there is no risk that an identified object for each report instance. As such, this
intruder can alter or create any management objects of this MIB related to the total device memory necessary to hold the
module via direct SNMP SET operations. collected data for the identified reports. The device must
determine whether it has the necessary storage. If not, the
device can indicate the available storage through the
usrHistoryControlBucketGranted object within this table. The
device to protect itself against memory overruns.
[TODO] if you have any sensitive readable objects, please include the * usrHistoryControlInterval - this object identifies the time
following boilerplate paragraph. interval being sampling events. If set too low, the device may
not be able to sample the object on remote devices fast enough
to satisfy the requested interval. Further, setting this value
too low could be used to overwhelm the processing capabilities
of the remote agent, resulting in a Denial-of-Service (DoS)
attack.
Some of the readable objects in this MIB module (i.e., objects with a * reportSampledControlRequestedNumber - this object identifies
MAX-ACCESS other than not-accessible) may be considered sensitive or the requested number of consecutive reports of this type to be
vulnerable in some network environments. It is thus important to generated and stored in this device. When, the value of this
control even GET and/or NOTIFY access to these objects and possibly object should be considered in the local device's estimates of
to even encrypt the values of these objects when sending them over memory consumption related to this control table row.
the network via SNMP. These are the tables and objects and their
sensitivity/vulnerability:
o [TODO] you must explicitly list by name any readable objects that * usrHistoryControlOwner - this objects provides a name
are sensitive or vulnerable and the associated security risks MUST associated with the presumed identity of the application
be spelled out (for instance, if they might reveal customer configuring this report. If the local device or management
information or violate personal privacy laws such as those of the applications attribute any authority to the values contained in
European Union if exposed to unauthorized parties) this object, then it is critical to secure access to setting or
modifying the value of this object.
o [TODO] list the tables and objects and state why they are * usrHistoryControlStatus - this is the RowStatus object
sensitive. controlling the configuration of this table row.
[TODO] discuss what security the protocol used to carry the o The reportSampledObjectTable is a writable table whose columnar
information should have. The following three boilerplate paragraphs objects are read-create. The following objects with MAX ACCESS of
should not be changed without very good reason. Changes will almost read-create and their security sensitivities are:
certainly require justification during IESG review.
o
* usrHistoryObjectVariable - this object identifies the specific
OID on a (potentially) remote agent whose counter or gauge
values are to be collected for the reports. If, for whatever
reason, the values of this OID collected within the report is
deemed sensitive, then the SNMP GET operations issued to
collect these values should use SNMPv3 authentication and
encryption mechanisms to protect.
* reportSampledObjectIpAddrType - this object identifies the
address type associated with the address of the agent whose OID
data is being collected for the report.
* reportSampledObjectIpAddress - this object identifies the
address associated with the address of the agent whose OID data
is being collected for the report. If the address of the
remote devices is deemed sensitive, then the SNMP SETs which
write or the SNMP GET which collect this information should be
protected using SNMPv3 authentication and encryption
mechanisms.
* usrHistoryObjectSampleType - this object identifies the the way
in which data values are to be stored within the reports.
SNMP versions prior to SNMPv3 did not include adequate security. SNMP versions prior to SNMPv3 did not include adequate security.
Even if the network itself is secure (for example by using IPSec), Even if the network itself is secure (for example by using IPSec),
even then, there is no control as to who on the secure network is even then, there is no control as to who on the secure network is
allowed to access and GET/SET (read/change/create/delete) the objects allowed to access and GET/SET (read/change/create/delete) the objects
in this MIB module. in this MIB module.
It is RECOMMENDED that implementers consider the security features as It is RECOMMENDED that implementers consider the security features as
provided by the SNMPv3 framework (see [RFC3410], section 8), provided by the SNMPv3 framework (see [RFC3410], section 8),
including full support for the SNMPv3 cryptographic mechanisms (for including full support for the SNMPv3 cryptographic mechanisms (for
skipping to change at page 69, line 22 skipping to change at page 22, line 15
Further, deployment of SNMP versions prior to SNMPv3 is NOT Further, deployment of SNMP versions prior to SNMPv3 is NOT
RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
enable cryptographic security. It is then a customer/operator enable cryptographic security. It is then a customer/operator
responsibility to ensure that the SNMP entity giving access to an responsibility to ensure that the SNMP entity giving access to an
instance of this MIB module is properly configured to give access to instance of this MIB module is properly configured to give access to
the objects only to those principals (users) that have legitimate the objects only to those principals (users) that have legitimate
rights to indeed GET or SET (change/create/delete) them. rights to indeed GET or SET (change/create/delete) them.
9. IANA Considerations 9. IANA Considerations
[TODO] In order to comply with IESG policy as set forth in
http://www.ietf.org/ID-Checklist.html, every Internet-Draft that is
submitted to the IESG for publication MUST contain an IANA
Considerations section. The requirements for this section vary
depending what actions are required of the IANA. see RFC4181 section
3.5 for more information on writing an IANA clause for a MIB module
document.
[TODO] select an option and provide the necessary details.
Option #1:
The MIB module in this document uses the following IANA-assigned The MIB module in this document uses the following IANA-assigned
OBJECT IDENTIFIER values recorded in the SMI Numbers registry: OBJECT IDENTIFIER values recorded in the SMI Numbers registry:
Descriptor OBJECT IDENTIFIER value Descriptor OBJECT IDENTIFIER value
---------- ----------------------- ---------- -----------------------
sampleMIB { mib-2 XXX } reportSampledMIB { experimental XXX }
Option #2:
Editor's Note (to be removed prior to publication): the IANA is
requested to assign a value for "XXX" under the 'mib-2' sub-tree and
to record the assignment in the SMI Numbers registry. When the
assignment has been made, the RFC Editor is asked to replace "XXX"
(here and in the MIB module) with the assigned value and to remove
this note.
Note well: prior to official assignment by the IANA, a draft document
MUST use placeholders (such as "XXX" above) rather than actual
numbers. See RFC4181 Section 4.5 for an example of how this is done
in a draft MIB module.
Option #3:
This memo includes no request to IANA.
10. Contributors 10. Contributors
This MIB document uses the template authored by D. Harrington which This MIB document uses the template authored by D. Harrington which
is based on contributions from the MIB Doctors, especially Juergen is based on contributions from the MIB Doctors, especially Juergen
Schoenwaelder, Dave Perkins, C.M.Heard and Randy Presuhn. Schoenwaelder, Dave Perkins, C.M.Heard and Randy Presuhn.
11. Acknowledgements 11. Acknowledgements
We would like to thank Bert Wijnen and Andy Bierman for pointing out We would like to thank Bert Wijnen for pointing out the existence of
the existence of the usrHistory group within RMON2 and in answering the usrHistory group within RMON2 and in answering our numerous
our numerous questions on the usrHistory group. Further, we wish to questions on the usrHistory group. Further, we wish to thank U.
thank U. Herberg for his forcing additions to this MIB through his Herberg for promoting additions to this MIB through his thoughtful
thoughtful consideration of performance monitoring requirements for consideration of performance monitoring requirements for other MIBs
other MIBs, e.g., NHDP and OLSR MIBs. within the MANET WG, e.g., NHDP and OLSR MIBs.
12. References 12. References
12.1. Normative References 12.1. Normative References
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC 2863, June 2000. MIB", RFC 2863, June 2000.
[RFC3418] Presuhn, R., "Management Information Base (MIB) for the [RFC3418] Presuhn, R., "Management Information Base (MIB) for the
Simple Network Management Protocol (SNMP)", STD 62, Simple Network Management Protocol (SNMP)", STD 62,
skipping to change at page 71, line 6 skipping to change at page 23, line 17
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Textual Conventions for SMIv2", Schoenwaelder, Ed., "Textual Conventions for SMIv2",
STD 58, RFC 2579, April 1999. STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580, "Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999. April 1999.
[RFC4001] Daniele, M., Haberman, B., Routhier, S., and J.
Schoenwaelder, "Textual Conventions for Internet Network
Addresses", RFC 4001, February 2005.
12.2. Informative References 12.2. Informative References
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet- "Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002. Standard Management Framework", RFC 3410, December 2002.
[RFC1757] Waldbusser, S., "Remote Network Monitoring Management
Information Base", RFC 1757, February 1995.
[RFC2021] Waldbusser, S., "Remote Network Monitoring Management [RFC2021] Waldbusser, S., "Remote Network Monitoring Management
Information Base Version 2 using SMIv2", RFC 2021, Information Base Version 2 using SMIv2", RFC 2021,
January 1997. January 1997.
[RFC4150] Dietz, R. and R. Cole, "Transport Performance Metrics
MIB", RFC 4150, August 2005.
Appendix A. Change Log Appendix A. Change Log
Changes from draft-ietf-manet-report-mib-01 to
draft-ietf-manet-report-mib-02 draft.
1. Stripped the Statistical and the Historical Reports from this
draft in order to greatly simplify the initial development and
experiments of this MIB module.
2. Changed the RFC category to Experimental.
3. Completed the Security section.
4. Relied upon the AUGMENTS statement to simplify further this MIB
definition.
Changes from draft-ietf-manet-report-mib-00 to Changes from draft-ietf-manet-report-mib-00 to
draft-ietf-manet-report-mib-01 draft. draft-ietf-manet-report-mib-01 draft.
1. Proposed additions to the statsReports in order to potentially 1. Proposed additions to the statsReports in order to potentially
simplify data transmission to management applications. simplify data transmission to management applications.
2. Added some Notification definitions and their relationship to the 2. Added some Notification definitions and their relationship to the
three reports' structure, i.e., statsReports, sampledReports, and three reports' structure, i.e., statsReports, sampledReports, and
historyReports. historyReports.
skipping to change at page 72, line 7 skipping to change at page 24, line 27
4. Ran MIB through smilint checker and cleaned up all errors and 4. Ran MIB through smilint checker and cleaned up all errors and
most warnings. A few warnings remain to be addressed. most warnings. A few warnings remain to be addressed.
5. Cleaned up textual material. 5. Cleaned up textual material.
Changes from draft-cole-manet-report-mib-02 to Changes from draft-cole-manet-report-mib-02 to
draft-ietf-manet-report-mib-00 draft. draft-ietf-manet-report-mib-00 draft.
1. Major change was the incorporation of the IP address objects 1. Major change was the incorporation of the IP address objects
associated with all objects of type 'OBJECT IDENTIFIER'. This associated with all objects of type 'OBJECT IDENTIFIER'. This
allows the REPORT-MIB to exist as a proxy report generation allows the REPORT-SAMPLED-MIB to exist as a proxy report
capability on a device separate but in close proximity to the generation capability on a device separate but in close proximity
device monitoring the referenced object. to the device monitoring the referenced object.
2. Cleaned up the up front text, reducing the repetition with the 2. Cleaned up the up front text, reducing the repetition with the
object descriptions in the MIB. object descriptions in the MIB.
3. Worked on and added sections discussing the relationship to other 3. Worked on and added sections discussing the relationship to other
MIBs. MIBs.
Changes from draft-cole-manet-report-mib-01 to Changes from draft-cole-manet-report-mib-01 to
draft-cole-manet-report-mib-02 draft. draft-cole-manet-report-mib-02 draft.
skipping to change at page 72, line 37 skipping to change at page 25, line 9
3. Added a new historyGroup which provides a history of change 3. Added a new historyGroup which provides a history of change
events. events.
4. Updated the4 Conformance section to reflect the above changes and 4. Updated the4 Conformance section to reflect the above changes and
additions. But did not yet run smilint to check MIB syntax. additions. But did not yet run smilint to check MIB syntax.
Changes from draft-cole-manet-report-mib-00 to Changes from draft-cole-manet-report-mib-00 to
draft-cole-manet-report-mib-01 draft. draft-cole-manet-report-mib-01 draft.
1. Added (copied) the usrHistory group from RMON2 into the REPORT- 1. Added (copied) the usrHistory group from RMON2 into the REPORT-
MIB. SAMPLED-MIB.
2. Restructured the MIB to account for the inclusion of the 2. Restructured the MIB to account for the inclusion of the
reportSampledGroup. reportSampledGroup.
3. Dropped the reportCurReportsTable as this did not make sense 3. Dropped the reportCurReportsTable as this did not make sense
within the context of the REPORT-MIB. within the context of the REPORT-SAMPLED-MIB.
4. Added the Compliance and Conformance material. Defined several 4. Added the Compliance and Conformance material. Defined several
Compliance Groups to all for base implementations of the REPORT- Compliance Groups to all for base implementations of the REPORT-
MIB for only statistical reports, for only historical reports or SAMPLED-MIB for only statistical reports, for only historical
for both. Allow for enhanced implementations to address higher reports or for both. Allow for enhanced implementations to
capacity issues and extension to metric reporting for statistical address higher capacity issues and extension to metric reporting
reporting. for statistical reporting.
5. Ran the MIB through the smilint checker and in the process 5. Ran the MIB through the smilint checker and in the process
corrected numerous typos, omissions, TEXTUAL CONVENTIONS, corrected numerous typos, omissions, TEXTUAL CONVENTIONS,
IMPORTS, etc. IMPORTS, etc.
6. Updated main text to reflect changes. 6. Updated main text to reflect changes.
Appendix B. Open Issues Appendix B. Open Issues
This section contains the set of open issues related to the This section contains the set of open issues related to the
development and design of the REPORT-MIB. This section will not be development and design of the REPORT-SAMPLED-MIB. This section will
present in the final version of the MIB and will be removed once all not be present in the final version of the MIB and will be removed
the open issues have been resolved. once all the open issues have been resolved.
1. Need to add an index associated with object IDs of interest which
are contained within a table, e.g., IfPacketsIn in an
InterfaceTable which is indexed by IfIndex. (Note: (RGC)I think
adding the IP address associated with the referenced object
addresses this issue.)
2. Complete notification group. Need to develop the preferred data
report transmission model. This will influence the design of the
Notifications. The initial form for the notifications has been
laid out in draft-ietf-manet-report-mib-02.
3. Update the text of the document to reflect the final state of the
MIB.
4. Identify all objects requiring non-volatile storage in their 1. Identify all objects requiring non-volatile storage in their
DESCRIPTION clauses. DESCRIPTION clauses.
5. Complete the security analysis and section.
6. Cleanup all the [TODOs] from the MIB template.
Appendix C. Appendix C.
*************************************************************** ***************************************************************
* Note to the RFC Editor (to be removed prior to publication) * * Note to the RFC Editor (to be removed prior to publication) *
* * * *
* 1) The reference to RFCXXXX within the DESCRIPTION clauses * * 1) The reference to RFCXXXX within the DESCRIPTION clauses *
* of the MIB module point to this draft and are to be * * of the MIB module point to this draft and are to be *
* assigned by the RFC Editor. * * assigned by the RFC Editor. *
* * * *
* 2) The reference to RFCXXX2 throughout this document point * * 2) The reference to RFCXXX2 throughout this document point *
* to the current draft-ietf-manet-report-xx.txt. This * * to the current draft-ietf-manet-report-xx.txt. This *
* need to be replaced with the XXX RFC number. * * need to be replaced with the XXX RFC number. *
* * * *
*************************************************************** ***************************************************************
Authors' Addresses Authors' Addresses
Robert G. Cole Robert G. Cole
US Army CERDEC US Army CERDEC
328 Hopkins Road 6010 Frankford Road
Aberdeen Proving Ground, Maryland 21005 Aberdeen Proving Ground, Maryland 21005
USA USA
Phone: +1 410 278 6779 Phone: +1 443 395 8744
EMail: robert.g.cole@us.army.mil EMail: robert.g.cole@us.army.mil
URI: http://www.cs.jhu.edu/~rgcole/ URI: http://www.cs.jhu.edu/~rgcole/
Joseph Macker Joseph Macker
Naval Research Laboratory Naval Research Laboratory
Washington, D.C. 20375 Washington, D.C. 20375
USA USA
EMail: macker@itd.nrl.navy.mil EMail: macker@itd.nrl.navy.mil
Al Morton Andy Bierman
AT&T Laboratories Brocade
Middletown, N.J. 07724
USA
EMail: amorton@att.com EMail: andy.bierman@brocade.com
 End of changes. 141 change blocks. 
2790 lines changed or deleted 701 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/