Performance Agent

O Performance Agent analisa o código-fonte e os logs do seu projeto para encontrar problemas concretos e corrigíveis que deixam seu app lento. Cada descoberta vem com um resumo em linguagem simples, uma severidade e uma correção recomendada que o Agent pode aplicar para você.

O que o Performance Agent encontra

O Performance Agent procura dois tipos de problemas. Cada tipo aparece como um grupo separado nos resultados.

Latency: partes do seu app que fazem os visitantes esperar. Por exemplo, uma página pode fazer um trabalho lento uma etapa por vez em vez de tudo ao mesmo tempo, ou repetir o mesmo trabalho a cada visita.
Data layer: problemas de banco de dados, como consultas N+1, índices ausentes e carregamento de mais dados do que a página precisa.

O Performance Agent só relata e corrige problemas que consegue associar ao seu código. Ele não altera o tamanho da sua máquina nem outras configurações de deployment. Para dar mais poder ao seu app, veja Configuração de máquina.

Antes de começar

O Performance Agent exige:

Um plano pago. O Performance Agent está disponível para builders em um plano pago. Se você está no plano gratuito, o card Performance scan mostra uma opção de upgrade.
Acesso de edição ao projeto.

Você pode analisar um app antes de publicá-lo. Depois que você publica, o Performance Agent também pode usar os logs do seu deployment para encontrar endpoints que são lentos para visitantes reais. A análise apenas lê seu projeto. Ela não altera seu código, seu banco de dados nem seu app publicado. As alterações só acontecem quando você escolhe corrigir os problemas.

Inicie uma análise

Abra o Monitoring

No painel Tools do seu projeto, abra Monitoring em Replit Cloud. Role até o card Performance scan.

Execute uma análise

Selecione Run scan with Agent para analisar todo o seu projeto com as configurações padrão.Para focar a análise, selecione primeiro a seta ao lado de Run scan with Agent:

Add context (optional): descreva as partes do seu app que importam para você, como “fluxo de checkout e a página de pedidos”.
Only scan changes since the last scan: marque esta caixa para revisar apenas o que mudou desde a análise anterior. O Performance Agent também reverifica os problemas dessa análise para ver se ainda estão presentes.

Depois selecione Start performance scan.

O card Performance scan com as opções de análise abertas, mostrando um campo Add context contendo Checkout flow and the orders page, a caixa Only scan changes since the last scan marcada e um botão Start performance scan — Adicione contexto ou limite a análise às alterações recentes antes de iniciá-la

Aguarde os resultados

A análise é executada como uma tarefa separada, então você pode continuar construindo. Enquanto ela é executada, o card mostra Scan in progress. Uma análise geralmente leva alguns minutos. Selecione Go to task para acompanhar.

Você também pode pedir ao Agent para iniciar uma análise pelo chat:

Revise os resultados

Quando a análise termina, um card Performance scan results aparece na tarefa da análise. Ele mostra quantos problemas novos o Performance Agent encontrou, agrupados em Latency e Data layer. Expanda um problema para ler seu resumo ou selecione View issue para abrir os detalhes completos, incluindo os arquivos afetados e a correção recomendada.

O card Performance scan results mostrando 4 novos problemas em dois grupos, Latency e Data layer, cada problema com um rótulo de severidade High ou Medium, e os botões Fix later e Fix all issues — Os resultados da análise agrupam os novos problemas por tipo e severidade

Escolha o que fazer em seguida:

Fix all issues: o Agent inicia uma tarefa de correção para cada grupo e abre a ferramenta Monitoring para que você possa acompanhá-las.
Fix later: fecha os resultados sem alterar nada. Os problemas permanecem no card Performance scan para que você os corrija quando estiver pronto.

Se a análise não encontrar nada novo, o card informa isso e você pode selecionar Got it.

Corrija problemas pelo Monitoring

O card Performance scan na ferramenta Monitoring acompanha todos os problemas abertos, incluindo os de análises anteriores. Os problemas são agrupados em Latency e Data layer, com uma Severity e um Status para cada um. Expanda um problema para ler seu resumo ou selecione View issue para ver os detalhes completos.

O card Performance scan na ferramenta Monitoring com uma tabela de problemas agrupados em Latency e Data layer, rótulos de severidade e o status Unresolved em cada problema. O primeiro problema de Latency está expandido, mostrando seu resumo e um botão View issue. Cada grupo tem um botão Fix with Agent e o cabeçalho tem um botão Fix all with Agent — Expanda um problema para ler seu resumo ou selecione View issue para ver os detalhes completos

Você pode corrigir os problemas um grupo por vez ou todos de uma vez:

Fix with Agent em um grupo envia todos os problemas desse grupo ao Agent como uma única tarefa.
Fix all with Agent envia todos os grupos abertos ao Agent.

O Agent trabalha em cada tarefa de correção em segundo plano, em paralelo, para que você possa continuar construindo. O status de cada problema é atualizado conforme o trabalho avança:

Fix in progress: o Agent está trabalhando na correção. Selecione Go to task para acompanhar.
Ready for review: a correção está pronta. Abra a tarefa, revise as alterações e selecione Apply changes to main version para adicioná-las ao seu app.
Applying fix: o Replit está adicionando as alterações ao seu app.
Ready for republish: a correção está no seu app, mas ainda não na sua versão publicada.
Fixed: a correção está no ar.

O card Performance scan com os problemas de Latency mostrando Fix in progress, os problemas de Data layer mostrando Ready for review e um botão Go to task em cada grupo — Os status dos problemas são atualizados conforme o Agent trabalha em cada tarefa de correção

Republique para aplicar suas correções

As correções só chegam aos seus visitantes depois que você republica. Quando uma ou mais correções estiverem Ready for republish, um botão Republish project aparece no card Performance scan. Selecione-o para publicar uma nova versão do seu app com as correções. O status muda para Publishing e depois para Fixed.

O card Performance scan com todos os problemas marcados como Ready for republish e um botão Republish project no cabeçalho, ao lado de Run scan with Agent — Selecione Republish project para colocar suas correções no ar

Você também pode republicar pela ferramenta Publishing. Veja Depois de publicar.

Depois de republicar, execute outra análise com Only scan changes since the last scan marcado. O Performance Agent confirma quais problemas foram corrigidos e verifica suas alterações recentes em busca de novos.