vstats/scripts/debug-data

vStats Debug Data Generator

生成调试数据用于测试 vStats 仪表板。支持新的多粒度聚合协议。

功能

1. 历史数据生成 - 生成多粒度聚合历史数据（5sec/2min/15min/hourly/daily）
2. 实时 Agent 模拟 - 启动多个模拟 Agent 实时向 Server 汇报数据

新协议特性

• 多粒度聚合: 发送预聚合的 bucket 数据，模拟真实 agent 行为
• 5种时间粒度: 5sec, 2min, 15min, hourly, daily
• Ping 聚合: 每个目标的延迟统计（sum/max/count/ok/fail）
• 实时 + 聚合: 同时发送实时指标和定期聚合数据

快速开始

# 确保 vStats server 正在运行
cd scripts/debug-data

# 运行（生成历史数据 + 启动实时 agents）
# 会提示输入 admin token（隐藏输入）
./run.sh

# 仅生成 2 小时历史数据
./run.sh history

# 仅运行实时 agents
./run.sh realtime

# 清理所有调试服务器
./run.sh cleanup

配置选项

通过环境变量配置：

# Server URL（默认 http://localhost:3001）
export VSTATS_SERVER_URL=http://localhost:3001

# 模拟服务器数量（默认 100）
export VSTATS_SERVER_COUNT=100

# 历史数据时长（默认 2 小时）
export VSTATS_HISTORY_HOURS=2

# 实时汇报间隔（默认 3 秒）
export VSTATS_INTERVAL=3

# 聚合数据同步间隔（默认 60 秒）
export VSTATS_AGG_INTERVAL=60

或直接使用命令行参数：

# 通过命令行传递 token（不推荐，会留在历史记录中）
go run main.go \
    --server http://localhost:3001 \
    --count 100 \
    --hours 2 \
    --interval 3 \
    --agg-interval 60 \
    --token "your-admin-token" \
    --mode both

# 不传 token 会提示安全输入
go run main.go --count 50 --mode realtime

参数说明

参数	默认值	说明
--server	http://localhost:3001	vStats Server 地址
--count	100	模拟服务器数量
--hours	2	生成历史数据的小时数
--interval	3	实时汇报间隔（秒）
--agg-interval	60	聚合数据同步间隔（秒）
--token	(提示输入)	Admin Token（用于 API 认证）
--mode	both	运行模式：history/realtime/both
--cleanup	false	仅清理调试服务器后退出

工作原理

历史数据模式

1. 通过 HTTP API (/api/servers) 注册调试服务器
2. 通过 WebSocket 连接到 /ws/agent 端点并认证
3. 发送 aggregated_metrics 消息，包含所有粒度的历史 bucket 数据
4. 数据直接入库到 metrics_*_agg 和 ping_*_agg 表

实时模式

1. 每 --interval 秒发送 metrics 消息（实时指标）
2. 每 --agg-interval 秒发送 aggregated_metrics 消息（聚合数据）
3. 模拟真实 agent 的双轨数据上报行为

清理调试数据

# 自动清理所有 Debug-Server-* 服务器
./run.sh cleanup

# 或在仪表板中手动删除

注意事项

• 确保 vStats Server 正在运行（v3.2.13+，支持新协议）
• 需要 Admin Token（从仪表板设置页面获取）
• 首次运行时会下载 Go 依赖
• 实时模式下按 Ctrl+C 停止所有 agents
• 每次运行会自动清理之前创建的调试服务器