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).
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).
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).
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 (,)
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.
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.
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 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.
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'.
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.
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.
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.
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.
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.
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.
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.
