chhaley/omada_exporter

TP-Link Omada Controller SDN Prometheus Exporter 镜像

镜像概述

该Docker镜像提供了一个Prometheus Exporter，专门用于从TP-Link Omada Controller SDN环境中收集网络设备指标。通过与Prometheus集成，可实现对Omada控制器管理的网络设备（如接入点、交换机、网关等）的性能监控、状态追踪和数据可视化。

核心功能与特性

• 多类型指标收集：支持收集Omada控制器管理的网络设备状态（在线/离线）、接口流量（发送/接收速率）、客户端连接数、信号强度等关键指标。
• Prometheus兼容：遵循Prometheus exposition格式，可直接被Prometheus抓取并集成到Grafana等可视化平台。
• 配置灵活：通过环境变量配置Omada控制器连接信息、指标采集频率、监听端口等参数。
• 轻量级设计：基于精简基础镜像构建，资源占用低，部署便捷。

使用场景

• 企业网络监控：实时监控Omada SDN环境中的网络设备运行状态，及时发现故障。
• 性能分析：通过历史指标数据，分析网络流量趋势、设备负载情况，优化网络资源分配。
• 告警集成：结合Prometheus Alertmanager，配置设备离线、流量异常等告警规则。
• SDN环境可视化：与Grafana配合，构建网络拓扑、流量监控仪表盘。

使用方法

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name omada-exporter \
  -p 9273:9273 \
  -e OMADA_URL="http://omada-controller:8088" \
  -e OMADA_USERNAME="admin" \
  -e OMADA_PASSWORD="your-password" \
  -e SCRAPE_INTERVAL="60" \
  docker.xuanyuan.run/tplink/omada-exporter:latest

Docker Compose 部署示例

yaml
version: '3'
services:
  omada-exporter:
    image: docker.xuanyuan.run/tplink/omada-exporter:latest
    container_name: omada-exporter
    ports:
      - "9273:9273"
    environment:
      - OMADA_URL=http://omada-controller:8088
      - OMADA_USERNAME=admin
      - OMADA_PASSWORD=your-password
      - SCRAPE_INTERVAL=60
      - TIMEOUT=15
    restart: unless-stopped

Prometheus 配置

在Prometheus配置文件中添加以下scrape_configs：

yaml
scrape_configs:
  - job_name: 'omada'
    static_configs:
      - targets: ['omada-exporter:9273']  # 替换为Exporter实际地址
    scrape_interval: 30s

指标示例

Exporter暴露的部分关键指标：

• omada_device_status{device_type="ap",mac="aa:bb:cc:dd:ee:ff"}：设备状态（1=在线，0=离线）
• omada_ap_clients{mac="aa:bb:cc:dd:ee:ff"}：接入点当前连接客户端数
• omada_interface_tx_bytes{device_type="switch",port="1",mac="aa:bb:cc:dd:ee:ff"}：接口发送字节数
• omada_gateway_cpu_usage{mac="aa:bb:cc:dd:ee:ff"}：网关CPU使用率（百分比）