txAdmin mantiene tres tipos de archivos de registro persistentes en el txData/<profile>/logs/ 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.
Log Types and Locations
Estructura de archivos
txData/ └── <profile>/ └── logs/ ├── admin/ ├── fxserver/ └── server/
Categorías de registro
Registros de administración (admin/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 (server/) 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
- Acceda a su panel web txAdmin en
http://your-server-ip:port - Navegar a Consola en vivo en la barra lateral
- Supervisar las actividades del servidor en tiempo real, las advertencias y los mensajes de error para solucionar problemas de depuración.
- Busque entradas marcadas con
[ERROR],[WARN], o[CRITICAL]
Método 2: Visor de registros del servidor
- Ir a Registro del servidor en el menú de la barra lateral
- 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.
- Utilice las opciones de filtro para aislar los mensajes de error
- Exportar secciones del registro para un análisis detallado
Método 3: Registro de acciones
- Navegar a Ajustes → Diagnóstico
- Ver el Registro de acciones, que registra todas las acciones realizadas por txAdmin o cualquier administrador
- Comprobar acciones administrativas fallidas o errores del sistema
Acceso a registros basados en archivos
Lectura directa de archivos
# Navigate to logs directory cd txData/<your-profile>/logs/ # View recent errors in fxserver logs tail -100 fxserver/fxserver-YYYY-MM-DD.log | grep -i error # Search for specific error patterns grep -r "ERROR|WARN|CRITICAL" ./ # Monitor logs in real-time tail -f fxserver/fxserver-$(date +%Y-%m-%d).log
Convención de nomenclatura de archivos de registro
- Los archivos siguen el patrón:
<type>-YYYY-MM-DD.log - Ejemplo:
fxserver-2025-06-10.log
Patrones de error comunes
Errores de carga de recursos
[ERROR] Failed to start resource 'resource_name' [ERROR] Could not load resource metadata for resource_name [WARN] Resource resource_name is using deprecated syntax
Problemas de conexión a la base de datos
[ERROR] MySQL connection failed [ERROR] Could not execute query [WARN] Connection to database timed out
Errores relacionados con el jugador
Las fuentes de los reproductores se mantienen en el formato [mutex#id] name 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
[WARN] High memory usage detected [ERROR] Script timeout in resource_name [CRITICAL] Server overload detected
Configuración de registro
Configuración de rotación
Edita tu txData/<profile>/config.json y agregue un objeto dentro del registrador con la clave siendo una de [admin, fxserver, server]. Configure las opciones de rotación según las Referencia de la biblioteca de flujo de archivos rotatorios.
Ejemplo de configuración:
{
"logger": {
"fxserver": {
"size": "10M",
"interval": "1d",
"compress": "gzip"
}
}
}
Registro detallado
Colocar txAdminVerbose a true Para imprimir en la consola información más detallada sobre errores y eventos:
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
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 recibe “no se puede leer el archivo”, el archivo txData/admins.json no existe o txAdmin no tiene permiso para leerlo.
Errores de carga del perfil
El perfil seleccionado no se puede cargar debido a problemas de permisos o JSON dañado.
Elimina los archivos corruptos y reinicia txAdmin para regenerar.
Mejores prácticas
- Revisión periódica del registro: Revise los registros diariamente para detectar advertencias acumuladas
- Monitoreo automatizado: Configurar alertas para patrones de errores críticos
- Retención de registros:Configure la rotación adecuada según la actividad del servidor
- Registros de respaldo:Incluir directorios de registro en los procedimientos de copia de seguridad
- Correlación de marcas de tiempo: Utilice marcas de tiempo para correlacionar eventos entre diferentes tipos de registros
- Asegúrate de que la configuración de tu servidor sea correcta: Tutorial de Server.cfg
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.