NAME
SNMP::Info::CiscoStats - Perl5 Interface to CPU and Memory stats for Cisco Devices
AUTHOR
Eric Miller, Max Baker, Sam Stickland
SYNOPSIS
# Let SNMP::Info determine the correct subclass for you.
my $ciscostats = new SNMP::Info(
AutoSpecify => 1,
Debug => 1,
# These arguments are passed directly on to SNMP::Session
DestHost => 'myswitch',
Community => 'public',
Version => 2
)
or die "Can't connect to DestHost.\n";
my $class = $ciscostats->class(); print "SNMP::Info determined this device to fall under subclass : $class\n";
DESCRIPTION
SNMP::Info::CiscoStats is a subclass of SNMP::Info that provides cpu, memory, os and version information about Cisco Devices.
Use or create in a subclass of SNMP::Info. Do not use directly.
Inherited Classes
None.
Required MIBs
- CISCO-PRODUCTS-MIB
- CISCO-PROCESS-MIB
- CISCO-MEMORY-POOL-MIB
- SNMPv2-MIB
- OLD-CISCO-SYSTEM-MIB
- CISCO-STACK-MIB
- CISCO-ENTITY-VENDORTYPE-OID-MIB
- CISCO-FLASH-MIB
- ENTITY-MIB
- CISCO-PROCESS-MIB
MIBs can be found at ftp://ftp.cisco.com/pub/mibs/v2/v2.tar.gz
GLOBALS
- $ciscostats->
cpu() -
Returns
ios_cpu()or cat_cpu(), whichever is available. - $ciscostats->
cpu_1min() -
Returns
ios_cpu_1min()or cat_cpu1min(), whichever is available. - $ciscostats->
cpu_5min() -
Returns
ios_cpu_5min()or cat_cpu5min(), whichever is available. - $ciscostats->
mem_total() -
Returns
mem_free()+mem_used() - $ciscostats->
os() -
Tries to parse if device is running IOS or CatOS from
description() -
Available values :
- pix
-
Cisco PIX
- asa
-
Cisco ASA
- fwsm
-
Single-mode FWSM
- fwsm-admin
-
Admin context of multi-context FWSM
- fwsm-context
-
Standard context of multi-context FWSM
- ace-admin
-
Admin context of ACE module
- ace-context
-
Standard context of ACE module (NB: No OS version detection is available, but will be the same as it's 'ace admin')
- css
-
Cisco Content Switch
- css-sca
-
Cisco Content Switch Secure Content Acceleration
- $ciscostats->
os_ver() -
Tries to parse device operating system version from
description() - $ciscostats->
ios_cpu() -
Current CPU usage in percent.
-
1.3.6.1.4.1.9.2.1.56.0=OLD-CISCO-CPU-MIB:avgBusyPer - $ciscostats->
ios_cpu_1min() -
Average CPU Usage in percent over the last minute.
-
1.3.6.1.4.1.9.2.1.57.0 - $ciscostats->
ios_cpu_5min() -
Average CPU Usage in percent over the last 5 minutes.
-
1.3.6.1.4.1.9.2.1.58.0 - $ciscostats->
cat_cpu() -
Current CPU usage in percent.
-
CISCO-PROCESS-MIB::cpmCPUTotal5sec.9 - $ciscostats->
cat_cpu_1min() -
Average CPU Usage in percent over the last minute.
-
CISCO-PROCESS-MIB::cpmCPUTotal1min.9 - $ciscostats->
cat_cpu_5min() -
Average CPU Usage in percent over the last 5 minutes.
-
CISCO-PROCESS-MIB::cpmCPUTotal5min.9 - $ciscostats->
mem_free() -
Main DRAM free of the device in bytes.
-
CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolFree - $ciscostats->
mem_used() -
Main DRAM used of the device in bytes.
-
CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolUsed - $ciscostats->
mem_total() -
Main DRAM of the device in bytes.
-
CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolFree+CISCO-MEMORY-POOL-MIB::ciscoMemoryPoolUsed - $ciscostats->
flashmem_total() -
Flash memory of the device in bytes.
-
CISCO-FLASH-MIB::ciscoFlashDeviceSize
TABLE METHODS
Cisco Memory Pool Table (ciscoMemoryPoolTable)
- $ciscostats->
cisco_mem_free() -
The number of bytes from the memory pool that are currently unused on the managed device.
-
(
ciscoMemoryPoolFree) - $ciscostats->
cisco_mem_used() -
The number of bytes from the memory pool that are currently in use by applications on the managed device.
-
(
ciscoMemoryPoolUsed)
Cisco Flash Device Table (ciscoFlashDeviceTable)
- $ciscostats->
cisco_flash_size() -
Total size of the Flash device. For a removable device, the size will be zero if the device has been removed.
-
(
ciscoFlashDeviceSize)
