dashboard-builder

name	dashboard-builder
description	Grafana、SigNoz、および類似プラットフォーム向けに、実際のオペレーターの質問に答えるモニタリングダッシュボードを構築します。見せかけのボードではなく、メトリクスを実用的なダッシュボードに変換する場合に使用します。
origin	ECC direct-port adaptation
version	1.0.0

Dashboard Builder

タスクが人々が運用できるダッシュボードを構築することである場合に使用します。

目標は「すべてのメトリクスを表示する」ことではありません。目標は以下に答えることです:

• 健全か?
• ボトルネックはどこか?
• 何が変わったか?
• 誰がどのアクションを取るべきか?

使用タイミング

• 「Kafka モニタリングダッシュボードを構築して」
• 「Elasticsearch 向けの Grafana ダッシュボードを作成して」
• 「このサービス向けの SigNoz ダッシュボードを作って」
• 「このメトリクスリストを実用的な運用ダッシュボードに変換して」

ガードレール

• 視覚レイアウトから始めない。オペレーターの質問から始める
• 存在するという理由だけで利用可能なすべてのメトリクスを含めない
• 構造なしにヘルス、スループット、リソースパネルを混在させない
• タイトル、単位、適切なしきい値なしにパネルを出荷しない

ワークフロー

1. 運用上の質問を定義する

以下を中心に整理します:

• ヘルス / 可用性
• レイテンシ / パフォーマンス
• スループット / ボリューム
• 飽和 / リソース
• サービス固有のリスク

2. ターゲットプラットフォームスキーマを学ぶ

まず既存のダッシュボードを調査します:

• JSON 構造
• クエリ言語
• 変数
• しきい値スタイリング
• セクションレイアウト

3. 最小限の有用なボードを構築する

推奨構造:

1. 概要
2. パフォーマンス
3. リソース
4. サービス固有セクション

4. 見せかけのパネルをカットする

すべてのパネルは実際の質問に答えるべきです。そうでなければ削除します。

パネルセットの例

Elasticsearch

• クラスターヘルス
• shard allocation
• 検索レイテンシ
• インデックスレート
• JVM heap / GC

Kafka

• ブローカー数
• under-replicated partitions
• messages in / out
• コンシューマーラグ
• ディスクとネットワーク圧

API gateway / ingress

• リクエストレート
• p50 / p95 / p99 レイテンシ
• エラーレート
• upstream ヘルス
• アクティブ接続

品質チェックリスト

• 有効なダッシュボード JSON
• 明確なセクショングルーピング
• タイトルと単位が存在する
• しきい値/ステータスカラーが意味のあるもの
• 共通フィルタ用の変数が存在する
• デフォルトの時間範囲と更新が妥当
• オペレーターの価値がない見せかけのパネルがない

関連スキル

• research-ops
• backend-patterns
• terminal-ops