ENTERASYS-SERVICE-LEVEL-REPORTING-MIB

TEXTUAL-CONVENTION

An OwnerString. The string length is limited to 32 octets.

TEXTUAL-CONVENTION

Each standard metric is identified below. In order to allow for several metrics to be calculated in a single measure, there is a need to describe in a bit string the metrics to be measured. This textual convention defines a BITS construct that gathers in a bit string a sequence of bits. The bit order corresponds to the order of the metric identifiers in the registry. The first bit (most significant bit) of the string has the index 0. The index 1 corresponds to the first metric of the registry (instantaneousUnidirectionalConnectivity ). Example: One-way-Delay(6) is identified as 6. One-way-Packet-Loss(12) is as 12. A network measure performing both One-way-Delay(6) and One-way-Packet-Loss(12) will be described as '0000001000001000'b, '208'B. Below is a list of defined metrics: reserved (0) Setting this reserved bit has no effect. instantUnidirectionConnectivity (1) The identifier for the Type-P-Instantaneous-Unidirectional- Connectivity metric. REFERENCE RFC2678, section 2. instantBidirectionConnectivity (2) The identifier for the Type-P-Instantaneous-Bidirectional- Connectivity metric. REFERENCE RFC2678, section 3. intervalUnidirectionConnectivity (3) The identifier for the Type-P-Interval-Unidirectional- Connectivity metric. REFERENCE RFC2678, section 4. intervalBidirectionConnectivity (4) The identifier for the Type-P-Interval-Bidirectional- Connectivity metric. REFERENCE RFC2678, section 5. intervalTemporalConnectivity (5) The identifier for the Type-P1-P2-Interval-Temporal- Connectivity metric. REFERENCE RFC2678, section 6. oneWayDelay (6) The identifier for the Type-P-One-way-Delay metric. REFERENCE RFC2679, section 3. oneWayDelayPoissonStream (7) The identifier for the Type-P-One-way-Delay-Poisson-Stream metric. REFERENCE RFC2679, section 4. oneWayDelayPercentile (8) The identifier for the Type-P-One-way-Delay-Percentile metric. REFERENCE RFC2679, section 5.1. oneWayDelayMedian (9) The identifier for the Type-P-One-way-Delay-Median metric. REFERENCE RFC2679, section 5.2. oneWayDelayMinimum (10) The identifier for the Type-P-One-way-Delay-Minimum metric. REFERENCE RFC2679, section 5.3. oneWayDelayInversePercentile (11) The identifier for the Type-P-One-way-Delay-Inverse- Percentile metric. REFERENCE RFC2679, section 5.4. oneWayPacketLoss (12) The identifier for the Type-P-One-way-Packet-Loss metric. REFERENCE RFC2680, section 2. oneWayPacketLossPoissonStream (13) The identifier for the Type-P-One-way-Packet-Loss-Poisson- Stream metric. REFERENCE RFC2680, section 3. oneWayPacketLossAverage (14) The identifier for the Type-P-One-way-Packet-Loss-Average metric. REFERENCE RFC2680, section 4. roundtripDelay (15) The identifier for the Type-P-Round-trip-Delay metric. REFERENCE section 2 of the rfc2681. roundtripDelayPoissonStream (16) The identifier for the Type-P-Round-trip-Delay-Poisson-Stream metric. REFERENCE RFC2681, section 4. roundtripDelayPercentile (17) The identifier for the Type-P-Round-trip-Delay-Percentile metric. REFERENCE RFC2681, section 4.1. roundtripDelayMedian (18) The identifier for the Type-P-Round-trip-Delay-Median metric. REFERENCE RFC2681, section 4.2. roundtripDelayMinimum (19) The identifier for the Type-P-Round-trip-Delay-Minimum metric. REFERENCE RFC2681, section 4.3. roundtripDelayInversePercentile (20) The identifier for the Type-P-Round-trip-Inverse-Percentile metric. REFERENCE RFC2681, section 4.4. oneWayLossDistanceStream (21) The identifier for the Type-P-One-Way-Loss-Distance-Stream metric. REFERENCE RFC3357, section 5.4.1. oneWayLossPeriodStream (22) The identifier for the Type-P-One-Way-Loss-Period-Stream metric. REFERENCE RFC3357, section 5.4.2. oneWayLossNoticeableRate (23) The identifier for the Type-P-One-Way-Loss-Noticeable-Rate metric. REFERENCE RFC3357, section 6.1. oneWayLossPeriodTotal (24) The identifier for the Type-P-One-Way-Loss-Period-Total metric. REFERENCE RFC3357, section 6.2. oneWayLossPeriodLengths (25) The identifier for the Type-P-One-Way-Loss-Period-Lengths metric. REFERENCE RFC3357, section 6.3. oneWayInterLossPeriodLengths (26) The identifier for the Type-P-One-Way-Inter-Loss-Period- Lengths metric. REFERENCE RFC3357, section 6.4. oneWayIpdv (27) The identifier for the Type-P-One-way-ipdv metric. REFERENCE RFC3393, section 2. oneWayIpdvPoissonStream (28) The identifier for the Type-P-One-way-ipdv-Poisson-stream metric. REFERENCE RFC3393, section 3. oneWayIpdvPercentile (29) The identifier for the Type-P-One-way-ipdv-percentile metric. REFERENCE RFC3393, section 4.3. oneWayIpdvInversePercentile (30) The identifier for the Type-P-One-way-ipdv-inverse-percentile metric. REFERENCE RFC3393, section 4.4. oneWayIpdvJitter (31) The identifier for the Type-P-One-way-ipdv-jitter metric. REFERENCE RFC3393, section 4.5. oneWayPeakToPeakIpdv (32) The identifier for the Type-P-One-way-peak-to-peak-ipdv metric. REFERENCE RFC3393, section 4.6. oneWayDelayPeriodicStream (33) The identifier for the Type-P-One-way-Delay-Periodic-Stream metric. REFERENCE RFC3432, section 4. roundtripDelayAverage (34) The identifier for the Type-P-Round-trip-Delay-Average metric. roundtripPacketLoss (35) The identifier for the Type-P-Round-trip-Packet-Loss metric. roundtripPacketLossAverage (36) The identifier for the Type-P-Round-trip-Packet-Loss-Average metric. roundtripIpdv (37) The identifier for the Type-P-Round-trip-ipdv metric.

