🚀 蜂巢指南
本指南详细介绍了蜂巢（Honeycomb）工具的使用方法，涵盖查询规范、工具使用说明、开发指南、环境需求、示例查询等内容，助您高效使用该工具进行数据分析。
🚀 快速开始
运行查询工具
pnpm run query
✨ 主要特性
查询规格说明
运算符
- COUNT：统计总数
- CONCURRENCY：统计并发数
- COUNT_DISTINCT：统计不同值的数量
- HEATMAP：绘制热力图
- SUM：求和
- AVG：计算平均值
- MAX：找出最大值
- MIN：找出最小值
- P001, P01, P05, P10, P25, P50, P75, P90, P95, P99, P999：计算指定百分位数
- RATE_AVG, RATE_SUM, RATE_MAX：统计速率平均值、总和及最大值
过滤条件
- 支持的操作符：=, !=, >, >=, <, <=, starts-with, does-not-start-with, exists, does-not-exist, contains, does-not-contain, in, not-in
- 示例：
{"column": "error", "op": "=", "value": true}
过滤组合
- 支持的逻辑：AND 或 OR（默认为 AND）
分组字段
- 示例：
["service.name", "http.status_code"]
排序规则
- 必须引用分组字段或计算字段
- 热力图操作不支持排序
- 示例：
{"op": "COUNT", "order": "descending"}
时间范围
- 支持相对时间（以秒为单位）和绝对时间戳
- 示例：
--time_range=3600 # 表示过去一小时的数据
--start_time=1625937600 --end_time=1625940000 # 表示特定时间段
Having过滤
- 示例：
{"calculate_op": "COUNT", "op": ">", "value": 100}
查询工具输出结果
pnpm run query -- --help
📦 安装指南
安装依赖
pnpm install
编译构建
pnpm run build
🔧 技术细节
环境需求
- Node.js 版本：16+
- Honeycomb API 权限：
- 查询权限用于数据分析
- 读取权限用于获取 SLO 和触发器信息
- 环境级权限用于数据集操作
💻 使用示例
基础查询
pnpm run query -- --table user_activity --where "user_id=123" --fields id, timestamp, action
高级查询
pnpm run query -- --file ./queries/weekly_report.sql
📄 许可证
- MIT License：请参考项目 LICENSE 文件。
以上为 Honeycomb 工具的详细指南，涵盖查询规范、工具使用及开发要求等内容。如需进一步帮助，请参阅相关文档或联系技术支持团队。