Gerenciando repositórios

Habilite ou desabilite o monitoramento por repositório, entenda os limites de plano, escolha o branch que a IA analisa e saiba o que o backfill histórico cobre.

O Latchkey só ingere dados de repositórios que você habilita explicitamente. Você os escolhe durante o onboarding, e pode alterá-los a qualquer momento pelo dashboard. Habilitar é também o que torna um repositório elegível para runners gerenciados: os runners gerenciados só atendem repositórios monitorados.

O modal de Monitoramento#

Na barra lateral do dashboard, clique em Monitoring (visível para owners e admins do workspace) para abrir Gerenciar Monitoramento de Repositório. O cabeçalho mostra quantos repositórios você está usando em relação ao limite do seu plano. Cada repositório tem uma alternância; as alterações são enfileiradas como "alterações pendentes" e aplicadas juntas quando você clica em Salvar Alterações.

• Buscar e rolar: a lista busca sua organização ao vivo e carrega mais conforme você rola.
• Seletor de branch: cada repositório monitorado mostra um seletor de branch que define o branch que a IA do Latchkey analisa para otimizações de workflow (o padrão é o branch padrão do repositório). Workflows que existem apenas em outros branches não são analisados.
• Permissões: habilitar e desabilitar o monitoramento requer uma função de owner ou admin.

Limites de plano#

No seu limite, alternâncias adicionais são bloqueadas e o modal indica que você faça upgrade. No Developer, o único repositório monitorado não pode ser trocado pelo modal; fazer upgrade para Launch ou Scale desbloqueia isso.

Escolhendo repositórios dentro de um limite#

Quando você tem mais repositórios do que vagas, trate o limite como uma questão de priorização:

• Tudo que você quer em runners gerenciados precisa ser monitorado. Jobs que miram labels latchkey-* de um repositório não monitorado nunca são pegos; eles permanecem na fila no GitHub. Se a adoção de runners é o objetivo, esses repositórios vêm primeiro.
• Repositórios de alta atividade dão ao analytics o máximo com que trabalhar. Os dashboards e as recomendações da IA são construídos a partir das suas execuções de workflow, então um repositório que roda CI muitas vezes por dia produz muito mais sinal do que um que faz build semanalmente.
• Um pipeline cronicamente falho é um forte candidato. Falhas consecutivas repetidas disparam análises de diagnóstico, então o repositório instável costuma ser onde a IA prova seu valor primeiro. Veja Insights de otimização.
• No Developer, escolha deliberadamente. O único repositório monitorado não pode ser trocado pelo modal, então escolha o repositório cujo CI você mais quer entender; fazer upgrade para Launch ou Scale desbloqueia a troca.

O que acontece quando você habilita um repositório#

Banners de progresso aparecem no dashboard enquanto o backfill e a primeira análise de IA rodam, então você sempre sabe o que ainda está aquecendo.

O que o backfill cobre e o que não cobre#

O backfill existe para tornar o dashboard útil no primeiro dia, em vez de após uma semana de coleta. Ele importa execuções concluídas recentes dos últimos 30 dias, o que é suficiente para semear as páginas de custo, desempenho e insights com números reais; a maioria dos times vê dados em poucos minutos. Duas expectativas que vale definir: é uma amostra, não uma importação de histórico completo, e ele só pode importar o que existe. Um repositório sem execuções de workflow nos últimos 30 dias não faz backfill de nada, e suas páginas permanecem vazias até que novas execuções aconteçam. O filtro de intervalo de datas do dashboard também precisa se sobrepor à atividade, então se uma página parecer vazia logo após o backfill, amplie o intervalo antes de assumir que algo está errado.

O que acontece quando você desabilita um repositório#

Desabilitar interrompe a ingestão daquele repositório imediatamente e libera a vaga em relação ao limite do seu plano. Seus dados históricos são arquivados em vez de mostrados no dashboard. Como os runners gerenciados só atendem repositórios monitorados, jobs naquele repositório que miram labels latchkey-* ficarão na fila em vez de rodar até que ele seja reabilitado. Reabilitar depois inicia um novo backfill.

Perguntas comuns#