routeros-scripts/doc/log-forward.md
Christian Hesse 4f8a2bd8e2 doc/log-forward: update notification
---- ✂️ ----
⚠️ Log Forwarding

The log on MikroTik contains these 3 messages after 6d23:55:18 uptime.

 ● 13:24:02 script;error backup-cloud: Failed uploading backup for MikroTik to cloud!
 ● 13:24:17 system;info;account user admin logged in from 192.168.88.177 via ssh
 ● 13:24:57 system;info;account user admin logged out from 192.168.88.177 via ssh
---- ✂️ ----
2022-10-20 11:28:09 +02:00

1.6 KiB
Raw Blame History

Forward log messages via notification

◀ Go back to main README

Info: This script can not be used on its own but requires the base installation. See main README for details.

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
  • Matrix and Telegram are not supported

The script is intended to be run periodically. It collects log messages and forwards them via notification.

Sample notification

log-forward 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, these are the parameters:

  • LogForwardFilter: define topics not to be forwarded
  • LogForwardFilterMessage: define message text not to be forwarded
  • LogForwardInclude: define topics to be forwarded (even if filter matches)
  • LogForwardIncludeMessage: define message text to be forwarded (even if filter matches)

Also notification settings are required for e-mail, matrix and/or telegram.


◀ Go back to main README
▲ Go back to top