IPPM-MIB
File:
IPPM-MIB.mib (76581 bytes)
Imported modules
Imported symbols
Defined Types
TimeUnit |
|
A list of time units. |
TEXTUAL-CONVENTION |
|
|
|
|
INTEGER |
year(1), month(2), week(3), day(4), hour(5), second(6), ms(7), us(8), ns(9) |
|
GMTDateAndTime |
|
A date-time specification.
field octets contents range
----- ------ -------- -----
1 1 year* 0..255
2 2 month 1..12
3 3 day 1..31
4 4 hour 0..23
5 5 minutes 0..59
6 6 seconds 0..59
7 7-8 1/10 milliseconds 0..9999
*Notes: 0 stands for year 2000.
For example, '0102192015100500' represent 8:15pm, 10
seconds and 50 ms GMT on 19 February 2001 and is
displayed as 01-02-19,20:15:10,0500 |
TEXTUAL-CONVENTION |
|
|
|
|
OCTET STRING |
Size(8) |
|
GmtTimeFilter |
|
GmtTimeFilter TC is inspired by the TimeFilter defined
in the RMON2. The reference of the time of TimeFilter is
the local value of sysUptime while GmtTimeFilter uses a
absolute reference of time.
GmtTimeFilter is intended to be used for the index of a
table. It allows an application to download only those
rows changed since a particular time. A row is
considered changed if the value of any object in the row
changes or if the row is created or deleted.
Each new conceptual row will be associated with the
timeMark instance which was created at the value of
ippmTimeSysTimer.
It is intended to provide an absolute timestamp index
for the result of measures. Typically to each singleton
produced by an IPPM measure is associated the timemark
corresponding to the moment of the measure.
illustrations:
Consider the 2 tables measureTable and resultTable
measureTable OBJECT-TYPE
SYNTAX SEQUENCE OF MeasureEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION ''
::= { fooMib 1 }
INDEX { measureIndex }
resultTable OBJECT-TYPE
SYNTAX SEQUENCE OF ResultEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION ''
::= { fooMib 2 }
INDEX { measureIndex, resultTimeMark }
ResultEntry {
resultTimeMark TimeFilter,
resultCounts Counter
}
Should there be two measure rows in the measure table
(measureIndex == 1, measureIndex == 2) which produced
results asynchronously (e.g. made at Poisson intervals
or sibling) and log them in the result table.
Measure 1 produced the result 34 at time
0102192015100500 GMT, while row 2 produced the value 54
most recently (10ms later) at time 0102192015100600 GMT,
and both rows are updated on several later occasions
such that the current values are 37 and 53 respectively.
Then the following resultCounts instances would exist.
resultCounts.1.0102192015100500 34
resultCounts.2.0102192015100600 54
resultCounts.1.0102192015100950 65
resultCounts.1.0102192015100600 57
resultCounts.2.0102192015100800 48
resultCounts.2.0102192015100850 53
resultCounts.1.0102192015110050 49
resultCounts.1.0102192015110200 37
The following get-bulk explains how a NMS retrieves the
results of the measures.
get-bulk(nonRptrs=1, maxReps=10, resultCounts.1);
returns:
resultCounts.1.0102192015100500 == 34
resultCounts.1.0102192015100950 == 65
resultCounts.1.0102192015100600 == 57
resultCounts.1.0102192015110050 == 49
resultCounts.1.0102192015110200 == 37
# return lexigraphically-next two MIB instances
get-bulk(nonRptrs=0, maxReps=2,
resultCounts.1.0102192015100600,
resultCounts.2.0102192015100600);
returns:
resultCounts.1.0102192015100950 == 65
resultCounts.2.0102192015100800 == 48
resultCounts.1.0102192015100600 == 57
resultCounts.2.0102192015100850 == 53
get-bulk(nonRptrs=0, maxReps=2,
resultCounts.1.0102192015110200,
resultCounts.2.0102192015110200);
returns:
return lexigraphically-next two MIB instances
no 'resultTable' counter values at all are
returned because neither counter has been updated since
time 0102192015110200
|
TEXTUAL-CONVENTION |
|
|
|
|
GMTDateAndTime |
|
|
TypeP |
|
This textual convention is used to describe the
protocols encapsulation list of a packet, and is used as
the value of the SYNTAX clause for the type of the Src
and Dst of a IPPM measure. The RFC2895 specifies a macro
for the definition of protocols identifiers while its
companion document, the RFC2896 defines a set of
protocols identifiers.
Notes: An IPPM TypeP does not differ from RMON2
Protocols identifiers but TypeP usage in IPPM MIB
differs from Protocol identifier usage in RMON2. A IPPM
measure is active so generally TypeP does not describe
the link layer (i.e. ether2...). Valid Internet packets
are sent from Src to Dst. Then the choice of the link
layer relies on the Internet stack.
For example, the RFC2896 defines the protocol identifier
'16.0.0.0.1.0.0.8.0.0.0.0.6.0.0.0.23.3.0.0.0' which
represents ether2.ip.tcp.telnet and the protocol
identifier 16.0.0.0.1.0.0.8.0.0.0.0.4.0.0.0.17.3.0.0.0
which stands for ether2.ip.ipip4.udp. The corresponding
TypeP are '12.0.0.8.0.0.0.0.6.0.0.0.23.3.0.0.0'
(ip.tcp.telnet) and 12.0.0.8.0.0.0.0.4.0.0.0.17.3.0.0.0
(ip.ipip4.udp). |
TEXTUAL-CONVENTION |
|
|
|
|
OCTET STRING |
|
|
IppmReportDefinition |
|
IppmReportDefinition is intended to be used for the description
of a report of results of a measure.
By default all the results of a measure belong to the report of
this measure.
The first step of the report elaboration set up triggers on the
value of the measure and on the distribution over time of the events
generated by these triggers.
The measure results corresponding to an event are reported
periodically or sent in alarms as soon as the event appears.
The end of description describe housekeeping tasks.
An action if performed if the corresponding bit is set to 1.
onSingleton(1):
The actions are performed each time a new result of the
measure occurs.
onMeasureCycle(2):
The actions are performed on the results of the measure
at the end of each cycle of measure.
onMeasureCompletion(3):
The actions are performed on the results of the measure
at the end of the measure.
reportOnlyUptoDownMetricResults(4):
Report the contiguous results which are on opposite sides
of the metric threshold.
reportOnlyExceededEventsDuration(5):
Report the current result of a serie of contiguous
results which exceed the metric threshold when the
duration of the serie is over the events duration
threshold seconds.
inIppmReportTable(6):
store the report in the local ippmReportTable.
inSNMPTrapPDU(7):
Send the report using a SNMP-Trap-PDU.
inSNMPv2TrapPDU(8):
Send the report using a SNMPv2-Trap-PDU.
inInformRequestPDU(9):
Send the report using a SNMP InformRequest-PDU.
inEmail(10):
Send the report using an email.
inSMS(11):
Send the report using a SMS.
clearHistory(12):
Remove all the results corresponding to this measure
from the ippmHistoryTable.
clearReport(13):
Remove all the results corresponding to this measure
from the ippmReportTable.
|
TEXTUAL-CONVENTION |
|
|
|
|
BITS |
none(0), onSingleton(1), onMeasureCycle(2), onMeasureCompletion(3), reportOnlyUptoDownMetricResults(4), reportOnlyExceededEventsDuration(5), inIppmReportTable(6), inSNMPTrapPDU(7), inSNMPv2TrapPDU(8), inInformRequestPDU(9), inEmail(10), inSMS(11), clearHistory(12), clearReport(13) |
|
IppmStandardMetrics |
|
The definition of the standardized IPPM metrics.
if the draftMetrics bit is set then the other bits describe a WG
draft metric identifiers.
|
TEXTUAL-CONVENTION |
|
|
|
|
BITS |
draftMetrics(0), instantaneousUnidirectionalConnectivity(1), instantaneousBidirectionalConnectivity(2), intervalUnidirectionalConnectivity(3), intervalBidirectionalConnectivity(4), intervalTemporalConnectivity(5), onewayDelay(6), onewayDelayPoissonStream(7), onewayDelayPercentile(8), onewayDelayMedian(9), onewayDelayMinimum(10), onewayDelayInversePercentile(11), onewayPacketLoss(12), onewayPacketLossPoissonStream(13), onewayPacketLossAverage(14), roundtripDelay(15), roundtripDelayPoissonStream(16), roundtripDelayPercentile(17), roundtripDelayMedian(18), roundtripDelayMinimum(19), roundtripDelayInversePercentile(20) |
|
IppmOwnersControlEntry |
|
SEQUENCE |
|
|
|
|
ippmOwnersControlOwner |
OwnerString |
|
|
ippmOwnersControlIndex |
Integer32 |
|
|
ippmOwnersControlGrantedMetrics |
IppmStandardMetrics |
|
|
ippmOwnersControlGrantedRules |
BITS |
|
|
ippmOwnersControlIpAddress |
DisplayString |
|
|
ippmOwnersControlEmail |
DisplayString |
|
|
ippmOwnersControlSMS |
DisplayString |
|
|
ippmOwnersControlStatus |
OwnerString |
|
IppmResultSharingEntry |
|
SEQUENCE |
|
|
|
|
ippmResultSharingOwner |
OwnerString |
|
|
ippmResultSharingIndex |
Integer32 |
|
|
ippmResultSharingMeasureOwner |
OwnerString |
|
|
ippmResultSharingMeasureIndex |
Integer32 |
|
|
ippmResultSharingGrantedOwner |
OwnerString |
|
|
ippmResultSharingStatus |
RowStatus |
|
IppmMetricEntry |
|
SEQUENCE |
|
|
|
|
ippmMetricIndex |
Integer32 |
|
|
ippmMetricCapabilities |
INTEGER |
|
|
ippmMetricUnit |
INTEGER |
|
|
ippmMetricDescription |
DisplayString |
|
|
ippmMetricMaxHistorySize |
Integer32 |
|
IppmMeasureEntry |
|
SEQUENCE |
|
|
|
|
ippmMeasureOwner |
OwnerString |
|
|
ippmMeasureIndex |
Integer32 |
|
|
ippmMeasureName |
DisplayString |
|
|
ippmMeasureMetrics |
IppmStandardMetrics |
|
|
ippmMeasureBeginTime |
GMTDateAndTime |
|
|
ippmMeasureClockPeriodUnit |
TimeUnit |
|
|
ippmMeasureClockPeriod |
Integer32 |
|
|
ippmMeasureDurationUnit |
TimeUnit |
|
|
ippmMeasureDuration |
Integer32 |
|
|
ippmMeasureHystorySize |
Integer32 |
|
|
ippmMeasureStorageType |
StorageType |
|
|
ippmMeasureStatus |
RowStatus |
|
IppmHistoryEntry |
|
SEQUENCE |
|
|
|
|
ippmHistoryTimeMark |
GMTDateAndTime |
|
|
ippmHistoryValue |
Integer32 |
|
IppmNetworkMeasureEntry |
|
SEQUENCE |
|
|
|
|
ippmNetworkMeasureSrcTypeP |
TypeP |
|
|
ippmNetworkMeasureSrc |
OCTET STRING |
|
|
ippmNetworkMeasureDstTypeP |
TypeP |
|
|
ippmNetworkMeasureDst |
OCTET STRING |
|
|
ippmNetworkMeasureClockPattern |
OCTET STRING |
|
|
ippmNetworkMeasureTimeoutDelay |
Integer32 |
|
|
ippmNetworkMeasureL3PacketSize |
Integer32 |
|
|
ippmNetworkMeasureDataPattern |
OCTET STRING |
|
IppmAggregatedMeasureEntry |
|
SEQUENCE |
|
|
|
|
ippmAggregatedMeasureHistoryOwner |
OwnerString |
|
|
ippmAggregatedMeasureHistoryOwnerIndex |
Integer32 |
|
|
ippmAggregatedMeasureHistoryMetric |
Integer32 |
|
IppmReportSetupEntry |
|
SEQUENCE |
|
|
|
|
ippmReportSetupDefinition |
IppmReportDefinition |
|
|
ippmReportSetupMetricThreshold |
Integer32 |
|
|
ippmReportSetupEventsDurationThreshold |
Integer32 |
|
|
ippmReportSetupNMS |
DisplayString |
|
IppmReportEntry |
|
SEQUENCE |
|
|
|
|
ippmReportTimeMark |
GMTDateAndTime |
|
|
ippmReportValue |
Integer32 |
|
Defined Values
ippmMib |
1.3.6.1.3.10000 |
This memo defines a portion of the Management Information Base
(MIB) for use with network management protocols in TCP/IP-based
internets. In particular, It defines a registry of the IPPM working
group metrics and specifies the objects used for managing IPPM
metrics measures, pushing alarms and reporting the measures results.
|
MODULE-IDENTITY |
|
|
|
metrics |
1.3.6.1.3.10000.1 |
OBJECT IDENTIFIER |
|
|
|
rfc |
1.3.6.1.3.10000.1.1 |
OBJECT IDENTIFIER |
|
|
|
draft |
1.3.6.1.3.10000.1.2 |
OBJECT IDENTIFIER |
|
|
|
id |
1.3.6.1.3.10000.1.3 |
OBJECT IDENTIFIER |
|
|
|
ippmHistoryGroup |
1.3.6.1.3.10000.6 |
OBJECT IDENTIFIER |
|
|
|
ippmOwnersControlTable |
1.3.6.1.3.10000.3.1 |
A NMS entity wishing to create and activate remote Ippm
measurements in an agent must previously be registered
in the ippmOwnersControlTable using the conceptual row
mechanism described in the RMON2.
The control of the access to the results of the measures
is managed in the table ippmResultSharing.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmOwnersControlEntry |
|
ippmOwnersControlEntry |
1.3.6.1.3.10000.3.1.1 |
The description of the resources the agent granted to a
SNMP application.
For example, an instance of ippmOwnersControlOwner with
an OwnerString 'acme', which represents the 14th owner
created in ippmOwnersControlTable would be named
ippmOwnersControlEntryOwner.14.
Notes:
The ippmOwnersControlIndex value is a local index
managed directly by the agent. It is not used in anyway
in the other IPPM tables. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmOwnersControlEntry |
|
|
ippmOwnersControlIndex |
1.3.6.1.3.10000.3.1.1.1 |
An arbitrary index that only identify an entry in this
table |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
1..65535 |
|
ippmOwnersControlGrantedRules |
1.3.6.1.3.10000.3.1.1.4 |
Defines the rules this owner may act as in the current IPPM MIB
instance.
all(0):
The owner is granted with all the rules.
readonly(1):
The measures (not only the metrics) allowed to this
owner are setup by the manager of the point of measure. The owner can
not add new measures for these metrics. The creation and the
configuration of the measures corresponding to these metrics are
managed by the manager of the point of measure.
permanent(2):
The measures (not only the metrics) allowed to this
owner are determined by the manager of the point of measure. The
owner can not add new measures for these metrics. The creation and
the first configuration of the measures corresponding to these
metrics are managed by the manager of the point of measure. The owner
may modify the measures parameters of the entries of the
corresponding ippmMeasureEntry which access is read-write.
Typically that permits the owner to suspend the
measures, to change the begin and end of the measures.
sender(3):
The owner may only activate measures for theses metrics
that send packets from the current point of measure. This flag is
only suitable for network measures. It shall be ignored for derived
metrics.
receiver(2):
The owner may only activate measures for theses metrics
that receive packets on the current point of measure. This flag is
only suitable for network measures. It shall be ignored for derived
metrics. Such control increases the security. The owner may not
generate packets from the probe.
report(4):
The owner may setup aggregated metrics on the measures
corresponding to these metrics.
alarm(5):
The owner may setup alarms on the results of the
measures metrics.
e.g.:
if the owner Acme is granted with the metric Instantaneous-
Unidirectional-Connectivity as a Receiver in the current point of
measure, then Acme can not setup a Instantaneous-Unidirectional-
Connectivity to another point of measure.
|
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
BITS |
all(0), readonly(1), permanent(2), sender(2), receive(3), report(4), alarm(5) |
|
ippmOwnersControlIpAddress |
1.3.6.1.3.10000.3.1.1.5 |
The IP address of the NMS corresponding to this owner.
The address is human readable and is represented using the dot
format. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
DisplayString |
|
|
ippmOwnersControlSMS |
1.3.6.1.3.10000.3.1.1.7 |
The SMS phone number of the NMS corresponding to this
owner. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
DisplayString |
|
|
ippmResultSharingTable |
1.3.6.1.3.10000.3.2 |
ippmResultSharingTable controls finely the access of
an owner to the measure results of other owners. An
owner may grant another to read the result of its
measure.
Entries may exist in ippmResultSharingTable even is the
measures to be shared are not yet defined. Deleting a
measure entry in the ippmMeasureTable does not delete
the entries corresponding to this measure in the
ippmResultSharingTable.
IppmResultSharingTable is optional. If this table is not
implemented then the owner has only access to its
measure results. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmResultSharingEntry |
|
ippmResultSharingEntry |
1.3.6.1.3.10000.3.2.1 |
An entry allows an owner to read the results of a
measure owned by another owner.
It permits 2 typical usages:
creating derived measurements on these results;
reading the results from a remote NMS.
Example: if acme.12 is a One-way-Delay(6) measure
Acme may allows Peter to make derived metrics
On the results of this measure.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmResultSharingEntry |
|
|
ippmResultSharingOwner |
1.3.6.1.3.10000.3.2.1.1 |
The owner of this result control entry. Typically the
owner which created this conceptual row. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OwnerString |
|
|
ippmResultSharingIndex |
1.3.6.1.3.10000.3.2.1.2 |
The index of this result control entry. The value is
managed by the owner. On creation a SNMP error 'inconsistentValue' is
returned if this value is already in use by this owner. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
1..65535 |
|
ippmResultSharingMeasureOwner |
1.3.6.1.3.10000.3.2.1.3 |
The owner of the measure to be shared. The couple
ippmResultSharingMeasureOwner, ippmResultSharingMeasureIndex
identifies absolutely a measure |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OwnerString |
|
|
ippmResultSharingGrantedOwner |
1.3.6.1.3.10000.3.2.1.5 |
The owner which is granted to access to the result of
the measure described by the couple ippmResultSharingMeasureOwner,
ippmResultSharingMeasureIndex. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
OwnerString |
|
|
ippmResultSharingStatus |
1.3.6.1.3.10000.3.2.1.6 |
The status of this table entry. Once the entry status
is set to active. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
RowStatus |
|
|
ippmSystemSynchonizationType |
1.3.6.1.3.10000.4.2 |
ippmSystemSynchonizationType describes the mechanism
used to synchronise the system.
other
The synchronisation process must be defined
extensively in the ippmSystemSynchonizationDescription.
ntp
The system is synchronised using the network
time protocol. The NTP synchronisation must be described
finely in the ippmSystemSynchonizationDescription.
gps
The system is synchronised using the GPS clocks.
cdma
The system is synchronised using the CDMA
clocks.
|
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
other(0), ntp(1), gps(2), cdma(4) |
|
ippmSystemClockResolution |
1.3.6.1.3.10000.4.4 |
ippmSystemClockResolution provides the precision of the
clock used for the measures. The unit is 1/10 of
millisecond. For example, the clock on an old Unix host
might advance only once every 10 msec, and thus have a
resolution of only 10 msec. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmSystemSynchronisationTime |
1.3.6.1.3.10000.4.5 |
The time when occurs the last synchronisation of the
clock. The last synchronisation must be set even if the
synchronisation is not automatic. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
DateAndTime |
|
|
ippmSystemClockAccuracy |
1.3.6.1.3.10000.4.6 |
The most recent accuracy of the clock computed. The
accuracy must be compute even if the synchronisation is
not automatic. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmSystemClockSkew |
1.3.6.1.3.10000.4.7 |
The most recent skew of the clock computed. The
ippmSystemSkew must be compute even if the
synchronisation is not automatic. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmSystemPrevClockAccuracy |
1.3.6.1.3.10000.4.8 |
The previous accuracy of the clock measured. The
ippmSystemPrevClockAccuracy must be computed even if the
synchronisation is not automatic. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmSystemPrevClockSkew |
1.3.6.1.3.10000.4.9 |
The previous skew of the clock measured. The
ippmSystemPrevClockSkew must be computed even if the
synchronisation is not automatic. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmMetricTable |
1.3.6.1.3.10000.5.1 |
This table describes the current implementation. This
table is mandatory. Each IPPM standardized metric must
be described in the table.
In reporting mode the entries of this table may be not
accessible. It means that the table is handle internally
by the measure software.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmMetricEntry |
|
ippmMetricEntry |
1.3.6.1.3.10000.5.1.1 |
An entry describes the static capabilities of a metric
implementation. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmMetricEntry |
|
|
ippmMetricIndex |
1.3.6.1.3.10000.5.1.1.1 |
ippmMetricIndex defines an unambiguous index for each
standardized metric. Its value is the value of the node of the
metric in the IPPM-MIB metrics registry ippmMib.metrics.rfc.
Each metric registered in the standard registry must be present
in this table.
This index is used to identify the metric performed among the
IPPM-MIB entities involved in the measure.
Example:
The index of the metric onewayPacketLossAverage which is
registered as ippmMib.metrics.rfc.onewayPacketLossAverage will
always have the value 14. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
1..65535 |
|
ippmMetricCapabilities |
1.3.6.1.3.10000.5.1.1.2 |
notImplemented
the metric is not implemented.
implemented
the metric is implemented. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
notImplemented(0), implemented(1) |
|
ippmMetricUnit |
1.3.6.1.3.10000.5.1.1.3 |
The unit used in the current entity for the results of
the measure of this metric. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
INTEGER |
noUnit(0), second(1), ms(2), us(3), ns(4), percentage(5), packets(6), byte(6), kbyte(7), megabyte(8) |
|
ippmMetricMaxHistorySize |
1.3.6.1.3.10000.5.1.1.5 |
Specifies the maximal number of results that a metric
measure can save in the ippmHistoryTable. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmMeasureTable |
1.3.6.1.3.10000.5.2 |
The table of all the IPPM measures which are running in
the device. They may not be active.
a measure consists in a subset of metrics to compute.
The results of the measure may be saved in the
ippmHistoryTable. The configuration of the measure sets
the size of the history requested in
ippmMeasureHystorySize.
The maximal number of MIB objects to be collected in the
portion of ippmHistoryTable associated with this metric
depends the value of the ippmMetricMaxHistorySize.
The value of each metric ippmMeasureHystorySize must not
be over the value of ippmMetricMaxHistorySize
corresponding to this metric in ippmMetricTable.
In reporting mode the entries of this table may be not
accessible. It means that the table is handle internally
by the measure software.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmMeasureEntry |
|
ippmMeasureEntry |
1.3.6.1.3.10000.5.2.1 |
A SNMP entity wishing to create and activate a
measurement adds a new entry in the ippmMeasureTable.
Typically the configuration operation set the values of
the conceptual row parameters using an unused owner
index and sets the status of the row to createAndGo.
An SNMP error 'inconsistentValue' is returned if the
owner index is out of range. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmMeasureEntry |
|
|
ippmMeasureOwner |
1.3.6.1.3.10000.5.2.1.1 |
The owner who has configured this entry. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OwnerString |
|
|
ippmMeasureIndex |
1.3.6.1.3.10000.5.2.1.2 |
The owner index of the measure. The value is managed by
the owner. An SNMP error 'inconsistentValue' is returned
if this value is already in use by this owner. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
1..65535 |
|
ippmMeasureName |
1.3.6.1.3.10000.5.2.1.3 |
The name of the instance of the metric. It illustrates
the specificity of the metric and includes the metric
and the typeP.
example: IP-port-HTTP-connectivity |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
DisplayString |
|
|
ippmMeasureMetrics |
1.3.6.1.3.10000.5.2.1.4 |
Defines the metrics to compute within this measure. A
measure may be configured for the result of different
metrics singletons to be archive in the
ippmHistoryTable. The ippmMetricIndex of the created
result has the value of the bit index of the
corresponding ippmMeasureMetrics as explained above in
the ippmMetricIndex definition.
Example:
A measure asking for One-way-Delay(6) and One-way-
Packet-Loss(12) generated a flow of singletons which are
logged in the ippmHistoryTable. The singletons created
for the One-way-Delay measure have a value of
ippmMetricIndex of 6 while the created singletons for
the One-way-Packet-Loss measure have a value of
ippmMetricIndex of 12. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
IppmStandardMetrics |
|
|
ippmMeasureClockPeriod |
1.3.6.1.3.10000.5.2.1.7 |
Specifies the among of time between 2 sampling
intervals.
Notes:
This interval generates a flow of periodical instants
which may be transformed as a flow of unpredictable
instants of measure by the
ippmNetworkMeasureClockPattern. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmMeasureDuration |
1.3.6.1.3.10000.5.2.1.9 |
Specifies the duration of the measure. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmMeasureHystorySize |
1.3.6.1.3.10000.5.2.1.10 |
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 overwrite
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.
|
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmMeasureStorageType |
1.3.6.1.3.10000.5.2.1.11 |
This object defines whether this row and the measure
controlled by this row are kept in volatile storage and
lost upon reboot or if this row is backed up by
non-volatile or permanent storage.
Possible values are: other(1), volatile(2), nonVolatile(3),
permanent(4), readOnly(5) |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
StorageType |
|
|
ippmMeasureStatus |
1.3.6.1.3.10000.5.2.1.12 |
The status of this table entry. Once the entry status
is set to active, the associate entry cannot be
modified. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
RowStatus |
|
|
ippmHistoryTable |
1.3.6.1.3.10000.6.1 |
The table of the results of the measures. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmHistoryEntry |
|
ippmHistoryEntry |
1.3.6.1.3.10000.6.1.1 |
An ippmHistoryEntry entry is one of the result of an
measure identified by the index members ippmMeasureOwner
and ippmMeasureIndex.
In the index :
+ ippmMeasureOwner and ippmMeasureIndex identify
the ippmMeasureEntry on whose behalf this entry was
created;
+ ippmMetricIndex identifies the ippmMetricEntry
of the metric to measure;
+ ippmLogTimeMark value is the absolute time
when the result of the metric was measured.
The ippmHistoryTimeMark value is the absolute time when
the ippmHistoryValue was performed.
IppmHistoryValue is the value of the metric measured at
the time ippmHistoryTimeMark.
Example:
A one way delay measure is created by the entity 'acme'
using the owner index 1 and setting the 6th bit
(corresponding to One-way-Delay) of ippmMeasureMetrics
to 1.
Consider that the result of the one way delay measured
for acme on the day 15 of June at 8h20mn 10s 10ms is 23.
The result is identified as the singleton
ippmHistoryValue.acme.1.6.0106150820100100 and stored
with value 23.
Its value may be retrieved using a get-
next(ippmHistoryValue.acme.1.6.0106150820100099) which
returns (ippmHistoryValue.acme.1.6.0106150820100100 ==
23). The ippmMetricIndex value of '6' corresponds to the
6th metric of ippmMetricTable which is Type-P-One-way-
Delay.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmHistoryEntry |
|
|
ippmHistoryTimeMark |
1.3.6.1.3.10000.6.1.1.1 |
The instant of the measure of the result. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
GMTDateAndTime |
|
|
ippmHistoryValue |
1.3.6.1.3.10000.6.1.1.2 |
The value of the measure. |
Status: current |
Access: read-only |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmNetworkMeasureTable |
1.3.6.1.3.10000.7.1 |
A entry is a measure which performs network measures
and provides a flow of results.
This table extends the ippmMeasureTable. A network
measure is a specific measure.
It performs several metrics measure per packet exchange.
Each step of a measure produces a singleton result per
metric. The time of the measure and the value of the
metric are saved in the ippmHistoryTable. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmNetworkMeasureEntry |
|
ippmNetworkMeasureEntry |
1.3.6.1.3.10000.7.1.1 |
A SNMP entity wishing to create and activate a network
measure adds a new entry in the ippmMeasureTable and in
IppmNetworkMeasureTable.
Typically the configuration operation set both the
values of the new ippmMeasureEntry and of the new
IppmNetworkMeasureEntry and sets the status of the row
to createAndGo.
An SNMP error 'inconsistentValue' is returned if the
index is out of range.
The ippmMeasureMetrics is set to a list of metrics to be
computed from the same raw packet exchange. Each step of
measure delivers a singleton per chosen metric. Results
are timestamped and saved in the ippmHistoryTable. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmNetworkMeasureEntry |
|
|
ippmNetworkMeasureSrcTypeP |
1.3.6.1.3.10000.7.1.1.1 |
Defines the type P of the source address of the packets
sent by the measure. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
TypeP |
|
|
ippmNetworkMeasureSrc |
1.3.6.1.3.10000.7.1.1.2 |
Specifies the address of the source of the measure.
It is represented as an octet string with specific
semantics and length as identified by the
ippmNetworkMeasureSrcTypeP.
For example, if the ippmNetworkMeasureSrcTypeP indicates
an encapsulation of 'ip', this object length is 4,
followed by the 4 octets of the IP address, in network
byte order. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OCTET STRING |
|
|
ippmNetworkMeasureDstTypeP |
1.3.6.1.3.10000.7.1.1.3 |
Defines the type P of the destination address of the
packets sent by the measure. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
TypeP |
|
|
ippmNetworkMeasureDst |
1.3.6.1.3.10000.7.1.1.4 |
Specifies the address of the destination of the
measure.
It is represented as an octet string with specific
semantics and length as identified by the
ippmNetworkMeasureDstTypeP.
For example, if the ippmNetworkMeasureDstTypeP indicates
an encapsulation of 'ip', this object length is 4,
followed by the 4 octets of the IP address, in network
byte order. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OCTET STRING |
|
|
ippmNetworkMeasureClockPattern |
1.3.6.1.3.10000.7.1.1.5 |
This cyclic clock shapes the profile of the instants of
measurement according to an arbitrary distribution law.
The clock resolution is ippmMeasureClockPeriod. The bits
of the clock set to the value 1 determine the valid
instants of measurement. A measure is to be processed if
and only if the current bit value is 1.
This pseudo-random clock pattern allows the
configuration by the NMS of numerous kind of sampling
law such as periodic or Poisson. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OCTET STRING |
|
|
ippmNetworkMeasureL3PacketSize |
1.3.6.1.3.10000.7.1.1.7 |
Specifies the size of the packets send at the last
network layer in the sense of the TypeP definition. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmNetworkMeasureDataPattern |
1.3.6.1.3.10000.7.1.1.8 |
The current field defines the round robin pattern used
to fill the packet. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OCTET STRING |
|
|
ippmAggregatedMeasureTable |
1.3.6.1.3.10000.8.1 |
This table extends the ippmMeasureTable.
A aggregated measure summarizes the results of previous
network or aggregated measures. The results may saved in
the ippmHistoryTable.
Each step of the measure computation produces a
singleton result per metric. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmAggregatedMeasureEntry |
|
ippmAggregatedMeasureEntry |
1.3.6.1.3.10000.8.1.1 |
A SNMP entity wishing to create and activate a statistic
measure adds a new entry in the ippmMeasureTable and in
ippmAggregatedMeasureTable.
Typically the configuration operation sets both the values of
the new ippmMeasureEntry and of the new
IppmAggregatedMeasureEntry and sets the status of the row to
createAndGo.
The ippmMeasureMetrics defines the metric to compute.
The results of the measure to summarize are identified by
ippmAggregatedMeasureHistoryOwner,
IppmAggregatedMeasureHistoryOwnerIndex and
ippmAggregatedMeasureHistoryMetric
The aggregated task starts at ippmMeasureBeginTime and end after
ippmMeasureDuration. A aggregated result is performed and saved
in the ippmHistoryTable for each ippmMeasureClockPeriod.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmAggregatedMeasureEntry |
|
|
ippmAggregatedMeasureHistoryOwner |
1.3.6.1.3.10000.8.1.1.1 |
The owner of the measure to summarize. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
OwnerString |
|
|
ippmAggregatedMeasureHistoryOwnerIndex |
1.3.6.1.3.10000.8.1.1.2 |
The owner index of the measure to summarize. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
1..65535 |
|
ippmAggregatedMeasureHistoryMetric |
1.3.6.1.3.10000.8.1.1.3 |
The metric of the measure to summarize. |
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmReportSetupTable |
1.3.6.1.3.10000.9.1 |
The ippmReportSetupTable is a list of definition of reports. It
defines the results of a network or aggregated measures which are to
report. A report is saved in the ippmReportTable or sent to an
application using a SNMP Trap, a SNMP inform PDU, an email or a SMS.
The reporting task is not 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.
It extends the definition of a measure: the definition of an measure
may include the definition of a report. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmReportSetupEntry |
|
ippmReportSetupEntry |
1.3.6.1.3.10000.9.1.1 |
The report applies on the results of the measure which is extended
by the current report definition.
Typically the creation or a report sets both the values of the new
measure and those of the new IppmReportSetupEntry.
The ippmReportSetupDefinition describes the data and the events to
include in the report. The definition consists in a list of tasks to
perform on the results of the measure. |
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmReportSetupEntry |
|
|
ippmReportSetupDefinition |
2.9.12.1.3.6.1.3.10000.9.1.1.1 |
The description of the events and actions which participate to
the elaboration of the report.
Send the report using the type of message selected by the bits 8
to 12. The report consists in the results of the measure which have
been saved in the ippmReportTable. If the onEventSendReport(7) bit is
unset the report is not saved.
The message sent is a notification defined in the
ippmNotifications node. The notification sent depends on the step of
the measure:
+ Singleton events are sent using the notification
ippmSingletonAlarm;
+ Exceeded events duration are sent using the
notification ippmEventsDurationExceededAlarm;
+ A report of a cycle of measure is sent using the
notification ippmCycleOfMeasureReport;
+ A report of a complete measure is sent using the
notification ippmCompletedMeasureReport;
Example 1:
The setup of an alarm to be sent to the owner in a SNMP Trap
each time the staircase crosses the metric threshold value of 5:
ippmReportSetupMetricThreshold 5
ippmReportSetupDefinition {
onSingleton(1),
reportOnlyUptoDownMetricResults(4),
inSNMPTrapPDU(8)
}
Example 2:
The setup of a report to be sent to the owner in a SNMP
informRequestPDU per measure cycle. It reports the staircase values
corresponding to a metric threshold of 5:
ippmReportSetupMetricThreshold 5
ippmReportSetupDefinition {
onMeasureCycle(2),
reportOnlyUptoDownMetricResults(4),
inInformRequestPDU(10),
clearHistory(13)
}
Default report:
The default report provides the control protocol with an
implicit mechanism to forward the result of a cycle of measure to the
owner of the measure while deleting the results from the
ippmHistoryTable on reception of the response to the InformRequestPDU
:
ippmReportSetupDefinition {
onMeasureCycle(2),
inInformRequestPDU(10),
clearHistory(13)
}
|
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
IppmReportDefinition |
|
|
ippmReportSetupMetricThreshold |
1.3.6.1.3.10000.9.1.1.2 |
An event is generated when the result of the measure exceeds
the value of ippmReportSetupMetricThreshold.
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.
|
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmReportSetupEventsDurationThreshold |
1.3.6.1.3.10000.9.1.1.3 |
An event is generated when the duration of a serie of results
which are continuously over the metric threshold cross over the
duration of the ippmReportSetupEventsDurationThreshold.
|
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
Integer32 |
|
|
ippmReportSetupNMS |
1.3.6.1.3.10000.9.1.1.4 |
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.
|
Status: current |
Access: read-create |
OBJECT-TYPE |
|
|
|
|
DisplayString |
|
|
ippmReportTable |
1.3.6.1.3.10000.9.2 |
The ippmReportTable logs the results of the reports.
The results consist in a subset of the results of a measure as
described in the report definition. The activation of a up and down
filtering in the report definition limits the results logged to those
corresponding to major events.
Excepted these points the ippmReportTable is identical
to the ippmHistoryTable.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
SEQUENCE OF |
|
|
|
|
IppmReportEntry |
|
ippmReportEntry |
1.3.6.1.3.10000.9.2.1 |
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 an measure to
report. The measure and the report definition are identified by the
index members ippmMeasureOwner and ippmMeasureIndex.
in the index :
+ ippmMeasureOwner and ippmMeasureIndex identify the
ippmMeasureEntry and the ippmReportSetupEntry on whose behalf this
report was created;
+ ippmMetricIndex identifies the ippmMetricEntry of the metric
measured;
+ ippmReportTimeMark value is the absolute time when the value
of the metric was measured.
The ippmReportTimeMark value is the absolute time when the
ippmHistoryValue was performed.
IppmHistoryValue is the value of the metric measured at the time
ippmReportTimeMark.
|
Status: current |
Access: not-accessible |
OBJECT-TYPE |
|
|
|
|
IppmReportEntry |
|
|
ippmSingletonAlarm |
1.3.6.1.3.10000.10.1 |
A notification sent because 2 contiguous results are on
opposite sides of the metric threshold value.
The index of the included ippmReportSetupMetricThreshold
object identifies
the ippmMeasureEntry and the ippmResultSetupEntry that
specified the threshold.
The notification contains the instances of the
ippmReportValue object which raised the threshold. The
ippmHistoryTimeMark of the index identifies the time the
event occurs.
|
Status: current |
Access: read-only |
NOTIFICATION-TYPE |
|
|
|
ippmEventsDurationExceededAlarm |
1.3.6.1.3.10000.10.2 |
A notification sent when the duration of contiguous
raising ippmReportSetupMetricThreshold exceeds the
ippmReportSetupEventsDurationThreshold value. The index
of the included ippmReportSetupDefinition object
identifies
the ippmMeasureEntry and the ippmResultSetupEntry that
specified the report.
The notification contains the instances of the
ippmReportValue objects saved in the ippmReportTable for
this report. The ippmHistoryTimeMark of the index
identifies the time theses measures results where
performed.
|
Status: current |
Access: read-only |
NOTIFICATION-TYPE |
|
|
|
ippmCycleOfMeasureReport |
1.3.6.1.3.10000.10.3 |
A notification sent when a measure cycle completes.
The index of the included ippmReportSetupDefinition
object identifies
the ippmMeasureEntry and the ippmResultSetupEntry that
specified the report.
The notification contains the instances of the
ippmReportValue objects saved in the ippmReportTable for
this measure cycle. The ippmHistoryTimeMark of the index
identifies the time the measures where performed.
|
Status: current |
Access: read-only |
NOTIFICATION-TYPE |
|
|
|
ippmCompletedMeasureReport |
1.3.6.1.3.10000.10.4 |
A notification sent when a measure completes.
The index of the included ippmReportSetupDefinition
object identifies
the ippmMeasureEntry and the ippmResultSetupEntry that
specified the report.
The notification contains the instances of the
ippmReportValue objects saved in the ippmReportTable for
this measure cycle. The ippmHistoryTimeMark of the index
identifies the time the measures where performed.
|
Status: current |
Access: read-only |
NOTIFICATION-TYPE |
|
|
|
ippmCompliance |
1.3.6.1.3.10000.2.1 |
The compliance statement for SNMP entities which
implement the IPPM MIB |
Status: current |
Access: read-only |
MODULE-COMPLIANCE |
|
|
|