# ダッシュボードの概観

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

Source: https://latchkey.dev/ja/documentation/dashboard-overview

## Summary

- 概要ページの先頭は **AI Insight**: 直近30日間に自己修復が直したものと、あなたの承認を待つ検出結果です。
- サイドバーはアナリティクス、ランナー、インサイト、チーム、請求、設定をカバーします。管理者専用の項目には印が付いています。
- 共有された1つの**フィルターバー**(ランナータイプ、リポジトリ、ワークフロー、日付範囲)が、すべてのアナリティクスページのスコープを決めます。
- データは自動的に更新され、ワークフロー実行中はより高速に更新されます。チャートはフィルターを保ったまま全画面に展開します。
- バナーはバックグラウンドの作業を伝えます: バックフィルの進捗、無料枠の警告、試用の通知。

> **デスクトップ専用**
> ダッシュボードはデスクトップのブラウザ向けに設計されています。スマートフォンとタブレットではサインイン後にブロック通知が表示されます。

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

## サイドバー

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

- **Command & Control** 概要ページ: AI Insight、パフォーマンス、コストを一目で。各セクションはそのフルページへリンクします。
- **Latchkey Runners** マネージドランナーのフリート: 設定、使用状況、そして自己修復のアクティビティフィード。
- **Optimization Insights** 毎晩の分析による定量化された検出結果。それぞれに承認すべき1つのアクションが付きます。ページ自体のタイトルは "AI Insight" です。
- **Pipeline Performance** ビルド時間、成功率、失敗、そして復旧メトリクス。
- **Cost Analysis** 理論コスト vs 請求対象コスト、リポジトリ別の内訳、無料枠の追跡。
- **Knowledge Base** AI推奨事項の根拠とするために、ランブックやドキュメントをアップロードします。
- **Migrate Runners** ワークフローをLatchkeyのランナーへガイド付きで一括移行します。モーダルが開きます。
- **Monitoring** リポジトリ監視の管理モーダルを開きます。
- **Team** メンバー、ロール、招待、シート。
- **Billing** プラン、シート、ランナー使用状況、そしてStripeポータル。Billing & Subscriptionモーダルが開きます。
- **Settings** 通知、自己修復モード、APIキー、アカウント。

それらの下に、サイドバーはこのドキュメント、Send Feedbackフォーム(モーダル)、サポートへのリンクを持っています。

> **初回の訪問**
> 初回セットアップの後、ステップバイステップのツアーがダッシュボード全体を案内します: Command & Control、フィルターバー、ランナー、自己修復、AI Insight、パフォーマンス、コスト、Knowledge Base、移行、監視、そしてドキュメントとサポートのある場所です。いつでもスキップできます。

## フィルターバー

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

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

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

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

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

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

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

## 知っておくべきバナー

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

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

| バナー | 何を伝えるか | 次にどこへ行くか |
| --- | --- | --- |
| バックフィルの進捗 | 新たに有効化したリポジトリの履歴実行がまだインポート中です | [リポジトリの管理](/documentation/managing-repositories) がバックフィルの対象範囲を説明します |
| 無料枠の警告 | 含まれるランナー分の80%(次に100%)を使用しました | [ランナー使用状況と無料分](/documentation/runner-usage-and-free-minutes) |
| 試用の通知 | 試用が終了間近、または終了しました | [プランと試用](/documentation/plans-and-trial) |

## Command & Control (概要)

概要ページの先頭は、Latchkeyがあなたのために何をしたか、そして何があなたの判断を待っているかです。その下にパフォーマンスとコストが凝縮されます。上から下へ3つのセクションがあり、各セクションはそのフルページへリンクします:

