Added APC UPS SNMP Monitor

docs/monitors/apcupssnmp.rst

@@ -0,0 +1,55 @@
+apcupssnmp - APC UPS status via NMC
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Connects directly to an APC UPS with an NMC (Network Management Card) installed, using SNMP.
+
+Currently only supports SNMP v1
+
+
+.. confval:: host
+
+    :type: string
+    :required: true
+
+    The hostname or IP address of the UPS
+
+.. confval:: community
+
+    :type: string
+    :required: false
+    :default: ``public``
+
+    The SNMP Community name to use when connecting to the UPS.
+
+.. conval:: maxloadpct
+
+    :type: int
+    :required: false
+    :default: ``80``
+
+    The Load Percentage of the UPS to be OK. A value over 100 will never trigger this warning.
+
+.. conval:: battpctwarn
+
+    :type: int
+    :required: false
+    :default: ``20``
+
+    The minimum Battery Percentage warning, above this number the battery is deemed OK. Monitor will fail if battery is under 20%. Useful to ensure the monitor stays in a failed state until the battery has recovered enough after a power outage.
+
+.. conval:: runtimemin
+
+    :type: int
+    :required: false
+    :default: ``10``
+
+    The minimum allowed runtime of the UPS, defaults to 10 (10 minutes). This default is used to allow enough time to trigger shutdown of systems.
+
+.. conval:: textdelimeter
+
+    :type: string
+    :required: false
+    :default: ``,``
+
+    The text to use to seperate each item in the Details when returned from the test. Defaults to using a comma ','.
+    Useful if you want to use this text in another system, or make it easier to read

pyproject.toml

@@ -55,6 +55,7 @@ paramiko = ">=2.7.2,<4.0.0"
 pyaarlo = ">=0.8.0.19,<0.9.0.0"
 icmplib = "^3.0.3"
 packaging = "^26.2"
+snmp = "^1.2.1"
 
 [tool.poetry.group.dev.dependencies]
 boto3-stubs = {extras = ["sns"], version = "^1.43.10"}

simplemonitor/Monitors/__init__.py

@@ -2,6 +2,7 @@
 Monitors for SimpleMonitor
 """
 
+from .apcupssnmp import MonitorAPCUPSSNMP
 from .arlo import MonitorArloCamera
 from .compound import CompoundMonitor, RemoteHostsMonitor
 from .file import MonitorBackup
@@ -44,6 +45,7 @@
 from .unifi import MonitorUnifiFailover, MonitorUnifiFailoverWatchdog
 
 __all__ = [
+    "MonitorAPCUPSSNMP",
     "MonitorMQTT",
     "CompoundMonitor",
     "MonitorApcupsd",