MicroProfiler

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

O MicroProfiler é uma ferramenta de otimização de desempenho e solução de problemas no Roblox Studio e no cliente Roblox. Ele fornece informações detalhadas e visuais sobre o tempo de execução de todas as tarefas do motor que ocorrem durante um quadro, como animar personagens, atualizar física, executar scripts e renderizar geometria. Você pode identificar quais tarefas foram executadas durante qual quadro, quanto tempo essas tarefas levaram para serem executadas e se alguma delas fez você perder suas metas de tempo de quadro.

Tempos de quadro

Para usar o MicroProfiler, você deve entender a relação entre tempo de quadro e taxa de quadros.

  • O tempo de quadro é quanto tempo um quadro levou para ser renderizado na tela, geralmente medido em milissegundos.
  • A taxa de quadros é o número de quadros renderizados na tela, geralmente medido em quadros por segundo (FPS).

Tempos de quadro mais baixos significam taxas de quadros mais altas. Divida 1.000 milissegundos (1 segundo) pelo tempo de quadro para obter a taxa de quadros.

Tempo médio de quadroQuadros por segundo
33,33 ms30 FPS
16,67 ms60 FPS
8,33 ms120 FPS
4,17 ms240 FPS

Para um jogo suave, no entanto, não é suficiente ter uma alta taxa de quadros. Você precisa de tempos de quadro consistentes. Por exemplo, se 59 quadros chegam em 10 milissegundos e um quadro em 410 milissegundos, os jogadores percebem uma grande e abrupta interrupção, mesmo que o jogo esteja rodando a 60 FPS. Se todos os quadros levam aproximadamente o mesmo tempo para renderizar, seu jogo parecerá perceptivelmente mais suave devido a essa consistência, especialmente em taxas de quadros mais baixas.

O MicroProfiler foca totalmente no tempo de quadro. Seu objetivo é ajudar você a identificar picos de tempo de quadro e o que os causou.

Abrir o MicroProfiler

Abrir o MicroProfiler varia de acordo com a plataforma:

  • No cliente móvel, abra o menu Configurações e altere o MicroProfiler para Ativado. Em seguida, de uma máquina de desenvolvimento na mesma rede, use seu navegador da web para navegar até o endereço IP e porta fornecidos.

    A interface do MicroProfiler no celular.

    Esta captura de tela mostra um endereço IP de 172.18.56.105 e uma porta de 1338, então você navega para 172.18.56.105:1338. Dependendo da configuração de rede do seu dispositivo, você pode ver vários endereços IP. Se um não funcionar, tente o próximo.

  • No cliente desktop, pressione CtrlF6 (⌘F6).

  • No Studio, pressione CtrlF6 (⌘F6).

Geralmente, o cliente móvel é o melhor lugar para perfilar seu jogo. A maioria dos jogadores no Roblox usa telefones e tablets, e esses dispositivos têm severas limitações térmicas e de energia que limitam seu desempenho. Se seu jogo roda bem em um tablet Android de médio porte, ele quase certamente terá um desempenho muito, muito melhor em um desktop para jogos.

Noções básicas do MicroProfiler

O MicroProfiler tem dois componentes principais: o gráfico de barras de tempo de quadro e a linha do tempo de tarefas detalhadas.

  • O gráfico de tempo de quadro se estende ao longo do topo da interface e mostra quanto tempo cada quadro levou para renderizar. Barras mais altas significam tempos de quadro mais longos.
  • A linha do tempo mostra todas as tarefas individuais que foram executadas durante o quadro. Barras mais largas representam tarefas que levaram mais tempo para serem executadas.

Um fluxo de trabalho típico no MicroProfiler é usar o gráfico de tempo de quadro para identificar um pico (uma barra mais alta) e, em seguida, usar a linha do tempo para identificar quais tarefas causaram o pico. Depois, você pode verificar a Referência de Tags para obter informações sobre a tarefa e como melhorar seu desempenho.

Exemplo de um pico de tempo de quadro.

Gráfico de tempo de quadro

A altura de cada barra indica o número de milissegundos que levou para completar o quadro. Os quadros mais recentes estão à direita. Passe o mouse sobre um quadro para obter algumas informações básicas sobre o uso de CPU e GPU.

