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

Runs ページ: 実行、ジョブ、ログ

ワークスペースで Latchkey が処理した実行とジョブを確認します: いま実行中のもの、履歴とそのフィルター、ジョブの詳細とログ、そして実行のジョブとレグ。

要点

  1. Runs には、このワークスペースで Latchkey が処理したパイプライン実行、CLI ジョブ、Latchkey on GH のジョブが並び、処理していないものは並びません。
  2. Running now は、いま実行中、起動中、保留中のパイプラインのジョブと CLI ジョブを示し、History はウィンドウ内を 25 行ずつページ送りし、フィルターと検索で絞り込みます。
  3. 実行または CLI ジョブを選ぶと、一覧の横にそのジョブの詳細が開き、フッターに Download log があります。Export CSV は履歴をファイルとして保存します。
  4. 実行のページは各ジョブが必要とするものに沿ってジョブを描き、マトリクスのジョブはレググリッドを開きます。自身のコマンドが失敗したジョブは、コーディングエージェントに渡せます。
app.latchkey.dev / acme / runs

Runs ページです。Live と表示された Running now に、push によるジョブ (CI の Lint、4 つの Unit シャード、Integration と、3 つの E2E ブラウザ) と、npm ci && npm test を実行する CLI ジョブが並びます。各ジョブはランナー上で起動するあいだ Starting と表示されてから実行され、Lint は完了して一覧から消えます。ジョブの上の行は、使用中のランナー数 (80 中 10 まで増え、その後 80 中 9) とそのうちまだ起動中の数を warm 6、parked 4、0 held とともに示し、1 時間あたりの支出も示します。支出は 1 時間あたり $4.80 まで上がり、Lint が消えると $4.65 に下がります。ジョブの下の凡例は queued、starting、running を示します。その下の History は 30d に設定され、Spend in this window の $41.25 の下に、実行とジョブを結果、パイプライン、リポジトリ、コスト、開始、所要時間とともに一覧します: 成功して横に Healed が付いた CI の実行、CLI ジョブ、E2E、Bench、失敗した CI の実行です。

FIG. 2.2-ARunning now は、この時点で実行中、起動中、保留中のジョブと、1 時間あたりの支出 (ドル) を示します。History はウィンドウ内に実行されたものを一覧します。Spend in this window が数えるのは、確定した請求だけです。

Runs ページはダッシュボードのサイドバーにあります。Running now と History の 2 つのパネルがあり、その行から、一覧の横のジョブの詳細、実行のページ、ジョブのページへ進めます。

どの行も Latchkey が実行したもので、Latchkey 自身の記録から読み取られます。GitHub Actions のジョブがページに載るのは、Latchkey が自分のランナーでそのジョブを処理したときだけです: そのジョブについて 1 つの Latchkey on GH 行になり、それを囲む GitHub の実行が載ることはありません。また、Latchkey はそのジョブ専用のページを持たないため、その行からは何も開きません。

タイトルバー#

  • Export CSV は、絞り込んだとおりの履歴を CSV ファイルとして保存します (下の「履歴のエクスポート」を参照)。
  • Run workflow は、on: workflow_dispatch を宣言している Latchkey CI の ワークフローファイル を手動で開始します: リポジトリ、ワークフローファイル、ブランチまたはタグ、そしてその入力を選びます。
  • Run a job はドロワーを開き、Latchkey CLI をインストールし、ジョブを実行できるキーでサインインし、ジョブを 1 つ実行するためのコマンドを示します。
  • Easy では、Filters で履歴のフィルターがポップオーバーに開きます。Pro では Running now の上に行として表示されます。

Running now#

Live と表示された Running now は、ワークスペースでいま実行中、起動中、保留中のすべてのジョブを、パイプライン実行のジョブも CLI ジョブも同じように一覧し、その見出しには一覧しているジョブの数が表示されます。1 つも一覧していないときは "No pipeline or CLI job is running now." と表示されます。ジョブの上の行には次のものがあります:

  • Runners at once: 上限に対する使用中のランナー数 ("Runners at once: 3 of 40 in use")。続いて、そのうちまだ起動中の数と、Latchkey on GH のジョブを実行している数が、あれば表示されます。
  • warm と parked: 待機中のワークスペース自身のランナー。ウォームランナーは、引き受けた 1 つのジョブが終わるまで数えられます。held: まだランナーを待って並んでいるジョブ。たとえば、ワークスペースの同時ランナー数の上限や支出上限に達しているときです。
  • あなたのランナーで開始したジョブと、まだ起動中のコールドスタートの、定価での 1 時間あたりの支出 (ドル)。Latchkey on GH のジョブも含みます。