- **AI Insight**(リンクは "View AI Insight"): ヘッダーには "See what self-heal fixed automatically and the savings ready to apply." とあります。分割ヒーローの左側には **Self-heal, last 30 days** として、ランナー上で修復された失敗の件数が **Autonomous** バッジ付きで表示され、右側には **Insight, ready to apply** として、適用の準備ができた検出結果の件数が、セキュリティ、信頼性、活用、コストの柱を示すドットと未対応の検出結果バッジとともに表示されます。ヒーローの下には、未対応の検出結果の上位3件がアクション付きのカードとして現れます: **Preview**、**Pin to SHA** のようなワンクリック適用、**Dismiss**、または **Investigate** です。何も未対応がない場合、セクションには "You are all caught up." と表示されます。
- **Pipeline Performance**(リンクは "View Performance"): "Successful Workflow Deployments" というキャプションのゲージで示されるWorkflow Health、Repositories MonitoredとWorkflows Monitoredの件数、平均復旧時間(MTTR)、Workflow Health Summary(Total Runs、Average Duration、Fail Rate、Cancel Rate、Rebuild Success Rate)、そして失敗した実行の件数と最も失敗しているワークフローを示すFailed Deployments(失敗がない場合は "No failures detected")。
- **Cost Analysis**(リンクは "View Cost Analysis"): 週ごとのバッジを伴うTheoretical Cost、GitHubへリンクする上位リポジトリを示すHighest Spend (Theoretical)、GitHubのKPIスタック(サイクル終了までの予測請求対象コスト、または "Not enough data yet - run more jobs for a forecast"、加えて今サイクルの残り・使用済みの無料枠分)、点線の予測延長を伴うTotal Billable Cost Over Time、そして "Current billing period" と表示されるLatchkeyのKPIスタック。

### 60秒で概要を読む

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

1. **AI Insightのヒーローを読む** 2つの数字がトーンを決めます。左の数字は自己修復がすでに自力で直したもので、あなたからは何も必要としません。右の数字はあなたの承認を待つ検出結果で、ゼロでなければそこが最初の行き先です。完全なキューは [AI Insight](/documentation/optimization-insights) にあります。
2. **その場で片づけられるものを片づける** 未対応の検出結果の上位3件が、カード上の1つのアクションとともにヒーローのすぐ下に並びます。**Preview** は適用前に正確な変更内容を表示し、**Dismiss** はあなたに当てはまらないものを片づけます。ここでの1分で、概要ページを離れることなくキューが空になることがよくあります。
3. **パフォーマンスカードを見る** Workflow HealthゲージとMTTR、そしてWorkflow Health Summaryの失敗率を見ます。探しているのは絶対的な数値ではなく、チームにとって通常の状態と比べた変化です。何か意外なものがあれば、セクションのリンクをたどって [Pipeline Performance](/documentation/pipeline-performance) へ。
4. **コストの傾向を読む** Theoretical Costの週ごとのバッジは、"支出はずれてきているか?" を判断する最速のシグナルです。上位の支出リポジトリと、サイクル終了までの予測請求対象コストをさっと見ましょう。無料枠分は同じスタックで追跡され、80%でバナーも警告します。全容は [Cost Analysis](/documentation/cost-analysis) にあります。
5. **動いた1つのセクションへ移動する** 概要の各セクションはそのフルページへリンクします。役立つ習慣: 前回見たときから最も変化した1つのセクションを選び、3つすべてに目を通すのではなく、それを深く掘り下げましょう。

### ダッシュボードのフィルターバーはどこに適用されますか?

共通のフィルターバー (ランナー種別、リポジトリ、ワークフロー、期間) がすべての分析ページに一括で適用されるため、あるページで設定したフィルターは別のページに移動しても有効なままです。全画面表示にしたグラフも同じフィルターを保持します。

### ダッシュボードのデータはどのくらいの頻度で更新されますか?

自動的に更新され、ワークフローの実行中はさらに高頻度になるため、ビルド中に再読み込みする必要はありません。ページが空に見える場合は、たいていフィルターバーか取り込み中のバックフィルが原因で、データが失われたわけではありません。

### ダッシュボード上部のバナーは何ですか?

エラーではなく、バックグラウンド処理の状況を伝えるものです。過去の実行を取り込むバックフィルの進捗、月間無料枠に近づいたときの警告、トライアルの通知などです。ブロックされた状態には必ず明示的な表示があるため、静かなダッシュボードはブロックされている状態ではありません。

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt