Rapport d'erreur vous permet de voir les erreurs et les avertissements Luau du système en temps réel pour le serveur et le client. Surveillez votre rapport d'erreur avant et après avoir mis à jour votre jeu pour identifier les problèmes potentiels tôt.
Voir votre rapport d'erreur
Pour voir le rapport d'erreur de votre jeu :
- Accédez à votre page Créations dans le Tableau de bord Créateur et sélectionnez votre jeu.
- Sous Surveillance, sélectionnez Rapport d'erreur.
Vous pouvez voir des analyses pour des expériences individuelles ou détenues par un groupe. Pour voir ce dernier, vous devez avoir les autorisations de groupe pour les analyses.
Surveiller les erreurs et les avertissements
Vous pouvez appliquer les filtres et options suivants à votre rapport d'erreur :
- Plage de dates — Filtrer par les dernières 1 heure, le dernier 1 jour, les 7 derniers jours ou les 30 derniers jours.
- Lieu — Filtrer par lieu.
- Afficher la version — Ajoute des annotations de version de lieu au graphique des erreurs et des avertissements.
- Sévérité — Filtrer pour afficher des erreurs, des avertissements ou les deux.
- Plateforme — Filtrer pour afficher les erreurs client provenant de dispositifs spécifiques.
- OS — Filtrer pour afficher les erreurs client provenant de systèmes d'exploitation spécifiques.
- Nouvelles erreurs depuis — Filtrer pour afficher uniquement les nouvelles erreurs et avertissements depuis une certaine version.
Sous les filtres et options, un graphique affiche le nombre d'erreurs et d'avertissements pour le serveur, le client, et le total. Utilisez ce graphique pour rechercher les augmentations des erreurs et des avertissements au fil du temps. Si vous voyez un pic important d'erreurs et d'avertissements, utilisez le tableau de rapport d'erreur pour résoudre les problèmes.
Dépanner les erreurs et les avertissements
Le tableau Erreurs et avertissements contient les colonnes suivantes :
| Colonne | Description |
|---|---|
| Compte | Nombre d'erreurs ou d'avertissements. |
| Sévérité | Étiquette d'erreur ou d'avertissement. |
| Type | Étiquette de serveur ou de client. |
| Message | Message d'erreur ou d'avertissement. |
| Premier vu à | Horodatage du premier affichage du message. |
| Version première | Disponible uniquement lorsqu'un lieu est choisi. Montre la première version où le message a été enregistré. |
Voir la trace de pile pour une erreur ou un avertissement
Si vous voyez un menu déroulant sur une erreur ou un avertissement, cliquez pour l'étendre et voir sa trace de pile correspondante. Une trace de pile est une liste des appels que votre jeu effectuait lorsque l'exception a été lancée. Cela peut vous aider à comprendre ce qui ne va pas.
Règles personnalisées
Les règles personnalisées vous permettent de définir des motifs regex ou des chaînes exactes pour ignorer automatiquement ou regrouper les erreurs et les avertissements. Cela vous aide à gérer le rapport signal/bruit de vos rapports d'erreur. Vous pouvez créer jusqu'à 100 règles par expérience. Les règles sont évaluées de haut en bas par ordre de priorité. Une fois qu'une erreur correspond à une règle, le traitement supplémentaire s'arrête.
Actions de règle
Chaque règle a l'une des deux actions :
| Action | Comportement |
|---|---|
| Ignorer | Masque les erreurs correspondantes du graphique et du tableau. Utilisé pour le bruit permanent tel que les erreurs de son moteur inévitables ou les instructions d'impression héritées. |
| Regrouper | Regroupe toutes les erreurs correspondantes sous un nom de groupe personnalisé (par exemple, "Problèmes de réseau", "Spam audio"). Le nom du groupe apparaît comme une seule ligne dans le tableau. |
Créer une règle
Il existe deux façons de créer une règle :
À partir du tableau des erreurs (en ligne) :
- Cliquez sur le menu contextuel (trois points) sur n'importe quelle ligne d'erreur.
- Sélectionnez Ignorer.
À partir de l'onglet des règles :
- Accédez à l'onglet Règles sur la page des rapports d'erreur.
- Cliquez sur Créer une règle.
- Entrez un motif (chaîne exacte ou regex).
- Sélectionnez une action : Ignorer ou Regrouper → [Nom du groupe].
- Enregistrez la règle.
Champs de création de règle
| Champ | Description |
|---|---|
| Motif | La chaîne exacte ou l'expression régulière à faire correspondre aux messages d'erreur. |
| Action | Choisissez Ignorer (masquer l'erreur) ou Regrouper → entrez un nom de groupe personnalisé. |
Les règles sont évaluées de haut en bas en fonction de l'ordre de priorité dans l'onglet Règles. Une fois qu'une erreur correspond à une règle, l'action de cette règle est exécutée et aucune règle supplémentaire n'est évaluée pour cette erreur. Cela empêche les conflits tels qu'une erreur regroupée par une règle puis ignorée par une règle suivante.
Les règles n'impactent que les erreurs enregistrées après leur sauvegarde. Une annotation apparaît sur votre graphique lorsque les règles sont modifiées.
Notions de base sur les expressions régulières
Une expression régulière (regex) est un motif qui correspond à du texte :
| Syntaxe | Signification | Exemple |
|---|---|---|
| . | Tout caractère unique | H.t correspond à "Hat", "Hit", "Hot" |
| * | Zéro ou plusieurs du caractère précédent | go*d correspond à "gd", "god", "good" |
| + | Un ou plusieurs du caractère précédent | go+d correspond à "god", "good", mais pas "gd" |
| .* | Toute séquence de caractères (caractère générique) | Failed.*load correspond à "Failed to load" et "Failed xyz load" |
| \d | Tout chiffre (0-9) | v\d+ correspond à "v1", "v123", "v4488" |
| \w | Tout caractère de mot (lettres, chiffres, trait de soulignement) | \w+ correspond à "Player123", "my_var" |
| ^ | Début de la chaîne | ^HTTP correspond aux erreurs commençant par "HTTP" |
| \/ | Un slash avant échappé | rbxassetid:\/\/ correspond à "rbxassetid://" |
| \[ et \] | Crochets carrés échappés (correspondance littérale) | \[Knit\] correspond à "[Knit]" |
| (a|b) | Correspond à "a" ou "b" | (Error|Warning):.* correspond à "Error: ..." et "Warning: ..." |
Conseils rapides :
- Commencez par une correspondance exacte (la chaîne d'erreur complète) si vous ne voulez capturer qu'une seule erreur spécifique.
- Utilisez une regex lorsque vous souhaitez capturer une famille d'erreurs similaires (par exemple, tous les échecs de chargement sonore, quels que soient l'ID de l'actif).
- Testez votre motif avec quelques vraies chaînes d'erreur avant de sauvegarder pour vous assurer qu'il capte ce que vous attendez.
Le système impose deux règles à vos motifs regex :
- Vous ne pouvez pas mettre un répétiteur (+ ou *) dans un groupe répétitif. Par exemple, (a+)* ou (\w+)+ sont rejetés.
- Doit commencer par un texte ancré : Les motifs ne peuvent pas commencer par un caractère générique comme .* ou .+. Votre motif doit commencer par un caractère concret ou un ancre (comme ^ ou une chaîne littérale).
Exemples de règles pour organiser vos rapports d'erreur
Au lieu de voir des dizaines de lignes d'erreurs séparées, regroupez des erreurs connexes sous un même nom de groupe :
| Cas d'utilisation | Exemples d'erreurs | Motif | Action |
|---|---|---|---|
| Toutes les erreurs réseau | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Regrouper → "Problèmes de réseau" |
| Avertissements de DataStore | DataStore request was added to queue, DataStoreService: ... | DataStore | Regrouper → "Avertissements de DataStore" |
| Erreurs de GUI de joueur | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Regrouper → "Erreurs de PlayerGui" |
| Cadre UI personnalisé | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Regrouper → "Système UI" |
Limites de suivi des erreurs
Le système suit jusqu'à 500 erreurs uniques et 500 avertissements uniques par nombre et les 100 nouvelles erreurs par version. Ces comptes se réinitialisent toutes les 6 heures. Pour maximiser le suivi utile des erreurs dans ces limites :
- Supprimez les identifiants uniques des messages d'erreur, tels que les identifiants d'utilisateur, les coordonnées ou les horodatages. Les erreurs comme Player 12345 failed to load et Player 67890 failed to load comptent comme deux entrées séparées. Si vous les consignez comme Player failed to load, elles se consolident en une seule entrée avec un compte plus élevé.
- Utilisez des règles personnalisées pour regrouper les erreurs connexes qui diffèrent uniquement par des valeurs dynamiques.
Résoudre les erreurs et les avertissements
Lorsque vous enquêtez sur les erreurs depuis la page des Rapports d'erreur, utilisez les approches suivantes :
- Examiner les traces de pile — Développez les lignes d'erreur pour voir le chemin d'appel et identifier le script exact et le numéro de ligne où l'erreur s'est produite.
- Vérifiez les mises à jour récentes — Surveillez les nouvelles erreurs depuis votre mise à jour la plus récente.
- Utilisez les outils intégrés :
- Console Développeur (F9 en jeu) : Affichez les erreurs en direct en temps réel et testez vos corrections.
- Profileur de script : Identifiez les erreurs liées aux performances causées par des opérations coûteuses.
- Fenêtre de sortie dans Studio — Attrapez les erreurs pendant le développement avant la publication.
- Utilisez les analyses — Vérifiez si l'erreur est spécifique à une plateforme (Bureau, Mobile, Console) ou OS (Windows, macOS, iOS, Android).
- Rassemblez les retours de la communauté — Si vous avez un Discord communautaire ou un article sur DevForum, vérifiez si les joueurs signalent le problème et quels dispositifs ou régions sont affectés.