O gráfico de tempo do Microprofiler, mostrando quadros azuis e informações detalhadas do quadro.
  • Barras laranjas são quadros onde o Tempo de Parede de Jobs excede o Tempo de Parede de Renderização. Nesses quadros, pelo menos uma das threads de trabalho, que fazem coisas como executar scripts, calcular física e reproduzir animações, levou mais tempo para executar do que a thread de renderização principal.

    Se o jogo não está atingindo suas metas de tempo de quadro e tem um grande número de quadros laranjas, as causas comuns são scripts, física e animações. Veja Melhorar desempenho.

  • Barras azuis são quadros onde o Tempo de Parede de Renderização excede o Tempo de Parede de Jobs. Nesses quadros, a thread de renderização principal levou mais tempo do que qualquer uma das threads de trabalho.

    Se o jogo não está atingindo suas metas de tempo de quadro e tem um grande número de quadros azuis, isso indica um gargalo de renderização. Causas comuns são densidade excessiva de objetos, movimento de objetos e iluminação. Veja Melhorar desempenho.

  • Barras vermelhas são quadros onde duas condições são verdadeiras:

    • Tempo de Parede de Renderização excede Tempo de Parede de Jobs
    • Tempo de Espera da GPU é maior que 2,5 milissegundos

    Barras vermelhas são menos comuns do que laranjas e azuis e geralmente são o resultado de complexidade excessiva de objetos, tamanho de textura e efeitos visuais. A otimização é semelhante à das barras azuis. Veja Melhorar desempenho.

Tarefas pequenas no final de um quadro podem às vezes distorcer o Tempo de Parede de Jobs e o Tempo de Parede de Renderização, o que é uma boa razão para se concentrar mais no tempo de quadro do que na cor do quadro. Não há uma "boa" cor a ser buscada. Uma mistura de laranja, azul e vermelho não é problemática, desde que você esteja atingindo suas metas de tempo de quadro. Se você não estiver atingindo suas metas de tempo de quadro, as cores podem indicar onde otimizar.

Linha do tempo

  • Clique com o botão esquerdo e arraste para mover a linha do tempo. Em uma máquina com muitos núcleos de CPU, você pode precisar mover para cima ou para baixo bastante para encontrar a thread que está executando uma tarefa específica.

    O lado esquerdo da visualização detalhada do Microprofiler, com linhas para threads.
  • Rolando a tela, você aumenta e diminui o zoom da linha do tempo. Combinado com os rótulos de milissegundos no topo da linha do tempo, você pode ter uma noção de quanto tempo uma tarefa levou em um sentido absoluto, mas também quanto tempo levou em relação a outras tarefas.

    A visualização detalhada do Microprofiler com vários rótulos horizontais.
  • A sobreposição verde no gráfico de barras indica o número de quadros atualmente visíveis na linha do tempo—seu nível de zoom. Clique com o botão esquerdo em uma barra de quadro para pular para essa posição na linha do tempo.

    Você pode ter que ajustar seu nível de zoom, mas passar o mouse sobre uma barra destaca o quadro na linha do tempo. Linhas cinzas claras delimitam os quadros.

    O gráfico de barras do MicroProfiler com sobreposição verde para mostrar o nível de zoom.
  • Rótulos que aparecem diretamente abaixo de outro rótulo indicam tarefas que são realizadas como parte da tarefa de nível superior.

    Em vez da tarefa pai, você normalmente quer solucionar os piores desempenhos das tarefas filhas; uma tarefa pai não pode ser mais curta do que a soma de suas tarefas filhas.

  • Clique com o botão direito em um rótulo para aumentar o zoom da linha do tempo exatamente para a duração daquela tarefa.

  • Se a quantidade de informações for esmagadora, use o menu Grupos ou Threads para filtrar a linha do tempo. Por exemplo, você pode querer ver apenas tarefas de Renderização na thread principal.

    A visualização ao passar o mouse sobre um rótulo, com Grupo destacado.
  • Use CtrlF (⌘F) para pular para a ocorrência de uma tarefa que consome mais tempo no dump. Por exemplo, computeLightingPerform é executado em cada quadro do cliente. Se você pesquisar por ele em um dump com 128 quadros, pode pular para o quadro onde levou mais tempo para ser concluído.

Threads

Como muitos programas, o Roblox usa várias threads para executar sequências de tarefas ao mesmo tempo. O MicroProfiler exibe o nome da thread no lado esquerdo da linha do tempo.

O lado esquerdo da visualização detalhada do Microprofiler, com linhas para threads.

