draft-ietf-ippm-reporting-mib-04.txt   draft-ietf-ippm-reporting-mib-05.txt 
Network Working Group E. Stephan/J. Jewitt Network Working Group E. Stephan/J. Jewitt
Internet Draft France Telecom R&D Internet Draft France Telecom R&D
Document: draft-ietf-ippm-reporting-mib-04.txt October, 2003 Document: draft-ietf-ippm-reporting-mib-05.txt February, 2004
Category: Informational Category: Standards Track
IPPM reporting MIB IPPM reporting MIB
Status of this Memo Status of this Memo
This document is an Internet-Draft and is in full conformance with This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC2026 [1]. all provisions of Section 10 of RFC2026 [1].
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that other Task Force (IETF), its areas, and its working groups. Note that other
skipping to change at page 2, line 11 skipping to change at page 2, line 11
In particular, this MIB specifies the objects used for managing the In particular, this MIB specifies the objects used for managing the
results of the IPPM metrics measures, for pushing alarms, and for results of the IPPM metrics measures, for pushing alarms, and for
reporting the measures results. reporting the measures results.
Table of Contents Table of Contents
1. Introduction................................................2 1. Introduction................................................2
2. The IPPM Framework..........................................3 2. The IPPM Framework..........................................3
3. The SNMP Management Framework...............................3 3. The SNMP Management Framework...............................3
4. Overview....................................................5 4. Overview....................................................5
4.1. Textual Conventions.........................................6 4.1. Textual Conventions.........................................5
4.2 Structure of the MIB.........................................8 4.2 Structure of the MIB.........................................8
4.3 Row identification in an application namespace..............10 4.3 Row identification in an application namespace..............10
4.4 Relationship of IPPM REPORTING MIB tables...................11 4.4 Relationship of IPPM REPORTING MIB tables...................11
5 Measurement architectures...................................12 5 Measurement architectures...................................12
5.1 Proxy architecture..........................................12 5.1 Proxy architecture..........................................12
5.2 Reporting architecture......................................13 5.2 Reporting architecture......................................13
5.3 Gateway architecture........................................15 5.3 Gateway architecture........................................15
5.4 Security....................................................15 5.4 Security....................................................15
6 Reporting mode integration..................................16 6 Reporting mode integration..................................16
6.1 Integration.................................................16 6.1 Integration.................................................16
6.2 Setup of the measure network................................16 6.2 Setup of the network measure table..........................16
6.3 Setup of a measurement report...............................16 6.3 Setup of the aggregated measure table.......................16
6.4 Updating the history of the MIB.............................17 6.4 Updating the history of the MIB.............................17
6.5 Report download and upload..................................17 6.5 Default value...............................................17
6.6 Default value...............................................17
7 Definition..................................................17 7 Definition..................................................17
8 Security Considerations.....................................70 8 Security Considerations.....................................57
8.1 VACM Access control.........................................70 8.1 VACM Access control.........................................57
8.2 Privacy.....................................................72 8.2 Privacy.....................................................59
8.3 Measurement aspects.........................................73 8.3 Measurement aspects.........................................59
8.4 Management aspects..........................................73 8.4 Management aspects..........................................60
9 Document management.........................................74 9 Document management.........................................61
9.1 Open issues.................................................74 9.1 Open issues.................................................61
9.2 Changes done since release 03...............................74 9.2 Changes done since release 04...............................61
9.3 Changes done since release 02...............................75 9.3 Changes done since release 03...............................61
10 References..................................................76 9.4 Changes done since release 02...............................62
11 Acknowledgments.............................................77 10 References..................................................62
12 Authors' Addresses..........................................77 11 Acknowledgments.............................................64
12 Authors' Addresses..........................................64
1. Introduction 1. Introduction
This memo defines a MIB for managing network measurements based upon This memo defines a MIB for managing network measurements based upon
the IP performance metrics specified by the IPPM Working Group. the IP performance metrics specified by the IPPM Working Group.
The definition of objects in the IPPM MIB are built on notions The definition of objects in the IPPM MIB are built on notions
introduced and discussed in the IPPM Framework document, RFC 2330 introduced and discussed in the IPPM Framework document, RFC 2330
[ii]. [ii].
This memo defines a Management Information Base (MIB), and as such it This memo defines a Management Information Base (MIB), and as such it
skipping to change at page 3, line 18 skipping to change at page 3, line 18
The IPPM Framework consists of 3 major components: The IPPM Framework consists of 3 major components:
A general framework for defining performance metrics, as described in A general framework for defining performance metrics, as described in
the Framework for IP Performance Metrics, RFC 2330 [2]; the Framework for IP Performance Metrics, RFC 2330 [2];
A set of standardized metrics which conform to this framework: The A set of standardized metrics which conform to this framework: The
IPPM Metrics for Measuring Connectivity, RFC 2678 [iii]; The One-way IPPM Metrics for Measuring Connectivity, RFC 2678 [iii]; The One-way
Delay Metric for IPPM, RFC 2679 [iv]; The One-way Packet Loss Metric Delay Metric for IPPM, RFC 2679 [iv]; The One-way Packet Loss Metric
for IPPM, RFC 2680 [v]; The Round-trip Delay Metric for IPPM, RFC for IPPM, RFC 2680 [v]; The Round-trip Delay Metric for IPPM, RFC
2681 [vi]. 2681 [vi];
Emerging metrics that are being specified in respect of this Emerging metrics that are being specified in respect of this
framework. framework.
3. The SNMP Management Framework 3. The SNMP Management Framework
The SNMP Management Framework consists of five major components: The SNMP Management Framework consists of five major components:
An overall architecture, described in RFC 2571 [2]. An overall architecture, described in RFC 2571 [2].
skipping to change at page 5, line 22 skipping to change at page 5, line 22
To permit metrics to be referenced by other MIBs and other protocols, To permit metrics to be referenced by other MIBs and other protocols,
the IPPM WG has defined a registry of the current metrics and a the IPPM WG has defined a registry of the current metrics and a
framework for the integration of future metrics in the [IPPM metrics framework for the integration of future metrics in the [IPPM metrics
registry]. registry].
As the specification of new metrics is a continuous process, this As the specification of new metrics is a continuous process, this
memo defines a framework for the integration of the future memo defines a framework for the integration of the future
standardized metrics. standardized metrics.
The MIB architecture is inspired by the RMON model [xxiii],[xxiv]
which specifies the MIB for the monitoring of a single point of
measure. The IPPM-REPORTING-MIB differs from this model in that IPPM
metrics measurement involves several points of measure and requires
common references for time and for measure identification.
The IPPM-REPORTING-MIB introduces a framework where each application The IPPM-REPORTING-MIB introduces a framework where each application
identifies its measures in an owner namespace. The administrator may identifies its measures in an owner namespace. The administrator may
grant access to a measure, or set of measures to another owner via grant access to a measure, or set of measures to another owner via
view based access control. As a result, one owner may compute view based access control. As a result, one owner may compute
aggregated metrics on another owners network measures. aggregated metrics on another owners network measures.
Different architectures may be used to perform metric measurements, Different architectures may be used to perform metric measurements,
using a control protocol and a test protocol. Different control using a control protocol and a test protocol. Different control
frameworks are suitable for performing measurements. The memo lists frameworks are suitable for performing measurements. The memo lists
them, while also looking for a way to integrate them with the IPPM- them, while also looking for a way to integrate them with the IPPM-
REPORTING-MIB. This section is for informational purposes only, and REPORTING-MIB. This section is for informational purposes only, and
is intended to help specify the relationship among the test protocol, is intended to help specify the relationship among the test protocol,
the control protocol and the IPPM-REPORTING-MIB. the control protocol and the IPPM-REPORTING-MIB.
Special care has been taken to provide a reporting mode suitable for Special care has been taken to provide a reporting mode suitable for
control protocols and test protocols. It addresses the need to control protocols and test protocols. It addresses the need to
provide access to results for the applications. Moreover, it may be provide access to results for the applications.
used to reduce the number of control frameworks.
This MIB is intended to handle multiple concurrent sessions by SNMP This MIB is intended to handle multiple concurrent sessions by SNMP
applications. However, the SNMP requests are not necessarily to be applications. However, the SNMP requests are not necessarily to be
handled explicitly by the measurement devices, but can be sent to handled explicitly by the measurement devices, but can be sent to
middleware performing an aggregation function. This allows for middleware performing an aggregation function. This allows for
continuous collection of measurements and statistics computation. continuous collection of measurements and statistics computation.
4.1. Textual Conventions 4.1. Textual Conventions
Seven types of data are introduced as textual conventions in this Eight types of data are introduced as textual conventions in this
document: IppmOwnerString, TimeUnit, TypeP, TypePaddress, document: IppmOwnerString, IppmOwnerIndex, TimeUnit, PacketType,
GMTTimeStamp, IppmStandardMetrics and IppmReportDefinition. PacketTypeAddress, GMTTimeStamp, IppmStandardMetrics and
IppmMetricResultFilter.
4.1.1 IppmOwnerString 4.1.1 IppmOwnerString
This octet string is used to represent the owners of the various This octet string is used to represent the owners of the various
measures and reports in the measurement system. measures and reports in the measurement system.
4.1.2 TimeUnit 4.1.2 IppmOwnerIndex
This integer identifies an instance of an object in an owner
namespace.
4.1.3 TimeUnit
This textual convention is used to indicate a unit of time, ranging This textual convention is used to indicate a unit of time, ranging
from nanosecond, microsecond, millisecond, second, hour, day, and from nanosecond, microsecond, millisecond, second, hour, day, and
week. week.
4.1.3 TypeP and TypePaddress 4.1.4 PacketType and PacketTypeAddress
Section 13 of the IPPM framework [2] introduces the generic notion of Section 13 of the IPPM framework [2] introduces the generic notion of
a "packet of type P", because in some contexts the metric's value a "packet of type P", because in some contexts the metric's value
depends on the type of the packets involved in the metric. In the depends on the type of the packets involved in the metric. In the
definition of a metric, the type P will be explicitly defined, definition of a metric, the type P will be explicitly defined,
partially defined, or left generic. Measurement of metrics defined partially defined, or left generic. Measurement of metrics defined
with generic type P are made specific when performing actual with generic type P are made specific when performing actual
measurements. It is important that one be conscious of the exact type measurements. It is important that one be conscious of the exact type
of traffic being measured. of traffic being measured.
skipping to change at page 6, line 44 skipping to change at page 6, line 40
capability to unambiguously configure the type P of the packets, and capability to unambiguously configure the type P of the packets, and
the parameters of the protocol suites of the type P. the parameters of the protocol suites of the type P.
RMON2 introduced the concept of protocol identifiers. RFC2895 [xxv] RMON2 introduced the concept of protocol identifiers. RFC2895 [xxv]
specifies a macro for the definition of protocol identifier. The specifies a macro for the definition of protocol identifier. The
RFC2896 [xxvi] defines the protocol identifiers for different RFC2896 [xxvi] defines the protocol identifiers for different
protocol encapsulation trees. protocol encapsulation trees.
The type P implementation relies on the MACRO PROTOCOL-IDENTIFIER The type P implementation relies on the MACRO PROTOCOL-IDENTIFIER
defined for identifying protocol suites in RMON2. It is achieved by defined for identifying protocol suites in RMON2. It is achieved by
defining the TypeP and the TypePaddress as new syntax in SMIv2 defining the PacketType and the PacketTypeAddress as new syntax in
TEXTUAL-CONVENTION. SMIv2 TEXTUAL-CONVENTION.
4.1.3.1 Internet addresses 4.1.4.1 Internet addresses
The section 14 of the IPPM framework defines (for the usual case of a The section 14 of the IPPM framework defines (for the usual case of a
unidirectional path through the Internet) the term "Src" and "Dst". unidirectional path through the Internet) the term "Src" and "Dst".
"Src" denotes the IP address of the beginning of the path, and "Dst" "Src" denotes the IP address of the beginning of the path, and "Dst"
denotes the IP address of the end. denotes the IP address of the end.
The section 3 of the RMON PI Reference specifies the Protocol The section 3 of the RMON PI Reference specifies the Protocol
Identifier Encoding rules, which consists briefly in a recursive Identifier Encoding rules, which consists briefly in a recursive
length value format. "Src" and "Dst" are protocol identifier length value format. "Src" and "Dst" are protocol identifier
parameters. Their values are encoded in separated fields using the parameters. Their values are encoded in separated fields using the
encoding rules of the protocol identifier, but without trailing encoding rules of the protocol identifier, but without trailing
parameters. parameters.
The packet encapsulation defined in an instance of TypeP embeds the The packet encapsulation defined in an instance of PacketType embeds
format of "Src" and "Dst" and their values. The type and value of the format of "Src" and "Dst" and their values. The type and value of
these addresses depend on the type P of the packet, IP version 4, these addresses depend on the type P of the packet, IP version 4,
IPV6, IP in IP... Both participate in the completion of the packet IPV6, IP in IP... Both participate in the completion of the packet
encoding. encoding.
Examples: Examples:
RFC2896 defines the protocol identifiers ip and ipip4. Should there RFC2896 defines the protocol identifiers ip and ipip4. Should there
be an Internet tunnel end-point of the IP address 192.168.1.1 in the be an Internet tunnel end-point of the IP address 192.168.1.1 in the
tunnel 128.2.6.7. the TypeP of the source address of the tunnel, Src, tunnel 128.2.6.7. the PacketType of the source address of the tunnel,
is 'ip.ipip4'. The encoding of 'ip.ipip4' using the RFC2895 rules Src, is 'ip.ipip4'. The encoding of 'ip.ipip4' using the RFC2895
adds a trailer 2.0.0. It means that an instance of this protocol rules adds a trailer 2.0.0. It means that an instance of this
identifier has 2 parameters, which values will be set only when protocol identifier has 2 parameters, which values will be set only
implemented. In the IPPM TypeP context these 2 parameters are when implemented. In the IPPM PacketType context these 2 parameters
provided in Src (or Dst). In the current example the value of Src is are provided in Src (or Dst). In the current example the value of Src
"192.168.1.1 128.2.6.7". is "192.168.1.1 128.2.6.7".
4.1.4 GMTTimeStamp 4.1.5 GMTTimeStamp
This textual convention defines the time at which an event occurred. This textual convention defines the time at which an event occurred.
It is very similar to the NTP timestamp format except that it It is very similar to the NTP timestamp format except that it
represents the time elapsed since January 1st, 2000 instead of represents the time elapsed since January 1st, 2000 instead of
January 1st, 1900. January 1st, 1900.
4.1.5 IppmStandardMetrics 4.1.6 IppmStandardMetrics
Each standard metric is identified in the IPPM-METRICS-REGISTRY under Each standard metric is identified in the IPPM-METRICS-REGISTRY under
the node rfc in chronological order. This textual convention defines the node rfc in chronological order. This textual convention defines
an octet string to permit several metrics to be performed in a single an octet string to permit several metrics to be performed in a single
measure. measure.
4.1.6 Report definition 4.1.7 Report definition
A report consists of sending, or logging, a subset of results of A report consists of sending, or logging, a subset of results of
measurements that have been taken over a period of time. The report measurements that have been taken over a period of time. The report
defines actions that are taken on the measurement results. An action defines actions that are taken on the measurement results. An action
is performed either: is performed either:
+ For each result + For each result
+ On the results corresponding to a measurement cycle + On the results corresponding to a measurement cycle
+ On the results available at the measurement completion. + On the results available at the measurement completion.
skipping to change at page 8, line 24 skipping to change at page 8, line 22
One may also want to report when particular values (i.e. constantly One may also want to report when particular values (i.e. constantly
over a threshold) repeatedly occur over a period of time. For over a threshold) repeatedly occur over a period of time. For
example, if one-way-day is constantly over a specified acceptable example, if one-way-day is constantly over a specified acceptable
threshold value for 10 minutes, then the values should be reported. threshold value for 10 minutes, then the values should be reported.
The combination of IPPM metric results, threshold events, and event The combination of IPPM metric results, threshold events, and event
filtering provides a very efficient mechanism to report measurement filtering provides a very efficient mechanism to report measurement
results, events, and alarms. results, events, and alarms.
A report is described using the TEXTUAL-CONVENTION A report is described using the TEXTUAL-CONVENTION
IppmReportDefinition. The report setup must not dramatically increase IppmMetricResultFilter. The report setup must not dramatically
the amount of data needed by the control protocol to setup a measure: increase the amount of data needed by the control protocol to setup a
measure:
+ A basic report is defined in the object ippmReportSetupDefinition; + A basic report is defined in the object ippmAggrMeasureFilter;
+ More elaborate reports are described using a metric threshold to + More elaborate reports are described using a metric threshold to
generate alarms and events. generate alarms and events.
+ The generation of alarms and reports requires a management station + The generation of alarms and reports requires a management station
address to which the data will be sent. address to which the data will be sent.
+ SLA alarms are described using an events duration threshold. + SLA alarms are described using an events duration threshold.
The TEXTUAL-CONVENTION IppmReportDefinition specifies the list of The TEXTUAL-CONVENTION IppmMetricResultFilter specifies the list of
events and actions that are used to create a report. events and actions that are used to create a report.
4.2 Structure of the MIB 4.2 Structure of the MIB
The MIB is arranged as follow: The MIB is arranged as follow:
- ippmSystem - ippmSystem Group:
- ippmOwners + ippmPointOfMeasureTable;
+ ippmSynchronizationTable;
+ ippmMetricsTable.
- ippmMeasure - ippmOwners Group:
-
+ ippmOwnersTable;
- ippmHistory - ippmHistory Group:
-
+ ippmHistoryTable;
- ippmNetMeasure - ippmNetMeasure Group:
-
+ ippmNetMeasureTable;
- ippmAggrMeasure - ippmAggrMeasure Group:
- ippmReport -
+ ippmAggrMeasureTable.
- ippmNotifications - ippmNotifications
4.2.1 The ippmSystem Group 4.2.1 The ippmSystem Group
The implementation of this group is mandatory.
This group consists of a set of parameters describing the clock This group consists of a set of parameters describing the clock
synchronization at a particular point of measure over time, as well synchronization at a particular point of measure over time, as well
as the system clock where the IPPM-REPORTING-MIB agent resides. as the system clock of the IPPM-REPORTING-MIB agent.
This group is critical to the implementation of the IPPM MIB. The table ippmPointOfMeasureTable describes the points of measure.
Section 6.3. of the IPPM Framework states that The table ippmSynchronisationTable is critical to the implementation,
especially to be respectful of the Section 6.3. of the IPPM
Framework, which states that
"Those who develop such measurement methodologies should strive to: "Those who develop such measurement methodologies should strive to:
+ Minimize their uncertainties/errors, + Minimize their uncertainties/errors,
+ Understand and document the sources of uncertainty/error, and + Understand and document the sources of uncertainty/error, and
+ Quantify the amounts of uncertainty/error." + Quantify the amounts of uncertainty/error."
The aim of this group is to have these values available to compute Consequently the table ippmSynchronisationTable makes these values
reliable statistics. The implementation of this group is mandatory, available to compute reliable statistics.
whether the time synchronization is automatic or not.
The table ippmMetricsTable list all the IPPM metrics using the
registry order and describes their implementation (unit...).
4.2.2 The ippmOwners Group 4.2.2 The ippmOwners Group
This group identifies an owner, or group of owners, that have access This group identifies an owner, or group of owners, that have access
to measurements on a probe. to measurements on a probe.
4.2.3 The ippmMeasure Group 4.2.3 The ippmHistory Group
This group contains all the IPPM metrics that are registered and
available for use by the agent.
The measurement entity describes in the ippmMetricsTable of the SNMP
agent the local implementation of the standardized metrics. All
standardized metrics should be displayed in this table, with the
ippmMetricCapabilities object defining whether the metric is
implemented or not.
4.2.4 The ippmHistory Group
The results of any given measure are stored in the ippmHistoryTable. The results of any given measure are stored in the ippmHistoryTable.
The indexing is such that there is an entry in this table for each The indexing is such that there is an entry in this table for each
result of a given measure for a given metric. result of a given measure for a given metric.
4.2.5 The ippmNetMeasure Group 4.2.4 The ippmNetMeasure Group
The control protocol registers a description of the existing network The control protocol registers a description of the existing network
measures in the ippmNetMeasureTable. measures in the ippmNetMeasureTable.
This group displays the network measures defined by the control This group displays the network measures defined by the control
protocol. The results are saved in the ippmHistoryTable. protocol. The results are saved in the ippmHistoryTable.
ippmNetMeasureTable is a reflection of the configuration of the ippmNetMeasureTable is a reflection of the configuration of the
network measure. network measure.
4.2.6 The ippmAggrMeasure Group 4.2.5 The ippmAggrMeasure Group
ippmAggrMeasureTable is responsible for the consolidation, or
aggregation, of results previously measured and saved in the
ippmHistoryTable. The aggregated results are saved in the
ippmHistoryTable and may be used for higher aggregated measures.
4.2.7 The Report Group
This group displays the existing reports of the measures collected. ippmAggrMeasureTable is responsible for the aggregation of results.
The ippmReportSetupTable is responsible for the configuration of the The aggregated results are saved in the ippmHistoryTable and may be
reports. used for higher aggregated measures.
The reports are saved in the ippmReportTable, or sent directly to
management applications.
4.2.8 The Notification Group 4.2.6 The Notification Group
The Notification group specifies a list of valid notifications. They The Notification group specifies a list of valid notifications. They
are used to generate alarms, or reports, to management applications. are used to generate alarms, or reports, to management applications.
4.3 Row identification in an application namespace 4.3 Row identification in an application namespace
The control protocol, or the test protocol, adds rows in the IPPM metrics measurement is a distributed task. An owner namespace is
namespace of the corresponding measure. defined to avoid the need of polling to determine the next free
index, to avoid index collision when 2 applications are looking for a
new index as the same time; to increase the speed of the management
operations; to reduce bandwidth consumption and to reduce CPU load in
the agents and applications.
An object instance identifier in an owner namespace is defined as a In a MIB, an object instance identifier is defined by the clause
list of objects in the clause INDEX where the first object type is INDEX of the table as a list of objects.
IppmOwnerString.
As the OBJECT IDENTIFIER, which identifies the instance, begins with The owner namespace is defined in the INDEX as a couple of 2 objects
the owner value, the remaining values of the index fields may be where the type of first one is IppmOwnerString and the type of the
chosen independently from one namespace to another. second is IppmOwnerIndex.
The first term of the instance identifier is the name of the owner.
The second term is an private index managed by the owner. This index
value is unique in an owner namespace. Before the creation of an
instance the creator pick up an IppmOwnerIndex value not in use.
This allows the user to choose arbitrary values for the remaining This allows the user to choose arbitrary values for the remaining
fields of the INDEX clause without checking that the values of these fields of the INDEX clause without checking that the values of these
fields exists in the MIB tables. This allows the owner to use the fields exists in the MIB tables. Moreover this allows the owner to
same values across MIB implementations. use the same instance identifier over a set of IPPM MIB
implementations.
Thus, it avoids polling to determine the next free index. Also, as a
consequence, two applications will never find the same free index
value.
The usage of owner namespace increases the speed of the management
operations while reducing bandwidth consumption and CPU load in the
agents and applications.
Measurements are requested by management applications. An instance of Measurements are requested by management applications. An instance of
an object managed by a management station is identified by the an object managed by a management station is identified by the
management station IppmOwnerString and the private index provided by management station IppmOwnerString and the private index provided by
the MS. the MS.
4.4 Relationship of IPPM REPORTING MIB tables 4.4 Relationship of IPPM REPORTING MIB tables
There is inherently a relationship between various tables in the IPPM There is inherently a relationship between various tables in the IPPM
REPORTING MIB, and as such, the data integrity must be assured. This REPORTING MIB, and as such, the data integrity must be assured. This
relationship is depicted in the following examples. relationship is depicted in the following examples.
skipping to change at page 12, line 8 skipping to change at page 11, line 51
The network measure table is read-only, thus entries in this table The network measure table is read-only, thus entries in this table
must be populated by the agent upon startup. must be populated by the agent upon startup.
The agent could potentially read a database that contains network The agent could potentially read a database that contains network
measures configured by a 3rd party proprietary management system that measures configured by a 3rd party proprietary management system that
directly interacts with the points of measure. However, the "owner" directly interacts with the points of measure. However, the "owner"
of the measure must be defined in the owners table. It may be either of the measure must be defined in the owners table. It may be either
configured directly, or exported to the agent by the external configured directly, or exported to the agent by the external
measurement tool. measurement tool.
The aggregated measure table allows for an "owner" to create The aggregated measure table allows for an "owner" to create
aggregated measures (such as average, minimum, maximum) on existing aggregated measures (such as average, minimum, maximum...) on
measures. An owner may even create aggregated measures on network existing measures. An owner may even create aggregated measures on
measures that are owned by other owners. However, it is recommended network measures that are owned by other owners. However, it is
to use view based access control to grant access of network measures recommended to use view based access control to grant access of
to other owners in the system. network measures to other owners in the system.
5 Measurement architectures 5 Measurement architectures
There are three main measurement architectures. There are three main measurement architectures.
5.1 Proxy architecture 5.1 Proxy architecture
. +----+ +----+ . +----+ +----+
. |NMS1| |NMS2| . |NMS1| |NMS2|
. +----+ +----+ . +----+ +----+
skipping to change at page 12, line 44 skipping to change at page 12, line 37
. | | . | |
. OWDP-Control . OWDP-Control
. | | . | |
. +----------+ +----------+ . +----------+ +----------+
. | | . | |
. v v . v v
.+----------------+ +------------------+ .+----------------+ +------------------+
.| Packets-Sender |--OWDP-Test-->| Packets-Receiver | .| Packets-Sender |--OWDP-Test-->| Packets-Receiver |
.+----------------+ +------------------+ .+----------------+ +------------------+
In this architecture, the different NMSs query the IPPM-REPORTING- In this architecture, the different NMSs query the IPPM-REPORTING-
MIB agent for measurements. The agent controls whether the NMS is MIB agent for measurements. The agent controls whether the NMS is
granted access to perform the measure requested. Each NMS may access granted access to perform the measure requested. Each NMS may access
the results of its measurements in the IPPM-REPORTING-MIB history the results of its measurements in the IPPM-REPORTING-MIB history
table. table.
The measurement setup/teardown and the data collection are done using The measurement setup/teardown and the data collection are done using
the control protocol and the test protocol. the control protocol and the test protocol.
In this mode the NMS does not depend on the control protocol nor on In this mode the NMS does not depend on the control protocol nor on
the test protocol. The entities involved in the measurement do not the test protocol. The entities involved in the measurement do not
skipping to change at page 13, line 36 skipping to change at page 13, line 30
. | | | | . | | | |
. | OWDP | OWDP . | OWDP | OWDP
. |Control |Control . |Control |Control
. | | | | . | | | |
. | | +------------------------------+ . | | +------------------------------+
. | | | | | . | | | | |
. | | +--|---------------------------+ | . | | +--|---------------------------+ |
. | | | | | | . | | | | | |
. | +--|--|------------------------+ | | . | +--|--|------------------------+ | |
. | | | | | | | . | | | | | | |
. +--------+---------------------+ | | | . +--------+---------------------+ | |
. | | | | | | | | . | | | | | | | |
. | | | | | | | | . | | | | | | | |
. v v v v v v v v . v v v v v v v v
. +------------------+ +------------------+ . +------------------+ +------------------+
. |IPPM-REPORTING-MIB| |IPPM-REPORTING-MIB| . |IPPM-REPORTING-MIB| |IPPM-REPORTING-MIB|
. | agent | | agent | . | agent | | agent |
. +------------------+ +------------------+ . +------------------+ +------------------+
. | Packets-Sender |--OWDP-Test-->| Packets-Receiver | . | Packets-Sender |--OWDP-Test-->| Packets-Receiver |
. +------------------+ +------------------+ . +------------------+ +------------------+
The activation of a measure by the control protocol or the test The activation of a measure by the control protocol or the test
protocol creates a measure in the IPPM-REPORTING-MIB Network Measure protocol creates a measure in the IPPM-REPORTING-MIB Network Measure
table. The table in question may be not accessible by SNMP. In this table. The table in question may be not accessible by SNMP. In this
case, a list of the measure identifiers (owner, index) is handled by case, a list of the measure identifiers (owner, index) is handled by
the measurement software. the measurement software.
Each timestamped result of the measure is logged in the IPPM- Each timestamped result of the measure is logged in the IPPM-
REPORTING-MIB History table in order to allow read access to the REPORTING-MIB History table in order to allow read access to the
NMSs and event handling. NMSs and event handling.
On completion, the measurement results are managed according to the On completion, the measurement results are managed according to the
measure setup: measure setup:
+ The results may be sent to an NMS; + The results may be sent to an NMS;
+ They may be dropped from the IPPM-REPORTING-MIB History table. + They may be dropped from the IPPM-REPORTING-MIB History table.
In this mode, it is recommended to use an SNMPv2 Inform PDU to send In this mode, it is recommended to use an SNMPv2 Inform PDU to send
reporting events because it ensures that the entire block of the reporting events because it ensures that the entire block of the
result is received. There is no control using SNMP Trap PDU. result is received. There is no control using SNMP Trap PDU.
skipping to change at page 16, line 48 skipping to change at page 16, line 48
The description of the measure is distributed to the points of The description of the measure is distributed to the points of
measure involved. The distribution may not be synchronized. measure involved. The distribution may not be synchronized.
6.1 Integration 6.1 Integration
The integration of the IPPM-REPORTING-MIB, and the test and control The integration of the IPPM-REPORTING-MIB, and the test and control
protocols consists in pushing the network measure setup/teardown protocols consists in pushing the network measure setup/teardown
parameters and the result values from the measurement software to the parameters and the result values from the measurement software to the
IPPM-REPORTING-MIB agent. IPPM-REPORTING-MIB agent.
6.2 Setup of the measure network 6.2 Setup of the network measure table
The measurement system updates the MIB on creation of a network measure. The measurement system updates the MIB on creation of a network measure.
6.3 Setup of a measurement report 6.3 Setup of the aggregated measure table
A measurement report setup describes events and data to include in
the report. A report is read by an NMS in the ippmReportTable, or
exported to an NMS using an SNMP trap, SNMP Inform PDU, an email, or
an SMS.
Different types of reports may be combined: There are 2 ways to setup an aggregated measure:
+ A trivial report defines the results to be saved in the The measurement system updates the MIB on creation of an aggregated
ippmReportTable; measure;
+ A basic report defines the host to which the results are sent An SNMP application creates an aggregated measure.
on completion of the measure;
+ An alarm report defines a threshold on the results of the
measure. A message is sent to a host when the result rises above,
or falls below the threshold;
+ An SLA report defines a threshold on the results of the
measure. The report consists of the results of the measure (time
and value) of the filtered events. The reports are sent at each
measurement cycle, or when the measure completes.
6.4 Updating the history of the MIB 6.4 Updating the history of the MIB
Results have to be written by the measurement task in the agent Results have to be written by the measurement task in the agent
implementing the IPPM REPORTING MIB. implementing the IPPM REPORTING MIB.
Adding the results of a measurement consists in the transfer of the Adding the results of a measurement consists in the transfer of the
result from the measurement software to the SNMP agent. The protocol result from the measurement software to the SNMP agent. The protocol
that provides the result may be the control protocol, or the test that provides the result may be the control protocol, or the test
protocol, or another mechanism. protocol, or another mechanism.
6.5 Report download and upload 6.5 Default value
A report is read in the ippmReportTable using SNMP, or generated by
the IPPM_MIB agent using a SNMP Inform PDU, an email or a SMS.
6.6 Default value
The default values correspond to IP version 4. The default values correspond to IP version 4.
7 Definition 7 Definition
IPPM-REPORTING-MIB DEFINITIONS ::= BEGIN IPPM-REPORTING-MIB DEFINITIONS ::= BEGIN
IMPORTS IMPORTS
MODULE-IDENTITY, MODULE-IDENTITY,
NOTIFICATION-TYPE, NOTIFICATION-TYPE,
skipping to change at page 18, line 21 skipping to change at page 17, line 52
RowStatus, RowStatus,
StorageType, StorageType,
TEXTUAL-CONVENTION TEXTUAL-CONVENTION
FROM SNMPv2-TC FROM SNMPv2-TC
MODULE-COMPLIANCE, MODULE-COMPLIANCE,
OBJECT-GROUP, OBJECT-GROUP,
NOTIFICATION-GROUP NOTIFICATION-GROUP
FROM SNMPv2-CONF; FROM SNMPv2-CONF;
ippmReportingMib MODULE-IDENTITY ippmReportingMib MODULE-IDENTITY
LAST-UPDATED "200310141200Z" -- 14 October 2003 LAST-UPDATED "200402121200Z" -- 12 February 2004
ORGANIZATION "France Telecom - R&D" ORGANIZATION "France Telecom - R&D"
CONTACT-INFO CONTACT-INFO
"Emile Stephan "Emile Stephan
France Telecom - R&D France Telecom - R&D
2, Avenue Pierre Marzin 2, Avenue Pierre Marzin
Technopole Anticipa Technopole Anticipa
22307 Lannion Cedex 22307 Lannion Cedex
FRANCE FRANCE
Tel: + 33 2 96 05 36 10 Tel: + 33 2 96 05 36 10
E-mail: emile.stephan@francetelecom.com E-mail: emile.stephan@francetelecom.com
skipping to change at page 19, line 4 skipping to change at page 18, line 34
reporting of measurement results." reporting of measurement results."
REVISION "200210181200Z" -- 18 October 2002 REVISION "200210181200Z" -- 18 October 2002
DESCRIPTION DESCRIPTION
"General cleanup "General cleanup
Change 5 tables to read write" Change 5 tables to read write"
REVISION "200302141200Z" -- 14 February 2003 REVISION "200302141200Z" -- 14 February 2003
DESCRIPTION DESCRIPTION
"Modifications based upon feedback from IETF-55" "Modifications based upon feedback from IETF-55"
REVISION "200306291200Z" -- 29 June 2003 REVISION "200306291200Z" -- 29 June 2003
DESCRIPTION DESCRIPTION
"Adaptation to VACM, preparation of the final version" "Adaptation to VACM, preparation of the final version"
REVISION "200310241200Z" -- 24 October 2003 REVISION "200310241200Z" -- 24 October 2003
DESCRIPTION DESCRIPTION
"Modifications based upon feedback from experimental "Modifications based upon feedback from experimental
implementation." implementation."
REVISION "200402121200Z" -- 12 February 2004
DESCRIPTION
"Modifications based upon feedback 58th IETF: The report group
and the corresponding notification are removed."
::= { experimental 10001 } -- XXX to be assigned by IANA ::= { experimental 10001 } -- XXX to be assigned by IANA
ippm OBJECT IDENTIFIER ::= { experimental 10000 } ippm OBJECT IDENTIFIER ::= { experimental 10000 }
-- --
-- TEXTUAL-CONVENTION -- TEXTUAL-CONVENTION
-- --
IppmOwnerString ::= TEXTUAL-CONVENTION IppmOwnerString ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An OwnerString. The length is limited to 32 bytes." "The owner namespace is defined in the INDEX of a table as a
couple of 2 objects where the type of the first one is
IppmOwnerString and the type of the second is IppmOwnerIndex.
IppmOwnerString is an OwnerString which length is limited to 32
bytes."
SYNTAX OCTET STRING (SIZE (0..32)) SYNTAX OCTET STRING (SIZE (0..32))
IppmOwnerIndex ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The owner namespace is defined in the INDEX of a table as a
couple of 2 objects where the type of first one is
IppmOwnerString and the type of the second is IppmOwnerIndex.
An object of type IppmOwnerIndex uniquely identifies a row of a
table inside an owner namespace.
Inside one namespace several objects of type IppmOwnerIndex
coexist and share the IppmOwnerIndex range of values to provide a
unique instance identifier.
"
SYNTAX Unsigned32 (1.. 65535)
TimeUnit ::= TEXTUAL-CONVENTION TimeUnit ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A enumerated list of time units." "A enumerated list of time units."
SYNTAX INTEGER { SYNTAX INTEGER {
week(1), week(1),
day(2), day(2),
hour(3), hour(3),
minute(4), minute(4),
second(5), second(5),
skipping to change at page 20, line 18 skipping to change at page 20, line 18
The first bit of the string has the index 0. The index 1 The first bit of the string has the index 0. The index 1
corresponds to the first metric of the registry corresponds to the first metric of the registry
(instantaneousUnidirectionalConnectivity ). (instantaneousUnidirectionalConnectivity ).
Example: Example:
One-way-Delay(6) is identified as the leaf number 6 of the node One-way-Delay(6) is identified as the leaf number 6 of the node
rfc of the registry. One-way-Packet-Loss(12) is identified as the rfc of the registry. One-way-Packet-Loss(12) is identified as the
leaf number 12 of the node leaf number 12 of the node
rfc of the registry. A network measure performing both One-way- rfc of the registry. A network measure performing both One-way-
Delay(6) and One-way-Packet-Loss(12) will be described as Delay(6) and One-way-Packet-Loss(12) will be described as
'0000001000001000'b, '1040'B. '0001000001000000'b, '1040'B.
" "
SYNTAX OCTET STRING (SIZE (1..64)) SYNTAX OCTET STRING (SIZE (1..64))
IppmMetricsRegistryIndex ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"IppmMetricsRegistryIndex defines an unambiguous index for each
standardized metric. It identifies a metric, and as such its
value is the value of the node of the metric in the IPPM
registry. This value is the same in any implementation of the
IPPM REPORTING MIB.
Example:
In the IPPM-METRICS-REGISTRY, onewayPacketLossAverage is
registered as the node 14 of ippmMetricsRegistry.metrics.rfc.
Consequently the index of the metric onewayPacketLossAverage in
the IppmMetricsTable will always be '14'. At large an instance,
which type is IppmMetricsRegistryIndex and which value is '14',
points to the metric onewayPacketLossAverage."
SYNTAX Unsigned32 (1.. 65535)
GMTTimeStamp ::= TEXTUAL-CONVENTION GMTTimeStamp ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time value at which a specific occurrence took place. The "The time value at which a measure or an event took place.
specific occurrence must be defined in the description of any
object defined using this type.
field octets contents range field octets contents range
----- ------ -------- ----- ----- ------ -------- -----
1 1-4 second since 1 Jan 2000 0H00* 0..2^31 - 1 1 1-4 second since 1 Jan 1900 0H00* 0..2^31 - 1
2 5-8 fractional part of the second* 0..2^32 - 1 2 5-8 fractional part of the second* 0..2^32 - 1
* the value is in network-byte order * the value is in network-byte order
The timestamp format is directly inspired from the NTP timestamp The timestamp format is the NTP timestamp format [RFC 1305].
format. The reference of time is GMT.
It differs in that it counts the seconds since 1 Jan 2000 0H00
instead of 1 Jan 1900 0H00. The most significant bit of the part
that represents the second is reserved. It will wrap in year 2068
(The NTP timestamp will wrap in year 2036).
This bit is set to indicate if the fractional part of the second
contains a precision field and a synchronization field as
initially proposed in the OWAMP draft.
When this bit is not set, the resolution is maximal.
The maximal resolution is close to 250 picoseconds.
The precision of the timestamp must be provided in another field.
" "
SYNTAX OCTET STRING (SIZE (8)) SYNTAX OCTET STRING (SIZE (8))
TypeP ::= TEXTUAL-CONVENTION PacketType ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This textual convention is a display string used to describe the "This textual convention is a display string used to describe the
protocol encapsulation list of a packet, and is used as the value protocol encapsulation list of a packet, and is used as the value
of the SYNTAX clause for the type of the Src and Dst of an IPPM of the SYNTAX clause for the type of the Src and Dst of an IPPM
measure. The RFC2895 specifies a macro named PROTOCOL-IDENTIFIER measure. The RFC2895 specifies a macro named PROTOCOL-IDENTIFIER
for the definition of protocol identifiers, while its companion for the definition of protocol identifiers, while its companion
document, the RFC2896 defines a set of protocol identifiers. document, the RFC2896 defines a set of protocol identifiers.
TypeP is defined as a display string. It consists of a list of PacketType is defined as a display string. It consists of a list
dot separated protocol names. Each protocol name has been of dot separated protocol names. Each protocol name has been
previously defined using the macro PROTOCOL-IDENTIFIER of the RFC previously defined using the macro PROTOCOL-IDENTIFIER of the RFC
2895. 2895.
Examples: Examples:
The RFC2896 defines the protocol identifiers 'ether2', 'ip', The RFC2896 defines the protocol identifiers 'ether2', 'ip',
'ipip4', 'udp', 'tcp', 'telnet'... 'ipip4', 'udp', 'tcp', 'telnet'...
The TypeP of the source address corresponding to telnet is the The PacketType of the source address corresponding to telnet is
string 'ip.tcp.telnet'. the string 'ip.tcp.telnet'.
The TypeP of the source address corresponding to UDP packets sent The PacketType of the source address corresponding to UDP packets
in an IP tunnel is the string 'ip.ipip4.udp'. sent in an IP tunnel is the string 'ip.ipip4.udp'.
Note: Note:
An IPPM measure is active, so generally a TypeP value does not An IPPM measure is active, so generally a PacketType value does
describe the link layer (i.e. ether2...). Valid Internet packets not describe the link layer (i.e. ether2...). Valid Internet
are sent from Src to Dst. Then the choice of the link layer packets are sent from Src to Dst. Then the choice of the link
relies on the Internet stack." layer relies on the Internet stack."
SYNTAX OCTET STRING (SIZE (0..512)) SYNTAX OCTET STRING (SIZE (0..512))
TypePaddress ::= TEXTUAL-CONVENTION PacketTypeAddress ::= TEXTUAL-CONVENTION
DISPLAY-HINT "255a" DISPLAY-HINT "255a"
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This textual convention is a Display string used to describe the "This textual convention is a Display string used to describe the
parameters of the protocol encapsulation list of a packet, parameters of the protocol encapsulation list of a packet,
basically the address. basically the address.
TypePaddress is defined as a display string. It consists in a PacketTypeAddress is defined as a display string. It consists in
list of blank separated addresses that reflect the encapsulation a list of blank separated addresses that reflect the
of the TypeP. Each parameter in the list corresponds to a encapsulation of the PacketType. Each parameter in the list
parameter of a PROTOCOL-IDENTIFIER of the TypeP. corresponds to a parameter of a PROTOCOL-IDENTIFIER of the
PacketType.
Example: Example:
The TypeP 'ip.ipip4' has 2 parameters. A valid TypePaddress value
is '192.168.1.1 128.2.6.7'." The PacketType 'ip.ipip4' has 2 parameters. A valid
PacketTypeAddress value is '192.168.1.1 128.2.6.7'."
SYNTAX OCTET STRING (SIZE (0..512)) SYNTAX OCTET STRING (SIZE (0..512))
IppmReportDefinition ::= TEXTUAL-CONVENTION IppmMetricResultFilter ::= TEXTUAL-CONVENTION
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" A report definition is a list of statements describing a report. A " Given that not all results from a metric measurement are
statement is part of this process if a corresponding bit in the pertinent, and that the size of the history must be limited whenever
definition is set to '1'. For all bit values that are set to one, a possible, the TC IppmMetricResultFilter defines basic filters to
report will be generated. limit the among of data collected:
The report process uses results saved in the history table. Threshold
values are provided by the report setup.
Given that not all results from a metric measurement are
pertinent to a particular report, and that the size of the report
must be limited whenever possible, the guidelines for the definition
of a report are as follows:
+ Select the events for consideration (1);
+ Configure filters to select pertinent values (2);
+ Describe the way the report is delivered (3);
+ Describe clean up actions to perform on report completion (4);
-1- events
Events determine when a report is processed. Events are
exclusive. The possible values are:
onSingleton:
The report is processed each time a new result of the measurement
occurs.
onMeasureCycle:
The report is processed each time a cycle of measure is
completed.
onMeasureCompletion:
The report is processed at the end of the measurement.
-2- filters
Filters determine if a result belongs to a report.
ReportInBandResults and ReportOutBandResults are exclusive. The
usage of ReportInBandResults and ReportOutBandResults exclude the
usage of ReportAboveResults and ReportBelowResults.
Possible values are:
reportUpAndDownResults:
Report contiguous results that are on opposite sides of
the up and down metric threshold.
ReportInBandResults:
Report results lower than the high metric threshold
field of the report setup and greater than the low
metric threshold field of the report setup.
ReportOutBandResults:
Report results greater than the high metric threshold
field of the report setup or lower than the low metric
threshold field of the report setup.
ReportAboveResults:
Report results greater than the high metric threshold
field of the report setup.
ReportBelowResults:
Report results lower than the low metric threshold field
of the report setup.
reportExceededEventsDuration:
Save the results of the metric only if the current
filter triggers repeatedly for a series of contiguous
results during more than
ippmReportSetupDurationThreshold seconds.
-3- deliver Filter's parameters are the 2 fields ippmAggrMeasureLowThreshold and
ippmAggrMeasureLowThreshold of the aggregated measure setup.
Even though report delivery statements are not exclusive, care A filter determines if the result of the current aggregation has to
should be taken to limit the number of report methods to 2. The be stored:
delivery methods are:
inIppmReportTable: LogInBandValue:
Store the report in the local ippmReportTable. The value is stored if it is lower than the high threshold of
NOTE WELL: Results are not stored in the report table if the aggregated measure setup and greater than the low
this flag is not set. threshold of of the aggregated measure setup.
inSNMPv2TrapPDU: LogOutBandValue:
Send the report using a SNMPv2-Trap-PDU. The value is stored if it is greater than the high threshold
of the aggregated measure setup or lower than the low
threshold of the aggregated measure setup.
inInformRequestPDU: LogAboveValue:
Send the report using a SNMP InformRequest-PDU. The value is stored if it is greater than the high threshold
of the aggregated measure setup.
inEmail: LogBelowValue:
Send the report using an email. The value is stored if it is lower than the low metric
threshold field of the aggregated measure setup.
inSMS: logUpAndDownValue:
Send the report using a SMS. This filter stores contiguous results that are on opposite
sides of the up and down metric thresholds:
A result is stored if it is the first result aggregated:
If it is greater than the high threshold and lower than the
low threshold then its value is set to the value of the low
threshold;
-4- Cleanup A result greater than the high threshold is stored if the
onReportDeliveryClearReport(12): previous result is lower than the low threshold;
Remove all the results corresponding to this measure A result lower than the low threshold is stored if the
from the ippmReportTable when the report has been previous result is greater than the high threshold;
delivered. This must be set in conjunction with
inIppmReportTable, and onMeasureCompletion.
" "
SYNTAX BITS { SYNTAX INTEGER {
none(0), -- reserved logInBandValue(1),
onSingleton(1), logOutBandValue(2),
onMeasureCycle(2), logAboveValue(3),
onMeasureCompletion(3), logBelowValue(4),
reportUpAndDownResults(4), logUpAndDownValue(5)
reportInBandResults(5),
reportOutBandResults(6),
reportAboveResults(7),
reportBelowResults(8),
reportExceededEventsDuration(9),
inIppmReportTable(10),
inSNMPv2TrapPDU(11),
inInformRequestPDU(12),
inEmail(13),
inSMS(14),
onReportDeliveryClearReport(15)
} }
-- --
-- IPPM Notifications -- IPPM Notifications
-- --
ippmNotifications OBJECT IDENTIFIER ::= { ippm 0 } ippmNotifications OBJECT IDENTIFIER ::= { ippm 0 }
-- --
-- IPPM Conformance -- IPPM Conformance
-- --
ippmConformance OBJECT IDENTIFIER ::= { ippm 1 } ippmConformance OBJECT IDENTIFIER ::= { ippm 1 }
-- --
-- IPPM MIB Object definitions -- IPPM MIB Object definitions
-- --
ippmSystem OBJECT IDENTIFIER ::= { ippmReportingMib 1 } ippmSystem OBJECT IDENTIFIER ::= { ippmReportingMib 1 }
ippmOwners OBJECT IDENTIFIER ::= { ippmReportingMib 2 } ippmOwners OBJECT IDENTIFIER ::= { ippmReportingMib 2 }
ippmHistory OBJECT IDENTIFIER ::= { ippmReportingMib 3 } ippmHistory OBJECT IDENTIFIER ::= { ippmReportingMib 3 }
ippmMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 4 } ippmNetMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 4 }
ippmReport OBJECT IDENTIFIER ::= { ippmReportingMib 5 } ippmAggrMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 5 }
-- --
-- ippmSystem Group -- ippmSystem Group
-- --
-- --
ippmSystemTime OBJECT-TYPE ippmSystemTime OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
skipping to change at page 26, line 31 skipping to change at page 25, line 15
unknown(0), unknown(0),
up(1), up(1),
down(2) down(2)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object describes the status of the system running the IPPM "This object describes the status of the system running the IPPM
REPORTING MIB SNMP agent. It does not describe end point measurement REPORTING MIB SNMP agent. It does not describe end point measurement
status. status.
unknown(0) unknown(0) means the service is unknown.
up(1) means service is operational and available for general use. up(1) means the service is operational and available for general
use.
down(2) means the agent is not available for use. down(2) means the agent is not available for use.
" "
::= { ippmSystem 5 } ::= { ippmSystem 5 }
ippmSystemAggregatedMetrics OBJECT-TYPE
SYNTAX IppmStandardMetrics
MAX-ACCESS read-only
STATUS current
DESCRIPTION
" ippmSystemAggregatedMetrics lists the aggregated metrics that
are performed in the SNMP agent instead of in the point of
measure."
::= { ippmSystem 6 }
ippmSynchronizationTable OBJECT-TYPE ippmSynchronizationTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmSynchronizationEntry SYNTAX SEQUENCE OF IppmSynchronizationEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table registers the event related to the synchronization of "This table registers the event related to the synchronization of
the points of measure. Each event is described in an the points of measure. Each event is described in an
ippmSynchronizationEntry. ippmSynchronizationEntry.
ippmSynchronizationTable is mandatory. ippmSynchronizationTable is mandatory.
ippmSynchronizationTable content is read only." ippmSynchronizationTable content is read only."
::= { ippmSystem 6 } ::= { ippmSystem 7 }
ippmSynchronizationEntry OBJECT-TYPE ippmSynchronizationEntry OBJECT-TYPE
SYNTAX IppmSynchronizationEntry SYNTAX IppmSynchronizationEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry describes a modification of the synchronization status. "An entry describes a modification of the synchronization
" status."
INDEX { ippmPointOfMeasureIndex, ippmSynchronizationIndex } INDEX { ippmPointOfMeasureIndex, ippmSynchronizationIndex }
::= { ippmSynchronizationTable 1 } ::= { ippmSynchronizationTable 1 }
IppmSynchronizationEntry ::= IppmSynchronizationEntry ::=
SEQUENCE { SEQUENCE {
ippmSynchronizationIndex Unsigned32, ippmSynchronizationIndex Unsigned32,
ippmSynchronizationTime GMTTimeStamp, ippmSynchronizationTime GMTTimeStamp,
ippmSynchronizationStratum Unsigned32, ippmSynchronizationStratum Unsigned32,
ippmSynchronizationResolution Unsigned32 ippmSynchronizationResolution Unsigned32
} }
ippmSynchronizationIndex OBJECT-TYPE ippmSynchronizationIndex OBJECT-TYPE
SYNTAX Unsigned32 (1 .. 65535) SYNTAX Unsigned32 (1 .. 65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An index that identifies the synchronization events in "An index that identifies the synchronization events in
chronological order." chronological order.
65535 is an arbitrary size. It is not recommended to keep
permanently a history of 65535 events."
::= { ippmSynchronizationEntry 1 } ::= { ippmSynchronizationEntry 1 }
ippmSynchronizationTime OBJECT-TYPE ippmSynchronizationTime OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time when the synchronization event occurs." "The time when the synchronization event occurs."
::= { ippmSynchronizationEntry 2 } ::= { ippmSynchronizationEntry 2 }
skipping to change at page 28, line 22 skipping to change at page 27, line 19
It is the list of the measurement end points of the set of probes It is the list of the measurement end points of the set of probes
for which the IPPM agent provides an SNMP interface. for which the IPPM agent provides an SNMP interface.
IPPM MIB implemented in a probe: IPPM MIB implemented in a probe:
It is the list of the measurement end points of the probe. It is the list of the measurement end points of the probe.
The ippmPointOfMeasureTable content is read only. This implies The ippmPointOfMeasureTable content is read only. This implies
that the measurement software handles the table internally that the measurement software handles the table internally
ippmPointOfMeasureTable is mandatory." ippmPointOfMeasureTable is mandatory."
::= { ippmSystem 7 } ::= { ippmSystem 8 }
ippmPointOfMeasureEntry OBJECT-TYPE ippmPointOfMeasureEntry OBJECT-TYPE
SYNTAX IppmPointOfMeasureEntry SYNTAX IppmPointOfMeasureEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" An entry may be the management address of some middleware in " An entry may be the management address of some middleware in
charge of the management of a set of probes. It may the charge of the management of a set of probes. It may the
management address of a probe that contains several line cards. management address of a probe that contains several line cards.
An entry describes the capability of a point of measure. The An entry describes the capability of a point of measure.
description may make the use of wildcards to define multiple
capabilities." ippmPointOfMeasureMetrics lists the metrics handles by the point
of measure."
INDEX { ippmPointOfMeasureIndex } INDEX { ippmPointOfMeasureIndex }
::= { ippmPointOfMeasureTable 1 } ::= { ippmPointOfMeasureTable 1 }
IppmPointOfMeasureEntry ::= SEQUENCE { IppmPointOfMeasureEntry ::= SEQUENCE {
ippmPointOfMeasureIndex Unsigned32, ippmPointOfMeasureIndex Unsigned32,
ippmPointOfMeasureMgmtAddrType InetAddressType, ippmPointOfMeasureMgmtAddrType InetAddressType,
ippmPointOfMeasureMgmtAddress InetAddress, ippmPointOfMeasureMgmtAddress InetAddress,
ippmPointOfMeasureTestAddrTypeP TypeP, ippmPointOfMeasureTestAddrType InetAddressType,
ippmPointOfMeasureTestAddr TypePaddress, ippmPointOfMeasureTestAddress InetAddress,
ippmPointOfMeasureMetrics IppmStandardMetrics ippmPointOfMeasureMetrics IppmStandardMetrics
} }
ippmPointOfMeasureIndex OBJECT-TYPE ippmPointOfMeasureIndex OBJECT-TYPE
SYNTAX Unsigned32 (1 .. 65535) SYNTAX Unsigned32 (1 .. 65535)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A local index that identifies an entry in the point of measure "A local index that identifies an entry in the point of measure
table." table."
skipping to change at page 29, line 24 skipping to change at page 28, line 22
::= { ippmPointOfMeasureEntry 2 } ::= { ippmPointOfMeasureEntry 2 }
ippmPointOfMeasureMgmtAddress OBJECT-TYPE ippmPointOfMeasureMgmtAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (1..128)) SYNTAX InetAddress (SIZE (1..128))
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The management address on the point of measure" "The management address on the point of measure"
::= { ippmPointOfMeasureEntry 3 } ::= { ippmPointOfMeasureEntry 3 }
ippmPointOfMeasureTestAddrTypeP OBJECT-TYPE ippmPointOfMeasureTestAddrType OBJECT-TYPE
SYNTAX TypeP SYNTAX InetAddressType
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines the address type of the measurement interface of the "Defines the address type of the measurement interface of the
point of measure." point of measure."
::= { ippmPointOfMeasureEntry 4 } ::= { ippmPointOfMeasureEntry 4 }
ippmPointOfMeasureTestAddr OBJECT-TYPE ippmPointOfMeasureTestAddress OBJECT-TYPE
SYNTAX TypePaddress SYNTAX InetAddress
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the address of the measurement interface for the point "Specifies the address of the measurement interface for the point
of measure." of measure."
::= { ippmPointOfMeasureEntry 5} ::= { ippmPointOfMeasureEntry 5}
ippmPointOfMeasureMetrics OBJECT-TYPE ippmPointOfMeasureMetrics OBJECT-TYPE
SYNTAX IppmStandardMetrics SYNTAX IppmStandardMetrics
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Metrics supported by this point of measure." " ippmPointOfMeasureMetrics lists the metrics this point of
measure implements."
::= { ippmPointOfMeasureEntry 6 } ::= { ippmPointOfMeasureEntry 6 }
ippmMetricTable OBJECT-TYPE ippmMetricsTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmMetricEntry SYNTAX SEQUENCE OF IppmMetricsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This table is mandatory. It describes the current "This table is mandatory. It describes the current
implementation. Each IPPM standardized metric must be described implementation. Each IPPM standardized metric must be described
in the table. in the table.
ippmMetricTable content is read only." ippmMetricsTable content is read only."
::= { ippmSystem 8 } ::= { ippmSystem 9 }
ippmMetricEntry OBJECT-TYPE ippmMetricsEntry OBJECT-TYPE
SYNTAX IppmMetricEntry SYNTAX IppmMetricsEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry describes the static capabilities of a metric "An entry describes the static capabilities of a metric
implementation." implementation."
INDEX { ippmMetricIndex } INDEX { ippmMetricsIndex }
::= { ippmMetricTable 1 } ::= { ippmMetricsTable 1 }
IppmMetricEntry ::= IppmMetricsEntry ::=
SEQUENCE { SEQUENCE {
ippmMetricIndex Unsigned32, ippmMetricsIndex IppmMetricsRegistryIndex,
ippmMetricCapabilities INTEGER, ippmMetricsType INTEGER,
ippmMetricType INTEGER, ippmMetricsUnit INTEGER,
ippmMetricUnit INTEGER, ippmMetricsDescription SnmpAdminString
ippmMetricDescription SnmpAdminString
} }
ippmMetricIndex OBJECT-TYPE ippmMetricsIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535) SYNTAX IppmMetricsRegistryIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"ippmMetricIndex defines an unambiguous index for each "ippmMetricsIndex defines an unambiguous index for each
standardized metric. It identifies a metric, and as such its standardized metric. It identifies a metric, and as such its
value is the value of the node of the metric in an IPPM registry. value is the value of the node of the metric in the IPPM
This value is the same in any implementation of the IPPM registry. This value is the same in any implementation of the
REPORTING MIB. IPPM REPORTING MIB.
Example: Example:
In the IPPM-METRICS-REGISTRY, onewayPacketLossAverage is In the IPPM-METRICS-REGISTRY, onewayPacketLossAverage is
registered as the node 14 of ippmMetricsRegistry.metrics.rfc. registered as the node 14 of ippmMetricsRegistry.metrics.rfc.
Consequently the index of the metric onewayPacketLossAverage in Consequently the index of the metric onewayPacketLossAverage in
the IppmMetricTable will always be '14'" the IppmMetricsTable will always be '14'"
::= { ippmMetricEntry 1 } ::= { ippmMetricsEntry 1 }
ippmMetricCapabilities OBJECT-TYPE
SYNTAX INTEGER {
notImplemented(0),
implemented(1)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A value of notImplemented implies the metric is not implemented.
A value of implemented implies the metric is implemented either
in the proxy or the point of measure itself.
Example: if the aggregated metric is not implemented in the point
of measure it may be implemented in the proxy."
::= { ippmMetricEntry 2 }
ippmMetricType OBJECT-TYPE ippmMetricsType OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
network(0), network(0),
aggregated(1) aggregated(1)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Indicates the metric type, whether it is network or aggregated" "Indicates the metric type, whether it is network or aggregated"
::= { ippmMetricEntry 3 } ::= { ippmMetricsEntry 2 }
ippmMetricUnit OBJECT-TYPE ippmMetricsUnit OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
noUnit(0), noUnit(0),
second(1), second(1),
millisecond(2), millisecond(2),
microsecond(3), microsecond(3),
nanosecond(4), nanosecond(4),
percentage(5), percentage(5),
packet(6), packet(6),
byte(7), byte(7),
kilobyte(8), kilobyte(8),
megabyte(9) megabyte(9)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The unit used in the current entity for the results of the "The unit used in the current entity for the results of the
measurement of this metric." measurement of this metric."
::= { ippmMetricEntry 4 } ::= { ippmMetricsEntry 3 }
ippmMetricDescription OBJECT-TYPE ippmMetricsDescription OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A textual description of the metric implementation following the "A textual description of the metric implementation following the
exact name of this metric in the registry. For example: exact name of this metric in the registry. For example:
oneWayDelay: OWD Metric ." oneWayDelay: OWD Metric ."
::= { ippmMetricEntry 5 } ::= { ippmMetricsEntry 4 }
-- --
-- ippmOwners Group -- ippmOwners Group
-- --
-- The ippmOwners objects are responsible for managing -- The ippmOwners objects are responsible for managing
-- the owners access to the measurements. -- the owners access to the measurements.
-- --
-- --
ippmOwnersTable OBJECT-TYPE ippmOwnersTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmOwnersEntry SYNTAX SEQUENCE OF IppmOwnersEntry
skipping to change at page 32, line 33 skipping to change at page 31, line 16
ippmOwnersEntry OBJECT-TYPE ippmOwnersEntry OBJECT-TYPE
SYNTAX IppmOwnersEntry SYNTAX IppmOwnersEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The description of the resources granted to an SNMP application. "The description of the resources granted to an SNMP application.
For example, an instance of ippmOwnersOwner with an For example, an instance of ippmOwnersOwner with an
IppmOwnerString 'acme', which represents the 14th owner created IppmOwnerString 'acme', which represents the 14th owner created
in ippmOwnersTable would be named ippmOwnersEntryOwner.14. in ippmOwnersTable would be named ippmOwnersEntryOwner.14.
"
Notes: INDEX { ippmOwnersOwner }
The ippmOwnersIndex value is a local index managed directly by
the agent. The management application must poll to get the next
available index value.
It is not used in anyway in other IPPM tables."
INDEX { ippmOwnersIndex }
::= { ippmOwnersTable 1 } ::= { ippmOwnersTable 1 }
IppmOwnersEntry ::= SEQUENCE { IppmOwnersEntry ::= SEQUENCE {
ippmOwnersIndex Unsigned32,
ippmOwnersOwner IppmOwnerString, ippmOwnersOwner IppmOwnerString,
ippmOwnersGrantedMetrics IppmStandardMetrics, ippmOwnersGrantedMetrics IppmStandardMetrics,
ippmOwnersQuota Unsigned32, ippmOwnersQuota Unsigned32,
ippmOwnersIpAddressType InetAddressType, ippmOwnersIpAddressType InetAddressType,
ippmOwnersIpAddress InetAddress, ippmOwnersIpAddress InetAddress,
ippmOwnersEmail SnmpAdminString, ippmOwnersEmail SnmpAdminString,
ippmOwnersSMS SnmpAdminString,
ippmOwnersStatus RowStatus ippmOwnersStatus RowStatus
} }
ippmOwnersIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary index that identifies an entry in the owners
table."
::= { ippmOwnersEntry 1 }
ippmOwnersOwner OBJECT-TYPE ippmOwnersOwner OBJECT-TYPE
SYNTAX IppmOwnerString SYNTAX IppmOwnerString
MAX-ACCESS read-create MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The owner described by this entry." "The owner described by this entry."
::= { ippmOwnersEntry 2 } ::= { ippmOwnersEntry 1 }
ippmOwnersGrantedMetrics OBJECT-TYPE ippmOwnersGrantedMetrics OBJECT-TYPE
SYNTAX IppmStandardMetrics SYNTAX IppmStandardMetrics
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" Defines the metrics granted to an owner for which measurements " Defines the metrics granted to an owner for which measurements
can be performed." can be performed."
::= { ippmOwnersEntry 3 } ::= { ippmOwnersEntry 2 }
ippmOwnersQuota OBJECT-TYPE ippmOwnersQuota OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" The maximum number of records that this owner may have in the " The maximum number of records that this owner may have in the
history table and in the report table." history table and in the report table."
::= { ippmOwnersEntry 4 } ::= { ippmOwnersEntry 3 }
ippmOwnersIpAddressType OBJECT-TYPE ippmOwnersIpAddressType OBJECT-TYPE
SYNTAX InetAddressType SYNTAX InetAddressType
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address type of the management entity corresponding to "The IP address type of the management entity corresponding to
this owner. this owner.
InetAddressType is restricted to ipv4(1),ipv6(2)and dns(16). " InetAddressType is restricted to ipv4(1),ipv6(2)and dns(16). "
::= { ippmOwnersEntry 5 } ::= { ippmOwnersEntry 4 }
ippmOwnersIpAddress OBJECT-TYPE ippmOwnersIpAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (1..128)) SYNTAX InetAddress (SIZE (1..128))
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IP address of the management entity corresponding to this "The IP address of the management entity corresponding to this
owner. For example, the IP address of the management console used owner. For example, the IP address of the management console used
to send SNMP requests." to send SNMP requests."
::= { ippmOwnersEntry 6 } ::= { ippmOwnersEntry 5 }
ippmOwnersEmail OBJECT-TYPE ippmOwnersEmail OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The email address of the management entity corresponding to this "The email address of the management entity corresponding to this
owner." owner."
::= { ippmOwnersEntry 7 } ::= { ippmOwnersEntry 6 }
ippmOwnersSMS OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The SMS phone number of the management entity corresponding to
this owner."
::= { ippmOwnersEntry 8 }
ippmOwnersStatus OBJECT-TYPE ippmOwnersStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this table entry. Once this status is set to "The status of this table entry. Once this status is set to
active, the corresponding entry in the table may not be active, the corresponding entry in the table may not be
modified." modified."
::= { ippmOwnersEntry 9 } ::= { ippmOwnersEntry 7 }
-- --
-- ippmHistory Group
-- --
-- --
-- ippmHistoryTable -- ippmHistoryTable
-- --
ippmHistoryTable OBJECT-TYPE ippmHistoryTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmHistoryEntry SYNTAX SEQUENCE OF IppmHistoryEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The table containing the measurement results." "The table containing the measurement results."
skipping to change at page 35, line 23 skipping to change at page 33, line 27
In the index : In the index :
+ ippmHistoryMeasureOwner identifies the owner of the measure; + ippmHistoryMeasureOwner identifies the owner of the measure;
+ ippmHistoryMeasureIndex identifies the measure in the owner + ippmHistoryMeasureIndex identifies the measure in the owner
namespace; namespace;
+ ippmHistoryMetricIndex identifies the metric measured by the + ippmHistoryMetricIndex identifies the metric measured by the
measure. The metric is described in the corresponding entry of measure. The metric is described in the corresponding entry of
the ippmMetricTable; the ippmMetricsTable;
+ ippmHistorySeqence is the sequence number of the measurement + ippmHistorySequence is the sequence number of the measurement
result for an entry in the history table." result for an entry in the history table."
INDEX { ippmHistoryMeasureOwner, ippmHistoryMeasureIndex, INDEX { ippmHistoryMeasureOwner, ippmHistoryMeasureIndex,
ippmHistoryMetricIndex, ippmHistorySequence } ippmHistoryMetricIndex, ippmHistorySequence }
::= { ippmHistoryTable 1 } ::= { ippmHistoryTable 1 }
IppmHistoryEntry ::= IppmHistoryEntry ::=
SEQUENCE { SEQUENCE {
ippmHistoryMeasureOwner IppmOwnerString, ippmHistoryMeasureOwner IppmOwnerString,
ippmHistoryMeasureIndex Unsigned32, ippmHistoryMeasureIndex IppmOwnerIndex,
ippmHistoryMetricIndex Unsigned32, ippmHistoryMetricIndex IppmMetricsRegistryIndex,
ippmHistorySequence Unsigned32, ippmHistorySequence Unsigned32,
ippmHistoryTimestamp GMTTimeStamp, ippmHistoryTimestamp GMTTimeStamp,
ippmHistoryValue Integer32 ippmHistoryValue Integer32
} }
ippmHistoryMeasureOwner OBJECT-TYPE ippmHistoryMeasureOwner OBJECT-TYPE
SYNTAX IppmOwnerString SYNTAX IppmOwnerString
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The owner of the measure that produced this result." "The owner of the measure that produced this result. The measure
is either an ippmNetMeasure or an ippmAggrMeasure."
::= { ippmHistoryEntry 1 } ::= { ippmHistoryEntry 1 }
ippmHistoryMeasureIndex OBJECT-TYPE ippmHistoryMeasureIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535) SYNTAX IppmOwnerIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" The owner index of the measure that produced this result." "The owner index of the measure that produced this result. The
measure is either an entry of the ippmNetMeasureTable or of the
ippmAggrMeasureTable."
::= { ippmHistoryEntry 2 } ::= { ippmHistoryEntry 2 }
ippmHistoryMetricIndex OBJECT-TYPE ippmHistoryMetricIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535) SYNTAX IppmMetricsRegistryIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" ippmHistoryMetricIndex identifies the metric measured by the " ippmHistoryMetricIndex identifies the metric measured by the
measure. The metric is described in the corresponding entry of measure. The metric is described in the corresponding entry of
the ippmMetricTable." the ippmMetricsTable."
::= { ippmHistoryEntry 3 } ::= { ippmHistoryEntry 3 }
ippmHistorySequence OBJECT-TYPE ippmHistorySequence OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295) SYNTAX Unsigned32 (0..4294967295)
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"ippmHistorySequence is the sequence number of the measurement "ippmHistorySequence is the sequence number of the measurement
results for a metric. results for a metric.
Network metrics: Network metrics:
It's the sequence number of a measurement packet. Typically, it It's the sequence number of a measurement packet. Typically, it
identifies the order of the packet in the stream of packets sent identifies the order of the packet in the stream of packets sent
by the source. by the source.
Aggregated metrics: Aggregated metrics:
It is the sequence number of the computed aggregated metric It is the sequence order of the aggregation computed."
result."
::= { ippmHistoryEntry 4 } ::= { ippmHistoryEntry 4 }
ippmHistoryTimestamp OBJECT-TYPE ippmHistoryTimestamp OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The timestamp when the measurement occurred." "The timestamp when the measurement occurred."
::= { ippmHistoryEntry 5 } ::= { ippmHistoryEntry 5 }
ippmHistoryValue OBJECT-TYPE ippmHistoryValue OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The observed value of the measurement." "The observed value of the measurement."
::= { ippmHistoryEntry 6 } ::= { ippmHistoryEntry 6 }
ippmHistoryPathToResults OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"It is typically an URL describing the file location where bulk
results are logged."
::= { ippmHistory 2 }
-- --
-- ippmNetMeasure Group
-- --
-- --
-- ippmNetMeasureTable -- ippmNetMeasureTable
-- --
-- --
ippmNetMeasureTable OBJECT-TYPE ippmNetMeasureTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmNetMeasureEntry SYNTAX SEQUENCE OF IppmNetMeasureEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"An entry is a measurement that performs network measures and "An entry is a measurement that performs network measures and
provides results. provides results.
It performs several metric measurements per packet exchange. Each It performs several metric measurements per packet exchange. Each
step of a measure produces a singleton result per metric. The step of a measure produces a singleton result per metric. The
time of the measurement and the value of the metric are saved in time of the measurement and the value of the metric are saved in
the ippmHistoryTable." the ippmHistoryTable."
::= { ippmMeasure 1 } ::= { ippmNetMeasure 1 }
ippmNetMeasureEntry OBJECT-TYPE ippmNetMeasureEntry OBJECT-TYPE
SYNTAX IppmNetMeasureEntry SYNTAX IppmNetMeasureEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" The IppmNetMeasureTable is mandatory, and its content is read " The IppmNetMeasureTable is mandatory, and its content is read
only. It means that the measurement software handles the table only. It means that the measurement software handles the table
internally. The setup of the network measure is not permitted internally. The setup of the network measure is not permitted
through the IPPM REPORTING MIB. As an example, OWAP provides a through the IPPM REPORTING MIB. As an example, OWAP provides a
setup protocol to setup and tear down networks measures. setup protocol to setup and tear down networks measures.
The ippmNetMeasureMetrics is set to a list of metrics to be The ippmNetMeasureMetrics is set to a list of metrics to be
computed from the same raw packet exchange. Each step of computed from the same raw packet exchange. Each step of
measurement delivers a singleton per chosen metric. Results are measurement delivers a singleton per metric. Results are
timestamped and saved in the ippmHistoryTable. timestamped and saved in the ippmHistoryTable.
One may create aggregated measures by using the results of One may create aggregated measures by using the results of
network measures. They may be referenced by their table index network measures."
values. "
INDEX { ippmNetMeasureOwner, ippmNetMeasureIndex } INDEX { ippmNetMeasureOwner, ippmNetMeasureIndex }
::= { ippmNetMeasureTable 1 } ::= { ippmNetMeasureTable 1 }
IppmNetMeasureEntry ::= SEQUENCE { IppmNetMeasureEntry ::= SEQUENCE {
ippmNetMeasureOwner IppmOwnerString, ippmNetMeasureOwner IppmOwnerString,
ippmNetMeasureIndex Unsigned32, ippmNetMeasureIndex IppmOwnerIndex,
ippmNetMeasureName SnmpAdminString, ippmNetMeasureName SnmpAdminString,
ippmNetMeasureMetrics IppmStandardMetrics, ippmNetMeasureMetrics IppmStandardMetrics,
ippmNetMeasureBeginTime GMTTimeStamp, ippmNetMeasureBeginTime GMTTimeStamp,
ippmNetMeasureCollectionRateUnit TimeUnit, ippmNetMeasureCollectionRateUnit TimeUnit,
ippmNetMeasureCollectionRate Unsigned32, ippmNetMeasureCollectionRate Unsigned32,
ippmNetMeasureDurationUnit TimeUnit, ippmNetMeasureDurationUnit TimeUnit,
ippmNetMeasureDuration Unsigned32, ippmNetMeasureDuration Unsigned32,
ippmNetMeasureHistorySize Unsigned32, ippmNetMeasureHistorySize Unsigned32,
ippmNetMeasureFailureMgmtMode INTEGER, ippmNetMeasureFailureMgmtMode INTEGER,
ippmNetMeasureResultsMgmt INTEGER, ippmNetMeasureResultsMgmt INTEGER,
ippmNetMeasureSrcTypeP TypeP, ippmNetMeasureSrcPacketType PacketType,
ippmNetMeasureSrc TypePaddress, ippmNetMeasureSrc PacketTypeAddress,
ippmNetMeasureDstTypeP TypeP, ippmNetMeasureDstPacketType PacketType,
ippmNetMeasureDst TypePaddress, ippmNetMeasureDst PacketTypeAddress,
ippmNetMeasureTxMode INTEGER, ippmNetMeasureTxMode INTEGER,
ippmNetMeasureTxPacketRateUnit TimeUnit, ippmNetMeasureTxPacketRateUnit TimeUnit,
ippmNetMeasureTxPacketRate Unsigned32, ippmNetMeasureTxPacketRate Unsigned32,
ippmNetMeasureMedOrBurstSize Unsigned32, ippmNetMeasureMedOrBurstSize Unsigned32,
ippmNetMeasureDevOrIntBurstSize Unsigned32, ippmNetMeasureDevOrIntBurstSize Unsigned32,
ippmNetMeasureLossTimeout Unsigned32, ippmNetMeasureLossTimeout Unsigned32,
ippmNetMeasureL3PacketSize Unsigned32, ippmNetMeasureL3PacketSize Unsigned32,
ippmNetMeasureDataPattern OCTET STRING, ippmNetMeasureDataPattern OCTET STRING,
ippmNetMeasureMap SnmpAdminString,
ippmNetMeasureTotalPktsRecv Counter64, ippmNetMeasureTotalPktsRecv Counter64,
ippmNetMeasureLastUpdate GMTTimeStamp, ippmNetMeasureLastUpdate GMTTimeStamp,
ippmNetMeasureOperState INTEGER ippmNetMeasureOperState INTEGER
} }
ippmNetMeasureOwner OBJECT-TYPE ippmNetMeasureOwner OBJECT-TYPE
SYNTAX IppmOwnerString SYNTAX IppmOwnerString
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The owner of the network measure." "The owner of the network measure."
::= { ippmNetMeasureEntry 1 } ::= { ippmNetMeasureEntry 1 }
ippmNetMeasureIndex OBJECT-TYPE ippmNetMeasureIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535) SYNTAX IppmOwnerIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The owner index of the network measure." "The owner index of the network measure."
::= { ippmNetMeasureEntry 2 } ::= { ippmNetMeasureEntry 2 }
ippmNetMeasureName OBJECT-TYPE ippmNetMeasureName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The name of the metric instance(s)as defined in "The name of the metric instance(s)as defined in
ippmNetMeasureMetrics. It illustrates the specificity of the ippmNetMeasureMetrics. It illustrates the specificity of the
metric(s) and includes the metric(s) and the TypeP. metric(s) and includes the metric(s) and the PacketType.
Example: Example:
IP-TCP-HTTP-One-way-Delay: free text " IP-TCP-HTTP-One-way-Delay: free text "
::= { ippmNetMeasureEntry 3 } ::= { ippmNetMeasureEntry 3 }
ippmNetMeasureMetrics OBJECT-TYPE ippmNetMeasureMetrics OBJECT-TYPE
SYNTAX IppmStandardMetrics SYNTAX IppmStandardMetrics
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines the metrics to compute within this measure. ONLY network "ippmNetMeasureMetrics defines the metrics to compute within this
metrics of the same type are allowed in this field. measure. Only network metrics of the same type are allowed in
A measure may be configured for the result of different metric this field (e.g. poisson-based metrics and periodic-based metrics
singletons to be archived in the ippmHistoryTable. The are incompatibles, while one-way delay and packet loss are
ippmMetricIndex of the created result has the value of the bit generally processed simultaneously: a very bad delay is
index of the corresponding ippmMeasureMetrics as explained above potentially a very good packet loss).
in the ippmMetricIndex definition.
Results are saved in the ippmHistoryTable. Results of a metric
are identified using an index of type IppmMetricsRegistryIndex.
Example: Example:
A measure asking for One-way-Delay(6) and One-way-Packet-Loss(12) Given a multi-metrics measure of One-way-Delay(6) and One-way-
generated a flow of singletons which are logged in the Packet-Loss(12). The value of the field ippmNetMeasureMetrics is
ippmHistoryTable. The singletons created for the One-way-Delay '0001000001000000'b, '1040'B. Results are logged in the
measure have a value of ippmMetricIndex of 6 while the created ippmHistoryTable where One-way-Delay singletons have a value of
singletons for the One-way-Packet-Loss measure have a value of ippmMetricsIndex of 6 while One-way-Packet-Loss singletons have a
ippmMetricIndex of 12. value of ippmMetricsIndex of 12.
" "
::= { ippmNetMeasureEntry 4 } ::= { ippmNetMeasureEntry 4 }
ippmNetMeasureBeginTime OBJECT-TYPE ippmNetMeasureBeginTime OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the time at which the measurement begins." "Specifies the time at which the measurement begins."
skipping to change at page 41, line 33 skipping to change at page 39, line 51
This object indicates the way the measurement results are managed This object indicates the way the measurement results are managed
when the owner quota has been exceeded: when the owner quota has been exceeded:
'wrap' 'wrap'
continue the measurement and erase the older entries in the continue the measurement and erase the older entries in the
history. history.
'suspend' 'suspend'
stop the measure and keep the results in the history. stop the measure and keep the results in the history.
" "
::= { ippmNetMeasureEntry 12 } ::= { ippmNetMeasureEntry 12 }
ippmNetMeasureSrcTypeP OBJECT-TYPE ippmNetMeasureSrcPacketType OBJECT-TYPE
SYNTAX TypeP SYNTAX PacketType
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines the type P of the source address of the packets sent by "Defines the type P of the source address of the packets sent by
the measure." the measure."
::= { ippmNetMeasureEntry 13 } ::= { ippmNetMeasureEntry 13 }
ippmNetMeasureSrc OBJECT-TYPE ippmNetMeasureSrc OBJECT-TYPE
SYNTAX TypePaddress SYNTAX PacketTypeAddress
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the address of the source of the measure. "Specifies the address of the source of the measure.
It is represented as a list of parameters corresponding to those It is represented as a list of parameters corresponding to those
of the PROTOCOL IDENTIFIER set in ippmNetMeasureSrcTypeP." of the PROTOCOL IDENTIFIER set in ippmNetMeasureSrcPacketType."
::= { ippmNetMeasureEntry 14} ::= { ippmNetMeasureEntry 14}
ippmNetMeasureDstTypeP OBJECT-TYPE ippmNetMeasureDstPacketType OBJECT-TYPE
SYNTAX TypeP SYNTAX PacketType
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines the type P of the destination address of the packets "Defines the type P of the destination address of the packets
sent by the measure." sent by the measure."
::= { ippmNetMeasureEntry 15 } ::= { ippmNetMeasureEntry 15 }
ippmNetMeasureDst OBJECT-TYPE ippmNetMeasureDst OBJECT-TYPE
SYNTAX TypePaddress SYNTAX PacketTypeAddress
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the address of the destination of the measure. "Specifies the address of the destination of the measure.
It is represented as a list of parameters corresponding to those It is represented as a list of parameters corresponding to those
of the PROTOCOL IDENTIFIER set in ippmNetMeasureDstTypeP." of the PROTOCOL IDENTIFIER set in ippmNetMeasureDstPacketType."
::= { ippmNetMeasureEntry 16 } ::= { ippmNetMeasureEntry 16 }
ippmNetMeasureTxMode OBJECT-TYPE ippmNetMeasureTxMode OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
other(0), other(0),
periodic(1), periodic(1),
poisson(2), poisson(2),
multiburst(3) multiburst(3)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
skipping to change at page 43, line 45 skipping to change at page 42, line 12
" "
::= { ippmNetMeasureEntry 20 } ::= { ippmNetMeasureEntry 20 }
ippmNetMeasureDevOrIntBurstSize OBJECT-TYPE ippmNetMeasureDevOrIntBurstSize OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "Packets" UNITS "Packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" "
Multi-burst mode: This field indicates the gap between 2 Multi-burst mode: This field indicates the gap between 2 bursts,
bursts, in number of packets. in number of packets.
Example: Example:
If TxPacketRateUnit/TxPacketRate is 100 packets/second, If TxPacketRateUnit/TxPacketRate is 100 packets/second,
and DevOrIntBurstSize equals 50 packets, then the gap and DevOrIntBurstSize equals 50 packets, then the gap between 2
between 2 bursts is bursts is
equal to 50*1/100, or 1/2 second. equal to 50*1/100, or 1/2 second.
Poisson mode: Poisson mode:
This field indicates the typical difference between the packets This field indicates the typical difference between the packets
of the period corresponding to the median. of the period corresponding to the median.
" "
::= { ippmNetMeasureEntry 21 } ::= { ippmNetMeasureEntry 21 }
ippmNetMeasureLossTimeout OBJECT-TYPE ippmNetMeasureLossTimeout OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "Milliseconds" UNITS "Milliseconds"
MAX-ACCESS read-only MAX-ACCESS read-only
skipping to change at page 44, line 28 skipping to change at page 42, line 44
by the sink." by the sink."
::= { ippmNetMeasureEntry 22 } ::= { ippmNetMeasureEntry 22 }
ippmNetMeasureL3PacketSize OBJECT-TYPE ippmNetMeasureL3PacketSize OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
UNITS "Bytes" UNITS "Bytes"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the size of the packets counted at the IP network "Specifies the size of the packets counted at the IP network
layer in regards to the TypeP definition. layer in regards to the PacketType definition.
Example: For a TypeP 'ip ipip4' the L3 size will be the size of Example: For a PacketType 'ip ipip4' the L3 size will be the size
the packet at ipip4 level. of the packet at ipip4 level.
" "
::= { ippmNetMeasureEntry 23 } ::= { ippmNetMeasureEntry 23 }
ippmNetMeasureDataPattern OBJECT-TYPE ippmNetMeasureDataPattern OBJECT-TYPE
SYNTAX OCTET STRING SYNTAX OCTET STRING
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The pattern used to fill the payload of the packet." "The pattern used to fill the payload of the packet."
::= { ippmNetMeasureEntry 24 } ::= { ippmNetMeasureEntry 24 }
ippmNetMeasureMap OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An administrative name of a network management map to which the
measure belongs."
::= { ippmNetMeasureEntry 25 }
ippmNetMeasureTotalPktsRecv OBJECT-TYPE ippmNetMeasureTotalPktsRecv OBJECT-TYPE
SYNTAX Counter64 SYNTAX Counter64
UNITS "Packets" UNITS "Packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Reports the current number of packets received since the "Reports the current number of packets received since the
beginning of the measure. beginning of the measure.
This parameters is useful to monitor the measure and it is needed This parameters is useful to monitor the measure and it is needed
to compute statistics." to compute statistics."
::= { ippmNetMeasureEntry 26 } ::= { ippmNetMeasureEntry 25 }
ippmNetMeasureLastUpdate OBJECT-TYPE ippmNetMeasureLastUpdate OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time when the last aggregation was computed." "The time when the last aggregation was computed."
::= { ippmNetMeasureEntry 27 } ::= { ippmNetMeasureEntry 26 }
ippmNetMeasureOperState OBJECT-TYPE ippmNetMeasureOperState OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
unknown(0), unknown(0),
running(1), running(1),
stopped(2) stopped(2)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Reports the operational status of the network measure." "Reports the operational status of the network measure."
::= { ippmNetMeasureEntry 28 } ::= { ippmNetMeasureEntry 27 }
-- --
-- --
-- ippmAggrMeasure Group
--
--
--
--
-- ippmAggrMeasureTable -- ippmAggrMeasureTable
-- --
-- --
ippmAggrMeasureTable OBJECT-TYPE ippmAggrMeasureTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmAggrMeasureEntry SYNTAX SEQUENCE OF IppmAggrMeasureEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" An aggregated measure summarizes the results of previous "An aggregated measure summarizes the results of previous network
network or aggregated measures. The results are saved in the or aggregated measures. The results are saved in the
ippmHistoryTable. ippmHistoryTable.
Each step of the calculation for the measure produces a singleton Each step of the calculation for the measure produces a singleton
result per metric." result per metric."
::= { ippmMeasure 2 } ::= { ippmAggrMeasure 1 }
ippmAggrMeasureEntry OBJECT-TYPE ippmAggrMeasureEntry OBJECT-TYPE
SYNTAX IppmAggrMeasureEntry SYNTAX IppmAggrMeasureEntry
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Typically, the configuration operation sets the value of "Typically, the configuration operation creates and sets the
theIppmAggrMeasureEntry. value of the fields of a new ippmAggrMeasureEntry.
ippmAggrMeasureOwner and ippmAggrMeasureIndex identify the
instance created.
The field ippmAggrMeasureMetrics identifies the metric to
compute. As such its ippmMetricsType should be 'aggregated'.
The ippmAggrMeasureMetrics defines the metric to compute. The measure aggregates the results of a measure identified by
The results of the measure to summarize are identified by: ippmAggrMeasureHistoryOwner, ippmAggrMeasureHistoryIndex and
+ ippmAggrMeasureOwner, ippmAggrMeasureHistoryMetric. The measure to aggregate belongs to
+ ippmAggrMeasureIndex ippmNetMeasureTable or ippmAggrMeasureTable.
The aggregated task starts at ippmAggrMeasureBeginTime and ends The aggregation starts at ippmAggrMeasureBeginTime and ends after
after ippmAggrMeasureDuration. An aggregated result is performed ippmAggrMeasureDuration.
and saved in the ippmHistoryTable for each
ippmMeasureCollectionRate tick. " An aggregated result is computed for each
ippmMeasureCollectionRate tick and saved in the
ippmHistoryTable."
INDEX { ippmAggrMeasureOwner, ippmAggrMeasureIndex } INDEX { ippmAggrMeasureOwner, ippmAggrMeasureIndex }
::= { ippmAggrMeasureTable 1 } ::= { ippmAggrMeasureTable 1 }
IppmAggrMeasureEntry ::= SEQUENCE { IppmAggrMeasureEntry ::= SEQUENCE {
ippmAggrMeasureOwner IppmOwnerString, ippmAggrMeasureOwner IppmOwnerString,
ippmAggrMeasureIndex Unsigned32, ippmAggrMeasureIndex IppmOwnerIndex,
ippmAggrMeasureName SnmpAdminString, ippmAggrMeasureName SnmpAdminString,
ippmAggrMeasureMetrics IppmStandardMetrics, ippmAggrMeasureMetrics IppmStandardMetrics,
ippmAggrMeasureHistoryOwner IppmOwnerString,
ippmAggrMeasureHistoryIndex IppmOwnerIndex,
ippmAggrMeasureHistoryMetric IppmMetricsRegistryIndex,
ippmAggrMeasureFilter IppmMetricResultFilter,
ippmAggrMeasureLowThreshold Unsigned32,
ippmAggrMeasureHighThreshold Unsigned32,
ippmAggrMeasureBeginTime GMTTimeStamp, ippmAggrMeasureBeginTime GMTTimeStamp,
ippmAggrMeasureAggrPeriodUnit TimeUnit, ippmAggrMeasureAggrPeriodUnit TimeUnit,
ippmAggrMeasureAggrPeriod Unsigned32, ippmAggrMeasureAggrPeriod Unsigned32,
ippmAggrMeasureDurationUnit TimeUnit, ippmAggrMeasureDurationUnit TimeUnit,
ippmAggrMeasureDuration Unsigned32, ippmAggrMeasureDuration Unsigned32,
ippmAggrMeasureHistorySize Unsigned32, ippmAggrMeasureHistorySize Unsigned32,
ippmAggrMeasureStorageType StorageType, ippmAggrMeasureStorageType StorageType,
ippmAggrMeasureHistoryOwner IppmOwnerString,
ippmAggrMeasureHistoryOwnerIndex Unsigned32,
ippmAggrMeasureHistoryMetric Unsigned32,
ippmAggrMeasureAdminState INTEGER, ippmAggrMeasureAdminState INTEGER,
ippmAggrMeasureFastReport OBJECT IDENTIFIER, ippmAggrMeasureFastReport OBJECT IDENTIFIER,
ippmAggrMeasureMap SnmpAdminString,
ippmAggrMeasureResultsMgmt INTEGER, ippmAggrMeasureResultsMgmt INTEGER,
ippmAggrMeasureLastUpdate GMTTimeStamp, ippmAggrMeasureLastUpdate GMTTimeStamp,
ippmAggrMeasureOperState INTEGER, ippmAggrMeasureOperState INTEGER,
ippmAggrMeasureNbPktsTreated Counter64, ippmAggrMeasureNbPktsTreated Counter64,
ippmAggrMeasureStatus RowStatus ippmAggrMeasureStatus RowStatus
} }
ippmAggrMeasureOwner OBJECT-TYPE ippmAggrMeasureOwner OBJECT-TYPE
SYNTAX IppmOwnerString SYNTAX IppmOwnerString
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The owner who has configured this entry." "The owner who has configured this entry."
::= { ippmAggrMeasureEntry 1 } ::= { ippmAggrMeasureEntry 1 }
ippmAggrMeasureIndex OBJECT-TYPE ippmAggrMeasureIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535) SYNTAX IppmOwnerIndex
MAX-ACCESS not-accessible MAX-ACCESS not-accessible
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The index of the aggregated measure. The value is managed by the "The index of the aggregated measure. The value is managed by the
owner." owner."
::= { ippmAggrMeasureEntry 2 } ::= { ippmAggrMeasureEntry 2 }
ippmAggrMeasureName OBJECT-TYPE ippmAggrMeasureName OBJECT-TYPE
SYNTAX SnmpAdminString SYNTAX SnmpAdminString
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The name of the instance of the metric. It illustrates the "The name of the instance of the metric. It illustrates the
specificity of the metric and includes the metric and the typeP. specificity of the metric and includes the metric and the typeP.
example: IP-port-HTTP-connectivity" example: IP-port-HTTP-connectivity: free text."
::= { ippmAggrMeasureEntry 3 } ::= { ippmAggrMeasureEntry 3 }
ippmAggrMeasureMetrics OBJECT-TYPE ippmAggrMeasureMetrics OBJECT-TYPE
SYNTAX IppmStandardMetrics SYNTAX IppmStandardMetrics
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Defines the metrics to compute within this aggregated measure. "ippmAggrMeasureMetrics defines the metrics to compute within
this aggregated measure.
ONLY aggregated metrics of the same type are allowed in this Only aggregated metrics of the same type are allowed in this
field. field (e.g. Measurement of minimum, average and maximum metrics
A measure may be configured for the result of different metric are generally processed simultaneously on the same network
singletons to be archived in the ippmHistoryTable. The measure).
ippmMetricIndex of the created result has the value of the bit
index of the corresponding ippmAggrMeasureMetrics as explained Results are saved in the ippmHistoryTable. Results of a metric
above in the ippmMetricIndex definition. are identified using an index of type IppmMetricsRegistryIndex.
Example: Example:
A network measure asking for One-way-Delay(6) and One-way-Packet- Given a multi-aggregation of One-way-Delay-Median(9) and One-way-
Loss(12) generated a flow of singletons which are logged in the Delay-Minimum(10). The value of the field ippmAggrMeasureMetrics
ippmHistoryTable. The singletons created for the One-way-Delay is '0000011000000000'b, '0600'B. Results are logged in the
measure have a value of ippmMetricIndex of 6.The aggregated ippmHistoryTable where One-way-Delay-Median singletons have a
measure definition(s) might be One-Way-Delay-Percentile(8),One- value of ippmMetricsIndex of 9 while One-way-Delay-Minimum
way-Delay-Median(9), or One-way-Delay-Minimum(10 . singletons have a value of ippmMetricsIndex of 10.
NOTE WELL: It is not recommended to use the multi aggregation
capability in conjunction with the filter feature.
" "
::= { ippmAggrMeasureEntry 4 } ::= { ippmAggrMeasureEntry 4 }
ippmAggrMeasureHistoryOwner OBJECT-TYPE
SYNTAX IppmOwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The owner of the measure to summarize. "
::= { ippmAggrMeasureEntry 5 }
ippmAggrMeasureHistoryIndex OBJECT-TYPE
SYNTAX IppmOwnerIndex
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The owner index of the measure to summarize. "
::= { ippmAggrMeasureEntry 6 }
ippmAggrMeasureHistoryMetric OBJECT-TYPE
SYNTAX IppmMetricsRegistryIndex
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The metric of the measure to summarize. "
::= { ippmAggrMeasureEntry 7 }
ippmAggrMeasureFilter OBJECT-TYPE
SYNTAX IppmMetricResultFilter
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"
ippmAggrMeasureFilter defines the kind of filter to apply on a
result to determine if the result is stored or not. The
parameters of the filter are ippmAggrMeasureLowThreshold and
ippmAggrMeasureHighThreshold.
Thresholds have the same unit as the metric value.
In the following examples we consider an aggregated measure. Its
low threshold is set to 80.its high threshold is set to 100. The
aggregation produced a flow of 12 aggregated results {40 30 60 85
140 130 190 95 50 90 30 20}.
If the filter is set to 'logInBandValue' then the results 85, 95,
90 will be stored.
If the filter is set to 'logOutBandValue' then the results 40 30
60 140 130 190 50 30 20 will be stored.
If the filter is set to 'logAboveValue' then the results 140 130
190 will be stored.
If the filter is set to 'logBelowValue' then the results 40 30 60
50 30 20 will be stored.
If the filter is set to 'logUpAndDownValue' then the results 40,
140, 50 will be stored."
::= { ippmAggrMeasureEntry 8 }
ippmAggrMeasureLowThreshold OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An event is generated when the result of the measure of the
metric is lower that the value of ippmAggrMeasureLowThreshold.
The threshold has the same unit as the metric. The metric unit is
recorded in the object ippmMetricsUnit of this metric entry in
the ippmMetricsTable.
"
::= { ippmAggrMeasureEntry 9 }
ippmAggrMeasureHighThreshold OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An event is generated when the result of the measure of the
metric exceeds the value of ippmAggrMeasureHighThreshold.
The threshold has the same unit as the metric. The metric unit is
recorded in the object ippmMetricsUnit of this metric entry in
the ippmMetricsTable.
"
::= { ippmAggrMeasureEntry 10 }
ippmAggrMeasureBeginTime OBJECT-TYPE ippmAggrMeasureBeginTime OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the time at which the aggregated measure starts." "Specifies the time at which the aggregated measure starts."
::= { ippmAggrMeasureEntry 5 } ::= { ippmAggrMeasureEntry 11 }
ippmAggrMeasureAggrPeriodUnit OBJECT-TYPE ippmAggrMeasureAggrPeriodUnit OBJECT-TYPE
SYNTAX TimeUnit SYNTAX TimeUnit
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the unit of the aggregated measure period." "Specifies the unit of the aggregated measure period."
DEFVAL { second } DEFVAL { second }
::= { ippmAggrMeasureEntry 6 } ::= { ippmAggrMeasureEntry 12 }
ippmAggrMeasureAggrPeriod OBJECT-TYPE ippmAggrMeasureAggrPeriod OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the amount of time between 2 measurement action "Specifies the amount of time between 2 measurement action
intervals. The action is specific to the semantic of the measure. intervals. The action is specific to the semantic of the measure.
Network metrics: Network metrics:
skipping to change at page 49, line 4 skipping to change at page 49, line 13
Aggregated metrics: Aggregated metrics:
They are performed periodically on a sequence of results of other They are performed periodically on a sequence of results of other
measures. The period corresponds to the interval between two measures. The period corresponds to the interval between two
successive computations of the metric. The value of successive computations of the metric. The value of
ippmHistoryTimestamp result of a aggregated metric computed ippmHistoryTimestamp result of a aggregated metric computed
corresponds to the value of the ippmHistoryTimestamp of the last corresponds to the value of the ippmHistoryTimestamp of the last
metric result of the sequence used to compute the aggregated metric result of the sequence used to compute the aggregated
metric." metric."
DEFVAL { 60 } DEFVAL { 60 }
::= { ippmAggrMeasureEntry 7 }
::= { ippmAggrMeasureEntry 13 }
ippmAggrMeasureDurationUnit OBJECT-TYPE ippmAggrMeasureDurationUnit OBJECT-TYPE
SYNTAX TimeUnit SYNTAX TimeUnit
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the unit of the measure duration." "Specifies the unit of the measure duration."
DEFVAL { second } DEFVAL { second }
::= { ippmAggrMeasureEntry 8 } ::= { ippmAggrMeasureEntry 14 }
ippmAggrMeasureDuration OBJECT-TYPE ippmAggrMeasureDuration OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the duration of the measure." "Specifies the duration of the measure."
DEFVAL { 120 } DEFVAL { 120 }
::= { ippmAggrMeasureEntry 9 } ::= { ippmAggrMeasureEntry 15 }
ippmAggrMeasureHistorySize OBJECT-TYPE ippmAggrMeasureHistorySize OBJECT-TYPE
SYNTAX Unsigned32 SYNTAX Unsigned32
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Specifies the maximum number of results saved for each metric of "Specifies the maximum number of results saved for each metric of
this measure. Overflow condition will be managed by the object this measure. Overflow condition will be managed by the object
ippmAggrMeasureResultsMgmt. " ippmAggrMeasureResultsMgmt. "
DEFVAL { 2 } DEFVAL { 2 }
::= { ippmAggrMeasureEntry 10 } ::= { ippmAggrMeasureEntry 16 }
ippmAggrMeasureStorageType OBJECT-TYPE ippmAggrMeasureStorageType OBJECT-TYPE
SYNTAX StorageType SYNTAX StorageType
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object defines whether this row and the measure controlled "This object defines whether this row and the measure controlled
by this row are kept in volatile storage and lost upon reboot or by this row are kept in volatile storage and lost upon reboot or
if this row is backed up if this row is backed up
by non-volatile or permanent storage. by non-volatile or permanent storage.
skipping to change at page 49, line 44 skipping to change at page 50, line 4
ippmAggrMeasureStorageType OBJECT-TYPE ippmAggrMeasureStorageType OBJECT-TYPE
SYNTAX StorageType SYNTAX StorageType
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object defines whether this row and the measure controlled "This object defines whether this row and the measure controlled
by this row are kept in volatile storage and lost upon reboot or by this row are kept in volatile storage and lost upon reboot or
if this row is backed up if this row is backed up
by non-volatile or permanent storage. by non-volatile or permanent storage.
Possible values are: other(1), volatile(2), nonVolatile(3), Possible values are: other(1), volatile(2), nonVolatile(3),
permanent(4), readOnly(5)." permanent(4), readOnly(5)."
DEFVAL { nonVolatile } DEFVAL { nonVolatile }
::= { ippmAggrMeasureEntry 11 } ::= { ippmAggrMeasureEntry 17 }
ippmAggrMeasureResultsMgmt OBJECT-TYPE ippmAggrMeasureResultsMgmt OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
wrap(1), wrap(1),
suspend(2) suspend(2)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object displays the way the history of the aggregated "This object displays the way the history of the aggregated
measure is managed. measure is managed.
'wrap' 'wrap'
continue the measure and erase the older entries in the continue the measure and erase the older entries in the
history. history.
'suspend' 'suspend'
stop the measure and keep the results in the history. stop the measure and keep the results in the history.
" "
DEFVAL { wrap } DEFVAL { wrap }
::= { ippmAggrMeasureEntry 12 } ::= { ippmAggrMeasureEntry 18 }
ippmAggrMeasureHistoryOwner OBJECT-TYPE
SYNTAX IppmOwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The owner of the measure to summarize. "
::= { ippmAggrMeasureEntry 13 }
ippmAggrMeasureHistoryOwnerIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The owner index of the measure to summarize. "
::= { ippmAggrMeasureEntry 14 }
ippmAggrMeasureHistoryMetric OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The metric of the measure to summarize. "
::= { ippmAggrMeasureEntry 15 }
ippmAggrMeasureAdminState OBJECT-TYPE ippmAggrMeasureAdminState OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
start(0), start(0),
stop(1) stop(1)
} }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object controls the activity of the aggregated measure. "This object controls the activity of the aggregated measure.
skipping to change at page 51, line 4 skipping to change at page 50, line 40
SYNTAX INTEGER { SYNTAX INTEGER {
start(0), start(0),
stop(1) stop(1)
} }
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"This object controls the activity of the aggregated measure. "This object controls the activity of the aggregated measure.
'start' 'start'
The aggregated measure is started. The aggregated measure is started.
'stop' 'stop'
The aggregated measure is stopped." The aggregated measure is stopped."
DEFVAL { start } DEFVAL { start }
::= { ippmAggrMeasureEntry 16 } ::= { ippmAggrMeasureEntry 19 }
ippmAggrMeasureFastReport OBJECT-TYPE ippmAggrMeasureFastReport OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A fast report is required in order to verify quickly that a "A fast report is required in order to verify quickly that a
measure is running well. measure is running well.
The feature 'fast report' is active if IppmAggrMeasureFastReport
The feature 'fast report' is active if ippmAggrMeasureFastReport
is not null and points to a notification. is not null and points to a notification.
A fast report consists of sending by email to the owner of the A fast report consists of sending by email to the owner of the
measure, a table of the results of all the metrics computed by measure, a table of the results of all the metrics computed by
this aggregated measure. The owner email address is read from the this aggregated measure. The owner email address is read from the
ippmOwnersTable. ippmOwnersTable.
ippmAggrMeasureFastReport identifies the notification which ippmAggrMeasureFastReport identifies the notification which
defines the header of the report. defines the header of the report.
The results part of the report is made of the a column of results The results part of the report is made of a column of results per
per metrics. Results are separated using commas. metrics. Results are separated using commas.
To avoid disaster, an aggregated measure using a fast report must To avoid disaster, an aggregated measure using a fast report must
have a cycle of aggregation greater than or equal to 1 second and have a cycle of aggregation greater than or equal to 1 second and
should not sent more than an email every 5 minutes and should not should not sent more than an email every 5 minutes and should not
sent more than 12 emails." sent more than 12 emails."
DEFVAL { zeroDotZero } DEFVAL { zeroDotZero }
::= { ippmAggrMeasureEntry 17 } ::= { ippmAggrMeasureEntry 20 }
ippmAggrMeasureMap OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object allows for classification of the measure. It is
typically the name of an administrative map.
"
DEFVAL { "" }
::= { ippmAggrMeasureEntry 18 }
ippmAggrMeasureLastUpdate OBJECT-TYPE ippmAggrMeasureLastUpdate OBJECT-TYPE
SYNTAX GMTTimeStamp SYNTAX GMTTimeStamp
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The time when the last aggregated measure was computed." "The time when the last aggregated measure was computed."
::= { ippmAggrMeasureEntry 19 } ::= { ippmAggrMeasureEntry 21 }
ippmAggrMeasureOperState OBJECT-TYPE ippmAggrMeasureOperState OBJECT-TYPE
SYNTAX INTEGER { SYNTAX INTEGER {
unknown(0), unknown(0),
running(1), running(1),
stopped(2) stopped(2)
} }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Reports the operational status of the aggregated measure." "Reports the operational status of the aggregated measure."
::= { ippmAggrMeasureEntry 20 } ::= { ippmAggrMeasureEntry 22 }
ippmAggrMeasureNbPktsTreated OBJECT-TYPE ippmAggrMeasureNbPktsTreated OBJECT-TYPE
SYNTAX Counter64 SYNTAX Counter64
UNITS "Packets" UNITS "Packets"
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Reports the current number of packets used to calculate the "Reports the current number of packets used to calculate the
aggregation since the start of the measure. aggregation since the start of the measure.
This parameters is useful to monitor the measure and it is needed This parameters is useful to monitor the measure and it is needed
to compute statistics." to compute statistics."
::= { ippmAggrMeasureEntry 21 } ::= { ippmAggrMeasureEntry 23 }
ippmAggrMeasureStatus OBJECT-TYPE ippmAggrMeasureStatus OBJECT-TYPE
SYNTAX RowStatus SYNTAX RowStatus
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The status of this table entry. Once the entry status is set to "The status of this entry. Once the entry status is set to
active, the associate entry cannot be modified. active, the associate entry cannot be modified.
" "
::= { ippmAggrMeasureEntry 22 } ::= { ippmAggrMeasureEntry 24 }
ippmReportPathToResults OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
" It is typically a URL describing the file location where the
results are logged. "
::= { ippmReport 1 }
ippmReportSetupTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmReportSetupEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The ippmReportSetupTable is a list of definition of reports. It
defines the results of network and/or aggregated measures that
are to be reported. A report is saved in the ippmReportTable, or
sent to an application using an SNMP Trap, an SNMP inform PDU, an
email, or a SMS. The reporting task is not intended to be a batch
action processed at the end of the measure. It is coupled with
threshold detections and event filtering to deliver application
level events and data, while preserving scalability.
"
::= { ippmReport 2 }
ippmReportSetupEntry OBJECT-TYPE
SYNTAX IppmReportSetupEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The report applies to the results of a measure as defined in
either the network measure table, or the aggregated measure
table.
The ippmReportSetupDefinition describes the data and the events
to include in the report. The definition consists of a list of
tasks to perform on the results of the measure.
A report is associated to a network measure or to an aggregated
measure.
Note 1: To associate a report to an existing measure the manager
suspends the measure by setting either the
ippmAggrMeasureAdminStatus or the ippmAggrMeasureStatus to
'notInService'. Then one sets the report fields and activates the
measure by setting the corresponding MeasureStatus to 'active'.
Note 2: A report is tied to a measure and its period."
INDEX { ippmReportSetupOwner, ippmReportSetupIndex }
::= { ippmReportSetupTable 1 }
IppmReportSetupEntry ::=
SEQUENCE {
ippmReportSetupOwner IppmOwnerString,
ippmReportSetupIndex Unsigned32,
ippmReportSetupMeasureOwner IppmOwnerString,
ippmReportSetupMeasureIndex Unsigned32,
ippmReportSetupMeasureMetric Unsigned32,
ippmReportSetupDefinition IppmReportDefinition,
ippmReportSetupUpDownThreshold Unsigned32,
ippmReportSetupLowThreshold Unsigned32,
ippmReportSetupHighThreshold Unsigned32,
ippmReportSetupDurationThresUnit TimeUnit,
ippmReportSetupDurationThreshold Unsigned32,
ippmReportSetupReportSize Unsigned32,
ippmReportSetupResultsMgmt INTEGER,
ippmReportSetupNMS IppmOwnerString,
ippmReportSetupNotification OBJECT IDENTIFIER,
ippmReportSetupMap SnmpAdminString,
ippmReportSetupStatus RowStatus
}
ippmReportSetupOwner OBJECT-TYPE
SYNTAX IppmOwnerString
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The owner who has configured this report entry."
::= { ippmReportSetupEntry 1 }
ippmReportSetupIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The owner index of the report entry. The value is managed by the
owner."
::= { ippmReportSetupEntry 2 }
ippmReportSetupMeasureOwner OBJECT-TYPE
SYNTAX IppmOwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The owner of the measure to report."
::= { ippmReportSetupEntry 3 }
ippmReportSetupMeasureIndex OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The index of the measure to report."
::= { ippmReportSetupEntry 4 }
ippmReportSetupMeasureMetric OBJECT-TYPE
SYNTAX Unsigned32 (1.. 65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The metric of the measure to report."
::= { ippmReportSetupEntry 5 }
ippmReportSetupDefinition OBJECT-TYPE
SYNTAX IppmReportDefinition
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"In order to properly define a report, one must provide
information to:
+ Select the events to consider for reporting
+ Configure filters to select pertinent values
+ Describe the way the report is delivered
+ Describe clean up actions to perform on report completion
The format of a report sent to a NMS is described in a
notification defined in the ippmNotifications node.
The event and the filter selected in the report definition
determine the notification:
+ Up and Down filter report format is ippmUpAndDownReport;
+ Inband filter report format is ippmInBandReport;
+ Outband filter report format is ippmOutBandReport;
+ Above filter report format is ippmAboveReport;
+ Below filter report format is ippmBelowReport;
+ Any filter and reportExceededEventsDuration report format is
ippmEventsDurationExceededReport;
+ Any filter and the event onMeasureCompletion report format is
ippmCompletedMeasureReport;
Example 1:
Consider a report definition, which reports up and down result
events of a metric measure:
ippmReportSetupDefinition {
onSingleton,
reportUpAndDownMetricResults,
inSNMPv2TrapPDU
}
The value of the threshold is given by
ippmReportSetupUpDownThreshold. It has the value '5' in this
example.
Being a flow of results { 3.3 3.2 3.2 5.1 5.3 5.6 6.3 5.2 4.0 3.8
...}, the report process will send 2 traps:
+ The first one carries the result 5.1 corresponding to
a down to up event;
+ The second one carries the result 4.0 of the up to
down event
Example 2:
Consider the report definition, which reports per measure cycle
in a SNMP informRequestPDU, up and down results events of a
metric measure:
:
ippmReportSetupDefinition {
onMeasureCycle,
reportUpAndDownMetricResults,
inInformRequestPDU
}
The value of the threshold is given by
ippmReportSetupUpDownThreshold. It has the value '5' in this
example.
The cycle of measure of the measure setup is set to 10 results.
Being a flow of 10 results { 3.3 3.2 3.2 5.1 5.3 5.6 6.3 5.2 4.0
3.8 ... }, the report process will send one InformRequestPDU that
carries 5.1 and 4.0 corresponding to the first down to up event
and to the second up to down event, respectively. "
::= { ippmReportSetupEntry 6 }
ippmReportSetupUpDownThreshold OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An event is generated when the result of the measure exceeds the
value of ippmReportSetupMetricThreshold, and then goes below the
threshold or vice versa. In the case of being over the threshold,
and then being below it, the measure value that is immediately
below the threshold, after previously being above it, is
reported. In the case of being below the threshold and then being
above it, the measure value that is above the threshold is
reported.
The threshold has the same unit as the metric. The metric unit is
recorded in the object ippmMetricsUnit of this metric entry in
the ippmMetricTable.
"
::= { ippmReportSetupEntry 7 }
ippmReportSetupLowThreshold OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An event is generated when the result of the measure of the
metric is lower that the value of ippmReportSetupLowThreshold.
The threshold has the same unit as the metric. The metric unit is
recorded in the object ippmMetricsUnit of this metric entry in
the ippmMetricTable.
"
::= { ippmReportSetupEntry 8 }
ippmReportSetupHighThreshold OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An event is generated when the result of the measure of the
metric exceeds the value of ippmReportSetupHighThreshold.
The threshold has the same unit as the metric. The metric unit is
recorded in the object ippmMetricsUnit of this metric entry in
the ippmMetricTable.
"
::= { ippmReportSetupEntry 9 }
ippmReportSetupDurationThresUnit OBJECT-TYPE
SYNTAX TimeUnit
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The unit of the duration threshold."
DEFVAL { second }
::= { ippmReportSetupEntry 10 }
ippmReportSetupDurationThreshold OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An event is generated when contiguous results of the measure are
over the ippmReportSetupUpDownThreshold, during
ippmReportSetupDurationThreshold seconds.
Performance:
To improve the performance of the system, the report process may
be synchronized with the cycle of collection of network measures,
or with the period of aggregation of an aggregated measure."
DEFVAL { 15 }
::= { ippmReportSetupEntry 11 }
ippmReportSetupReportSize OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Specifies the maximum number of results saved for each metric of
this measure. The history of each metric is managed as a circular
table. The newest result overwrites the oldest one when the
history granted to this metric measure is full.
The management of the results may be optimized if synchronized
with the reports steps of this measure. "
::= { ippmReportSetupEntry 12 }
ippmReportSetupResultsMgmt OBJECT-TYPE
SYNTAX INTEGER {
wrap(1),
suspend(2)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"
Action to take when the report log is full. The user may choose
to either wrap, in which case the agent writes over existing
records. The user may choose to suspend writing to the log in the
event that he wishes to archive the data. The resume action
causes the agent to begin to write in the report log, and assumes
the data has been cleared
This object indicates the way the measure results are managed
when the owner quota is over:
'wrap'
continue the measure and erase the older entries in the
history.
'suspend'
stop the measure and keep the results in the history"
DEFVAL { wrap }
::= { ippmReportSetupEntry 13 }
ippmReportSetupNMS OBJECT-TYPE
SYNTAX IppmOwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The recipient of the report may be provided in the setup. By
default the recipient of the report is the owner of the measure.
Its addresses are recorded in the ippmOwnersTable.
The type of ippmReportSetupNMS is not InetAddress because the
report may be sent using SMS or fax.
"
DEFVAL { "" }
::= { ippmReportSetupEntry 14 }
ippmReportSetupNotification OBJECT-TYPE
SYNTAX OBJECT IDENTIFIER
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Even though the notification to use is defined in the report
definition, the object ippmReportSetupNotification provides
flexibility to select another notification. "
DEFVAL { zeroDotZero }
::= { ippmReportSetupEntry 15 }
ippmReportSetupMap OBJECT-TYPE
SYNTAX SnmpAdminString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An administrative name of a map to which the report belongs."
DEFVAL { "" }
::= { ippmReportSetupEntry 16 }
ippmReportSetupStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this table entry. "
::= { ippmReportSetupEntry 17 }
ippmReportTable OBJECT-TYPE
SYNTAX SEQUENCE OF IppmReportEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The ippmReportTable logs the results of the reports. The results
consist of a subset of the results of a measure as described in
the report definition. The activation of an up and down filtering
in the report definition limits the results logged to those
corresponding to major events. Otherwise, the ippmReportTable is
identical to the ippmHistoryTable."
::= { ippmReport 3 }
ippmReportEntry OBJECT-TYPE
SYNTAX IppmReportEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A report is a list of results of a measure. This sample is
associated with the ippmReportSetupEntry which has set up the
report. An ippmReportEntry entry is one of the results of a
measure to report.
An ippmReportEntry entry is one of the results of a measure
identified by ippmReportMeasureOwner, ippmReportMeasureIndex,
ippmReportMetricIndex and ippmReportIndex.
In the index:
+ ippmReportSetupOwner identifies the owner of the measure
+ ippmReportSetupIndex identifies the measure in the owner
namespace;
+ ippmReportSequence identifies the sequence number of the
measure result"
INDEX { ippmReportSetupOwner, ippmReportSetupIndex,
ippmReportSequence }
::= { ippmReportTable 1 }
IppmReportEntry ::=
SEQUENCE {
ippmReportSequence Unsigned32,
ippmReportTimestamp GMTTimeStamp,
ippmReportValue Integer32
}
ippmReportSequence OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"ippmReportSequence is the sequence number of the measurement
results to report.
Network metrics:
It's the sequence number of a measurement packet. Typically, it
identifies the order of the packet in the stream of packets sends
by the source.
Aggregated metrics:
It is the sequence number of the aggregated metric results
computed."
::= { ippmReportEntry 1 }
ippmReportTimestamp OBJECT-TYPE
SYNTAX GMTTimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The timestamp of the measurement result."
::= { ippmReportEntry 2 }
ippmReportValue OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value."
::= { ippmReportEntry 3 }
-- --
-- IPPM Notifications -- IPPM Notifications
-- --
ippmUpAndDownReport NOTIFICATION-TYPE ippmAggrMeasureReport NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupDefinition,
ippmReportSetupUpDownThreshold,
ippmMetricType,
ippmMetricUnit,
ippmMetricDescription,
ippmHistoryTimestamp,
ippmHistoryValue,
ippmReportPathToResults
}
STATUS current
DESCRIPTION
"A notification sent because 2 contiguous results are on opposite
sides of the metric threshold value.
The notification contains the instances of the ippmHistoryValue
object that exceeded the threshold in the case of a down to up
change. In the case of a up to down change, the ippmHistoryValue
object that is below the threshold immediately after being over
the threshold.
The notification contains the instances of the
ippmHistoryTimestamp identifying the time the event occurred.
ippmReportPathToResults is a link to the file name, which
contains detailed results corresponding to this event."
::= { ippmNotifications 1 }
ippmInBandReport NOTIFICATION-TYPE
OBJECTS { OBJECTS {
ippmReportSetupDefinition, ippmAggrMeasureFilter,
ippmReportSetupLowThreshold, ippmAggrMeasureLowThreshold,
ippmReportSetupHighThreshold, ippmAggrMeasureHighThreshold,
ippmMetricType, ippmMetricsType,
ippmMetricUnit, ippmMetricsUnit,
ippmMetricDescription, ippmMetricsDescription,
ippmHistoryTimestamp, ippmHistoryTimestamp,
ippmHistoryValue, ippmHistoryValue,
ippmReportPathToResults ippmHistoryPathToResults
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A notification sent because the value of the measure is under "A notification sent because the value of the measure is under
the high threshold value and greater than the low threshold the high threshold value and greater than the low threshold
value. value.
The notification contains the instances of the ippmHistoryValue The notification contains the instances of the ippmHistoryValue
object that exceeded the threshold. object that exceeded the threshold.
The notification contains the instances of the The notification contains the instances of the
ippmHistoryTimestamp identifying the time the event occurred. ippmHistoryTimestamp identifying the time the event occurred.
ippmReportPathToResults is a link to the file name, which ippmHistoryPathToResults is a link to the file name, which
contains detailed results corresponding to this event."
::= { ippmNotifications 2 }
ippmOutBandReport NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupDefinition,
ippmReportSetupLowThreshold,
ippmReportSetupHighThreshold,
ippmMetricType,
ippmMetricUnit,
ippmMetricDescription,
ippmHistoryTimestamp,
ippmHistoryValue,
ippmReportPathToResults
}
STATUS current
DESCRIPTION
"A notification sent because the result of the measure is either
greater than the high threshold or lower than the low threshold.
The notification contains the instances of the ippmHistoryValue
object that exceeded the threshold.
The notification contains the instances of the
ippmHistoryTimestamp identifying the time the event occurred.
ippmReportPathToResults is a link to the file name, which
contains detailed results corresponding to this event."
::= { ippmNotifications 3 }
ippmAboveReport NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupDefinition,
ippmReportSetupHighThreshold,
ippmMetricType,
ippmMetricUnit,
ippmMetricDescription,
ippmHistoryTimestamp,
ippmHistoryValue,
ippmReportPathToResults
}
STATUS current
DESCRIPTION
"The notification contains the instances of the ippmHistoryValue
object that exceeded the threshold.
The notification contains the instances of the
ippmHistoryTimestamp identifying the time the event occurred.
ippmReportPathToResults is a link to the file name, which
contains detailed results corresponding to this event."
::= { ippmNotifications 4 }
ippmBelowReport NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupDefinition,
ippmReportSetupLowThreshold,
ippmMetricType,
ippmMetricUnit,
ippmMetricDescription,
ippmHistoryTimestamp,
ippmHistoryValue,
ippmReportPathToResults
}
STATUS current
DESCRIPTION
"
The notification contains the instances of the ippmHistoryValue
object that were below the threshold.
The notification contains the instances of the
ippmHistoryTimestamp identifying the time the event occurred.
ippmReportPathToResults is a link to the file name, which
contains detailed results corresponding to this event." contains detailed results corresponding to this event."
::= { ippmNotifications 5 } ::= { ippmNotifications 1 }
ippmEventsDurationExceededReport NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupDefinition,
ippmReportSetupUpDownThreshold,
ippmReportSetupDurationThreshold,
ippmReportSetupDurationThresUnit,
ippmMetricType,
ippmMetricUnit,
ippmMetricDescription,
ippmHistoryTimestamp,
ippmHistoryValue,
ippmReportPathToResults
}
STATUS current
DESCRIPTION
"A notification sent when the duration of continuously rising
metric threshold exceeds the ippmReportSetupDurationThreshold
value.
The notification contains the instances of the ippmReportValue
object that exceeded the threshold.
The notification contains the instances of the
ippmReportTimestamp identifying the time the event occurred.
ippmReportPathToResults is a link to the file name, which
contains detailed results corresponding to this event.
"
::= { ippmNotifications 6 }
ippmCompletedMeasureReport NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupDefinition,
ippmMetricType,
ippmMetricUnit,
ippmMetricDescription,
ippmHistoryTimestamp,
ippmHistoryValue,
ippmReportPathToResults
}
STATUS current
DESCRIPTION
"A notification sent when a measure completes.
The index of the included ippmReportSetupDefinition object
identifies the ippmMeasureEntry and the ippmResultSetupEntry that
specified the report.
ippmReportPathToResults is a link to the file name, which
contains the results of this measure cycle."
::= { ippmNotifications 7 }
ippmAggrMeasureHistoryFull NOTIFICATION-TYPE ippmAggrMeasureHistoryFull NOTIFICATION-TYPE
OBJECTS { OBJECTS {
ippmAggrMeasureName, ippmAggrMeasureName,
ippmAggrMeasureHistorySize, ippmAggrMeasureHistorySize,
ippmMetricType, ippmMetricsType,
ippmMetricUnit, ippmMetricsUnit,
ippmMetricDescription, ippmMetricsDescription,
ippmHistoryTimestamp, ippmHistoryTimestamp,
ippmHistoryValue ippmHistoryValue
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" A notification sent when the size of the history of a metric of " A notification sent when the size of the history of a metric of
a aggregated measure exceeds ippmAggrMeasureHistorySize. The a aggregated measure exceeds ippmAggrMeasureHistorySize. The
agent will then manage the reports according to the policy agent will then manage the reports according to the policy
described in ippmAggrMeasureResultsMgmt." described in ippmAggrMeasureResultsMgmt."
::= { ippmNotifications 8 } ::= { ippmNotifications 2 }
ippmNetMeasureHistoryFull NOTIFICATION-TYPE ippmNetMeasureHistoryFull NOTIFICATION-TYPE
OBJECTS { OBJECTS {
ippmNetMeasureName, ippmNetMeasureName,
ippmNetMeasureHistorySize, ippmNetMeasureHistorySize,
ippmMetricType, ippmMetricsType,
ippmMetricUnit, ippmMetricsUnit,
ippmMetricDescription, ippmMetricsDescription,
ippmHistoryTimestamp, ippmHistoryTimestamp,
ippmHistoryValue ippmHistoryValue
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
" A notification sent when the size of the history of a metric of " A notification sent when the size of the history of a metric of
a network measure exceeded ippmNetMeasureHistorySize. Then the a network measure exceeded ippmNetMeasureHistorySize. Then the
agent manages the records according to the policy described in agent manages the records according to the policy described in
ippmNetMeasureResultsMgmt." ippmNetMeasureResultsMgmt."
::= { ippmNotifications 9 } ::= { ippmNotifications 3 }
ippmReportLogFull NOTIFICATION-TYPE
OBJECTS {
ippmReportSetupResultsMgmt,
ippmReportSetupReportSize,
ippmReportTimestamp,
ippmReportValue
}
STATUS current
DESCRIPTION
"A notification sent when the size of the report of a metric of a
measure exceeded ippmReportSetupReportSize. The agent manages the
reports according to the policy described in
ippmReportSetupResultsMgmt."
::= { ippmNotifications 10 }
-- --
-- IPPM MIB Conformance statements -- IPPM MIB Conformance statements
-- --
ippmCompliances OBJECT IDENTIFIER ::={ ippmConformance 1 } ippmCompliances OBJECT IDENTIFIER ::={ ippmConformance 1 }
ippmGroups OBJECT IDENTIFIER ::={ ippmConformance 2 } ippmGroups OBJECT IDENTIFIER ::={ ippmConformance 2 }
ippmProxyInterDomainCompliances MODULE-COMPLIANCE ippmProxyInterDomainCompliances MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for SNMP entities which implement the "The compliance statement for SNMP entities which implement the
IPPM MIB as a proxy in interdomain. The implementation of the IPPM MIB as a proxy in interdomain. The implementation of the
VACM control is mandatory." VACM control is mandatory."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { MANDATORY-GROUPS {
ippmSystemGroup, ippmNetMeasureGroup, ippmHistoryGroup, ippmSystemGroup, ippmHistoryGroup, ippmNetMeasureGroup,
ippmAggrMeasureGroup, ippmReportGroup, ippmNotificationGroup ippmAggrMeasureGroup, ippmNotificationGroup
} }
::= { ippmCompliances 1 } ::= { ippmCompliances 1 }
ippmProxyCompliances MODULE-COMPLIANCE ippmProxyCompliances MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for SNMP entities which implement the "The compliance statement for SNMP entities which implement the
IPPM MIB as a proxy." IPPM MIB as a proxy."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { MANDATORY-GROUPS {
ippmSystemGroup, ippmNetMeasureGroup, ippmHistoryGroup, ippmSystemGroup, ippmOwnersGroup, ippmHistoryGroup,
ippmAggrMeasureGroup, ippmReportGroup, ippmNotificationGroup ippmNetMeasureGroup, ippmAggrMeasureGroup, ippmNotificationGroup
} }
GROUP ippmOwnersGroup GROUP ippmOwnersGroup
DESCRIPTION DESCRIPTION
"The ippmOwnersGroup is needed if VACM is not implemented." "The ippmOwnersGroup is needed if VACM is not implemented."
::= { ippmCompliances 2 } ::= { ippmCompliances 2 }
ippmProbeCompliances MODULE-COMPLIANCE ippmEmbeddedCompliances MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for SNMP entities which implement the "The compliance statement for SNMP entities which implement the
IPPM MIB in a probe." IPPM MIB in a probe."
MODULE -- this module MODULE -- this module
MANDATORY-GROUPS { MANDATORY-GROUPS {
ippmSystemGroup, ippmNetMeasureGroup, ippmHistoryGroup ippmSystemGroup, ippmHistoryGroup, ippmNetMeasureGroup
} }
::= { ippmCompliances 3 } ::= { ippmCompliances 3 }
ippmSystemGroup OBJECT-GROUP ippmSystemGroup OBJECT-GROUP
OBJECTS { OBJECTS {
ippmSystemSynchronizationDesc, ippmSystemSynchronizationDesc,
ippmSystemTime, ippmSystemTime,
ippmSystemSynchronizationType, ippmSystemSynchronizationType,
ippmSystemClockResolution, ippmSystemClockResolution,
ippmSynchronizationTime, ippmSynchronizationTime,
ippmSynchronizationStratum, ippmSynchronizationStratum,
ippmSynchronizationResolution, ippmSynchronizationResolution,
ippmPointOfMeasureMgmtAddrType, ippmPointOfMeasureMgmtAddrType,
ippmPointOfMeasureMgmtAddress, ippmPointOfMeasureMgmtAddress,
ippmPointOfMeasureTestAddrTypeP, ippmPointOfMeasureTestAddrType,
ippmPointOfMeasureTestAddr, ippmPointOfMeasureTestAddress,
ippmSystemOperationalStatus, ippmSystemOperationalStatus,
ippmSystemAggregatedMetrics,
ippmPointOfMeasureMetrics, ippmPointOfMeasureMetrics,
ippmMetricCapabilities, ippmMetricsType,
ippmMetricType, ippmMetricsUnit,
ippmMetricUnit, ippmMetricsDescription
ippmMetricDescription
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IPPM System Group" "The IPPM System Group"
::= { ippmGroups 1} ::= { ippmGroups 1}
ippmNetMeasureGroup OBJECT-GROUP ippmNetMeasureGroup OBJECT-GROUP
OBJECTS { OBJECTS {
ippmNetMeasureName, ippmNetMeasureName,
ippmNetMeasureMetrics, ippmNetMeasureMetrics,
ippmNetMeasureBeginTime, ippmNetMeasureBeginTime,
ippmNetMeasureCollectionRateUnit, ippmNetMeasureCollectionRateUnit,
ippmNetMeasureCollectionRate, ippmNetMeasureCollectionRate,
ippmNetMeasureDurationUnit, ippmNetMeasureDurationUnit,
ippmNetMeasureDuration, ippmNetMeasureDuration,
ippmNetMeasureHistorySize, ippmNetMeasureHistorySize,
ippmNetMeasureFailureMgmtMode, ippmNetMeasureFailureMgmtMode,
ippmNetMeasureResultsMgmt, ippmNetMeasureResultsMgmt,
ippmNetMeasureSrcTypeP, ippmNetMeasureSrcPacketType,
ippmNetMeasureSrc, ippmNetMeasureSrc,
ippmNetMeasureDstTypeP, ippmNetMeasureDstPacketType,
ippmNetMeasureDst, ippmNetMeasureDst,
ippmNetMeasureTxMode, ippmNetMeasureTxMode,
ippmNetMeasureTxPacketRateUnit, ippmNetMeasureTxPacketRateUnit,
ippmNetMeasureTxPacketRate, ippmNetMeasureTxPacketRate,
ippmNetMeasureMedOrBurstSize, ippmNetMeasureMedOrBurstSize,
ippmNetMeasureDevOrIntBurstSize, ippmNetMeasureDevOrIntBurstSize,
ippmNetMeasureLossTimeout, ippmNetMeasureLossTimeout,
ippmNetMeasureL3PacketSize, ippmNetMeasureL3PacketSize,
ippmNetMeasureDataPattern, ippmNetMeasureDataPattern,
ippmNetMeasureMap,
ippmNetMeasureTotalPktsRecv, ippmNetMeasureTotalPktsRecv,
ippmNetMeasureLastUpdate, ippmNetMeasureLastUpdate,
ippmNetMeasureOperState ippmNetMeasureOperState
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IPPM Network Measure Group" "The IPPM Network Measure Group"
::= { ippmGroups 3} ::= { ippmGroups 2}
ippmHistoryGroup OBJECT-GROUP ippmHistoryGroup OBJECT-GROUP
OBJECTS { OBJECTS {
ippmHistoryTimestamp, ippmHistoryTimestamp,
ippmHistoryValue ippmHistoryValue,
ippmHistoryPathToResults
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IPPM History Group" "The IPPM History Group"
::= { ippmGroups 4} ::= { ippmGroups 3}
ippmAggrMeasureGroup OBJECT-GROUP ippmAggrMeasureGroup OBJECT-GROUP
OBJECTS { OBJECTS {
ippmAggrMeasureName, ippmAggrMeasureName,
ippmAggrMeasureMetrics, ippmAggrMeasureMetrics,
ippmAggrMeasureBeginTime, ippmAggrMeasureBeginTime,
ippmAggrMeasureAggrPeriodUnit, ippmAggrMeasureAggrPeriodUnit,
ippmAggrMeasureAggrPeriod, ippmAggrMeasureAggrPeriod,
ippmAggrMeasureDurationUnit, ippmAggrMeasureDurationUnit,
ippmAggrMeasureDuration, ippmAggrMeasureDuration,
ippmAggrMeasureFilter,
ippmAggrMeasureLowThreshold,
ippmAggrMeasureHighThreshold,
ippmAggrMeasureHistorySize, ippmAggrMeasureHistorySize,
ippmAggrMeasureStorageType, ippmAggrMeasureStorageType,
ippmAggrMeasureHistoryOwner, ippmAggrMeasureHistoryOwner,
ippmAggrMeasureHistoryOwnerIndex, ippmAggrMeasureHistoryIndex,
ippmAggrMeasureHistoryMetric, ippmAggrMeasureHistoryMetric,
ippmAggrMeasureAdminState, ippmAggrMeasureAdminState,
ippmAggrMeasureFastReport, ippmAggrMeasureFastReport,
ippmAggrMeasureMap,
ippmAggrMeasureResultsMgmt, ippmAggrMeasureResultsMgmt,
ippmAggrMeasureLastUpdate, ippmAggrMeasureLastUpdate,
ippmAggrMeasureOperState, ippmAggrMeasureOperState,
ippmAggrMeasureNbPktsTreated, ippmAggrMeasureNbPktsTreated,
ippmAggrMeasureStatus ippmAggrMeasureStatus
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IPPM AggregatedMeasure Group" "The IPPM AggregatedMeasure Group"
::= { ippmGroups 5} ::= { ippmGroups 4}
ippmReportGroup OBJECT-GROUP
OBJECTS {
ippmReportSetupMeasureOwner,
ippmReportSetupMeasureIndex,
ippmReportSetupMeasureMetric,
ippmReportSetupDefinition,
ippmReportSetupUpDownThreshold,
ippmReportSetupLowThreshold,
ippmReportSetupHighThreshold,
ippmReportSetupDurationThresUnit,
ippmReportSetupDurationThreshold,
ippmReportSetupReportSize,
ippmReportSetupResultsMgmt,
ippmReportSetupNMS,
ippmReportSetupNotification,
ippmReportSetupMap,
ippmReportSetupStatus,
ippmReportPathToResults,
ippmReportTimestamp,
ippmReportValue
}
STATUS current
DESCRIPTION
"The IPPM Report Group"
::= { ippmGroups 6}
ippmOwnersGroup OBJECT-GROUP ippmOwnersGroup OBJECT-GROUP
OBJECTS { OBJECTS {
ippmOwnersOwner,
ippmOwnersGrantedMetrics, ippmOwnersGrantedMetrics,
ippmOwnersQuota, ippmOwnersQuota,
ippmOwnersIpAddressType, ippmOwnersIpAddressType,
ippmOwnersIpAddress, ippmOwnersIpAddress,
ippmOwnersEmail, ippmOwnersEmail,
ippmOwnersSMS,
ippmOwnersStatus ippmOwnersStatus
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IPPM Owners Group" "The IPPM Owners Group"
::= { ippmGroups 7} ::= { ippmGroups 5}
ippmNotificationGroup NOTIFICATION-GROUP ippmNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS { NOTIFICATIONS {
ippmUpAndDownReport, ippmAggrMeasureReport,
ippmInBandReport,
ippmOutBandReport,
ippmAboveReport,
ippmBelowReport,
ippmEventsDurationExceededReport,
ippmCompletedMeasureReport,
ippmAggrMeasureHistoryFull,
ippmNetMeasureHistoryFull, ippmNetMeasureHistoryFull,
ippmReportLogFull ippmAggrMeasureHistoryFull
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The IPPM Notification Group" "The IPPM Notification Group"
::= { ippmGroups 8} ::= { ippmGroups 6}
END END
8 Security Considerations 8 Security Considerations
8.1 VACM Access control 8.1 VACM Access control
View Based Access Control, or VACM may be used to restrict access to View Based Access Control, or VACM may be used to restrict access to
certain objects, or even object instances within tables. For example, certain objects, or even object instances within tables. For example,
one may: one may:
+ Give an 'administrator' write access to the ippmOwnersTable, + Give an 'administrator' write access to the ippmOwnersTable,
whereas all other users may only have read access whereas all other users may only have read access
+ Give access to individual rows in the network measure, aggregated + Give access to individual rows in the network measure, aggregated
measure, history, and report table to particular owners based upon measure, history, and report table to particular owners based upon
indexing on an 'owners name', and even upon a particular measure. indexing on an 'owners name', and even upon a particular measure.
This will be illustrated below. This will be illustrated below.
+ Give access of one owners measure, and associated results, to + Give access of one owners measure, and associated results, to
another owner in order to create an aggregated measure based upon the another owner in order to create an aggregated measure based upon the
results. results.
8.1.1 Example of implementing VACM control for the IPPM-REPORTING-MIB 8.1.1 Example of implementing VACM control for the IPPM-REPORTING-MIB
The following example illustrates how one could use VACM to restrict The following example illustrates how one could use VACM to restrict
access to particular objects within the MIB. It uses syntax specific access to particular objects within the MIB. It uses syntax specific
to a particular agent development toolkit, but may be generalized to a particular agent development toolkit, but may be generalized
using the concepts as defined in the VACM MIB. using the concepts as defined in the VACM MIB.
skipping to change at page 74, line 17 skipping to change at page 61, line 9
It is then a customer/user responsibility to ensure that the SNMP It is then a customer/user responsibility to ensure that the SNMP
entity giving access to an instance of this MIB, is properly entity giving access to an instance of this MIB, is properly
configured to give access to the objects only to those principals configured to give access to the objects only to those principals
(users) that have legitimate rights to indeed GET or SET (users) that have legitimate rights to indeed GET or SET
(change/create/delete) them. (change/create/delete) them.
9 Document management 9 Document management
9.1 Open issues 9.1 Open issues
Usage of accessible-for-notify for an index ? Smilint complains when accessible-for-notify is used for an index.
9.2 Changes done since release 03 9.2 Changes done since release 04
Report Group deleted:
reportHistoryTable deleted;
reportSetupTable deleted;
6 related notifications deleted;
low and high thresholds added in ippmAggrMeasureTable;
TC IppmOwnerIndex added to clearly define the owner namespace.
GMTTimestamp time origine changed to NTP (1900).
9.3 Changes done since release 03
+ SMI subtype: INTEGER vs Integer32...; + SMI subtype: INTEGER vs Integer32...;
+ SMI UNITS: Clauses added; + SMI UNITS: Clauses added;
+ cleanup of DEFVAL values; + cleanup of DEFVAL values;
+ Counter/index wrapping: + Counter/index wrapping:
the index of the table wrap independently of the sequence of the the index of the table wrap independently of the sequence of the
results. That makes it very difficult for application to track the results. That makes it very difficult for application to track the
results. As the sequence id identify the instance of the result of a results. As the sequence id identify the instance of the result of a
measure the index is removed both from the table and from the index measure the index is removed both from the table and from the index
clause. clause.
ippmHistoryIndex removed from ippmHistoryEntry; ippmHistoryIndex removed from ippmHistoryEntry;
ippmHistoryIndex removed from the INDEX clause of the table ippmHistoryIndex removed from the INDEX clause of the table
ippmHistoryTable; ippmHistoryTable;
ippmReportIndex removed from ippmReportEntry; ippmReportIndex removed from ippmAggrHistoryEntry;
ippmReportIndex removed from the clause INDEX of ippmReportEntry ippmReportIndex removed from the clause INDEX of
INDEX clause of the table ippmReportTable; ippmAggrHistoryEntry INDEX clause of the table ippmAggrHistoryTable;
9.3 Changes done since release 02 9.4 Changes done since release 02
+ Security/VACM: + Security/VACM:
sharing table removed; sharing table removed;
ippmMeasure merged with networkMeasure and AggrMeasure to have ippmMeasure merged with networkMeasure and AggrMeasure to have
all networkMeasure objects in read only. all networkMeasure objects in read only.
Indexes belong to the table; Indexes belong to the table;
remove all reference to SNMPv1 ...inSNMPTrapPDU remove all reference to SNMPv1 ...inSNMPTrapPDU
+ System: + System:
ippmSystemOperationalStatus added ippmSystemOperationalStatus added
ippmSynchronizationTable adapted for proxy mode: ippmSynchronizationTable adapted for proxy mode:
ippmPointOfMeasureIndex added to the index of ippmPointOfMeasureIndex added to the index of
ippmSystemCurrentSynchronization removed from system ippmSystemCurrentSynchronization removed from system
capabilities: capabilities:
ippmPointOfMeasureMetrics added to ippmPointOfMeasureMetrics added to
IppmPointOfMeasureEntry; IppmPointOfMeasureEntry;
ippmMetricType added to ippmMetricsTable; ippmMetricsType added to ippmMetricsTable;
+ Owners + Owners
ippmMetricMaxHistorySize replaced with quota in ippmOwnersTable; ippmMetricMaxHistorySize replaced with quota in ippmOwnersTable;
+ ippmOnHistoryFullAction replaced with resultsMgmt in aggr and network.; + ippmOnHistoryFullAction replaced with resultsMgmt in aggr and network.;
+ network measure: + network measure:
ippmNetMeasureOperState added to indicate the state of the network ippmNetMeasureOperState added to indicate the state of the network
measure measure
state; state;
added burst mode; added burst mode;
state of the measure: nb of singletons collected and oper status state of the measure: nb of singletons collected and oper status
added; added;
+aggregated metric: +aggregated metric:
fast report added to get raw results by email; fast report added to get raw results by email;
+ report setup: + report setup:
onReportDeliveryClearHistory removed from IppmReportDefinition; onReportDeliveryClearHistory removed from
IppmMetricResultFilter;
+ Map field added to network, aggr and report tables to help to map + Map field added to network, aggr and report tables to help to map
on topology map or admin view. on topology map or admin view.
10 References 10 References
[1] Bradner, S., "The Internet Standards Process -- Revision 3", BCP [1] Bradner, S., "The Internet Standards Process -- Revision 3", BCP
9, RFC 2026, October 1996. 9, RFC 2026, October 1996.
[2] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for [2] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for
Describing SNMP Management Frameworks", RFC 2571, April 1999. Describing SNMP Management Frameworks", RFC 2571, April 1999.
[3] Rose, M., and K. McCloghrie, "Structure and Identification of [3] Rose, M., and K. McCloghrie, "Structure and Identification of
Management Information for TCP/IP-based Internets", STD 16, RFC Management Information for TCP/IP-based Internets", STD 16, RFC
1155, May 1990. 1155, May 1990.
 End of changes. 

This html diff was produced by rfcdiff 1.23, available from http://www.levkowetz.com/ietf/tools/rfcdiff/