check-health: monitor free RAM

---- ✂️ ----
🗃️📉️ Health warning: free RAM

The available free RAM on MikroTik is at 18% (47MiB)!
---- ✂️ ----
🗃️📈️ Health recovery: free RAM

The available free RAM on MikroTik increased to 65% (168MiB).
---- ✂️ ----

check-health

@@ -12,6 +12,7 @@
 
 :global CheckHealthCPULoad;
 :global CheckHealthCPULoadNotified;
+:global CheckHealthFreeRAMNotified;
 :global CheckHealthLast;
 :global CheckHealthTemperature;
 :global CheckHealthTemperatureDeviation;
@@ -45,7 +46,9 @@
 
 $ScriptLock $0;
 
-:set CheckHealthCPULoad (($CheckHealthCPULoad * 4 + [ /system/resource/get cpu-load ] * 10) / 5);
+:local Resource [ /system/resource/get ];
+
+:set CheckHealthCPULoad (($CheckHealthCPULoad * 4 + ($Resource->"cpu-load") * 10) / 5);
 :if ($CheckHealthCPULoad > 750 && $CheckHealthCPULoadNotified != true) do={
   $SendNotification2 ({ origin=$0; \
     subject=([ $SymbolForNotification "abacus,chart-increasing" ] . "Health warning: CPU load"); \
@@ -59,6 +62,23 @@ $ScriptLock $0;
   :set CheckHealthCPULoadNotified false;
 }
 
+:local CheckHealthFreeRAM ($Resource->"free-memory" * 100  / $Resource->"total-memory");
+:if ($CheckHealthFreeRAM < 20 && $CheckHealthFreeRAMNotified != true) do={
+  $SendNotification2 ({ origin=$0; \
+    subject=([ $SymbolForNotification "card-file-box,chart-decreasing" ] . "Health warning: free RAM"); \
+    message=("The available free RAM on " . $Identity . " is at " . $CheckHealthFreeRAM . "% (" . \
+    ($Resource->"free-memory" / 1024 / 1024) . "MiB)!") });
+  :set CheckHealthFreeRAMNotified true;
+}
+:if ($CheckHealthFreeRAM > 30 && $CheckHealthFreeRAMNotified = true) do={
+  $SendNotification2 ({ origin=$0; \
+    subject=([ $SymbolForNotification "card-file-box,chart-increasing" ] . "Health recovery: free RAM"); \
+    message=("The available free RAM on " . $Identity . " increased to " . $CheckHealthFreeRAM . "% (" . \
+    ($Resource->"free-memory" / 1024 / 1024) . "MiB).") });
+  :set CheckHealthFreeRAMNotified false;
+}
+
+
 :foreach Voltage in=[ /system/health/find where type="V" ] do={
   :local Name  [ /system/health/get $Voltage name  ];
   :local Value [ /system/health/get $Voltage value ];

doc/check-health.md

@@ -13,14 +13,16 @@ This script is run from scheduler periodically, sending notification on
 health related events:
 
 * high CPU load
+* low available free RAM
 * voltage jumps up or down more than configured threshold or drops below limit
 * power supply failed or recovered
 * temperature is above or below threshold
 
 Note that bad initial state will not trigger an event.
 
-Monitoring CPU load works on all devices. Other than that only sensors
+Monitoring CPU load and available free RAM works on all devices. Other
-available in hardware can be checked. See what your hardware supports:
+than that only sensors available in hardware can be checked. See what your
+hardware supports:
 
     /system/health/print;
 
@@ -31,19 +33,24 @@ available in hardware can be checked. See what your hardware supports:
 ![check-health notification cpu load high](check-health.d/notification-01-cpu-load-high.avif)
 ![check-health notification cpu load ok](check-health.d/notification-02-cpu-load-ok.avif)
 
+#### Available free RAM
+
+![check-health notification free ram low](check-health.d/notification-03-free-ram-low.avif)
+![check-health notification free ram ok](check-health.d/notification-04-free-ram-ok.avif)
+
 #### Voltage
 
-![check-health notification voltage](check-health.d/notification-03-voltage.avif)
+![check-health notification voltage](check-health.d/notification-05-voltage.avif)
 
 #### Temperature
 
-![check-health notification temperature high](check-health.d/notification-04-temperature-high.avif)  
+![check-health notification temperature high](check-health.d/notification-06-temperature-high.avif)  
-![check-health notification temperature ok](check-health.d/notification-05-temperature-ok.avif)
+![check-health notification temperature ok](check-health.d/notification-07-temperature-ok.avif)
 
 #### PSU state
 
-![check-health notification psu fail](check-health.d/notification-06-psu-fail.avif)  
+![check-health notification psu fail](check-health.d/notification-08-psu-fail.avif)  
-![check-health notification psu ok](check-health.d/notification-07-psu-ok.avif)
+![check-health notification psu ok](check-health.d/notification-09-psu-ok.avif)
 
 Requirements and installation
 -----------------------------

global-functions

@@ -1078,6 +1078,7 @@
     "abacus"="\F0\9F\A7\AE";
     "alarm-clock"="\E2\8F\B0";
     "calendar"="\F0\9F\93\85";
+    "card-file-box"="\F0\9F\97\83";
     "chart-decreasing"="\F0\9F\93\89";
     "chart-increasing"="\F0\9F\93\88";
     "cloud"="\E2\98\81";