Cómo comprobar los registros de txAdmin en busca de errores

txAdmin mantiene tres tipos de archivos de registro persistentes en el txData/ /registros/ Directorio: registros de administración para acciones administrativas, registros de fxserver para la salida de la consola y registros del servidor para eventos del juego. Estos registros son esenciales para diagnosticar problemas del servidor, rastrear la actividad de los jugadores y supervisar el rendimiento del sistema.

Público objetivo: Administradores de servidores de FiveM utilizando txAdmin v4.6.0 o más reciente con capacidades de rotación de registros.

Tipos y ubicaciones de registros

Estructura de archivos

txData/ └── / └── registros/ ├── administrador/ ├── fxserver/ └── servidor/

Categorías de registro

Registros de administración (administración/Contiene el registro de acciones administrativas, así como algunas automatizadas, como reinicios del servidor, bloqueos, advertencias, cambios de configuración y entradas de consola en tiempo real. No registra las direcciones IP de los usuarios, excepto las de los endpoints de autenticación.

Registros de FXServer (fxserver/) Contiene el registro de todo lo que sucede en la consola de fxserver (entrada estándar, salida estándar, salida estándar). Cualquier entrada de consola en tiempo real tiene el prefijo >.

Registros del servidor (servidor/) Contiene todas las acciones que ocurren dentro del servidor, por ejemplo, los jugadores se unen/salen/mueren, mensajes de chat, explosiones, eventos de menú, comandos.

Acceso al registro de la interfaz web

Método 1: Consola en vivo

1. Acceda a su panel web txAdmin en http://ip-de-su-servidor:puerto
2. Navegar a Consola en vivo en la barra lateral
3. Supervisar las actividades del servidor en tiempo real, las advertencias y los mensajes de error para solucionar problemas de depuración.
4. Busque entradas marcadas con [ERROR], [ADVERTIR], o [CRÍTICO]

Método 2: Visor de registros del servidor

1. Ir a Registro del servidor en el menú de la barra lateral
2. Supervisar todas las actividades en el servidor, incluidas las conexiones de jugadores, los mensajes de chat, las muertes en el juego, las acciones del menú, los comandos ejecutados y los eventos del sistema.
3. Utilice las opciones de filtro para aislar los mensajes de error
4. Exportar secciones del registro para un análisis detallado

Método 3: Registro de acciones

1. Navegar a Ajustes → Diagnóstico
2. Ver el Registro de acciones, que registra todas las acciones realizadas por txAdmin o cualquier administrador
3. Comprobar acciones administrativas fallidas o errores del sistema

Acceso a registros basados en archivos

Lectura directa de archivos

# Navegue al directorio de registros cd txData/ /logs/ # Ver errores recientes en los registros de fxserver tail -100 fxserver/fxserver-YYYY-MM-DD.log | grep -i error # Buscar patrones de error específicos grep -r "ERROR\|WARN\|CRITICAL" ./ # Supervisar registros en tiempo real tail -f fxserver/fxserver-$(date +%Y-%m-%d).log

Convención de nomenclatura de archivos de registro

• Los archivos siguen el patrón: -AAAA-MM-DD.log
• Ejemplo: fxserver-2025-06-10.log

Patrones de error comunes

Errores de carga de recursos

[ERROR] No se pudo iniciar el recurso 'resource_name' [ERROR] No se pudieron cargar los metadatos del recurso para resource_name [WARN] El recurso resource_name está usando una sintaxis obsoleta

Problemas de conexión a la base de datos

[ERROR] Falló la conexión a MySQL [ERROR] No se pudo ejecutar la consulta [WARN] Se agotó el tiempo de conexión a la base de datos

Errores relacionados con el jugador

Las fuentes de los reproductores se mantienen en el formato [mutex#id] nombre Donde el mutex es un identificador de la ejecución de ese servidor. Buscar [mutex#id] Para encontrar al jugador inicial, únete con todos los identificadores.

Problemas de memoria y rendimiento

[ADVERTENCIA] Se detectó un uso elevado de memoria [ERROR] Tiempo de espera de script en resource_name [CRÍTICO] Se detectó una sobrecarga del servidor

Configuración de registro

Configuración de rotación

Edita tu txData/ /config.json y agregue un objeto dentro del registrador con la clave siendo una de [admin, fxserver, servidor]. Configure las opciones de rotación según las Referencia de la biblioteca de flujo de archivos rotatorios.

Ejemplo de configuración:

{ "logger": { "fxserver": { "tamaño": "10M", "intervalo": "1d", "comprimir": "gzip" } } }

Registro detallado

Colocar txAdminVerbose a verdadero Para imprimir en la consola información más detallada sobre errores y eventos:

# Windows ./FXServer.exe +establecer txAdminVerbose verdadero # Linux ./run.sh +establecer txAdminVerbose verdadero

Solución de problemas específicos

txAdmin no responde

Si obtienes “¡FXServer no responde!Significa que txAdmin:Monitor no pudo conectarse a FXServer. Las causas incluyen:

• FXServer atascado en un recurso
• Conflictos de puertos entre FXServer y txAdmin
• Comprobación del estado que devuelve errores 404

Problemas de permisos

Si aparece el mensaje "no se puede leer el archivo", el archivo de administración txData/admins.json no existe o txAdmin no tiene permiso para leerlo.

Errores de carga del perfil

Selected profile cannot be loaded due to permission issues or broken JSON.
Delete corrupted files and restart txAdmin to regenerate.

Mejores prácticas

1. Revisión periódica del registro: Revise los registros diariamente para detectar advertencias acumuladas
2. Monitoreo automatizado:Configurar alertas para patrones de errores críticos
3. Retención de registros:Configure la rotación adecuada según la actividad del servidor
4. Registros de respaldo:Incluir directorios de registro en los procedimientos de copia de seguridad
5. Correlación de marcas de tiempo: Utilice marcas de tiempo para correlacionar eventos entre diferentes tipos de registros
6. Make sure your server configuration is right: Server.cfg Tutorial

Recursos externos

• Documentación oficial de txAdmin – Referencia principal para las características y configuración de txAdmin
• Repositorio txAdmin GitHub – Código fuente y seguimiento de problemas
• Manual del servidor FiveM – Guía completa de configuración del servidor

Nota de incertidumbreLas especificaciones del formato de registro pueden variar entre las versiones de txAdmin; verifique siempre con su versión instalada.

La monitorización sistemática de registros a través de la interfaz web de txAdmin y el acceso directo a los archivos permiten la identificación proactiva de problemas del servidor antes de que afecten la experiencia del jugador.

https://fivemx.com/fivem-error-codes-fixes/