AHCF-MIB: View SNMP OID List / Download MIB

The MIB module describes a object definition for history collection.

A list of data-collection configuration entries.

List of parameters that set up sampling on a user specified MIB variable(a scalar variable or a columnar variable).

An index that uniquely identifies an entry in the ahcfConfigTable.

The object identifier of the particular MIB variable to be sampled. Only variables that resolve to an ASN.1 primitive type of Integer32 (Integer32, Counter, Gauge, or TimeTicks) MUST be specified. Refer to RFC 2578 - Structure of Management Information Version 2 (SMIv2)for details If ahcfConfigObjectType is 'scalar', then this will Contain the complete object identifier that needs to be sampled. If ahcfConfigObjectType is 'columnar', then this will contain the object identifier of a column in a table that needs to be sampled. This object MUST NOT be modified if the associated ahcfConfigStatus object is equal to active(1).

The type of the object variable specified in ahcfConfigObjectVariable. If this object is set to 'scalar', then ahcfConfigObjectVariable will contain the complete object identifier that needs to be sampled. If this object is set to 'columnar', ahcfConfigObjectVariable this will contain the object identifier of a column in a table that needs to be sampled. This object MUST NOT be modified if the associated ahcfConfigStatus object is equal to active(1). Enumeration: 'scalar': 1, 'columnar': 2.

The number of rows in the ahcfInstanceTable associated with this ahcfConfigEntry. If ahcfConfigObjectType is 'scalar', then this will be 1. If ahcfConfigObjectType is 'columnar', then this will contain the number of instances for which a row has been created in ahcfInstanceTable for the given columnar object id.

The method of sampling the selected variable for storage in the ahcfSampleTable. If the value of this object is absoluteValue(1), the value of the selected variable will be copied directly into the sample entry. If the value of this object is deltaValue(2), the value of the selected variable at the last sample will be subtracted from the current value, and the difference will be stored in the history bucket. If the associated ahcfInstanceObjectVariable instance could not be obtained at the previous sample interval, then a delta sample is not possible, and the value of the associated ahcfSampleValStatus object for this interval will be valueNotAvailable(1). This object MUST NOT be modified if the associated ahcfConfigStatus object is equal to active(1). Enumeration: 'absoluteValue': 1, 'deltaValue': 2.

A printable string which describes the object being sampled. For example, if the object being sampled is the disk space usage defined in the Host Resources MIB (RFC 1514) hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed, the object name can be 'Used Disk Space'.

One or more MIB variables which provide a unique identifier for the object oid to be sampled. This is meaningful only if the ahcfConfigObjectType is 'columnar'. The identifier can be specified in terms of another columnar oid of the same MIB table (or an augmented table or a table that has the same INDEX clause as this table) that will remain unique and constant over many restarts of the management agent or the managed system. The identifier oids can be of any ASN.1 type. The need for an identifier oid is to counter the changes in the ordering of rows in the MIB table. The format for this variable is ([Oid1][,Oid2][,Oid3]) Maximum of 3 identifier oids can be specified. A value of '()' is used as the default value for this variable and it represents zero identifier oids. For example, if the object being sampled is the disk space usage defined in the Host Resources MIB (RFC 1514) hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed, then the description of the storage medium (hrStorageDescr) can be used as the identifier oid. The value for this variable will be (1.3.6.1.2.1.25.2.3.1.3) The reason for using a identifier oid is because the order of rows in hrStorageTable need not be same over time. If there are two storage media ('/' and ' /usr') and a new media is added (say '/var'), a new row may be created in between the two existing rows in the table making the contents of hrStorageTable ('/', '/var' and '/usr'). This will change the index of the mib variable hrStorageUsed for '/usr'. In order to obtain the new index value for the row for '/usr' and to collect and store the samples correctly, the agent uses the identifier oid. Without the concept of an identifier variable the agent cannot detect that the second row now represents '/var' and will wrongly store the data for '/var' in the samples for '/usr'

The type of filters specified for this config entry. This is meaningful only if the ahcfConfigObjectType is 'columnar'. If ahcfConfigFilterType is inclusive, an instance of ahcfConfigObjectVariable is selected for sampling only if the values of the ahcfConfigIdentifierVariables for the same instance match one of the filters specified (variables defined below). If ahcfConfigFilterType is exclusive, an instance of ahcfConfigObjectVariable is selected for sampling only if the values of the ahcfConfigIdentifierVariables for the same instance do not match any of the filters specified (variables defined below). This object MUST NOT be modified if the associated ahcfConfigStatus object is equal to active(1). Enumeration: 'exclusive': 2, 'nofilters': 3, 'inclusive': 1.

