Copian

Copian is a suite of SNMP network device collectors. It provides an easy way of gathering information from SNMP enabled network devices. As of the current version it supports the following

  • Network Interface Stats

    • MTU size

    • Connection speed (in bits)

    • Admin and Oper status indicating UP/DOWN

  • Network Interface Bandwidth, including 64 bit counter support.

  • Switch port to IP Address mapping

  • Switch port to MAC Addresses

  • VLAN listings

Examples

Collecting the status of all the network interfaces on a Cisco Router

require 'copian'
collector = Copian::Collector::Cisco.new('192.168.1.1', 'public')
collector.port_stats do |ifindex, ifname, mtu, speed, admin_status, oper_status|
  puts "Port #{ifname} is #{oper_status} @ #{speed} bps. mtu (#{mtu})"
end
# Port 1/e1 is 1 @ 100000000. mtu(1500)
# ...

presently the admin_status and oper_status are not interpreted, but equate to

  1. up

  2. down

  3. testing

History

1.3.3 - 2012/02/20

  • 1 major enhancement

    • Add interface description collector

1.3.2 - 2009/10/06

  • 1 major correction

    • BandwidthCollector fixed, it was incredibly buggy

1.3.1 - 2009/10/06

  • 1 patch

    • Fix symbol reference for the bandwidth collector from :64bit -> :b64

1.3.0 - 2009/10/05

  • 1 major enhancement

    • Added generic Bandwidth collector with support for 32 and 64bit counters to use the 64 bit counters => true needs to be passed to the bandwidth method on the collector.

1.2.0 - 2009/02/04

  • 2 major enhancements

    • Added VLAN collector to Dell collector

    • Added VLAN collector to HP collector

1.1.1 - 2009/02/04

  • 1 bug fix

    • Fixed HP ports collector incorrectly stripping information from returned ObjectID resulting in invalid MAC addresses

1.1.0 - 2009/02/04

  • 3 major enhancement

    • Dell collector with ports support

    • HP collector with ports support

    • Port stats, ifMtu, ifSpeed, ifAdminStatus and ifOperStatus

  • 1 extensibility enhancement

    • Introduced Generic Collector from which the others descend

1.0.0 - 2009/02/03

  • 1 major enhancement

    • Cisco collector supports Ports, VLANs and Addresses

0.0.1 - 2009/02/02

  • 1 major enhancement

    • initial creation

Copyright © 2009 Geoff Garside. See LICENSE for details.