txAdmin onderhoudt drie soorten persistente logbestanden in de txData/<profile>/logs/ map: admin logs voor administratieve acties, fxserver logs voor console-uitvoer, en server logs voor in-game gebeurtenissen. Deze logs zijn essentieel voor het diagnosticeren van serverproblemen, het volgen van spelersactiviteiten en het monitoren van systeemprestaties.
Doelgroep: FiveM serverbeheerders die txAdmin v4.6.0 of nieuwer gebruiken met logrotatiemogelijkheden.
Logtypen en Locaties
Bestandsstructuur
txData/ └── <profile>/ └── logs/ ├── admin/ ├── fxserver/ └── server/
Logcategorieën
Admin Logs (admin/) Bevat log van administratieve acties en ook enkele geautomatiseerde zoals serverherstarten, bans, waarschuwingen, instellingen wijzigen, live console-invoer. Logt geen gebruikers-IP-adressen behalve van authenticatie-eindpunten.
FXServer Logs (fxserver/) Bevat de log van alles wat er gebeurt in de fxserver console (stdin, stdout, stderr). Elke live console-invoer wordt voorafgegaan door >.
Server Logs (server/) Bevat alle acties die in de server plaatsvinden, bijvoorbeeld speler join\/leave\/die, chatberichten, explosies, menu-evenementen, commando's.
Webinterface Logtoegang
Methode 1: Live Console
- Toegang tot uw txAdmin-webpaneel op
http://your-server-ip:port - Navigeer naar Live Console in de zijbalk
- Monitor realtime serveractiviteiten, waarschuwingen en foutmeldingen voor het debuggen van problemen
- Zoek naar vermeldingen gemarkeerd met
[ERROR],[WARN], of[CRITICAL]
Methode 2: Serverlogviewer
- Ga naar Serverlog in het zijbalkmenu
- Monitor alle activiteiten op de server, waaronder spelersverbindingen, chatberichten, game-sterfgevallen, menuacties, uitgevoerde opdrachten en systeemgebeurtenissen
- Gebruik de filteropties om foutmeldingen te isoleren
- Exporteer logsecties voor gedetailleerde analyse
Methode 3: Actielog
- Navigeer naar Instellingen → Diagnostiek
- Bekijk het Actielog, dat alle acties registreert die door txAdmin of een beheerder zijn uitgevoerd
- Controleer op mislukte beheerdersacties of systeemfouten
Bestandsgebaseerde logtoegang
Direct bestand lezen
# 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
Naamgevingsconventie voor logbestanden
- Bestanden volgen patroon:
<type>-YYYY-MM-DD.log - Voorbeeld:
fxserver-2025-06-10.log
Veelvoorkomende foutpatronen
Bronlaadfouten
[ERROR] Failed to start resource 'resource_name' [ERROR] Could not load resource metadata for resource_name [WARN] Resource resource_name is using deprecated syntax
Databaseverbindingsproblemen
[ERROR] MySQL connection failed [ERROR] Could not execute query [WARN] Connection to database timed out
Spelergerelateerde fouten
Spelerbronnen worden bewaard in het formaat [mutex#id] name waarbij de mutex een identificatie is van die serveruitvoering. Zoek naar [mutex#id] om de initiële spelerjoin met alle identificaties te vinden.
Geheugen- en prestatieproblemen
[WARN] High memory usage detected [ERROR] Script timeout in resource_name [CRITICAL] Server overload detected
Logconfiguratie
Rotatie-instellingen
Bewerk uw txData/<profile>/config.json en voeg een object toe in logger met de sleutel zijnde een van [admin, fxserver, server]. Configureer rotatieopties volgens de rotating-file-stream bibliotheekreferentie.
Voorbeeldconfiguratie:
{
"logger": {
"fxserver": {
"size": "10M",
"interval": "1d",
"compress": "gzip"
}
}
}
Uitgebreide logboekregistratie
Instellen txAdminVerbose naar true om meer gedetailleerde informatie over fouten en gebeurtenissen op de console af te drukken:
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
Specifieke problemen oplossen
txAdmin reageert niet
Als je “FXServer reageert niet!” betekent dat de txAdmin:Monitor geen verbinding kon maken met de FXServer. Oorzaken zijn onder meer:
- FXServer vast op een resource
- Poortconflicten tussen FXServer en txAdmin
- Healthcheck retourneert 404-fouten
Toestemmingsproblemen
Als je “kan bestand niet lezen” krijgt, het adminbestand txData/admins.json bestaat niet of txAdmin heeft geen toestemming om het te lezen.
Profiellaadfouten
Geselecteerd profiel kan niet worden geladen vanwege toestemmingsproblemen of kapotte JSON.
Verwijder beschadigde bestanden en herstart txAdmin om opnieuw te genereren.
Beste praktijken
- Regelmatige logboekcontrole: Controleer dagelijks logs op oplopende waarschuwingen
- Geautomatiseerde monitoring: Stel meldingen in voor kritieke foutpatronen
- Logboekbewaring: Configureer passende rotatie op basis van serveractiviteit
- Back-uppen van logs: Voeg logboekmappen toe aan back-upprocedures
- Tijdstempelcorrelatie: Gebruik tijdstempels om gebeurtenissen te correleren over verschillende logboektypen
- Zorg ervoor dat je serverconfiguratie correct is: Server.cfg-handleiding
Externe bronnen
- Officiële txAdmin-documentatie – Primaire referentie voor txAdmin-functies en -configuratie
- txAdmin GitHub-repository – Broncode en issue tracking
- FiveM Serverhandleiding – Volledige serverinstallatiegids
Onzekerheidsnotitie: Logformaat specificaties kunnen variëren tussen txAdmin-versies; controleer altijd tegen uw geïnstalleerde versie.
Systematische logmonitoring via txAdmin's webinterface en directe bestandstoegang maakt proactieve identificatie van serverproblemen mogelijk voordat ze de spelerservaring beïnvloeden.
