A página Runs: execuções, jobs e logs

A página Runs fica na barra lateral do dashboard. Ela tem dois painéis, Running now e History, e a partir das linhas deles leva ao detalhe de um job ao lado da lista, à página de uma execução e à página de um job.

Cada linha é algo que o Latchkey executou, lido dos próprios registros dele. Um job do GitHub Actions só aparece na página quando o Latchkey o atendeu nos runners dele: ele é uma linha Latchkey on GH para aquele job, nunca a execução do GitHub da qual ele faz parte, e não abre nada, porque o Latchkey não tem uma página própria para ele.

A barra de título#

• Export CSV salva o histórico como você o restringiu, em um arquivo CSV (veja Exportar o histórico, abaixo).
• Run workflow inicia manualmente um arquivo de workflow do Latchkey CI, um que declare on: workflow_dispatch: você escolhe o repositório, o arquivo de workflow, a branch ou tag e as entradas dele.
• Run a job abre um painel com os comandos para instalar o Latchkey CLI, entrar com uma chave que possa executar jobs e executar um.
• No Easy, Filters abre os filtros do histórico em um popover. O Pro os mostra como uma linha acima de Running now.

Running now#

Running now, marcado Live, lista todo job do workspace que está rodando, iniciando ou retido agora, tanto os jobs de execuções de pipeline quanto os jobs da CLI, e o seu cabeçalho conta os jobs que lista. Quando não lista nenhum, mostra "No pipeline or CLI job is running now." A linha acima dos jobs traz:

• Runners at once: os runners em uso em relação ao seu limite ("Runners at once: 3 of 40 in use"), depois quantos deles ainda estão iniciando e quantos rodam jobs do Latchkey on GH, quando há algum.
• warm e parked: os runners de prontidão do próprio workspace, um runner warm contado até terminar o único job que ele pega; held: os jobs ainda na fila por um runner, como no limite de runners simultâneos do workspace ou no limite de gastos dele.
• A taxa de gasto, pelo preço de tabela, dos jobs iniciados nos seus runners e dos cold starts ainda inicializando, incluindo os jobs do Latchkey on GH, em dólares por hora.

Abaixo dela, cada job é uma linha em um único eixo de tempo: um ponto e o seu rótulo (o pipeline e o job de uma execução, ou CLI job e o seu comando), um chip Starting ou Held enquanto ele espera, e uma barra desde quando ele entrou na fila: queued até ser entregue a um runner, starting até começar, depois running. A legenda indica queued e running, e starting sempre que uma barra o desenha. Um job retido também ganha uma linha sob o eixo com o motivo da espera, quando o Latchkey nomeia um.

Cada linha abre a página do próprio job. Nada é cancelado a partir de Running now: um job da CLI é cancelado na própria página, e uma execução na sua linha em History ou na própria página. View fleet abre a página de Runners. Passando de 100 jobs, o painel mostra os 100 primeiros e avisa isso.

History#

History lista as execuções na janela e os jobs que terminaram nela, uma linha cada, os mais recentes primeiro; clique em Started para inverter a ordem. O painel mostra 25 linhas por página, com o intervalo sob a tabela ("1 to 25 of 140 runs and jobs"). A janela fica nas ferramentas do histórico: 7d, 30d (o padrão) e 90d, além de 1d e Custom no Pro, onde Custom escolhe um início e o seu horário até 90 dias atrás.

Ao lado da janela, o campo de busca ("Pipeline, job, sha or ref") restringe as linhas, e Spend in this window é o que foi cobrado na janela inteira, quaisquer que sejam os filtros ou a página na tela. Sob a tabela, By key e By batch dividem esse gasto pela chave de API e pelo lote que enviou o trabalho: os três maiores pelo nome, o restante contado em uma linha.

Filtros#

No Pro, os filtros ficam em uma linha acima de Running now, um chip para cada um definido, com Clear filters no fim; no Easy, eles abrem a partir de Filters na barra de título. O Latchkey os aplica à janela inteira, então toda página do histórico é restringida, não só a que está na tela.

• All runs and jobs mostra todo tipo de linha; escolha Pipelines, CLI jobs ou Latchkey on GH para mostrar um tipo. O tipo mostrado não é um filtro: não ganha chip, e Clear filters o mantém.
• Runner escolhe um tamanho de runner e mostra só jobs da CLI e jobs do Latchkey on GH.
• Repository e Pipeline aceitam várias escolhas cada, e Pipeline oferece No pipeline para execuções sem arquivo de workflow para rodar. Qualquer um dos dois deixa de fora os jobs da CLI, que não pertencem a nenhum repositório, e uma escolha em Pipeline deixa de fora também os jobs do Latchkey on GH.
• Branch escolhe uma branch das execuções da janela, e mostra só execuções.
• Triggered by lista as People que iniciaram execuções e as API keys que enviaram jobs da CLI (not recorded quando a chave de um job não é nomeada). Uma pessoa mostra só execuções, e uma chave só jobs da CLI.
• Result escolhe um resultado: Failed, Passed, Running, Stopped, Cancelled, Timed out, Action needed, Not run, Out of date ou No result. Running e Not run mostram só execuções, e Stopped deixa de fora os jobs do Latchkey on GH.

Linhas#

A linha de uma execução termina com no máximo uma ação, conforme o estado da execução: Cancel run enquanto ela está em andamento, que pede confirmação antes; Re-run, para os jobs que não passaram, quando ela terminou sem passar, a menos que mostre Not run ou seja um preflight; Approve em um pull request retido vindo de um fork, que abre a página da execução para aprovar o commit; Newer run em uma execução que uma mais nova substituiu; Open billing em uma execução que o faturamento interrompeu; e Docs em uma execução que não encontrou arquivo de workflow. Enquanto um detalhe de job fica ao lado da tabela, as linhas não mostram ação.

