rfc-3705

High Capacity Textual Conventions for MIB Modules Using Performance History Based on 15 Minute Intervals

B. Ray, R. Abbi
date2004-02 streamIETF areaops wgadslmib statusPROPOSED STANDARD pages11 canonicalhttps://www.rfc-editor.org/rfc/rfc3705 doi10.17487/RFC3705
This document presents a set of High Capacity Textual Conventions for use in MIB modules which require performance history based upon 15 minute intervals. The Textual Conventions defined in this document extend the conventions presented in RFC 3593 to 64 bit resolution using the conventions presented in RFC 2856. [STANDARDS-TRACK]

Extracted elements (15)

design-rationale §2

64-bit versions of the RFC 3593 textual conventions are needed but SMIv2 provides no Gauge64 or Unsigned64 type. CounterBasedGauge64 from RFC 2856 cannot be used as a base type for TCs either, so the conventions are defined directly on Counter64, inheriting its read-only access and other constraints.

snmp, yang

design-rationale §3

The three Counter64-based count TCs (HCPerfCurrentCount, HCPerfIntervalCount, HCPerfTotalCount) are explicitly described as a limited, short-term solution that may be deprecated once a long-term replacement is defined and deployed.

snmp

interoperability-note §3

HCPerfCurrentCount, HCPerfIntervalCount, and HCPerfTotalCount are not strictly supported in SMIv2 because they use Counter64 syntax without preserving its 'always increasing' and 'counter wrap' semantics. Management applications that rely solely on the Counter64 ASN.1 tag may misinterpret these objects as standard counters.

snmp

normative-requirement §2 MUST NOT

No sub-range can be specified and no DEFVAL clause can be used in object definitions based on these textual conventions, because Counter64 does not permit sub-ranges or DEFVALs. Objects of these types also cannot appear in an INDEX clause.

snmp

normative-requirement §2 MUST

Objects defined using the HC-PerfHist textual conventions MUST have MAX-ACCESS read-only, because the underlying Counter64 base type is read-only.

snmp

normative-requirement §2 REQUIRED

Use of these textual conventions assumes the agent supports 15-minute based history counters and is capable of keeping a history of 96 intervals of 15-minute performance data.

snmp, qos

normative-requirement §3 SHALL

When an agent has no valid data for the current or a historical interval, the corresponding object instance MUST NOT be available; a retrieval request SHALL return an error indicating the instance does not exist.

snmp

protocol-element §3

HCPerfCurrentCount is a Counter64-based gauge for a performance measurement in the current 15-minute interval. Starts at zero, increments on events, is stored as X(1) at interval end and reset. If no valid data is available, the object instance is absent and a retrieval returns an error.

snmp, qos

protocol-element §3

HCPerfIntervalCount is a Counter64-based gauge representing a previous 15-minute measurement interval. At each interval boundary: X(n) is discarded, X(i) takes X(i-1) for n>=i>1, X(1) takes the prior current value Y, and aggregate Z is adjusted if supported.

snmp, qos

protocol-element §3

HCPerfIntervalThreshold defines a fault threshold alarm control range for 15-minute intervals. Range is Unsigned32 (0..900), where 0 disables the alarm.

snmp, qos

protocol-element §3

HCPerfInvalidIntervals represents the number of near-end 15-minute intervals for which no data is available, typically zero except in proxy situations. Encoded as Integer32 (0..96).

snmp, qos

protocol-element §3

HCPerfTimeElapsed represents seconds elapsed since the beginning of the current measurement period. For 15-minute intervals the range is (0..899); for 24-hour intervals (0..86399). Capped at maximum value if the interval is extended by clock adjustments or leap seconds. Encoded as Integer32 (0..86399).

snmp, qos

protocol-element §3

HCPerfTotalCount is a Counter64-based gauge representing the aggregate of all previous valid 15-minute intervals; intervals with no valid data are excluded. Value saturates at 2^64-1 and may decrease if a retroactive adjustment causes the underlying count to fall below that ceiling.

snmp, qos

protocol-element §3

HCPerfValidIntervals is a textual convention representing the count of near-end 15-minute intervals for which data was collected. Its value is 96 unless measurement started within the last 1440 minutes; encoded as Integer32 (0..96).

snmp, qos

security-consideration §6

The HC-PerfHist-TC-MIB module defines only textual conventions and no management objects. Meaningful security considerations apply only to the MIB modules that use these conventions to define objects; this document itself has no direct impact on Internet security.

snmp, security