# 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.

Source: https://latchkey.dev/pt/documentation/dashboard-overview

## Summary

- A Visão Geral abre com o **AI Insight**: o que a autocorreção corrigiu nos últimos 30 dias e as descobertas prontas para sua aprovação.
- A barra lateral cobre analytics, runners, insights, equipe, faturamento e configurações; itens exclusivos de admin são marcados.
- Uma única **barra de filtros** compartilhada (tipo de runner, repositório, workflow, intervalo de datas) delimita o escopo de cada página de analytics.
- Os dados são atualizados automaticamente, e mais rápido enquanto os workflows executam; os gráficos se expandem em tela cheia com os filtros intactos.
- Os banners narram o trabalho em segundo plano: progresso do backfill, avisos de plano gratuito e avisos de teste.

> **Apenas desktop**
> O painel foi projetado para navegadores desktop. Celulares e tablets veem um aviso de bloqueio após o login.

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.

- **Command & Control** A página de Visão Geral: AI Insight, desempenho e custo em resumo, cada seção com link para sua página completa.
- **Latchkey Runners** Sua frota de runners gerenciados: configurações, uso e o feed de atividades de autocorreção.
- **Optimization Insights** Descobertas quantificadas da análise noturna, cada uma com uma ação para aprovar. A própria página se chama "AI Insight".
- **Pipeline Performance** Durações de build, taxas de sucesso, falhas e métricas de recuperação.
- **Cost Analysis** Custo teórico vs. faturável, detalhamento por repositório, acompanhamento do plano gratuito.
- **Knowledge Base** Envie runbooks e documentação para embasar as recomendações de IA.
- **Migrate Runners** Movimentação guiada em massa de workflows para os runners do Latchkey; abre um modal.
- **Monitoring** Abre o modal Manage Repository Monitoring.
- **Team** Membros, papéis, convites e assentos.
- **Billing** Plano, assentos, uso de runners e o portal Stripe; abre o modal Billing & Subscription.
- **Settings** Notificações, modo de autocorreção, chaves de API, conta.

Abaixo disso, a barra lateral traz links para esta documentação, um formulário Send Feedback (um modal) e o suporte.

> **Primeira visita**
> Após a configuração inicial, um tour passo a passo percorre todo o painel: Command & Control, a barra de filtros, runners, autocorreção, AI Insight, desempenho, custo, a Knowledge Base, migração, monitoramento e onde ficam a documentação e o suporte. Você pode pular a qualquer momento.

## 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](/documentation/cost-analysis) e as durações que você vê em [Pipeline Performance](/documentation/pipeline-performance) descrevem a mesma fatia da sua CI.

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](/documentation/managing-repositories).

### 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:

| 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](/documentation/managing-repositories) explica o que o backfill abrange |
| Aviso de plano gratuito | Você usou 80% (depois 100%) dos seus minutos de runner incluídos | [Uso de runners e minutos gratuitos](/documentation/runner-usage-and-free-minutes) |
| Avisos de teste | Seu teste está terminando, ou já terminou | [Planos e teste](/documentation/plans-and-trial) |

## 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:

1. **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](/documentation/optimization-insights).
2. **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.
3. **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](/documentation/pipeline-performance).
4. **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](/documentation/cost-analysis).
5. **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.

### A que se aplica a barra de filtros do painel?

Uma única barra de filtros (tipo de runner, repositório, workflow e intervalo de datas) delimita todas as páginas de analytics ao mesmo tempo, então um filtro definido em uma página continua valendo quando você muda para outra. Gráficos abertos em tela cheia mantêm os mesmos filtros.

### Com que frequência os dados do painel são atualizados?

Automaticamente, e mais rápido enquanto há workflows em execução, então não é preciso recarregar durante um build. Se uma página parecer vazia, normalmente é a barra de filtros ou uma importação ainda em andamento, não dados perdidos.

### O que são os banners no topo do painel?

Eles narram trabalho em segundo plano, não erros: progresso da importação do histórico, avisos de cota gratuita conforme você se aproxima do limite mensal de minutos e avisos de teste. Todo estado bloqueado tem um sinal explícito, então um painel silencioso não é um painel bloqueado.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt