SNMP::Info::CiscoStats3pm
Perl5 interface to cpu and memory stats for cisco devices
Usage
# 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::SessionDestHost => '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";
Overview
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-IMAGE-MIB
Globals
- $ciscostats->
cpu() -
Returns
ios_cpu()orcat_cpu(), whichever is available.
- $ciscostats->
cpu_1min() -
Returns
ios_cpu_1min()orcat_cpu1min(), whichever is available.
- $ciscostats->
cpu_5min() -
Returns
ios_cpu_5min()orcat_cpu5min(), whichever is available.
- $ciscostats->
mem_total() -
Returns
mem_free()+mem_used()
- $ciscostats->
vendor() -
'cisco'
- $ciscostats->
os() -
Tries to parse if device is running 'IOS', 'CatOS', 'IOS-XE' or something else from
description()Available values:
'ios' for Cisco IOS'ios-xe' for Cisco IOS XE'ios-xr' for Cisco IOS XR'pix' for Cisco PIX'asa' for Cisco ASA'fwsm' for Single-mode FWSM'fwsm-admin' for Admin context of multi-context FWSM'fwsm-context' for Standard context of multi-context FWSM'ace-admin' for Admin context of ACE module'ace-context' for Standard context of ACE module (NB: No OS versiondetection is available, but will be the same as it's'ace admin')'css' for Cisco Content Switch'css-sca' for Cisco Content Switch Secure Content Acceleration'san-os' for Cisco SAN-OS
- $ciscostats->
os_ver() -
Tries to parse device operating system version from
description(), falls back to parsing"CISCO-IMAGE-MIB::ciscoImageString"if needed
- $ciscostats->
os_bin() -
Tries to parse
"ROMMON"version fromrom_id()string
- $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")
Cisco Image Table ("ciscoImageTable")
- $ci->
ci_images() -
Returns the table of image strings.
"ciscoImageString"
Releases
9 releases since Debian 5.0 (Lenny); the text changed 8 times.