SNMP Traps for Juniper Power Supplies

LibreNMS/Snmptrap/Handlers/JnxPowerSupplyFailure.php

@@ -0,0 +1,49 @@
+<?php
+/**
+ * JnxPowerSupplyFailure.php
+ *
+ * -Description-
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * @package    LibreNMS
+ * @link       http://librenms.org
+ * @copyright  2019 KanREN, Inc.
+ * @author     <your name> <your email>
+ */
+
+namespace LibreNMS\Snmptrap\Handlers;
+
+use App\Models\Device;
+use LibreNMS\Interfaces\SnmptrapHandler;
+use LibreNMS\Snmptrap\Trap;
+use Log;
+
+class JnxPowerSupplyFailure implements SnmptrapHandler
+{
+    /**
+     * Handle snmptrap.
+     * Data is pre-parsed and delivered as a Trap.
+     *
+     * @param Device $device
+     * @param Trap $trap
+     * @return void
+     */
+    public function handle(Device $device, Trap $trap)
+    {
+        $powerSupply = $trap->getOidData($trap->findOid('JUNIPER-MIB::jnxContentsDescr'));
+        $state = $trap->getOidData($trap->findOid('JUNIPER-MIB::jnxOperatingState'));
+        Log::event("Power Supply $powerSupply is $state", $device->device_id, 'trap', 5);
+    }
+}

LibreNMS/Snmptrap/Handlers/JnxPowerSupplyOk.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * JnxPowerSupplyOK.php
+ *
+ * -Description-
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * @package    LibreNMS
+ * @link       http://librenms.org
+ * @copyright  2019 KanREN, Inc
+ * @author Heath Barnhart <hbarnhart@kanren.net>.
+ */
+
+namespace LibreNMS\Snmptrap\Handlers;
+
+use App\Models\Device;
+use LibreNMS\Interfaces\SnmptrapHandler;
+use LibreNMS\Snmptrap\Trap;
+use Log;
+
+class JnxPowerSupplyOk implements SnmptrapHandler
+{
+    /**
+     * Handle snmptrap.
+     * Data is pre-parsed and delivered as a Trap.
+     *
+     * @param Device $device
+     * @param Trap $trap
+     * @return void
+     */
+    public function handle(Device $device, Trap $trap)
+    {
+        $powerSupply = $trap->getOidData($trap->findOid('JUNIPER-MIB::jnxContentsDescr'));
+        Log::event("Power Supply $powerSupply is OK", $device->device_id, 'trap', 1);
+    }
+}

config/snmptraps.php

@@ -47,6 +47,8 @@
         'JUNIPER-LDP-MIB::jnxLdpLspUp' => \LibreNMS\Snmptrap\Handlers\JnxLdpLspUp::class,
         'JUNIPER-LDP-MIB::jnxLdpSesDown' => \LibreNMS\Snmptrap\Handlers\JnxLdpSesDown::class,
         'JUNIPER-LDP-MIB::jnxLdpSesUp' => \LibreNMS\Snmptrap\Handlers\JnxLdpSesUp::class,
+        'JUNIPER-MIB::jnxPowerSupplyFailure' => \LibreNMS\Snmptrap\Handlers\JnxPowerSupplyFailure::class,
+        'JUNIPER-MIB::jnxPowerSupplyOk' => \LibreNMS\Snmptrap\Handlers\JnxPowerSupplyOk::class,
         'JUNIPER-VPN-MIB::jnxVpnIfDown' => \LibreNMS\Snmptrap\Handlers\JnxVpnIfDown::class,
         'JUNIPER-VPN-MIB::jnxVpnIfUp' => \LibreNMS\Snmptrap\Handlers\JnxVpnIfUp::class,
         'JUNIPER-VPN-MIB::jnxVpnPwDown' => \LibreNMS\Snmptrap\Handlers\JnxVpnPwDown::class,

tests/Feature/SnmpTraps/JnxPowerSupplyTest.php

@@ -0,0 +1,82 @@
+<?php
+/**
+ * JnxPowerSupplyTest.php
+ * -Description-
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ *
+ * Tests JnxDomAlertSet and JnxDomAlertCleared traps from Juniper devices.
+ *
+ * @package    LibreNMS
+ * @link       http://librenms.org
+ * @copyright  2019 KanREN, Inc
+ * @author     Heath Barnhart <hbarnhart@kanren.net>
+ */
+
+namespace LibreNMS\Tests;
+
+use App\Models\Device;
+use LibreNMS\Snmptrap\Dispatcher;
+use LibreNMS\Snmptrap\Trap;
+use LibreNMS\Tests\Feature\SnmpTraps\SnmpTrapTestCase;
+
+class JnxPowerSupplyTest extends SnmpTrapTestCase
+{
+    public function testJnxPowerSupplyFailureTrap()
+    {
+        $device = factory(Device::class)->create();
+
+        $trapText = "$device->hostname
+UDP: [$device->ip]:49716->[10.0.0.1]:162
+DISMAN-EVENT-MIB::sysUpTimeInstance 470:23:25:41.21
+SNMPv2-MIB::snmpTrapOID.0 JUNIPER-MIB::jnxPowerSupplyFailure
+JUNIPER-MIB::jnxContentsContainerIndex.2.4.0.0 2
+JUNIPER-MIB::jnxContentsL1Index.2.4.0.0 4
+JUNIPER-MIB::jnxContentsL2Index.2.4.0.0 0
+JUNIPER-MIB::jnxContentsL3Index.2.4.0.0 0
+JUNIPER-MIB::jnxContentsDescr.2.4.0.0 PEM 3
+JUNIPER-MIB::jnxOperatingState.2.4.0.0 down
+SNMPv2-MIB::snmpTrapEnterprise.0 JUNIPER-CHASSIS-DEFINES-MIB::jnxProductNameMX960";
+
+        $trap = new Trap($trapText);
+        $message = "Power Supply PEM 3 is down";
+        \Log::shouldReceive('event')->once()->with($message, $device->device_id, 'trap', 5);
+
+        $this->assertTrue(Dispatcher::handle($trap), 'Could not handle JnxPowerSupplyFailure');
+    }
+
+    public function testJnxPowerSupplyOkTrap()
+    {
+        $device = factory(Device::class)->create();
+
+        $trapText = "$device->hostname
+UDP: [$device->ip]:49716->[10.0.0.1]:162
+DISMAN-EVENT-MIB::sysUpTimeInstance 470:23:25:41.21
+SNMPv2-MIB::snmpTrapOID.0 JUNIPER-MIB::jnxPowerSupplyOk
+JUNIPER-MIB::jnxContentsContainerIndex.2.4.0.0 2
+JUNIPER-MIB::jnxContentsL1Index.2.4.0.0 4
+JUNIPER-MIB::jnxContentsL2Index.2.4.0.0 0
+JUNIPER-MIB::jnxContentsL3Index.2.4.0.0 0
+JUNIPER-MIB::jnxContentsDescr.2.4.0.0 PEM 4
+JUNIPER-MIB::jnxOperatingState.2.4.0.0 ok
+SNMPv2-MIB::snmpTrapEnterprise.0 JUNIPER-CHASSIS-DEFINES-MIB::jnxProductNameMX960";
+
+        $trap = new Trap($trapText);
+        $message = "Power Supply PEM 4 is OK";
+        \Log::shouldReceive('event')->once()->with($message, $device->device_id, 'trap', 1);
+
+        $this->assertTrue(Dispatcher::handle($trap), 'Could not handle JnxPowerSupplyOk');
+    }
+}