create-honeycomb-board

Honeycomb ボードを作成する

create_board MCP ツールを使用して、Honeycomb にボード（ダッシュボード）を構築します。 更新ツールは存在しないため、作成する前にしっかりと定義してください。

ボードを構築する際は、目的と対象となる期間について考えてください。いくつかの例を示します。

• サービス用のボード。これは特定の時点に依存しないもので、サービスの健全性、パフォーマンス、ビジネスメトリクスを確認するものです。このボードを構築する際に、問題の診断や調査を行わないでください。テキストパネルで意見を述べたり、グラフを要約したりしないでください。ボードは、誰がいつ見てもその時点でのサービスの健全性を表すものであるべきです。
• 機能用のボード。これは機能の利用動向と、ビジネスへの影響を確認するものです。このボードの対象期間は 7 日間で、インフラストラクチャのメトリクスやサービスの依存関係は含めません。
• 問題用のボード。これはインシデント中またはその後に作成されることがあります。対象期間はそのインシデントに固有のものとなります。調査内容や、何が起きているかについてのあなたの意見を含めます。ここでは、注目すべきパターンを示すのが適切です。

ワークフロー

SLO を収集する

get_slos を使用して、環境内の SLO を一覧表示します。関連する SLO は slo パネルとしてボードに配置します。

説明的なコンテキストを収集する

コードとドキュメントを（Read/Grep/Glob を使用して）確認し、サービスまたは機能を理解します。これを使用してテキストパネルを作成します。可能であれば GitHub やドキュメントへのリンクを記載します。

これはボードの目的によって大きく異なります。

アプリケーションの説明とコードへのリンク - サービスボードに最適です。

機能とは何か、そしてそれがビジネスにどのような影響を与えるか？ - 機能ボードに最適です。

問題とは何か、そしてその影響は何か？どのようなパターンが見られるか？ - 問題ボードに最適です。

候補クエリを構築する

Honeycomb のコンテキストを取得する: get_workspace_context を呼び出して、利用可能な環境を確認します。get_environment を使用してデータセットを探します — 各データセットは OTEL_SERVICE_NAME に対応します。

コードのコンテキスト: 言語と、カスタム属性（多くの場合 app. というプレフィックスが付きます）を確認します。カスタムフィールドは、内訳やビジネスメトリクスの有力な候補です。

カラムを発見する: find_columns または get_dataset_columns を使用します。非標準のカラムに特に注意してください — それらはアプリケーションに固有のものです。

クエリを探す: find_queries を使用して、これまでにどのようなクエリが実行されてきたかを確認します。get_triggers で何に対してアラートが設定されているかを確認します — それらは何が重要かを示しています。

期間: デフォルトでは 2 時間とします。トラフィックの少ないサービスでは 8〜24 時間を使用します。機能の利用状況のボードでは 7 日間を使用します。すべてのパネルで一貫させてください。

6〜12 個のグラフを目指してください。統計パネルはボーナスです — この上限には含まれません。

実行する前に、候補クエリを理由とともにユーザーに一覧表示してください。各種類について何を含めるか、どのように書くかについては ${CLAUDE_PLUGIN_ROOT}/skills/create-honeycomb-board/references/board-queries.md を参照してください。

クエリを実行して確認する

各候補クエリに対して run_query を使用します。各結果はクエリ実行 PK（QR-abc123 など）を返します — ボードを構築する際にこれをパネルの id として使用します。

エラーを修正します。興味深い結果を返さないクエリは除外します。

レイアウトを計画する

視覚的な流れと、ボードをどのように表現豊かにするかを考えます。ボードは 12 カラムのグリッドを使用します — 統計パネルは横に並べることができ、ヒートマップには全幅がふさわしく、内訳には高さを多めに取ると効果的です。サイズ設定の例については ${CLAUDE_PLUGIN_ROOT}/skills/create-honeycomb-board/references/board-layout.md を参照してください。

閲覧者がボードをインタラクティブに切り分けたい場合（ルート、リージョン、アカウント階層など）は、preset_filters を検討してください。

提案するボードをユーザーに必ず表示する — 例外なく、常に

各パネルについて、次を表示します。

• テキストパネル: ボードに表示されるMarkdown の内容全体を示します。ボードは作成後に更新できないため、ユーザーは作成前に正確な文言を確認する必要があります。
• SLO パネル: SLO の名前、目標値、現在の準拠状況を示します。
• クエリパネル: 名前、説明、チャートの種類、表示スタイル、およびクエリへのリンク（run_query の結果メタデータにある query_url）を示します。結果が何を示したかを簡単に説明します。
• 予定しているレイアウト（サイズとグループ分け）
• タグ: ボードに追加する予定のタグを表示します。
• プリセットフィルターがある場合はそれも

最後にこう締めくくります:「これが作成予定のボードです。進めてよろしいですか？」

このステップは省略できません。 ユーザーが「とにかく作成して」「信頼している」「プレビューは飛ばして」と言っても、必ず計画を表示してください。ユーザーは、見ていないものを有意義に確認することはできません。ボードは作成後に更新する方法がなく、修正するには削除して最初からやり直すしかありません。たとえユーザーが不要だと思っていても、先に計画を示すことでユーザーを守ることになります。

唯一の例外: この会話の中でユーザーがすでに特定の計画を確認し、承認している場合は、そのまま進めてかまいません。

ボードを作成する

panels 配列を指定して create_board を呼び出します。すべてのパネルには type フィールド（"query"、"slo"、または "text"）が必要で、これによって適用される他のフィールドが決まります。フィールドの完全なリファレンスについては ${CLAUDE_PLUGIN_ROOT}/skills/create-honeycomb-board/references/board-layout.md を参照してください。

{
  "environment_slug": "production",
  "name": "Checkout Service",
  "description": "...",
  "panels": [
    {
      "type": "text",
      "content": "## Checkout Service\nOwned by Platform team. [Source](https://github.com/...)"
    },
    {
      "type": "slo",
      "id": "SLO-abc123",
      "size": { "width": 4 }
    },
    {
      "type": "query",
      "id": "QR-abc123",
      "name": "Request Rate",
      "chart_type": "stat",
      "display_style": "chart",
      "size": { "width": 4 }
    },
    {
      "type": "query",
      "id": "QR-def456",
      "name": "Error Rate",
      "chart_type": "stat",
      "display_style": "chart",
      "size": { "width": 4 }
    },
    {
      "type": "query",
      "id": "QR-ghi789",
      "name": "Latency Distribution",
      "description": "Overall request latency as a heatmap",
      "chart_type": "default",
      "display_style": "chart",
      "size": { "width": 12, "height": 3 }
    }
  ],
  "preset_filters": [{ "column": "http.route", "alias": "Route" }],
  "tags": ["team:platform", "tier:critical"]
}

フォローアップ

ユーザーをボードへのリンクに誘導します。

相互参照

• クエリ構築のパターンと計算フィールドについて: query-patterns スキル
• SLO の解釈とバーンアラートの設計について: slos-and-triggers スキル