Existem três tipos importantes de threads:

  • Principal ("RBX Main"): Lida com tarefas de renderização baseadas em CPU. Processa entrada, Humanoids, animações/tweening, propriedade de física, som e espera por retomas de script. Também atualiza interfaces do Studio e coordena as outras threads.

  • Trabalhador ("RBX Worker"): Ajuda a thread principal com rede, física e busca de caminho. Devido ao número de núcleos em CPUs modernas, você provavelmente tem muitas threads de trabalho, a maioria das quais está em estado de espera a qualquer momento.

  • Renderização ("GPU"): Segue uma lógica de "preparar, executar, apresentar". Comunica-se com a unidade de processamento gráfico (GPU) do dispositivo.

    • Preparar: Informações da thread principal são usadas para atualizar modelos de renderização.
    • Executar: Emite comandos de renderização, incluindo interfaces 2D.
    • Apresentar: Sincroniza com a GPU.

Perfis de script personalizados

Se seus scripts estão executando tarefas complicadas, você pode perfilar partes críticas do código para garantir que não estejam levando muito tempo. Envolva o código com debug.profilebegin() e debug.profileend() para cronometrar tudo feito entre essas chamadas de função e criar um rótulo na linha do tempo do MicroProfiler.

local RunService = game:GetService("RunService")
local function onPreSimulation()
debug.profilebegin("Hard Work")
-- Exemplo de trabalho duro: trocar duas variáveis 200.000 vezes
local a, b = 0, 1
for _ = 1, 200000 do
a, b = b, a
end
debug.profileend()
end
RunService.PreSimulation:Connect(onPreSimulation)
Muitos rótulos no MicroProfiler, com um rótulo personalizado ocupando a maior parte do tempo de processamento.

Pela sua duração na linha do tempo, você pode perceber que a função está usando muito tempo de processamento em comparação com outras tarefas.

Analisar capturas com o Assistente

No Studio, você pode pedir ao Assistente para analisar automaticamente uma captura pausada do MicroProfiler, identificar gargalos de desempenho e propor correções.

  1. No Studio, abra o MicroProfiler com CtrlF6 (⌘F6).
  2. Quando você notar um pico de tempo de quadro, pause a captura pressionando Pausar no menu superior ou usando CtrlP (⌘P).
  3. Abra o Assistente e peça para ele analisar a captura. Exemplos de solicitações incluem:
    • "Capturei um pico de tempo de quadro no MicroProfiler—analise-o."
    • "O que causou o pico?"
    • "É limitado pela física ou por scripts?"
    • "Qual categoria tem o maior tempo exclusivo?"
    • "Quando estou no hangar, a FPS cai. Reproduza o problema, use o MicroProfiler para encontrar a causa, corrija-o e reteste."

O Assistente lê a captura pausada através da API do MicroProfiler e retorna um relatório sobre os gargalos prováveis, juntamente com propostas de alterações de script ou cena que você pode aplicar.

Essa funcionalidade também funciona através do servidor Studio MCP, para que você possa integrar análises do MicroProfiler em seu próprio agente de IA ou loop de agente para obter feedback automatizado sobre como novas alterações impactam o desempenho do seu jogo.

Salvar dados de quadro

Se você quiser salvar um conjunto de dados de quadro para revisão posterior (ou para compartilhar com outra pessoa), use o botão Salvar em arquivo. O MicroProfiler salva os dados de quadro em um arquivo HTML independente chamado microprofile-<data>-<hora>.html.

O botão salvar em arquivo na interface da web.

No cliente desktop ou no Studio, use o menu Dump. Em ambos os casos, o MicroProfiler salva automaticamente o arquivo no diretório de logs do Roblox:

  • No Windows, verifique %LOCALAPPDATA%\Roblox\logs.

    Se você usar o aplicativo da Plataforma Universal do Windows (UWP), verifique \Users\<username>\AppData\Local\Packages\ROBLOXCORPORATION.ROBLOX_<hash>\LocalState\logs\.

  • No macOS, verifique ~/Library/Logs/Roblox.

Perfilar o servidor

Além de perfilar o cliente, você pode capturar breves dumps da atividade do servidor:

  1. No cliente desktop, entre em um jogo para o qual você tem permissões de edição.

  2. Abra o Console do Desenvolvedor com CtrlF9 (⌘F9).

  3. No menu suspenso, selecione MicroProfiler.

  4. Na aba Servidor, especifique o número de quadros a serem capturados (máximo 60) e o número de segundos para atrasar antes de iniciar a captura (máximo 4).

  5. Clique em Iniciar gravação do servidor.

    A tela do MicroProfiler no Console do Desenvolvedor.

    Após alguns segundos, o Console do Desenvolvedor fornece o caminho para o arquivo, que é o mesmo caminho de um dump padrão.

