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.
Solucione erros e avisos
A tabela de Erros e avisos possui as seguintes colunas:
| Coluna | Descrição |
|---|---|
| Contagem | Número de erros ou avisos. |
| Severidade | Rótulo de erro ou aviso. |
| Tipo | Rótulo de servidor ou cliente. |
| Mensagem | Mensagem de erro ou aviso. |
| Primeira visualização | Carimbo de data/hora da primeira visualização da mensagem. |
| Primeira versão | Disponível apenas quando um lugar é selecionado. Mostra a primeira versão onde a mensagem foi registrada. |
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ção | Comportamento |
|---|---|
| Ignorar | Oculta 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. |
| Agrupar | Consolida 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):
- Clique no menu de contexto (três pontos) em qualquer linha de erro.
- Selecione Ignorar.
A partir da guia de regras:
- Navegue até a guia Regras na página de Relatórios de Erros.
- Clique em Criar Regra.
- Insira um padrão (string exata ou regex).
- Selecione uma ação: Ignorar ou Agrupar → [Nome do Grupo].
- Salve a regra.
Campos de criação de regra
| Campo | Descrição |
|---|---|
| Padrão | A string exata ou expressão regular a ser correspondida contra mensagens de erro. |
| Ação | Escolha Ignorar (ocultar o erro) ou Agrupar → insira um nome de grupo personalizado. |
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:
| Sintaxe | Significado | Exemplo |
|---|---|---|
| . | Qualquer caractere único | H.t corresponde a "Hat", "Hit", "Hot" |
| * | Zero ou mais do caractere anterior | go*d corresponde a "gd", "god", "good" |
| + | Um ou mais do caractere anterior | go+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" |
| \d | Qualquer dígito (0-9) | v\d+ corresponde a "v1", "v123", "v4488" |
| \w | Qualquer 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 escapada | rbxassetid:\/\/ 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 uso | Exemplos de erros | Padrão | Ação |
|---|---|---|---|
| Todos os erros de rede | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Agrupar → "Problemas de Rede" |
| Avisos de DataStore | DataStore request was added to queue, DataStoreService: ... | DataStore | Agrupar → "Avisos de DataStore" |
| Erros de GUI do jogador | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Agrupar → "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:
- 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.
- Verifique atualizações recentes — Monitore novos erros desde sua atualização mais recente.
- 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.
- Use desagregações — Verifique se o erro é específico para uma plataforma (Desktop, Móvel, Console) ou SO (Windows, macOS, iOS, Android).
- 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.