その下では、各ジョブが 1 本の時間軸上の行になります: ドットとそのラベル (実行のパイプラインとジョブ、または CLI job とそのコマンド)、待っているあいだの Starting または Held のチップ、そしてキューに入ったときからのバーです。バーは、ランナーに渡されるまでは queued、開始するまでは starting、その後は running です。凡例は queued と running を示し、starting はバーに描かれているときに示します。保留中のジョブには、待っている理由を Latchkey が示す場合、その理由を書いた行も軸の下に表示されます。

各行はそのジョブ自身のページを開きます。Running now からは何もキャンセルされません: CLI ジョブはそのジョブ自身のページで、実行は History のその行か実行自身のページでキャンセルします。View fleet で Runners ページ が開きます。ジョブが 100 を超えると、パネルは最初の 100 件を表示し、そのことを示します。

History#

History は、ウィンドウ内の実行と、その中で終わったジョブを 1 行ずつ、新しい順に一覧します。Started を押すと順序が逆になります。25 行ずつページ送りされ、テーブルの下に範囲が表示されます ("1 to 25 of 140 runs and jobs")。ウィンドウは履歴のツールにあります: 7d、30d (デフォルト)、90d、そして Pro では 1d と Custom もあり、Custom では 90 日前までの開始日とその時刻を選びます。

ウィンドウの横では、検索フィールド ("Pipeline, job, sha or ref") が行を絞り込み、Spend in this window は、フィルターや表示中のページにかかわらず、ウィンドウ全体に請求された額です。テーブルの下では、By key と By batch がその支出を、作業を送った API キーとバッチごとに分けて示します: 上位 3 つは名前で、残りは 1 行にまとめて数えます。

フィルター#

Pro では、フィルターは Running now の上の行に並び、設定したものごとにチップが付き、行の末尾に Clear filters があります。Easy では、タイトルバーの Filters から開きます。Latchkey はフィルターをウィンドウ全体に適用するため、表示中のページだけでなく、履歴のすべてのページが絞り込まれます。

  • All runs and jobs はすべての種類の行を表示します。Pipelines、CLI jobs、Latchkey on GH のいずれかを選ぶと、その種類だけを表示します。表示する種類はフィルターではありません: チップは付かず、Clear filters を押してもそのままです。
  • Runner はランナーサイズを選び、CLI ジョブと Latchkey on GH のジョブだけを表示します。
  • Repository と Pipeline はそれぞれ複数選択でき、Pipeline には、実行するワークフローファイルがなかった実行のための No pipeline があります。どちらを選んでも、どのリポジトリにも属さない CLI ジョブは除かれ、Pipeline を選ぶと Latchkey on GH のジョブも除かれます。
  • Branch はウィンドウ内の実行が対象としたブランチを選び、実行だけを表示します。
  • Triggered by は、実行を開始した People と、CLI ジョブを送った API keys を一覧します (ジョブのキーの名前がない場合は not recorded)。人を選ぶと実行だけが、キーを選ぶと CLI ジョブだけが表示されます。
  • Result は結果を 1 つ選びます: Failed、Passed、Running、Stopped、Cancelled、Timed out、Action needed、Not run、Out of date、No result のいずれかです。Running と Not run は実行だけを表示し、Stopped は Latchkey on GH のジョブを除きます。

行#

