Relatório de Erros

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

Relatório de Erros permite que você visualize erros e avisos do sistema Luau em tempo real para servidor e cliente. Monitore seu relatório de erros antes e depois de atualizar seu jogo para identificar problemas potenciais mais cedo.

Visualize seu relatório de erros

Para visualizar o relatório de erros do seu jogo:

  • Navegue até sua página de Criações no Painel do Criador e selecione seu jogo.
  • Em Monitoramento, selecione Relatório de Erros.

Você pode visualizar análises para experiências individuais ou de grupos. Para visualizar estas últimas, você precisa ter permissões de grupo para analytics.

Monitore erros e avisos

Você pode aplicar os seguintes filtros e alternâncias ao seu relatório de erros:

  • Intervalo de datas — Filtrar para a última 1 hora, último 1 dia, últimos 7 dias ou últimos 30 dias.
  • Lugar — Filtrar por lugar.
  • Mostrar versão — Adiciona anotações de versão do lugar ao gráfico de erros e avisos.
  • Severidade — Filtrar para mostrar erros, avisos, ou ambos.
  • Plataforma — Filtrar para mostrar erros do cliente de dispositivos específicos.
  • SO — Filtrar para mostrar erros do cliente de sistemas operacionais específicos.
  • Novos erros desde — Filtrar para mostrar apenas novos erros e avisos desde uma certa versão.

Abaixo dos filtros e alternâncias, um gráfico exibe os números de erros e avisos para servidor, cliente e total. Use este gráfico para procurar aumentos em erros e avisos ao longo do tempo. Se você ver um grande aumento em erros e avisos, use a tabela de relatórios de erros para solucionar problemas.

Erros e avisos mostrados ao longo do tempo por categoria

Solucione erros e avisos

A tabela de Erros e avisos possui as seguintes colunas:

ColunaDescrição
ContagemNúmero de erros ou avisos.
SeveridadeRótulo de erro ou aviso.
TipoRótulo de servidor ou cliente.
MensagemMensagem de erro ou aviso.
Primeira visualizaçãoCarimbo de data/hora da primeira visualização da mensagem.
Primeira versãoDisponível apenas quando um lugar é selecionado. Mostra a primeira versão onde a mensagem foi registrada.
A tabela do relatório de erros

Visualize a pilha de chamadas para um erro ou aviso

Se você vir um menu suspenso em um erro ou aviso, clique para expandi-lo e veja sua correspondente pilha de chamadas. Uma pilha de chamadas é uma lista das chamadas que seu jogo estava realizando quando a exceção foi lançada. Isso pode ajudá-lo a descobrir o que está dando errado.

Regras personalizadas

Regras personalizadas permitem definir padrões de regex ou de string exata para ignorar ou agrupar automaticamente erros e avisos. Isso ajuda a gerenciar a relação sinal-ruído de seus relatórios de erros. Você pode criar até 100 regras por experiência. As regras são avaliadas de cima para baixo na ordem de prioridade. Uma vez que um erro corresponda a uma regra, o processamento adicional para.

Ações da regra

Cada regra possui uma das duas ações:

AçãoComportamento
IgnorarOculta erros correspondentes do gráfico e da tabela. Use para ruídos permanentes, como erros de som de motor inevitáveis ou instruções de impressão legadas.
AgruparConsolida todos os erros correspondentes sob um nome de grupo personalizado (por exemplo, "Problemas de Rede", "Spam de Áudio"). O nome do grupo aparece como uma única linha na tabela.

Crie uma regra

Existem duas maneiras de criar uma regra:

A partir da tabela de erros (inline):

  1. Clique no menu de contexto (três pontos) em qualquer linha de erro.
  2. Selecione Ignorar.
Ignorando um erro da tabela de erros

A partir da guia de regras:

  1. Navegue até a guia Regras na página de Relatórios de Erros.
  2. Clique em Criar Regra.
  3. Insira um padrão (string exata ou regex).
  4. Selecione uma ação: Ignorar ou Agrupar → [Nome do Grupo].
  5. Salve a regra.
A guia Regras mostrando regras de exemplo

Campos de criação de regra

CampoDescrição
PadrãoA string exata ou expressão regular a ser correspondida contra mensagens de erro.
AçãoEscolha Ignorar (ocultar o erro) ou Agrupar → insira um nome de grupo personalizado.
A caixa de diálogo Criar regra

As regras são avaliadas de cima para baixo com base na ordem de prioridade na guia Regras. Uma vez que um erro corresponda a uma regra, a ação dessa regra é executada e nenhuma regra adicional é avaliada para esse erro. Isso evita conflitos, como um erro sendo agrupado por uma regra e depois ignorado por uma regra subsequente.