TEXTUAL-CONVENTION

The value at which a specific occurrence happened. The specific occurrence must be defined in the description of any object defined using this type. field octets contents range ----- ------ -------- ----- 1 1-4 second since 1 Jan 2000 0H00* 0..2^31 - 1 2 5-8 fractional part of the second* 0..2^32 - 1 * the value is in network-byte order The timestamp format is directly inspired from the NTP timestamp format. It differs because it counts the second 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. When this bit is not set the resolution is maximal. The maximal resolution is close to 250 picoseconds. The precision of the timestamp is provided in etsysSrvcLvlSystemClockResolution.

TEXTUAL-CONVENTION

A enumerated list of time units.

TEXTUAL-CONVENTION

This textual convention is a display string used to describe the 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 a measure. The RFC2895 specifies a macro named PROTOCOL-IDENTIFIER for the definition of protocol identifiers, while its companion document, the RFC2896 defines a set of protocol identifiers. TypeP is defined as a display string. It consists of a list of dot separated protocol names. Each protocol name has been previously defined using the macro PROTOCOL-IDENTIFIER of the RFC 2895. Examples: The RFC2896 defines the protocol identifiers 'ether2', 'ip', 'ipip4', 'udp', 'tcp', 'telnet'... The TypeP of the source address corresponding to telnet is the string 'ip.tcp.telnet'. The TypeP of the source address corresponding to UDP packets sent in an IP tunnel is the string 'ip.ipip4.udp'. Note: A performance measure is active, so generally a TypeP value 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.

TEXTUAL-CONVENTION

This textual convention is a Display string used to describe the parameters of the protocol encapsulation list of a packet, basically the address. TypePaddress is defined as a display string. It consists in a list of space separated parameter list. Each parameter in the list corresponds to a parameter of a PROTOCOL-IDENTIFIER of the TypeP. Example: The TypeP 'ip.ipip4' has 2 parameters. A valid TypePaddress value is '192.168.1.1 128.2.6.7'.

OBJECT-IDENTITY

OBJECT-IDENTITY

OBJECT-TYPE

The current time of the system.

OBJECT-TYPE

etsysSrvcLvlSystemClockResolution provides the precision of the clock used for the measures . The unit is the picosecond. For example, the clock on an old Unix host might advance only once every msec, and thus have a resolution of 1 msec. So its resolution is 1,000,000,000 picosecond and the value of etsysSrvcLvlSystemClockResolution is 1000000000.

