Honeycomb

🚀 蜂巢指南

本指南详细介绍了蜂巢（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 工具的详细指南，涵盖查询规范、工具使用及开发要求等内容。如需进一步帮助，请参阅相关文档或联系技术支持团队。