ダッシュボードの概観

ダッシュボードのレイアウト、サイドバーの各行き先、グローバルなフィルターバー、そしてLatchkeyがバックグラウンドで何をしているかを伝えるバナーについて。

Command & Control の概要ページ — Command & Control: インサイトの健全性、パイプラインのパフォーマンス、コストを1画面で。

ダッシュボードには3つの常設パーツがあります: サイドバー(どこへ行くか)、フィルターバー(どのデータを見ているか)、そしてページ本体です。このガイドではこの3つに加え、Latchkeyがバックグラウンドで何が起きているかを伝えるために使うバナーを説明します。

サイドバー#

すべての行き先が1か所に。admin の印が付いた項目はワークスペースのオーナーと管理者にのみ表示されます。それ以外のユーザーには残りが表示されます。

Command & Control概要ページ: インサイト、パフォーマンス、コストを一目で。各セクションはそのフルページへリンクします。Latchkey Runnersマネージドランナーのフリート: 設定、使用状況、そして自己修復のアクティビティフィード。Optimization Insightsワークフロー向けのAI推奨事項。プルリクエストとして適用されます。Pipeline Performanceビルド時間、成功率、失敗、そして復旧メトリクス。Cost Analysis理論コスト vs 請求対象コスト、リポジトリ別の内訳、無料枠の追跡。Knowledge BaseAI推奨事項の根拠とするために、ランブックやドキュメントをアップロードします。

adminMonitoringリポジトリ監視のモーダル(オーナーと管理者)。

adminMigrate RunnersワークフローをLatchkeyのランナーへガイド付きで一括移行します。

adminTeamメンバー、ロール、招待、シート。adminBillingプラン、シート、ランナー使用状況、Stripeポータル(モーダルとして開きます)。Settings通知、自己修復モード、APIキー、アカウント。

それらの下に、サイドバーはこのドキュメント、フィードバックフォーム、サポートへのリンクを持っています。

フィルターバー#

すべてのアナリティクスページは、上部の1つのフィルターバーを共有します:

ランナータイプセレクター: All Runners、Latchkey Runners、または GitHub Runners。
リポジトリとワークフローのマルチセレクト。 リポジトリピッカーには検索、すべて選択、すべてクリアが加わります。アナリティクスページは選択したリポジトリとワークフローのデータを表示します。何も選択されていない場合、ページはまずリポジトリを選ぶよう促します。
日付範囲ピッカー。7D、30D、90D、1Y、YTDのプリセットに加えてカスタムのカレンダー範囲があります。既定のウィンドウは直近14日です。(Cost Analysisページは請求向けのプリセットに切り替わります: MTD、7D、30D、3M、6M、12M。)
フィルターのリセットでワンクリックで既定に戻します。
表示設定(歯車アイコン)には、丸めた値と正確な値を切り替える "Show decimals" トグルがあります。
通知ベルにはアプリ内の通知履歴があります。

フィルターがどう組み合わさるか#

セレクターはすべて同じ結果セットを絞り込みます: ランナータイプ、リポジトリ、ワークフローが一緒に作用し、日付範囲がすべての計算対象となるウィンドウを区切ります。1つのリポジトリと1つのワークフローを選び、日付範囲を狭めることが、特定の期間における単一のパイプラインの挙動を分離する標準的な方法です。すべてのアナリティクスページが同じバーを共有するため、設定したスコープは次にどこへ移動しても適用されます: Cost Analysis で見るコストと Pipeline Performance で見る所要時間は、あなたのCIの同じ断面を示します。

リポジトリが選択されていない

アナリティクスページがスコープを推測することはありません
まずリポジトリを選ぶよう促されます
リポジトリセレクターから1つ選ぶとページにデータが入ります

リポジトリが選択されている

ページは選択したリポジトリとワークフローそのもののデータを表示します
ワークフローセレクターと日付範囲でさらに絞り込みます
フィルターのリセットでワンクリックで既定に戻ります

想定していたリポジトリがセレクターに見当たらない場合、まだ監視されていない可能性が高いです。監視はオーナーと管理者がMonitoringモーダルから管理します。リポジトリの管理を参照してください。

