ogi4i/mikrotik-exporter

prometheus-mikrotik

镜像概述

prometheus-mikrotik是一个Prometheus导出器，用于收集Mikrotik设备的监控指标。支持单设备和多设备监控，单设备可通过命令行配置，多设备需使用配置文件。需在Mikrotik设备上创建具有API和只读权限的用户以实现指标采集。目前可收集接口和系统资源指标，其他指标可通过API扩展支持。

核心功能与特性

• 多设备监控：支持单设备命令行配置和多设备配置文件管理
• 丰富指标采集：默认收集接口流量、系统资源，可扩展收集BGP、DHCP、WLAN、IPSec等指标
• 动态设备发现：支持通过DNS SRV记录自动发现Mikrotik设备
• 灵活配置：可全局或按设备配置采集特性，支持TLS连接及超时设置
• 环境变量支持：支持通过环境变量设置用户名和密码，提高安全性

使用场景

适用于需要监控Mikrotik路由器/交换机的网络环境，如企业网络、数据中心、ISP网络等场景，可与Prometheus+Grafana结合实现设备性能可视化和告警。

使用方法与配置说明

Mikrotik设备配置

需在Mikrotik设备上创建具有API访问和只读权限的用户组及用户：

1. 创建用户组（基础权限）：

bash
/user group add name=prometheus policy=api,read,winbox

2. 若需监控LTE指标，需添加test权限：

bash
/user group add name=prometheus policy=api,read,winbox,test

3. 创建用户：

bash
/user add name=prometheus group=prometheus password=changeme

单设备运行

通过命令行参数直接配置单设备监控：

bash
./mikrotik-exporter -address 10.10.0.1 -device my_router -password changeme -user prometheus

参数说明：

• -address：Mikrotik设备IP地址
• -device：设备在指标中的标签名称
• -user：Mikrotik API用户名（可通过MIKROTIK_USER环境变量设置）
• -password：Mikrotik API密码（可通过MIKROTIK_PASSWORD环境变量设置）

使用环境变量示例：

bash
MIKROTIK_USER=prometheus
MIKROTIK_PASSWORD=changeme
./mikrotik-exporter -address 10.10.0.1 -device my_router

多设备配置文件方式

通过YAML配置文件管理多设备监控，使用-config-file参数指定配置文件路径：

bash
./mikrotik-exporter -config-file config.yml

配置文件示例

yaml
devices:
  - name: my_router
    address: 10.10.0.1
    username: prometheus
    password: changeme
    features:
      bgp: true
      dhcp: true
      dhcp_leases: true
      ip_pools: true
      wlan: true
      wlan_stations: true
      bridge_hosts: true
  - name: my_second_router
    address: 10.10.0.2
    port: 8999
    username: prometheus2
    password: password_to_second_router
    client:
      enable_tls: true
      insecure_tls_skip_verify: true
  - name: routers_srv_dns
    dns_record:
      record: _mikrotik._udp.example.com
    username: prometheus
    password: password_to_all_dns_routers
  - name: routers_srv_custom_dns
    dns_record:
      record: _mikrotik2._udp.example.com
      server:
        address: 1.1.1.1
        port: 53
    username: prometheus
    password: password_to_all_dns_routers

client:
  dial_timeout: 1s

features:
  firmware: true
  routes: true
  ethernet: true
  ipsec: true
  ospf_neighbors: true
  conntrack: true

配置参数说明

• 全局配置：

  • client：客户端连接配置，如dial_timeout（连接超时时间）
  • features：全局启用的采集特性，如firmware（固件信息）、routes（路由表）等

• 设备配置：

  • name：设备名称（指标标签）
  • address：设备IP地址（与dns_record二选一）
  • port：API端口（默认8728）
  • username/password：设备API认证信息
  • features：设备级采集特性（覆盖全局配置）
  • client：设备级连接配置（覆盖全局配置）
  • dns_record：通过DNS SRV记录发现设备，包含record（SRV记录名）和server（DNS服务器配置）

Docker部署示例

Docker Run

bash
docker run -d \
  --name mikrotik-exporter \
  -p 9436:9436 \
  -v /path/to/config.yml:/app/config.yml \
  -e MIKROTIK_USER=prometheus \
  -e MIKROTIK_PASSWORD=changeme \
  ogi4i/mikrotik-exporter -config-file /app/config.yml

Docker Compose

yaml
version: '3'
services:
  mikrotik-exporter:
    image: ogi4i/mikrotik-exporter
    container_name: mikrotik-exporter
    ports:
      - "9436:9436"
    volumes:
      - ./config.yml:/app/config.yml
    environment:
      - MIKROTIK_USER=prometheus
      - MIKROTIK_PASSWORD=changeme
    command: -config-file /app/config.yml
    restart: unless-stopped

指标示例

mikrotik_interface_tx_byte{address="10.10.0.1",interface="ether2",name="my_router"} 1.4189902583e+10
mikrotik_interface_tx_byte{address="10.10.0.1",interface="ether3",name="my_router"} 2.263768666e+09
mikrotik_interface_tx_byte{address="10.10.0.1",interface="ether4",name="my_router"} 1.6572299e+08
mikrotik_interface_tx_byte{address="10.10.0.1",interface="ether5",name="my_router"} 1.66711315e+08
mikrotik_interface_tx_byte{address="10.10.0.1",interface="ether6",name="my_router"} 1.0026481337e+10