A filter for selecting the rows of a MIB table that need to be sampled. This is meaningful only if the ahcfConfigObjectType is 'columnar'. A filter can be specified in terms of the values of identifier oids given in ahcfConfigIdentifierVariables. The format for this variable is ([Oid1 Value][,Oid2 Value][,Oid3 Value]) Oid1, Oid2 and Oid3 are the identifier oids specified in ahcfConfigIdentifierVariables. Value for a maximum of 3 identifier oids can be specified. A value of '()' is used as the default value for this variable and it will not be considered as a valid filter. For example, if the object being sampled is the disk space usage defined in the Host Resources MIB (RFC 1514) hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed, and the description of the storage medium (hrStorageDescr) is being used as the identifier oid. If there are three logical storage media ('/', '/usr' and '/var') and the user only wants to monitor the disk usage of media '/usr', then ahcfConfigFilterType can be set to 'inclusive' and ahcfConfigFilterSpec1 can be set to (/usr) If the user wants to monitor disk usage of all media other than '/', then ahcfConfigFilterType can be set to 'exclusive' and ahcfConfigFilterSpec1 can be set to (/) Maximum of three filters can be specified using ahcfConfigFilterSpec1, 2 and 3. The filter specs MUST be modifiable when the value of ahcfConfigStatus object is equal to active(1). The agent MUST re-evaluate the filters and retain the sample data for mib instances which were being sampled before and which pass the new filters also. For example, if the ahcfConfigFilterSpec1 was previously (/) and ahcfConfigFilterSpec2 is set to (/usr), then the agent MUST retain the previous sample data for the medium '/' and start collecting data for '/usr'. Note that if there are two identifier oids, the user can decide to provide the value for only Oid1 in the filters by leaving the value of Oid2 empty. That is (,)

A filter for specifying the rows of a MIB table that need to be sampled. Refer to description for ahcfConfigFilterSpec1 for details.

A filter for specifying the rows of a MIB table that need to be sampled. Refer to description for ahcfConfigFilterSpec1 for details.

The entity that configured this entry and is therefore using the resources assigned to it.

The default value to be used for ahcfInstanceInterval if a new row has to be created in ahcfInstanceTable for this config entry. If the ahcfConfigObjectType is 'columnar' and the SNMP probe detects at run time that a new instance is available in the table (e.g. a new logical storage media is added to hrStorageTable), then the probe creates a new entry in the ahcfInstanceTable and uses the ahcfConfigDefaultInterval as the value of ahcfInstanceInterval for this new entry. The user can then modify the ahcfInstanceInterval if required to a value more specific to the new entry created (the new logical storage media added to hrStorageTable).

The default value to be used for ahcfInstanceBucketsRequested if a new entry has to be created in ahcfInstanceTable for this config entry. If the ahcfConfigObjectType is 'columnar' and the SNMP probe detects at runtime that a new instance is available in the table (e.g. a new logical storage media is added to hrStorageTable),then the probe creates a new entry in the ahcfInstanceTable and uses the ahcfConfigDefaultBucketsReq as the value of ahcfInstanceBucketsRequested for this new entry. The user can then modify the ahcfInstanceBucketsRequested if required to a value more specific to the new entry created (the new logical storage media added to hrStorageTable).

The status of this variable history configuration entry. An entry MUST NOT exist in the active state unless all objects in the entry have an appropriate value. If this object is not equal to active(1), all associated entries in the ahcfInstanceTable and the ahcfSampleTable shall be deleted.

List of MIB variable instances to be sampled based on the configuration in ahcfConfigTable.

A MIB instance to be sampled periodically. Entries in this table are created when an associated ahcfConfigEntry is created or new instances are detected for an existing ahcfConfigEntry.

An index used to uniquely identify an entry in the ahcfInstance table. Each such entry defines a MIB instance to be sampled periodically.

The object identifier of the particular MIB instance to be sampled. If ahcfConfigObjectType is 'scalar', then this will be same as the ahcfConfigObjectVariable (the complete object identifier that needs to be sampled). If ahcfConfigObjectType is 'columnar', then this will be one of the instances of ahcfConfigObjectVariable.

The interval in seconds over which the data is sampled for each bucket in the part of the ahcf table associated with this ahcfInstanceEntry. If the ahcfConfigObjectType is 'columnar' and the SNMP probe detects at run time that a new instance is available in the table (e.g. a new logical storage media is added to hrStorageTable), then the probe creates a new entry in the ahcfInstanceTable and uses the ahcfConfigDefaultInterval as the value of ahcfInstanceInterval for this new entry. The user can then modify the ahcfInstanceInterval if required to a value more specific to the new entry created (the new logical storage media added to hrStorageTable). Because the counters in a bucket may overflow at their maximum value with no indication, a prudent manager will take into account the possibility of overflow in any of the associated counters. It is important to consider the minimum time in which any counter could overflow on a particular media type and set the ahcfInstanceInterval object to a value less than this interval. This object MUST NOT be modified if the associated ahcfInstanceStatus object is equal to valid(1).

