Rapporto Errori ti consente di visualizzare errori e avvisi del sistema Luau in tempo reale sia per il server che per il client. Monitora il tuo rapporto sugli errori prima e dopo l'aggiornamento del tuo gioco per identificare potenziali problemi precocemente.
Visualizza il tuo rapporto errori
Per visualizzare il rapporto errori del tuo gioco:
- Naviga alla tua pagina Creazioni nel Creator Dashboard e seleziona il tuo gioco.
- Sotto Monitoraggio, seleziona Rapporto Errori.
Puoi visualizzare le analisi per esperienze di proprietà individuale o di gruppo. Per visualizzare quest'ultima, devi avere permessi di gruppo per le analisi.
Monitora errori e avvisi
Puoi applicare i seguenti filtri e interruttori al tuo rapporto errori:
- Intervallo di date — Filtra per ultime 1 ora, ultime 1 giorno, ultime 7 giorni o ultime 30 giorni.
- Luogo — Filtra per luogo.
- Mostra versione — Aggiunge annotazioni sulla versione del luogo al grafico di errori e avvisi.
- Gravità — Filtra per mostrare errori, avvisi o entrambi.
- Piattaforma — Filtra per mostrare errori del client provenienti da dispositivi specifici.
- OS — Filtra per mostrare errori del client provenienti da sistemi operativi specifici.
- Nuovi errori da — Filtra per mostrare solo nuovi errori e avvisi da una certa versione.
Sotto i filtri e gli interruttori, un grafico visualizza il numero di errori e avvisi per server, client e totale. Usa questo grafico per cercare aumenti di errori e avvisi nel tempo. Se vedi un grande picco in errori e avvisi, utilizza la tabella del rapporto errori per risolvere il problema.
Risolvi errori e avvisi
La tabella degli Errori e avvisi ha le seguenti colonne:
| Colonna | Descrizione |
|---|---|
| Conteggio | Numero di errori o avvisi. |
| Gravità | Etichetta di errore o avviso. |
| Tipo | Etichetta server o client. |
| Messaggio | Messaggio di errore o avviso. |
| Prima vista a | Timestamp della prima vista del messaggio. |
| Prima versione vista | Disponibile solo quando un luogo è selezionato. Mostra la prima versione in cui il messaggio è stato registrato. |
Visualizza il tracciato degli errori o avvisi
Se vedi un menu a discesa su un errore o avviso, fai clic per espanderlo e vedere il suo corrispondente tracciato degli errori. Un tracciato degli errori è un elenco delle chiamate che il tuo gioco stava eseguendo quando è stata generata l'eccezione. Questo può aiutarti a capire cosa sta andando storto.
Regole personalizzate
Le regole personalizzate ti consentono di definire modelli regex o stringhe esatte per ignorare automaticamente o raggruppare errori e avvisi. Questo ti aiuta a gestire il rapporto segnale-rumore dei tuoi rapporti sugli errori. Puoi creare fino a 100 regole per esperienza. Le regole vengono valutate dall'alto verso il basso in ordine di priorità. Una volta che un errore corrisponde a una regola, il trattamento successivo si interrompe.
Azioni della regola
Ogni regola ha una delle due azioni:
| Azione | Comportamento |
|---|---|
| Ignora | Nasconde gli errori corrispondenti dal grafico e dalla tabella. Utilizza per rumori permanenti come errori di suono inevitabili o dichiarazioni di stampa legacy. |
| Gruppo | Consolida tutti gli errori corrispondenti sotto un nome di gruppo personalizzato (es. "Problemi di rete", "Spam audio"). Il nome del gruppo appare come una singola riga nella tabella. |
Crea una regola
Ci sono due modi per creare una regola:
Dalla tabella degli errori (inline):
- Fai clic sul menu contestuale (tre punti) su qualsiasi riga di errore.
- Seleziona Ignora.
Dalla scheda regole:
- Naviga alla scheda Regole nella pagina dei Rapporti Errori.
- Fai clic su Crea Regola.
- Inserisci un modello (stringa esatta o regex).
- Seleziona un'azione: Ignora o Gruppo → [Nome Gruppo].
- Salva la regola.
Campi di creazione regole
| Campo | Descrizione |
|---|---|
| Modello | La stringa esatta o l'espressione regolare da abbinare ai messaggi di errore. |
| Azione | Scegli Ignora (nascondi l'errore) o Gruppo → inserisci un nome di gruppo personalizzato. |
Le regole vengono valutate dall'alto verso il basso in base all'ordine di priorità nella scheda Regole. Una volta che un errore corrisponde a una regola, l'azione di quella regola viene eseguita e non vengono valutate ulteriori regole per quell'errore. Questo previene conflitti come un errore raggruppato da una regola e poi ignorato da una regola successiva.
Le regole influiscono solo sugli errori registrati dopo che sono state salvate. Un'annotazione appare nel tuo grafico quando le regole vengono modificate.
Fondamenti delle espressioni regolari
Un'espressione regolare (regex) è un modello che corrisponde al testo:
| Sintassi | Significato | Esempio |
|---|---|---|
| . | Qualsiasi singolo carattere | H.t corrisponde a "Hat", "Hit", "Hot" |
| * | Zero o più del carattere precedente | go*d corrisponde a "gd", "god", "good" |
| + | Uno o più del carattere precedente | go+d corrisponde a "god", "good", ma non a "gd" |
| .* | Qualsiasi sequenza di caratteri (carattere jolly) | Failed.*load corrisponde a "Failed to load" e "Failed xyz load" |
| \d | Qualsiasi cifra (0-9) | v\d+ corrisponde a "v1", "v123", "v4488" |
| \w | Qualsiasi carattere alfanumerico (lettere, cifre, underscore) | \w+ corrisponde a "Player123", "my_var" |
| ^ | Inizio della stringa | ^HTTP corrisponde a errori che iniziano con "HTTP" |
| \/ | Slash in avanti sfuggito | rbxassetid:\/\/ corrisponde a "rbxassetid://" |
| \[ e \] | Parentesi quadre sfuggite (corrispondenza letterale) | \[Knit\] corrisponde a "[Knit]" |
| (a|b) | Corrisponde a "a" o "b" | (Error|Warning):.* corrisponde sia a "Error: ..." sia a "Warning: ..." |
Consigli rapidi:
- Inizia con una corrispondenza esatta (l'intera stringa di errore) se vuoi catturare solo un errore specifico.
- Usa una regex quando vuoi catturare una famiglia di errori simili (es. tutti i fallimenti nel caricamento audio indipendentemente dall'ID dell'asset).
- Testa il tuo modello contro alcune vere stringhe di errore prima di salvare per assicurarti che catturi ciò che ti aspetti.
Il sistema impone due regole sui tuoi modelli regex:
- Non puoi mettere un ripetitore (+ o *) all'interno di un gruppo ripetuto. Ad esempio, (a+)* o (\w+)+ vengono rifiutati.
- Deve iniziare con testo ancorato: i modelli non possono iniziare con un carattere jolly come .* o .+. Il tuo modello deve iniziare con un carattere concreto o un'ancora (come ^ o una stringa letterale).
Esempi di regole per organizzare i tuoi rapporti sugli errori
Invece di vedere dozzine di righe di errore separate, consolida errori correlati sotto un unico nome di gruppo:
| Caso d'uso | Errori di esempio | Modello | Azione |
|---|---|---|---|
| Tutti gli errori di rete | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Gruppo → "Problemi di rete" |
| Avvisi DataStore | DataStore request was added to queue, DataStoreService: ... | DataStore | Gruppo → "Avvisi DataStore" |
| Errori GUI giocatore | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Gruppo → "Errori PlayerGui" |
| Framework UI personalizzato | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Gruppo → "Sistema UI" |
Limiti di tracciamento errori
Il sistema tiene traccia di un massimo di 500 errori unici e 500 avvisi unici per conteggio e dei 100 nuovi errori per versione. Questi conteggi si azzerano ogni 6 ore. Per massimizzare il tracciamento utile degli errori all'interno di questi limiti:
- Rimuovi identificatori unici dai messaggi di errore, come ID utente, coordinate o timestamp. Gli errori come Player 12345 failed to load e Player 67890 failed to load contano come due voci separate. Se li registri come Player failed to load, si consolidano in un'unica voce con un conteggio più alto.
- Usa regole personalizzate per raggruppare errori correlati che differiscono solo per valori dinamici.
Risolvere errori e avvisi
Quando indaghi sugli errori dalla pagina Rapporti Errori, usa i seguenti approcci:
- Esamina i tracciati degli errori — Espandi le righe di errore per vedere il percorso di chiamata e identificare il preciso script e numero di riga in cui si è verificato l'errore.
- Controlla gli aggiornamenti recenti — Monitora nuovi errori dalla tua ultima aggiornamento.
- Usa strumenti integrati:
- Console Sviluppatore (F9 in gioco): Visualizza errori dal vivo in tempo reale e testa le correzioni.
- Profiler Script: Identifica errori relativi alle prestazioni causati da operazioni costose.
- Finestra di output in Studio — Rileva errori durante lo sviluppo prima della pubblicazione.
- Usa breakdown — Controlla se l'errore è specifico per una piattaforma (Desktop, Mobile, Console) o OS (Windows, macOS, iOS, Android).
- Raccogli feedback dalla comunità — Se hai un Discord della comunità o un post su DevForum, controlla se i giocatori segnalano il problema e quali dispositivi o regioni sono interessati.