列表示内容
Result結果。自己修復が直して成功したものには、横に Healed が付きます。
Pipeline実行のパイプライン、その下にコマンドが付いた CLI job、または Latchkey on GH のジョブのワークフロー。Pro では、実行には Latchkey CI タグが付き、Latchkey on GH のジョブには自身のタグが付いてその下にジョブが表示され、実行の 2 行目には、失敗を説明する一文か、保留、置き換え、または停止されたことが表示されます。
RepositoryPro で、幅 1,280 px 以上かつジョブの詳細が開いていないときは列になります。それ以外では、リポジトリは名前の下に表示されます。
Runnerジョブのランナーサイズ。幅 1,280 px 以上で表示されます。
Cost請求された額。無料分でまかなわれた場合は free、請求が確定するまでは定価での so far の額です。
Commit、Ref、EventPro で、幅 1,920 px 以上かつジョブの詳細が開いていないときの、実行のコミット、そのブランチ、タグ、またはプルリクエスト、そして実行を開始したもの。
Started、Took開始した時刻と、かかった時間。

実行の行の末尾には、実行の状態に応じて最大 1 つのアクションがあります: 進行中は Cancel run です (先に確認があります)。成功せずに終わった後は、成功しなかったジョブのための Re-run です (Not run と表示されている場合とプリフライトの場合を除く)。保留中のフォークからのプルリクエストには Approve があり、コミットを承認するための実行ページを開きます。新しい実行に置き換えられた実行には Newer run、課金によって停止された実行には Open billing、ワークフローファイルが見つからなかった実行には Docs です。ジョブの詳細がテーブルの横にあるあいだ、行にはアクションが表示されません。

履歴のエクスポート#

タイトルバーの Export CSV と、履歴のツールにあるダウンロードアイコン (名前は Download CSV) は、同じファイルを保存します: 表示中のページだけでなく、ウィンドウ、フィルター、検索、並び順で残るすべての行で、ファイル名は対象の日付を示します (latchkey-history-2026-10-01-to-2026-10-31.csv)。列は Kind、Result、Pipeline or job、Repository、Runner、Cost (USD)、Cost so far (USD)、Commit、Ref、Event、Triggered by、Started (UTC)、Took (seconds)、Id です。1 つのファイルに入るのは最大 1,000 行で、すべての行が入らないときは、履歴にファイルに入る行数が表示されます ("The file holds the first 1,000 of 1,240 rows. Narrow the window or the filters to export the rest.")。

一覧の横のジョブの詳細#

実行の行または CLI ジョブの行を選ぶと、履歴の横にジョブが開きます: CLI ジョブならそのジョブ自身、実行なら最初に失敗したジョブ、それがなければ最も新しいジョブです。ジョブを 1 つも持たない実行では "No jobs" と表示されます。幅 1,280 px 以上ではテーブルの横に、それより狭いとテーブルの下に表示されます。Escape または閉じるコントロールで行に戻ります。

見出しには、CLI ジョブとその結果、または実行のパイプラインと実行の結果が表示され、表示しているジョブはその上のパンくずにあります。続いて This job: Result、Started、Took、Queue to start、実行のジョブの Cost、CLI ジョブの Command と Budget、そして Pro では Runner と Served by (warm、parked、cold start) です。その下には、ジョブの ID、最初のステップまでの時間、ログが続きます。フッターには、実行のジョブなら Open the run、ログ全体を読み込んだ後に Raw の表示どおりのログを <job id>.log として保存する Download log、そして Open job page があります。自身のコマンドが失敗したジョブでは、Hand to agent がコーディングエージェントに貼り付けるプロンプトを作ります。エージェントは Latchkey MCP サーバー を通じて失敗を読み取ります。

実行ページ#

実行のページ ("How this run was served, where its time went, and its jobs.") は、Open the run、ジョブページのパンくず、そしてコードホスト上の Latchkey のチェックから開きます。ヘッダーには結果、パイプライン (Pro ではそのワークフローファイルも)、ref、コミット、リポジトリがあり、続いて Triggered by、Event、手動実行の Inputs、Started、Took、Cost が Run id の上に並びます。実行に 2 回目の試行があると、ヘッダーはそれを数え ("Attempt 2 of 2")、以前の試行のページは、それが以前の試行であることを示します。

タイトルバーにはアクションが 1 つあります: 実行が成功せずに終わった後は Re-run jobs that did not pass (Not run と表示されている場合、プリフライトの場合、新しい実行に置き換えられた場合を除く)、進行中は Cancel run ("Cancel this run? Every job in it that has not finished is cancelled.")、保留中のフォークからのプルリクエストでは Approve this commit です。