OBJECT-TYPE

This table is mandatory. It describes the current implementation. Each defined metric must be described in the table. etsysSrvcLvlMetricTable content is read only.

OBJECT-TYPE

An entry describes the static capabilities of a metric implementation.

OBJECT-TYPE

etsysSrvcLvlMetricIndex defines an unambiguous index for each standardized metric. It identifies a metric. Its value is defined above. This value is the same in any implementation of the ENTERASYS-SERVICE-LEVEL-REPORTING-MIB. See EtsysSrvcLvlStandardMetrics for description of the metrics. Example: onewayPacketLossAverage is defined as the 14. Consequently the index of the metric onewayPacketLossAverage in the EtsysSrvcLvlMetricTable will always be '14'

OBJECT-TYPE

A value of notImplemented implies the metric is not implemented. A value of implemented implies the metric is implemented.

OBJECT-TYPE

Indicates the metric type, whether it is network or aggregated

OBJECT-TYPE

The unit used in the current entity for the results of the measurement of this metric.

OBJECT-TYPE

A textual description of the metric implementation following the exact name of this metric in the registry. For example: oneWayDelay: text .

OBJECT-IDENTITY

OBJECT-TYPE

A management entity wishing to create and activate remote EtsysSrvcLvl measurements in an agent must previously be registered in the etsysSrvcLvlOwnersTable. etsysSrvcLvlOwnersTable content is read-create. It contains at least the owner 'monitor'.

OBJECT-TYPE

The description of the resources granted to an SNMP application. For example, an instance of etsysSrvcLvlOwnersOwner with an EtsysSrvcLvlOwnerString 'acme', which represents the 14th owner created in etsysSrvcLvlOwnersTable would be named etsysSrvcLvlOwnersEntryOwner.14. Notes: The etsysSrvcLvlOwnersIndex 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 tables.

OBJECT-TYPE

An arbitrary index that identifies an entry in the owners table.

OBJECT-TYPE

The owner described by this entry.

OBJECT-TYPE

Defines the metrics granted to an owner for which measurements can be performed.

OBJECT-TYPE

The maximum number of records that this owner may have in the history table.

OBJECT-TYPE

The IP address type of the management entity corresponding to this owner. InetAddressType is restricted to ipv4(1),ipv6(2)and dns(16).

OBJECT-TYPE

The IP address of the management entity corresponding to this owner.

OBJECT-TYPE

The email address of the management entity corresponding to this owner.

OBJECT-TYPE

The SMS phone number of the management entity corresponding to this owner.

OBJECT-TYPE

The status of this table entry.

OBJECT-IDENTITY

OBJECT-TYPE

The table containing the measurement results.

OBJECT-TYPE

An etsysSrvcLvlHistoryEntry entry is one of the results of a measure identified by etsysSrvcLvlHistoryMeasureOwner, etsysSrvcLvlHistoryMeasureIndex, etsysSrvcLvlHistoryMetricIndex and etsysSrvcLvlHistoryIndex. In the index : + etsysSrvcLvlHistoryMeasureOwner identifies the owner of the measure + etsysSrvcLvlHistoryMeasureIndex identifies the measure in the owner namespace + etsysSrvcLvlHistoryMetricIndex identifies the metric measured by the measure. The metric is described in the corresponding entry of the n etsysSrvcLvlMetricTable + etsysSrvcLvlHistoryIndex is the local index of the result on the history table.

OBJECT-TYPE

The owner of the measure that produced this result.

OBJECT-TYPE

