Pular para o conteúdo
Latchkey
Comece grátis
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: o hero do AI Insight e as principais descobertas, com o Pipeline Performance abaixo.

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.

O modal Migrate Runners
O Migrate Runners abre um modal guiado (proprietários e administradores) para mover workflows em massa para os runners do Latchkey.

Abaixo disso, a barra lateral traz links para esta documentação, um formulário Send Feedback (um modal) 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, e toda página de analytics compartilha o mesmo seletor.
  • 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.
  • 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
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 Visão Geral abre com o que o Latchkey fez por você e o que está aguardando sua decisão, e então comprime desempenho e custo logo abaixo. Três seções, de cima para baixo, cada uma com link para sua página completa:

  • AI Insight (link "View AI Insight"): o cabeçalho diz "See what self-heal fixed automatically and the savings ready to apply." Um hero dividido mostra Self-heal, last 30 days à esquerda, a contagem de falhas reparadas no runner com um selo Autonomous, e Insight, ready to apply à direita, a contagem de descobertas prontas para aplicar, com pontos de pilar para segurança, confiabilidade, adoção e custo e um selo de descobertas em aberto. Abaixo do hero, as três principais descobertas em aberto aparecem como cartões com suas ações: Preview, uma aplicação em um clique como Pin to SHA, Dismiss ou Investigate. Quando não há nada em aberto, a seção diz "You are all caught up."
  • Pipeline Performance (link "View Performance"): Workflow Health como um medidor com a legenda "Successful Workflow Deployments", contagens de Repositories Monitored e Workflows Monitored, Mean Time to Recovery (MTTR), um Workflow Health Summary (Total Runs, Average Duration, Fail Rate, Cancel Rate, Rebuild Success Rate) e Failed Deployments com a contagem de execuções com falha e o workflow que mais falha, ou "No failures detected" quando não há nenhuma.
  • Cost Analysis (link "View Cost Analysis"): Theoretical Cost com um selo semana a semana, Highest Spend (Theoretical) com os principais repositórios com link para o GitHub, uma pilha de KPI do GitHub (custo faturável previsto até o fim do ciclo, ou "Not enough data yet - run more jobs for a forecast", mais os minutos do plano gratuito restantes e usados neste ciclo), Total Billable Cost Over Time com uma extensão de previsão pontilhada e uma pilha de KPI do Latchkey rotulada "Current billing period".

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:

Leia o hero do AI Insight

Dois números definem o tom. O número da esquerda é o que a autocorreção já corrigiu por conta própria; ele não precisa de nada de você. O número da direita são as descobertas aguardando sua aprovação; se não for zero, essa é sua primeira parada. A fila completa fica em AI Insight.

Resolva o que puder ali mesmo

As três principais descobertas em aberto ficam logo abaixo do hero, com sua única ação no cartão. Preview mostra a mudança exata antes de você aplicar; Dismiss limpa o que não se aplica a você. Um minuto aqui muitas vezes esvazia a fila sem sair da Visão Geral.

Examine os cartões de desempenho

Olhe para o medidor de Workflow Health, o MTTR e a taxa de falha no Workflow Health Summary. 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

O selo semana a semana no Theoretical Cost é seu sinal mais rápido de "o gasto está desviando?". Dê uma olhada nos repositórios de maior gasto e no custo faturável previsto para o ciclo; os minutos do plano gratuito são acompanhados nas mesmas pilhas, e um banner também avisará você aos 80%. A história completa fica em Cost Analysis.

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.

References