Informe de Errores te permite ver errores y advertencias del sistema Luau en tiempo real, tanto para el servidor como para el cliente. Monitorea tu informe de errores antes y después de actualizar tu juego para identificar problemas potenciales temprano.
Ver tu informe de errores
Para ver el informe de errores de tu juego:
- Navega a tu página de Creaciones en el Tablero de Creadores y selecciona tu juego.
- Bajo Monitoreo, selecciona Informe de Errores.
Puedes ver análisis para experiencias individuales o pertenecientes a grupos. Para ver las del grupo, necesitas tener permisos de grupo para análisis.
Monitorear errores y advertencias
Puedes aplicar los siguientes filtros y alternancias a tu informe de errores:
- Rango de fechas — Filtrar por la última 1 hora, 1 día, 7 días, o 30 días.
- Lugar — Filtrar por lugar.
- Mostrar versión — Añade anotaciones de la versión del lugar al gráfico de errores y advertencias.
- Severidad — Filtrar para mostrar errores, advertencias, o ambos.
- Plataforma — Filtrar para mostrar errores del cliente de dispositivos específicos.
- SO — Filtrar para mostrar errores del cliente de sistemas operativos específicos.
- Nuevos errores desde — Filtrar para mostrar solo nuevos errores y advertencias desde una cierta versión.
Debajo de los filtros y alternancias, un gráfico muestra el número de errores y advertencias para el servidor, el cliente, y el total. Utiliza este gráfico para buscar aumentos en errores y advertencias con el tiempo. Si ves un gran aumento en errores y advertencias, utiliza la tabla de informes de errores para solucionar problemas.
Solucionar errores y advertencias
La tabla de Errores y Advertencias tiene las siguientes columnas:
| Columna | Descripción |
|---|---|
| Conteo | Número de errores o advertencias. |
| Severidad | Etiqueta de error o advertencia. |
| Tipo | Etiqueta de servidor o cliente. |
| Mensaje | Mensaje de error o advertencia. |
| Primero visto en | Marca de tiempo del primer avistamiento del mensaje. |
| Primera versión vista | Solo disponible cuando se elige un lugar. Muestra la primera versión donde se registró el mensaje. |
Ver el rastro de la pila para un error o advertencia
Si ves un menú desplegable en un error o advertencia, haz clic para expandirlo y ver su correspondiente rastro de pila. Un rastro de pila es una lista de las llamadas que tu juego estaba realizando cuando se lanzó la excepción. Esto puede ayudarte a descubrir qué está mal.
Reglas personalizadas
Las reglas personalizadas te permiten definir patrones de expresiones regulares o cadenas exactas para ignorar o agrupar automáticamente errores y advertencias. Esto te ayuda a gestionar la relación señal-ruido de tus informes de errores. Puedes crear hasta 100 reglas por experiencia. Las reglas se evalúan de arriba hacia abajo en orden de prioridad. Una vez que un error coincide con una regla, el procesamiento adicional se detiene.
Acciones de regla
Cada regla tiene una de dos acciones:
| Acción | Comportamiento |
|---|---|
| Ignorar | Oculta errores coincidentes del gráfico y de la tabla. Úsalo para ruido permanente como errores de sonido del motor inevitables o declaraciones de impresión heredadas. |
| Agrupar | Consolida todos los errores coincidentes bajo un nombre de grupo personalizado (p. ej., "Problemas de Red", "Spam de Audio"). El nombre del grupo aparece como una sola fila en la tabla. |
Crear una regla
Hay dos formas de crear una regla:
Desde la tabla de errores (en línea):
- Haz clic en el menú contextual (tres puntos) en cualquier fila de error.
- Selecciona Ignorar.
Desde la pestaña de reglas:
- Navega a la pestaña Reglas en la página de Informes de Errores.
- Haz clic en Crear Regla.
- Ingresa un patrón (cadena exacta o regex).
- Selecciona una acción: Ignorar o Agrupar → [Nombre del Grupo].
- Guarda la regla.
Campos de creación de reglas
| Campo | Descripción |
|---|---|
| Patrón | La cadena exacta o expresión regular para coincidir con los mensajes de error. |
| Acción | Elige Ignorar (ocultar el error) o Agrupar → ingresa un nombre de grupo personalizado. |
Las reglas se evalúan de arriba hacia abajo según el orden de prioridad en la pestaña de Reglas. Una vez que un error coincide con una regla, se ejecuta la acción de esa regla y no se evalúan más reglas para ese error. Esto previene conflictos como que un error sea agrupado por una regla y luego ignorado por una regla subsiguiente.
Las reglas solo afectan los errores registrados después de ser guardadas. Una anotación aparece en tu gráfico cuando se modifican las reglas.
Conceptos básicos de expresiones regulares
Una expresión regular (regex) es un patrón que coincide con texto:
| Sintaxis | Significado | Ejemplo |
|---|---|---|
| . | Cualquier carácter único | H.t coincide con "Hat", "Hit", "Hot" |
| * | Cero o más del carácter precedente | go*d coincide con "gd", "god", "good" |
| + | Uno o más del carácter precedente | go+d coincide con "god", "good", pero no con "gd" |
| .* | Cualquier secuencia de caracteres (comodín) | Failed.*load coincide con "Failed to load" y "Failed xyz load" |
| \d | Cualquier dígito (0-9) | v\d+ coincide con "v1", "v123", "v4488" |
| \w | Cualquier carácter de palabra (letras, dígitos, guion bajo) | \w+ coincide con "Player123", "my_var" |
| ^ | Inicio de la cadena | ^HTTP coincide con errores que comienzan con "HTTP" |
| \/ | Una barra diagonal escapada | rbxassetid:\/\/ coincide con "rbxassetid://" |
| \[ y \] | Corchetes cuadrados escapados (coincidencia literal) | \[Knit\] coincide con "[Knit]" |
| (a|b) | Coincide "a" o "b" | (Error|Warning):.* coincide con "Error: ..." y "Warning: ..." |
Consejos rápidos:
- Comienza con una coincidencia exacta (la cadena completa de error) si solo quieres capturar un error específico.
- Usa una regex cuando quieras atrapar una familia de errores similares (p. ej., todas las fallas de carga de sonido independientemente del ID de activo).
- Prueba tu patrón contra algunas cadenas de error reales antes de guardarlo para asegurarte de que capture lo que esperas.
El sistema impone dos reglas en tus patrones de regex:
- No puedes poner un repetidor (+ o *) dentro de un grupo repetido. Por ejemplo, (a+)* o (\w+)+ son rechazados.
- Debe comenzar con texto anclado: los patrones no pueden comenzar con un comodín como .* o .+. Tu patrón debe comenzar con un carácter concreto o ancla (como ^ o una cadena literal).
Ejemplos de reglas para organizar tus informes de errores
En lugar de ver docenas de filas de errores separadas, consolida errores relacionados bajo un nombre de grupo:
| Caso de uso | Errores de ejemplo | Patrón | Acción |
|---|---|---|---|
| Todos los errores de red | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | Agrupar → "Problemas de Red" |
| Advertencias de DataStore | DataStore request was added to queue, DataStoreService: ... | DataStore | Agrupar → "Advertencias de DataStore" |
| Errores de GUI de jugador | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | Agrupar → "Errores de PlayerGui" |
| Marco de UI personalizado | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | Agrupar → "Sistema de UI" |
Límites de seguimiento de errores
El sistema rastrea hasta 500 errores únicos y 500 advertencias únicos por conteo y los 100 nuevos errores por versión. Estos conteos se reinician cada 6 horas. Para maximizar el seguimiento útil de errores dentro de estos límites:
- Elimina identificadores únicos de los mensajes de error, como IDs de usuario, coordenadas o marcas de tiempo. Errores como El jugador 12345 falló en cargar y El jugador 67890 falló en cargar cuentan como dos entradas separadas. Si los registras como El jugador falló en cargar, se consolidan en una entrada con un conteo más alto.
- Usa reglas personalizadas para agrupar errores relacionados que solo difieren por valores dinámicos.
Resolver errores y advertencias
Al investigar errores desde la página de Informes de Errores, utiliza los siguientes enfoques:
- Revisa los rastros de pila — Expande las filas de errores para ver la ruta de llamada e identificar el script exacto y el número de línea donde ocurrió el error.
- Verifica actualizaciones recientes — Monitorea nuevos errores desde tu actualización más reciente.
- Usa herramientas integradas:
- Consola de Desarrollador (F9 en el juego): Ve errores en tiempo real y prueba correcciones.
- Profiler de Scripts: Identifica errores relacionados con el rendimiento causados por operaciones costosas.
- Ventana de Salida en Studio — Captura errores durante el desarrollo antes de publicar.
- Usa desgloses — Comprueba si el error es específico de una plataforma (Escritorio, Móvil, Consola) o SO (Windows, macOS, iOS, Android).
- Recoge retroalimentación de la comunidad — Si tienes un Discord comunitario o publicación en DevForum, verifica si los jugadores están informando del problema y qué dispositivos o regiones están afectados.