コンテンツへスキップ
Latchkey
無料で始める
ドキュメントメニュー

ダッシュボードの概観

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

Command & Control の概要ページ
Command & Control: AI Insightのヒーローと上位の検出結果、その下にPipeline Performance。

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

サイドバー#

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

Migrate Runnersモーダル
Migrate Runnersは、ワークフローをLatchkeyのランナーへ一括で移すためのガイド付きモーダル(オーナーと管理者)を開きます。

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

フィルターバー#

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

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

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

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

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

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

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

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

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

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

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

知っておくべきバナー#

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

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

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

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件がアクション付きのカードとして現れます: PreviewPin 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つの方法を示します。順序は提案であって、製品上の要件ではありません:

AI Insightのヒーローを読む

2つの数字がトーンを決めます。左の数字は自己修復がすでに自力で直したもので、あなたからは何も必要としません。右の数字はあなたの承認を待つ検出結果で、ゼロでなければそこが最初の行き先です。完全なキューは AI Insight にあります。

その場で片づけられるものを片づける

未対応の検出結果の上位3件が、カード上の1つのアクションとともにヒーローのすぐ下に並びます。Preview は適用前に正確な変更内容を表示し、Dismiss はあなたに当てはまらないものを片づけます。ここでの1分で、概要ページを離れることなくキューが空になることがよくあります。

パフォーマンスカードを見る

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

コストの傾向を読む

Theoretical Costの週ごとのバッジは、"支出はずれてきているか?" を判断する最速のシグナルです。上位の支出リポジトリと、サイクル終了までの予測請求対象コストをさっと見ましょう。無料枠分は同じスタックで追跡され、80%でバナーも警告します。全容は Cost Analysis にあります。

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

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

References