Menu da documentação
Primeiros passos
Painel e análises
- Painel em resumo
- Análise de custo
- Desempenho de pipeline
- Insights de otimização
- Knowledge Base
- Conecte seu agente de IA
Runners gerenciados
- Visão geral dos runners
- Execute seu primeiro job
- A página de Runners
- Runners personalizados (AI Scan)
- Autorreparo
- Imagem e software do runner
- Limites e concorrência
Cache
Equipe e notificações
Faturamento e planos
Ajuda
O painel em resumo
O layout do painel, cada destino da barra lateral, a barra de filtros global e os banners que informam o que o Latchkey está fazendo em segundo plano.

O painel tem três partes permanentes: a barra lateral (para onde você vai), a barra de filtros (quais dados você está vendo) e a própria página. Este guia cobre as três, além dos banners que o Latchkey usa para informar o que está acontecendo em segundo plano.
A barra lateral#
Todos os destinos em um só lugar. Entradas marcadas como admin só são visíveis para proprietários e administradores do workspace; todos os demais veem o restante.
Abaixo disso, a barra lateral traz links para esta documentação, um formulário de feedback e o suporte.
A barra de filtros#
Toda página de analytics compartilha uma barra de filtros no topo:
- Seletor de tipo de runner: All Runners, Latchkey Runners ou GitHub Runners.
- Multisseleções de Repositório e Workflow. O seletor de repositório adiciona busca, selecionar tudo e limpar tudo. As páginas de analytics mostram dados dos repositórios e workflows que você selecionar; se nada estiver selecionado, as páginas pedem que você escolha um repositório primeiro.
- Seletor de intervalo de datas com predefinições 7D, 30D, 90D, 1Y e YTD, além de um intervalo de calendário personalizado. A janela padrão é os últimos 14 dias. (A página Cost Analysis troca por predefinições voltadas para faturamento: MTD, 7D, 30D, 3M, 6M e 12M.)
- Redefinir filtros para voltar aos padrões em um clique.
- Configurações de exibição (ícone de engrenagem) com um botão "Show decimals" que alterna entre valores arredondados e precisos.
- Sino de notificações com seu histórico de notificações no aplicativo.
Como os filtros se combinam#
Todos os seletores restringem o mesmo conjunto de resultados: tipo de runner, repositório e workflow atuam em conjunto, e o intervalo de datas limita a janela sobre a qual tudo é calculado. Selecionar um repositório e um workflow, e depois estreitar o intervalo de datas, é a maneira padrão de isolar o comportamento de um único pipeline em um período específico. Como toda página de analytics compartilha a mesma barra, o escopo que você definir se aplica para onde quer que você navegue em seguida: o custo que você vê em Cost Analysis e as durações que você vê em Pipeline Performance descrevem a mesma fatia da sua CI.
Nenhum repositório selecionado
- As páginas de analytics não adivinham um escopo por você
- Você é solicitado a escolher um repositório primeiro
- Escolha um no seletor de Repositório para preencher a página
Repositórios selecionados
- As páginas mostram dados exatamente dos repositórios e workflows que você escolheu
- Restrinja ainda mais com o seletor de workflow e o intervalo de datas
- Redefinir filtros leva você de volta aos padrões em um clique
Se um repositório que você espera está ausente do seletor, o mais provável é que ele ainda não esteja monitorado. O monitoramento é gerenciado por proprietários e administradores no modal Monitoring; veja Gerenciando repositórios.
Gráficos em tela cheia e atualização ao vivo#
Dois comportamentos que vale conhecer sobre os dados na tela. Todo gráfico se expande em uma visualização em tela cheia com a barra de filtros ainda disponível, para que você possa fatiar e apresentar na mesma visualização sem perder seu escopo. E a página atualiza automaticamente, encurtando seu intervalo de atualização enquanto qualquer workflow está em andamento: durante execuções ativas de CI, os resultados chegam quase em tempo real sem recarregamento manual.
Banners que vale conhecer#
- Progresso do backfill: aparece enquanto os dados históricos de um repositório recém-habilitado estão sendo importados.
- Processamento de IA: aparece na página Insights enquanto o agente de otimização está analisando.
- Aviso de plano gratuito: aparece quando você usou 80% (e novamente aos 100%) dos seus minutos de runner incluídos.
- Avisos de teste: uma contagem regressiva quando seu teste está terminando, e um prompt em tela cheia para assinar assim que ele termina.
Nenhum deles exige ação para manter o painel funcionando; são o Latchkey narrando seu próprio trabalho em segundo plano. Cada um tem um próximo passo natural quando você quer mais detalhes:
| Banner | O que ele informa | Para onde ir em seguida |
|---|---|---|
| Progresso do backfill | Execuções históricas de um repositório recém-habilitado ainda estão sendo importadas | Gerenciando repositórios explica o que o backfill abrange |
| Processamento de IA | O agente de otimização está analisando seus workflows agora mesmo | Optimization insights é onde os resultados chegam |
| Aviso de plano gratuito | Você usou 80% (depois 100%) dos seus minutos de runner incluídos | Uso de runners e minutos gratuitos |
| Avisos de teste | Seu teste está terminando, ou já terminou | Planos e teste |
Command & Control (Visão Geral)#
A página de Visão Geral condensa as três áreas de analytics em uma só tela, e cada seção tem link para sua página de detalhes:
- Optimization Insights: um selo de saúde (GOOD, WARNING ou CRITICAL) com contagens de recomendações de prioridade alta, média e baixa, além da economia mensal potencial. Quando não há nada em aberto, o cartão mostra um estado "You're all caught up", e novas recomendações surgem conforme seus workflows executam.
- Pipeline Performance: medidor de saúde de workflows, repositórios e workflows monitorados, tempo médio de recuperação (MTTR) e um resumo de total de execuções, duração média, taxa de falha, taxa de cancelamento e taxa de sucesso de rebuild.
- Cost Analysis: custo teórico com tendência semana a semana, seus três principais repositórios por gasto (cada um com link para o GitHub), custo faturável ao longo do tempo com uma extensão de previsão pontilhada, e acompanhamento de minutos do plano gratuito tanto para runners do GitHub quanto do Latchkey.
Lendo a Visão Geral em 60 segundos#
A Visão Geral foi feita para ser escaneada, não estudada. Eis uma forma de tornar uma passagem rápida um hábito; a ordem é uma sugestão, não um requisito do produto:
Confira o selo de saúde
GOOD, WARNING ou CRITICAL define o tom de toda a passagem. Se não for GOOD, anote a contagem de recomendações de prioridade alta; é nisso que você vai se aprofundar depois na página de Insights.
Examine o resumo de desempenho
Olhe para o medidor de saúde de workflows, o MTTR e a taxa de falha. Você não está procurando números absolutos; está procurando movimento em relação ao que é normal para sua equipe. Qualquer coisa surpreendente, siga o link da seção para Pipeline Performance.
Leia a tendência de custo
A tendência semana a semana do custo teórico é seu sinal mais rápido de "o gasto está desviando?". Dê uma olhada nos repositórios de maior gasto em busca de algo inesperado no topo; a história completa fica em Cost Analysis.
Dê uma olhada no acompanhamento do plano gratuito
A Visão Geral acompanha os minutos do plano gratuito tanto para runners do GitHub quanto do Latchkey. Se algum estiver esquentando, você também receberá um banner aos 80%, mas perceber cedo aqui é mais barato do que reagir depois.
Clique na única seção que mudou
Cada seção da Visão Geral tem link para sua página completa. Uma disciplina útil: escolha a única seção que mais mudou desde a sua última olhada e aprofunde-se nela, em vez de passar os olhos por todas as três.