txAdmin przechowuje trzy rodzaje trwałych plików dziennika w katalogu txData/<profile>/logs/ katalogu: dzienniki administracyjne dla działań administracyjnych, dzienniki fxserver dla wyjścia konsoli oraz dzienniki serwera dla zdarzeń w grze. Te dzienniki są niezbędne do diagnozowania problemów z serwerem, śledzenia aktywności graczy i monitorowania wydajności systemu.
Grupa docelowa: Administratorzy serwera FiveM korzystający z txAdmin w wersji 4.6.0 lub nowszej z funkcją rotacji dzienników.
Rodzaje i lokalizacje dzienników
Struktura plików
txData/ └── <profile>/ └── logs/ ├── admin/ ├── fxserver/ └── server/
Kategorie dzienników
Dzienniki administracyjne (admin/) Zawiera dziennik działań administracyjnych oraz niektórych zautomatyzowanych, takich jak restart serwera, blokady, ostrzeżenia, zmiany ustawień, wejścia konsoli na żywo. Nie rejestruje adresów IP użytkowników poza punktami końcowymi uwierzytelniania.
Dzienniki FXServer (fxserver/) Zawiera dziennik wszystkiego, co dzieje się w konsoli fxserver (stdin, stdout, stderr). Każde wejście konsoli na żywo jest poprzedzone >.
Dzienniki serwera (server/) Zawiera wszystkie działania zachodzące wewnątrz serwera, na przykład dołączenie/opuszczenie/śmierć gracza, wiadomości na czacie, eksplozje, zdarzenia menu, komendy.
Dostęp do dzienników przez interfejs WWW
Metoda 1: Konsola na żywo
- Uzyskaj dostęp do panelu internetowego txAdmin pod adresem
http://your-server-ip:port - Przejdź do Konsola na żywo w panelu bocznym
- Monitoruj działania serwera w czasie rzeczywistym, ostrzeżenia i komunikaty błędów w celu debugowania problemów
- Szukaj wpisów oznaczonych jako
[ERROR],[WARN], lub[CRITICAL]
Metoda 2: Podgląd logów serwera
- Przejdź do Log serwera w menu bocznym
- Monitoruj wszystkie aktywności na serwerze, w tym połączenia graczy, wiadomości na czacie, śmierci w grze, akcje menu, wykonane komendy oraz zdarzenia systemowe
- Użyj opcji filtrowania, aby wyizolować komunikaty błędów
- Eksportuj sekcje logów do szczegółowej analizy
Metoda 3: Log działań
- Przejdź do Ustawienia → Diagnostyka
- Wyświetl Log działań, który rejestruje wszystkie akcje wykonane przez txAdmin lub dowolnego administratora
- Sprawdź nieudane akcje administracyjne lub błędy systemowe
Dostęp do logów oparty na plikach
Bezpośrednie odczytywanie plików
# 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
Konwencja nazewnictwa plików logów
- Pliki są zgodne ze wzorcem:
<type>-YYYY-MM-DD.log - Przykład:
fxserver-2025-06-10.log
Typowe wzorce błędów
Błędy ładowania zasobów
[ERROR] Failed to start resource 'resource_name' [ERROR] Could not load resource metadata for resource_name [WARN] Resource resource_name is using deprecated syntax
Problemy z połączeniem do bazy danych
[ERROR] MySQL connection failed [ERROR] Could not execute query [WARN] Connection to database timed out
Błędy związane z graczami
Źródła graczy są przechowywane w formacie [mutex#id] name gdzie muteks jest identyfikatorem tej instancji serwera. Szukaj [mutex#id] aby znaleźć początkowe dołączenie gracza ze wszystkimi identyfikatorami.
Problemy z pamięcią i wydajnością
[WARN] High memory usage detected [ERROR] Script timeout in resource_name [CRITICAL] Server overload detected
Konfiguracja logów
Ustawienia rotacji
Edytuj swoje txData/<profile>/config.json i dodaj obiekt wewnątrz loggera, gdzie kluczem będzie jeden z [admin, fxserver, server]. Skonfiguruj opcje rotacji zgodnie z Odwołanie do biblioteki rotating-file-stream.
Przykładowa konfiguracja:
{
"logger": {
"fxserver": {
"size": "10M",
"interval": "1d",
"compress": "gzip"
}
}
}
Szczegółowe logowanie
Ustaw txAdminVerbose do true aby drukować na konsoli bardziej szczegółowe informacje o błędach i zdarzeniach:
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
Rozwiązywanie konkretnych problemów
txAdmin Nie odpowiada
Jeśli otrzymasz “FXServer nie odpowiada!” oznacza to, że txAdmin:Monitor nie mógł połączyć się z FXServer. Przyczyny obejmują:
- FXServer utknął na zasobie
- Konflikty portów między FXServer a txAdmin
- Healthcheck zwraca błędy 404
Problemy z uprawnieniami
Jeśli otrzymasz “nie można odczytać pliku”, plik administratora txData/admins.json nie istnieje lub txAdmin nie ma uprawnień do jego odczytu.
Błędy ładowania profilu
Wybranego profilu nie można załadować z powodu problemów z uprawnieniami lub uszkodzonego JSON.
Usuń uszkodzone pliki i zrestartuj txAdmin, aby je odtworzyć.
Najlepsze praktyki
- Regularne przeglądanie logów: Codziennie sprawdzaj logi pod kątem narastających ostrzeżeń
- Automatyczne monitorowanie: Ustaw alerty dla krytycznych wzorców błędów
- Przechowywanie logów: Skonfiguruj odpowiednie obroty w zależności od aktywności serwera
- Kopie zapasowe dzienników: Uwzględnij katalogi logów w procedurach tworzenia kopii zapasowych
- Korelacja znaczników czasu: Używaj znaczników czasu do korelacji zdarzeń w różnych typach logów
- Upewnij się, że konfiguracja serwera jest poprawna: Samouczek Server.cfg
Zewnętrzne zasoby
- Oficjalna dokumentacja txAdmin – Podstawowe odniesienie do funkcji i konfiguracji txAdmin
- txAdmin GitHub Repozytorium – Kod źródłowy i śledzenie błędów
- FiveM Podręcznik serwera – Kompletny przewodnik konfiguracji serwera
Uwaga dotycząca niepewności: Specyfikacje formatu logów mogą się różnić w zależności od wersji txAdmin; zawsze weryfikuj z zainstalowaną wersją.
Systematyczne monitorowanie logów za pośrednictwem interfejsu internetowego txAdmin i bezpośredni dostęp do plików umożliwiają proaktywne identyfikowanie problemów z serwerem, zanim wpłyną one na doświadczenie graczy.