Sunucu günlükleri ve çökme raporları nasıl okunur
Bir oyun sunucusu günlüğünde önemli olan satırı bulun: günlük seviyeleri, yığın izleri, ilk hata kuralı ve günlüklerle çökme raporlarının panelde nerede durduğu.
4 dk okuma · Güncellendi: 21 Eki 2026 · Yazan: GuavaHost Team
Bir sunucu çöktüğünde ya da başlamayı reddettiğinde sebep neredeyse her zaman günlüğüne yazılmıştır. Günlükler ürkütücü görünür, ama nadiren hepsini anlamanız gerekir: tek bir satırı bulmanız gerekir. Bu rehber bir günlük satırını nasıl okuyacağınızı, seviyelerin ne anlama geldiğini, bir yığın izini nasıl okuyacağınızı ve günlüklerle çökme raporlarının panelinizde nerede durduğunu gösteriyor.
Bir günlük satırının anatomisi
Bir Minecraft sunucusundan tipik bir satır:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
[14:02:11]zamandır. Bu sunucunun saatidir ve sizin saat diliminizle uyuşmayabilir.Server thread, satırı programın hangi parçasının yazdığıdır. Sunucu iş parçacığı ana oyun döngüsüdür.INFOseviyedir: satırın ne kadar ciddi olduğu.- İki noktadan sonraki her şey mesajdır.
Diğer oyunlar satırları farklı biçimlendirir, ama neredeyse hepsi bir yerde zaman, seviye ve mesaj içerir.
Günlük seviyeleri
| Seviye | Anlamı | Endişelenmeli misiniz? |
|---|---|---|
| DEBUG ya da TRACE | Geliştiriciler için ince ayrıntı | Genelde gizli; yok sayın |
| INFO | Normal etkinlik: başlatma, katılmalar, kayıtlar | Hayır |
| WARN | Bir şey ters, ama sunucu devam ediyor | Bazen; birçok uyarı zararsız gürültüdür |
| ERROR | Bir şey başarısız oldu | Sorununuzla aynı zamana denk geliyorsa evet |
| FATAL ya da SEVERE | Sunucu devam edemiyor | Evet, bu genelde çökmenin kendisidir |
Her uyarının peşine düşmeyin. Sağlıklı pek çok sunucu her başlatmada aynı zararsız uyarıları basar. Sorununuz olduğu anda oluşan hatalara odaklanın.
İlk hata kuralı
Gerçek bir sorun, sunucunun diğer parçaları ilk hataya takıldıkça sık sık arkasından bir yığın hata doğurur. Ekrandaki son hata genelde bir belirtidir. Normal görünen son satırdan sonraki ilk hata ise genelde sebeptir.
- İşlerin normal göründüğü son satırı bulun.
- Aşağı doğru ilk
ERROR,Exceptionya daFATALsatırına kadar okuyun. - Onu düzeltin, yeniden başlatın ve tekrar okuyun. Sunucu artık arıza vermeden önce daha ileri gidiyorsa yol alıyorsunuz.
Bir yığın izini okumak
Yığın izi, program başarısız olduğu anda attığı adımların listesidir. Bir Minecraft eklenti sunucusundan yaygın bir örnek:
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
Nasıl okunur:
- İlk satır neyin başarısız olduğunu söyler: ExampleShop eklentisi başlayamadı.
- İstisna türü nedenini söyler:
NoClassDefFoundError, orada olmayan bir koda ihtiyaç duyduğu anlamına gelir. atsatırları nerede olduğunu gösterir. Oyunun kendi iç parçaları yerine, eklentinin kendi adı gibi tanıdığınız bir ad arayın.Caused bykökü gösterir. Bir izde birkaç tane varsa sonCaused bygenelde gerçek sebeptir. Burada Vault'tan bir sınıf eksik, dolayısıyla çözüm bu dükkânın bağlı olduğu Vault eklentisini kurmaktır.
Yaygın hatalar ve genelde ne anlama geldikleri
| Gördüğünüz | Genelde şu anlama gelir |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Eksik bir bağımlılık ya da başka bir sürüm için yapılmış bir eklenti veya mod |
NoSuchMethodError | Farklı bir oyun sürümü için derlenmiş bir şey |
OutOfMemoryError | Sunucunun RAM'i tükendi |
FAILED TO BIND TO PORT ya da Address already in use | Port dolu, genelde hâlâ çalışan ikinci bir kopya yüzünden |
found character '\t' that cannot start any token | Bir YAML yapılandırma dosyasında sekme; YAML yalnızca boşluğa izin verir |
NullPointerException | Bir hata ya da eksik veya yanlış yazılmış bir yapılandırma değeri |
Çökme raporları
Bazı oyunlar çöktüklerinde ayrı, daha ayrıntılı bir rapor yazar.
- Minecraft bunları
crash-reportsklasörüne, tarih ve saatle adlandırarak kaydeder. En üste yakın bir yerde birDescriptionsatırı ve istisnayı bulursunuz. Modlu sunucular yüklü her modu listeler ve Forge ile NeoForge raporları sık sık şüpheli bir modu işaret eder. - Java'nın kendisini deviren bir Java çökmesi, sunucunun ana klasöründe bir
hs_err_piddosyası (arkasından bir sayı gelir) bırakır. Bunlar genelde bir eklentiyi değil belleği ya da yerel bir kütüphaneyi işaret eder.
Panelinizde günlükler nerede durur
Console (Konsol) sekmesi canlı çıktıyı gösterir. Yalnızca son satırları tutar, dolayısıyla daha eski her şey için günlük dosyalarını Files (Dosyalar) sekmesinden açın ya da SFTP ile indirin.
| Oyun | Nereye bakılır |
|---|---|
| Minecraft Java | logs/latest.log; daha eski günlükler logs içinde .log.gz dosyaları (indirip açın); çökmeler crash-reports içinde |
| BepInEx ile Valheim | BepInEx/LogOutput.log |
| ARK: Survival Evolved ve Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | DoNotStarveTogether/config/server/Master ve .../Caves içinde server_log.txt, her parça için bir tane |
| Enshrouded | enshrouded_server.json içindeki logDirectory ile belirlenen klasör, varsayılan olarak logs |
| Diğer oyunlar | Konsolun bastığı her şey; ayrıca bir logs ya da Logs klasörüne veya .log ile biten dosyalara bakın |
Panel bir çökme bildirdiğinde
Sunucu süreci beklenmedik şekilde durursa panel, bir çıkış koduyla birlikte sunucunun çöktüğünü söyleyen kendi mesajını basabilir. Bilmeye değer birkaçı:
- 0: normal bir duruş.
- 1: oyun bir hata yüzünden çıktı; hemen üstteki satırları okuyun.
- 137: süreç zorla öldürüldü, genelde bellek sınırını aştığı için. Bkz. sunucunuzun RAM'inin tükendiğinin işaretleri.
- 139: oyunun kendi içinde yerel bir çökme.
Uzun bir günlüğü aramak
- Günlüğü indirip bir metin düzenleyicide açın.
- Önce
ERROR, sonraException, sonraCaused byiçin Bul'u kullanın (Ctrl+F, Mac'te Cmd+F). - Eklediğiniz son eklentinin ya da modun adını arayın.
- Zaman damgalarını sorunun olduğu ana eşleştirin.
Bir günlükle yardım istemek
Normal görünen son satırdan ilk hatanın sonuna kadar kopyalayın ve ekran görüntüsü yerine metin olarak yapıştırın. Herhangi bir yerde paylaşmadan önce şifreleri, anahtarları ve özel olan her şeyi çıkarın. Sonra Discord'umuza getirin, ekip onu sizinle birlikte okuyabilir. Özellikle başlatma sorunları için bkz. sunucu başlıyorda takıldı.
Hâlâ çözemediniz mi? discord.gg/GuavaHost adresindeki Discord'umuza katılın, ekibimiz size yardımcı olacak.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Hâlâ yardım mı gerekiyor? Ekibimiz sorularınızı yanıtlamak için 7/24 çevrimiçi.