txAdmin verwaltet drei Arten von persistenten Protokolldateien im txData/ /Protokolle/ Verzeichnis: Admin-Protokolle für administrative Aktionen, FXServer-Protokolle für Konsolenausgaben und Server-Protokolle für In-Game-Ereignisse. Diese Protokolle sind wichtig für die Diagnose von Serverproblemen, die Verfolgung von Spieleraktivitäten und die Überwachung der Systemleistung.
Zielgruppe: FiveM-Serveradministratoren Verwende txAdmin v4.6.0 oder neuer mit Log-Rotation-Funktionen.
Protokolltypen und -speicherorte
Dateistruktur
txData/ └── / └── Protokolle/ ├── Admin/ ├── fxserver/ └── Server/
Protokollkategorien
Administratorprotokolle (Administrator/) Enthält ein Protokoll administrativer Aktionen sowie einiger automatisierter Aktionen wie Serverneustarts, Sperren, Warnungen, Einstellungsänderungen und Live-Konsoleneingaben. Protokolliert keine Benutzer-IP-Adressen, außer von Authentifizierungsendpunkten.
FXServer-Protokolle (fxserver/) Enthält das Protokoll aller Vorgänge in der FXServer-Konsole (stdin, stdout, stderr). Jede Live-Konsoleneingabe erhält das Präfix >.
Serverprotokolle (Server/) Enthält alle Aktionen, die innerhalb des Servers stattfinden, z. B. Beitritt/Verlasse/Sterben des Spielers, Chatnachrichten, Explosionen, Menüereignisse, Befehle.
Protokollzugriff auf die Webschnittstelle
Methode 1: Live-Konsole
- Greife auf dein txAdmin-Webpanel zu bei
http://your-server-ip:port - Navigiere zu Live-Konsole in der Seitenleiste
- Überwache Echtzeit-Serveraktivitäten, Warnungen und Fehlermeldungen zur Fehlerbehebung
- Suche nach Einträgen, die mit gekennzeichnet sind
[FEHLER],[WARNEN], oder[KRITISCH]
Methode 2: Server-Log-Viewer
- Gehe zu Serverprotokoll im Seitenleistenmenü
- Überwache alle Aktivitäten auf dem Server, einschließlich Spielerverbindungen, Chat-Nachrichten, Spielertode, Menüaktionen, ausgeführte Befehle und Systemereignisse
- Verwende die Filteroptionen, um Fehlermeldungen zu isolieren
- Exportiere Log-Abschnitte für eine detaillierte Analyse
Methode 3: Aktionsprotokoll
- Navigiere zu Einstellungen → Diagnose
- Sieh dir das Aktionsprotokoll an, das alle von txAdmin oder einem Admin durchgeführten Aktionen aufzeichnet
- Überprüfe fehlgeschlagene administrative Aktionen oder Systemfehler
Dateibasierter Protokollzugriff
Direktes Lesen von Dateien
# Navigiere zum Protokollverzeichnis cd txData//logs/ # Aktuelle Fehler in fxserver-Protokollen anzeigen tail -100 fxserver/fxserver-YYYY-MM-DD.log | grep -i error # Nach bestimmten Fehlermustern suchen grep -r "ERROR|WARN|CRITICAL" ./ # Protokolle in Echtzeit überwachen tail -f fxserver/fxserver-$(date +%Y-%m-%d).log
Benennungskonvention für Protokolldateien
- Die Dateien folgen dem Muster:
-JJJJ-MM-TT.log - Beispiel:
fxserver-2025-06-10.log
Häufige Fehlermuster
Fehler beim Laden von Ressourcen
[FEHLER] Ressource „Ressource_Name“ konnte nicht gestartet werden. [FEHLER] Ressourcenmetadaten für Ressource_Name konnten nicht geladen werden. [WARNUNG] Ressource „Ressource_Name“ verwendet veraltete Syntax.
Probleme mit der Datenbankverbindung
[FEHLER] MySQL-Verbindung fehlgeschlagen [FEHLER] Abfrage konnte nicht ausgeführt werden [WARNUNG] Zeitüberschreitung bei Verbindung zur Datenbank
Spielerbezogene Fehler
Player-Quellen werden im Format gehalten [mutex#id] Name wo der Mutex eine Kennung dieser Serverausführung ist. Suche nach [mutex#id] um den anfänglichen Spielerbeitritt mit allen Kennungen zu finden.
Speicher- und Leistungsprobleme
[WARN] Hohe Speicherauslastung erkannt. [FEHLER] Skript-Timeout in Ressourcenname. [KRITISCH] Serverüberlastung erkannt.
Protokollkonfiguration
Rotationseinstellungen
Bearbeite dein txData/ /config.json und füge ein Objekt innerhalb des Loggers mit dem Schlüssel hinzu, der einer der folgenden ist [admin, fxserver, server]. Konfiguriere die Rotationsoptionen gemäß der Referenz zur Bibliothek „Rotating-File-Stream“.
Beispielkonfiguration:
{
"logger": {
"fxserver": {
"size": "10M",
"interval": "1d",
"compress": "gzip"
}
}
}
Ausführliche Protokollierung
Satz txAdminVerbose Zu WAHR um detailliertere Informationen zu Fehlern und Ereignissen auf der Konsole auszugeben:
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
Fehlerbehebung bei bestimmten Problemen
txAdmin antwortet nicht
Wenn du “erhältst“FXServer antwortet nicht!„bedeutet dies, dass der txAdmin:Monitor keine Verbindung zum FXServer herstellen konnte. Mögliche Ursachen:
- FXServer hängt bei einer Ressource fest
- Portkonflikte zwischen FXServer und txAdmin
- Healthcheck gibt 404-Fehler zurück
Berechtigungsprobleme
Wenn die Meldung „Datei kann nicht gelesen werden“ angezeigt wird, txData/admins.json existiert nicht oder txAdmin hat keine Berechtigung, es zu lesen.
Fehler beim Laden des Profils
Das ausgewählte Profil kann aufgrund von Berechtigungsproblemen oder beschädigtem JSON nicht geladen werden.
Lösche beschädigte Dateien und starte txAdmin neu, um sie neu zu generieren.
Bewährte Methoden
- Regelmäßige Protokollprüfung: Überprüfe die Protokolle täglich auf sich ansammelnde Warnungen
- Automatisierte Überwachung: Richte Benachrichtigungen für kritische Fehler-Muster ein
- Protokollaufbewahrung: Konfiguriere eine geeignete Rotation basierend auf der Serveraktivität
- Sicherungsprotokolle: Log-Verzeichnisse in Backup-Prozeduren einbeziehen
- Zeitstempelkorrelation: Verwende Zeitstempel, um Ereignisse über verschiedene Log-Typen hinweg zu korrelieren
- Stelle sicher, dass deine Serverkonfiguration richtig ist: Server.cfg-Tutorial
Externe Ressourcen
- Offizielle txAdmin-Dokumentation – Primäre Referenz für txAdmin-Funktionen und -Konfiguration
- txAdmin GitHub-Repository – Quellcode und Problemverfolgung
- FiveM Server Handbuch – Vollständige Anleitung zur Servereinrichtung
Unsicherheitshinweis: Log-Format-Spezifikationen können sich zwischen txAdmin-Versionen unterscheiden; verifiziere sie immer mit deiner installierten Version.
Die systematische Protokollüberwachung über die Weboberfläche von txAdmin und der direkte Dateizugriff ermöglichen die proaktive Identifizierung von Serverproblemen, bevor diese das Spielerlebnis beeinträchtigen.
