Come controllare i log di txAdmin per errori

txAdmin mantiene tre tipi di file di registro persistenti nel txData/ /registri/ 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/ └── / └── log/ ├── admin/ ├── fxserver/ └── server/

Categorie di registro

Registri amministrativi (amministratore/) 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

1. Accedi al tuo pannello web txAdmin su http://ip-del-tuo-server:porta
2. Vai a Console live nella barra laterale
3. Monitora le attività del server in tempo reale, gli avvisi e i messaggi di errore per risolvere i problemi
4. Cerca le voci contrassegnate con [ERRORE], [AVVISARE], O [CRITICO]

Metodo 2: Visualizzatore del registro del server

1. Vai a Registro del server nel menu della barra laterale
2. 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
3. Utilizzare le opzioni di filtro per isolare i messaggi di errore
4. Esportare le sezioni del registro per un'analisi dettagliata

Metodo 3: Registro azioni

1. Vai a Impostazioni → Diagnostica
2. Visualizza il registro delle azioni, che registra tutte le azioni eseguite da txAdmin o da qualsiasi amministratore
3. Controllare azioni amministrative non riuscite o errori di sistema

Accesso al registro basato su file

Lettura diretta dei file

# Passare alla directory dei registri cd txData/ /logs/ # Visualizza gli errori recenti nei log di fxserver tail -100 fxserver/fxserver-YYYY-MM-DD.log | grep -i error # Cerca modelli di errore specifici grep -r "ERROR\|WARN\|CRITICAL" ./ # Monitora i log in tempo reale tail -f fxserver/fxserver-$(date +%Y-%m-%d).log

Convenzione di denominazione dei file di registro

• I file seguono lo schema: -AAAA-MM-GG.log
• Esempio: fxserver-2025-06-10.log

Modelli di errore comuni

Errori di caricamento delle risorse

[ERRORE] Impossibile avviare la risorsa 'resource_name' [ERRORE] Impossibile caricare i metadati della risorsa per resource_name [WARN] La risorsa resource_name utilizza una sintassi deprecata

Problemi di connessione al database

[ERRORE] Connessione MySQL non riuscita [ERRORE] Impossibile eseguire la query [WARN] Timeout della connessione al database

Errori relativi al giocatore

Le sorgenti del giocatore sono mantenute nel formato [mutex#id] nome 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] Rilevato elevato utilizzo di memoria [ERRORE] Timeout dello script in resource_name [CRITICO] Rilevato sovraccarico del server

Configurazione del registro

Impostazioni di rotazione

Modifica il tuo txData/ /config.json e aggiungi un oggetto all'interno del logger con la chiave che è una delle [amministratore, fxserver, server]. Configurare le opzioni di rotazione in base a riferimento alla libreria rotating-file-stream.

Esempio di configurazione:

{ "logger": { "fxserver": { "dimensione": "10M", "intervallo": "1g", "compressione": "gzip" } } }

Registrazione dettagliata

Impostato txAdminVerbose A VERO per stampare sulla console informazioni più dettagliate su errori ed eventi:

# Windows ./FXServer.exe +imposta txAdminVerbose vero # Linux ./run.sh +imposta txAdminVerbose vero

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

1. Revisione regolare del registro: Controlla i registri ogni giorno per gli avvisi in accumulo
2. Monitoraggio automatico: Imposta avvisi per modelli di errore critici
3. Conservazione dei registri: Configurare la rotazione appropriata in base all'attività del server
4. Registri di backup: Includere le directory di registro nelle procedure di backup
5. Correlazione timestamp: Utilizza i timestamp per correlare gli eventi tra diversi tipi di log
6. 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.

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