txAdmin, üç tür kalıcı günlük dosyasını korur txData/<profile>/logs/ dizin: yönetimsel eylemler için yönetici günlükleri, konsol çıktısı için fxserver günlükleri ve oyun içi olaylar için sunucu günlükleri. Bu günlükler, sunucu sorunlarını teşhis etmek, oyuncu etkinliklerini izlemek ve sistem performansını izlemek için önemlidir.
Hedef Kitle: FiveM sunucu yöneticileri Günlük döndürme yeteneklerine sahip txAdmin v4.6.0 veya daha yenisini kullanıyorum.
Günlük Türleri ve Konumları
Dosya Yapısı
txData/ └── <profile>/ └── logs/ ├── admin/ ├── fxserver/ └── server/
Günlük Kategorileri
Yönetici Günlükleri (admin/) Yönetimsel eylemlerin yanı sıra sunucu yeniden başlatmaları, yasaklamalar, uyarılar, ayar değişiklikleri, canlı konsol girişi gibi bazı otomatik eylemlerin günlüğünü içerir. Kimlik doğrulama uç noktaları dışında kullanıcı IP adreslerini kaydetmez.
FXServer Günlükleri (fxserver/) fxserver konsolunda gerçekleşen her şeyin günlüğünü içerir (stdin, stdout, stderr). Herhangi bir canlı konsol girişi, şu ön eke sahiptir: >.
Sunucu Günlükleri (server/) Sunucu içerisinde gerçekleşen tüm eylemleri içerir, örneğin oyuncunun katılması/ayrılması/ölmesi, sohbet mesajları, patlamalar, menü olayları, komutlar.
Web Arayüzü Günlük Erişimi
Yöntem 1: Canlı Konsol
- txAdmin web panelinize şu adresten erişin:
http://your-server-ip:port - Şuraya git: Canlı Konsol kenar çubuğunda
- Hata ayıklama sorunları için gerçek zamanlı sunucu etkinliklerini, uyarıları ve hata mesajlarını izleyin
- İle işaretlenmiş girdileri arayın
[ERROR],[WARN], veya[CRITICAL]
Yöntem 2: Sunucu Günlük Görüntüleyicisi
- Git Sunucu Günlüğü kenar çubuğu menüsünde
- Oyuncu bağlantıları, sohbet mesajları, oyun ölümleri, menü eylemleri, yürütülen komutlar ve sistem olayları dahil olmak üzere sunucudaki tüm etkinlikleri izleyin
- Hata mesajlarını izole etmek için filtre seçeneklerini kullanın
- Ayrıntılı analiz için günlük bölümlerini dışa aktarın
Yöntem 3: Eylem Günlüğü
- Şuraya git: Ayarlar → Tanılama
- txAdmin veya herhangi bir Admin tarafından gerçekleştirilen tüm eylemleri kaydeden Eylem Günlüğünü görüntüleyin
- Başarısız yönetimsel eylemleri veya sistem hatalarını kontrol edin
Dosya Tabanlı Günlük Erişimi
Doğrudan Dosya Okuma
# 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
Günlük Dosyası Adlandırma Kuralı
- Dosyalar şu kalıbı takip ediyor:
<type>-YYYY-MM-DD.log - Örnek:
fxserver-2025-06-10.log
Yaygın Hata Modelleri
Kaynak Yükleme Hataları
[ERROR] Failed to start resource 'resource_name' [ERROR] Could not load resource metadata for resource_name [WARN] Resource resource_name is using deprecated syntax
Veritabanı Bağlantı Sorunları
[ERROR] MySQL connection failed [ERROR] Could not execute query [WARN] Connection to database timed out
Oyuncuyla İlgili Hatalar
Oyuncu kaynakları formatta tutulur [mutex#id] name burada mutex, o sunucu yürütmesinin bir tanımlayıcısıdır. Ara [mutex#id] tüm tanımlayıcılarla ilk oyuncu katılımını bulmak için.
Bellek ve Performans Sorunları
[WARN] High memory usage detected [ERROR] Script timeout in resource_name [CRITICAL] Server overload detected
Günlük Yapılandırması
Rotasyon Ayarları
Düzenle txData/<profile>/config.json ve logger'ın içine anahtarı aşağıdakilerden biri olan bir nesne ekleyin [admin, fxserver, server]. Dönüş seçeneklerini aşağıdakilere göre yapılandırın: dönen dosya akışı kütüphane referansı.
Örnek yapılandırma:
{
"logger": {
"fxserver": {
"size": "10M",
"interval": "1d",
"compress": "gzip"
}
}
}
Ayrıntılı Günlük Kaydı
Ayarlamak txAdminVerbose ile true konsolda hatalar ve olaylar hakkında daha ayrıntılı bilgi yazdırmak için:
# Windows ./FXServer.exe +set txAdminVerbose true # Linux ./run.sh +set txAdminVerbose true
Belirli Sorunların Giderilmesi
txAdmin Yanıt Vermiyor
Eğer "FXServer yanıt vermiyor!” txAdmin:Monitor'un FXServer'a bağlanamadığı anlamına gelir. Nedenleri şunlardır:
- FXServer bir kaynakta takılı kaldı
- FXServer ve txAdmin arasındaki port çakışmaları
- Sağlık kontrolü 404 hataları döndürüyor
İzin Sorunları
"Dosya okunamıyor" mesajını alırsanız, yönetici dosyası txData/admins.json mevcut değil veya txAdmin'in bunu okuma yetkisi yok.
Profil Yükleme Hataları
Seçilen profil, izin sorunları veya bozuk JSON nedeniyle yüklenemiyor.
Bozuk dosyaları silin ve yeniden oluşturmak için txAdmin'yi yeniden başlatın.
En İyi Uygulamalar
- Düzenli Günlük İncelemesi: Uyarıların birikmesi için günlükleri kontrol edin
- Otomatik İzleme: Kritik hata kalıpları için uyarılar ayarlayın
- Günlük Tutma: Sunucu etkinliğine göre uygun rotasyonu yapılandırın
- Yedekleme Günlükleri: Yedekleme prosedürlerine günlük dizinlerini dahil edin
- Zaman Damgası Korelasyonu: Farklı günlük türlerindeki olayları ilişkilendirmek için zaman damgalarını kullanın
- Sunucu yapılandırmanızın doğru olduğundan emin olun: Server.cfg Rehberi
Dış Kaynaklar
- Resmi txAdmin Belgeleri – txAdmin özellikleri ve yapılandırması için birincil referans
- txAdmin GitHub Deposu – Kaynak kodu ve sorun takibi
- FiveM Sunucu Kılavuzu – Tam sunucu kurulum kılavuzu
Belirsizlik Notu: Günlük biçimi özellikleri txAdmin sürümleri arasında farklılık gösterebilir; daima yüklü sürümünüze göre doğrulayın.
TxAdmin'in web arayüzü ve doğrudan dosya erişimi aracılığıyla yapılan sistematik günlük izleme, sunucu sorunlarının oyuncu deneyimini etkilemeden önce proaktif bir şekilde tanımlanmasını sağlar.