Unique name for the object instance being sampled. This value can be used by the management console when displaying the history statistics. The format of this is [Oid1 Value][,Oid2 Value][,Oid3 Value] Oid1, Oid2 and Oid3 are the identifier oids specified in ahcfConfigIdentifierVariables. For example, if the object being sampled is the disk space usage defined in the Host Resources MIB (RFC 1514) hrStorage.hrStorageTable.hrStorageEntry.hrStorageUsed and the description of the storage medium (hrStorageDescr) is used as the identifier oid, then the instance name can be '/', '/var', '/usr'

The requested number of discrete time intervals over which data is to be saved in the part of the ahcfSampleTable associated with this ahcfConfigEntry. When this object is created, the probe SHOULD set ahcfInstanceBucketsGranted as closely to this object as is possible for the particular probe implementation and available resources. This object MUST NOT be modified if the associated ahcfInstanceStatus object is equal to valid(1).

The number of discrete sampling intervals over which data shall be saved in the part of ahcfSampleTable associated with this ahcfConfigEntry. If the ahcfConfigObjectType is 'columnar' and the SNMP probe detects at runtime that a new instance is available in the table (e.g. a new logical storage media is added to hrStorageTable),then the probe creates a new entry in the ahcfInstanceTable and uses the ahcfConfigDefaultBucketsReq as the value of ahcfInstanceBucketsRequested for this new entry. The user can then modify the ahcfInstanceBucketsRequested if required to a value more specific to the new entry created (the new logical storage media added to hrStorageTable). When the associated ahcfInstanceBucketsRequested object is created, the probe SHOULD set this object as closely to the requested value as is possible for the particular probe implementation and available resources. There will be times when the actual number of buckets associated with this entry is less than the value of this object. In this case, at the end of each sampling interval, a new bucket will be added to the ahcfSampleTable. When the number of buckets reaches the value of this object and a new bucket is to be added to the ahcfSampleTable, the oldest bucket associated with this ahcfConfigEntry shall be deleted by the agent so that the new bucket can be added.

The value of ahcfSampleIndex for the most recent sample in the associated history. Zero if no samples have yet been taken.

The current state of history collection for the ahcfInstanceEntry. When the state is 'enabled', each sampled value will be added to the history. When the state is 'disabled', sampled values will not be added to the stored history. The management console MAY detect the missing samples by looking at the ahcfSampleTimeStamp. The state 'instanceNotAvailable' indicates that history collection is enabled for this object but the specified object is not available in the mib view. This variable may be set to instanceNotAvailable by the SNMP probe but not by a SNMP manager. Enumeration: 'disabled': 2, 'instanceNotAvailable': 3, 'enabled': 1.

The current state of threshold monitoring for this ahcfInstanceEntry. When the state is 'enabled', the sampled value will be compared to the configured thresholds, and a notification generated if appropriate. When the state is 'disabled', the thresholds will be ignored, and no notification will ever be generated. If ahcfInstanceTrendingState is disabled and ahcfInstanceThresholdState is enabled the MIB variable will be sampled but not stored. Only threshold checking will be done. ahcfInstanceThresholdState can be 'enabled' only if the corresponding value of ahcfInstanceAlarmType is not 'undefined'. Enumeration: 'disabled': 2, 'enabled': 1.

The alarm that may be sent when this entry is first set to valid. If the first sample after this entry becomes valid is greater than or equal to the risingThreshold and ahcfInstanceAlarmType is equal to risingAlarm(1) or risingOrFallingAlarm(3), then a single rising alarm will be generated. If the first sample after this entry becomes valid is less than or equal to the fallingThreshold and ahcfInstanceAlarmType is equal to fallingAlarm(2) or risingOrFallingAlarm(3), then a single falling alarm will be generated. Enumeration: 'fallingAlarm': 2, 'risingAlarm': 1, 'risingOrFallingAlarm': 3, 'undefined': 4.

The type of the notification that needs to be sent for a threshold violation. The management console can use this value to identify the importance of a particular notification. Enumeration: 'unknown': 5, 'severe': 1, 'informational': 4, 'major': 2, 'minor': 3.

A threshold for the sampled variable. When the current sampled value is greater than or equal to this threshold, and the value at the last sampling interval was less than this threshold, and the value of ahcfInstanceThresholdType is 'risingAlarm' or 'risingOrFallingAlarm', a single notification will be generated. After a notification is generated, another such notification will not be generated until the sampled value falls below this threshold and reaches the ahcfInstanceFallingThreshold. That is, the hysterisis mechanism is used to limit the generation of events. This mechanism generates one event as a threshold is crossed in the appropriate direction. No more events are generated for that threshold until the opposite threshold is crossed.

