O painel de Desempenho fornece métricas de cliente e servidor atualizadas para sua experiência. Monitore esta página antes e depois de atualizar sua experiência para identificar problemas de desempenho rapidamente.
Ver métricas de desempenho
Para acessar o painel de desempenho, você deve ser o proprietário da experiência ou ter permissões de grupo de análise.
- Navegue até a página de Criações no Creator Hub.
- No canto superior esquerdo, selecione sua conta ou o grupo que possui a experiência.
- Selecione a experiência.
- 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, sua experiência deve ter pelo menos 100 usuários ativos diariamente (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 toda a experiência.
O menu Filtrar Por permite alternar entre valores médios ou percentuais.
Ao revisar gráficos ou filtrar:
- P90 refere-se ao número de valores que caem dentro do 90º percentil. Se o P90 da frequência de batimentos 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 da frequência de batimentos do servidor é 40, então 10% dos servidores estão rodando a 40 FPS ou menos.
- P50 é a mediana. Metade de todos os valores fica 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 Quebra 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 recente do lugar em todo o painel.
Com essa quebra, você pode rapidamente ver se sua última versão tem mudanças 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 segmentados por plataforma ou sistema operacional:
| Gráfico | Descrição |
|---|---|
| Usuários simultâneos | Gráfico de linhas mostrando o número de usuários em sua experiência. |
| Tempo de sessão | Duração que os usuários passam em sua experiência. |
| Taxa de quadros do cliente | Gráfico de linhas 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 linhas mostrando falhas do cliente, divididas por sessões encerradas por tipo de dispositivo. Picos na taxa de falhas, especialmente após uma atualização da experiência, frequentemente indicam um problema. |
| Saídas inesperadas por falta de memória | Gráfico de linhas 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 para seus usuários. |
| Contagem de falhas do cliente | Gráfico de linhas mostrando a contagem da taxa de falhas por tipo de dispositivo. Se você tiver dados de taxa de falhas ruidosos devido ao baixo tamanho da amostra, recomendamos monitorar também a contagem de falhas. |
| Uso de memória do cliente | Gráfico de linhas 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 linhas mostrando a porcentagem de memória disponível do dispositivo que o cliente está utilizando. Por exemplo, se a linha do Android se aproxima de 100%, a maioria dos dispositivos Android executando sua experiência está em risco de ficar sem memória e falhar. |
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, as divisões 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ê vir 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. Valores acima de 16,67 ms são altamente indesejáveis; podem causar uma queda nas taxas de quadros do servidor abaixo de 60. Veja Cálculo do Servidor. |
| Taxa de quadros do servidor | Gráfico de linhas mostrando a taxa de quadros do servidor em FPS. Idealmente, esse valor deve ser sempre 60. A taxa de quadros do servidor tem um limite de 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. Entretanto, o gráfico não mostra a memória total do servidor, então uma 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 o maior crescimento, particularmente scripts, física e renderização. |
| Núcleos usados por servidor | Gráfico de linhas mostrando o uso da contagem de núcleos da CPU do servidor. Um baixo uso da contagem de núcleos combinado com um alto tempo de CPU do servidor é um indicador de que você deve investigar multithreading. |
| Eficiência de cálculo | Gráfico de linhas mostrando a eficiência da sua experiência em comparação com a média da Roblox. Valores acima de 100% indicam maior eficiência do que a linha de base. Os fatores contribuintes incluem o número máximo de jogadores por servidor (maior é mais eficiente) e o tempo de CPU do servidor por quadro (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 para o 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 têm como padrão a visualizaçã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ído em nenhuma categoria. Assim, os valores gerais em milissegundos e MB são ligeiramente inferiores à realidade, mas próximos o suficiente para dar uma compreensão clara do desempenho do servidor.
Se uma categoria estiver mais alta do que o habitual ou parecer estar ocupando uma quantidade desproporcional de tempo, use o menu suspenso para detalhar o 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 da CPU mapeiam para aquelas no MicroProfiler, para que você possa fazer dumps do servidor, selecionar o modo Temporizadores e então usar o menu Grupos para filtrar pelo grupo de processo problemático.
Por exemplo, se você identificar um potencial problema com o processo assemble sob o grupo Física, você pode encontrá-lo pelo mesmo nome no MicroProfiler:
As etiquetas 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 etiquetas 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 alterações, incluindo recursos e correções de bugs. As anotações de atualizações do Roblox permitem que você faça uma referência cruzada do desempenho da sua experiência com atualizações recentes da plataforma Roblox.
Algumas plataformas lançam 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 assim que uma versão é disponibilizada, dando a você o sinal mais cedo sem adicionar desordem visual.
- Windows
- macOS
- Xbox
- iOS
- Google
- Amazon
- Samsung
- PlayStation
- Meta Quest
Solução de problemas
Se você detectar um potencial problema, use os seguintes passos para remediá-lo 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 a análise de 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 porções não otimizadas de sua experiência visualmente.
Reúna feedback dos usuários da sua comunidade.
Chamadas de API do cliente após ingressar
Esta métrica está disponível apenas para um pequeno número de experiências de destaque.
A métrica Chamadas de API do Cliente nos Primeiros 60s Após Ingressar mede o número total de requisições (chamadas de API) que sua experiência faz aos serviços Roblox durante o minuto crítico seguinte a um usuário ingressar com sucesso.
Essas chamadas acontecem automaticamente para cada usuário que ingressa, portanto, monitorar essa métrica pode ajudá-lo a entender a eficiência de tempo de carregamento e o desempenho do backend.
Acesse a métrica
- Navegue até a visão geral da sua experiência no Creator Hub.
- No gráfico de Instantâneo, clique em Explorar.
- No menu suspenso Selecionar uma métrica, escolha Chamadas de API do Cliente nos Primeiros 60s Após Ingressar.
Monitore a métrica
O objetivo principal durante os primeiros 60 segundos do ingresso de um jogador é transmitir e carregar os ativos da sua experiência (malhas, imagens, sons, etc.). Idealmente, o serviço de entrega de ativos é a API mais chamada durante esse período crucial.
A métrica é atualizada a cada hora para que você possa verificá-la rapidamente após publicar uma nova versão de sua experiência.
| Condição | Implicação | Ação |
|---|---|---|
| Entrega de ativos é a API mais acionada. | Efetivo. Sua experiência está corretamente priorizando o carregamento de ativos necessários. | Continue monitorando. |
| Um serviço diferente (por exemplo, inventário, amigos ou usuários) é a API mais acionada. | Ineficiência potencial ou bug. Sua experiência está executando chamadas de API pesadas e não críticas cedo demais na sequência de ingresso, potencialmente atrasando o processo de carregamento. | Investigue e refatore os scripts que são executados durante o ingresso inicial para priorizar o carregamento de ativos. |