From 6bce0a4b6a3d1ee48a1e4b4f40652ae490fb288c Mon Sep 17 00:00:00 2001
From: Christian Hesse <mail@eworm.de>
Date: Wed, 15 Jul 2020 12:22:55 +0200
Subject: add 'log-forward', drop 'early-errors'

---
 doc/early-errors.md | 39 ++++-----------------------------------
 doc/log-forward.md  | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 35 deletions(-)
 create mode 100644 doc/log-forward.md

(limited to 'doc')

diff --git a/doc/early-errors.md b/doc/early-errors.md
index f6209b7..a16da7d 100644
--- a/doc/early-errors.md
+++ b/doc/early-errors.md
@@ -3,40 +3,9 @@ Send notification with early errors
 
 [◀ Go back to main README](../README.md)
 
-Description
------------
+This script has been replace. Please migrate to
+[Forward log messages via notification](log-forward.md).
 
-RouterOS supports sending log messages via e-mail or to a syslog server.
-However this does not work early after boot if network connectivity is not
-yet established. For example log messages about reboot without proper
-shutdown may be missed:
-
-> router rebooted without proper shutdown, probably power outage
-
-The script collects log messages with severity `error` and sends a
-notification.
-
-Requirements and installation
------------------------------
-
-Just install this script and [global-wait](global-wait.md):
-
-    $ScriptInstallUpdate early-errors,global-wait;
-
-... and add a scheduler:
-
-    / system scheduler add name=early-erros on-event="/ system script { run global-wait; run early-errors; }" start-time=startup;
-
-Configuration
--------------
-
-The notifications just require notification settings for e-mail and telegram.
-
-See also
---------
-
-* [Wait for configuration und functions](global-wait.md)
-
----
-[◀ Go back to main README](../README.md)  
+--- 
+[◀ Go back to main README](../README.md)
 [▲ Go back to top](#top)
diff --git a/doc/log-forward.md b/doc/log-forward.md
new file mode 100644
index 0000000..bc7213a
--- /dev/null
+++ b/doc/log-forward.md
@@ -0,0 +1,42 @@
+Forward log messages via notification
+=====================================
+
+[◀ Go back to main README](../README.md)
+
+Description
+-----------
+
+RouterOS supports sending log messages via e-mail or to a syslog server.
+This has some limitation, however:
+
+* does not work early after boot if network connectivity is not
+  yet established
+* lots of messages generate a flood of mails
+* Telegram is not supported
+
+The script is intended to be run periodically. It collects log messages
+and forwards them via notification.
+
+Requirements and installation
+-----------------------------
+
+Just install the script:
+
+    $ScriptInstallUpdate log-forward;
+
+... and add a scheduler:
+
+    / system scheduler add interval=1m name=log-forward on-event="/ system script run log-forward;" start-time=startup;
+
+Configuration
+-------------
+
+The configuration goes to `global-config-overlay`, there is just one parameters:
+
+* `LogForwardFilter`: define topics *not* to be forwarded
+
+Also notification settings are required for e-mail and telegram.
+
+---
+[◀ Go back to main README](../README.md)  
+[▲ Go back to top](#top)
-- 
cgit v1.2.3-70-g09d2