txAdmin Logs auf Fehler prüfen

Einführung

Richtest du deinen ersten FiveM Server ein? Unser vollständiger Server-Setup-Leitfaden deckt alles von Hosting bis zur Sicherheitskonfiguration ab.

txAdmin speichert drei Arten von persistenten Log-Dateien im Verzeichnis txData/<profil>/logs/: Admin-Logs für administrative Aktionen, FXServer-Logs für die Konsolenausgabe und Server-Logs für In-Game-Ereignisse. Diese Logs sind unverzichtbar für die Diagnose von Server-Problemen, das Verfolgen von Spieleraktivitäten und die Überwachung der System-Performance.

Zielgruppe: FiveM-Server-Administratoren, die txAdmin v4.6.0 oder neuer mit Log-Rotation-Funktionen verwenden.

Log-Typen und Speicherorte

Dateistruktur

txData/
└── <profil>/
    └── logs/
        ├── admin/
        ├── fxserver/
        └── server/

Log-Kategorien

Admin-Logs (admin/) Enthält ein Protokoll aller administrativen Aktionen sowie einiger automatisierter wie Server-Neustarts, Bans, Verwarnungen, Einstellungsänderungen und Live-Konsoleneingaben. Protokolliert keine Benutzer-IP-Adressen, außer von Authentifizierungs-Endpunkten.

FXServer-Logs (fxserver/) Enthält das Protokoll aller Ereignisse in der FXServer-Konsole (stdin, stdout, stderr). Jede Live-Konsoleneingabe ist mit > vorangestellt.

Server-Logs (server/) Enthält alle Aktionen, die auf dem Server stattfinden, z.B. Spieler-Join/Leave/Tod, Chat-Nachrichten, Explosionen, Menü-Ereignisse, Befehle.

Zugriff auf Logs über das Web-Interface

Methode 1: Live-Konsole

1. Rufe dein txAdmin-Web-Panel unter http://deine-server-ip:port auf
2. Navigiere in der Seitenleiste zur Live-Konsole
3. Überwache Server-Aktivitäten, Warnungen und Fehlermeldungen in Echtzeit
4. Achte auf Einträge mit [ERROR], [WARN] oder [CRITICAL]

Methode 2: Server-Log-Viewer

1. Gehe im Seitenleistenmenü zu Server Log
2. Überwache alle Aktivitäten auf dem Server einschließlich Spielerverbindungen, Chat-Nachrichten, Spielertode, Menüaktionen, ausgeführte Befehle und Systemereignisse
3. Verwende die Filteroptionen, um Fehlermeldungen zu isolieren
4. Exportiere Log-Abschnitte für detaillierte Analyse

Methode 3: Aktions-Log

1. Navigiere zu Einstellungen → Diagnose
2. Sieh dir das Aktions-Log an, das alle von txAdmin oder einem Administrator durchgeführten Aktionen aufzeichnet
3. Prüfe auf fehlgeschlagene administrative Aktionen oder Systemfehler

Dateibasierter Log-Zugriff

Direktes Dateilesen

# Zum Logs-Verzeichnis navigieren
cd txData/<dein-profil>/logs/

# Aktuelle Fehler in FXServer-Logs anzeigen
tail -100 fxserver/fxserver-YYYY-MM-DD.log | grep -i error

# Nach bestimmten Fehlermustern suchen
grep -r "ERROR\|WARN\|CRITICAL" ./

# Logs in Echtzeit überwachen
tail -f fxserver/fxserver-$(date +%Y-%m-%d).log

Benennungskonvention der Log-Dateien

• Dateien folgen dem Muster: <typ>-YYYY-MM-DD.log
• Beispiel: fxserver-2025-06-10.log

Häufige Fehlermuster

Ressourcen-Ladefehler

[ERROR] Failed to start resource 'resource_name'
[ERROR] Could not load resource metadata for resource_name
[WARN] Resource resource_name is using deprecated syntax

Datenbankverbindungsprobleme

[ERROR] MySQL connection failed
[ERROR] Could not execute query
[WARN] Connection to database timed out

Spielerbezogene Fehler

Spieler-Quellen werden im Format [mutex#id] name gespeichert, wobei der Mutex ein Bezeichner dieser Server-Ausführung ist. Suche nach [mutex#id], um den initialen Spieler-Join mit allen Bezeichnern zu finden.

Speicher- und Performance-Probleme

[WARN] High memory usage detected
[ERROR] Script timeout in resource_name
[CRITICAL] Server overload detected

Log-Konfiguration

Rotations-Einstellungen

Bearbeite deine txData/<profil>/config.json und füge ein Objekt innerhalb von logger hinzu, wobei der Schlüssel einer von [admin, fxserver, server] ist. Konfiguriere Rotationsoptionen gemäß der rotating-file-stream-Bibliotheksreferenz.

Beispielkonfiguration:

{
  "logger": {
    "fxserver": {
      "size": "10M",
      "interval": "1d",
      "compress": "gzip"
    }
  }
}

Ausführliches Logging

Setze txAdminVerbose auf true, um detailliertere Fehler- und Ereignisinformationen in der Konsole auszugeben:

# Windows
./FXServer.exe +set txAdminVerbose true

# Linux
./run.sh +set txAdminVerbose true

Fehlerbehebung bei spezifischen Problemen

txAdmin reagiert nicht

Wenn du „FXServer is not responding!" erhältst, bedeutet dies, dass txAdmin:Monitor keine Verbindung zum FXServer herstellen konnte. Ursachen sind:

• FXServer bei einer Ressource blockiert
• Port-Konflikte zwischen FXServer und txAdmin
• Healthcheck gibt 404-Fehler zurück

Wie man „FXServer Is Not Responding!" behebt

Berechtigungsprobleme

Wenn du „cannot read file" erhältst, existiert die Admin-Datei txData/admins.json nicht oder txAdmin hat keine Leseberechtigung.

Profil-Ladefehler

Das ausgewählte Profil kann aufgrund von Berechtigungsproblemen oder fehlerhaftem JSON nicht geladen werden. Beschädigte Dateien löschen und txAdmin neu starten, damit es neu generiert wird.

Best Practices

1. Regelmäßige Log-Überprüfung: Logs täglich auf sich ansammelnde Warnungen prüfen
2. Automatisierte Überwachung: Alerts für kritische Fehlermuster einrichten
3. Log-Aufbewahrung: Entsprechende Rotation basierend auf Server-Aktivität konfigurieren
4. Logs sichern: Log-Verzeichnisse in Backup-Prozeduren einschließen
5. Zeitstempel-Korrelation: Zeitstempel verwenden, um Ereignisse über verschiedene Log-Typen zu korrelieren
6. Stelle sicher, dass deine Serverkonfiguration korrekt ist: Server.cfg Tutorial

Externe Ressourcen

• Offizielle txAdmin-Dokumentation – Primäre Referenz für txAdmin-Funktionen und -Konfiguration
• txAdmin GitHub-Repository – Quellcode und Issue-Tracking
• FiveM Server Manual – Vollständiger Server-Setup-Leitfaden

Hinweis: Log-Formatspezifikationen können zwischen txAdmin-Versionen variieren; überprüfe immer deine installierte Version.

Systematische Log-Überwachung über txAdmins Web-Interface und direkten Dateizugriff ermöglicht die proaktive Identifizierung von Server-Problemen, bevor sie sich auf die Spielererfahrung auswirken.

Wie man die meisten Fehler behebt

FiveM Fehlercodes & Fixes – Mega-Guide