|
Table Of Contents
Service Monitor Support for SNMP MIBs
System Application MIB Implementation
System Application Resource MIB Tables
Sample MIB Walk for System Application MIB
Service Monitor Support for SNMP MIBs
Service Monitor implements the system application MIB using SNMP v2 and supplies an SNMP subagent. You can use simple SNMP queries to monitor the health of applications in the Cisco Unified Communications Management suite that supports the MIB.
For information about configuring your system to use SNMP to manage Service Monitor and other Cisco Unified applications, see Using SNMP to Monitor Service Monitor, page 6-10.
Related Topic
System Application MIB Implementation
System Application MIB Implementation
The system application MIB, defined in RFC 2287, provides applications installed, processes running for an application, and past run information. You can use the information in the system application MIB to determine the overall health of Service Monitor and drill down to the actual processes running for the application.
For more information about the system application MIB, you can browse MIB information at the following URL:
http://www.cisco.com/cgi-bin/Support/Mibbrowser/mibinfo.pl?tab=4
Related Topics
• System Application Resource MIB Tables
• Sample MIB Walk for System Application MIB
System Application Resource MIB Tables
This section describes MIB tables that contain the following information:
• Status of Packages when They Ran Previously
• Status of Elements when They Ran Previously
Installed Packages
Table E-1 stores information for installed packages for Service Monitor and other applications in the Cisco Unified Management Suite that support the system application MIB.
Related Topic
Installed Elements
For each entry in the installed packages table, Table E-1, there can be many entries in the installed element table, Table E-2. The number of installed elements for a package corresponds to the number of processes being monitored for that package.
Table E-2 lists the contents of sysApplInstallElmtTable.
Table E-2 sysApplInstallElmtTable
MIB Row Entry Description from the MIB Cisco Unified Communications Management Suite UsagesysApplInstallPkgIndex
Part of the index for this table. This value identifies the installed software package for the application of which this process is a part.
Value from sysApplInstallPkgTable, Table E-1.
sysApplInstallElmtIndex
Unique number across the applications.
Running number.
sysApplInstallElmtName
The name assigned to the software element package by the manufacturer.
Process name used in the daemon manager (not a file or executable name as specified in RFC 2287).
sysApplInstallElmtType
The type of element that is part of the installed application.
Default application(5).
sysApplInstallElmtDate
The date and time that this component was installed on the system.
Note All dates and times are formatted using SNMPv2 textual conventions.
sysApplInstallElmtPath
Install location for this application
NMSROOT—Directory where Service Monitor is installed. If you selected the default directory during installation, it is C:\Program~1\CSCOpx.
sysApplInstallInstallElmt
SizeHighThe installed file size in 232 byte blocks.
Default 0 (not implemented).
sysApplInstallInstallElmt
SizeLowThe installed file size in 232 byte blocks.
Default 0 (not implemented).
sysApplInstallElmtRole
An operator-assigned value used in the determination of application status.
Value used in determining application status:
•required(3)—Process that must run for the application to be considered running.
•unknown(5)—Optional process.
sysApplInstallElmtModifyDate
The date and time that this element was last modified.
Note All dates and times are formatted using SNMPv2 textual conventions.
sysApplInstallCurSizeHigh
The current file size in 232 byte blocks.
Default 0 (not implemented).
sysApplInstallCurSizeLow
The current file size in 232 byte blocks.
Default 0 (not implemented).
Package Status Information
Table E-3 supplies current application status for Service Monitor and other applications in the Cisco Unified Management Suite that support the system application MIB.
Table E-3 sysApplRunTable
MIB Row Entry Description from the MIB Cisco Unified Communications Management Suite UsagesysApplInstallPkgIndex
Part of the index for this table. This value identifies the installed software package for the application of which this process is a part.
Value from sysApplInstallPkgTable, Table E-1.
sysApplRunIndex
Part of the index for this table. An arbitrary integer used only for indexing purposes. Generally, monotonically increasing from 1 as new applications are started on the host, it uniquely identifies application invocations.
Running number.
sysApplRunStarted
The date and time that the application was started.
Note All dates and times are formatted using SNMPv2 textual conventions.
sysApplRunCurrentState
The current state of the running application instance. The possible values are running(1), runnable(2) but waiting for a resource such as CPU, waiting(3) for an event, exiting(4), or other(5).
This value is the measure of application health:
•running(1)—All required processes are running.
•other(5)-One or more required processes are not running.
When all required processes stop or the daemon manager stops, this entry moves to the sysApplPastRun table.
Element Status Information
Table E-4 provides current status for processes that belong to each application that is currently running.
Table E-4 sysApplElmtRunTable
MIB Row Entry Description from the MIB Cisco Unified Communications Management Suite UsagesysApplElmtRunInstallPkg
Part of the index for this table. This value identifies the installed software package for the application of which this process is a part.
Value from sysApplInstallPkgTable, Table E-1.
sysApplElmtRunInvocID
Part of the index for this table. This value identifies the invocation of an application of which this process is a part.
Default 0.
Note Service Monitor processes run independently and are not invoked by any other process.
sysApplElmtRunIndex
Part of the index for this table. A unique value for each process running on the host.
Process ID in the operating system.
sysApplElmtRunInstallID
Part of the index for this table. The value of this object is the same value as sysApplInstallElmtIndex for the application element of which this entry represents a running instance.
Value from sysApplInstallElmtTable, Table E-2.
sysApplElmtRunTimeStarted
The time the process was started.
—
sysApplElmtRunState
The current state of the running process. The possible values are running(1), runnable(2) but waiting for a resource such as CPU, waiting(3) for an event, exiting(4), or other(5).
If all processes are running successfully, value is running(1).
Note If the process terminates, the process entry moves to the sysElmtPastRun table.
sysApplElmtRunName
The full path and filename of the process.
—
sysApplElmtRunParameters
The starting parameters for the process.
—
sysApplElmtRunCPU
Hundredths of a second of the total system CPU resources consumed by this process.
Obtained from the operating system.
sysApplElmtRunMemory
The total amount of real system memory, measured in kilobytes, currently allocated to this process.
Obtained from the operating system.
sysApplElmtRunNumFiles
The number of regular files that the process currently has open.
Default 0 (not implemented).
sysApplElmtRunUser
The process owner's login name.
Either casuser or SYSTEM.
Status of Packages when They Ran Previously
Table E-5 contains the status of applications when they ran previously.
Table E-5 sysApplPastRunTable
MIB Row Entry Description from the MIBsysApplInstallPkgIndex
Value from sysApplInstallPkgTable, Table E-1.
sysApplPastRunIndex
Part of the index for this table. An arbitrary integer used only for indexing purposes. Generally monotonically increasing from 1 as new applications are started on the host, it uniquely identifies application invocations.
sysApplPastRunStarted
The date and time that the application started.
Note All dates and times are formatted using SNMPv2 textual conventions.
sysApplPastExitState
The state of the application instance when it was terminated.
sysApplPastRunEnded
The date and time the application instance was determined to be no longer running.
Note All dates and times are formatted using SNMPv2 textual conventions.
Status of Elements when They Ran Previously
Table E-6 contains the status of processes when they ran previously.
Scalar Variables
These variables are used to control MIB table size. You cannot update them.
Process Map
The sysApplMapTable contains one entry for each process currently running on the system. Table E-8 provides the index mapping from a process identifier to the invoked application, installed element, and installed application package.
Sample MIB Walk for System Application MIB
This example shows abridged output from a MIB walk of the SYSAPPL-MIB on a system where Cisco Unified Operations Manager and Service Monitor are installed.
***** SNMP QUERY STARTED *****
1: sysApplInstallPkgManufacturer.1 (octet string) Copyright (c) 2004 by Cisco Systems, Inc.[43.6F.70.79.72.69.67.68.74.20.28.63.29.20.32.30.30.34.20.62.79.20.43.69.73.63.6F.20.5 3.79.73.74.65.6D.73.2C.20.49.6E.63.2E (hex)]
2: sysApplInstallPkgManufacturer.2 (octet string) Copyright (c) 2004 by Cisco Systems, Inc.[43.6F.70.79.72.69.67.68.74.20.28.63.29.20.32.30.30.34.20.62.79.20.43.69.73.63.6F.20.5 3.79.73.74.65.6D.73.2C.20.49.6E.63.2E (hex)]
3: sysApplInstallPkgProductName.1 (octet string) Cisco Unified Service Monitor [43.69.73.63.6F.20.55.6E.69.66.69.65.64.20.53.65.72.76.69.63.65.20.4D.6F.6E.69.74.6F.72 (hex)]
4: sysApplInstallPkgProductName.2 (octet string) Cisco Unified Operations Manager and Service Monitor [43.69.73.63.6F.20.55.6E.69.66.69.65.64.20.4F.70.65.72.61.74.69.6F.6E.73.20.4D.61.6E.61.67 .65.72.20.61.6E.64.20.53.65.72.76.69.63.65.20.4D.6F.6E.69.74.6F.72 (hex)]
5: sysApplInstallPkgVersion.1 (octet string) 2.0.0 [32.2E.30.2E.30 (hex)]
6: sysApplInstallPkgVersion.2 (octet string) 2.0.0 [32.2E.30.2E.30 (hex)]
7: sysApplInstallPkgSerialNumber.1 (octet string) n/a [6E.2F.61 (hex)]
8: sysApplInstallPkgSerialNumber.2 (octet string) n/a [6E.2F.61 (hex)]
9: sysApplInstallPkgDate.1 (octet string) 2006-10-12,15:36:45 [07.D6.0A.0C.0F.24.2D (hex)]
10: sysApplInstallPkgDate.2 (octet string) 2006-10-12,15:36:45 [07.D6.0A.0C.0F.24.2D (hex)]
11: sysApplInstallPkgLocation.1 (octet string) C:\PROGRA~1\CSCOpx [43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78 (hex)]
12: sysApplInstallPkgLocation.2 (octet string) C:\PROGRA~1\CSCOpx [43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78 (hex)]
13: sysApplInstallElmtName.1.1 (octet string) QOVR [51.4F.56.52 (hex)]
14: sysApplInstallElmtName.1.2 (octet string) QOVRDbEngine [51.4F.56.52.44.62.45.6E.67.69.6E.65 (hex)]
15: sysApplInstallElmtName.1.3 (octet string) QOVRDbMonitor [51.4F.56.52.44.62.4D.6F.6E.69.74.6F.72 (hex)]
16: sysApplInstallElmtName.1.4 (octet string) Apache [41.70.61.63.68.65 (hex)]
17: sysApplInstallElmtName.1.5 (octet string) CmfDbEngine [43.6D.66.44.62.45.6E.67.69.6E.65 (hex)]
18: sysApplInstallElmtName.1.6 (octet string) JRunProxyServer [4A.52.75.6E.50.72.6F.78.79.53.65.72.76.65.72 (hex)]
19: sysApplInstallElmtName.1.7 (octet string) Tomcat [54.6F.6D.63.61.74 (hex)]
20: sysApplInstallElmtName.1.8 (octet string) WebServer [57.65.62.53.65.72.76.65.72 (hex)]
21: sysApplInstallElmtName.2.9 (octet string) AdapterServer [41.64.61.70.74.65.72.53.65.72.76.65.72 (hex)]
22: sysApplInstallElmtName.2.10 (octet string) Apache [41.70.61.63.68.65 (hex)]
23: sysApplInstallElmtName.2.11 (octet string) CmfDbEngine [43.6D.66.44.62.45.6E.67.69.6E.65 (hex)]
24: sysApplInstallElmtName.2.12 (octet string) DCRServer [44.43.52.53.65.72.76.65.72 (hex)]
25: sysApplInstallElmtName.2.13 (octet string) DfmBroker [44.66.6D.42.72.6F.6B.65.72 (hex)]
26: sysApplInstallElmtName.2.14 (octet string) DfmServer [44.66.6D.53.65.72.76.65.72 (hex)]
27: sysApplInstallElmtName.2.15 (octet string) EDS [45.44.53 (hex)]
28: sysApplInstallElmtName.2.16 (octet string) EPMDbEngine [45.50.4D.44.62.45.6E.67.69.6E.65 (hex)]
29: sysApplInstallElmtName.2.17 (octet string) EPMServer [45.50.4D.53.65.72.76.65.72 (hex)]
30: sysApplInstallElmtName.2.18 (octet string) ESS [45.53.53 (hex)]
31: sysApplInstallElmtName.2.19 (octet string) FHDbEngine [46.48.44.62.45.6E.67.69.6E.65 (hex)]
32: sysApplInstallElmtName.2.20 (octet string) FHServer [46.48.53.65.72.76.65.72 (hex)]
33: sysApplInstallElmtName.2.21 (octet string) GPF [47.50.46 (hex)]
34: sysApplInstallElmtName.2.22 (octet string) INVDbEngine [49.4E.56.44.62.45.6E.67.69.6E.65 (hex)]
35: sysApplInstallElmtName.2.23 (octet string) IVR [49.56.52 (hex)]
36: sysApplInstallElmtName.2.24 (octet string) IPIUDbEngine [49.50.49.55.44.62.45.6E.67.69.6E.65 (hex)]
37: sysApplInstallElmtName.2.25 (octet string) IPSLAServer [49.50.53.4C.41.53.65.72.76.65.72 (hex)]
38: sysApplInstallElmtName.2.26 (octet string) ITMDiagServer [49.54.4D.44.69.61.67.53.65.72.76.65.72 (hex)]
39: sysApplInstallElmtName.2.27 (octet string) Interactor [49.6E.74.65.72.61.63.74.6F.72 (hex)]
40: sysApplInstallElmtName.2.28 (octet string) InventoryCollector [49.6E.76.65.6E.74.6F.72.79.43.6F.6C.6C.65.63.74.6F.72 (hex)]
41: sysApplInstallElmtName.2.29 (octet string) IPIUDataServer [49.50.49.55.44.61.74.61.53.65.72.76.65.72 (hex)]
42: sysApplInstallElmtName.2.30 (octet string) ITMOGSServer [49.54.4D.4F.47.53.53.65.72.76.65.72 (hex)]
43: sysApplInstallElmtName.2.31 (octet string) jrm [6A.72.6D (hex)]
44: sysApplInstallElmtName.2.32 (octet string) LicenseServer [4C.69.63.65.6E.73.65.53.65.72.76.65.72 (hex)]
45: sysApplInstallElmtName.2.33 (octet string) NOTSServer [4E.4F.54.53.53.65.72.76.65.72 (hex)]
46: sysApplInstallElmtName.2.34 (octet string) PTMServer [50.54.4D.53.65.72.76.65.72 (hex)]
47: sysApplInstallElmtName.2.35 (octet string) PIFServer [50.49.46.53.65.72.76.65.72 (hex)]
48: sysApplInstallElmtName.2.36 (octet string) QoVMServer [51.6F.56.4D.53.65.72.76.65.72 (hex)]
49: sysApplInstallElmtName.2.37 (octet string) SRSTServer [53.52.53.54.53.65.72.76.65.72 (hex)]
50: sysApplInstallElmtName.2.38 (octet string) SIRServer [53.49.52.53.65.72.76.65.72 (hex)]
51: sysApplInstallElmtName.2.39 (octet string) STServer [53.54.53.65.72.76.65.72 (hex)]
52: sysApplInstallElmtName.2.40 (octet string) Tomcat [54.6F.6D.63.61.74 (hex)]
53: sysApplInstallElmtName.2.41 (octet string) TISServer [54.49.53.53.65.72.76.65.72 (hex)]
54: sysApplInstallElmtName.2.42 (octet string) TopoServer [54.6F.70.6F.53.65.72.76.65.72 (hex)]
55: sysApplInstallElmtName.2.43 (octet string) VsmServer [56.73.6D.53.65.72.76.65.72 (hex)]
56: sysApplInstallElmtName.2.44 (octet string) VHMIntegrator [56.48.4D.49.6E.74.65.67.72.61.74.6F.72 (hex)]
57: sysApplInstallElmtName.2.45 (octet string) VHMServer [56.48.4D.53.65.72.76.65.72 (hex)]
58: sysApplInstallElmtName.2.46 (octet string) ITMCTMStartup [49.54.4D.43.54.4D.53.74.61.72.74.75.70 (hex)]
59: sysApplInstallElmtName.2.47 (octet string) IPSLAPurgeTask [49.50.53.4C.41.50.75.72.67.65.54.61.73.6B (hex)]
60: sysApplInstallElmtName.2.48 (octet string) GpfPurgeTask [47.70.66.50.75.72.67.65.54.61.73.6B (hex)]
61: sysApplInstallElmtName.2.49 (octet string) FHPurgeTask [46.48.50.75.72.67.65.54.61.73.6B (hex)]
62: sysApplInstallElmtType.1.1 (integer) application(5)
63: sysApplInstallElmtType.1.2 (integer) application(5)
111: sysApplInstallElmtDate.1.1 (octet string) 2006-10-12,15:36:45 [07.D6.0A.0C.0F.24.2D (hex)]
112: sysApplInstallElmtDate.1.2 (octet string) 2006-10-12,15:36:45 [07.D6.0A.0C.0F.24.2D (hex)]
160: sysApplInstallElmtPath.1.1 (octet string) C:\PROGRA~1\CSCOpx [43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78 (hex)]
209: sysApplInstallElmtSizeHigh.1.1 (integer) 0
258: sysApplInstallElmtSizeLow.1.1 (integer) 0
307: sysApplInstallElmtRole.1.1 (integer) required(3)
356: sysApplInstallElmtModifyDate.1.1 (octet string) 2006-10-12,15:36:45 [07.D6.0A.0C.0F.24.2D (hex)]
405: sysApplInstallElmtCurSizeHigh.1.1 (integer) 0
454: sysApplInstallElmtCurSizeLow.1.1 (integer) 0
503: sysApplRunStarted.1.2 (octet string) 2006-10-18,17:13:24 [07.D6.0A.12.11.0D.18 (hex)]
505: sysApplRunCurrentState.1.2 (integer) running(1)
507: sysApplElmtRunInstallID.0.0.888 (integer) 0
563: sysApplElmtRunTimeStarted.0.0.888 (octet string) 2006-10-18,17:15:35 [07.D6.0A.12.11.0F.23 (hex)]
619: sysApplElmtRunState.0.0.888 (integer) running(1)
675: sysApplElmtRunName.0.0.888 (octet string) C:\PROGRA~1\CSCOpx\lib\vbroker\bin\osagent.exe [43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78.5C.6C.69.62.5C.76.62.72.6F.6B.65.72 .5C.62.69.6E.5C.6F.73.61.67.65.6E.74.2E.65.78.65 (hex)]
731: sysApplElmtRunParameters.0.0.888 (octet string) -p 42342 [2D.70.20.34.32.33.34.32 (hex)]
787: sysApplElmtRunCPU.0.0.888 (timeticks) 0 days 00h:04m:27s.39th (26739)
843: sysApplElmtRunMemory.0.0.888 (integer) 676
899: sysApplElmtRunNumFiles.0.0.888 (integer) 0
955: sysApplElmtRunUser.0.0.888 (octet string) SYSTEM [53.59.53.54.45.4D (hex)]
1000: sysApplElmtRunUser.2.0.9220 (octet string) casuser [63.61.73.75.73.65.72 (hex)]
1011: sysApplElmtPastRunInstallID.2.0.6180 (integer) 44
1012: sysApplElmtPastRunTimeStarted.2.0.6180 (octet string) 2006-10-18,17:16:27 [07.D6.0A.12.11.10.1B (hex)]
1013: sysApplElmtPastRunTimeEnded.2.0.6180 (octet string) 2006-11-5,12:45:49 [07.D6.0B.05.0C.2D.31 (hex)]
1014: sysApplElmtPastRunName.2.0.6180 (octet string) C:\PROGRA~1\CSCOpx\bin\cwjava.exe [43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78.5C.62.69.6E.5C.63.77.6A.61.76.61.2E .65.78.65 (hex)]
1015: sysApplElmtPastRunParameters.2.0.6180 (octet string) -Dcom.smarts.conf.clientConnect=C:\PROGRA~1\CSCOpx\objects\smarts\conf\clientConnect.conf -Djava.security.policy=C:\PROGRA~1\CSCOpx\lib\jre2\lib\security\java.policy -Xmx128m -cw:jre C:\PROGRA~1\CSCOpx\lib\jre -cw:xrs -cp:pmf conf\vhm\vhm.classpath [2D.44.63.6F.6D.2E.73.6D.61.72.74.73.2E.63.6F.6E.66.2E.63.6C.69.65.6E.74.43.6F.6E.6E.65.63 .74.3D.43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78.5C.6F.62.6A.65.63.74.73.5C.73 .6D.61.72.74.73.5C.63.6F.6E.66.5C.63.6C.69.65.6E.74.43.6F.6E.6E.65.63.74.2E.63.6F.6E.66.20 .20.2D.44.6A.61.76.61.2E.73.65.63.75.72.69.74.79.2E.70.6F.6C.69.63.79.3D.43.3A.5C.50.52.4F .47.52.41.7E.31.5C.43.53.43.4F.70.78.5C.6C.69.62.5C.6A.72.65.32.5C.6C.69.62.5C.73.65.63.75 .72.69.74.79.5C.6A.61.76.61.2E.70.6F.6C.69.63.79.20.2D.58.6D.78.31.32.38.6D.20.20.2D.63.77 .3A.6A.72.65.20.43.3A.5C.50.52.4F.47.52.41.7E.31.5C.43.53.43.4F.70.78.5C.6C.69.62.5C.6A.72 .65.20.20.2D.63.77.3A.78.72.73.20.20.2D.63.70.3A.70.6D.66.20.63.6F.6E.66.5C.76.68.6D.5C.76 .68.6D.2E.63.6C.61.73.73.70.61.74.68.20.20 (hex)]
1016: sysApplElmtPastRunCPU.2.0.6180 (timeticks) 0 days 00h:01m:52s.06th (11206)
1017: sysApplElmtPastRunMemory.2.0.6180 (integer) 970216
1018: sysApplElmtPastRunNumFiles.2.0.6180 (integer) 0
1019: sysApplElmtPastRunUser.2.0.6180 (octet string) SYSTEM [53.59.53.54.45.4D (hex)]
1020: sysApplPastRunMaxRows.0 (integer) 2000
1021: sysApplPastRunTableRemItems.0 (integer) 20
1022: sysApplPastRunTblTimeLimit.0 (integer) 86400
1023: sysApplElemPastRunMaxRows.0 (integer) 2000
1024: sysApplElemPastRunTableRemItems.0 (integer) 20
1025: sysApplElemPastRunTblTimeLimit.0 (integer) 86400
1026: sysApplAgentPollInterval.0 (integer) 60
1027: sysApplMap.2.888.0.0 (integer) 0
1082: sysApplMap.2.15056.0.28 (integer) 2
***** SNMP QUERY FINISHED *****
Posted: Fri Aug 31 12:37:35 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.