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.6
• Python Packages
  • Click
  • librouteros
  • nagiosplugin

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.

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.

To get more information about the available subcommands/checks haf 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+