CISCO-SAA-APM-MIB

All MIBs › CISCO-SAA-APM-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2000-10-10

Category: Cisco Devices, Network Monitoring (RMON)

Description: Manages Service Assurance Agent Application Performance Monitor probes and results on Cisco network devices.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-SAA-APM-MIB?

CISCO-SAA-APM-MIB defines the Application Performance Monitor extension to Cisco's Service Assurance Agent (SAA), which runs TCL scripts on a Cisco device to emulate an application's data flows and measure how that application performs over the network. It belongs to the IP SLA/application-performance technology area and exposes both agent-level capacity/resource data and per-operation control and result data. Notably it includes saaApmApplFreeMemLowWaterMark, giving direct visibility into the device's available memory under load, alongside saaApmApplMaxOper/saaApmApplOperCapacity which show how close the agent is to its configured operation capacity — both classic software/resource-health indicators for the monitoring device itself. It builds on the underlying CISCO-RTTMON/SAA control framework and TCL scripting engine referenced by saaApmCtrlScriptCfgURL. It is typically deployed on Cisco routers used as active probes emulating client application behavior (e.g. HTTP, database, or custom TCL-scripted transactions) for application performance monitoring in enterprise WANs. Engineers can download the CISCO-SAA-APM-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-SAA-APM-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco router (SAA/IP SLA probe)

Monitoring Examples

An operator would poll saaApmApplFreeMemLowWaterMark and saaApmApplMaxOper/saaApmApplOperCapacity to see whether the device running the APM agent is running low on memory or has hit its maximum number of concurrent operations, both of which would cause new APM probes to fail to launch. For a specific probe, saaApmCtrlTable exposes saaApmCtrlScriptCfgURL, saaApmCtrlOwner, saaApmCtrlInitDataTrans and saaApmCtrlDataTransTime per saaApmCtrlIndex, so an admin can confirm a given TCL-scripted application emulation actually completed its data transfer within an expected time window, flagging application-level slowdowns.

What Can Be Monitored

agent free memory low-water mark
max/current operation capacity
script config URL per probe
data transfer initiation/completion time

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From IF-MIB

OwnerString

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE

From SNMPv2-TC

