Come diagnosticare crash e rallentamenti di un server FiveM
Trova la causa di un crash o di un rallentamento sul tuo server FiveM Linux: log, memoria, hitch warning, resmon, profiler e isolamento della risorsa responsabile.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
Un server FiveM che si blocca o rallenta ha spesso una causa precisa: una risorsa, una mancanza di memoria o una macchina satura. Questa guida ti dà un metodo per trovare quale: qualificare il sintomo, leggere i log giusti, misurare, poi isolare la risorsa responsabile.
Prerequisiti
- Un server installato con la guida Creare un server FiveM: utente
fivem, serviziofivem.service, console in/home/fivem/fxserver.log - Un accesso SSH con
sudoe un accesso a txAdmin - Un backup recente, da fare con
sudo /usr/local/sbin/backup-fivem.shprima di modificare qualsiasi cosa
Qualificare il sintomo
| Cosa osservi | Pista principale | Sezione da consultare |
|---|---|---|
| Il server si riavvia da solo, tutti i giocatori vengono disconnessi | Arresto del processo o blocco | Passi da 1 a 3 |
| Il server non si avvia più o si ferma durante il caricamento | Risorsa o configurazione | Passo 4 |
| I giocatori vedono scatti, veicoli che si teletrasportano | Server sovraccarico | Passi 5 e 6 |
| Un solo giocatore ha pochi fotogrammi al secondo | Lato client | Passo 7 |
| Il problema è iniziato dopo un'aggiunta o un aggiornamento | Modifica recente | Passo 8 |
Passo 1: conservare i log
Il file /home/fivem/fxserver.log viene svuotato a ogni avvio del servizio. Copialo prima di riavviare qualsiasi cosa:
sudo install -o fivem -g fivem -m 640 /home/fivem/fxserver.log "/home/fivem/fxserver-incident-$(date +%F_%H-%M).log"txAdmin conserva anche i propri log, con rotazione, in /home/fivem/txData/default/logs/:
| File | Contenuto |
|---|---|
fxserver.log |
Console del server. I vecchi file hanno la data nel nome |
admin.log |
Azioni degli amministratori e riavvii automatici |
server.log |
Eventi in gioco: connessioni, morti, messaggi, comandi |
Questi file contengono dati dei giocatori. Non pubblicarli così come sono.
Passo 2: capire perché il server si è riavviato
Cerca le decisioni prese da txAdmin:
sudo grep -a 'Restarting server' /home/fivem/txData/default/logs/admin.log | tail -n 20| Motivo mostrato | Significato | Cosa fare |
|---|---|---|
Server process close detected |
Il processo FXServer si è arrestato | Guarda la fine della console e la memoria (passo 3) |
Server is not responding |
FXServer è in esecuzione ma non risponde più | Cerca un blocco: passi 5 e 6 |
Server is taking too long to start |
L'avvio supera il tempo consentito | Passa al passo 4 |
Resource "nome" failed to start within the ... time limit |
Questa risorsa blocca l'avvio | Prova senza di lei (passo 8) |
Leggi poi le ultime righe della console prima dell'incidente, nella copia fatta al passo 1:
sudo bash -c 'ls -t /home/fivem/fxserver-incident-*.log | head -n 1 | xargs tail -n 80'Guarda anche la cronologia del servizio:
sudo systemctl status fivem.service --no-pager
sudo journalctl -u fivem.service --since "2 days ago" --no-pager | tail -n 40Passo 3: verificare la memoria e il disco
Quando manca la memoria, il kernel Linux uccide un processo. Cerca la sua traccia:
sudo journalctl -k --since "2 days ago" --no-pager | grep -iE 'out of memory|oom-kill|killed process'
free -h
df -h /home /var/lib/mysql- Compare una riga
Out of memory: Killed process: il server ha poca memoria. Cerca una risorsa il cui consumo aumenta, poi riduci il carico o aumenta la memoria della macchina. - Un disco è pieno al 100 %: libera dello spazio. MariaDB e i log non possono più scrivere.
Per seguire la memoria di FXServer nel tempo, rileva questo comando in più momenti. txAdmin e il server di gioco compaiono come due processi, e il più grande è in genere il server di gioco:
ps -u fivem -o pid,pcpu,pmem,rss,etime,args --sort=-rss | cut -c1-110Una colonna RSS che sale senza mai scendere, mentre il numero di giocatori resta stabile, orienta verso una perdita di memoria in una risorsa.
Passo 4: analizzare un avvio che fallisce
Mostra gli ultimi eventi di caricamento:
sudo grep -a -E "Started resource|Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log | tail -n 30| Messaggio | Causa | Soluzione |
|---|---|---|
Couldn't find resource nome. |
La cartella non esiste, o il nome è diverso dalla riga ensure |
Correggi server.cfg o la cartella, poi digita refresh |
Couldn't start resource nome. |
L'avvio è fallito | Leggi le righe subito sopra |
Could not find dependency x for resource y. |
Manca la risorsa x |
Installala |
Could not start dependency x for resource y. |
La risorsa x esiste ma non si avvia |
Risolvi prima x |
Resource 'nome' can't run: |
Una condizione non è soddisfatta, ad esempio server needs to be 12913 or higher |
Segui Aggiornare gli artifact di FXServer |
Failed to load script file. |
File assente o non valido | Reinstalla la risorsa |
SCRIPT ERROR: |
Errore nel codice di uno script | Il messaggio indica il file e la riga: aggiorna o segnala al suo autore |
Per un errore del database, consulta Installare e configurare oxmysql su FiveM.
Passo 5: individuare i rallentamenti del server
FXServer segnala i ritardi dei suoi cicli interni con gli hitch warning:
sudo grep -a -c 'hitch warning' /home/fivem/fxserver.log
sudo grep -a 'hitch warning' /home/fivem/fxserver.log | tail -n 20| Messaggio | Attivato a partire da | Riguarda |
|---|---|---|
server thread hitch warning |
150 ms | Ciclo principale, dove vengono eseguiti gli script server |
network thread hitch warning |
150 ms | Rete |
sync thread hitch warning |
100 ms | Sincronizzazione OneSync |
Un avviso isolato all'avvio o al riavvio di una risorsa non è preoccupante. Avvisi regolari in gioco lo sono. Cfx.re li attribuisce più spesso a una risorsa poco performante, ad esempio un ciclo troppo costoso o una query SQL lenta.
Prima di accusare una risorsa, verifica che la macchina non sia satura:
uptime
vmstat 1 10In vmstat, guarda tre colonne:
| Colonna | Valore elevato |
|---|---|
id |
Basso: il processore è quasi completamente occupato |
wa |
Il processore attende il disco |
st |
Parte del tempo del processore viene presa dall'hypervisor |
Guarda poi il dettaglio dei thread di esecuzione, sostituendo PID con il numero del processo più grande rilevato al passo 3. Esci con q:
top -H -p PIDUn solo thread vicino al 100 % indica che un ciclo del server è saturo, anche se la macchina ha altri core liberi. In questo caso, aggiungere core aiuta poco: conviene alleggerire gli script. Se wa o st restano elevati mentre il server è poco carico, contatta il supporto dalla tua area clienti, con le tue rilevazioni.
Verifica anche le query lente segnalate da oxmysql:
sudo grep -a 'to execute a query' /home/fivem/fxserver.log | tail -n 20Passo 6: registrare un profilo del server
Il profiler integrato mostra quale risorsa consuma tempo. Lancialo in Live Console mentre il problema si verifica, se possibile con dei giocatori connessi:
profiler record 500
profiler statusAttendi che profiler status indichi Recording: No, poi salva il risultato:
profiler saveJSON profilo-server.jsonIl file viene creato nella cartella del server, il cui nome termina con .base. Sul server, copialo nella tua cartella personale, sostituendo NOME_CARTELLA:
sudo find /home/fivem/txData -maxdepth 1 -type d -name '*.base'
sudo install -o "$USER" -m 600 /home/fivem/txData/NOME_CARTELLA.base/profilo-server.json "$HOME/profilo-server.json"
sudo rm /home/fivem/txData/NOME_CARTELLA.base/profilo-server.jsonRecuperalo poi dal tuo computer:
scp TUO_USER@IP_DEL_SERVER:profilo-server.json .Apri Google Chrome, poi gli strumenti per sviluppatori con F12. Nella scheda Performance, carica il file con Load profile. Individua i picchi della curva di attività, ingrandiscili, poi leggi il nome delle risorse e delle funzioni più lunghe.
Passo 7: misurare lato giocatore con resmon
resmon mostra il costo di ogni risorsa sul client. Aiuta per i cali di fotogrammi al secondo, non per i ritardi del server.
Nel gioco, apri la console con F8 e digita:
resmon trueOrdina per CPU msec o Time % per individuare le risorse costose, e guarda Memory per la memoria. Digita resmon false per chiudere.
Se la console risponde Access denied for command resmon, la modalità sviluppatore non è attiva sul tuo client. Avvia FiveM con l'argomento +set moo 31337. Con FiveM per GTA V Enhanced, questo argomento non esiste più e il server deve definire sv_devMode true.
La pagina Player Drops di txAdmin completa questa analisi: mostra se i giocatori lasciano il server a causa di crash del loro gioco, e da quando.
Passo 8: isolare la risorsa responsabile
Inizia da ciò che è cambiato di recente. Se non è cambiato nulla, procedi per metà.
Prova rapida sul server avviato
Per una risorsa secondaria, arrestala in Live Console, poi osserva gli avvisi per una decina di minuti:
stop nome_risorsaRilanciala poi con ensure nome_risorsa. Non arrestare in questo modo oxmysql, es_extended, qb-core o un'altra risorsa da cui dipendono molte altre: provocheresti errori estranei al problema.
Ricerca per metà
Fai prima una copia della configurazione, sostituendo NOME_CARTELLA:
sudo -u fivem cp /home/fivem/txData/NOME_CARTELLA.base/server.cfg /home/fivem/txData/NOME_CARTELLA.base/server.cfg.prima-diagnosticaPoi, fuori dagli orari di punta:
- In CFG Editor, disattiva metà delle risorse opzionali aggiungendo
#davanti alla loro rigaensure. Mantieni il framework e le sue dipendenze. - Riavvia il server e prova a riprodurre il problema.
- Se il problema scompare, deriva dalla metà disattivata. Altrimenti, deriva da quella che resta attiva.
- Ricomincia sul gruppo sospetto, fino a tenere una sola risorsa.
Se più risorse vengono avviate da una cartella, come ensure [addons], sostituisci temporaneamente questa riga con una riga ensure per ciascuna di esse. Un errore Could not find dependency durante la prova significa semplicemente che hai disattivato una dipendenza: riattivala.
Una volta trovata la risorsa, aggiornala, correggi la sua configurazione o segnala il problema al suo autore, con il tuo profilo e i tuoi log. Rimetti poi la configurazione originale, quindi riavvia il server da txAdmin:
sudo -u fivem cp /home/fivem/txData/NOME_CARTELLA.base/server.cfg.prima-diagnostica /home/fivem/txData/NOME_CARTELLA.base/server.cfgChiedere aiuto
Per un problema di una risorsa, rivolgiti al suo autore o al forum Cfx.re. Prepara:
- la build di FXServer e la versione di txAdmin, rilevate come in Aggiornare gli artifact di FXServer
- il momento dell'incidente e ciò che è cambiato subito prima
- le righe di console interessate, il profilo e i risultati di
free -hevmstat
Cfx.re ricorda che la versione Linux di FXServer è un porting offerto per comodità: se un difetto deriva da FXServer stesso, ha più probabilità di essere corretto se viene riprodotto su Windows. Verifica anche che persista sull'ultima versione consigliata prima di segnalarlo.
In caso di problemi durante la diagnosi
profiler saveJSON restituisce Invalid path
Usa un semplice nome di file, senza cartelle, e verifica che l'utente fivem possa scrivere nella cartella del server.
A recording is already taking place
Una registrazione è già in corso. Attendi la sua fine con profiler status, oppure arrestala con profiler record stop.
Il file fxserver.log è vuoto
Il servizio è appena stato riavviato. Usa /home/fivem/txData/default/logs/fxserver.log, insieme ai file datati della stessa cartella.
Il server si riavvia in loop durante le prove
Arrestalo con sudo systemctl stop fivem.service, rimetti al suo posto server.cfg.prima-diagnostica con il comando qui sopra, poi riavvia il servizio con sudo systemctl start fivem.service.