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 owner’s network measures. | aggregated metrics on another ownerÆs 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 NMS’s query the IPPM-REPORTING- | In this architecture, the different NMSÆs 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 | |||
NMS’s and event handling. | NMSÆs 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 owner’s measure, and associated results, to | + Give access of one ownerÆs 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/ |