routeros-scripts/doc/log-forward.md
Christian Hesse de61c14c60 log-forward: implement reverse logic to include messages...
... even if a filter matches to exclude them. Let's have an example:

:global LogForwardFilter "(debug|info)";
:global LogForwardInclude "account";

This will forward everything about topic *account* (login, logout,
failed login, ...) - even with topic *info*.
2021-06-09 14:42:43 +02:00

1.5 KiB

Forward log messages via notification

◀ Go back to main README

🛈 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.

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