apmAppDirID
APM-MIB ·
.1.3.6.1.2.1.16.23.1.3
Object
scalar
r/w
ObjectIdentifier
This object allows managers to avoid downloading application
directory information when the directory is set to a known
(usually fixed) configuration.
If the value of this object isn't 0.0, it signifies
that the entire contents of the apmAppDirTable,
apmHttpFilterTable, apmUserDefinedAppTable and
protocolDirTable are equal to a known state identified
by the value of this object. If a manager recognizes this
value as identifying a directory configuration it has a local
copy of, it may use this local copy rather than downloading
these tables. Note that it may have downloaded this local copy
(and the ID) from another agent and used this copy for all
other agents that advertised the same ID.
If an agent recognizes that the entire contents of the
apmAppDirTable, apmHttpFilterTable,
apmUserDefinedAppTable and protocolDirTable are equal to
a known state to which an ID has been assigned, it should set
this object to that ID.
In many cases when this feature is used, the application
directory information will be in read-only memory and thus the
tables may not be modified via SNMP requests. In the event
that the tables are writable and a modification is made, the
agent is responsible for setting this object to 0.0 if it
cannot determine that the state is equal to a known state.
An agent is not obligated to recognize and advertise all such
registered states as it may not have knowledge of all states.
Thus, a manager may encounter agents whose DirectoryID value
is 0.0 even though the contents of the directory were equal to
a registered state.
Note that the contents of those tables includes the
protocolDirLocalIndex and appLocalIndex values. In other
words, these values can't be assigned randomly on each agent,
but must be equal to values that are part of the known
state. While it is possible for a manager to download
application directory details using SNMP and to set the
appropriate directoryID, the manager would need to have some
scheme to ensure consistent values of LocalIndex variables
from agent to agent. Such schemes are outside the scope of
this specification.
Application directory registrations are unique within an
administrative domain.
Typically these registrations will be made by an agent
software developer who will set the application directory
tables to a read-only state and assign a DirectoryID to that
state. Thus, all agents running this software would share the
same DirectoryID. As the application directory might change
from one software release to the next, the developer may
register different DirectoryID's for each software release.
A customer could also create a site-wide application directory
configuration and assign a DirectoryID to that configuration
as long as consistent values of LocalIndex variables can be
ensured.
The value of this object must persist across reboots.
Context
- MIB
- APM-MIB
- OID
.1.3.6.1.2.1.16.23.1.3- Type
- scalar
- Access
- readwrite
- Status
- current
- Parent
- apmMibObjects
- Siblings
- 14
Syntax
ObjectIdentifier
Values & Constraints
No enumerated values or constraints recorded.
Related Objects
Sibling Objects
| Object | Type | Syntax | OID |
|---|---|---|---|
| apmAppDirTable The APM MIB directory of applications and application
verbs. The agent will populate this table with all
applications/verbs of any responsivenessType it has the
capability to moni… | table | - | .1.3.6.1.2.1.16.23.1.1 |
| apmReportTable The data resulting from aggregated APM reports. Consult the
definition of apmReportControlAggregationType for the
definition of the various types of aggregations. | table | - | .1.3.6.1.2.1.16.23.1.10 |
| apmTransactionTable This table contains transactions that are currently running
or have recently finished. | table | - | .1.3.6.1.2.1.16.23.1.11 |
| apmTransactionsRequestedHistorySize The maximum number of completed transactions desired to be
retained in the apmTransactionTable. If the agent doesn't have
enough resources to retain this many, it will retain as m… | scalar | SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.16.23.1.12 |
| apmExceptionTable This table creates filters so that a management station can
get immediate notification of a transaction that has had poor
availability or responsiveness.
Eac… | table | - | .1.3.6.1.2.1.16.23.1.13 |
| apmThroughputExceptionMinTime Because the responsiveness for throughput-oriented
transactions is divided by the elapsed time, it can be very
sensitive to short-term performance variations for
transactions that… | scalar | seconds SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.16.23.1.14 |
| apmNotificationMaxRate The maximum number of notifications that can be generated
from this agent by the apmExceptionTable in any 60 second
period.
The value of this object must persist across… | scalar | SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.16.23.1.15 |
| apmBucketBoundaryLastChange The value of sysUpTime the last time that any bucket boundary
in any appDirEntry was changed. This object can help to
determine if two managers are both trying to enforce differen… | scalar | SNMPv2-TCTimeStamp | .1.3.6.1.2.1.16.23.1.2 |
| apmHttpFilterTable A table that creates virtual applications which measure the
performance of certain web pages or sets of web pages.
When an entry is added to this table, the agent will
… | table | - | .1.3.6.1.2.1.16.23.1.4 |
| apmHttpIgnoreUnregisteredURLs When true, APM measurements of HTTP transactions will only
measure transactions relating to URLs that match a filter in
the apmHttpFilterTable. Thus, measurements for the HTTP
app… | scalar | SNMPv2-TCTruthValue | .1.3.6.1.2.1.16.23.1.5 |
| apmHttp4xxIsFailure When true, this agent will recognize HTTP errors in the range
of 400 through 499 and will treat them as unavailable
transactions. When false or when this object isn't supported,
t… | scalar | SNMPv2-TCTruthValue | .1.3.6.1.2.1.16.23.1.6 |
| apmUserDefinedAppTable A table that advertises user-defined applications that the
agent is measuring.
The agent will automatically create one or more entries in the
apmAppDirTable (one for ea… | table | - | .1.3.6.1.2.1.16.23.1.7 |
| apmNameTable A client machine may have multiple addresses during a period
of monitoring. The apmNameTable assigns a long-lived
identifier to a client and records what addresses were
assigned t… | table | - | .1.3.6.1.2.1.16.23.1.8 |
| apmReportControlTable Parameters that control the creation of a set of reports that
aggregate application performance. | table | - | .1.3.6.1.2.1.16.23.1.9 |