コンテンツへスキップ
Latchkey ホーム
EnglishPortuguês日本語
無料で始める
ドキュメントメニュー
はじめに
  1. Latchkey とは
  2. Quickstart
  3. GitHub App をインストールする
  4. リポジトリの管理
ダッシュボードと分析
  1. ダッシュボードの概観
  2. コスト分析
  3. パイプラインのパフォーマンス
  4. 最適化インサイト
  5. Knowledge Base
  6. AI エージェントを接続
マネージドランナー
  1. ランナーの概要
  2. 最初のジョブを実行する
  3. GitHub ホステッドからの移行
  4. Latchkey CLI
  5. Runners ページ
  6. カスタムランナー (AI Scan)
  7. 自己修復
  8. ランナーイメージとソフトウェア
  9. プロビジョニングとウォームプール
  10. 上限と同時実行数
キャッシュ
  1. 依存関係のキャッシュ
  2. Docker レイヤーキャッシュ
チームと通知
  1. チームとロール
  2. 通知
  3. Slack 連携
請求とプラン
  1. プランとトライアル
  2. 請求の管理
  3. 使用量と無料分数
ヘルプ
  1. トラブルシューティング
  2. FAQ
  3. セキュリティアーキテクチャ
  4. セキュリティと権限
ワークフローファイル
  1. ワークフローファイル

コスト分析

Latchkeyランナーの分が請求でいくらになるかを確認し、無料分を追跡し、最も支出の多いリポジトリを見つけます。

·Latchkey

要点

  1. Spend は、選択した日付の範囲でランナーの分に対して請求される額です。無料枠でカバーされた分は請求されません。
  2. Highest Spend と Repository Costs は最もコストのかかるリポジトリを見つけます。Free Tier Minutes Tracking はLatchkeyプランの分を追跡します。
  3. CLI Jobs 行は、Latchkey CLI または run_job MCP ツールから開始されたジョブを表示します。これらはどのリポジトリにも属しません。
  4. Latchkey KPIスタックと Free Tier Minutes Tracking は、日付フィルターに関係なく常に当暦月を反映します。

Cost Analysis ページは、Latchkeyランナーで実行されたジョブについて "CIのお金はどこへ行っているのか?" に答えます。

ページは3つのセクションで構成されています: Cost Overview(見出しのKPI)、Cost Analysis(掘り下げるチャート)、Latchkey Runner Costs(マネージドランナーの構成ごとのコスト)。ただし、それらが役に立つ前に、見出しが何を数えているかを知っておく必要があります。

Spend が数えるもの#

Spend は、選択した日付の範囲でランナーの分に対して、各ランナーサイズの価格で請求される額です。無料枠でカバーされた分は請求されないため、無料枠の範囲内のワークスペースは、ジョブが実行されていても $0 と表示されます。ページ上のすべてのコストの数字は、Latchkeyの請求記録から読み取られます。

Cost Overview セクション#

  • Spend。週ごとの傾向バッジを伴います。バッジは実行のあった直近7日の Spend をその前の7日と比較します。範囲内に実行のあった日が14日揃うまで、またその前の7日の費用がゼロのときは、ダッシュを表示します。
  • Highest Spend: 選択した日付の範囲の Spend による上位3リポジトリ。請求されたリポジトリのみが表示されます。1つもない場合、カードには "No repository was charged in the selected dates." と表示されます。
  • Latchkey KPIスタック: "This calendar month" と表示され、当暦月の推定コストに加え、今期間の残り・使用済みの無料枠のスモール換算分を表示します。ランナー使用状況が読み込めない場合、各カードには数字の代わりに "Unavailable" と表示されます。
  • Free Tier Minutes Tracking: Latchkeyプランに含まれるスモール換算分のセグメント化されたゲージで、上限はあなた自身のプランの割り当てを反映します。ランナー使用状況が読み込めない場合、ゲージは描画されず、カードには "Unavailable" と "runner usage did not load" が表示されます。

Cost Analysis セクション#

  • Cost Over Time: 選択した日付範囲にわたる日ごとの Spend。
  • Repository Costs: リポジトリごとの Spend。Top 5 / Bottom 5 のドロップダウン付き。リポジトリ名はGitHubへ直接リンクするので、コストの急増からその背後にあるワークフローファイルへワンクリックで行けます。

このセクションの読み方のヒント: Cost Over Time で $0 が続く期間は、無料分がカバーした期間です。無料分が尽きると線は上がり始めます。

Latchkey Runner Costs セクション#

マネージドランナーでジョブを実行する場合、このセクションは構成ごとのコスト表とともに表示されます: Config Name(latchkey-small のようにワークフローファイルで使うランナーラベル付き)、Custom or Preset のタイプバッジ、Jobs、Avg Duration、そして Cost(選択期間における各構成の分を、無料分を差し引く前の定価で計算した額)。無料分が使われた場合、フッターに "Free tier applied: X / Y small-equivalent min" と "Saved $Z"(その無料分にかかったはずの額)が表示されるため、表の数字の合計は Spend を上回ることがあります。Cost Overview のLatchkey KPIスタックと Free Tier Minutes Tracking は、日付範囲フィルターに関係なく常に当暦月を反映します。