The index (in owner's namespace) of the measure that produced this result.

OBJECT-TYPE

etsysSrvcLvlHistoryMetricIndex identifies the metric measured by the measure. The metric is described in the corresponding entry of the etsysSrvcLvlMetricTable.

OBJECT-TYPE

A local index that identifies a result in the history table.

OBJECT-TYPE

etsysSrvcLvlHistorySequence is the sequence index of the measurement results for a metric. Network metrics: It's the sequence index 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 index of the computed aggregated metric result.

OBJECT-TYPE

The timestamp when the measurement occurred.

OBJECT-TYPE

The observed value of the measurement.

OBJECT-IDENTITY

OBJECT-TYPE

An entry is a measurement that performs network measures and provides results. It performs several metric measurements per packet exchange. Each step of a measure produces a singleton result per metric. The time of the measurement and the value of the metric are saved in the etsysSrvcLvlHistoryTable.

OBJECT-TYPE

The EtsysSrvcLvlNetMeasureTable is mandatory. The etsysSrvcLvlNetMeasureMetrics is set to a list of metrics to be computed from the same raw packet exchange. Each step of measurement delivers a singleton per chosen metric. Results are timestamped and saved in the etsysSrvcLvlHistoryTable. The etsysSrvcLvlNetMeasureTable typical usage consists in providing network measure indices in order to allow aggregated measures to perform aggregation on the results of network measures.

OBJECT-TYPE

The owner of the network measurement.

OBJECT-TYPE

The index (in owner's namespace) of the network measure.

OBJECT-TYPE

The name of the metric instance. It illustrates the specificity of the metric and includes the metric and the TypeP. Example: IP-TCP-HTTP-One-way-Delay: free text

OBJECT-TYPE

Defines the metrics to compute within this measure. ONLY network metrics of the same type are allowed in this field. A measure may be configured for the result of different metric singletons to be archived in the etsysSrvcLvlHistoryTable. The etsysSrvcLvlMetricIndex of the created result has the value of the bit index of the corresponding etsysSrvcLvlMeasureMetrics as explained above in the etsysSrvcLvlMetricIndex 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 etsysSrvcLvlHistoryTable. The singletons created for the One-way-Delay measure have a value of etsysSrvcLvlMetricIndex of 6 while the created singletons for the One-way-Packet-Loss measure have a value of etsysSrvcLvlMetricIndex of 12. One measure may perform simultaneously either several network metrics either several aggregated metrics

OBJECT-TYPE

Specifies the time at which the measurement begins.

OBJECT-TYPE

Specifies the measurement duration unit.

OBJECT-TYPE

Specifies the measurement duration.

OBJECT-TYPE

Specifies the maximum number of results saved for each metric of this measure. Overflow condition will be managed by the object etsysSrvcLvlNetMeasureResultsMgmt.

OBJECT-TYPE

This object defines whether this row is discarded on failure. 'auto' the failure is handled automatically depending on the implementation. 'manual' the entry should be discarded manually. 'discarded' the entry is discarded all the time.

OBJECT-TYPE

Action to take when the 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 delete action causes the agent to begin to write in the log, and assumes the data has been cleared. This object indicates the way the measurement results are managed when the owner quota has been exceeded: 'wrap' continue the measurement and erase the older entries in the history. 'suspend' stop the measure and keep the results in the history. 'delete' remove the results from the history.

OBJECT-TYPE

Defines the type P of the source address of the packets sent by the measure.

OBJECT-TYPE

Specifies the address of the source of the measure. It is represented as a list of parameters corresponding to those of the PROTOCOL IDENTIFIER sets in etsysSrvcLvlNetMeasureSrcTypeP.

OBJECT-TYPE

Defines the type P of the destination address of the packets sent by the measure.

OBJECT-TYPE

Specifies the address of the destination of the measure. It is represented as a list of parameters corresponding to those of the PROTOCOL IDENTIFIER set in etsysSrvcLvlNetMeasureDstTypeP.

OBJECT-TYPE

The transmit mode used to send the packets: 'other' The rule used to send the packets is unknown. 'periodic' Packets are sent periodically at etsysSrvcLvlNetMeasureTxPacketRate rate. 'poisson' Packets are sent using a Poisson law, the median is the value of etsysSrvcLvlNetMeasureMedOrIntBurstSize, the deviation is etsysSrvcLvlNetMeasureDevtnOrBurstSize. 'multiburst' Packets are sent bursty at etsysSrvcLvlNetMeasureTxPacketRate. The size of the burst is made of etsysSrvcLvlNetMeasureDevtnOrBurstSize packets.

OBJECT-TYPE

The packet rate unit used to send the packets.

OBJECT-TYPE

The rate the packets are sent.

OBJECT-TYPE

Indicates the average number of packets per seconds sent using a poisson law.

OBJECT-TYPE

According to the transmit mode, this value indicates the average number of packets per seconds sent using a poisson law, or the number of packets to wait between consecutive bursts.

OBJECT-TYPE

Specifies the delay after which the packet is considered lost by the sink.

OBJECT-TYPE

Specifies the size of the packets counted at the IP network layer in regards to the TypeP definition. Example: For a TypeP 'ip ipip4' the L3 size will be the size of the packet at ipip4 level.

OBJECT-TYPE

The pattern used to fill the payload of the packet.

OBJECT-TYPE

An administrative name of a network management map to which the measure belongs.

OBJECT-TYPE

Reports the number of singletons performed per metric by the measure since the beginning of the measure. This parameters is required for aggregation.

OBJECT-TYPE

Reports the operational status of the network measure.

OBJECT-TYPE

An aggregated measure summarizes the results of previous network or aggregated measures. The results may be saved in the etsysSrvcLvlHistoryTable. Each step of the calculation for the measure produces a singleton result per metric.

OBJECT-TYPE

Typically the configuration operation sets the value of the EtsysSrvcLvlAggrMeasureEntry. etsysSrvcLvlAggrMeasureTable is mandatory. The etsysSrvcLvlAggrMeasureMetrics defines the metric to compute. The results of the measure to summarize are identified by: + etsysSrvcLvlAggrMeasureHistoryOwner, + etsysSrvcLvlAggrMeasureHistoryOwnerIndex and + etsysSrvcLvlAggrMeasureHistoryMetric The aggregated task starts at etsysSrvcLvlAggrMeasureBeginTime and ends after etsysSrvcLvlAggrMeasureDuration. An aggregated result is performed and saved in the etsysSrvcLvlHistoryTable for each etsysSrvcLvlAggrMeasureAggrPeriod.

OBJECT-TYPE

The owner who has configured this entry.

OBJECT-TYPE

The index (in owner's namespace) of the measure. The value is managed by the owner.

OBJECT-TYPE

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

OBJECT-TYPE

Defines the metrics to compute within this aggregated measure. ONLY aggregated metrics of the same type are allowed in this field. A measure may be configured for the result of different metric singletons to be archived in the etsysSrvcLvlHistoryTable. The etsysSrvcLvlMetricIndex of the created result has the value of the bit index of the corresponding etsysSrvcLvlAggrMeasureMetrics as explained above in the etsysSrvcLvlMetricIndex 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 etsysSrvcLvlHistoryTable. The singletons created for the One-way-Delay measure have a value of etsysSrvcLvlMetricIndex of 6 while the created singletons for the One-way-Packet-Loss measure have a value of etsysSrvcLvlMetricIndex of 12.

OBJECT-TYPE

Specifies the time at which the aggregated measure starts.

OBJECT-TYPE

Specifies the unit of the aggregated measure period.

OBJECT-TYPE

Specifies the amount of time between 2 measurement action intervals. The action is specific to the semantic of the measure. They are performed periodically on a sequence of results of other measures. The period corresponds to the interval between two successive computations of the metric. The value of etsysSrvcLvlHistoryTimestamp result of a aggregated metric computed corresponds to the value of the etsysSrvcLvlHistoryTimestamp of the last metric result of the sequence used in to compute the aggregated metric.

OBJECT-TYPE

Specifies the unit of the measure duration.

OBJECT-TYPE

Specifies the duration of the measure.

OBJECT-TYPE

Specifies the maximum number of results saved for each metric of this measure. Overflow condition will be managed by the object etsysSrvcLvlAggrMeasureResultsMgmt.

OBJECT-TYPE

This object defines whether this row and the corresponding entry in the etsysSrvcLvlNetMeasureTable is 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).

OBJECT-TYPE

This object displays the way the history of the aggregated measure is managed. 'wrap' continue the measure and erase the older entries in the history. 'suspend' stop the measure and keep the results in the history.

OBJECT-TYPE

The owner of the measure to summarize.

OBJECT-TYPE

The index (in owner's namespace) of the measure to summarize.

OBJECT-TYPE

The metric of the measure to summarize.

OBJECT-TYPE

This object controls the activity of the aggregated measure. 'start' The aggregated measure is started. 'stop' The aggregated measure is stopped.

OBJECT-TYPE

This object allows for classification of the measure. It is typically the name of an administrative map.

OBJECT-TYPE

The status of this table entry. Once the entry status is set to active, the associate entry cannot be modified. The creation of an aggregated measure forced the creation of the corresponding entry in etsysSrvcLvlNetMeasureTable.

OBJECT-IDENTITY

OBJECT-IDENTITY

OBJECT-IDENTITY