{"id":24651040,"url":"https://github.com/dinotools/monitoring-check_routeros","last_synced_at":"2025-04-13T17:51:37.381Z","repository":{"id":40473194,"uuid":"442665815","full_name":"DinoTools/monitoring-check_routeros","owner":"DinoTools","description":"Monitoring plugin for MikroTik devices for Icinga/Nagios/...","archived":false,"fork":false,"pushed_at":"2025-03-31T17:50:22.000Z","size":219,"stargazers_count":11,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-12T10:05:35.298Z","etag":null,"topics":["icinga-plugin","icinga2-plugin","mikrotik","monitoring-plugins","nagios-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DinoTools.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-29T05:06:53.000Z","updated_at":"2025-02-17T15:20:29.000Z","dependencies_parsed_at":"2023-02-10T06:15:23.362Z","dependency_job_id":"8229c23f-82c5-4d6e-bcc4-3a800d26b843","html_url":"https://github.com/DinoTools/monitoring-check_routeros","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DinoTools%2Fmonitoring-check_routeros","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DinoTools%2Fmonitoring-check_routeros/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DinoTools%2Fmonitoring-check_routeros/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DinoTools%2Fmonitoring-check_routeros/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DinoTools","download_url":"https://codeload.github.com/DinoTools/monitoring-check_routeros/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248758302,"owners_count":21156957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["icinga-plugin","icinga2-plugin","mikrotik","monitoring-plugins","nagios-plugin"],"created_at":"2025-01-25T18:49:56.560Z","updated_at":"2025-04-13T17:51:37.357Z","avatar_url":"https://github.com/DinoTools.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"check_routeros - Monitoring MikroTik devices\n============================================\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/dinotools/monitoring-check_routeros/issues\"\u003e\n    \u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/dinotools/monitoring-check_routeros\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/dinotools/monitoring-check_routeros/network\"\u003e\n    \u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/dinotools/monitoring-check_routeros\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/dinotools/monitoring-check_routeros/stargazers\"\u003e\n    \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/dinotools/monitoring-check_routeros\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/DinoTools/monitoring-check_routeros/blob/main/LICENSE.md\"\u003e\n    \u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/dinotools/monitoring-check_routeros\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://dinotools.github.io/monitoring-check_routeros\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://github.com/DinoTools/monitoring-check_routeros/actions/workflows/docs.yml/badge.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://exchange.icinga.com/dinotools/check_routeros\"\u003e\n    \u003cimg alt=\"Icinga Exchange\" src=\"https://img.shields.io/badge/Icinga-Exchange-success\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/routeros-check/\"\u003e\n    \u003cimg alt=\"PyPI - Downloads\" src=\"https://img.shields.io/pypi/dm/routeros-check\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/routeros-check/\"\u003e\n    \u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/routeros-check\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/routeros-check/\"\u003e\n    \u003cimg alt=\"PyPI - Format\" src=\"https://img.shields.io/pypi/format/routeros-check\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/routeros-check/\"\u003e\n    \u003cimg alt=\"PyPI - Status\" src=\"https://img.shields.io/pypi/status/routeros-check\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nThis is a monitoring plugin for [Icinga](https://icinga.com/), [Nagios](https://www.nagios.org/) and other compatible monitoring solutions to check [MikroTik](https://mikrotik.com/) devices running RouterOS.\nIt uses the API to fetch the required information.\n\nRequirements\n------------\n\n- [Python](https://www.python.org/) \u003e= 3.8 (Some checks might still run with older Python 3)\n- Python Packages\n    - [Click](https://pypi.org/project/click/)\n    - [librouteros](https://pypi.org/project/librouteros/)\n    - [nagiosplugin](https://pypi.org/project/nagiosplugin/)\n\nInstallation\n------------\n\n### PIP\n\nIf you want to use pip we recommend to use as virtualenv to install the dependencies.\n\n```shell\npip install -r requirements.txt\n```\n\nCopy the script ```check_routeros.py``` and the directory ```routeros_check``` into your plugin directory.\n\n### Debian/Ubuntu\n\nInstall the required packages\n\n```shell\nsudo apt-get install python3 python3-click python3-librouteros python3-nagiosplugin\n```\n\nCopy the script ```check_routeros.py``` and the directory ```routeros_check``` into your plugin directory.\n\n### From PyPI\n\nInstall the package from PyPI.\n\n```shell\npip install routeros-check\n```\n\nYou should be able to run ```check_routeros``` after the package installation has been finished successfully.\n\n\u003e **Note**\n\u003e You have to update the command in the icinga CheckCommand example config.\n\nUsage\n-----\n\nTo get the latest help just run the following command.\n\n```shell\n./check_routeros.py --help\n```\n\nTo get help for a subcommand just extend the previous command with the subcommand.\nIn the example below you will see how to get help for the ```tool.ping``` subcommand.\n\n```shell\n./check_routeros.py tool.ping --help\n```\n\nSubcommands/Checks\n------------------\n\nAll commands require at least `api` and `read` permissions.\nThe permissions documented in the table are additional permissions.\n\n| Subcommand             | Permissions | RouterOS | Description                                              |\n|------------------------|-------------|----------|----------------------------------------------------------|\n| interface              | -           | 6, 7     | Check interfaces                                         |\n| interface.gre          | -           | 6        | Check GRE interfaces/tunnels                             |\n| interface.vrrp         | -           | 6        | Check the state of an VRRP interface                     |\n| routing.bgp.peers      | -           | 6        | Check if connection to BGP peers is established          |\n| routing.ospf.neighbors | -           | 6        | Check if ospf neigbhors are reachable                    |\n| system.clock           | -           | 6, 7     | Check the time from RouterOS against local time          |\n| system.cpu             | -           | 6, 7     | Check the cpu load                                       |\n| system.fan             | -           | 6, 7     | Check the fans                                           |\n| system.memory          | -           | 6, 7     | Check system memory                                      |\n| system.ntp.client      | -           | 6, 7     | Check the ntp client, offset and stratum                 |\n| system.license         | -           | 6, 7     | Check the license level and deadline and renewal date    |\n| system.power           | -           | 6, 7     | Check the overall power consumption if available         |\n| system.psu             | -           | 6, 7     | Check the current, voltage and state of the power supply |\n| system.temperature     | -           | 6, 7     | Check the cpu, system, board and more temperatures.      |\n| system.update          | -           | 6, 7     | Check for updates                                        |\n| system.uptime          | -           | 6, 7     | Check the uptime                                         |\n| tool.ping              | test        | 6, 7     | Run the ping command on the device                       |\n\nTo get more information about the available subcommands/checks have a look at the [check_routeros Command Reference](https://dinotools.github.io/monitoring-check_routeros/cli/)\n\nResources\n---------\n\n- Git-Repository: https://github.com/DinoTools/monitoring-check_routeros\n- Issues: https://github.com/DinoTools/monitoring-check_routeros/issues\n- Documentation: https://dinotools.github.io/monitoring-check_routeros\n\nLicense\n-------\n\nGPLv3+\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdinotools%2Fmonitoring-check_routeros","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdinotools%2Fmonitoring-check_routeros","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdinotools%2Fmonitoring-check_routeros/lists"}