RowStatus
TEXTUAL-CONVENTION
TimeStamp
TruthValue

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoSaaApmMIB	1.3.6.1.4.1.9.9.177			Acronyms and Terms: SAA - Service Assurance Agent APM - Application Performance Monitoring A MIB for controlling SAA APM. APM provides a framework for running scripts, written in TCL language, which help emulate the data flows of an application. Through this emulation, the performance of an application across a network can be computed. The parameters required to perform an operation are defined in a 'config file' as defined by saaApmCtrlScriptCfgURL. This MIB has three OBJECT group. 'saaApmAppl' group contains global objects while 'saaApmCtrl' group contains the objects to control the APM operation. Controlling includes creation and deletion of the operation and initiating a result-transfer for the operation. 'saaApmOper' group contains objects to get the statistics of the operation.
ciscoSaaApmMIBObjects	1.3.6.1.4.1.9.9.177.1
saaApmAppl	1.3.6.1.4.1.9.9.177.1.1
I32 saaApmApplMajorVersion	1.3.6.1.4.1.9.9.177.1.1.1	Integer32	read-only	SAA APM application major version.
I32 saaApmApplMinorVersion	1.3.6.1.4.1.9.9.177.1.1.2	Integer32	read-only	SAA APM application minor version.
I32 saaApmApplMaxOper	1.3.6.1.4.1.9.9.177.1.1.3	Integer32	read-only	This object defines the maximum total number of operations that can be configured.
I32 saaApmApplFreeMemLowWaterMark	1.3.6.1.4.1.9.9.177.1.1.4	Integer32	read-write	If APM determines that the available free processor memory has fallen below this mark, new operations will not be configurable until the amount of available free memory is greater than this mark. Available free memory is indicated by the object, ciscoMemoryPoolFree. This object's value should not be set so high as to approach or exceed the free processor memory available on the managed device.
G32 saaApmApplOperCapacity	1.3.6.1.4.1.9.9.177.1.1.5	Gauge32	read-only	This object defines the number of new operations that can be configured on the device. The number is obtain by dividing the memory available for APM by the average memory used for each APM operation. The available memory for APM is computed by taking the difference between Free Memory on the device and saaApmApplFreeMemLowWaterMark. If the current number of operation configured is equal to saaApmApplMaxOper then saaApmApplOperCapacity is zero.
saaApmCtrl	1.3.6.1.4.1.9.9.177.1.2
saaApmCtrlTable	1.3.6.1.4.1.9.9.177.1.2.1		not-accessible	A set of parameters to create, control and destroy an APM Operation.
saaApmCtrlEntry	1.3.6.1.4.1.9.9.177.1.2.1.1		not-accessible	Parameters for controlling APM operation.
I32 saaApmCtrlIndex	1.3.6.1.4.1.9.9.177.1.2.1.1.1	Integer32	not-accessible	This object uniquely identifies a row int the saaApmCtrlTable. This is a pseudo-random number selected by the management station when creating a row via the saaApmCtrlStatus object. If the pseudo-random number is already in use, an 'inconsistentValue' error will be returned by the agent.
STR saaApmCtrlScriptCfgURL	1.3.6.1.4.1.9.9.177.1.2.1.1.2	SnmpAdminString	read-create	This URL defines the location of the config file required to measure the performance of the application. It also defines which protocol should be used in downloading the file. For example ftp://joe:mybirthday@myhost/smtp/smtp.cfg The config file contains the parameters required to start and run the operation. Operation/Results control variables, the URL's of the scheduler, and script/data scriptfiles are all possible parameters contained in the config file.
STR saaApmCtrlOwner	1.3.6.1.4.1.9.9.177.1.2.1.1.3	OwnerString	read-create	Identifies the entity that created this table row.
T/F saaApmCtrlInitDataTrans	1.3.6.1.4.1.9.9.177.1.2.1.1.4	TruthValue	read-create	This object is set to TRUE to initiate result transfer. Results are transferred to a server specified in the control file. It is set back automatically to 'false' by this system once the results are transferred.
TIM saaApmCtrlDataTransTime	1.3.6.1.4.1.9.9.177.1.2.1.1.5	TimeStamp	read-only	This object indicates the time of the last result transfer attempt.
SAA saaApmCtrlDataTransStatus	1.3.6.1.4.1.9.9.177.1.2.1.1.6	SaaApmDataTransErrorCode	read-only	This object indicates the status of the result transfer.
ROW saaApmCtrlStatus	1.3.6.1.4.1.9.9.177.1.2.1.1.7	RowStatus	read-create	saaApmControlScriptCfgURL is the only required object for this row to become 'active'. APM operations are created in one of two ways: 1) By setting this object to 'createAndGo' and supplying a values for saaApmControlScriptCfgURL as part of the same set operation. 2) By setting this object to 'createAndWait' and then supplying a value for saaApmControlScriptCfgURL via a different set operation. In the 'createAndGo' case, the row will transition to 'active' and the APM operation will start. In the 'createAndWait' case, a subsequent set operation will be required to transition the row to 'active' and start the APM operation. The APM operation cannot start until saaApmScriptCfgURL is set. Until the required object is set, the row will be 'notReady'. The APM operation can be started by setting this object to 'active'. The APM operation can be stopped by setting this object to 'notInService'. The APM operation can be deleted by setting this object to 'destroy'. saaApmCtrlStatus transitions from 'active' to 'notInService' if the saaApmOperLastStatus is changed to any error other than 'noError' and 'socketErr'.
T/F saaApmCtrlNvgen	1.3.6.1.4.1.9.9.177.1.2.1.1.8	TruthValue	read-create	This object is to allow or disallow the operation control info from being written to running-config. It cannot be set once the operation is 'active'.
saaApmOper	1.3.6.1.4.1.9.9.177.1.3
saaApmOperTable	1.3.6.1.4.1.9.9.177.1.3.1		not-accessible	A list of Operational status for monitoring APM Operations. All the object in this table are updated after the completion of performance measurement cycle.
saaApmOperEntry	1.3.6.1.4.1.9.9.177.1.3.1.1		not-accessible	An entry containing the status information applicable to a particular APM operation.
TIM saaApmOperLastStartTime	1.3.6.1.4.1.9.9.177.1.3.1.1.1	TimeStamp	read-only	This object represents the start time of the last performance measurement cycle for the application specified by saaApmCtrlScriptCfgURL object.
TIM saaApmOperLastEndTime	1.3.6.1.4.1.9.9.177.1.3.1.1.2	TimeStamp	read-only	This object represents the end time of the last performance measurement cycle for the application specified by saaApmCtrlScriptCfgURL object.
SAA saaApmOperLastStatus	1.3.6.1.4.1.9.9.177.1.3.1.1.3	SaaApmOperErrorCode	read-only	This object is used to indicate status of the last measurement cycle.
ciscoSaaApmMIBNotifPrefix	1.3.6.1.4.1.9.9.177.2
ciscoSaaApmMIBNotifs	1.3.6.1.4.1.9.9.177.2.0
ciscoSaaApmMIBConformance	1.3.6.1.4.1.9.9.177.3
ciscoSaaApmMIBCompliances	1.3.6.1.4.1.9.9.177.3.1
ciscoSaaApmMIBCompliance	1.3.6.1.4.1.9.9.177.3.1.1			The compliance statement for entities which implement the Cisco SAA APM MIB.
ciscoSaaApmMIBGroups	1.3.6.1.4.1.9.9.177.3.2
ciscoSaaApmApplGroup	1.3.6.1.4.1.9.9.177.3.2.1			A collection of objects to provide the general information of SAA APM management.
ciscoSaaApmCtrlGroup	1.3.6.1.4.1.9.9.177.3.2.2			A collection of objects to control the APM Operations.
ciscoSaaApmOperGroup	1.3.6.1.4.1.9.9.177.3.2.3			A collection of objects to provide the operational status of APM Operations.

RFC description

Controls Service Assurance Agent Application Performance Monitoring to measure app performance across networks.

Start monitoring Cisco router (SAA/IP SLA probe) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-SAA-APM-MIB

What Is CISCO-SAA-APM-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description