aboutsummaryrefslogtreecommitdiffstats
path: root/doc/netwatch-syslog.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/netwatch-syslog.md')
-rw-r--r--doc/netwatch-syslog.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/doc/netwatch-syslog.md b/doc/netwatch-syslog.md
new file mode 100644
index 0000000..9a28bb9
--- /dev/null
+++ b/doc/netwatch-syslog.md
@@ -0,0 +1,34 @@
+Manage remote logging
+=====================
+
+[◀ Go back to main README](../README.md)
+
+Description
+-----------
+
+RouterOS supports sending log messages via network to a remote syslog server.
+If the server is not available no log messages (with potentially sensitive
+information) should be sent. This script disables remote logging by
+availability.
+
+Requirements and installation
+-----------------------------
+
+Let's assume there is a remote log action and associated logging rule:
+
+ / system logging action set remote=10.0.0.1 [ find where name="remote" ];
+ / system logging add action=remote topics=info;
+
+Just install the script:
+
+ $ScriptInstallUpdate netwatch-syslog;
+
+... and create a netwatch matching the IP address from logging action above:
+
+ / tool netwatch add down-script=netwatch-syslog host=10.0.0.1 up-script=netwatch-syslog;
+
+All logging rules are disabled when host is down.
+
+---
+[◀ Go back to main README](../README.md)
+[▲ Go back to top](#top)