routeros-scripts/doc/log-forward.md
Christian Hesse 34ed387343 use arrows with emoji representation
We had...

  ◀ Go back to main README
  ▲ Go back to top

... and switch to...

  ⬅️ Go back to main README
  ⬆️ Go back to top
2023-01-11 12:28:31 +01:00

1.7 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