MikroTik RouterOS log exporter

[!WARNING] Proof of Concept

This project is in an very early stage of development. Don't use it in production.

The Exporter connects to MikroTik RouterOS devices via API and connects to the log stream to export the logs in realtime.

Requirements

• Python >= 3.8 (It might still run with older versions of Python 3)
• Python Packages
  • Click
  • librouteros
  • pyyaml

Installation

Docker

docker pull ghcr.io/dinotools/routeros-log-exporter:main
docker run --rm -v ./config.yaml:/etc/routeros_log_exporter/config.yaml:ro ghcr.io/dinotools/routeros-log-exporter:main

PIP

If you want to use pip we recommend to use as virtualenv to install the dependencies.

pip install -r requirements.txt

Debian/Ubuntu

Install the required packages

sudo apt-get install python3 python3-click python3-librouteros

From PyPI

Install the package from PyPI.

pip install routeros-log-exporter

Usage

python3 -m routeros_log_exporter --config config.yaml -vv

Resources

• Git-Repository: https://github.com/DinoTools/routeros-log-exporter
• Issues: https://github.com/DinoTools/routeros-log-exporter/issues
• Documentation: https://dinotools.github.io/routeros-log-exporter

License

GPLv3+