check_routeros - Monitoring MikroTik devices
This is a monitoring plugin for Icinga, Nagios and other compatible monitoring solutions to check MikroTik devices running RouterOS. It uses the API to fetch the required information.
Requirements
- Python >= 3.8 (Some checks might still run with older Python 3)
- Python Packages
Installation
PIP
If you want to use pip we recommend to use as virtualenv to install the dependencies.
pip install -r requirements.txt
Copy the script check_routeros.py and the directory routeros_check into your plugin directory.
Debian/Ubuntu
Install the required packages
sudo apt-get install python3 python3-click python3-librouteros python3-nagiosplugin
Copy the script check_routeros.py and the directory routeros_check into your plugin directory.
From PyPI
Install the package from PyPI.
pip install routeros-check
You should be able to run check_routeros after the package installation has been finished successfully.
Note You have to update the command in the icinga CheckCommand example config.
Usage
To get the latest help just run the following command.
./check_routeros.py --help
To get help for a subcommand just extend the previous command with the subcommand.
In the example below you will see how to get help for the tool.ping subcommand.
./check_routeros.py tool.ping --help
Subcommands/Checks
All commands require at least api and read permissions.
The permissions documented in the table are additional permissions.
| Subcommand | Permissions | RouterOS | Description |
|---|---|---|---|
| interface | - | 6, 7 | Check interfaces |
| interface.gre | - | 6 | Check GRE interfaces/tunnels |
| interface.vrrp | - | 6 | Check the state of an VRRP interface |
| routing.bgp.peers | - | 6 | Check if connection to BGP peers is established |
| routing.ospf.neighbors | - | 6 | Check if ospf neigbhors are reachable |
| system.clock | - | 6, 7 | Check the time from RouterOS against local time |
| system.cpu | - | 6, 7 | Check the cpu load |
| system.fan | - | 6, 7 | Check the fans |
| system.memory | - | 6, 7 | Check system memory |
| system.ntp.client | - | 6, 7 | Check the ntp client, offset and stratum |
| system.license | - | 6, 7 | Check the license level and deadline and renewal date |
| system.power | - | 6, 7 | Check the overall power consumption if available |
| system.psu | - | 6, 7 | Check the current, voltage and state of the power supply |
| system.temperature | - | 6, 7 | Check the cpu, system, board and more temperatures. |
| system.update | - | 6, 7 | Check for updates |
| system.uptime | - | 6, 7 | Check the uptime |
| tool.ping | test | 6, 7 | Run the ping command on the device |
To get more information about the available subcommands/checks have a look at the check_routeros Command Reference
Resources
- Git-Repository: https://github.com/DinoTools/monitoring-check_routeros
- Issues: https://github.com/DinoTools/monitoring-check_routeros/issues
- Documentation: https://dinotools.github.io/monitoring-check_routeros
License
GPLv3+
1 maintainer
Metadata
1 maintainer
Release files for routeros-check 0.11.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| routeros_check-0.11.1.tar.gz | 100.7 kB | Without provenance | Details for routeros_check-0.11.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| routeros_check-0.11.1-py3-none-any.whl | Python 3 | none | any | Details for routeros_check-0.11.1-py3-none-any.whl |
Total release size: 169.3 kB
Release files / routeros_check-0.11.1.tar.gz
| Download URL | routeros_check-0.11.1.tar.gz |
|---|---|
| Size | 100.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
76e1dafdf0a7310e6424d7bfd24ff3e710eace463f77760e9d74c10bb649de8a
|
|
BLAKE2b-256 checksum How to use checksums |
1f3c3b35dd0be2687086fdaecbca9153792b1e1646afcdff5c569a085c638c75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / routeros_check-0.11.1-py3-none-any.whl
| Download URL | routeros_check-0.11.1-py3-none-any.whl |
|---|---|
| Size | 68.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
161d11cd0ecd150f6af4a4f13e0a048df594c03f09203e5db790f945b68d7ab7
|
|
BLAKE2b-256 checksum How to use checksums |
24d4eb4e66ad5db968a1bd2abeb0640d117ff2b3857953918aa50d0f5a5234d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Security for routeros-check 0.11.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
