Menu da documentação
Painel e análises
Runners gerenciados
Equipe e notificações
Faturamento e planos
Arquivos de workflow
Análise de custo
Veja quanto custam seus minutos de runner do Latchkey conforme a fatura os cobra, acompanhe seus minutos gratuitos e encontre os repositórios que mais gastam.
Resumo
- Spend é o que a fatura cobra pelos minutos de runner nas datas selecionadas; minutos cobertos por uma cota gratuita não são cobrados.
- Highest Spend e Repository Costs encontram os repositórios que mais custam; Free Tier Minutes Tracking acompanha os minutos do seu plano Latchkey.
- A linha CLI Jobs reúne os jobs iniciados pelo Latchkey CLI ou pela ferramenta MCP run_job, que não pertencem a nenhum repositório.
- A pilha de KPIs do Latchkey e o Free Tier Minutes Tracking sempre refletem o mês civil atual, independentemente do filtro de datas.
A página Cost Analysis responde "para onde vai o nosso dinheiro de CI?" para os jobs que rodaram em runners do Latchkey.
A página é organizada em três seções: Cost Overview (os KPIs principais), Cost Analysis (os gráficos em que você se aprofunda) e Latchkey Runner Costs (quanto custou cada configuração dos seus runners gerenciados). Antes que qualquer coisa disso seja útil, porém, você precisa saber o que o número principal conta.
O que o Spend conta#
Spend é o que a fatura cobra pelos minutos de runner nas datas selecionadas, ao preço de cada tamanho de runner. Minutos cobertos por uma cota gratuita não são cobrados, então um workspace dentro da sua cota mostra $0 enquanto seus jobs continuam rodando. Todos os números de custo da página são lidos dos seus registros de faturamento do Latchkey.
Seção Cost Overview#
- Spend com um selo de tendência semana a semana. O selo compara o Spend dos últimos 7 dias com execuções com os 7 anteriores. Ele mostra um traço até o intervalo conter 14 dias com execuções, e sempre que esses 7 dias anteriores não custaram nada.
- Highest Spend: seus 3 principais repositórios por Spend nas datas selecionadas. Só aparecem repositórios que foram cobrados; quando nenhum foi, o cartão mostra "No repository was charged in the selected dates."
- Pilha de KPIs do Latchkey, rotulada "This calendar month": custo estimado neste mês civil mais os minutos gratuitos em equivalente small restantes e usados neste período. Quando o uso de runners não carrega, cada cartão mostra "Unavailable" em vez de um número.
- Free Tier Minutes Tracking: um medidor segmentado dos minutos em equivalente small que seu plano Latchkey inclui, com o limite refletindo a cota do seu próprio plano. Quando o uso de runners não carrega, o medidor não é desenhado e o cartão mostra "Unavailable" com "runner usage did not load".
Seção Cost Analysis#
- Cost Over Time: Spend por dia ao longo do intervalo de datas selecionado.
- Repository Costs: Spend por repositório, com um menu Top 5 / Bottom 5. Os nomes dos repositórios levam direto ao GitHub, então você vai de um pico de custo aos arquivos de workflow por trás dele em um clique.
Uma dica de leitura para esta seção: em Cost Over Time, um trecho em $0 é um trecho que seus minutos gratuitos cobriram; a linha começa a subir quando eles acabam.
Seção Latchkey Runner Costs#
Se você executa jobs em runners gerenciados, esta seção aparece com uma tabela de custo por configuração: Config Name (com o rótulo de runner que você usa nos arquivos de workflow, como latchkey-small), um selo de tipo Custom or Preset, Jobs, Avg Duration e Cost, os minutos de cada configuração ao preço de tabela no período selecionado, antes dos minutos gratuitos. Quando minutos gratuitos foram usados, um rodapé mostra "Free tier applied: X / Y small-equivalent min" e "Saved $Z", o que esses minutos gratuitos teriam custado, então os números da tabela podem somar mais do que o Spend. A pilha de KPIs do Latchkey e o Free Tier Minutes Tracking em Cost Overview sempre refletem o mês civil atual, independentemente do filtro de intervalo de datas.
Linha CLI Jobs#
Se sua equipe executa jobs avulsos pelo Latchkey CLI ou pela ferramenta MCP run_job, esse gasto aparece como uma linha própria, CLI Jobs, com o gasto e a contagem de jobs do período. Esses jobs não pertencem a nenhum repositório nem a nenhum workflow, então esta linha é o dinheiro que o detalhamento por repositório não consegue posicionar; eles são contados no Spend. A linha fica oculta enquanto um filtro de repositório ou de workflow está ativo e desaparece por completo em períodos sem jobs de CLI.
Filtros nesta página#
Os filtros compartilhados são exibidos apenas no Command & Control. Todos os números desta página são de runners do Latchkey. Show decimals, em Display no menu Account and help, alterna os valores em dólar entre precisão de centavos e dólares inteiros arredondados. As exceções ao filtro de datas: a pilha de KPIs do Latchkey e o Free Tier Minutes Tracking sempre refletem o mês civil atual.
Qual gráfico responde qual pergunta#
| Você quer saber | Olhe para |
|---|---|
| O gasto de CI está subindo ou caindo? | Spend e seu selo de tendência semana a semana |
| Quais repositórios custam mais? | Highest Spend, depois Repository Costs com a alternância Top/Bottom |
| Quando exatamente o pico aconteceu? | Cost Over Time, com o intervalo de datas estreitado em torno dele |
| Como a fatura vai ficar? | A pilha de KPIs do Latchkey (custo estimado neste mês civil) |
| Quão perto estamos de esgotar os minutos gratuitos? | O medidor de Free Tier Minutes Tracking |
| Quanto cada tamanho de runner está nos custando? | A tabela por configuração em Latchkey Runner Costs |
| Quanto custaram nossos jobs avulsos de CLI e de agentes? | A linha CLI Jobs |
Usando esta página para de fato cortar custo#
Uma rotina sugerida quando o gasto precisa cair. Nada aqui é imposto pelo produto; é simplesmente a ordem em que os gráficos respondem às perguntas uns dos outros:
Estabeleça a tendência
Comece com Spend e seu selo semana a semana. Se a tendência estiver estável, você está otimizando uma conta estável; se estiver subindo, você está perseguindo uma mudança, e o resto da passagem é sobre descobrir quando e onde.
Encontre a concentração
Abra Highest Spend e Repository Costs. O gasto de CI costuma ser concentrado: um pequeno número de repositórios tende a carregar a maior parte da conta, então o esforço gasto no topo deste gráfico compensa muito mais do que em qualquer outro lugar.
Isole o pipeline
Use os filtros de repositório e workflow para dar zoom em um candidato, e leia Cost Over Time para o intervalo selecionado. Isso geralmente identifica o dia em que um pico começou e o workflow responsável.
Aja sobre isso
Confira o AI Insight: a análise noturna revela descobertas de custo quantificadas, cada uma com uma ação que o Latchkey pode executar por você (reduzir um runner superdimensionado, adicionar caching), aplicada como um pull request que você aprova. Se o problema for esgotamento do plano gratuito em vez de desperdício, veja Uso de runners e minutos gratuitos e Gerenciando o faturamento.
Referência de métricas#
| Métrica | O que ela informa |
|---|---|
| Spend | O que a fatura cobra pelos minutos de runner nas datas selecionadas, ao preço de cada tamanho de runner; minutos cobertos por uma cota gratuita não são cobrados |
| Week over Week | Variação percentual do Spend, últimos 7 dias com execuções vs os 7 anteriores; um traço até o intervalo conter 14 dias com execuções, ou enquanto esses 7 dias anteriores não custaram nada |
| Highest Spend | Seus 3 principais repositórios por Spend nas datas selecionadas; só aparecem repositórios que foram cobrados |
| Free Tier Minutes Tracking | Medidor "X / Y small-equivalent minutes used" do seu plano Latchkey |
| Cost Over Time | Spend por dia ao longo das datas selecionadas |
| Free tier applied: X / Y min | Minutos gratuitos do Latchkey aplicados contra os minutos incluídos do seu plano, e seu valor em dólares, no rodapé da tabela de custos de runner |
| CLI Jobs | Gasto e contagem de jobs iniciados pelo Latchkey CLI ou pela ferramenta MCP run_job; não pertencem a nenhum repositório, então aparecem aqui e dentro do Spend, não no detalhamento por repositório |
Para modelar o gasto antes que ele apareça nesta página - um novo repo, um runner maior, mais jobs - use a calculadora de custo do GitHub Actions no Learn, ou navegue pelos guias de custo de CI para a mecânica de preços entre provedores.
Por que a pilha de KPIs do Latchkey e o Free Tier Minutes Tracking ignoram meu filtro de datas?
A pilha de KPIs do Latchkey e o Free Tier Minutes Tracking sempre refletem o mês civil atual, seja qual for o intervalo do filtro. Eles respondem quanto você deve e quanto resta neste mês, que é uma pergunta de mês civil e não de intervalo de datas. Os outros gráficos da página seguem o filtro.