txAdmin mantiene tre tipi di file di registro persistenti nel txData/<profile>/logs/ Directory: log di amministrazione per le azioni amministrative, log di fxserver per l'output della console e log del server per gli eventi di gioco. Questi log sono essenziali per diagnosticare i problemi del server, monitorare le attività dei giocatori e monitorare le prestazioni del sistema.
Pubblico di destinazione: Amministratori del server FiveM utilizzando txAdmin v4.6.0 o versione successiva con funzionalità di rotazione dei log.
Tipi e posizioni dei registri
Struttura del file
txData/ └── <profile>/ └── logs/ ├── admin/ ├── fxserver/ └── server/
Categorie di registro
Registri amministrativi (admin/) Contiene il registro delle azioni amministrative e di alcune azioni automatiche come riavvii del server, ban, avvisi, modifiche alle impostazioni e input dalla console live. Non registra gli indirizzi IP degli utenti, tranne quelli degli endpoint di autenticazione.
Registri di FXServer (fxserver/) Contiene il registro di tutto ciò che accade nella console di fxserver (stdin, stdout, stderr). Qualsiasi input dalla console live è preceduto da >.
Registri del server (server/) Contiene tutte le azioni che avvengono all'interno del server, ad esempio l'ingresso/uscita/morte dei giocatori, i messaggi della chat, le esplosioni, gli eventi del menu, i comandi.
Accesso al registro dell'interfaccia Web
Metodo 1: Live Console
- Accedi al tuo pannello web txAdmin su
http://your-server-ip:port - Vai a Console live nella barra laterale
- Monitora le attività del server in tempo reale, gli avvisi e i messaggi di errore per risolvere i problemi
- Cerca le voci contrassegnate con
[ERROR],[WARN], O[CRITICAL]
Metodo 2: Visualizzatore del registro del server
- Vai a Registro del server nel menu della barra laterale
- Monitora tutte le attività sul server, incluse le connessioni dei giocatori, i messaggi di chat, le morti di gioco, le azioni del menu, i comandi eseguiti e gli eventi di sistema
- Utilizzare le opzioni di filtro per isolare i messaggi di errore
- Esportare le sezioni del registro per un'analisi dettagliata
Metodo 3: Registro azioni
- Vai a Impostazioni → Diagnostica
- Visualizza il registro delle azioni, che registra tutte le azioni eseguite da txAdmin o da qualsiasi amministratore
- Controllare azioni amministrative non riuscite o errori di sistema
Accesso al registro basato su file
Lettura diretta dei file
# 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
Convenzione di denominazione dei file di registro
- I file seguono lo schema:
<type>-YYYY-MM-DD.log - Esempio:
fxserver-2025-06-10.log
Modelli di errore comuni
Errori di caricamento delle risorse
[ERROR] Failed to start resource 'resource_name' [ERROR] Could not load resource metadata for resource_name [WARN] Resource resource_name is using deprecated syntax
Problemi di connessione al database
[ERROR] MySQL connection failed [ERROR] Could not execute query [WARN] Connection to database timed out
Errori relativi al giocatore
Le sorgenti del giocatore sono mantenute nel formato [mutex#id] name dove il mutex è un identificatore dell'esecuzione di quel server. Cerca [mutex#id] per trovare il giocatore iniziale con tutti gli identificatori.
Problemi di memoria e prestazioni
[WARN] High memory usage detected [ERROR] Script timeout in resource_name [CRITICAL] Server overload detected
Configurazione del registro
Impostazioni di rotazione
Modifica il tuo txData/<profile>/config.json e aggiungi un oggetto all'interno del logger con la chiave che è una delle [admin, fxserver, server]. Configurare le opzioni di rotazione in base a riferimento alla libreria rotating-file-stream.
Esempio di configurazione:
{
"logger": {
"fxserver": {
"size": "10M",
"interval": "1d",
"compress": "gzip"
}
}
}
Registrazione dettagliata
Impostato txAdminVerbose A true per stampare sulla console informazioni più dettagliate su errori ed eventi:
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
Risoluzione dei problemi specifici
txAdmin non risponde
Se ottieni "FXServer non risponde!"significa che txAdmin:Monitor non è riuscito a connettersi a FXServer. Le cause includono:
- FXServer bloccato su una risorsa
- Conflitti di porte tra FXServer e txAdmin
- Controllo sanitario che restituisce errori 404
Problemi di autorizzazione
Se si ottiene "impossibile leggere il file", il file di amministrazione txData/admins.json non esiste o txAdmin non ha l'autorizzazione per leggerlo.
Errori di caricamento del profilo
Il profilo selezionato non può essere caricato a causa di problemi di autorizzazione o di JSON non funzionante.
Eliminare i file danneggiati e riavviare txAdmin per rigenerarli.
Migliori pratiche
- Revisione regolare del registro: Controlla i registri ogni giorno per gli avvisi in accumulo
- Monitoraggio automatico: Imposta avvisi per modelli di errore critici
- Conservazione dei registri: Configurare la rotazione appropriata in base all'attività del server
- Registri di backup: Includere le directory di registro nelle procedure di backup
- Correlazione timestamp: Utilizza i timestamp per correlare gli eventi tra diversi tipi di log
- Assicurati che la configurazione del tuo server sia corretta: Tutorial Server.cfg
Risorse esterne
- Documentazione ufficiale di txAdmin – Riferimento principale per le funzionalità e la configurazione di txAdmin
- Repository txAdmin GitHub – Codice sorgente e monitoraggio dei problemi
- Manuale del server FiveM – Guida completa alla configurazione del server
Nota di incertezza: Le specifiche del formato del registro possono variare tra le versioni di txAdmin; verificare sempre con la versione installata.
Il monitoraggio sistematico dei log tramite l'interfaccia web di txAdmin e l'accesso diretto ai file consentono l'identificazione proattiva dei problemi del server prima che incidano sull'esperienza del giocatore.