synackray/cloudgenix-wan-management

CloudGenix WAN带宽管理工具

CloudGenix要求分支内的所有WAN电路需手动设置带宽。本工具利用CloudGenix收集的PCM数据计算WAN电路容量，并基于指定间隔（默认4小时）自动为每个电路设置带宽值。

!https://raw.githubusercontent.com/synackray/cloudgenix-wan-management/master/docs/media/screenshot1.png

核心功能与特性

• 自动带宽计算：基于PCM数据计算WAN电路实际容量
• 定时调整：按指定时间间隔（默认4小时）自动更新带宽设置
• 异常值过滤：通过设置百分位数（默认95%）移除数据点异常值
• 带宽上限控制：可配置最大带宽容量限制
• 站点过滤：支持按标签筛选特定分支站点
• 电路排除：可通过标签排除不需要自动调整的电路

使用场景

适用于需要自动管理WAN电路带宽的CloudGenix环境，特别适合具有多个分支站点、需要定期调整带宽以优化性能的企业网络。

使用方法

直接运行脚本

$ python3 run.py -h
usage: run.py [-h] -c CLOUDGENIX_TOKEN [-H 4] [-m 100] [-p 95] [-t Offices] [-v]

可选参数:
  -h, --help            显示此帮助消息并退出
  -c CLOUDGENIX_TOKEN, --cloudgenix-token CLOUDGENIX_TOKEN
                        用于CloudGenix请求认证的API令牌。
  -H 4, --hours 4       从当前时间回溯计算指标的小时数。(默认: 4)
  -m 100, --max 100     允许的最大带宽容量（Mbps）。设置带宽上限。
  -p 95, --percentile 95
                        通过设置X百分位数移除数据点异常值。(默认: 95)
  -t Offices, --tag Offices
                        筛选包含指定标签的分支站点。
  -v, --verbose         启用详细输出。仅用于调试目的。

Docker容器运行

最新容器镜像已在Docker Hub构建，可直接下载使用。

$ docker run -e CGX_TOKEN=$X_AUTH_TOKEN -e MAX=100 -e VERBOSE=True synackray/cloudgenix-wan-management

命令行版本的参数可通过环境变量设置，具体说明如下：

排除站点电路

可通过为站点电路应用标签auto_bw:false来排除特定电路的自动调整。脚本将忽略所有应用此标签的电路。