Honeycomb

🚀 蜂巢指南

本指南詳細介紹了蜂巢工具的使用方法，涵蓋查詢規範、工具說明、開發指南、環境需求、示例查詢等內容，幫助你更好地使用該工具進行數據分析等操作。

🚀 快速開始

運行查詢工具

使用以下命令運行查詢工具：

pnpm run query

📦 安裝指南

安裝依賴

pnpm install

編譯構建

pnpm run build

💻 使用示例

基礎用法

pnpm run query -- --table user_activity --where "user_id=123" --fields id, timestamp, action

高級用法

pnpm run query -- --file ./queries/weekly_report.sql

📚 詳細文檔

查詢規格說明

運算符

• 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

🔧 技術細節

環境需求

• Node.js 版本：16+
• Honeycomb API 權限：
  • 查詢權限用於數據分析
  • 讀取權限用於獲取 SLO 和觸發器信息
  • 環境級權限用於數據集操作

📄 許可證

• MIT License：請參考項目 LICENSE 文件。

以上為 Honeycomb 工具的詳細指南，涵蓋查詢規範、工具使用及開發要求等內容。如需進一步幫助，請參閱相關文檔或聯繫技術支持團隊。