Pular para o conteúdo
Latchkey
Menu da documentação

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.

A página de visão geral do Command & Control
Command & Control: saúde dos insights, desempenho de pipeline e custo em uma só tela.

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:

BannerO que ele informaPara onde ir em seguida
Progresso do backfillExecuções históricas de um repositório recém-habilitado ainda estão sendo importadasGerenciando repositórios explica o que o backfill abrange
Processamento de IAO agente de otimização está analisando seus workflows agora mesmoOptimization insights é onde os resultados chegam
Aviso de plano gratuitoVocê usou 80% (depois 100%) dos seus minutos de runner incluídosUso de runners e minutos gratuitos
Avisos de testeSeu teste está terminando, ou já terminouPlanos 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.