ドキュメントメニュー
マネージドランナー
ワークフローファイル
ランナーの使用量と無料分数
マネージドランナーの分数がどのように計測されるか、無料枠が何をカバーするか、使用量がどこに表示されるか、そして無料分数が尽きると何が起こるかを説明します。
要点
- ジョブごとに切り上げて分単位で課金: small $0.0025 から xlarge $0.0200 まで。カスタムランナーは xlarge のレート。
- 無料分数は毎月1日にリセットされます（プランごとに small 換算で 2,000/4,000/6,000）。超過分のみ課金されます。
- Latchkey CLI やエージェントからのワンオフジョブもまったく同じように計測され、同じ無料分数プールを使用します。その支出は Cost Analysis 上に CLI Jobs の項目として表示されます。
- どちらの場合も 80% と 100% で警告されます。カード未登録のワークスペースは使い切ると新しいジョブがブロックされ、サブスクリプションはジョブを実行し続けて超過分を計測します。
計測の仕組み#
- 使用量はジョブごとに切り上げて分単位で課金されます。
latchkey-smallでの90秒のジョブは2分です。 - 各サイズには独自のレートがあります: 1分あたり small $0.0025、medium $0.0050、large $0.0100、xlarge $0.0200。カスタム構成のランナーは xlarge のレートで課金されます。
- ジョブが実際にランナーを占有している時間のみが課金されます。ジョブは4時間のランナー寿命によって上限が設けられています。
- self-healing に別途料金はかかりません。heal 中の追加ランタイムはランナーの標準の分単位レートで課金されます。
- Latchkey CLI や MCP の
run_jobツールからのワンオフジョブも同じように計測されます: 同じ分単位レート、同じ無料分数プール、ジョブごとの切り上げです。デフォルトのタイムアウトは30分で、3時間まで延長でき、キュー待ち時間は決して課金されません。 - 超過分はプランと同じ月次 Stripe 請求書に従量制の項目として計上されます。
切り上げは月ごとではなくジョブごとに行われます。これはジョブが短い場合に重要です。61秒のジョブは2分として課金されるため、多数の1分ジョブに分散する workflow は、合計の実時間が示唆するよりも目に見えて速く分数を消費します。これがゲージ上で見えるようになったら、非常に短いジョブをまとめることが対策になります。
無料枠#
| プラン | 月あたりの無料ランナー分数 (small 換算) |
|---|---|
| Developer | 2,000 |
| Launch | 4,000 |
| Scale | 6,000 |
| Enterprise | カスタム |
無料分数は暦月の初日にリセットされます。無料枠内の分数は無料です。それを超える使用量のみが分単位のレートで課金されます。無料ランナー時間は small 換算の単位で計算されます。latchkey-small の 1 分は 1、medium は 2、large は 4、xlarge とカスタムランナーは 8 として数えられ、各プランに含まれる無料枠の量は変わりません。
計算例#
以下の数字は例示であり、レートと枠は実際のものです。Launch（small 換算の無料分数4,000）のチームが、1か月に latchkey-small を6,000分実行したとします。この場合、1 分は 1 として数えられます:
| 項目 | 金額 |
|---|---|
latchkey-small で計測された分数 | 6,000 |
| Launch の無料枠 | 最初の4,000分 (small 換算) は無料。latchkey-small では4,000分にあたります |
| 課金対象の分数 | 6,000 - 4,000 = 2,000 |
| $0.0025/min での超過分 | 2,000 x $0.0025 = $5.00、月次請求書の従量制項目として |
大きいマシンは 1 分あたりの料金が高いだけでなく、無料枠の消費も速くなります。同じ6,000分でも latchkey-medium（$0.0050/min）は small 換算で12,000分となるため、4,000分の無料枠は2,000分をカバーし、残り4,000分が $20.00 の超過分になります。latchkey-large（$0.0100/min）では無料枠が1,000分をカバーし、残り5,000分が $50.00 になります。下の計算ツールで、あなた自身の数字で同じ計算を実行できます。
コストを見積もる#
月々のランナー費用を見積もる
あくまで見積もりです。無料分は small 換算の単位で数えられ、この計算機は選んだサイズの重みを適用します。GitHub との比較には、同じサイズの GitHub Linux 定価 ($0.006 から $0.042/分) を使用しています。請求額は実際の計測使用量に基づきます。
使用量を確認する場所#
- Billing ページには、無料枠の進捗バー、今期の合計分数と課金対象分数、そしてこれまでの推定ランナーコストが表示されます。
- Latchkey Runners ページには、フリート全体のコスト、GitHub ホスト型と比較した推定節約額、無料枠の消費量が表示されます。
- Cost Analysis ページは、Latchkey ランナーの支出を GitHub の支出と並べて追跡し、両方の無料枠ゲージを含みます。
- Latchkey CLI やエージェントから開始されたジョブは、Cost Analysis に独自の CLI Jobs 項目として表示されます。個々のジョブは CLI 自体から追跡してください（
latchkey status、latchkey logs）。
無料分数を使い切る#
- カード未登録のワークスペースは、80% の時点で 1 日に最大 1 回、再び 100% の時点で暦月あたり 1 回警告されます。100% の時点で Latchkey は実行中のジョブを停止し、プランが始まるか分数がリセットされるまで新しいジョブを保留します。
- サブスクリプションが登録されている場合: 80% と、再び 100% の時点で、しきい値ごとに暦月あたり最大 1 回警告されます。ジョブは動作し続け、オーナーまたは管理者が Billing ページで設定できる支出上限まで、超過分が請求書に計測されます。
- カードなしトライアルの場合: 無料分数を使い切ると、Latchkey は実行中のジョブを停止し、購読するか分数がリセットされるまで新しいマネージドランナージョブを保留します。保留されたジョブは GitHub 上でキューに残り（GitHub UI にエラーは出ません）、その月の「Free tier running out」通知がそれを伝えます。その後に「Managed runner blocked」通知は続きません。
タイムラインの概要#
- 0180% 使用最初の「free tier running out」警告: ゲージを確認して判断する
- 02100% 使用2回目の警告: これ以降のすべての分数は課金対象、またはカードなしトライアルではブロック
- 03超過またはブロックサブスクリプションがあればジョブは動作し続けメーターが回る。カードなしトライアルは新しいランナーの起動を停止する
- 04月次リセット無料分数は暦月の初日にリセットされる
100% ではなく 80% の警告を判断のポイントとして扱ってください。枠の5分の1がまだ残っており、使用量を切り詰める（Cost Analysis ページで支出の出どころがわかります）か、超過を承知の上で受け入れる余地があります。サブスクリプションが登録されていて支出上限が設定されていなければ、受け入れることも完全に有効な選択です。ただし、それは選ばれたものであるべきです。
起動がブロックされている場合#
無料分数のゲートであることを確認する
保留されたジョブはエラーなしで GitHub 上のキューに残り、その月の「Free tier running out」通知が停止を伝えます。無料枠ゲージ（Billing ページまたは Runners ページ）が状態を確認します: カードなしトライアルで 100% 使用。
購読してブロックを解除する
購読するまで新しいマネージドランナージョブはブロックされるため、サブスクリプションを追加することが直接の解決策です。登録されていれば、無料枠を超える使用量はブロックせず、単に請求書に計測されるだけになります。
または月次リセットまでつなぐ
無料分数は暦月の初日にリセットされます。それまでは、緊急の workflow を GitHub ホスト型のラベルに戻して指すことができます。これらは latchkey-* ラベルと並んでずっと動作し続けます。
ランナーの利用時間はどのように計測されますか?
分単位で、ジョブごとに切り上げられます。small の 1 分 $0.0025 から xlarge の $0.0200 までで、カスタムランナーは xlarge の料金で計測されます。切り上げはジョブ単位のため、非常に短いジョブが多いと実際の合計分数より高くなります。
無料枠の分数はいつリセットされますか?
毎月 1 日にリセットされ、プランに応じて small 換算で 2,000 分、4,000 分、6,000 分です。課金対象は無料枠を超えた分のみなので、枠内に収まった月はランナー時間の費用はかかりません。
CLI やエージェントのジョブも同じ無料枠を使いますか?
はい。Latchkey CLI や AI エージェントから起動した単発ジョブも同じ方法で計測され、同一の月間プールを消費します。その支出は Cost Analysis 上に CLI Jobs の行として別途表示されるため、ワークフローのコストに埋もれずに確認できます。