Files
NetAlertX/server/plugins/mikrotik_scan
Jokob @NetAlertX 9e38cfd8b4 Add website monitoring plugin and update workflows configuration
- Introduced a new plugin for monitoring website health, including functionality to check URLs and log results.
- Created README and configuration files for the workflows plugin, detailing its purpose and settings.
- Updated import paths in various test files to reflect the new directory structure.
- Ensured compatibility of test cases with the updated plugin architecture.
2026-08-10 02:32:49 +00:00
..

Overview

The plugin uses the MikroTik API to discover devices by retrieving DHCP lease information.

Prerequisites

  • API must be enabled in API > Interfaces on your MikroTik router.
  • A user must be created in System > Users on your MikroTik router. Read-only permissions are recommended for security.

Usage

It is recommended to use this plugin in scheduled mode for continuous device discovery and monitoring.

In the Settings section of NetAlertX, provide the following parameters:

  • MTSCAN_MT_HOST: IP address of the MikroTik router (default: 192.168.88.1).
  • MTSCAN_MT_PORT: Port for the MikroTik API (default: 8728).
  • MTSCAN_MT_USER: Username for the MikroTik router.
  • MTSCAN_MT_PASS: Password for the MikroTik router.

Device name resolution order

To assign a meaningful device name, the plugin resolves it in the following order:

  • Comment: The comment field in the MikroTik router's DHCP lease configuration. This is useful for naming static leases of known devies.
  • Hostname: The hostname provided by the device during DHCP negotiation.
  • "(unknown)": as the fallback name, allowing other plugins to resolve the device name later.

Other info