Recursos apenas para a web

O MicroProfiler tem duas interfaces de usuário: a interface da web (móvel e dumps) e a interface desktop (cliente e Studio). Recomendamos usar a interface da web sempre que possível. Em geral, as duas funcionam de maneira semelhante, mas a interface da web tem alguns recursos extras:

  • Use o menu Raio-X para habilitar ou desabilitar a codificação de cores para alocação de memória.

    A visualização da web do MicroProfiler com raio-x habilitado.
    • Quadros mais claros dentro do gráfico de barras principal indicam maior alocação de memória.
    • Porções mais claras da barra de visualização e rótulos mais claros na linha do tempo indicam porções do quadro com maior alocação de memória.
    • No modo Raio-X, pressione C para mostrar o tamanho total das alocações de memória em vez do número de alocações.
  • Use o menu Exportar para exportar um gráfico de chamas de CPU ou memória, uma visualização especializada que agrega todas as pilhas de chamadas incluídas no dump, mantém a hierarquia pai-filho e as dimensiona com base na duração. Gráficos de chamas são especialmente úteis para identificar tarefas que não fazem você perder suas metas de tempo de quadro (e, portanto, são difíceis de notar), mas que são executadas com tanta frequência que seu tempo de processamento se torna significativo.

    O gráfico de chamas do MicroProfiler na interface da web.

    Você também pode criar gráficos de chamas no Studio, embora apenas para scripts (tempo de execução e alocações de memória). Comparado aos gráficos de chamas baseados na web, os do Studio são de cima para baixo, em vez de baixo para cima, e suportam tempos de captura dramaticamente mais longos.

    O gráfico de chamas do MicroProfiler no Studio.
  • Arraste e solte um segundo arquivo de dump na interface da web para gerar um gráfico de chamas de diferença, que pode ajudá-lo a identificar melhorias ou regressões no desempenho do seu jogo ao longo do tempo. Clique em Combinar e Comparar para exportar um novo arquivo HTML.

    O construtor de gráfico de chamas de diferença do MicroProfiler mostrando os lados esquerdo e direito.

    O gráfico de chamas de diferença destaca o dump (esquerdo ou direito) que consome mais CPU ou memória, com cores mais brilhantes indicando uma diferença maior.

    O gráfico de chamas de diferença do MicroProfiler.

Recursos apenas para desktop

Na linha do tempo desktop, clique com o botão esquerdo em um rótulo para adicioná-lo a um gráfico de linha no canto inferior direito. O gráfico mostra o tempo que a tarefa leva a cada quadro. Usando esse gráfico, você pode testar o desempenho de apenas certas tarefas em seu jogo. Quando terminar, clique com o botão direito no gráfico para ocultá-lo.

O gráfico mostrando quanto tempo as tarefas levam por quadro.

Esse gráfico está sincronizado com as barras do profiler principal. O intervalo de quadros atualmente selecionado é destacado em verde no gráfico. Você também pode clicar em qualquer lugar neste gráfico para re-centralizar a visualização principal do profiler para aquele quadro específico, o que é útil para encontrar picos na visualização detalhada.

Pesquisar na visualização detalhada

No cliente desktop, você pode pesquisar por tarefas pelo nome na visualização Detalhada:

  1. Abra o MicroProfiler com CtrlF6 (⌘F6) e mude para o modo Detalhado.

  2. Pressione CtrlF (⌘F) para abrir a caixa de pesquisa.

  3. Digite parte de um nome de tarefa ou rótulo. A correspondência não diferencia maiúsculas de minúsculas e encontra o texto em qualquer lugar no nome. Rótulos correspondentes mantêm sua cor e todos os outros rótulos são atenuados. Quadros que contêm uma correspondência são destacados no gráfico de tempo de quadro.

  4. Mova-se entre as correspondências:

    AçãoAtalho
    Próxima correspondênciaF3 ou Enter
    Correspondência anteriorShiftF3 ou ShiftEnter

    Você também pode clicar nos botões < e > ao lado da caixa de pesquisa. A correspondência atual é contornada e marcada com um triângulo acima dela, e um contador como 12 / 340 mostra sua posição entre todas as correspondências. Se a correspondência estiver fora da tela, a linha do tempo rola até ela. Se você tiver movido a linha do tempo, a navegação continua a partir das correspondências que estão atualmente visíveis.

  5. Pressione Esc, ou pressione CtrlF (⌘F) novamente, para fechar a pesquisa. Fechar a pesquisa não fecha o MicroProfiler.

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.