1Info::CiscoStats(3)   User Contributed Perl Documentation  Info::CiscoStats(3)
2
3
4

NAME

6       SNMP::Info::CiscoStats - Perl5 Interface to CPU and Memory stats for
7       Cisco Devices
8

AUTHOR

10       Eric Miller, Max Baker, Sam Stickland
11

SYNOPSIS

13        # Let SNMP::Info determine the correct subclass for you.
14        my $ciscostats = new SNMP::Info(
15                           AutoSpecify => 1,
16                           Debug       => 1,
17                           # These arguments are passed directly on to SNMP::Session
18                           DestHost    => 'myswitch',
19                           Community   => 'public',
20                           Version     => 2
21                           )
22           or die "Can't connect to DestHost.\n";
23
24        my $class      = $ciscostats->class();
25        print "SNMP::Info determined this device to fall under subclass : $class\n";
26

DESCRIPTION

28       SNMP::Info::CiscoStats is a subclass of SNMP::Info that provides cpu,
29       memory, os and version information about Cisco Devices.
30
31       Use or create in a subclass of SNMP::Info.  Do not use directly.
32
33   Inherited Classes
34       None.
35
36   Required MIBs
37       CISCO-PRODUCTS-MIB
38       CISCO-PROCESS-MIB
39       CISCO-MEMORY-POOL-MIB
40       SNMPv2-MIB
41       OLD-CISCO-SYSTEM-MIB
42       CISCO-STACK-MIB
43       CISCO-ENTITY-VENDORTYPE-OID-MIB
44       CISCO-FLASH-MIB
45       ENTITY-MIB
46
47       MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
48

GLOBALS

50       $ciscostats->cpu()
51           Returns ios_cpu() or cat_cpu(), whichever is available.
52
53       $ciscostats->cpu_1min()
54           Returns ios_cpu_1min() or cat_cpu1min(), whichever is available.
55
56       $ciscostats->cpu_5min()
57           Returns ios_cpu_5min() or cat_cpu5min(), whichever is available.
58
59       $ciscostats->mem_total()
60           Returns mem_free() + mem_used()
61
62       $ciscostats->os()
63           Tries to parse if device is running IOS or CatOS from description()
64
65       $ciscostats->vendor()
66            'cisco'
67
68           Available values :
69
70           pix Cisco PIX
71
72           asa Cisco ASA
73
74           fwsm
75               Single-mode FWSM
76
77           fwsm-admin
78               Admin context of multi-context FWSM
79
80           fwsm-context
81               Standard context of multi-context FWSM
82
83           ace-admin
84               Admin context of ACE module
85
86           ace-context
87               Standard context of ACE module (NB: No OS version detection is
88               available, but will be the same as it's 'ace admin')
89
90           css Cisco Content Switch
91
92           css-sca
93               Cisco Content Switch Secure Content Acceleration
94
95       $ciscostats->os_ver()
96           Tries to parse device operating system version from description()
97
98       $ciscostats->ios_cpu()
99           Current CPU usage in percent.
100
101           1.3.6.1.4.1.9.2.1.56.0 = "OLD-CISCO-CPU-MIB:avgBusyPer"
102
103       $ciscostats->ios_cpu_1min()
104           Average CPU Usage in percent over the last minute.
105
106           1.3.6.1.4.1.9.2.1.57.0
107
108       $ciscostats->ios_cpu_5min()
109           Average CPU Usage in percent over the last 5 minutes.
110
111           1.3.6.1.4.1.9.2.1.58.0
112
113       $ciscostats->cat_cpu()
114           Current CPU usage in percent.
115
116           "CISCO-PROCESS-MIB::cpmCPUTotal5sec.9"
117
118       $ciscostats->cat_cpu_1min()
119           Average CPU Usage in percent over the last minute.
120
121           "CISCO-PROCESS-MIB::cpmCPUTotal1min.9"
122
123       $ciscostats->cat_cpu_5min()
124           Average CPU Usage in percent over the last 5 minutes.
125
126           "CISCO-PROCESS-MIB::cpmCPUTotal5min.9"
127
128       $ciscostats->mem_free()
129           Main DRAM free of the device in bytes.
130
131           "CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolFree"
132
133       $ciscostats->mem_used()
134           Main DRAM used of the device in bytes.
135
136           "CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolUsed"
137
138       $ciscostats->mem_total()
139           Main DRAM of the device in bytes.
140
141           "CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolFree" +
142           "CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolUsed"
143
144       $ciscostats->flashmem_total()
145           Flash memory of the device in bytes.
146
147           "CISCO-FLASH-MIB::ciscoFlashDeviceSize"
148

TABLE METHODS

150   Cisco Memory Pool Table ("ciscoMemoryPoolTable")
151       $ciscostats->cisco_mem_free()
152           The number of bytes from the memory pool that are currently unused
153           on the managed device.
154
155           ("ciscoMemoryPoolFree")
156
157       $ciscostats->cisco_mem_used()
158           The number of bytes from the memory pool that are currently in use
159           by applications on the managed device.
160
161           ("ciscoMemoryPoolUsed")
162
163   Cisco Flash Device Table ("ciscoFlashDeviceTable")
164       $ciscostats->cisco_flash_size()
165           Total size of the Flash device.  For a removable device, the size
166           will be zero if the device has been removed.
167
168           ("ciscoFlashDeviceSize")
169
170
171
172perl v5.12.0                      2009-06-12               Info::CiscoStats(3)
Impressum