As regras apenas impactam erros registrados após serem salvas. Uma anotação aparece no seu gráfico quando as regras são modificadas.

Noções básicas de expressões regulares

Uma expressão regular (regex) é um padrão que corresponde a texto:

SintaxeSignificadoExemplo
.Qualquer caractere únicoH.t corresponde a "Hat", "Hit", "Hot"
*Zero ou mais do caractere anteriorgo*d corresponde a "gd", "god", "good"
+Um ou mais do caractere anteriorgo+d corresponde a "god", "good", mas não "gd"
.*Qualquer sequência de caracteres (coringa)Failed.*load corresponde a "Failed to load" e "Failed xyz load"
\dQualquer dígito (0-9)v\d+ corresponde a "v1", "v123", "v4488"
\wQualquer caractere de palavra (letras, dígitos, sublinhado)\w+ corresponde a "Player123", "my_var"
^Início da string^HTTP corresponde a erros começando com "HTTP"
\/Uma barra diagonal escapadarbxassetid:\/\/ corresponde a "rbxassetid://"
\[ e \]Colchetes escapados (correspondência literal)\[Knit\] corresponde a "[Knit]"
(a|b)Correspondência "a" ou "b"(Error|Warning):.* corresponde a "Error: ..." e "Warning: ..."

Dicas rápidas:

  • Comece com uma correspondência exata (a string completa do erro) se você quiser capturar apenas um erro específico.
  • Use uma regex quando quiser capturar uma família de erros semelhantes (por exemplo, todas as falhas de carregamento de som, independentemente do ID do ativo).
  • Teste seu padrão contra algumas strings de erro reais antes de salvar para garantir que ele captura o que você espera.

O sistema impõe duas regras aos seus padrões de regex:

  • Você não pode colocar um repetidor (+ ou *) dentro de um grupo repetido. Por exemplo, (a+)* ou (\w+)+ são rejeitados.
  • Deve começar com texto ancorado: Padrões não podem começar com um coringa como .* ou .+. Seu padrão deve começar com um caractere concreto ou ancla (como ^ ou uma string literal).

Exemplos de regras para organizar seus relatórios de erros

Em vez de ver dezenas de linhas de erro separadas, consolide erros relacionados sob um único nome de grupo:

Caso de usoExemplos de errosPadrãoAção
Todos os erros de redeHttpError: ConnectFail, HttpError: TimedoutHttpError:.*Agrupar → "Problemas de Rede"
Avisos de DataStoreDataStore request was added to queue, DataStoreService: ...DataStoreAgrupar → "Avisos de DataStore"
Erros de GUI do jogadorPlayers.Player1.PlayerGui.Shop:12: attempt to index nilPlayers\.\w+\.PlayerGuiAgrupar → "Erros de PlayerGui"
Framework UI personalizado[UIManager] Button render failed, [UIManager] Layout overflow\[UIManager\].*Agrupar → "Sistema UI"

Limites de rastreamento de erros

O sistema rastreia até 500 erros únicos e 500 avisos únicos por contagem e os 100 novos erros principais por versão. Essas contagens se reiniciam a cada 6 horas. Para maximizar o rastreamento útil de erros dentro desses limites:

  • Remova identificadores exclusivos das mensagens de erro, como IDs de usuário, coordenadas ou carimbos de data/hora. Erros como Player 12345 failed to load e Player 67890 failed to load contam como duas entradas separadas. Se você registrá-los como Player failed to load, eles se consolidam em uma entrada com uma contagem maior.
  • Use regras personalizadas para agrupar erros relacionados que diferem apenas por valores dinâmicos.

Resolva erros e avisos

Ao investigar erros a partir da página de Relatórios de Erros, use as seguintes abordagens:

  1. Revise as pilhas de chamadas — Expanda as linhas de erro para ver o caminho de chamada e identificar o script exato e o número da linha onde o erro ocorreu.
  2. Verifique atualizações recentes — Monitore novos erros desde sua atualização mais recente.
  3. Use ferramentas integradas:
    • Console do Desenvolvedor (F9 no jogo): Veja erros ao vivo em tempo real e teste correções.
    • Profiler de Script: Identifique erros relacionados ao desempenho causados por operações caras.
    • Janela de Saída no Estúdio — Capture erros durante o desenvolvimento antes da publicação.
  4. Use desagregações — Verifique se o erro é específico para uma plataforma (Desktop, Móvel, Console) ou SO (Windows, macOS, iOS, Android).
  5. Reúna feedback da comunidade — Se você tiver um Discord da comunidade ou post no DevForum, verifique se os jogadores estão relatando o problema e quais dispositivos ou regiões estão afetados.
©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.