APM-MIB
AI MIB Summary
The APM-MIB module enables the monitoring of end-user application performance metrics, specifically tracking transaction response times, success rates, and error counts across networked services. It facilitates the correlation of application-layer latency and availability with underlying network conditions to identify performance bottlenecks affecting user experience.
The MIB module for measuring application performance as experienced by end-users.
Copyright (C) The Internet Society (2004). This version of this MIB module is part of RFC 3729; see the RFC itself for full legal notices.
Main OID:
apm.1.3.6.1.4.1.3727.20.20.3.1.16.23
99
Objects
Active
Status
6
Dependencies
Imported Objects
Objects
99 total| Object Name |
|---|
apmThe MIB module for measuring application performance
as experienced by end-users.
Copyright (C) The Internet Society (2004). This version of
this MIB module is part of RFC 3729; see the RFC itself for
full legal notices. MODULE-IDENTITY .1.3.6.1.4.1.3727.20.20.3.1.16.23 |
apmNotifications OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.16.23.0 |
apmTransactionResponsivenessAlarmNotification sent when a transaction exceeds a threshold
defined in the apmException table. The index of the
included apmExceptionResponsivenessThreshold object identifies
the apmExceptionEntry that specified the threshold. The
apmTransactionResponsiveness variable identifies the actual
transaction and its responsiveness.
Agent implementors are urged to include additional data
objects in the alarm that may explain the reason for the
alarm. It is helpful to include such data in the alarm because
it describes the situation at the time the alarm was
generated, where polls after the fact may not provide
meaningful information. Examples of such information are CPU
load, memory utilization, network utilization, and transaction
statistics. NOTIFICATION-TYPE .1.3.6.1.4.1.3727.20.20.3.1.16.23.0.1 |
apmTransactionUnsuccessfulAlarmNotification sent when a transaction is unsuccessful.
The index of the included apmExceptionResponsivenessThreshold
object identifies both the type of the transaction that caused
this notification as well as the apmExceptionEntry that
specified the threshold.
Agent implementors are urged to include additional data
objects in the alarm that may explain the reason for the
alarm. It is helpful to include such data in the alarm because
it describes the situation at the time the alarm was
generated, where polls after the fact may not provide
meaningful information. Examples of such information are CPU
load, memory utilization, network utilization, and transaction
statistics. NOTIFICATION-TYPE .1.3.6.1.4.1.3727.20.20.3.1.16.23.0.2 |
apmMibObjects OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.16.23.1 |
apmAppDirTableThe 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 monitor. Since the agent populates this table
with every entry it has the capability to monitor, the
entries in this table are read-write, allowing the management
station to modify parameters in this table but not to add new
entries or delete entries (however, entries may be
disabled). If new entries are added to the apmHttpFilterTable
or the apmUserDefinedAppTable, the agent will add the
corresponding entries to this table.
It is an implementation-dependent matter as to how the agent
sets these default parameters. For example, it may leave
certain entries in this table 'off(0)' if the agent developer
believes that combination will be infrequently used, allowing
a manager that needs that capability to set it to 'on(1)'.
Some applications are registered in the RMON2 protocol
directory and some are registered in other tables in this
MIB Module. Regardless of where an application is originally
registered, it is assigned an AppLocalIndex value that is the
primary index for this table.
The contents of this table affect all reports and exceptions
generated by this agent. Accordingly, modification of this
table should be performed by a manager acting in the role of
administrator. In particular, management software should not
require or enforce particular configuration of this table - it
should reflect the preferences of the site administrator, not
the software author. As a practical matter, this requires
management software to allow the administrator to configure
the values it will use so that it can be adapted to the site
policy. SEQUENCE OF ApmAppDirEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1 |
apmAppDirEntryThe APM MIB directory of applications and application
verbs. An entry will exist in this table for all applications
for which application performance measurement is supported. ApmAppDirEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1 |
apmAppDirAppLocalIndexThe AppLocalIndex assigned for this application Directory
entry. AppLocalIndex .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.1 |
apmAppDirResponsivenessTypeThis object describes and configures the agent's support for
application performance measurement for this application.
There are 3 types of measurements for different types of
applications:
Transaction-Oriented applications have a fairly constant
workload to perform for all transactions. The responsiveness
metric for transaction-oriented applications is application
response time (from first request to final delivery of
service) and is measured in milliseconds. This is
commonly referred to as end-user response time.
Throughput-Oriented applications have widely varying workloads
based on the nature of the client request. In particular,
throughput-oriented applications vary widely in the amount of
data that must be transported to satisfy the request. The
responsiveness metric for throughput-oriented applications is
kilobits per second.
Streaming-Oriented applications deliver data at a constant
metered rate of speed regardless of the responsiveness of the
networking and computing infrastructure. This constant rate of
speed is generally specified to be below (sometimes well
below) the nominal capability of the infrastructure. However,
when the infrastructures cannot deliver data at this speed,
interruption of service or degradation of service can
result. The responsiveness metric for streaming-oriented
applications is the ratio of time that the service is degraded
or interrupted to the total service time. This metric is
measured in parts per million.
Note that for some applications, measuring more than one
responsiveness type may be interesting. For agents that wish
to support more than one measurement for a application, they
will populate this table with multiple entries for that
application, one for each type. Enumeration .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.2 |
apmAppDirConfigThis object describes and configures support for application
performance measurement for this application.
If the value of this object is on(2), the agent supports
measurement of application performance metrics for this
application and is configured to measure such metrics for all
APM MIB functions and all interfaces. If the value of this
object is off(1), the agent supports measurement of
application performance for this application but is configured
to not measure these metrics for any APM MIB functions or
interfaces. Whenever this value changes from on(2) to off(1),
the agent shall delete all related entries in all tables in
this MIB Module.
The value of this object must persist across reboots.rw Enumeration .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.3 |
apmAppDirResponsivenessBoundary1The boundary value between bucket1 and bucket 2. If this
value is modified, all entries in the apmReportTable must be
deleted by the agent.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.4 |
apmAppDirResponsivenessBoundary2The boundary value between bucket2 and bucket 3. If this
value is modified, all entries in the apmReportTable must be
deleted by the agent.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.5 |
apmAppDirResponsivenessBoundary3The boundary value between bucket3 and bucket 4. If this
value is modified, all entries in the apmReportTable must be
deleted by the agent.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.6 |
apmAppDirResponsivenessBoundary4The boundary value between bucket4 and bucket 5. If this
value is modified, all entries in the apmReportTable must be
deleted by the agent.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.7 |
apmAppDirResponsivenessBoundary5The boundary value between bucket5 and bucket 6. If this
value is modified, all entries in the apmReportTable must be
deleted by the agent.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.8 |
apmAppDirResponsivenessBoundary6The boundary value between bucket6 and bucket 7. If this
value is modified, all entries in the apmReportTable must be
deleted by the agent.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.1.1.9 |
apmBucketBoundaryLastChangeThe 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 different
configurations of this table.ro TimeStamp (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.2 |
apmAppDirIDThis 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.rw OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.3 |
apmHttpFilterTableA 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
automatically create one or more entries in the
apmAppDirTable (one for each responsivenessType it is
capable of measuring).
Note that when entries exist in this table some HTTP
transactions will be summarized twice: in applications
represented here as well as the HTTP application. If entries
in this table overlap, these transactions may be summarized
additional times.
The contents of this table affect all reports and exceptions
generated by this agent. Accordingly, modification of this
table should be performed by a manager acting in the role of
administrator. In particular, management software should not
require or enforce particular configuration of this table - it
should reflect the preferences of the site administrator, not
the software author. SEQUENCE OF ApmHttpFilterEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4 |
apmHttpFilterEntryA virtual application which measure the performance of certain
web pages or sets of web pages. ApmHttpFilterEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1 |
apmHttpFilterIndexAn index that uniquely identifies an entry in the
apmHttpFilterTable. Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.1 |
apmHttpFilterAppLocalIndexThe AppLocalIndex that represents HTTP transactions
that match this entry.
This object is read-only. A value is created by the agent from
an unused AppLocalIndex value when this apmHttpFilterEntry is
created.ro AppLocalIndex .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.2 |
apmHttpFilterServerProtocolThe protocolDirLocalIndex value of the network level protocol
of the apmHttpFilterServerAddress.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.3 |
apmHttpFilterServerAddressThis entry will only represent transactions coming from the
network address specified in this object.
This is represented as an octet string with
specific semantics and length as identified
by the associated apmHttpFilterServerProtocol object.
If this object is the zero-length string, then this entry will
match one of the addresses represented by the 'host' component
of the associated apmHttpFilterURLPath object, where the
format if a URL [9] is
http://<host>:<port>/<path>?<searchpart>.rw ProtocolDirNetworkAddress .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.4 |
apmHttpFilterURLPathThis entry will only represent HTTP transactions
where the URL path component in the request matches this
value. This value represents the requested path regardless of
any substitution that the server might perform.
Prior to the matching, the URL is stripped of any server
address or DNS name and consists solely of the path name on
that server.
If the length of this object is zero, then this entry will
match if the associated apmHttpFilterServerAddress match. If
the length of that object is also zero, then this entry will
match nothing.
The value of the associated apmHttpFilterMatchType dictates
the type of matching that will be attempted.rw OCTET STRING .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.5 |
apmHttpFilterMatchTypeThe matching algorithm used to compare the URL pathname.
If the value is exact(1), then the pathname component will be
compared with the associated apmHttpFilterURLPath and
will only be associated with this entry if it matches exactly.
If the value is stripTrailingSlash(2), then the pathname
component will be compared with the associated
apmHttpFilterURLPath and will only be associated with this
entry if it matches exactly or if the pathname ends with a '/'
symbol and matches apmHttpFilterURLPath if the '/' symbol is
removed from the pathname. This option exists for those paths
where an optional trailing slash is possible but for which a
prefix match would be too broad.
If the value is prefix(3), then the pathname component will be
compared with the associated apmHttpFilterURLPath and will
only be associated with this entry if the beginning of the
pathname matches every octet of this value. Octets that extend
beyond the length of this value are ignored.rw Enumeration .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.6 |
apmHttpFilterOwnerThe entity that configured this entry and is
therefore using the resources assigned to it.rw OwnerString (RMON-MIB) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.7 |
apmHttpFilterStorageTypeThe storage type of this apmHttpFilterEntry. If the value of
this object is 'permanent', no objects in this row need to be
writable.rw StorageType (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.8 |
apmHttpFilterRowStatusThe status of this apmHttpFilterEntry. No objects in this row
may be modified while the row's status is 'active'.rw RowStatus (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.4.1.9 |
apmHttpIgnoreUnregisteredURLsWhen 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
application will present aggregated statistics for
URL-matching HTTP transactions and measurements for the HTTP
GET application verb will present aggregated statistics for
URL-matching HTTP GET transactions.
This will be used in environments that wish to monitor only
targeted URLs and to ignore large volumes of internet web
browsing traffic.
This object affects all APM reports and exceptions generated
by this agent. Accordingly, modification of this object should
be performed by a manager acting in the role of
administrator. In particular, management software should not
require or enforce particular configuration of this object -
it should reflect the preferences of the site administrator,
not the software author.
The value of this object must persist across reboots.rw TruthValue (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.5 |
apmHttp4xxIsFailureWhen 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,
they will be treated as successful transactions.
This object allows such error pages to be tracked at the
possible expense of having user typos treated as poor service
on the part of the web server.
This object affects all reports and exceptions generated by
this agent. Accordingly, modification of this object should be
performed by a manager acting in the role of administrator. In
particular, management software should not require or enforce
particular configuration of this object - it should reflect
the preferences of the site administrator, not the software
author.
The value of this object must persist across reboots.rw TruthValue (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.6 |
apmUserDefinedAppTableA 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 each responsivenessType it is
capable of measuring) for each entry in this table.
Note that when entries exist in this table some
transactions can be summarized more than once if there is
overlap between applications defined here and applications
defined in the protocol directory or in the httpFilter table. SEQUENCE OF ApmUserDefinedAppEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.7 |
apmUserDefinedAppEntryA user-defined application that the agent is measuring, along
with its AppLocalIndex assignment.
The apmAppDirAppLocalIndex value in the index identifies
the agent-assigned AppLocalIndex value for this user-defined
application. ApmUserDefinedAppEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.7.1 |
apmUserDefinedAppParentIndexThe protocolDirLocalIndex value of the highest-layer
protocol defined in the protocolDirTable that this
application is a child of.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.7.1.1 |
apmUserDefinedAppApplicationA human readable descriptive tag for this application.ro SnmpAdminString (SNMP-FRAMEWORK-MIB) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.7.1.2 |
apmNameTableA 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 to that client for periods of time. Various
implementation techniques exist for tracking this mapping but
if an agent is unable to track client address mappings, it may
map client identifiers to client addresses rather than to
distinct client machines.
A particular apmNameClientID should be a constant attribute of
a particular client. When available, the agent may also record
the machine name and/or user name which may be valuable for
displaying to humans. The apmNameMachineName and
apmNameUserName are relatively constant, changing only if
these attributes actually change on the client.
The agent will store a historical log of these entries, aging
out old entries as the log becomes too large. Since this table
contains information vital to the interpretation of other
tables (e.g., the apmReportTable), the agent should ensure that
the log doesn't age out entries that would be referenced by
data in those tables.
Note that an entry for a clientID is active from its
StartTime until the StartTime of another entry (for the same
clientID) that supersedes it, or 'now' if none supersede
it. Therefore, if a clientID only has a single entry, it is by
definition very new and should never be aged out. No entry for
a clientID should be aged out unless it has been updated by a
new entry for the client (i.e., with an updated address) and
only if the new entry is 'old' enough.
To determine how old is old enough, compute the maximum value
of Interval * (NumReports + 1) of all entries in the
apmReportControlTable (the '+ 1' is to allow a reasonable
period of time for the report to be downloaded). Then take the
larger of this value and the age in seconds of the oldest
entry in the current transaction table. If an entry for a
clientID is superseded by another entry whose StartTime is
more than this many seconds ago, then the older entry may be
deleted. SEQUENCE OF ApmNameEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8 |
apmNameEntryAn entry in the APM name table. An entry exists for each
period of time that a client has been associated with a
particular address.
The protocolDirLocalIndex value in the index identifies
the network layer protocol for the ClientAddress for this
entry.
Note that some combinations of index values may result in an
index that exceeds 128 sub-identifiers in length which exceeds
the maximum for the SNMP protocol. Implementations should take
care to avoid such combinations. ApmNameEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8.1 |
apmNameClientIDA unique ID assigned to the machine represented by this
mapping. This ID is assigned by the agent using an
implementation-specific algorithm. RmonClientID .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8.1.1 |
apmNameClientAddressThe network client address for this client when this mapping
was active.
This is represented as an octet string with specific semantics
and length as identified by the protocolDirLocalIndex
component of the index. This object may not be the zero length
string.
Since this object is an index variable, it is encoded in the
index according to the index encoding rules. For example, if
the protocolDirLocalIndex component of the index indicates an
encapsulation of ip, this object is encoded as a length octet
of 4, followed by the 4 octets of the ip address, in network
byte order. Care should be taken to avoid values of this
object that, in conjunction with the other index variables,
would result in an index longer than SNMP's maximum of 128
subidentifiers. ProtocolDirNetworkAddress .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8.1.2 |
apmNameMappingStartTimeThe time that the agent first discovered this mapping
as active. DateAndTime (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8.1.3 |
apmNameMachineNameThe human readable name of the client machine.
If the client has no machine name or the agent is
unable to learn the machine name, this object will be
a zero-length string.ro SnmpAdminString (SNMP-FRAMEWORK-MIB) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8.1.4 |
apmNameUserNameThe human readable name of a human user using the client
machine. If more than one user name are available
simultaneously, it is an implementation-dependent matter as to
which is used here. However, if the user name changes, this
object should change to reflect that change.
Non-human user names like 'root' or 'administrator' aren't
intended as values for this object. If the client has no
recorded user name or the agent is unable to learn a user
name, this object will be a zero-length string.ro SnmpAdminString (SNMP-FRAMEWORK-MIB) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.8.1.5 |
apmReportControlTableParameters that control the creation of a set of reports that
aggregate application performance. SEQUENCE OF ApmReportControlEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9 |
apmReportControlEntryA conceptual row in the apmReportControlTable.
An example of the indexing of this table is
apmReportControlInterval.3 ApmReportControlEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1 |
apmReportControlIndexAn index that uniquely identifies an entry in the
apmReportControlTable. Each such entry defines a unique
report whose results are placed in the apmReportTable on
behalf of this apmReportControlEntry. Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.1 |
apmReportControlDataSourceThe source of the data for APM Reports generated on
behalf of this apmReportControlEntry.
If the measurement is being performed by a probe, this should
be set to interface or port where data was received for
analysis. If the measurement isn't being performed by a probe,
this should be set to the primary interface over which the
measurement is being performed. If the measurement isn't being
performed by a probe and there is no primary interface or this
information isn't known, this object should be set to 0.0.
This object may not be modified if the associated
apmReportControlStatus object is equal to active(1).rw DataSourceOrZero .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.2 |
apmReportControlAggregationTypeThe type of aggregation being performed for this set of
reports.
The metrics for a single transaction are the responsiveness of
the transaction and whether the transaction succeeded (a
boolean). When such metrics are aggregated in this MIB Module,
these metrics are replaced by averages and distributions of
responsiveness and availability. The metrics describing
aggregates are constant no matter which type of aggregation is
being performed. These metrics may be found in the
apmReportTable.
The flows(1) aggregation is the simplest. All transactions
that share common application/server/client 3-tuples are
aggregated together, resulting in a set of metrics for all
such unique 3-tuples.
The clients(2) aggregation results in somewhat more
aggregation (i.e., fewer resulting records). All transactions
that share common application/client tuples are aggregated
together, resulting in a set of metrics for all such unique
tuples.
The servers(3) aggregation usually results in still more
aggregation (i.e., fewer resulting records). All transactions
that share common application/server tuples are aggregated
together, resulting in a set of metrics for all such unique
tuples.
The applications(4) aggregation results in the most
aggregation (i.e., the fewest resulting records). All
transactions that share a common application are aggregated
together, resulting in a set of metrics for all such unique
applications.
Note that it is not meaningful to aggregate applications, as
different applications have widely varying characteristics.
As a result, this set of aggregations is complete.
This object may not be modified if the associated
apmReportControlStatus object is equal to active(1).rw TransactionAggregationType -- INTEGER { -- flows(1), -- clients(2), -- servers(3), -- applications(4) -- } .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.3 |
apmReportControlIntervalThe interval in seconds over which data is accumulated before
being aggregated into a report in the apmReportTable. All
reports with the same apmReportControlIndex will be based on
the same interval. This object must be greater than zero.
Many users desire that these reports be synchronized to within
seconds of the beginning of the hour because the results may
be correlated more meaningfully to business behavior and so
that data from multiple agents is aggregated over the same
time periods. Thus management software may take extra effort
to synchronize reports to the beginning of the hour and to one
another. However, the agent must not allow reports to 'drift'
over time as they will quickly become unsynchronized. In
particular, if there is any fixed processing delay between
reports, the reports should deduct this time from the interval
so that reports don't drift.
This object may not be modified if the associated
apmReportControlStatus object is equal to active(1).rw Unsigned32 UNITS "Seconds" .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.4 |
apmReportControlRequestedSizeThe number of entries requested to be allocated for each
report generated on behalf of this entry.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.5 |
apmReportControlGrantedSizeThe number of entries per report the agent has allocated
based on the requested amount in apmReportControlRequestedSize.
Since multiple reports are saved, the total number of entries
allocated will be this number multiplied by the value of
apmReportControlGrantedReports, or 1 if that object doesn't
exist.
When the associated apmReportControlRequestedSize object is
created or modified, the agent should set this object as
closely to the requested value as is possible for the
particular implementation and available resources. When
considering resources available, the agent must consider its
ability to allocate this many entries for all reports.
Note that while the actual number of entries stored in the
reports may fluctuate due to changing conditions, the agent
must continue to have storage available to satisfy the full
report size for all reports when necessary. Further, the agent
must not lower this value except as a result of a set to the
associated apmReportControlRequestedSize object.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.6 |
apmReportControlRequestedReportsThe number of saved reports requested to be allocated on
behalf of this entry.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.7 |
apmReportControlGrantedReportsThe number of saved reports the agent has allocated
based on the requested amount in
apmReportControlRequestedReports. Since each report can have
many entries, the total number of entries allocated will be
this number multiplied by the value of
apmReportControlGrantedSize, or 1 if that object doesn't
exist.
When the associated apmReportControlRequestedReports object is
created or modified, the agent should set this object as
closely to the requested value as is possible for the
particular implementation and available resources. When
considering resources available, the agent must consider its
ability to allocate this many reports each with the number of
entries represented by apmReportControlGrantedSize, or 1 if
that object doesn't exist.
Note that while the storage required for each report may
fluctuate due to changing conditions, the agent must continue
to have storage available to satisfy the full report size for
all reports when necessary. Further, the agent must not lower
this value except as a result of a set to the associated
apmReportControlRequestedSize object.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.8 |
apmReportControlStartTimeThe value of sysUpTime when the system began processing the
report in progress. Note that the report in progress is not
available.
This object may be used by the management station to figure
out the start time for all previous reports saved for this
apmReportControlEntry, as reports are started at fixed
intervals.ro TimeStamp (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.9 |
apmReportControlReportNumberThe number of the report in progress. When an
apmReportControlEntry is activated, the first report will be
numbered one.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.10 |
apmReportControlDeniedInsertsThe number of failed attempts to add an entry to reports for
this apmReportControlEntry because the number of entries
would have exceeded apmReportControlGrantedSize.
This number is valuable in determining if enough entries have
been allocated for reports in light of fluctuating network
usage. Note that since an entry that is denied will often be
attempted again, this number will not predict the exact number
of additional entries needed, but can be used to understand
the relative magnitude of the problem.
Also note that there is no ordering specified for the entries
in the report, thus there are no rules for which entries will
be omitted when not enough entries are available. As a
consequence, the agent is not required to delete 'least
valuable' entries first.ro Counter32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.11 |
apmReportControlDroppedFramesThe total number of frames which were received by the agent
and therefore not accounted for in the *StatsDropEvents, but
for which the agent chose not to count for this entry for
whatever reason. Most often, this event occurs when the agent
is out of some resources and decides to shed load from this
collection.
This count does not include packets that were not counted
because they had MAC-layer errors.
This counter is only relevant if this apm report is based on
a data source whose collection methodology is based on
analyzing network traffic.
Note that if the apmReportTables are inactive because no
applications are enabled in the application directory, this
value should be 0.
Note that, unlike the dropEvents counter, this number is the
exact number of frames dropped.ro Counter32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.12 |
apmReportControlOwnerThe entity that configured this entry and is
therefore using the resources assigned to it.rw OwnerString (RMON-MIB) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.13 |
apmReportControlStorageTypeThe storage type of this apmReportControlEntry. If the value
of this object is 'permanent', no objects in this row need to
be writable.rw StorageType (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.14 |
apmReportControlStatusThe status of this apmReportControlEntry.
An entry may not exist in the active state unless all
objects in the entry have an appropriate value. The only
objects in the entry that may be modified while the entry is
in the active state are apmReportControlRequestedSize and
apmReportControlRequestedReports.
If this object is not equal to active(1), all
associated entries in the apmReportTable shall be deleted
by the agent.rw RowStatus (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.9.1.15 |
apmReportTableThe data resulting from aggregated APM reports. Consult the
definition of apmReportControlAggregationType for the
definition of the various types of aggregations. SEQUENCE OF ApmReportEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10 |
apmReportEntryA conceptual row in the apmReportTable.
The apmReportControlIndex value in the index identifies the
apmReportControlEntry on whose behalf this entry was created.
The apmReportIndex value in the index identifies which report
(in the series of reports) this entry is a part of.
The apmAppDirAppLocalIndex value in the index identifies
the common application of the transactions aggregated in this
entry.
The apmAppDirResponsivenessType value in the index
identifies the type of responsiveness metric reported by
this entry and uniquely identifies this entry when more
than one responsiveness metric is measured for a flow.
Entries will only exist in this table for those
combinations of AppLocalIndex and ResponsivenessType
that are configured 'on(1)'.
The protocolDirLocalIndex value in the index identifies
the network layer protocol of the apmReportServerAddress.
When the associated apmReportControlAggregationType value is
equal to applications(4) or clients(2), this
protocolDirLocalIndex value will equal 0.
The apmReportServerAddress value in the index identifies the
network layer address of the server in transactions aggregated
in this entry.
The apmNameClientID value in the index identifies the
client in transactions aggregated in this entry. If the
associated apmReportControlAggregationType is equal to
applications(4) or servers(3), then this protocolDirLocalIndex
value will equal 0.
An example of the indexing of this entry is
apmReportTransactionCount.3.15.3.1.8.4.192.168.1.2.3232235788
Note that some combinations of index values may result in an
index that exceeds 128 sub-identifiers in length which exceeds
the maximum for the SNMP protocol. Implementations should take
care to avoid such combinations. ApmReportEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1 |
apmReportIndexThe value of apmReportControlReportNumber for the report to
which this entry belongs. Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.1 |
apmReportServerAddressThe network server address for this apmReportEntry.
This is represented as an octet string with
specific semantics and length as identified
by the protocolDirLocalIndex component of the index.
Since this object is an index variable, it is encoded in the
index according to the index encoding rules. For example, if
the protocolDirLocalIndex indicates an encapsulation of ip,
this object is encoded as a length octet of 4, followed by the
4 octets of the ip address, in network byte order. Care
should be taken to avoid values of this object that, in
conjunction with the other index variables, would result in an
index longer than SNMP's maximum of 128 subidentifiers.
If the associated apmReportControlAggregationType is equal to
applications(4) or clients(2), then this object will be a null
string and will be encoded simply as a length octet of 0. ProtocolDirNetworkAddress .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.2 |
apmReportTransactionCountThe total number of transactions aggregated into this record.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.3 |
apmReportSuccessfulTransactionsThe total number of successful transactions aggregated into
this record.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.4 |
apmReportResponsivenessMeanThe arithmetic mean of the responsiveness metrics for all
successful transactions aggregated into this record.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.5 |
apmReportResponsivenessMinThe minimum of the responsiveness metrics for all
successful transactions aggregated into this record.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.6 |
apmReportResponsivenessMaxThe maximum of the responsiveness metrics for all
successful transactions aggregated into this record.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.7 |
apmReportResponsivenessB1The number of successful transactions aggregated into this
record whose responsiveness was less than boundary1 value for
this application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.8 |
apmReportResponsivenessB2The number of successful transactions aggregated into this
record whose responsiveness did not fall into Bucket 1 and was
greater than or equal to the boundary1 value for this
application and less than the boundary2 value for this
application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.9 |
apmReportResponsivenessB3The number of successful transactions aggregated into this
record whose responsiveness did not fall into Bucket 1 or 2
and as greater than or equal to the boundary2 value for this
application and less than the boundary3 value for this
application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.10 |
apmReportResponsivenessB4The number of successful transactions aggregated into this
record whose responsiveness did not fall into Buckets 1
through 3 and was greater than or equal to the boundary3 value
for this application and less than the boundary4 value for
this application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.11 |
apmReportResponsivenessB5The number of successful transactions aggregated into this
record whose responsiveness did not fall into Buckets 1
through 4 and was greater than or equal to the boundary4 value
for this application and less than the boundary5 value for
this application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.12 |
apmReportResponsivenessB6The number of successful transactions aggregated into this
record whose responsiveness did not fall into Buckets 1
through 5 and was greater than or equal to the
boundary5 value for this application and less than the
boundary6 value for this application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.13 |
apmReportResponsivenessB7The number of successful transactions aggregated into this
record whose responsiveness did not fall into Buckets 1
through 6 and was greater than or equal to the boundary6 value
for this application.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.10.1.14 |
apmTransactionTableThis table contains transactions that are currently running
or have recently finished. SEQUENCE OF ApmTransactionEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11 |
apmTransactionEntryA conceptual row in the apmTransactionTable.
The apmAppDirAppLocalIndex value in the index identifies
the application of the transaction represented by this entry.
The apmAppDirResponsivenessType value in the index
identifies the type of responsiveness metric reported by
this entry and uniquely identifies this entry when more
than one responsiveness metric is measured for a flow.
Entries will only exist in this table for those
combinations of AppLocalIndex and ResponsivenessType
that are configured 'on(1)'.
The protocolDirLocalIndex value in the index identifies
the network layer protocol of the apmTransactionServerAddress.
The apmTransactionServerAddress value in the index identifies
the network layer address of the server in the transaction
represented by this entry.
The apmNameClientID value in the index identifies the
client in the transaction represented by this entry.
An example of the indexing of this entry is
apmTransactionCount.3.1.8.4.192.168.1.2.3232235788.2987
Note that some combinations of index values may result in an
index that exceeds 128 sub-identifiers in length which exceeds
the maximum for the SNMP protocol. Implementations should take
care to avoid such combinations. ApmTransactionEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11.1 |
apmTransactionServerAddressThe network server address for this apmTransactionEntry.
This is represented as an octet string with specific semantics
and length as identified by the protocolDirLocalIndex
component of the index. This object may not be the zero length
string.
For example, if the protocolDirLocalIndex indicates an
encapsulation of ip, this object is encoded as a length octet
of 4, followed by the 4 octets of the ip address, in network
byte order. Care should be taken to avoid values of this
object that, in conjunction with the other index variables,
would result in an index longer than SNMP's maximum of 128
subidentifiers. ProtocolDirNetworkAddress .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11.1.1 |
apmTransactionIDA unique value for this transaction amongst other
transactions sharing the same application layer protocol and
server and client addresses. Implementations may choose to use
the value of the client's source port, when possible. Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11.1.2 |
apmTransactionResponsivenessThe current value of the responsiveness metric for this
transaction. If this transaction has completed, the final
value of the metric will be available.
Note that this value may change over the lifetime of the
transaction and it is the final value of this metric that is
recorded as the responsiveness of the transaction for use in
other APM MIB functions.ro Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11.1.3 |
apmTransactionAgeIf this transaction is still executing, this value shall be
the length of time since it was started. If it has completed,
this value shall be the length of time it was executing.ro TimeInterval (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11.1.4 |
apmTransactionSuccessThe success of this transaction up to this time. Once a
transaction has been marked as failed, it cannot move back
into the successful state.ro TruthValue (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.11.1.5 |
apmTransactionsRequestedHistorySizeThe 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 many as
possible. Regardless of this value, the agent must attempt to
keep records for all current transactions it is monitoring.
The value of this object must persist across reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.12 |
apmExceptionTableThis table creates filters so that a management station can
get immediate notification of a transaction that has had poor
availability or responsiveness.
Each apmExceptionEntry is associated with a particular type of
transaction and is applied to all transactions of that
type. Multiple apmExceptionEntries may be associated with a
particular type of transaction. A transaction type is
identified by the value of the apmAppDirAppLocalIndex
component of the index.
Because the quality of a transaction is not known until it is
completed, these thresholds are only applied after the
transaction has completed. SEQUENCE OF ApmExceptionEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13 |
apmExceptionEntryA conceptual row in the apmExceptionTable.
The apmAppDirAppLocalIndex value in the index identifies
the application this entry will monitor.
The apmAppDirResponsivenessType value in the index
identifies the type of responsiveness metric this entry will
monitor. ApmExceptionEntry .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1 |
apmExceptionIndexAn index that uniquely identifies an entry in the
apmExceptionTable amongst other entries with equivalent index
values for apmAppDirAppLocalIndex and
apmAppDirResponsivenessType. Each such entry sets up
thresholds for a particular measurement of a particular
application. Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.1 |
apmExceptionResponsivenessComparisonIf this value is greater(2) or less(3), the associated
apmExceptionResponsivenessThreshold will be compared to this
value and an exception will be created if the responsiveness
is greater than the threshold (greater(2)) or less than the
threshold (less(3)).rw Enumeration .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.2 |
apmExceptionResponsivenessThresholdThe threshold that responsiveness metrics are compared to.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.3 |
apmExceptionUnsuccessfulExceptionIf this value is on(2), an exception will be created if a
transaction of the associated type is unsuccessful.rw Enumeration .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.4 |
apmExceptionResponsivenessEventsThe total number of responsiveness exceptions generated. This
counter will be incremented even if no notification was sent
due to notifications not being configured or due to exceeding
the apmNotificationMaxRate value.ro Counter32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.5 |
apmExceptionUnsuccessfulEventsThe total number of unsuccessful exceptions generated. This
counter will be incremented even if no notification was sent
due to notifications not being configured or due to exceeding
the apmNotificationMaxRate value.ro Counter32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.6 |
apmExceptionOwnerThe entity that configured this entry and is
therefore using the resources assigned to it.rw OwnerString (RMON-MIB) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.7 |
apmExceptionStorageTypeThe storage type of this apmReportControlEntry. If the value
of this object is 'permanent', no objects in this row need to
be writable.rw StorageType (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.8 |
apmExceptionStatusThe status of this apmExceptionEntry. The only objects in the
entry that may be modified while the entry is in the active
state are apmExceptionResponsivenessComparison,
apmExceptionResponsivenessThreshold and
apmExceptionUnsuccessfulException.rw RowStatus (SNMPv2-TC) .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.13.1.9 |
apmThroughputExceptionMinTimeBecause 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 take a short period of time. For example,
when downloading a very short file, a single dropped packet
could double or triple the total response time.
Further, throughput is usually examined for applications that
transfer a lot of data, and when doing so it is helpful to
conceptualize transaction costs that are proportional to the
amount of data separately from those costs that are relatively
fixed (i.e., independent of the amount of data). For very
short transactions, these fixed transaction costs (handshake,
setup time, authentication, round-trip time) may dominate the
total response time for the transaction, resulting in
throughput measurements that aren't really proportional to the
network's, server's and client's combined data throughput
capability.
This object controls the minimum number of seconds that an
throughput-based transaction must exceed before an exception
can be generated for it. If this object is set to zero, then
all throughput-based transactions are candidates for
exceptions.
The value of this object must persist across reboots.rw Unsigned32 UNITS "seconds" .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.14 |
apmNotificationMaxRateThe 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 reboots.rw Unsigned32 .1.3.6.1.4.1.3727.20.20.3.1.16.23.1.15 |
apmConformance OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.16.23.2 |
apmCompliances OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.16.23.2.1 |
apmGroups OBJECT IDENTIFIER .1.3.6.1.4.1.3727.20.20.3.1.16.23.2.2 |