Sistem Logları Paneli (Ayarlar → Log)

Sistem logları paneli, sunucudaki storage/logs/laravel.log dosyasını panel içinden okumanızı sağlar. Artık entegrasyon bir hata verdiğinde SSH'a girip tail -f çalıştırmanıza gerek yoktur. Hatalar kategori bazında filtrelenir, en yeniler üstte gösterilir, stack trace'i tek tıkla genişletebilirsiniz.

Sayfaya nasıl giderim?

Yönetici paneli → sol menüde Ayarlar → Log. Doğrudan URL: /settings/logs

Çalışma mantığı (lazy load)

Sayfa açıldığında loglar otomatik yüklenmez; çünkü log dosyası bazı sunucularda 50–500 MB'a kadar ulaşabilir ve sayfayı yavaşlatır. Bunun yerine:

1. Üstte iki açılır liste vardır: Kaynak ve Satır sayısı.
2. Kaynağı (örnek: iyzico, Paraşüt, Mail/SendGrid, VMware) seçin.
3. Logları getir butonuna basın.
4. Sistem dosyanın son 1 MB'lık kısmını okur, log entry'lerine ayırır, kaynağa göre filtreler ve en yeniler üstte olacak şekilde listeler.

Desteklenen kaynaklar

• Tüm kaynaklar — filtre uygulanmaz
• E-posta (SendGrid / Mailer) — SendGrid HTTP API çağrıları, Symfony mailer transport hataları, "from address does not match", null transport vb.
• iyzico (ödeme) — 3D Secure başarısızlıkları, iyzico API HTTP 4xx/5xx, imza hataları
• Paraşüt (ön-muhasebe) — Paraşüt OAuth token yenileme hataları, fatura push hataları, ürün eşleşme hataları
• Plesk — Plesk REST API bağlantı hataları, hesap oluşturma / yenileme hataları
• cPanel / WHM — WHM API token sorunları, paket eşleşme hataları
• VMware / vSphere — vCenter REST oturum süresi dolmuş, şablon klonlama hataları, VM başlatma hataları
• SMS (Bulutfon / Netgsm) — OTP gönderim başarısızlıkları, başlık onay sorunları, bakiye hataları
• GİB e-Fatura — WSDL bağlantı sorunları, kullanıcı/şifre hataları, e-fatura UUID hataları
• Domain registrar — ResellerClub / Namecheap API hataları, domain transferi başarısızlıkları
• Kuyruk / job — Failed job kayıtları, "Job processed", retry'ler
• Kimlik / oturum — Authentication exception, CSRF token mismatch, 401/403
• Sadece hatalar — yalnızca .ERROR / .CRITICAL / .ALERT / .EMERGENCY seviyeleri

Görünüm

Her log kaydı bir kart olarak listelenir:

• Seviye rozeti — kırmızı (ERROR/CRITICAL), sarı (WARNING), mavi (INFO)
• Kaynak rozeti — sistemin otomatik tahmin ettiği kategori (mail, iyzico, vmware, vb.)
• Zaman — log entry zaman damgası
• Mesaj — log mesajının ilk satırı
• Detayı / stack trace göster — uzun olan exception trace'leri tıklayarak açabilirsiniz

Üst paneldeki ortam bilgileri

Sayfanın üst kısmında log dosyasına bakmadan da entegrasyonların durumunu hızlıca görmek için anlık özet vardır:

• Log dosyası ve boyutu (KB)
• app.env, app.debug, mail.default, queue.default, logging.default, PHP versiyonu

Pratik tanı senaryoları

• "iyzico ödeme alınmıyor" → Kaynak: iyzico, Satır: 200 → "Logları getir". HTTP yanıtı / imza hatası / IP whitelist sorunu burada görülür.
• "Müşteri kayıt mailini almadı" → Kaynak: E-posta. SendGrid 401/403, Sender Authentication hataları, NullTransport uyarısı burada listelenir.
• "Paraşüt'e fatura düşmedi" → Kaynak: Paraşüt. OAuth refresh hatası veya HTTP 422 detayları burada.
• "VM başlatılamadı" → Kaynak: VMware. vCenter REST oturum hatası, datastore yetersizliği vb.
• "Kampanya maili gitmedi" → Kaynak: Kuyruk / job + E-posta. Önce job'un işlenip işlenmediğine bakın, sonra mail gönderim katmanına.

Sınırlar ve performans

• Sadece dosyanın son 1 MB'ı okunur (ortalama 5.000–15.000 entry). Daha eski kayıtlar için sunucuda storage/logs/laravel-YYYY-MM-DD.log rotasyon dosyalarına bakın.
• Maksimum 2.000 entry tek seferde gösterilir.
• Stack trace'ler 4.000 karakter ile kırpılır (UI'ı yavaşlatmamak için).
• Sayfa cache'lenmez; her "Logları getir" tıklamasında dosya yeniden okunur — anlık durumu yansıtır.

İlgili belgeler

• Bilgi bankası → Twilio SendGrid entegrasyonu
• Bilgi bankası → Pazarlama kampanyası gönderme