CLI Jobs 行#

チームが Latchkey CLI または MCP の run_job ツールから単発ジョブを実行する場合、その支出は独立した CLI Jobs 行として、その期間の支出とジョブ数とともに表示されます。これらのジョブはどのリポジトリにもどのワークフローにも属さないため、この行はリポジトリの内訳では位置づけられないお金にあたります。これらは Spend に含まれます。リポジトリまたはワークフローのフィルターが有効な間はこの行は非表示になり、CLIジョブのない期間には完全に消えます。

このページのフィルター#

共有フィルターは Command & Control にだけ表示されます。このページの数字はすべてLatchkeyランナーのものです。Account and help メニューの Display にある Show decimals は、ドル表記をセント精度と丸めた整数ドルとで切り替えます。日付フィルターの例外: Latchkey KPIスタックと Free Tier Minutes Tracking は常に当暦月を反映します。

どのチャートがどの問いに答えるか#

知りたいこと見る場所
CI支出は増加傾向か減少傾向か?Spend とその週ごとの傾向バッジ
どのリポジトリが最もコストがかかるか?Highest Spend、次に Top/Bottom 切り替え付きの Repository Costs
急増は正確にいつ起きたか?Cost Over Time、その周辺に日付範囲を絞って
請求書はどうなりそうか?Latchkeyの KPIスタック(当暦月の推定コスト)
無料分を使い切るまでどれくらい近いか?Free Tier Minutes Tracking のゲージ
各ランナーサイズはいくらかかっているか?Latchkey Runner Costs の構成ごとの表
単発のCLIジョブやエージェントのジョブはいくらかかったか?CLI Jobs 行

このページを使って実際にコストを削減する#

支出を下げる必要があるときの推奨ルーティンです。ここにあるものは製品によって強制されるものではなく、単にチャートが互いの問いに答える順序です:

傾向を確立する

Spend とその週ごとのバッジから始めます。傾向が横ばいなら、安定した請求を最適化していることになります。上昇しているなら、変化を追っていることになり、残りの一巡はいつどこでかを見つけることが目的です。

集中を見つける

Highest Spend と Repository Costs を開きます。CI支出は通常集中しています: 少数のリポジトリが請求の大半を担う傾向があるので、このチャートの上位に費やす労力は他のどこよりもはるかに大きく報われます。

パイプラインを分離する

リポジトリとワークフローのフィルターを使って1つの候補にズームインし、選択した範囲について Cost Over Time を読みます。これにより通常、急増が始まった日と、その原因となったワークフローが特定できます。

対処する

AI Insight を確認してください: 毎晩の分析が定量化されたコストの検出結果を表面化します。各検出結果にはLatchkeyが代わりに実行できる1つのアクション(大きすぎるランナーのダウンサイズ、キャッシュの追加)が付き、あなたが承認するプルリクエストとして適用されます。問題が無駄ではなく無料枠の枯渇なら、ランナー使用状況と無料分 と 請求の管理 を参照してください。

メトリクスリファレンス#

メトリクス何を伝えるか
Spend選択した日付の範囲でランナーの分に対して、各ランナーサイズの価格で請求される額。無料枠でカバーされた分は請求されません
Week over WeekSpend の変化率、実行のあった直近7日 vs その前の7日。範囲内に実行のあった日が14日揃うまで、またはその前の7日の費用がゼロの間はダッシュ
Highest Spend選択した日付の範囲の Spend による上位3リポジトリ。請求されたリポジトリのみが表示されます
Free Tier Minutes TrackingLatchkeyプランについての "X / Y small-equivalent minutes used" ゲージ
Cost Over Time選択した日付の範囲にわたる日ごとの Spend
Free tier applied: X / Y minプランの含有分に対して適用されたLatchkeyの無料分と、そのドル価値。ランナーコスト表のフッターに表示
CLI JobsLatchkey CLI または run_job MCP ツールから開始されたジョブの支出とジョブ数。どのリポジトリにも属さないため、リポジトリの内訳ではなく、ここと Spend の中に表示

このページに現れる前に支出をモデル化するには - 新しいリポジトリ、より大きなランナー、より多くのジョブ - Learn の GitHub Actions コスト計算ツール を使うか、プロバイダー横断の価格の仕組みについては CIコストガイド を参照してください。

Latchkey KPIスタックと Free Tier Minutes Tracking が日付フィルターを無視するのはなぜですか?

Latchkey KPIスタックと Free Tier Minutes Tracking は、フィルターがどの範囲に設定されていても、常に当暦月を反映します。今月いくら支払い、どれだけ残っているかに答えるもので、それは日付範囲ではなく暦月の問いです。ページ上のその他のチャートはフィルターに従います。

References