O Painel de Desempenho fornece métricas de cliente e servidor em tempo real para o seu jogo. Monitore esta página antes e depois de atualizar seu jogo para identificar problemas de desempenho precocemente.
Visualizar métricas de desempenho
Para acessar o painel de desempenho, você deve ser o proprietário do jogo ou ter permissões de grupo de análise.
- No Creator Hub, navegue até a página de Criações.
- No canto superior esquerdo, selecione sua conta ou o grupo que possui o jogo.
- Selecione o jogo.
- No menu suspenso Monitoramento, selecione Desempenho.
O painel começa com o número atual de usuários, o número de servidores em que estão distribuídos e uma divisão por dispositivo. Para que o painel mostre gráficos de cliente e servidor como os abaixo, seu jogo deve ter pelo menos 100 usuários ativos diários (DAU).
O painel contém duas abas, Cliente e Servidor, juntamente com menus para ajustar o intervalo de datas e o intervalo de tempo. Você também pode usar o menu Lugar para examinar lugares individuais em vez de todo o jogo.
O menu Filtrar Por permite alternar entre médias ou valores percentuais.
Ao revisar gráficos ou filtrar:
- P90 refere-se ao número de valores que caem dentro do 90º percentil. Se o P90 do heartbeat do servidor é 59, então 90% dos servidores estão rodando a 59 FPS ou menos.
- Da mesma forma, P10 refere-se ao 10º percentil. Se o P10 do heartbeat do servidor é 40, então 10% dos servidores estão rodando a 40 FPS ou menos.
- P50 é a mediana. Metade de todos os valores está acima dela, metade abaixo.
Para ajudar a identificar a fonte de uma regressão, você pode detalhar todas as métricas de desempenho do cliente por Versão do Lugar e comparar sua atualização mais recente com versões anteriores.
Para filtrar por versão do lugar, selecione Versão do Lugar no menu suspenso Detalhamento por. Os gráficos serão atualizados automaticamente para mostrar sua versão mais nova ao lado de todas as versões anteriores. Você também pode usar o menu de filtro principal para isolar a versão mais nova do lugar em todo o painel.
Com esse detalhamento, você pode rapidamente ver se sua última versão tem alterações, como taxas de quadros mais baixas ou um aumento em saídas por falta de memória em comparação com versões anteriores.
Gráficos do cliente
A aba Cliente inclui os seguintes gráficos, todos os quais são detalhados por plataforma ou sistema operacional:
| Gráfico | Descrição |
|---|---|
| Usuários simultâneos | Gráfico de linha mostrando o número de usuários em seu jogo. |
| Tempo de sessão | Duração que os usuários passam em seu jogo. |
| Taxa de quadros do cliente | Gráfico de linha mostrando os quadros por segundo do cliente. Taxas de quadros persistentemente baixas ou grandes quedas podem sinalizar problemas. Para informações sobre como investigar a taxa de quadros do cliente, veja Cálculo do Cliente. |
| Taxa de falhas do cliente | Gráfico de linha mostrando falhas do cliente, divididas por sessões encerradas por tipo de dispositivo. Picos na taxa de falhas, particularmente após uma atualização do jogo, frequentemente indicam um problema. |
| Saídas inesperadas por falta de memória | Gráfico de linha mostrando com que frequência os usuários falham devido a erros de falta de memória ou saem via aviso de baixa memória. Embora este gráfico possa não cobrir todas as falhas por falta de memória devido a limitações de telemetria, ele é direcionalmente preciso. Um pico após uma atualização indica uma regressão no uso de memória que causa falhas aos seus usuários. |
| Contagem de falhas do cliente | Gráfico de linha mostrando a contagem da taxa de falhas por tipo de dispositivo. Se você tiver dados de taxa de falhas ruidosos devido a um tamanho de amostra baixo, recomendamos monitorar a contagem de falhas também. |
| Uso de memória do cliente | Gráfico de linha mostrando o uso de memória do cliente por tipo de dispositivo. Aumentos contínuos podem indicar um vazamento de memória. Veja Memória. |
| Porcentagem de uso de memória do cliente | Gráfico de linha mostrando a porcentagem da memória disponível do dispositivo que o cliente está usando. Por exemplo, se a linha do Android se aproxima de 100%, a maioria dos dispositivos Android que executam seu jogo está em risco de ficar sem memória e falhar. |
| Tempo de CPU do cliente | Gráfico de área empilhada mostrando milissegundos (ms) de tempo de processamento por quadro. Você quer que o tempo de CPU do cliente seja o mais baixo possível, pois isso impacta diretamente suas taxas de quadros. Para atingir uma taxa de quadros do cliente de 60, seu tempo de CPU deve estar abaixo de 16 ms. |
Taxa de falhas
A taxa de falhas do cliente mede o número de falhas dividido pelo número de sessões encerradas. Quando o número de sessões encerradas é baixo, os detalhamentos da taxa de falhas podem se tornar instáveis. Nesses casos, o gráfico mostrará uma linha pontilhada em vez de uma linha sólida, indicando que o ponto de dados é ruidoso e que a taxa de falhas pode variar. Se você ver uma linha pontilhada em seu gráfico, recomendamos verificar a contagem total de falhas em vez da taxa de falhas do cliente.
Se você tiver problemas de memória, consulte o guia de otimização de desempenho.
Gráficos do servidor
A aba Servidor inclui os seguintes gráficos:
| Gráfico | Descrição |
|---|---|
| Tempo de CPU do servidor | Gráfico de área empilhada mostrando milissegundos (ms) de tempo de processamento por quadro. Para atingir uma taxa de quadros do servidor de 60, seu tempo de CPU deve estar abaixo de 16 ms. Veja Cálculo do Servidor. |
| Taxa de quadros do servidor | Gráfico de linha mostrando a taxa de quadros do servidor em FPS. Idealmente, esse valor deve ser sempre 60. A taxa de quadros do servidor é limitada a 60, e quedas podem reduzir a taxa de quadros do cliente e aumentar a latência. Veja Cálculo de Script. |
| Uso de memória do servidor | Gráfico de área empilhada mostrando o uso de memória do servidor em MB. Tente manter esse valor abaixo de 50% da memória total do servidor. No entanto, o gráfico não mostra a memória total do servidor, então outra boa diretriz é ficar abaixo de 3 GB. Se esse número permanecer alto ou aumentar continuamente ao longo do tempo, investigue maneiras de melhorar o uso de memória. |
| Memória do servidor por idade | Gráfico de área empilhada mostrando o uso de memória do servidor por idade do servidor. Se o uso de memória aumentar significativamente ao longo da vida útil do servidor, investigue possíveis vazamentos de memória nas categorias com maior crescimento, particularmente scripts, física e renderização. |
| Núcleos usados por servidor | Gráfico de linha mostrando o uso da contagem de núcleos de CPU do servidor. O baixo uso da contagem de núcleos combinado com alto tempo de CPU do servidor é um indicador de que você deve investigar multithreading. Se o uso de núcleos permanecer alto após a otimização, você pode reservar mais CPU do servidor com Serviços Estendidos para Cálculo. |
| Eficiência de cálculo | Gráfico de linha mostrando a eficiência do seu jogo em comparação com a média do Roblox. Valores acima de 100% indicam maior eficiência do que a linha de base. Fatores contribuintes incluem o número máximo de jogadores por servidor (quanto maior, mais eficiente) e o tempo de CPU do servidor por quadro (quanto menor, mais eficiente). Maior eficiência de cálculo significa menor impacto ambiental, mas essa métrica não é indicativa de uma boa ou má experiência do jogador. |
Para uma visão aprofundada sobre falhas do servidor e instantâneas de falta de memória, veja gráfico de falhas do servidor.
Os gráficos de CPU e memória do servidor padrão são exibidos na visão Geral, mas possuem menus suspensos para grupos de processos individuais, como física, renderização e scripts. A soma dessas categorias não é abrangente; o servidor realiza uma pequena e tipicamente insignificante quantidade de trabalho adicional por quadro que não está incluída em nenhuma categoria. Assim, os valores gerais em milissegundos e MB são ligeiramente inferiores à realidade, mas próximos o suficiente para lhe dar uma compreensão clara do desempenho do servidor.
Se uma categoria estiver mais alta do que o normal ou parecer estar ocupando uma quantidade desproporcional de tempo, use o menu suspenso para aprofundar-se no grupo e identificar processos que podem estar causando problemas.
Para excluir um grupo ou processo de um gráfico, clique em seu rótulo na legenda.
As categorias e tarefas de CPU mapeiam para aquelas no MicroProfiler, então você pode fazer dumps do servidor, selecionar o modo Tempos e, em seguida, usar o menu Grupos para filtrar pelo grupo de processos problemático.
Por exemplo, se você notar um problema potencial com o processo assemble sob o grupo Física, você pode encontrá-lo sob o mesmo nome no MicroProfiler:
As tags de memória mapeiam para aquelas em Enum.DeveloperMemoryTag, com a notável exceção de CoreMemory:Total, que é equivalente a Enum.DeveloperMemoryTag.Internal. Você pode usar o Console do Desenvolvedor para verificar tags de uso excessivo. Esta imagem mostra como você pode usar o Console do Desenvolvedor para investigar um problema com PlaceMemory:GraphicsTexture que você vê no painel:
Atualizações do Roblox
Cada atualização do Roblox contém muitas mudanças, incluindo recursos e correções de bugs. As anotações de atualização do Roblox permitem que você faça uma referência cruzada ao desempenho do seu jogo com as atualizações recentes da plataforma Roblox.
Algumas plataformas são lançadas para 100% dos usuários imediatamente após a versão ser disponibilizada. Outras plataformas são lançadas gradualmente e requerem tempo adicional para aumentar a adoção; essas recebem uma única anotação uma vez que uma versão é disponibilizada, dando a você o primeiro sinal disponível sem adicionar desordem visual.
- Windows
- macOS
- Xbox
- iOS
- Google
- Amazon
- Samsung
- PlayStation
- Meta Quest
Solução de problemas
Se você notar um problema potencial, use os seguintes passos para remediar e corrigi-lo:
Verifique suas atualizações recentes e considere revertê-las se o impacto nas métricas for severo.
Veja Identificar problemas de desempenho e Melhorar desempenho para informações sobre como solucionar problemas com cálculo de servidor, cálculo de cliente e uso de memória.
Use ferramentas de teste integradas para aprofundar ainda mais os problemas:
- Console do Desenvolvedor para visualizar mensagens de erro e log e informações detalhadas sobre memória e rede.
- Profiler de Script para identificar scripts que consomem mais recursos.
- O MicroProfiler para visualizar partes não otimizadas do seu jogo visualmente.
Reúna feedback dos usuários da sua comunidade.
Chamadas de API do cliente após a entrada
Esta métrica está disponível apenas para um pequeno número de jogos de destaque.
A métrica Chamadas de API do Cliente nos Primeiros 60s Após a Entrada mede o número total de solicitações (chamadas de API) que seu jogo faz aos serviços do Roblox durante o primeiro minuto crítico após um usuário entrar com sucesso.
Essas chamadas acontecem automaticamente para cada usuário que entra, então monitorar essa métrica pode ajudá-lo a entender a eficiência do tempo de carregamento e o desempenho do backend.
Acessar a métrica
- Navegue até a visão geral do seu jogo no Creator Hub.
- No gráfico Instantâneo, clique em Explorar.
- No menu suspenso Selecionar uma métrica, escolha Chamadas de API do Cliente nos Primeiros 60s Após a Entrada.
Monitorar a métrica
O objetivo principal durante os primeiros 60 segundos de um jogador entrando é transmitir e carregar os ativos do seu jogo (malhas, imagens, sons, etc.). Idealmente, o serviço de entrega de ativos é a API mais chamada durante esse período crítico.
A métrica é atualizada a cada hora para que você possa verificá-la rapidamente após publicar uma nova versão do seu jogo.
| Condição | Implicação | Ação |
|---|---|---|
| A entrega de ativos é a API mais acessada. | Eficiente. Seu jogo está priorizando corretamente o carregamento dos ativos necessários. | Continue monitorando. |
| Um serviço diferente (por exemplo, inventário, amigos ou usuários) é a API mais acessada. | Potencial ineficiência ou bug. Seu jogo está executando chamadas de API pesadas e não críticas muito cedo na sequência de entrada, potencialmente atrasando o processo de carregamento. | Investigue e refatore os scripts que são executados durante a entrada inicial para priorizar o carregamento de ativos. |