全画面チャートとライブ更新#

画面上のデータについて知っておくべき2つの挙動。すべてのチャートはフィルターバーを利用できる状態のまま全画面ビューに展開するので、スコープを失うことなく同じビューで切り分けと提示ができます。そしてページは自動的に更新され、いずれかのワークフローが進行中の間は更新間隔を短くします: アクティブなCI実行中は、手動でリロードすることなく結果がほぼリアルタイムで届きます。

知っておくべきバナー#

バックフィルの進捗: 新たに有効化したリポジトリの履歴データをインポート中に表示されます。
AI処理: 最適化エージェントが分析している間、Insightsページに表示されます。
無料枠の警告: 含まれるランナー分の80%(および再度100%)を使用したときに表示されます。
試用の通知: 試用が終了間近のときのカウントダウンと、終了後にサブスクライブを促す全画面のプロンプト。

これらのいずれも、ダッシュボードを動かし続けるために操作を要しません。Latchkeyが自身のバックグラウンド作業を伝えているだけです。それぞれ、より詳しく知りたいときの自然な次の行き先があります:

バナー	何を伝えるか	次にどこへ行くか
バックフィルの進捗	新たに有効化したリポジトリの履歴実行がまだインポート中です	リポジトリの管理がバックフィルの対象範囲を説明します
AI処理	最適化エージェントが今まさにあなたのワークフローを分析しています	Optimization insights が結果の届く場所です
無料枠の警告	含まれるランナー分の80%(次に100%)を使用しました	ランナー使用状況と無料分
試用の通知	試用が終了間近、または終了しました	プランと試用

Command & Control (概要)#

概要ページは3つのアナリティクス領域を1画面に凝縮し、各セクションはその詳細ページへリンクします:

Optimization Insights: 高・中・低優先度の推奨事項の件数を含む健全性バッジ(GOOD、WARNING、CRITICAL)と、月あたりの潜在的な節約額。何も未対応がない場合、カードは "You're all caught up" の状態を表示し、ワークフローの実行に伴って新しい推奨事項が現れます。
Pipeline Performance: ワークフロー健全性ゲージ、監視中のリポジトリとワークフロー、平均復旧時間(MTTR)、そして総実行数、平均所要時間、失敗率、キャンセル率、リビルド成功率のサマリー。
Cost Analysis: 週ごとの傾向を伴う理論コスト、支出上位3リポジトリ(それぞれGitHubへリンク)、点線の予測延長を伴う時系列の請求対象コスト、そしてGitHubとLatchkeyの両ランナーの無料枠分の追跡。

60秒で概要を読む#

概要は熟読するためではなく、ざっと見るために作られています。この素早い一巡を習慣にする1つの方法を示します。順序は提案であって、製品上の要件ではありません:

健全性バッジを確認する

GOOD、WARNING、CRITICAL が一巡全体のトーンを決めます。GOODでない場合は高優先度の推奨事項の件数を控えておきましょう。それが後で Insightsページで掘り下げる対象です。

パフォーマンスサマリーを見る

ワークフロー健全性ゲージ、MTTR、失敗率を見ます。探しているのは絶対的な数値ではなく、チームにとって通常の状態と比べた変化です。何か意外なものがあれば、セクションのリンクをたどって Pipeline Performance へ。

コストの傾向を読む

理論コストの週ごとの傾向は、"支出はずれてきているか?" を判断する最速のシグナルです。上位の支出リポジトリを見て、上位に予想外のものがないか確認しましょう。全容は Cost Analysis にあります。

無料枠の追跡をさっと見る

概要はGitHubとLatchkeyの両ランナーの無料枠分を追跡します。どちらかが逼迫していれば80%でバナーも表示されますが、ここで早めに気づく方が後で対応するより安く済みます。

動いた1つのセクションへ移動する

概要の各セクションはそのフルページへリンクします。役立つ習慣: 前回見たときから最も変化した1つのセクションを選び、3つすべてに目を通すのではなく、それを深く掘り下げましょう。