Cisco CBQOS

Implements the CISCO-CLASS-BASED-QOS-MIB to retrieve QOS counters from Cisco devices.
Policy and Class-map details are collected and stored in the database.
Details are presented on a new "CBQoS" tab of the interface that the policy is applied to.
Includes a policy selector that allows you to select which policy-map to show graphs for.

Each class-map has its own rrd file, in which 3 metrics are stored: Bytes, QoS Drops, Buffer Drops.
This can produce a LOT of rrd files.

As an example:
A Cisco 4500 series switch, running MQC on 200 ports. Each port has a common 5 class queueing policy applied, this creates 1000 (5 x 200) RRD's.

Because of this I have currently set:
```
$config['discovery_modules']['cisco-cbqos']    = 0;
```

Includes function snmpwalk_array_num, which performs a numeric SNMPWalk and returns an array containing $count indexes
One Index:
 From: 1.3.6.1.4.1.9.9.166.1.15.1.1.27.18.655360 = 0
 To: $array['1.3.6.1.4.1.9.9.166.1.15.1.1.27.18']['655360'] = 0
Two Indexes:
 From: 1.3.6.1.4.1.9.9.166.1.15.1.1.27.18.655360 = 0
 To: $array['1.3.6.1.4.1.9.9.166.1.15.1.1.27']['18']['655360'] = 0
And so on...

includes/snmp.inc.php

@@ -1268,4 +1268,70 @@ function register_mibs($device, $mibs, $included_by)
     }
 
     echo "\n";
+
 } // register_mibs
+
+/**
+ * SNMPWalk_array_num - performs a numeric SNMPWalk and returns an array containing $count indexes
+ * One Index:
+ *  From: 1.3.6.1.4.1.9.9.166.1.15.1.1.27.18.655360 = 0
+ *  To: $array['1.3.6.1.4.1.9.9.166.1.15.1.1.27.18']['655360'] = 0
+ * Two Indexes:
+ *  From: 1.3.6.1.4.1.9.9.166.1.15.1.1.27.18.655360 = 0
+ *  To: $array['1.3.6.1.4.1.9.9.166.1.15.1.1.27']['18']['655360'] = 0
+ * And so on...
+ * Think snmpwalk_cache_*_oid but for numeric data.
+ *
+ * Why is this useful?
+ * Some SNMP data contains a single index (eg. ifIndex in IF-MIB) and some is dual indexed
+ * (eg. PolicyIndex/ObjectsIndex in CISCO-CLASS-BASED-QOS-MIB).
+ * The resulting array allows us to easily access the top level index we want and iterate over the data from there.
+ *
+ * @param $device
+ * @param $OID
+ * @param int $indexes
+ * @internal param $string
+ * @return array
+ */
+function snmpwalk_array_num($device,$OID,$indexes=1) {
+    $array = array();
+    $string = snmp_walk($device, $OID, '-Osqn');
+
+    if ( $string === false) {
+        // False means: No Such Object.
+        return false;
+    }
+    if ($string == "") {
+        // Empty means SNMP timeout or some such.
+        return null;
+    }
+
+    // Let's turn the string into something we can work with.
+    foreach (explode("\n", $string) as $line) {
+        if ($line[0] == '.') {
+            // strip the leading . if it exists.
+            $line = substr($line,1);
+        }
+        list($key, $value) = explode(' ', $line, 2);
+        $prop_id = explode('.', $key);
+        $value = trim($value);
+
+        // if we have requested more levels that exist, set to the max.
+        if ($indexes > count($prop_id)) {
+            $indexes = count($prop_id)-1;
+        }
+
+        for ($i=0;$i<$indexes;$i++) {
+            // Pop the index off.
+            $index = array_pop($prop_id);
+            $value = array($index => $value);
+        }
+
+        // Rebuild our key
+        $key = implode('.',$prop_id);
+
+        // Add the entry to the master array
+        $array = array_replace_recursive($array,array($key => $value));
+    }
+    return $array;
+}