A threshold for the sampled variable. When the current sampled value is less than or equal to this threshold, and the value at the last sampling interval was greater than this threshold, and the value of ahcfInstanceThresholdType is 'fallingAlarm' or 'risingOrFallingAlarm', a single notification will be generated. After a notification is generated, another such notification will not be generated until the sampled value rises above this threshold and reaches the ahcfInstanceRisingThreshold.

The status of this ahcfInstanceEntry. ahcfInstanceEntry may be set to invalid, to modify one or more of ahcfInstanceInterval, ahcfInstanceBucketsRequested or ahcfInstanceAlarmType. On setting this value to invalid, all the samples collected till now for this instance will be discarded. Sampling starts again when this value is set to valid. Enumeration: 'valid': 1, 'invalid': 2.

List of historical samples for user-defined MIB variables.

Historical samples for a particular user-defined MIB variable.

An index that uniquely identifies the particular sample this entry represents among all samples associated with the same ahcfConfigEntry. This index starts at 1 and increases by one as each new sample is taken.

The absolute value (i.e. unsigned value) of the user- specified statistic during the last sampling period. The value during the current sampling period is not made available until the period is completed. To obtain the true value for this sampling interval, the associated instance of ahcfSampleValStatus MUST be checked, and ahcfSampleAbsValue adjusted as necessary. If the MIB instance could not be accessed during the sampling interval, then this object will have a value of zero and the associated instance of ahcfSampleAbsValue will be set to 'valueNotAvailable(1)'.

This object indicates the validity and sign of the data in the associated instance of ahcfSampleAbsValue. If the MIB instance could not be accessed during the sampling interval, then 'valueNotAvailable(1)' will be returned. If the sample is valid and actual value of the sample is greater than or equal to zero then 'valuePositive(2)' is returned. If the sample is valid and the actual value of the sample is less than zero, 'valueNegative(3)' will be returned. The associated instance of ahcfSampleAbsValue SHOULD be multiplied by -1 to obtain the true sample value. Enumeration: 'valuePositive': 2, 'valueNotAvailable': 1, 'valueNegative': 3.

This timestamp is the absolute date and time (UTC) that the sample was taken, expressed as seconds since midnight on January 1, 1970 If the probe keeps track of the time of day, it SHOULD take the first sample of the history at a time such that when the next hour of the day begins, a sample is collected at that instant. Note that following this rule may require the probe to delay collecting the first sample of the history.

The date and time (UTC) on the SNMP probe.

The time zone in which this SNMP probe resides. The string is in the format - where 'Time Zone Offset' is +hh:mm or -hh:mm

Indicates whether daylight savings time is applicable or not. Enumeration: 'disabled': 2, 'enabled': 1.

A rising alarm notification generated by the AHCF-MIB. When the ahcfInstanceThresholdState is 'enabled', the sampled value will be compared to the configured thresholds, and a notification generated if appropriate. The notification will contain the name of the probe that generated the notification, the time at which it was generated, the rising threshold, falling threshold, sampling interval configured, the unique identifier for the instance if the ahcfConfigObjectType is columnar and the severity configured by the user for a notification related to this instance. When the state is 'disabled', the thresholds will be ignored, and no notification will ever be generated.

A falling alarm notification generated by the AHCF-MIB. Refer to the description of ahcfRisingAlarm for details.

The name of this probe

The UTC time in seconds at which the notification was generated.

The rising threshold value specified by the user in the ahcfInstanceEntry for which this notification is generated.

The falling threshold value specified by the user in the ahcfInstanceEntry for which this notification is generated.

The sample interval in seconds specified by the user in the ahcfInstanceEntry for which this notification is generated.

The descriptive name for the object instance sampled For example, if the object being sampled is the disk space usage defined in the hrStorageTable of Host Resources MIB (hrStorageUsed) and the description of the storage medium hrStorageDescr) is used as the identifier oid, then this will be the value of hrStorageDescr.

The importance of the event (threshold violation) which resulted in the generation of this notification. The value used for this object is specified by the user in ahcfInstanceAlarmSeverity. The management console can use this value to identify the importance of a particular notification.

The compliance statement for SNMP entities that implement the AHCF-MIB.

Objects for data-collection configuration.

Objects for data-collection configuration of MIB instances based on the configuration in ahcfConfigTable.

Objects for storing the historical samples.

Objects providing the date, time and time zone of the agent machine.

Objects defining the notifications generated by AHCF-MIB.

Objects defining the notification variables for notifications generated by AHCF-MIB.