蜂巢指南

查询规范

运行查询工具

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