https://github.com/dinotools/routeros-log-exporter
Export Logs from MikroTik RouterOS devices
https://github.com/dinotools/routeros-log-exporter
logging mikrotik routeros
Last synced: 6 months ago
JSON representation
Export Logs from MikroTik RouterOS devices
- Host: GitHub
- URL: https://github.com/dinotools/routeros-log-exporter
- Owner: DinoTools
- License: gpl-3.0
- Created: 2024-09-16T06:31:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-31T17:50:42.000Z (6 months ago)
- Last Synced: 2025-04-10T20:14:13.283Z (6 months ago)
- Topics: logging, mikrotik, routeros
- Language: Python
- Homepage: https://dinotools.github.io/routeros-log-exporter/
- Size: 66.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
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](https://mikrotik.com/) RouterOS devices via API and connects to the log stream to export the logs in realtime.
Requirements
------------
- [Python](https://www.python.org/) >= 3.8 (It might still run with older versions of Python 3)
- Python Packages
- [Click](https://pypi.org/project/click/)
- [librouteros](https://pypi.org/project/librouteros/)
- [pyyaml](https://pypi.org/project/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.
```shell
pip install -r requirements.txt
```
### Debian/Ubuntu
Install the required packages
```shell
sudo apt-get install python3 python3-click python3-librouteros
```
### From PyPI
Install the package from PyPI.
```shell
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+