Jobs は、実行のジョブをタイルとして、各ジョブが必要とするものに沿った列に、実行のチェックのあいだに描きます。あるジョブから別のジョブへの線は、後者が前者を必要とすることを意味します。タイルにはジョブの結果とその 1 行の説明が表示され、マトリクスのジョブのタイルはレグを結果ごとに数えます。タイルを押すと、そのジョブが専用のセクションに開きます。セクションの見出しにはジョブの名前と Open the job page があり、ジョブの情報、ジョブがサービスを開始した場合は Services、そしてログが続きます。マトリクスのジョブのセクションでは、見出しには代わりに Open the leg grid があり (マトリクスのジョブのタイルにもあります)、ジョブのレグが一覧されます。レグを 1 つ押すと、一覧の下にそのレグの情報、Services、ログが開き、その情報の上に Open the job page があります。

ジョブの上には、実行のジョブが指定する環境ごとに Approval for パネルがあります。実行が待っているあいだ、オーナーまたは管理者がそこで承認または却下します。その後、パネルには誰がいつ決めたか、またはその環境に承認が不要だったことが表示されます (ワークフローファイル を参照)。ジョブの下では、Artifacts が、その試行のジョブがアップロードしたものを、サイズ、アップロードしたジョブ、有効期限、Download とともに一覧します。

ジョブページ#

ジョブ自身のページ ("How this job was served, where its time went, and its log.") には、This job、ジョブがサービスを開始した場合は Services、そしてログがあり、実行のジョブはタイトルバーのパンくずからその実行に戻れます。タイトルバーには、自身のコマンドが失敗したジョブでは Hand to agent が、終わっていない CLI ジョブでは Cancel job があります ("Cancel this job? A cancelled job cannot be resumed.")。

レググリッド#

Open the leg grid は、マトリクスのジョブのレグを表示します ("The legs of this job and how each ended.")。ストリップには Legs、Failed、Median、Slowest が表示されます。グリッドは、Rows と Columns で選んだジョブの 2 つの軸の上に、レグを Chips または Dots として並べ (軸が 1 つのジョブには Rows だけがあります)、Chips では、Latchkey が遅いと判定したレグに三角のマークが付きます: "over 1.5x the median"。軸が 3 つのジョブでは、3 つ目の軸の値ごとに 1 つのグリッドを描きます。失敗したレグと、成功したレグのうち最も遅いものはグリッドの横にあり、それぞれから自身のページを開けます。失敗したレグのうち、自身のコマンドが失敗したものには Hand to agent があります。

ログ#

ジョブのログはステップごとに分かれ、それぞれにステータスがあります。どのステップにも属さない行は Outside the steps の下にあります。Search the log は語句を検索して一致箇所を順にたどり、Raw はログをプレーンテキストで表示し、ジョブの実行中は Follow で最新の行を表示し続けます。ログは 7 日間保持されます。Latchkey が修復したステップには Healed が付き、What Latchkey did と Open the heal があります。自己修復 を参照してください。

Q.01GitHub Actions の実行が Runs ページにないのはなぜですか?

このページには Latchkey が実行したものだけが並びます。Latchkey が自分のランナーで処理した GitHub Actions のジョブは、終わると History の Latchkey on GH 行になります。その GitHub の実行の残りの部分や、Latchkey が処理したジョブを 1 つも含まない実行は、ページに載りません。

Q.02コストに "so far" と表示されるのはなぜですか?

実行の請求が確定するまで、その Cost は各ジョブ自身の分数をそのサイズの定価で計算したもので、請求書の額ではありません。請求が確定するとそれに置き換わり、Spend in this window が数えるのは確定した請求だけです。使用した無料分は Runners ページ に表示されます。

Q.03ジョブや実行はどこでキャンセルしますか?

CLI ジョブは、そのジョブ自身のページで、タイトルバーの Cancel job でキャンセルします。実行は、History のその行か実行ページで Cancel run でキャンセルし、終わっていないその実行のジョブがすべてキャンセルされます。Running now はジョブのページを開くだけで、それ自体は何もキャンセルしません。