STP fix, only try contexts on Cisco (#13767)

* STP fix, only try contexts on Cisco
Only Cisco is known to support this type of polling

* merge, not push.

* Fix collection construction

* Fixed the function signature in Interface def

* fixed signature here as well

* Lighter code to return a collection of Stp instances

* Type enforced in signatures

* missing implement for Cisco Class

* style

* Collection methods are immutable indeed 😠

* nullable vlan

Co-authored-by: PipoCanaja <38363551+PipoCanaja@users.noreply.github.com>

LibreNMS/Interfaces/Discovery/StpInstanceDiscovery.php

@@ -32,7 +32,8 @@ interface StpInstanceDiscovery
     /**
      * Discover STP instances on the device.
      *
+     * @param  string  $vlan  Vlan ID of the instance to discover (or null for default)
      * @return Collection<\App\Models\Stp>
      */
-    public function discoverStpInstances(): Collection;
+    public function discoverStpInstances(?string $vlan = null): Collection;
 }

LibreNMS/OS/Shared/Cisco.php

@@ -31,11 +31,13 @@ use App\Models\Mempool;
 use App\Models\PortsNac;
 use App\Models\Sla;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Collection;
 use LibreNMS\Device\Processor;
 use LibreNMS\Interfaces\Discovery\MempoolsDiscovery;
 use LibreNMS\Interfaces\Discovery\OSDiscovery;
 use LibreNMS\Interfaces\Discovery\ProcessorDiscovery;
 use LibreNMS\Interfaces\Discovery\SlaDiscovery;
+use LibreNMS\Interfaces\Discovery\StpInstanceDiscovery;
 use LibreNMS\Interfaces\Polling\NacPolling;
 use LibreNMS\Interfaces\Polling\SlaPolling;
 use LibreNMS\OS;
@@ -43,7 +45,14 @@ use LibreNMS\OS\Traits\YamlOSDiscovery;
 use LibreNMS\RRD\RrdDefinition;
 use LibreNMS\Util\IP;
 
-class Cisco extends OS implements OSDiscovery, SlaDiscovery, ProcessorDiscovery, MempoolsDiscovery, NacPolling, SlaPolling
+class Cisco extends OS implements
+    OSDiscovery,
+    SlaDiscovery,
+    StpInstanceDiscovery,
+    ProcessorDiscovery,
+    MempoolsDiscovery,
+    NacPolling,
+    SlaPolling
 {
     use YamlOSDiscovery {
         YamlOSDiscovery::discoverOS as discoverYamlOS;
@@ -520,6 +529,20 @@ class Cisco extends OS implements OSDiscovery, SlaDiscovery, ProcessorDiscovery,
         }
     }
 
+    public function discoverStpInstances(?string $vlan = null): Collection
+    {
+        $vlans = $this->getDevice()->vlans;
+        $instances = new Collection;
+
+        // attempt to discover context based vlan instances
+        foreach ($vlans->isEmpty() ? [null] : $vlans as $vlan) {
+            $vlan = (empty($vlan->vlan_vlan) || $vlan->vlan_vlan == '1') ? null : (string) $vlan->vlan_vlan;
+            $instances = $instances->merge(parent::discoverStpInstances($vlan));
+        }
+
+        return $instances;
+    }
+
     protected function getMainSerial()
     {
         $serial_output = snmp_get_multi($this->getDeviceArray(), ['entPhysicalSerialNum.1', 'entPhysicalSerialNum.1001'], '-OQUs', 'ENTITY-MIB:OLD-CISCO-CHASSIS-MIB');

LibreNMS/OS/Traits/BridgeMib.php

@@ -33,7 +33,7 @@ use SnmpQuery;
 
 trait BridgeMib
 {
-    public function discoverStpInstances(): Collection
+    public function discoverStpInstances(?string $vlan = null): Collection
     {
         $protocol = SnmpQuery::get('BRIDGE-MIB::dot1dStpProtocolSpecification.0')->value();
         // 1 = unknown (mstp?), 3 = ieee8021d
@@ -44,13 +44,8 @@ trait BridgeMib
 
         $timeFactor = $this->stpTimeFactor ?? 0.01;
 
-        $vlans = $protocol == 1 ? $this->getDevice()->vlans : new Collection;
-        $instances = new Collection;
-
-        foreach ($vlans->isEmpty() ? [null] : $vlans as $vlan) {
         // fetch STP config and store it
-            $vlan = (empty($vlan->vlan_vlan) || $vlan->vlan_vlan == '1') ? null : $vlan->vlan_vlan;
-            $instance = SnmpQuery::context("$vlan", 'vlan-')->enumStrings()->get([
+        $stp = SnmpQuery::context("$vlan", 'vlan-')->enumStrings()->get([
             'BRIDGE-MIB::dot1dBaseBridgeAddress.0',
             'BRIDGE-MIB::dot1dStpProtocolSpecification.0',
             'BRIDGE-MIB::dot1dStpPriority.0',
@@ -66,17 +61,16 @@ trait BridgeMib
             'BRIDGE-MIB::dot1dStpBridgeMaxAge.0',
             'BRIDGE-MIB::dot1dStpBridgeHelloTime.0',
             'BRIDGE-MIB::dot1dStpBridgeForwardDelay.0',
-            ]);
+        ])->values();
 
-            $stp = $instance->values();
         if (empty($stp)) {
-                continue;
+            return new Collection;
         }
 
         \Log::debug('VLAN: ' . ($vlan ?: 1) . " Bridge: {$stp['BRIDGE-MIB::dot1dBaseBridgeAddress.0']} DR: {$stp['BRIDGE-MIB::dot1dStpDesignatedRoot.0']}");
         $bridge = Rewrite::macToHex($stp['BRIDGE-MIB::dot1dBaseBridgeAddress.0'] ?? '');
         $drBridge = Rewrite::macToHex($stp['BRIDGE-MIB::dot1dStpDesignatedRoot.0'] ?? '');
-            $instances->push(new \App\Models\Stp([
+        $instance = new \App\Models\Stp([
             'vlan' => $vlan,
             'rootBridge' => $bridge == $drBridge ? 1 : 0,
             'bridgeAddress' => $bridge,
@@ -94,10 +88,9 @@ trait BridgeMib
             'bridgeMaxAge' => ($stp['BRIDGE-MIB::dot1dStpBridgeMaxAge.0'] ?? 0) * $timeFactor,
             'bridgeHelloTime' => ($stp['BRIDGE-MIB::dot1dStpBridgeHelloTime.0'] ?? 0) * $timeFactor,
             'bridgeForwardDelay' => ($stp['BRIDGE-MIB::dot1dStpBridgeForwardDelay.0'] ?? 0) * $timeFactor,
-            ]));
-        }
+        ]);
 
-        return $instances;
+        return (new Collection())->push($instance);
     }
 
     public function discoverStpPorts(Collection $stpInstances): Collection