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 # 過去1時間のデータを表します
  --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 ファイルを参照してください。

以上がハニカムツールの詳細なガイドです。さらなる支援が必要な場合は、関連ドキュメントを参照するか、技術サポートチームにお問い合わせください。