mirror of
https://github.com/zsai001/vstats.git
synced 2026-09-08 18:27:39 +08:00
117 lines
3.2 KiB
Markdown
117 lines
3.2 KiB
Markdown
# 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）
|
||
- **实时 + 聚合**: 同时发送实时指标和定期聚合数据
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 确保 vStats server 正在运行
|
||
cd scripts/debug-data
|
||
|
||
# 运行（生成历史数据 + 启动实时 agents）
|
||
# 会提示输入 admin token（隐藏输入）
|
||
./run.sh
|
||
|
||
# 仅生成 2 小时历史数据
|
||
./run.sh history
|
||
|
||
# 仅运行实时 agents
|
||
./run.sh realtime
|
||
|
||
# 清理所有调试服务器
|
||
./run.sh cleanup
|
||
```
|
||
|
||
## 配置选项
|
||
|
||
通过环境变量配置：
|
||
|
||
```bash
|
||
# 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
|
||
```
|
||
|
||
或直接使用命令行参数：
|
||
|
||
```bash
|
||
# 通过命令行传递 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 的双轨数据上报行为
|
||
|
||
## 清理调试数据
|
||
|
||
```bash
|
||
# 自动清理所有 Debug-Server-* 服务器
|
||
./run.sh cleanup
|
||
|
||
# 或在仪表板中手动删除
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 确保 vStats Server 正在运行（v3.2.13+，支持新协议）
|
||
- 需要 Admin Token（从仪表板设置页面获取）
|
||
- 首次运行时会下载 Go 依赖
|
||
- 实时模式下按 `Ctrl+C` 停止所有 agents
|
||
- 每次运行会自动清理之前创建的调试服务器
|