Exportar o histórico#

Export CSV na barra de título e o ícone de download nas ferramentas do histórico (chamado Download CSV) salvam o mesmo arquivo: as linhas que a janela, os filtros, a busca e a ordem mantêm, não só a página na tela, com o nome dos dias que ele cobre (latchkey-history-2026-10-01-to-2026-10-31.csv). As colunas são Kind, Result, Pipeline or job, Repository, Runner, Cost (USD), Cost so far (USD), Commit, Ref, Event, Triggered by, Started (UTC), Took (seconds) e Id. Um arquivo guarda no máximo 1.000 linhas; quando não cabem todas, o histórico diz quantas ele guarda ("The file holds the first 1,000 of 1,240 rows. Narrow the window or the filters to export the rest.").

O detalhe do job ao lado da lista#

Escolha a linha de uma execução ou de um job da CLI e um job abre ao lado do histórico: o próprio job da CLI, ou o primeiro job com falha de uma execução, ou, se não houver, o mais recente; uma execução sem nenhum job diz "No jobs". A partir de 1.280 px de largura ele fica ao lado da tabela, e abaixo disso, sob ela. Escape ou o controle de fechar leva você de volta à linha.

O cabeçalho nomeia um job da CLI e o seu resultado, ou o pipeline de uma execução e o resultado da execução, com o job que ele mostra na trilha acima. Depois vem This job: Result, Started, Took e Queue to start, o Cost de um job de execução, o Command e o Budget de um job da CLI e, no Pro, o Runner e Served by (warm, parked ou cold start). Abaixo deles vêm os ids do job, o tempo antes do primeiro passo e o log. O rodapé traz Open the run para o job de uma execução, Download log, que salva o log como Raw o mostra depois que o log inteiro é lido, como <job id>.log, e Open job page. Em um job cujo próprio comando falhou, Hand to agent monta um prompt para colar no seu agente de código, que lê a falha pelo servidor MCP do Latchkey.

A página da execução#

A página de uma execução ("How this run was served, where its time went, and its jobs.") abre a partir de Open the run, da trilha da página de um job e dos checks do Latchkey no seu host de código. O cabeçalho traz o resultado, o pipeline (no Pro, com o arquivo de workflow), o ref, o commit e o repositório, depois Triggered by, Event, os Inputs de uma execução manual, Started, Took e Cost, sobre o Run id. Quando uma execução tem uma segunda tentativa, o cabeçalho a conta ("Attempt 2 of 2"), e a página de uma tentativa anterior diz que é uma tentativa anterior.

A barra de título traz uma ação: Re-run jobs that did not pass quando a execução terminou sem passar, a menos que mostre Not run, seja um preflight ou uma execução mais nova a tenha substituído, Cancel run enquanto ela está em andamento ("Cancel this run? Every job in it that has not finished is cancelled.") ou Approve this commit em um pull request retido vindo de um fork.

Jobs desenha os jobs da execução como blocos, em colunas pelo que cada um precisa, entre os checks da execução; uma linha de um job a outro significa que o segundo precisa do primeiro. Um bloco dá o resultado do job e a sua linha de texto, e o bloco de um job de matriz conta as pernas por resultado. Clique em um bloco para abrir o job em uma seção própria, encabeçada pelo nome dele e por Open the job page, com os dados dele, Services quando o job iniciou serviços, e o log. A seção de um job de matriz é encabeçada, em vez disso, por Open the leg grid, que o bloco do job de matriz também traz, e lista as pernas do job; clique em uma para abrir os dados, os Services e o log dessa perna abaixo da lista, com Open the job page sobre os dados dela.

Acima dos jobs, cada ambiente que os jobs da execução nomeiam ganha um painel Approval for. Enquanto a execução espera, um owner ou admin a aprova ou rejeita ali; depois, o painel diz quem decidiu e quando, ou que o ambiente não precisava de aprovação (veja Arquivos de workflow). Abaixo dos jobs, Artifacts lista o que os jobs da tentativa enviaram, cada um com o seu tamanho, o job que o enviou, quando expira e Download.

A página do job#

A página própria de um job ("How this job was served, where its time went, and its log.") traz This job, Services quando o job iniciou serviços, e o log, e o job de uma execução leva de volta à execução pela trilha na barra de título. A barra de título traz Hand to agent em um job cujo próprio comando falhou, e Cancel job em um job da CLI que não terminou ("Cancel this job? A cancelled job cannot be resumed.").

A grade de pernas#

Open the leg grid mostra as pernas de um job de matriz ("The legs of this job and how each ended."). Uma faixa dá Legs, Failed, Median e Slowest. A grade dispõe as pernas em dois dos eixos do job, escolhidos em Rows e Columns (um job de um só eixo tem apenas Rows), como Chips ou Dots, e em Chips uma perna que o Latchkey marca como lenta traz um triângulo: "over 1.5x the median". Um job de três eixos desenha uma grade para cada valor do terceiro. As pernas com falha e a mais lenta das pernas que passaram ficam ao lado da grade, cada uma com o caminho para a sua própria página, e uma perna com falha cujo próprio comando falhou oferece Hand to agent.

O log#

O log de um job é dividido pelos seus passos, cada um com o seu status, e as linhas fora de todo passo ficam sob Outside the steps. Search the log encontra um termo e percorre as ocorrências, Raw mostra o log como texto simples e, enquanto o job roda, Follow mantém a linha mais recente à vista. Os logs são guardados por 7 dias. Um passo que o Latchkey reparou traz Healed, com What Latchkey did e Open the heal; veja Autorreparo.