Crash_Override/routeros-scripts
1
0
Fork 0
mirror of https://github.com/eworm-de/routeros-scripts synced 2024-05-14 08:04:19 +00:00
Code Issues Packages Projects Releases Wiki Activity
routeros-scripts/doc/log-forward.md
Michael Gisbers 8375673d93 global-functions: implement notifications via Matrix 
Matrix is an open network for secure, decentralized communication - and
it has a web api.

A warning on message type: Using 'm.notice' breaks rendering on Element
for Android (no fixed width font) and does not pop up desktop
notification. Thus we use 'm.text'. Should be safe as we do not send the
messages in response to other messages.

https://matrix.org/
2021-06-08 21:07:25 +02:00

1.3 KiB
Raw Blame History

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

  • LogForwardFilter: define topics not to be forwarded
  • LogForwardFilterMessage: define message text not to be forwarded

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

◀ Go back to main README
▲ Go back to top